Fonte della legge
Schema, metadati e policy del database diventano un modello canonico affidabile.
Software Engines Architecture 2.0
Sistemi complessi.Regole chiare.Dati mai persi.
SIRUCES è un’officina di motori software indipendenti e riutilizzabili. Le regole nascono dal database, i moduli comunicano solo attraverso l’HUB e ogni passaggio resta deterministico, tracciabile e recuperabile.
01Fonte autorevole
01HUB di connessione
0Dati persi
SIRUCES / RUNTIMEGATE VERDE
01EGRRegole
02VEGRValida
ConnectorHUB
03ERR_EGRGoverna
04COMMITConsolida
INPUT VALIDATE COMMIT RECOVER
Il database definisce.
L’HUB connette.
I motori decidono.
La UI mostra.
Una nuova idea di software
Non un monolite.
Un’officina.
Ogni componente ha una responsabilità precisa, un contratto stabile e nessuna conoscenza nascosta degli altri moduli.
Separazione reale
Nessuna UI chiama direttamente un motore. Ogni scambio passa da porte e HUB.
No-loss by design
Se un commit fallisce, il payload resta custodito e pronto al recupero.
La funzione più evoluta nata nell’app
Importare dati massivi.
Senza mille “if” nella UI.
VEGR_IMPORT nasce da una necessità concreta del gestionale assicurativo ed è ancora integrato nell’app. Non è un semplice caricatore di file: è un editor operativo massivo in RAM che accompagna l’intero lavoro, dal record grezzo fino al commit dei soli dati conformi.
ENTITÀ DBana_cli
FASEEditor RAM
FILEclienti.csv
RIGHE ATTIVEDATASET
CAMPI LINKED03
Mapping da metadata EGR6 campi · 6 assegnati
AcodcliTEXTBcognomeTEXTCnomeTEXTDtipo_anaLINK · FKEcodfiscTEXTFobsoletoBOOL
#CODCLICOGNOMENOMETIPO_ANAESITOAZIONI
148CL-0148RossiMaria1 · PersonaOKModifica
149CL-0149BianchiPaolo—KOCorreggi
150CL-0150VerdiAnna2 · AziendaOKModifica
TOTALIRAM
VALIDIOK
SCARTIKO
VEGR ha separato gli esiti. La pagina non ha deciso nulla.
Ricerca, filtri, modifica, nuova riga, cancellazione e revisione agiscono sullo stato RAM.
I campi collegati ricevono opzioni dal DB; in RAM resta l’ID reale selezionato.
Tipi, obbligatorietà, relazioni e chiavi sono verificati fuori dalla pagina.
L’importazione può essere interrotta, ripresa e corretta; solo i validi raggiungono la scrittura controllata.
VEGR_IMPORT gestisce il lavoro massivo; EGR fornisce le regole, VEGR valida e il Write Center governa la scrittura.
Evidenza dal banco operativo
Non è un concept.
È già dentro l’app.
Il percorso reale parte dalla scelta dell’entità e dal file Excel, conserva le righe grezze in RAM, assegna le colonne ai campi EGR tramite lettere, valida con VEGR e consente correzioni con lookup sul database.
Il ciclo operativo, schermata per schermata
Dalla materia grezza alla decisione del motore, senza trasformare la pagina nel luogo delle regole.
Dimostrato nelle schermate
Caricamento dei dati grezzi, mapping per lettere, validazione VEGR, modifica in RAM e lookup DB.
Funzione presente, non eseguita in questa prova
Il commit dei soli record validi non è stato lanciato perché quei record erano già presenti nel database.
Continuità operativa
La sessione può essere salvata e ripresa: un’importazione lunga non deve ricominciare da zero.
Dove vive il motore
VEGR_IMPORT è una dotazione concreta dell’app assicurativa e usa la struttura governata da EGR.
Un motore di importazione massiva realmente in dotazione all’app, non un mockup dimostrativo.
Il banco operativo da cui tutto è nato
SIRUCES non nasce in laboratorio.
Nasce dentro un’app reale.
Un gestionale desktop per agenzie assicurative ha messo alla prova il sistema su dati, vincoli e operazioni concrete. Da quelle esigenze sono emerse responsabilità ricorrenti; separandole sono nati EGR, VEGR, connettori e Write Center.
Funzioni operative già presenti
Anagrafiche, ricerca, stato storico e documenti collegati.
Rate, filtri, regole di pre-commit e controlli bloccanti.
Allegati per entità, staging e salvataggio solo a commit riuscito.
Corrispondenti, collaboratori e rami assicurativi.
Posizioni, compensi, riepiloghi e coerenza con documenti e PDF.
Selezione delle opportunità e tracciamento degli esiti.
Vincoli assicurativi, dati storici, documenti e commit richiedono coerenza assoluta.
Schema, validazione, connessione, scrittura e audit diventano moduli separati.
La soluzione non resta legata al settore assicurativo: diventa architettura combinabile.
Il gestionale è il banco reale. SIRUCES è ciò che può essere riusato oltre quel singolo prodotto.
Motori autonomi, sistema unico
Ogni motore fa una cosa.
E la fa bene.
La complessità non viene nascosta: viene distribuita in responsabilità chiare, verificabili e sostituibili senza riscrivere l’intero sistema.
Engine General Rules
Legge lo schema reale e lo trasforma in un modello canonico: entità, campi, tipi, vincoli, relazioni e policy.
- Definisce le regole
- Non valida dati runtime
Connector Hub
Consegna messaggi da una porta all’altra attraverso contratti espliciti e connettori configurati.
- Instrada, non decide
- Nessun collegamento nascosto
Validator Engine
Valida i payload secondo le regole EGR, normalizza i dati e identifica con precisione ogni anomalia.
- Regole campo e record
- Relazioni e FK
Error Engine
Unifica e classifica gli errori, ne valuta la severità e governa l’impatto operativo sul flusso.
- Catalogo e stati
- Decisioni e blocchi
Queue & Commit
Custodisce localmente il lavoro, gestisce retry e code, poi affida al CommitCenter una scrittura atomica e sicura.
- Persistenza locale
- Commit reale verificabile
Help Engine
Traduce la diagnosi tecnica in spiegazioni e suggerimenti comprensibili, senza sostituire la logica deterministica.
- Guida contestuale
- AI solo opzionale
Pipeline deterministica
Dal dato al database.
Senza scorciatoie.
Ogni passaggio ha un ingresso, un’uscita e un’evidenza. Nessun modulo può saltare la dorsale.
01InputUI · API · VEGR_IMPORT
02VEGRValida e normalizza
03SchedulerCustodisce il payload
04CommitCenterApplica le regole
05PostgreSQLScrittura reale
Errore governato
ERR_EGR classifica il problema; HELP_EGR lo rende comprensibile. Il flusso si blocca senza perdere contesto.
Commit verificato
Solo una scrittura reale produce successo. Se fallisce, il payload resta locale e rientra nella coda di retry.
SIRUCES Comics · Capitolo 01
Il viaggio del dato.Sei scene, una sola dorsale.
Dallo sportello al commit: il fumetto rende visibile il ruolo di ogni motore, i contratti tra i moduli e la custodia no-loss del dato.
UI_EGRHUBEGR · VEGRCOMMIT
Apri a piena risoluzione 
Apri a piena risoluzione La mappa completa
Un solo nodo di connessione. Responsabilità leggibili.
L’HUB è il punto di passaggio, non il cervello del sistema. Non interpreta il contenuto e non prende decisioni: consegna messaggi tra porte note, lasciando l’autorità ai motori competenti.
- 01DB ed EGR definiscono
La struttura reale viene letta, canonicalizzata e resa disponibile a tutti i motori.
- 02Le porte separano
Nessuna UI parla direttamente con un’altra UI o con un motore.
- 03ERR_EGR governa
Errori, severità, stati e blocchi passano da un’autorità coerente.
- 04Scheduler protegge
Il lavoro resta recuperabile anche con database non disponibile o app riavviata.
Principio no-loss
Se il sistema si ferma,
il dato no.
Prima del commit, il payload viene conservato localmente. Un errore di rete, un database non disponibile o un riavvio non cancellano il lavoro: il sistema riparte dall’evidenza già custodita.
01
Snapshot localeJSON · payload · contesto · timestamp
Salvato02
Gate infrastrutturaleSensori · Central Alarm · stato DB
Verificato03
Retry controllatoCoda · priorità · ripresa al riavvio
Pronto04
Commit atomicoScrittura reale · controllo finale
ConfermatoIl JSON viene eliminato solo dopo un successo reale.
Governance del progetto
Costruire solo
su evidenza.
SIRUCES cresce per fasi delimitate. Ogni avanzamento viene analizzato, provato, documentato e congelato prima di aprire il successivo.
01Stato reale
Ricostruire ciò che esiste, senza confondere intenzioni e fatti.
02Decisione
Separare evidenze, ipotesi, vincoli e scelte architetturali.
03Patch minima
Modificare solo quanto serve alla fase autorizzata.
04Prova controllata
Test automatici, analisi statica e sentinelle preparano il campo.
05Evidenza reale
L’operatore verifica il comportamento osservabile sul sistema reale.
06Congelamento
Decisioni, esiti e deviazioni restano tracciati prima del passo successivo.
“I test automatici preparano.
L’operatore certifica.”
Banco Motori 2 · sviluppo attivo
L’architettura
si prova nel mondo reale.
SIRUCES viene costruito e validato progressivamente su un banco reale: applicazione Flutter desktop, database PostgreSQL, configurazione DB-driven e prove operatore tracciate.
FlutterPostgreSQLDB-drivenVEGR_IMPORTAuditNo-loss
Contatto direttoSalvatore VaccaroIdeatore e sviluppatore di SIRUCES
Contatto via email
Scrivimi dal sito.
Compila il modulo: il messaggio verrà consegnato senza rendere pubblico il mio indirizzo email.
Tutela della proprietà intellettuale
Paternità e diritti riservati.
© 2026 Salvatore Vaccaro · Tutti i diritti riservati.
La paternità intellettuale del progetto SIRUCES e delle relative opere originali — inclusi software e codice sorgente, architettura come espressa nella documentazione, interfacce, testi, schemi e documentazione tecnica — è rivendicata da Salvatore Vaccaro. I diritti di utilizzazione economica sono riservati al titolare, fatti salvi eventuali diritti di terzi e diversi accordi scritti.
Le denominazioni SIRUCES, EGR, VEGR, ERR_EGR, HELP_EGR, HUB_EGR, VEGR_IMPORT, COMMIT CENTER EGR, SCHEDULER EGR e le altre denominazioni dei motori e moduli sono adottate come segni distintivi del progetto. Non è autorizzato alcun uso idoneo a generare confusione, falsa attribuzione o appropriazione della paternità, né alcuna riproduzione, modifica, distribuzione o sfruttamento del materiale protetto, salvo consenso scritto o gli usi espressamente consentiti dalla legge.
La consultazione del sito non comporta concessione, licenza o cessione di diritti. Ogni licenza o autorizzazione deve risultare da atto scritto del titolare.