Una piattaforma che segue ogni dinaro dalla cassa alla tesoreria.

Panoramica.
Un gruppo commerciale con quattro filiali e una tesoreria
I cassieri, i corrieri e i raccoglitori di campo gestiscono i contanti tutto il giorno. Un CFO, tesoriere e teste di ramo hanno bisogno di sapere, in qualsiasi momento, quanto è dove e chi lo ha toccato.
Conteggi su carta, totali inseriti a mano e nessuna tracciabilità
Le chiusure hanno richiesto ore, i totali sono stati tipizzati a mano, il cambiamento e le vendite di credito hanno offuscato i numeri, e le controversie non potevano essere risolte perché nulla era immutabile.
Un registro basato sui conteggi che il telefono non può alterare
App Android in arabo per tre ruoli operativi, con un motore finanziario Postgres che accetta solo conteggi, calcola tutto sul server e non modifica mai lo storico.
Schermate.

Un telefono, più ruoli sensibili e due password
Il cliente ha chiesto un secondo controllo della password prima che qualcuno tocchi i soldi. L'accesso ha due porte: l'account centrale, quindi una ri-verifica finanziaria che indirizza l'utente direttamente al loro posto.
- 1Cancello centraleIl nome utente viene mappato su un alias di posta elettronica dietro le quinte in modo che i cassieri non digitino mai un'e-mail. Standard Supabase Auth sotto.
- 2Cancello finanziarioUna vera e propria verifica della password, non un PIN. Un singolo RPC poi restituisce il ruolo, la filiale, la cassa e il giorno finanziario aperto in modo atomico.
- 3Instradamento automaticoContanti, corrieri e raccoglitori di campo atterrano a casa loro. Gli account Admin, CFO, Treaser e Branch-head sono solo web e vengono bloccati su dispositivi mobili da una guardia del dispositivo.

La giornata finanziaria, a colpo d’occhio
La giornata del cassiere segue un ciclo: apertura, operazioni, consegna e chiusura. La schermata iniziale mostra lo stato attuale e le azioni consentite.
- 1Stato del giornoAperto o chiuso, sessione A o B, e se una chiusura parziale approvata dal CFO è in sospeso.
- 2Composizione del cassettoI totali vivi derivano da movimenti di denominazione, mai da un importo tipizzato.
- 3Azioni rapideIncassare, vendita diretta, cambio di ritorno, cambio, spese e il diario, ciascuno recintato dallo stato giorno.

Contare banconote e monete, senza digitare i totali
Il cliente ha proibito i totali tipizzati a mano. Ogni conteggio nell'app, dall'apertura del giorno allo scambio di note per le monete, viene inserito per denominazione e il server calcola gli importi.
- 1Composizione del cassetto, calcolatoIl cassetto corrente è derivato da movimenti registrati ed etichettato come calcolato automaticamente. Nessuno ha un equilibrio.
- 2L'intero set algerinoOgni nota e moneta in circolazione, con la banconota da 200 dinari e la moneta da 200 dinari trattati come oggetti diversi.
- 3Scambiare senza cambiare il totaleRompere una nota di grandi dimensioni in quelle più piccole, o il contrario, e il server controlla che i pezzi che lasciano il cassetto esistono effettivamente prima di accettare lo swap.
- 4Protocollo non circolabileUna nota danneggiata o sospetta attiva la prova obbligatoria della telecamera, l'identità del titolare, una ricevuta di protezione numerata sul server e una tripla notifica al client, alla filiale e al CFO.

Ogni entrata ha una causale
I soldi che entrano nel cassetto devono essere classificati: vendite, regolamento del debito, altro, o una raccolta per conto di un'altra filiale.
- 1Classificazione obbligatoriaSpaccatura a tre vie più collezione a sezione trasversale. Niente contanti non categorizzati.
- 2Collezione a sezione trasversaleScrive la voce della cassa e un saldo inter-branch in sospeso in una chiamata atomica. Solo il CFO può risolverlo.
- 3Idempotente per designOgni scrittura trasporta un UUID generato dal client con un vincolo univoco lato server, quindi una richiesta ripetuta su una connessione errata non può mai postare due volte.

