[DOCS] CLAUDE.md aggiornato: FeedbackService, controller, endpoint, contatore file

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

CLAUDE.md

@@ -2,8 +2,8 @@
 
 ## PRIMA DI INIZIARE
 - Leggi sempre questo file prima di iniziare qualsiasi lavoro
-- Il progetto e' al **100% di completamento + Sprint Simulazioni + Audit Chain** (~32.000 righe, 80+ file sorgente)
+- Il progetto e' al **100% di completamento + Sprint Simulazioni + Audit Chain + Sistema Feedback AI** (~34.000 righe, 85+ file sorgente)
-- 11 commit su main, tutto deployato e testato su Hetzner
+- 15 commit su main, tutto deployato e testato su Hetzner
 - E2E test completati, bug fixing, Docker verificato, UI polished
 > 3. `docs/CONTEXT_LAST_SESSION.md` - **Contesto ultima sessione (continuita cross-browser)**
 >
@@ -130,13 +130,15 @@ nis2.agile/
 │   │   ├── ServicesController.php     # Services API (read-only, API Key + scope)
 │   │   ├── WebhookController.php      # CRUD api_keys + webhook_subscriptions
 │   │   ├── WhistleblowingController.php # Segnalazioni anonime Art.32 NIS2
-│   │   └── NormativeController.php    # Feed NIS2/ACN/DORA con ACK tracciato
+│   │   ├── NormativeController.php    # Feed NIS2/ACN/DORA con ACK tracciato
+│   │   └── FeedbackController.php     # Sistema segnalazioni bug/UX con risoluzione AI autonoma
 │   ├── services/                      # 6 servizi
 │   │   ├── AIService.php              # Anthropic Claude API (gap, risk, policy, incident)
 │   │   ├── EmailService.php           # Email CSIRT, training, welcome, invite
 │   │   ├── RateLimitService.php       # Rate limiting file-based
 │   │   ├── ReportService.php          # Report esecutivo HTML, export CSV
 │   │   ├── WebhookService.php         # Delivery webhook HMAC-SHA256, retry 3x
+│   │   └── FeedbackService.php        # createReport, classifyWithAI, broadcastResolution
 │   │   └── VisuraService.php          # AI extraction PDF visura + CertiSource API
 │   ├── models/                        # (vuoto - logica nei controller)
 │   └── data/
@@ -258,6 +260,12 @@ Schema: `docs/sql/` (9 migrazioni: 001→009)
 - Delivery HMAC-SHA256 Stripe-like, header X-NIS2-Signature
 - Retry 3x backoff (0s/5min/30min), log in webhook_deliveries
 
+### FeedbackService.php (NUOVO)
+- `createReport()`: INSERT + classifyWithAI() sincrono (10s timeout)
+- `classifyWithAI()`: chiama AIService::classifyFeedback(), aggiorna DB silenziosamente
+- `broadcastResolution()`: email a tutti i membri org via EmailService::sendFeedbackResolved()
+- Worker autonomo: `scripts/feedback-worker.php` (cron 30min, docker exec nis2-agile-devenv + Claude Code CLI)
+
 ### simulate-nis2.php (ROOT — NUOVO)
 - Script simulazione demo 3 aziende × 5 scenari (CLI + SSE streaming)
 - Aziende: DataCore (IT/Essential), MedClinic (Sanità/Important), EnerNet (Energia/Critical)
@@ -319,6 +327,7 @@ Base: `/api/{controller}/{action}/{id?}` (su subdomain https://nis2.agile.softwa
 ### Webhooks: GET api-keys, subscriptions, deliveries | POST api-keys, subscriptions, subscriptions/{id}/test, retry | PUT subscriptions/{id} | DELETE api-keys/{id}, subscriptions/{id}
 ### Whistleblowing: POST submit, {id}/assign, {id}/close | GET list, {id}, stats, track-anonymous | PUT {id}
 ### Normative: GET list, {id}, pending, stats | POST {id}/ack, create
+### Feedback: POST submit | GET mine, list, {id} | PUT {id} | POST {id}/resolve
 
 ## Stato Completamento
 Tutti i moduli sono implementati e testati:
@@ -347,20 +356,34 @@ Tutti i moduli sono implementati e testati:
 | **Password IDE** | Nis2AgileDev2026! |
 | **Produzione** | https://nis2.agile.software/ |
 
-## Documentazione Commerciale
+## Documentazione Commerciale AgentAI (aggiornato 2026-03-09)
 
-> Standard grafici e workflow: `/opt/devenv/COMMERCIAL_STANDARDS.md`
+> QUESTO ANNULLA LE ISTRUZIONI PRECEDENTI sulla documentazione commerciale.
+> Standard completo: /opt/devenv/COMMERCIAL_STANDARDS.md
+> Stato prodotti: /opt/agent-ai/hub/AGENTAI_SPECS.md
 
-5 documenti per il catalogo Agent AI:
+### Regole NUOVE (in vigore)
-1. Landing Page - `/opt/agent-ai/hub/landing/nis2-agile.html`
+- Landing page e presentazione vanno nel TUO repo (docs/agentai/ o dove preferisci)
-2. Scheda Funzionale - `products.json -> detail.funzionale`
+- products.json (/opt/agent-ai/hub/products.json) e SOLO un indice con URL assoluti
-3. Scheda Tecnica - `products.json -> detail.tecnica`
+- Aggiorna products.json con https://tuo-dominio/path-al-file.html
-4. Presentazione - `/opt/agent-ai/hub/presentations/nis2-agile.html`
+- La landing DEVE includere un link/bottone per registrazione o richiesta informazioni
-5. Link Demo - `products.json -> links.demo`
+- mktg.agile.software legge products.json per campagne marketing
+
+### Regole OBSOLETE (non fare piu)
+- NON scrivere file in /opt/agent-ai/hub/landing/
+- NON scrivere file in /opt/agent-ai/hub/presentations/
+- NON usare path relativi in products.json
+- Le directory landing/ e presentations/ nel hub sono VUOTE
+
+### Workflow
+1. Scrivi landing/presentazione nel tuo repo
+2. Commit + push (webhook aggiorna /var/www/)
+3. Chiedi conferma utente
+4. Aggiorna products.json con URL assoluto
+5. Verifica URL raggiungibile
 
 ### REGOLA
 > SEMPRE chiedere conferma utente PRIMA di generare documenti commerciali.
-
 ## REGOLA: Sincronizzazione CLAUDE.md
 - Dopo QUALSIASI modifica a: URL produzione, dominio, porta, path, schema DB, architettura -> **AGGIORNARE CLAUDE.md IMMEDIATAMENTE**
 - CLAUDE.md e la "single source of truth" del progetto