# Specifiche Funzionali di Dettaglio, Architettura e Requisiti Sistemistici
**Piattaforma GRC Software Validation & Quality Gate Pre-Execution**  
**Progetto:** DevWithBrain — Smart GRC Checklist & Quality Gate Platform  
**Edizione:** Complete EU Digital Single Market Rulebook (17 Regolamenti Europei)  
**Data Documento:** 12 Novembre 2026  
**Stato Documento:** Rilasciato / Auto-Consistente  

---

## Indice Generale

1. [Executive Summary & Visione del Prodotto](#1-executive-summary--visione-del-prodotto)
   - 1.1 Il Paradigma "Shift-Left GRC"
   - 1.2 Eliminazione di LLM Council e Passaggio al GRC Deterministico
   - 1.3 Principi Guida: Zero-Data Retention & Privacy-by-Design
2. [Quadro Regolatorio Europeo Integrato (I 17 Regolamenti)](#2-quadro-regolatorio-europeo-integrato-i-17-regolamenti)
   - 2.1 Catalogo Completo delle Norme Europee
   - 2.2 Tabella Sinottica delle Normative, Presidi e Scadenze
3. [Architettura Funzionale a 5 Fasi Sequenziali](#3-architettura-funzionale-a-5-fasi-sequenziali)
   - 3.1 Fase 1: Ingestion Multi-Fase & Multi-File Progressiva
   - 3.2 Fase 2: Triage Semantico Proattivo & Questionario Interattivo
   - 3.3 Fase 3: Smart GRC Checklist Dinamica
   - 3.4 Fase 4: Downstream Code & Artifact Validation
   - 3.5 Fase 5: Decision Gate, Registro Deroghe CISO & Deliverable
4. [Architettura di Internazionalizzazione Multilingua Reattiva (i18n)](#4-architettura-di-internazionalizzazione-multilingua-reattiva-i18n)
   - 4.1 Modello di Traduzione Client-Side a Zero Latenza
   - 4.2 Localizzazione Server-Side dei Deliverable e Dossier HTML
5. [Stato dell'Arte Implementativo (Cosa è Stato Realizzato)](#5-stato-dellarte-implementativo-cosa-è-stato-realizzato)
   - 5.1 Struttura del Repository e Moduli Backend
   - 5.2 Specifiche delle API REST (OpenAPI / Endpoints)
   - 5.3 Implementazione Frontend SPA
   - 5.4 Suite di Test Automatizzati e Risultati di Collaudo
6. [Tecnologie Utilizzate e Standard Industriali](#6-tecnologie-utilizzate-e-standard-industriali)
   - 6.1 Backend Stack & Librerie
   - 6.2 Frontend Stack
   - 6.3 Standard e Formati di Sicurezza Adottati
7. [Componenti Sistemistiche & Requisiti di Esecuzione (SysOps)](#7-componenti-sistemistiche--requisiti-di-esecuzione-sysops)
   - 7.1 Requisiti Hardware (Minimi e Raccomandati)
   - 7.2 Requisiti Software, OS e Dipendenze Linux
   - 7.3 Topologia di Rete, Porte e Configurazione Tailscale Mesh
   - 7.4 Gestione del Processo Demone e Systemd Service
   - 7.5 Architettura di Deployment Containerizzato (Docker & Docker Compose)
   - 7.6 Monitoraggio, Logging e Manutenzione

---

## 1. Executive Summary & Visione del Prodotto

### 1.1 Il Paradigma "Shift-Left GRC"
Nel moderno panorama dello sviluppo software, la conformità alle normative europee (Cyber Resilience Act, GDPR, EU AI Act, NIS 2, DORA, ecc.) viene tipicamente affrontata come una verifica a posteriori (*post-audit*), spesso a ridosso o successivamente alla messa in produzione. Questo approccio comporta ritardi critici nel time-to-market, costi esponenziali di refactoring architetturale e gravosi rischi di sanzioni legali o interruzioni d'esercizio.

**DevWithBrain** ribalta radicalmente questo paradigma introducendo lo **Shift-Left GRC (Governance, Risk and Compliance)**:
- Consente di identificare il perimetro regolatorio europeo applicabile **fin dalla stesura dei primi documenti di progetto** (Product Requirements Document - PRD, deck di presentazione, diagrammi architetturali, contratti di fornitura, capitolati d'oneri).
- Trasforma le complessità legislative in una **Smart GRC Checklist interattiva e azionabile** per gli sviluppatori, i DevOps, i compliance officer e i CISO.
- Istituisce un **Quality Gate vincolante prima dell'esecuzione o della messa in produzione** (*pre-execution / pre-production gate*), bloccando il deployment in presenza di violazioni inderogabili e consentendo il rilascio condizionato unicamente previa formale sottoscrizione di una deroga (Risk Acceptance) con tracciatura crittografica.

### 1.2 Eliminazione di LLM Council e Passaggio al GRC Deterministico
Nelle prime iterazioni prototipali, la piattaforma esplorava l'uso di un "LLM Council" generativo per simulare opinioni multiple. Su indicazione strategica dell'utente, **l'LLM Council è stato completamente dismesso** in favore di:
1. **Regole Deterministiche ed Euristiche Trasparenti**: la piattaforma non "allucina" né esprime pareri generici, ma mappa requisiti esatti estratti dalle Gazzette Ufficiali dell'Unione Europea.
2. **Classificazione Oggettiva dei Presidi**: ogni controllo è univocamente associato ad articoli di legge, criteri di severità (`BLOCKER`, `HIGH`, `MEDIUM`) e modalità di verifica (procedurale vs. evidenza a codice).
3. **Quality Gate Matematico**: la delibera (GO / CONDITIONAL / NO-GO) è frutto di un algoritmo deterministico basato sulla presenza di violazioni bloccanti e sullo stato formale delle eccezioni approvate dal CISO/DPO.

### 1.3 Principi Guida: Zero-Data Retention & Privacy-by-Design
La piattaforma è concepita per essere utilizzata su progetti software confidenziali e proprietari:
- **Zero-Data Retention (ZDR)**: la piattaforma non memorizza in modo persistente il codice sorgente né i documenti caricati su database condivisi. Le sessioni risiedono in memoria RAM effimera e isolata per sessione (`GRC_SESSION_STORE`).
- **Nessuna dipendenza obbligatoria da LLM esterni**: il triage, la generazione della checklist, la scansione del codice, la generazione dello SBOM CycloneDX, la creazione del Fascicolo Tecnico CRA e la delibera del Quality Gate funzionano al 100% in locale, senza inviare token o codice a terze parti.
- **BYOK (Bring Your Own Key)**: qualora l'utente decida opzionalmente di abilitare spiegazioni contestuali avanzate tramite AI, le chiavi API rimangono memorizzate esclusivamente a livello client o in sessione effimera protetta da crittografia a riposo e 2FA TOTP.

---

## 2. Quadro Regolatorio Europeo Integrato (I 17 Regolamenti)

La piattaforma integra l'intero **EU Digital Single Market Rulebook**, coprendo 17 normative dell'Unione Europea, analizzate sia su asse orizzontale (applicabilità trasversale a tutti i prodotti software) sia su asse verticale (settori specifici: sanità, finanza, crypto, identità digitale).

### 2.1 Catalogo Completo delle Norme Europee

```
┌──────────────────────────────────────────────────────────────────────────────────────────────────┐
│                            QUADRO REGOLATORIO DIGITALE EUROPEO (17 REGOLAMENTI)                   │
├────────────────────────────────┬────────────────────────────────┬────────────────────────────────┤
│    SICUREZZA & CYBER RESILIENCE│    DATI, PRIVACY & AI          │   SETTORI VERTICALI & MERCATO  │
├────────────────────────────────┼────────────────────────────────┼────────────────────────────────┤
│ 1. CRA (Cyber Resilience Act)  │ 2. GDPR (Privacy & DPIA)       │ 6. DORA (Finanza & Resilienza) │
│ 4. NIS 2 (Infrastrutture Crit.)│ 3. EU AI Act (Sistemi AI)      │ 7. Data Act (Dati & Cloud)     │
│ 16. CSRD & Green IT (Ecodesign)│ 5. eIDAS 2 (EUDI Wallet)       │ 8. EHDS (Dati Sanitari)        │
│ 17. PLD (Responsabilità Danni) │ 11. DGA (Data Governance Act)  │ 9. MDR / IVDR (Software Medico)│
│                                │ 13. Copyright DSM (IP & TDM)   │ 10. MiCA & TFR (Crypto-Asset)  │
│                                │ 14. ePrivacy (Cookie & Tracker)│ 12. EAA (Accessibilità EN301549│
│                                │ 15. Direttiva Omnibus (Consum.)│                                │
└────────────────────────────────┴────────────────────────────────┴────────────────────────────────┘
```

1. **Cyber Resilience Act (CRA - Regolamento UE 2024/2847)**:
   - *Ambito*: Prodotti software commerciali con elementi digitali.
   - *Obblighi*: Security-by-Design, generazione obbligatoria dello SBOM (CycloneDX/SPDX), canale di Coordinated Vulnerability Disclosure (RFC 9116 `security.txt`), supporto e patch di sicurezza per almeno 5 anni o per il ciclo di vita del prodotto, notifica incidenti a ENISA/CSIRT entro 24 ore.
   - *Impatto*: Bloccante (Hard Blocker) per il rilascio di software commerciale in UE.

2. **Regolamento Generale sulla Protezione dei Dati (GDPR - Regolamento UE 2016/679)**:
   - *Ambito*: Trattamento di dati personali e particolari di cittadini europei.
   - *Obblighi*: Privacy by Design & by Default (Art. 25), Registro dei trattamenti (Art. 30), Valutazione d'Impatto sulla Protezione dei Dati (DPIA Art. 35), gestione consensi e revoche, cifratura dei dati a riposo e in transito, diritto all'oblio ed export dati (Art. 17 & 20).

3. **Artificial Intelligence Act (EU AI Act - Regolamento UE 2024/1689)**:
   - *Ambito*: Sistemi software che incorporano algoritmi di machine learning, modelli generativi (LLM) o logiche decisionali automatizzate.
   - *Obblighi*: Classificazione per classi di rischio (Inaccettabile = divieto, Alto Rischio = requisiti severi di tracciabilità dataset, test di bias, human-in-the-loop, conformità marcatura CE; Trasparenza = disclosure dell'uso di AI generativa, marcatura watermark/metadati).

4. **Direttiva NIS 2 (Direttiva UE 2022/2555)**:
   - *Ambito*: Soggetti essenziali e importanti in 18 settori critici (energia, sanità, PA, cloud provider, data center, telecomunicazioni, finanza).
   - *Obblighi*: Gestione del rischio di supply chain cyber, autenticazione multi-fattore (MFA), cifratura end-to-end, piani di Business Continuity & Disaster Recovery (BC/DR), notifica preventiva degli incidenti significativi entro 24 ore.

5. **Digital Operational Resilience Act (DORA - Regolamento UE 2022/2554)**:
   - *Ambito*: Entità finanziarie (banche, assicurazioni, intermediari, exchange) e loro fornitori ICT terzi critici.
   - *Obblighi*: Test avanzati di resilienza operativa digitale (TLPT - Threat-Led Penetration Testing), registro degli accordi ICT di outsourcing, RTO/RPO rigorosi, piani di continuità per i servizi finanziari core.

6. **eIDAS 2.0 (Regolamento UE 2024/1183)**:
   - *Ambito*: Sistemi di autenticazione, identità digitale, European Digital Identity Wallet (EUDI Wallet).
   - *Obblighi*: Supporto OpenID for Verifiable Presentations (OpenID4VP), attributi d'identità crittografici, firme elettroniche qualificate (QES), divieto di profiling cross-servizio tramite l'ID wallet.

7. **European Data Act (Regolamento UE 2023/2854)**:
   - *Ambito*: Prodotti connessi, IoT, fornitori di servizi di elaborazione dati (Cloud, PaaS, SaaS).
   - *Obblighi*: Interoperabilità dei dati, diritto di accesso e condivisione dei dati generati dall'utente, eliminazione delle penali ingiustificate di switching tra cloud provider, presidi contro l'accesso extraterritoriale non UE.

8. **European Health Data Space (EHDS - Regolamento UE 2025/327)**:
   - *Ambito*: Sistemi software per cartelle cliniche elettroniche (EHR), software biomedicali, sanità digitale.
   - *Obblighi*: Formato europeo interoperabile (EEHRxF), tracciabilità completa degli accessi ai dati sanitari, audit logging non ripudiabile, segregazione logica rigorosa dei dati sanitari primari e secondari.

9. **Medical Device Regulations (MDR UE 2017/745 & IVDR UE 2017/746)**:
   - *Ambito*: Software as a Medical Device (SaMD) impiegato a fini diagnostici o terapeutici.
   - *Obblighi*: Marcatura CE medicale, gestione del ciclo di vita software secondo norma EN 62304, gestione dei rischi clinici ISO 14971, tracciabilità UDI (Unique Device Identifier).

10. **Markets in Crypto-Assets & Transfer of Funds (MiCA Reg. UE 2023/1114 & TFR Reg. UE 2023/1113)**:
    - *Ambito*: Software per emissione o intermediazione di crypto-asset, smart contract, wallet provider (CASP).
    - *Obblighi*: Audit di sicurezza formale degli smart contract, Travel Rule per il tracciamento dei trasferimenti, whitepaper regolamentato, presidi di resilienza e separazione fondi.

11. **Data Governance Act (DGA - Regolamento UE 2022/868)**:
    - *Ambito*: Piattaforme di intermediazione dati e data altruism.
    - *Obblighi*: Neutralità dell'intermediario dei dati, divieto di riutilizzo dei dati transitati per scopi propri, notifica formale alle autorità nazionali di vigilanza.

12. **European Accessibility Act (EAA - Direttiva UE 2019/882)**:
    - *Ambito*: E-commerce, bancomat, servizi bancari, app mobili per i consumatori, servizi di trasporto.
    - *Obblighi*: Piena conformità allo standard europeo EN 301 549 e WCAG 2.1 livello AA, supporto a tecnologie assistive, dichiarazione di accessibilità obbligatoria.

13. **Direttiva Copyright nel Mercato Unico Digitale (DSM - Direttiva UE 2019/790)**:
    - *Ambito*: Piattaforme di content sharing, modelli di Text and Data Mining (TDM) per addestramento AI.
    - *Obblighi*: Rispetto della riserva dei diritti (Opt-out Art. 4 TDM), licenze per opere protette, meccanismi di Notice & Take Down non arbitrari.

14. **Direttiva ePrivacy (Direttiva 2002/58/CE aggiornata)**:
    - *Ambito*: Applicazioni web, app mobili, telecomunicazioni, tracciamento utenti.
    - *Obblighi*: Consenso preventivo per cookie non tecnici, pixel e SDK di terze parti, riservatezza delle comunicazioni elettroniche, divieto di fingerprinting non autorizzato.

15. **Direttiva Omnibus / Tutela dei Consumatori (Direttiva UE 2019/2161)**:
    - *Ambito*: Piattaforme e-commerce e marketplace digitali B2C.
    - *Obblighi*: Trasparenza assoluta su recensioni autenticate, prezzi personalizzati tramite profilazione algoritmica, parametri di posizionamento/ranking dei risultati di ricerca.

16. **Corporate Sustainability Due Diligence & Green IT (CSRD Dir. UE 2022/2464 & Ecodesign)**:
    - *Ambito*: Software aziendale, data center, infrastrutture cloud ad alto assorbimento.
    - *Obblighi*: Tracciamento emissioni Scope 3 ICT, misurazione efficienza energetica del codice (Green Coding / PUE), rendicontazione di sostenibilità digitale.

17. **Product Liability Directive per Software & AI (PLD - Direttiva UE 2024/2853)**:
    - *Ambito*: Produttori di software e fornitori di sistemi AI.
    - *Obblighi*: Responsabilità oggettiva per danni derivanti da software difettoso o patch di sicurezza omesse, obbligo di disclosure documentale delle evidenze tecniche in sede di contenzioso.

---

### 2.2 Tabella Sinottica delle Normative, Presidi e Scadenze

| Sigla Norma | Riferimento Ufficiale | Natura Giuridica | Presidi Chiave Imposti | Severità Predefinita |
| :--- | :--- | :--- | :--- | :--- |
| **CRA** | Regolamento (UE) 2024/2847 | Regolamento UE | SBOM CycloneDX, RFC 9116 security.txt, patch 5 anni | **BLOCKER** |
| **GDPR** | Regolamento (UE) 2016/679 | Regolamento UE | Privacy by Design, Registro Trattamenti, DPIA, Cifratura | **BLOCKER** |
| **EU AI ACT** | Regolamento (UE) 2024/1689 | Regolamento UE | Classificazione rischio AI, test bias, marcatura output AI | **BLOCKER** |
| **NIS 2** | Direttiva (UE) 2022/2555 | Direttiva UE | Supply chain security, MFA obbligatorio, Incident reporting | **BLOCKER** |
| **DORA** | Regolamento (UE) 2022/2554 | Regolamento UE | Test TLPT, registro outsourcing ICT, RTO/RPO finanziario | **BLOCKER** |
| **eIDAS 2** | Regolamento (UE) 2024/1183 | Regolamento UE | OpenID4VP, EUDI Wallet, Firme digitali QES | **HIGH** |
| **DATA ACT** | Regolamento (UE) 2023/2854 | Regolamento UE | Switching cloud senza penali, portabilità dati generati | **HIGH** |
| **EHDS** | Regolamento (UE) 2025/327 | Regolamento UE | Formato EEHRxF, audit logging sanitario non ripudiabile | **BLOCKER** |
| **MDR/IVDR**| Regolamenti 2017/745 & 746 | Regolamento UE | Norma EN 62304, risk analysis ISO 14971, Marcatura CE | **BLOCKER** |
| **MiCA/TFR** | Regolamenti 2023/1114 & 1113| Regolamento UE | Audit smart contract, Travel Rule, segregazione fondi | **BLOCKER** |
| **DGA** | Regolamento (UE) 2022/868 | Regolamento UE | Neutralità intermediazione dati, notifica vigilanza | **MEDIUM** |
| **EAA** | Direttiva (UE) 2019/882 | Direttiva UE | Standard EN 301 549, WCAG 2.1 AA, accessibilità B2C | **HIGH** |
| **COPYRIGHT**| Direttiva (UE) 2019/790 | Direttiva UE | Opt-out TDM Art. 4, licenze content sharing | **MEDIUM** |
| **ePRIVACY** | Direttiva 2002/58/CE | Direttiva UE | Consenso cookie/SDK, divieto fingerprinting | **HIGH** |
| **OMNIBUS** | Direttiva (UE) 2019/2161 | Direttiva UE | Trasparenza recensioni, disclosure prezzi algoritmici | **MEDIUM** |
| **CSRD** | Direttiva (UE) 2022/2464 | Direttiva UE | Tracciamento Scope 3 ICT, policy Green Coding | **MEDIUM** |
| **PLD** | Direttiva (UE) 2024/2853 | Direttiva UE | Conservazione evidenze tecniche, liability da difetto | **HIGH** |

---

## 3. Architettura Funzionale a 5 Fasi Sequenziali

L'architettura del sistema è strutturata su un flusso a 5 fasi sequenziali e disaccoppiate:

```
┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│     FASE 1      │     │     FASE 2      │     │     FASE 3      │     │     FASE 4      │     │     FASE 5      │
│ Ingestion Multi-│────>│ Triage Semantico│────>│ Smart Checklist │────>│ Code Validation │────>│ Quality Gate &  │
│ File Progressiva│     │ & Questionario  │     │ Dinamica (Live) │     │ (Downstream)    │     │ Compliance File │
└─────────────────┘     └─────────────────┘     └─────────────────┘     └─────────────────┘     └─────────────────┘
```

---

### 3.1 Fase 1: Ingestion Multi-Fase & Multi-File Progressiva

#### Funzionalità e Requisiti
- **Upload Multi-File Contemporaneo**: l'utente può trascinare o selezionare contemporaneamente uno o più documenti di progetto.
- **Formati Supportati**: `.md`, `.txt`, `.pdf`, `.json`, `.yaml`, `.docx`, `.py`, `.java`, `.js`, `.go`, `.rs`, `.c`, `.cpp`, `.html`.
- **Tipizzazione Contestuale**: per ogni file in coda, l'utente seleziona la tipologia da un menu a tendina:
  1. `PRD`: Specifiche Funzionali / Product Requirements Document
  2. `ARCH`: Architettura Software & Modello Dati
  3. `SECURITY`: Threat Model & Analisi Rischi
  4. `CRA_TECH`: Fascicolo Tecnico / CRA Dossier
  5. `PRIVACY`: Privacy Policy & DPIA (GDPR)
  6. `OTHER`: Altro Documento Tecnico
- **Descrizione Testuale Opzionale**: se vengono caricati documenti, il campo di testo per la descrizione libera diventa opzionale; se non vengono caricati documenti, è richiesto un testo di specifica minimo.
- **Parsing e Normalizzazione**: il modulo `document_parser.py` estrae il testo pulito decodificando codifiche multiple (UTF-8, Latin-1, CP1252) ed estraendo metadati strutturati.
- **Hashing SHA-256 e Tracciamento**: a ciascun documento caricato viene assegnato un hash univoco calcolato sui byte originali, inserito nel vault effimero della sessione per garantire l'integrità e la non alterazione durante l'audit.

---

### 3.2 Fase 2: Triage Semantico Proattivo & Questionario Interattivo

#### Motore di Triage Semantico (`grc_triage_engine.py`)
Il motore analizza i testi ingeriti e la descrizione del progetto mediante token semantici ed espressioni regolari calibrate:
- *Esempio GDPR*: rilevazione di termini come `user`, `personal data`, `email`, `login`, `customer`, `profiling`, `gdpr`.
- *Esempio CRA*: rilevazione di software distribuito commercialmente, binari, app mobile, SaaS venduto in UE.
- *Esempio AI Act*: rilevazione di `llm`, `neural network`, `machine learning`, `predictive model`, `genai`.
- *Esempio NIS 2*: rilevazione di infrastrutture critiche, PA, energia, sanità, cloud provider.
- *Esempio DORA*: rilevazione di banche, pagamenti, core banking, fintech.

#### Generazione del Questionario Proattivo (Deep-Dive Survey)
Qualora la documentazione presenti ambiguità o lacune, il sistema genera proattivamente domande a risposta chiusa mirate a confermare o escludere specifici regimi normativi.
- *Esempio Domanda AI*: "Il software integra o intende integrare modelli di intelligenza artificiale o LLM per decisioni automatizzate o generazione contenuti?" -> Rispondendo "Sì", il regime `EU_AI_ACT` viene immediatamente aggiunto con tutti i presidi correlati.
- *Esempio Domanda NIS 2*: "L'organizzazione o il cliente target opera come soggetto critico o importante nei settori della Direttiva NIS 2?" -> Rispondendo "Sì", si attivano i requisiti di supply chain e incident reporting a 24h.
- *Conferma Perimetro*: l'utente può confermare o disattivare selettivamente i regimi prima di passare alla generazione della checklist.

---

### 3.3 Fase 3: Smart GRC Checklist Dinamica

#### Generatore della Matrice di Conformità (`grc_checklist_generator.py`)
Genera la lista viva dei controlli normativi derivata dall'intersezione di tutti i regimi attivi:
- **Tassonomia dei Controlli**:
  - `Control ID`: identificatore standard (es. `CRA-SBOM-01`, `CRA-CVD-02`, `GDPR-CONSENT-01`, `AIACT-RISK-01`).
  - `Domain`: area di pertinenza (Software Supply Chain, Privacy & Personal Data, AI Governance, Network & Operational Resilience, ecc.).
  - `Title`: titolo del presidio (localizzato nella lingua corrente).
  - `Legal Reference`: articolo e comma della normativa UE di riferimento (es. *Reg. UE 2024/2847 Art. 10 & All. I.2*).
  - `Criticality`:
    - `BLOCKER`: presidio inderogabile. La sua violazione comporta automaticamente il verdetto NO-GO al Quality Gate.
    - `HIGH`: presidio ad alto impatto. Richiede rimozione o formale deroga CISO.
    - `MEDIUM`: presidio procedurale o raccomandazione.
  - `Verification Mode`: `DOC_VERIFIED` (verificato su documentazione/PRD) vs. `PENDING_CODE_VALIDATION` (richiede ispezione del codice sorgente).
- **Ciclo di Vita dello Stato di un Controllo**:
  ```
  [PENDING_DOC] ──> [DOC_VERIFIED] ──> [PENDING_CODE_VALIDATION] ──> [VERIFIED_IN_CODE]
          │                                      │
          └───> [VIOLATED] <─────────────────────┘
                    │
                    └───> [EXCEPTION_GRANTED] (Previa firma CISO)
  ```

---

### 3.4 Fase 4: Downstream Code & Artifact Validation

#### Motore di Validazione Tecnica (`grc_code_validator.py`)
In questa fase downstream, il sistema esegue una scansione oggettiva del codice sorgente fornito tramite repository Git, archivio ZIP o snippet multifile:
1. **Verifica Cyber Resilience Act (CRA-CVD-02)**:
   - Scansione deterministica alla ricerca del file `security.txt` conforme allo standard RFC 9116 in `.well-known/security.txt` o nella root.
   - Verifica della presenza di `Contact:`, `Expires:`, e chiavi crittografiche per il Coordinated Vulnerability Disclosure. Se assente, il controllo `CRA-CVD-02` passa a `VIOLATED` con criticità `BLOCKER`.
2. **Generazione Automatica dello SBOM CycloneDX v1.5 (CRA-SBOM-01)**:
   - Scansione automatica dei manifest di dipendenze: `requirements.txt`, `Pipfile`, `pyproject.toml`, `package.json`, `pom.xml`, `go.mod`, `Cargo.toml`.
   - Estrazione dei componenti, versioni, licenze software e calcolo dell'identificativo Package URL (PURL).
   - Generazione del documento formale JSON conforme allo standard CISA/NIST CycloneDX v1.5. Se il software non presenta distinte o dipendenze tracciate, viene generato rilievo bloccante.
3. **Scansione Secret Leaks & Hardcoded Credentials**:
   - Pattern matching ed entropia Shannon per rilevare chiavi API, token JWT, certificati privati e password nel codice. La presenza di credenziali in chiaro viola i presidi di Security-by-Design del CRA e di NIS 2.
4. **Scansione SAST (Static Application Security Testing)**:
   - Rilevazione di pattern di vulnerabilità (SQL Injection, Command Injection, Insecure Deserialization, XSS, configurazioni TLS deboli).
5. **Correlazione con la Smart Checklist**:
   - I risultati della scansione aggiornano automaticamente lo stato di ciascun controllo della checklist (`VERIFIED_IN_CODE` per controlli superati, `VIOLATED` con file e riga esatta per controlli falliti).

---

### 3.5 Fase 5: Decision Gate, Registro Deroghe CISO & Deliverable

#### Algoritmo di Delibera del Quality Gate (`grc_gate_engine.py`)
Il Quality Gate valuta l'intero stato della sessione calcolando il **Compliance Score** (percentuale dei controlli conformi o validamente derogati sul totale dei controlli applicabili) ed emette uno dei tre verdetti vincolanti:
- 🟢 **AUTORIZZATO (GO)**:
  - 100% dei presidi conformi (`VERIFIED_IN_CODE` o `DOC_VERIFIED`).
  - Nessun Blocker aperto. Nessuna violazione residua.
- 🟡 **CONDIZIONATO (CONDITIONAL)**:
  - Presenza di controlli nello stato `EXCEPTION_GRANTED` (deroghe CISO regolarmente firmate).
  - Oppure presenza di rilievi non bloccanti con piano di rientro formale.
  - Il rilascio in produzione è consentito esclusivamente nei limiti della deroga concessa.
- 🔴 **BLOCCATO (NO-GO)**:
  - Anche **un solo controllo Blocker violato** (`VIOLATED`) e non coperto da deroga formale approvata.
  - Deployment categoricamente interrotto.

#### Registro Formale delle Deroghe & Risk Acceptance Sign-Off
La piattaforma include un sistema integrato di gestione del rischio formale:
- Qualora un controllo risulti violato ma il business o esigenze tecniche temporanee richiedano il rilascio, un soggetto autorizzato (CISO o DPO) può invocare l'endpoint `/api/grc/session/grant-exception`.
- **Dati Obbligatori della Deroga**:
  - `item_id`: identificativo del controllo oggetto di deroga (es. `CRA-CVD-02`).
  - `signed_by`: nome e cognome del firmatario.
  - `role`: qualifica formale (es. *CISO*, *Data Protection Officer*, *Head of Security*).
  - `rationale`: motivazione tecnica ed economica vincolante per l'accettazione del rischio residuo.
  - `expires_at`: data perentoria di scadenza della deroga (dopo la quale la deroga decade e il Quality Gate torna in NO-GO).
  - `signature_hash`: calcolo automatico dell'impronta crittografica SHA-256 della transazione di deroga per garantire non-ripudiabilità e trasparenza negli audit.

#### Deliverable Esportabili
1. **GRC Compliance Dossier HTML** (`/api/grc/session/{id}/dossier.html?lang={lang}`): fascicolo formale di conformità navigabile, stampabile in PDF per comitati direttivi, auditor esterni o autorità di controllo.
2. **CycloneDX v1.5 JSON SBOM** (`/api/grc/session/{id}/sbom.cyclonedx.json`): file machine-readable per scanner di vulnerabilità e sistemi di compliance di terze parti.
3. **Fascicolo Tecnico CRA (Marcatura CE)** (`/api/grc/session/{id}/cra-technical-file.json`): documento tecnico strutturato contenente la dichiarazione di conformità ai requisiti essenziali dell'Allegato I del Regolamento UE 2024/2847.
4. **Attestato Crittografico Anti-Manomissione (Tamper-Proof SHA-256 Digest)**: stringa crittografica univoca calcolata sull'unione dello score, del verdetto, della distinta SBOM e della checklist. Qualsiasi alterazione a posteriori invalida l'attestato.

---

## 4. Architettura di Internazionalizzazione Multilingua Reattiva (i18n)

La piattaforma supporta integralmente 5 lingue ufficiali: **Italiano (`it`)**, **Inglese (`en`)**, **Spagnolo (`es`)**, **Francese (`fr`)**, **Tedesco (`de`)**.

### 4.1 Modello di Traduzione Client-Side a Zero Latenza
Nel frontend ([`frontend/index.html`](file:///root/projects/DevWithBrain/frontend/index.html)), l'internazionalizzazione è implementata con un'architettura ibrida dichiarativa e programmatica:
- **Attributi Dichiarativi**: tutti gli elementi statici utilizzano `data-i18n="chiave"` per i contenuti testuali e `data-i18n-ph="chiave"` per i placeholder dei campi di input.
- **Dizionari Centralizzati**:
  - `TRANSLATIONS`: oltre 180 voci lessicali per ogni lingua.
  - `REGIMES_I18N`: testi completi, basi legali e descrizioni per tutte le 17 normative europee in 5 lingue.
  - `QUESTIONS_I18N`: domande, risposte e impatti del questionario proattivo per tutte le 5 lingue.
  - `CHECKLIST_I18N`: titoli e descrizioni di tutti i presidi in 5 lingue.
- **Reattività Istantanea (`selectLanguage`)**: il cambio lingua non richiede refresh della pagina né chiamate HTTP al server. La funzione esegue l'aggiornamento istantaneo del DOM e riesegue il re-render di tutti i componenti dinamici attivi (file in coda, questionari caricati, tabelle checklist e delibera del gate).

### 4.2 Localizzazione Server-Side dei Deliverable e Dossier HTML
Il generatore del dossier formale di audit ([`backend/app/engine/grc_dossier_generator.py`](file:///root/projects/DevWithBrain/backend/app/engine/grc_dossier_generator.py)) include il dizionario server-side `DOSSIER_I18N`. L'endpoint HTTP riceve il parametro `?lang={codice}` e compila l'intero documento HTML (titoli, tabelle, badge di stato, registro deroghe e clausole legali) rigorosamente nella lingua richiesta.

---

## 5. Stato dell'Arte Implementativo (Cosa è Stato Realizzato)

### 5.1 Struttura del Repository e Moduli Backend

```
/root/projects/DevWithBrain/
├── backend/
│   └── app/
│       ├── main.py                     # API Gateway FastAPI & Orchestratore GRC
│       ├── auth/
│       │   └── service.py              # Autenticazione, hashing bcrypt, 2FA TOTP & BYOK
│       └── engine/
│           ├── grc_session.py          # Session Store effimero & Modelli dati di sessione
│           ├── grc_triage_engine.py    # Motore semantico 17 normative & Questionario proattivo
│           ├── grc_checklist_generator.py # Generatore dinamico Smart Checklist dei presidi
│           ├── grc_code_validator.py   # Scanner codice, RFC 9116 security.txt & SBOM CycloneDX
│           ├── grc_gate_engine.py      # Motore decisionale Quality Gate & Attestazione SHA-256
│           ├── grc_dossier_generator.py# Generatore Fascicolo Tecnico HTML Multilingua (i18n)
│           ├── document_parser.py      # Parser universale file (MD, PDF, TXT, JSON, YAML, DOCX)
│           ├── ingestion.py            # Ingestion modulare e profiling architetturale
│           ├── security_scanner.py     # Scanner deterministico segreti e vulnerabilità
│           ├── resilience_scanner.py   # Scanner metriche complessità ciclomatica e churn
│           └── sbom_generator.py       # Builder standardizzato CycloneDX v1.5
├── frontend/
│   ├── index.html                      # Single Page Application reattiva Tailwind CSS & i18n
│   ├── help.html                       # Manuale operativo, guida token Git e documentazione
│   └── SPECIFICHE_PIATTAFORMA_GRC.md   # Copia statica delle specifiche pronta al download
├── docs/
│   ├── SPECIFICHE_PIATTAFORMA_GRC.md   # Master copy delle specifiche e architettura completa
│   └── grc_functional_specifications.md# Storico evolutivo delle specifiche
├── scripts/
│   ├── start_daemon.sh                 # Script di avvio processo in background
│   └── stop_server.sh                  # Script di arresto controllato del demone
└── tests/
    ├── test_grc_platform.py            # 13 Test E2E automatici su flusso GRC completo
    ├── test_audit_pipeline.py          # Test pipeline di audit downstream
    └── test_auth_and_byok.py           # Test autenticazione e sicurezza
```

---

### 5.2 Specifiche delle API REST (OpenAPI / Endpoints)

Tutte le API operano su protocollo HTTP/JSON, conformi alle convenzioni RESTful:

| Metodo | Endpoint | Descrizione | Parametri / Payload di Esempio |
| :--- | :--- | :--- | :--- |
| `POST` | `/api/grc/session/init` | Inizializza una nuova sessione GRC effimera | `{"project_name": "MySaaS"}` |
| `POST` | `/api/grc/session/upload-file` | Caricamento multipart di un singolo file con tipo | Form-Data: `session_id`, `doc_type`, `file` |
| `POST` | `/api/grc/session/ingest-docs` | Ingestion cumulativa di documentazione e testo | `{"session_id": "...", "title": "...", "content": "...", "doc_type": "PRD"}` |
| `POST` | `/api/grc/session/submit-answers` | Invia risposte al questionario proattivo | `{"session_id": "...", "answers": {"q_ai_act": "yes"}}` |
| `POST` | `/api/grc/session/confirm-perimeter`| Conferma perimetro ed emette la Smart Checklist | `{"session_id": "...", "confirmed_regimes": ["CRA", "GDPR"]}` |
| `POST` | `/api/grc/session/run-code-validation`| Esegue scansione codice su snippet o path Git | `{"session_id": "...", "code_path": "...", "raw_code_snippet": "..."}` |
| `POST` | `/api/grc/session/grant-exception`| Sottoscrive formale deroga CISO (Risk Acceptance) | `{"session_id": "...", "item_id": "CRA-CVD-02", "signed_by": "Mario Rossi", "role": "CISO", "rationale": "In corso di pubblicazione RFC 9116", "expiry_days": 30}` |
| `GET` | `/api/grc/session/{id}/dossier.html` | Restituisce il Fascicolo HTML di conformità | Query param: `?lang=it` (oppure `en`, `es`, `fr`, `de`) |
| `GET` | `/api/grc/session/{id}/sbom.cyclonedx.json` | Restituisce lo SBOM CycloneDX v1.5 JSON | N/A |
| `GET` | `/api/grc/session/{id}/cra-technical-file.json` | Restituisce il Fascicolo Tecnico Marcatura CE | N/A |
| `GET` | `/api/docs/specifications.md` | **Download diretto del presente documento Markdown** | Content-Disposition: `attachment; filename="SPECIFICHE_PIATTAFORMA_GRC.md"` |

---

### 5.3 Implementazione Frontend SPA
L'interfaccia utente è interamente contenuta in [`frontend/index.html`](file:///root/projects/DevWithBrain/frontend/index.html):
- **Stepping a 5 Fasi Visive**: barra di avanzamento dinamica numerata con indicatore di stato attivo, completato e bloccato.
- **Dropzone Multi-File**: supporta drag & drop, conteggio caratteri in tempo reale, rimozione singoli documenti prima dell'invio e lista interattiva dei documenti già acquisiti con timestamp e hash SHA-256.
- **Visualizzatore Matrice Controlli**: tabella ricca con filtri istantanei per criticità (`ALL`, `BLOCKER`, `VIOLATED`), badge colorati per stato e visualizzazione espandibile dei file/righe incriminati nei finding di violazione.
- **Finestra Modale di Deroga CISO**: dialog interattivo per la firma immediata delle deroghe con calcolo in tempo reale dell'impronta crittografica SHA-256 e aggiornamento istantaneo del Quality Gate.

---

### 5.4 Suite di Test Automatizzati e Risultati di Collaudo
Il sistema è corredato da una suite di test end-to-end completa eseguita tramite `pytest`:
```bash
PYTHONPATH=. .venv/bin/pytest tests/
======================== 13 passed, 2 warnings in 1.82s ========================
```
I test coprono:
- Inizializzazione sessione e parsing documenti multi-formato.
- Upload multi-file con tipizzazione contestuale (PRD, Architettura, Threat Model).
- Triage semantico automatico con attivazione dei regimi pertinenti.
- Generazione dinamica della checklist ed enforcement dei controlli Blocker.
- Rilevazione del file `security.txt` conforme a RFC 9116 per il Cyber Resilience Act.
- Generazione formale della distinta componenti CycloneDX v1.5 JSON.
- Generazione del Fascicolo Tecnico CRA per Marcatura CE.
- Registrazione ed enforcement delle deroghe CISO con transizione da NO-GO a CONDITIONAL.
- Generazione multilingua del Dossier HTML in tutte e 5 le lingue europee (`it`, `en`, `es`, `fr`, `de`).

---

## 6. Tecnologie Utilizzate e Standard Industriali

### 6.1 Backend Stack & Librerie
- **Linguaggio**: Python 3.12+ (tipizzazione statica rigorosa con `typing`, `Pydantic v2`).
- **Web Framework**: FastAPI (performance asincrone elevate su standard ASGI).
- **Server ASGI**: Uvicorn con gestione worker asincroni.
- **Crittografia & Sicurezza**:
  - `hashlib`: hashing crittografico SHA-256 per digest di conformità e impronte documenti.
  - `passlib` & `bcrypt`: hashing sicuro delle password di autenticazione.
  - `secrets`: generazione di token di sessione crittograficamente sicuri (CSPRNG).
- **Validazione Dati**: Pydantic v2 con modelli rigorosi per payload di sessione, checklist e deroghe.
- **Testing**: `pytest 9.x`, `starlette.testclient`, `httpx`.

### 6.2 Frontend Stack
- **Architettura**: Single Page Application (SPA) reattiva a zero dipendenze esterne di build (nessun bundle npm pesante, zero rischio supply chain su bundler).
- **Stile & Layout**: Tailwind CSS 3 via CDN con tema dark-mode moderno (*slate/indigo/sky*).
- **Iconografia**: FontAwesome 6 Pro CDN.
- **Logica Client**: Vanilla ES6+ JavaScript, reattività event-driven nativa, manipolazione sicura del DOM contro attacchi XSS.

### 6.3 Standard e Formati di Sicurezza Adottati
- **CycloneDX v1.5 JSON**: standard aperto per la distinta base software (SBOM) raccomandato da CISA, OWASP ed ENISA per la conformità al Cyber Resilience Act.
- **RFC 9116**: standard IETF per il formato e la collocazione del file `security.txt` per il Coordinated Vulnerability Disclosure.
- **EN 301 549 & WCAG 2.1 AA**: standard di accessibilità armonizzati europei richiamati dall'European Accessibility Act.
- **ISO/IEC 27001 & NIST CSF**: allineamento dei controlli ai framework internazionali di gestione della sicurezza delle informazioni.
- **CE Marking Technical Documentation**: schema di fascicolo tecnico secondo Regolamento (UE) 2024/2847 Allegato I.

---

## 7. Componenti Sistemistiche & Requisiti di Esecuzione (SysOps)

### 7.1 Requisiti Hardware (Minimi e Raccomandati)

| Risorsa Hardware | Requisito Minimo (Development / Test) | Requisito Raccomandato (Produzione / Enterprise) |
| :--- | :--- | :--- |
| **CPU** | 2 vCPU (x86_64 o ARM64) | 4+ vCPU (x86_64 o ARM64) |
| **RAM** | 2 GB RAM libera | 4 GB - 8 GB RAM libera |
| **Storage (Disco)** | 5 GB SSD (per venv, log e dipendenze) | 20 GB NVMe SSD |
| **Throughput Rete** | 100 Mbps | 1 Gbps |

*Nota di Sostenibilità*: l'architettura Zero-Data Retention basata su elaborazione in memoria richiede un consumo di storage permanente trascurabile, limitato esclusivamente all'installazione del software e alla rotazione dei log d'esercizio.

### 7.2 Requisiti Software, OS e Dipendenze Linux
- **Sistemi Operativi Supportati**:
  - Ubuntu Linux 22.04 LTS / 24.04 LTS (raccomandato)
  - Debian GNU/Linux 12 (Bookworm)
  - Red Hat Enterprise Linux (RHEL) 9 / Rocky Linux 9 / AlmaLinux 9
  - Alpine Linux 3.19+ (per container Docker ultra-leggeri)
- **Runtime e Strumenti di Sistema**:
  - Python 3.12 o superiore (`python3`, `python3-venv`, `python3-pip`).
  - `git` (per la clonazione e l'analisi dei repository downstream).
  - `curl` e `jq` (per verifiche sistemistiche da riga di comando).
  - `bash` (per l'esecuzione degli script di orchestrazione).

---

### 7.3 Topologia di Rete, Porte e Configurazione Tailscale Mesh

```
                     ┌──────────────────────────────────────────────┐
                     │            RETE AZIENDALE / TAILSCALE        │
                     │                 (WireGuard Mesh)             │
                     └──────────────────────┬───────────────────────┘
                                            │
                                  Porta TCP: 8080 (o 443 con TLS)
                                            ▼
                     ┌──────────────────────────────────────────────┐
                     │            HOST SERVER LINUX                 │
                     │  IP Tailscale: 100.122.89.117:8080           │
                     │                                              │
                     │   ┌──────────────────────────────────────┐   │
                     │   │ Reverse Proxy Nginx (Opzionale)      │   │
                     │   └──────────────────┬───────────────────┘   │
                     │                      │ localhost:8080        │
                     │   ┌──────────────────▼───────────────────┐   │
                     │   │ DevWithBrain GRC Daemon (FastAPI)    │   │
                     │   │ Process PID: Gestito da bash/systemd │   │
                     │   └──────────────────────────────────────┘   │
                     └──────────────────────────────────────────────┘
```

1. **Porta Principale di Ascolto**:
   - Porta TCP predefinita: `8080` (configurabile tramite variabile d'ambiente `PORT`).
   - Indirizzo di binding predefinito: `0.0.0.0` (ascolta su tutte le interfacce di rete).
2. **Accesso Protetto tramite Tailscale Mesh**:
   - La piattaforma è accessibile in modo sicuro attraverso la rete overlay Tailscale (crittografia punto-punto WireGuard a livello kernel, zero porte aperte su Internet pubblico).
   - Indirizzo attivo assegnato: `http://100.122.89.117:8080/`.
3. **Configurazione Reverse Proxy Nginx Consigliata (per Produzione Pubblica)**:
   ```nginx
   server {
       listen 443 ssl http2;
       server_name grc.tuodominio.eu;

       ssl_certificate /etc/letsencrypt/live/grc.tuodominio.eu/fullchain.pem;
       ssl_certificate_key /etc/letsencrypt/live/grc.tuodominio.eu/privkey.pem;

       client_max_body_size 50M;

       location / {
           proxy_pass http://127.0.0.1:8080;
           proxy_set_header Host $host;
           proxy_set_header X-Real-IP $remote_addr;
           proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
           proxy_set_header X-Forwarded-Proto $scheme;
           proxy_read_timeout 300s;
           proxy_connect_timeout 60s;
       }
   }
   ```

---

### 7.4 Gestione del Processo Demone e Systemd Service

#### 1. Gestione Rapida tramite Script Operativi Bash
Il progetto include due script nella directory `scripts/`:
- **Avvio Demone**:
  ```bash
  cd /root/projects/DevWithBrain
  ./scripts/start_daemon.sh
  ```
  Lo script attiva il virtualenv `.venv`, verifica le dipendenze, avvia il processo in background reindirizzando i log su `data/server.log` e salva il PID del processo su `data/server.pid`.
- **Arresto Demone**:
  ```bash
  cd /root/projects/DevWithBrain
  ./scripts/stop_server.sh
  ```
  Invia un segnale `SIGTERM` al processo registrato, attendendone la chiusura ordinata prima di rilasciare le risorse.

#### 2. Configurazione del Servizio Systemd per l'Avvio Automatico al Boot
Per installazioni permanenti su server Linux, è raccomandata la configurazione come servizio di sistema `systemd`:

Creare il file `/etc/systemd/system/devwithbrain.service`:
```ini
[Unit]
Description=DevWithBrain GRC Software Validation Platform
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/root/projects/DevWithBrain
ExecStart=/root/projects/DevWithBrain/.venv/bin/uvicorn backend.app.main:app --host 0.0.0.0 --port 8080 --workers 2
Restart=always
RestartSec=5
StandardOutput=append:/root/projects/DevWithBrain/data/server.log
StandardError=append:/root/projects/DevWithBrain/data/server.log
Environment="PYTHONPATH=/root/projects/DevWithBrain"
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
```

Attivazione del servizio:
```bash
sudo systemctl daemon-reload
sudo systemctl enable devwithbrain
sudo systemctl start devwithbrain
sudo systemctl status devwithbrain
```

---

### 7.5 Architettura di Deployment Containerizzato (Docker & Docker Compose)

Per gli ambienti che prediligono la containerizzazione e i cluster Kubernetes o Docker Swarm, la piattaforma è predisposta per l'esecuzione in container isolato.

#### Dockerfile Multi-Stage di Produzione
```dockerfile
# Stage 1: Build & Dependencies
FROM python:3.12-slim AS builder

WORKDIR /app
RUN apt-get update && apt-get install -y --no-install-recommends \
    build-essential git curl \
    && rm -rf /var/lib/apt/lists/*

COPY requirements.txt .
RUN pip install --no-cache-dir --user -r requirements.txt

# Stage 2: Runtime Finale Ultra-Leggero
FROM python:3.12-slim AS runner

WORKDIR /app
RUN apt-get update && apt-get install -y --no-install-recommends \
    git curl \
    && rm -rf /var/lib/apt/lists/* \
    && useradd -u 1001 -m -s /bin/bash grcuser

COPY --from=builder /root/.local /home/grcuser/.local
COPY --chown=grcuser:grcuser backend ./backend
COPY --chown=grcuser:grcuser frontend ./frontend
COPY --chown=grcuser:grcuser docs ./docs
COPY --chown=grcuser:grcuser data ./data

USER grcuser
ENV PATH=/home/grcuser/.local/bin:$PATH
ENV PYTHONPATH=/app
ENV PORT=8080

EXPOSE 8080

HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
  CMD curl -f http://localhost:8080/ || exit 1

CMD ["uvicorn", "backend.app.main:app", "--host", "0.0.0.0", "--port", "8080"]
```

#### docker-compose.yml
```yaml
version: '3.8'

services:
  devwithbrain-grc:
    build:
      context: .
      dockerfile: Dockerfile
    container_name: devwithbrain-grc
    restart: unless-stopped
    ports:
      - "8080:8080"
    environment:
      - PYTHONPATH=/app
      - PORT=8080
    volumes:
      - ./data:/app/data
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8080/"]
      interval: 30s
      timeout: 5s
      retries: 3
```

Avvio rapido via Docker Compose:
```bash
docker compose up -d --build
```

---

### 7.6 Monitoraggio, Logging e Manutenzione

1. **Gestione dei Log (`data/server.log`)**:
   - Il server scrive i log di accesso e gli eventi di audit su `data/server.log`.
   - Rotazione log consigliata con `logrotate` (`/etc/logrotate.d/devwithbrain`):
     ```
     /root/projects/DevWithBrain/data/*.log {
         weekly
         missingok
         rotate 8
         compress
         delaycompress
         notifempty
         copytruncate
     }
     ```
2. **Healthcheck e Sorveglianza Continua**:
   - Verifica di stato immediata da shell:
     ```bash
     curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:8080/
     # Ritorna 200 in caso di funzionamento regolare
     ```
3. **Smaltimento e Pulizia Sessioni**:
   - Poiché le sessioni di audit risiedono nella memoria di processo (`GRC_SESSION_STORE`), il riavvio periodico del demone (o il garbage collector interno basato su TTL) elimina completamente qualsiasi dato temporaneo delle analisi passate, garantendo la piena rispondenza alle policy di Zero-Data Retention.

---

## 8. Come Scaricare Questo Documento

Il presente documento è nativamente integrato nella piattaforma e può essere scaricato o consultato direttamente attraverso i seguenti canali:

1. **Download Diretto via Browser (Attachment HTTP)**:
   - URL: `http://100.122.89.117:8080/api/docs/specifications.md`
   - Facendo clic sul link o inserendolo nel browser, il file viene immediatamente scaricato con il nome `SPECIFICHE_PIATTAFORMA_GRC.md`.
2. **Download Diretto da Web UI**:
   - Nella barra di navigazione superiore della piattaforma ([`http://100.122.89.117:8080/`](http://100.122.89.117:8080/)), fare clic sul pulsante **"Specifiche GRC (.md)"** per avviare il download istantaneo.
3. **Download da Terminale / Shell via `curl`**:
   ```bash
   curl -O http://100.122.89.117:8080/api/docs/specifications.md
   ```
4. **Percorsi del File sul File System Locale del Server**:
   - File master di documentazione: [`/root/projects/DevWithBrain/docs/SPECIFICHE_PIATTAFORMA_GRC.md`](file:///root/projects/DevWithBrain/docs/SPECIFICHE_PIATTAFORMA_GRC.md)
   - Copia statica web frontend: [`/root/projects/DevWithBrain/frontend/SPECIFICHE_PIATTAFORMA_GRC.md`](file:///root/projects/DevWithBrain/frontend/SPECIFICHE_PIATTAFORMA_GRC.md)

---
*Fine del Documento di Specifiche Funzionali e Architetturali — Piattaforma DevWithBrain GRC v2.2*
