aggiunte schermate per manuale, sistemato readme per git

README.md

@@ -0,0 +1,87 @@
+# GRIFO_M_PBIT — Release Notes & Feature Summary
+
+Questo documento sintetizza le funzionalità implementate nella versione corrente dello
+script `GRIFO_M_PBIT.py` rispetto a una versione iniziale minimale (senza GUI, senza
+handling avanzato di "known failures", senza propagation della versione dello script, senza aggregazione dei risultati dei test, senza gestione del test del target).
+Serve per informare altri sviluppatori sulle modifiche principali e sulle modalità d'uso.
+
+## Scopo
+Fornire un elenco chiaro e conciso delle funzionalità aggiunte, dei comportamenti modificati
+(e dove cercare il codice/documentazione per approfondire).
+
+## Principali funzionalità implementate
+- `TEST_VERSION`:
+  - Aggiunta di una costante `TEST_VERSION` nello script principale.
+  - La stringa di versione viene inserita in tutti gli output generati: log, CSV, JSON e PDF.
+
+- Gestione estesa di `KNOWN_FAILURES` (ora applicata anche a B8):
+  - `KNOWN_FAILURES` può ora essere usata per classificare come "Known" anche le failure
+    individuate nel drill-down B8.
+  - Aggiunto helper `is_known_failure(field_name)` (matching case-insensitive, substring).
+  - Comportamento: le failure classificate come "known" sono registrate ma NON rendono
+    la run fallita; le failure non note su B8 causano la FAIL della run.
+
+- B8 drill-down migliorato:
+  - Il drill-down B8 classifica ogni field in PASS / REAL FAIL / KNOWN FAIL.
+  - Conta `b8_pass`, `b8_fail`, `b8_known_fail` e mantiene dettagli separati per real e known.
+  - Drill-down eseguito solo se necessario (presenza di real failures) oppure se forzato
+    tramite `FORCE_B8_DRILL_DOWN`.
+
+- GUI real-time (Tkinter) — `GRIFO_M_PBIT_gui.py`:
+  - Aggiunta di un monitor in tempo reale opzionale (avviabile di default, disabilitabile con `--no-gui`).
+  - Tabella `Runs Overview` aggiornata per mostrare la colonna B8 nel formato `Pass/Fail/Known`.
+  - Comunicazione thread-safe tra test thread e GUI tramite `queue.Queue()`.
+
+- Reportistica aggiornata (CSV / JSON / PDF):
+  - I file CSV/JSON includono ora `script_version` e i conteggi `b8_known_fail` per run.
+  - Il PDF include la `Script Version` nella sezione metadati e mostra, nella tabella Run Details,
+    la colonna B8 come `Pass/Fail/Known`.
+
+- Simulation & Mocks migliorati:
+  - `GRIFO_M_PBIT_mock.py` include scenari aggiuntivi (`pedestal_fail`, `mixed_b8_failures`, `agc_tests_fail`, ecc.)
+  - Launcher `run_simulate.bat` e `run_simulate_simple.bat` sono mantenuti per eseguire rapidamente
+    test in modalità simulata.
+
+## Differenze rispetto alla versione iniziale (baseline)
+Baseline: script senza GUI, senza gestione avanzata di known-failures, senza propagation della versione, ecc.
+
+Cosa è stato aggiunto/alterato:
+- Interfaccia grafica opzionale per monitoraggio realtime.
+- Meccanismo `KNOWN_FAILURES` esteso a B8 con helper dedicato.
+- Maggiori dettagli nei report (terzo campo B8: known count; script version metadata).
+- Drill-down B8 condizionato e classificazione Known vs Real.
+- Mocks e scenari di simulazione arricchiti per testare casi complessi.
+- Test automatici per prevenire regressioni nelle regole di notazione delle failure.
+- Correzioni logiche che garantiscono che real B8 failures provochino correttamente la FAIL della run.
+- Gestione dei test con target generator
+
+## Dove trovare il codice e la documentazione
+- Script principale: `TestEnvironment/scripts/GRIFO_M_PBIT.py`
+- GUI: `TestEnvironment/scripts/GRIFO_M_PBIT_gui.py`
+- Mock / simulazione: `TestEnvironment/scripts/GRIFO_M_PBIT_mock.py`
+- Report / PDF generator: `TestEnvironment/env/leo_grifo_pdf2report.py`
+
+
+## Esempi di esecuzione
+- Modalità simulazione (rapida):
+
+```powershell
+.\run_simulate.bat
+```
+
+- Modalità hardware:
+
+```powershell
+.\run_target.bat
+```
+
+Output generati in (cartelle):
+- Log: `TestEnvironment/LOG/GRIFO_M_PBIT.log`
+- PDF/CSV/JSON: `TestEnvironment/pdf_reports/` (file con prefisso `GRIFO_M_PBIT_YYYYMMDD_HHMMSS`)
+
+## Note per sviluppatori
+- Matching `KNOWN_FAILURES`: la logica attuale usa substring case-insensitive. Per renderla più restrittiva
+  usare regex o nomi completi: modificare `is_known_failure()` in `GRIFO_M_PBIT.py`.
+- Per aggiungere un known failure permanente, aggiornare la lista `KNOWN_FAILURES` in `GRIFO_M_PBIT.py`.
+- Se si modifica la struttura dei report JSON, aggiornare anche `TestEnvironment/env/leo_grifo_test_report.py`.
+