Come funziona
effettivamente "VenduSys".
VenduSys Non è né un monolite né uno sciame di microservizi. Si tratta di un piccolo insieme di servizi ben definiti, dotati di contratti espliciti, che si presentano attraverso un’unica API coerente e sono distribuiti nell’UE. Questa pagina ne offre una panoramica chiara e trasparente.
Case-to-Core™ è l’asse portante dell’apprendimento attraverso il quale un ecosistema diventa progressivamente comprensibile a se stesso — e attraverso il quale segnali, lacune conoscitive, incertezze e possibilità stimolano continuamente nuove riflessioni.
Dalla rete al
registro.
Ogni livello è un piccolo servizio con un nome specifico e un contratto esplicito. È possibile adottare l'intero stack oppure sostituire un singolo livello con uno proprio, mantenendo il resto.
Quattro entità.
Tutto il resto ne deriva.
Abbiamo descritto il modello in un post a parte. Di seguito ne riportiamo una sintesi.
Festa
Persone, organizzazioni, agenti. Acquirenti, venditori, operatori, partner: tutte rappresentazioni dello stesso record. L’identità è un grafo, non un tipo.
Cosa
Qualsiasi cosa offerta o posseduta. Prodotti, licenze, servizi, abbonamenti, risorse, tempo. Le varianti e i pacchetti si aggiungono a tutto ciò.
Sposta
Eventi che comportano il trasferimento di valori o diritti tra le parti. Ordini, resi, rinnovi, trasferimenti e controversie sono tutte operazioni gestite dalle macchine a stati.
Voce
Righe nel libro mastro. Il modello è concepito in modo tale che ogni operazione generi delle registrazioni, da cui vengono ricavati i rendiconti e i saldi.
Ogni flusso
è osservabile.
Elenchi, approvazioni, pagamenti, resi, rinnovi — rappresentati sotto forma di codice o grafici visivi. Ramificazioni, nuovi tentativi, riproduzioni, verifiche. Lo stato viene conservato; nulla viene eseguito una volta per tutte.
- EVT Evento di dominio
- CRON In programma
- API Chiamata diretta
- WHK Webhook esterno
- CDC Modifica al database
- Compila graficoPARSE
- Stato persistenteSTATE
- Fasi della spedizioneRUN
- Gestione dei tentativi di ricaricaRETRY
- Genera il registro di auditAUDIT
- DB Voci di contabilità generale
- PAY Pagamento / liquidazione
- MSG Notifica
- EXT Chiamata al connettore
- EVT Evento a valle
Cosa serve per correre.
I dettagli noiosi: hosting, residenza, RPO/RTO, osservabilità. Le cose che contano quando qualcosa va storto alle 2 del mattino di domenica.
- Hosting
- Vercel per l'API edge · cluster dedicati nell'UE per servizi stateful (Parigi)
- Archiviazione
- Postgres (Supabase) con replica logica · Archiviazione oggetti compatibile con S3 · pgvector per gli embedding
- Replica
- Multi-AZ all’interno della regione · repliche di lettura tra regioni · flusso CDC verso il data warehouse
- Failover
- RPO 0 · RTO 5 minuti per il registro e l'identità · 15 minuti per il catalogo
- Osservabilità
- OpenTelemetry di default · tracce per tenant · registro di audit strutturato · riproduzione del flusso di lavoro
- Crittografia
- TLS 1.3 in transito · AES-256 inattivi · BYOK su Enterprise · isolamento delle chiavi per tenant
- Residenza
- UE come impostazione predefinita · assegnazione delle regioni in Scale/Enterprise · esportazione dei dati in formato adatto alla revisione contabile