Due flussi di cassa, un importo netto, una ricevuta
Un cliente paga 2.000 per un articolo 1.750. Il cassetto riceve 2.000 e restituisce 250, ma la vendita è 1.750. L'app registra entrambi i movimenti in modo atomico.
- 1Ricevuta e modifica conteggiata separatamenteEntrambi i lati sono conteggi di denominazione, quindi la composizione del cassetto rimane esatta.
- 2Valore netto dell'elemento ugualeIl server registra i movimenti in entrata e in uscita insieme e li mette in rete, con una ricevuta numerata automaticamente.
- 3Modifica ritorno hard-linkedUn ritorno di cambiamento successivo deve fare riferimento a un'operazione padre e viene limitato dall'importo di tale operazione e da ciò che il cassetto detiene effettivamente.

Uno storico immutabile che il cassiere può consultare
Nulla viene mai modificato o cancellato. Le correzioni sono voci inverse legate all'originale, e il diario mostra la storia completa del giorno.
- 1Identità per tipoOgni tipo di operazione ha una propria identità visiva in modo che uno spostamento possa essere scansionato a colpo d'occhio.
- 2Archivio di giornoSessione A e sessione B raggruppate, con stato di trasferimento per passaggio di consegne.
- 3Registro di controllo dietro di essoChi, cosa, quando e da quale dispositivo, ha scritto lato server per ogni mutazione.

Prima dichiarare, poi confrontare
Alla fine, il cassiere dichiara le cifre commerciali senza vedere il denaro contato. Il server corrisponde alla dichiarazione contro il cassetto e supera la differenza.
- 1Tre passi, in ordineRiconciliazione commerciale prima, poi il conteggio automatico, poi la dichiarazione e chiudere. Le cifre commerciali vengono inserite prima che il denaro contato venga rivelato.
- 2Debiti differitiLe vendite di credito sono dichiarate separatamente e monitorate come debiti, non nascosti nella cifra in contanti.
- 3Chiusura parzialeCon il permesso del CFO, una chiusura di mezzogiorno apre una seconda sessione in modo che una consegna non interrompa il trading.

