Documentazione — indice

La documentazione è un tassello fondante: si scrive e si aggiorna insieme al codice. Vedi la policy di documentazione.

📄 Technical Overview — panoramica condivisibile del prodotto (cos'è, cosa fa, come si espande, direzione).

🛠️ Guida allo sviluppo — orientamento pratico: come funziona il progetto e come svilupparci.

🌐 Sito di documentazione — questi stessi documenti, con navigazione per percorsi, ricerca e pagine interattive. Si legge nell'app desktop (pulsante Guida, ADR-0044) o in locale con pnpm run docs:dev. Come è costruito e dove si aggiunge una pagina: policy di documentazione § Il sito.

Percorsi (pagine del sito)

• Come si usa Noeva ETL — app desktop, esito di una run
• Creare con Claude Code — compositore del prompt, comandi, subagent e skill
• Il grafo, nodo per nodo e le decisioni del progetto — pagine interattive

Convenzioni (regole del team)

• Standard di codifica
• Strategia di test — i test non sono opzionali
• GraphRunReport — il risultato di una run (stdout JSON, stateless)
• Descriptor dei nodi — che connettore è / dove punta (UI del DAG)
• Colonne dei nodi — quali campi scorrono nel nodo (UI del DAG)
• Git workflow
• Policy di documentazione

Architettura

• Panoramica architetturale
• Architecture Decision Records (ADR)

Operatività

• Connettori — Source/Sink verso sistemi reali (es. PostgreSQL)
• Gestione issue — pianificazione, triage, label, board
• Runbook — procedure operative/recovery (template)
• Deploy batch (ECR/Docker) — modalità etl run
• Worker daemon — modalità etl worker, poller su processes (una istanza serve N workspace, ADR-0021)
• Server grafi — modalità etl serve, topologia delle pipeline via HTTP per la UI
• Database di test locali — Postgres, SQL Server, MinIO, SFTP via docker compose
• Version bump dei file Noeva — test di integrazione manuale del bump di versione di un file Noeva
• Sito di documentazione su Cloudflare — deploy, Access e rollback della variante pubblica (ADR-0045)

Per gli agenti

• docs/agents/ — configurazione letta dalle skill engineering: issue tracker, label di triage, domain doc
• docs/plans/ — piani di implementazione storici (luglio 2026): registro, non riferimento aggiornato

Governance dell'agente

Le regole vincolanti per gli agenti AI e il team sono in CLAUDE.md. I comandi e la skill dell'agente sono in .claude/.