Skip to main content

🌊 Data Flow & Architecture

Benvenuto nella documentazione dei flussi dati di Visla Platform. Qui troverai i dettagli su come i dati GPS e gli eventi fluiscono attraverso i microservizi.

📚 Indice dei Documenti​

1. Panoramica Architetturale (Redis vs Isolated) (architecture_streams.md)​

Una visione d'alto livello che separa i servizi "Real-Time" (che dipendono da Redis) dai servizi "Isolati" (CRUD/API).

  • Capire a colpo d'occhio: Chi vive nel flusso veloce e chi gestisce l'anagrafica.

2. Gerarchia delle Dipendenze (La Piramide) (dependency_pyramid.md)​

Un diagramma gerarchico che mostra i livelli di elaborazione, dall'Ingestione (Decoder) alla Reazione (Notifiche).

  • Capire la logica: Chi comanda su chi? (Es. Events comanda Notification).

3. Flussi Stream Dettagliati (Position & Presence) (stream_flows.md)​

Il diagramma tecnico completo del percorso dei dati.

  • Dettaglio tecnico: Decoder -> Raw -> Filter -> Validated -> WebSocket.

4. Audit Consumatori Stream (stream_consumers.md)​

Un'analisi precisa di quali microservizi consumano lo stream positions:validated e quali invece lo ignorano.

  • Per gli sviluppatori: Chi sto impattando se tocco lo stream validato?

5. Logica di Notifica (notification_flow.md)​

Spiegazione specifica di come il servizio Notifiche riceve l'input ("trigger") dal servizio Eventi.

  • Focus specifico: Analisi del meccanismo XADD/XREADGROUP tra Events e Notification.