Trasferimenti di denaro e spese autorizzate
Il contante lascia la filiale solo attraverso una catena di corrieri, e solo dopo la chiusura della giornata. Le spese lasciano il cassetto solo contro gli ordini già approvati dal CFO.
- 1Bloccato fino alla chiusuraLa scheda di trasferimento rimane bloccata mentre il giorno è aperto. Una richiesta di svuotamento del cassetto diventa disponibile nel momento in cui la giornata finanziaria è chiusa, per esattamente l'importo contato.
- 2Catena di trasferimentoAssegnato, raccolto, consegnato, ricevuto dal tesoro. Ogni passaggio è una transizione di stato che il server convalida e il corriere ha le proprie schermate per esso.
- 3Ordini di esecuzioneIl cassiere può eseguire soltanto spese già approvate e allega la foto della fattura come prova in un bucket privato.
- 4Collettori di campoUn terzo ruolo mobile viene raccolto dai clienti sul campo con le stesse regole di denominazione.
Regole finanziarie.
Architettura.
Approfondimenti tecnici.
1. Modello finanziario immutabile, ispirato alla partita doppia
- Problema
- Le registrazioni devono essere legalmente difendibili. Un equilibrio che è stato modificato sul posto non prova nulla.
- Approccio
- Operazioni e movimenti di denominazione solo appendici. Le correzioni esistono solo come voci inverse collegate. I saldi sono sempre derivati dal libro mastro del ramo, mai memorizzati e aggiornati. Gli importi sono centesimi interi.
- Trade-off
- Ogni equilibrio è una query sulla storia. Legge più pesante in cambio di prove di manomissione e riproducibilità.
2. Conteggi per taglio con calcolo autorevole sul server
- Problema
- I cassieri contano i pezzi, non i totali, e il cliente ha proibito gli importi tipizzati a mano.
- Approccio
- L'app invia solo conteggi di denominazione. Il server calcola gli importi, convalida la disponibilità del cassetto per ogni denominazione prima di qualsiasi deflusso, come la modifica o lo scambio, e tratta la carta 200 e la moneta 200 come distinte.
- Trade-off
- I payload RPC di Chattier, ma un dispositivo client non possono mai fabbricare un importo.
3. Autenticazione su due livelli e instradamento automatico per ruolo
- Problema
- Un telefono fisico, più ruoli sensibili e un client richiedono una seconda password prima dell'area di lavoro finanziaria.
- Approccio
- Sessione centrale di Supabase, quindi una vera e propria ri-verifica di signInWithPassword, quindi un RPC platform_login che restituisce ruolo, ramo, cassa e giorno aperto in modo atomico. Il navigatore instrada per ruolo e rimbalza i ruoli solo web a una guardia del dispositivo.
- Trade-off
- Un extra di rete andata e ritorno al login, ammorbidito con una sovrapposizione di routing di marca.
4. Scritture finanziarie idempotenti, pronte per la modalità offline
- Problema
- Le reti di filiale cadono a metà richiesta. Un “record cash” non deve mai essere pubblicato due volte.
- Approccio
- Ogni RPC mutante porta un UUID generato dal client con un vincolo univoco sul server. La coda di sincronizzazione SQLite pianificata riutilizza la stessa chiave, quindi il replay offline è sicuro per costruzione.
- Trade-off
- Impermeabilità idraulica su ogni chiamata prima del negozio offline anche le navi.
5. Operazioni atomiche composte
- Problema
- Una vendita diretta con cambiamento sposta due flussi di cassa ma nette un importo. Le operazioni semi-completate avrebbero corrotto il cassetto.
- Approccio
- Un singolo RPC registra i movimenti IN e OUT insieme a una rete pari al valore dell'elemento e a una ricevuta numerata automaticamente. La raccolta incrociata utilizza lo stesso schema, riscrivendo la voce cashbox e un libro mastro in sospeso inter-branch che solo il CFO può regolare.
- Trade-off
- RPC più grassi, in cambio di operazioni che non possono essere completate a metà.
6. RLS senza scrittura diretta dal client
- Problema
- Una chiave cliente trapelata non deve consentire la scrittura di alcun dato.
- Approccio
- Sicurezza a livello di riga su tutte le 25 tabelle senza inserire, aggiornare o eliminare criteri per i client. Ogni percorso di scrittura è una funzione SECURITY DEFINER, e un passaggio di rafforzamento delle protezioni ha revocato l'implicita concessione pubblica di esecuzione da ogni funzione dopo un avviso di security advisor.
- Trade-off
- Tutte le logiche di autorizzazione vivono in SQL, quindi la revisione delle funzioni diventa il limite di sicurezza.
Flusso di cassa.
- Apri e chiudi la giornata
- Introito, vendite, cambiamento, scambio
- Protocollo non circolabile
- Trasferimento della catena di attività
- Pickup e prova di consegna
- Collezioni di clienti sul campo
- Stesse regole di denominazione
- Autorizzazioni e insediamenti
- Pannelli Web (pianificati)
- Bloccato sul cellulare
Prossimi passi.
Il debito tecnico da affrontare per primo
Rispecchia le migrazioni in tempo reale nel repository, sostituisci l'elenco dei client finti rimanenti con i record dei client reali, aggiungi test sui contratti RPC e imposta CI per le build firmate.
Sviluppi del prodotto
Coda offline su SQLite che riutilizza i tasti di idempotency, notifiche push per il protocollo di notifica tripla e le dashboard web per il CFO, il tesoriere e le teste di ramo.