Architettura

Grafo delle dipendenze tra i microservizi backend del namespace ditta — depends_on derivato dai frontmatter delle pagine servizio.

Architettura del namespace `ditta`

Vista d'insieme delle dipendenze applicative tra i 13 microservizi backend deployati nel namespace ditta. Il grafo è generato a partire dai campi depends_on e consumed_by dichiarati nei frontmatter delle pagine servizio.

Le dipendenze infrastrutturali (PostgreSQL, NATS, Redis, MinIO) non sono rappresentate: tutti i servizi le usano e il grafo perderebbe leggibilità. Vedi la sezione Architettura della singola pagina servizio per i dettagli.

Grafo delle dipendenze

Frecce orientate da chi chiama verso chi viene chiamato. I colori raggruppano i servizi per categoria; i nodi tratteggiati rappresentano consumer esterni al backend (es. frontend Vue) o componenti speciali.

Diagramma disponibile lato client.

Servizi per categoria

Categoria	Servizi	Ruolo
Accesso dati	`node-postgrest-sidecar`	Esposizione dati tenant via REST/SQL
Import/Export	`node-excel-export` `node-excel-import`	Import/export verso/da formati office (Excel, CSV)
Output documenti	`node-print` `node-renderer`	Rendering template e stampa/conversione documenti
Eventing	`node-listen` `node-notification`	Notifiche multi-canale, propagazione eventi inter-servizio
Identità	`node-user-auth` `node-user-profiling`	Autenticazione, identità utente, ruoli/scope applicativi
Integrazione	`node-xmlvalidation`	Validazione e bridge con sistemi esterni
Orchestrazione	`node-orchestrator` `node-scheduler`	Coordinamento workflow, scheduling, esecuzione task asincrona
Storage	`node-storage`	Persistenza file e BLOB con accesso temporizzato

Matrice dipendenze

Tabella riepilogativa per consultazione rapida. La colonna Dipende da elenca i servizi chiamati da quello sulla riga; Consumato da elenca chi lo chiama.

Servizio	Dipende da	Consumato da
`node-excel-export`	`node-user-auth`	`frontend Vue`
`node-excel-import`	`node-user-auth`	`frontend Vue`
`node-listen`	nessuno	`node-orchestrator`, `node-notification`
`node-notification`	`node-user-auth`	`frontend Vue`, `node-orchestrator`
`node-orchestrator`	`node-user-auth`, `node-postgrest-sidecar`	`frontend Vue`, `node-scheduler`
`node-postgrest-sidecar`	`node-user-auth`	`frontend Vue`, `node-orchestrator`, `node-print`, `node-renderer`, `node-notification`
`node-print`	`node-user-auth`, `node-renderer`, `node-storage`	`frontend Vue`, `node-orchestrator`
`node-renderer`	`node-user-auth`, `node-storage`	`node-print`, `frontend Vue`
`node-scheduler`	`node-user-auth`, `node-orchestrator`	`frontend Vue`
`node-storage`	`node-user-auth`	`node-print`, `node-renderer`, `frontend Vue`
`node-user-auth`	`node-user-profiling`	`node-orchestrator`, `node-notification`, `node-storage`, `node-print`, `node-renderer`, `node-scheduler`, `node-excel-export`, `node-excel-import`, `node-xmlvalidation`, `node-postgrest-sidecar`, `ingress nginx (auth_request)`
`node-user-profiling`	nessuno	`node-user-auth`, `frontend Vue`
`node-xmlvalidation`	`node-user-auth`	`node-orchestrator`, `frontend Vue`

Come leggere il grafo

Hub di autenticazione: node-user-auth è il punto di ingresso per tutto il traffico HTTP autenticato (sub-request nginx). Quasi tutti i servizi dipendono da lui.
Hub di orchestrazione: node-orchestrator coordina i workflow asincroni; node-scheduler lo invoca per i job temporali; i moduli registrati ricevono task via NATS.
Pipeline documenti: node-renderer produce HTML/sorgenti dai template, node-print li converte in PDF/etichette, node-storage archivia entrambi.
Identità composta: node-user-auth (autenticazione) e node-user-profiling (autorizzazione/ruoli) sono complementari — vedi le rispettive pagine per la divisione delle responsabilità.
Accesso dati: node-postgrest-sidecar è il bus unico verso PostgreSQL per i microservizi che non parlano SQL direttamente (frontend Vue, orchestratore, renderer).

Architecture

Vista high-level dei 13 microservizi backend e delle loro dipendenze.