← Tutti i progetti
Caso di studio · Fintech · B2B · Mobile

Una piattaforma che segue ogni dinaro dalla cassa alla tesoreria.

Al Burhan dà a un gruppo di vendita al dettaglio di quattro filiali ad Annaba un sistema per l'apertura e la chiusura della giornata, prendendo denaro per denominazione, vendendo con il cambiamento, inviando denaro tramite corriere e chiudendo con una riconciliazione cieca. Ogni scrittura è lato server, solo append e verificabile. Consegnato come beta firmata in quattro settimane.
ClienteEURL El Modjamaa El Tidjari Elborhane
PeriodoAgosto 2026, quattro settimane per la beta
PiattaformaAndroid, React Native (bare), RTL arabo
TecnologieReact Native 0.86, TypeScript, Zustand, Supabase Postgres
Schermo di accesso di Al Burhan
25
tabelle, tutti append-only per soldi
15+
RPC SECURITY DEFINER, nessuna scrittura diretta
4
succursali, 7 ruoli, 3 su mobile
4 wk
da spec a firmato beta APK

Panoramica.

A chi si rivolge, quale problema risolve e cosa è stato realizzato.
Il cliente

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.

Il problema

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.

Il prodotto

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.

Il giorno del cassiere, passo dopo passo. L'app è solo in arabo per design.
Un telefono, più ruoli sensibili e due password
01 · Accesso a due porte

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.

  • 1
    Cancello 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.
  • 2
    Cancello 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.
  • 3
    Instradamento 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
02 · Casa della cassa

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.

  • 1
    Stato del giornoAperto o chiuso, sessione A o B, e se una chiusura parziale approvata dal CFO è in sospeso.
  • 2
    Composizione del cassettoI totali vivi derivano da movimenti di denominazione, mai da un importo tipizzato.
  • 3
    Azioni rapideIncassare, vendita diretta, cambio di ritorno, cambio, spese e il diario, ciascuno recintato dallo stato giorno.
Contare banconote e monete, senza digitare i totali
03 · Denominazione

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.

  • 1
    Composizione del cassetto, calcolatoIl cassetto corrente è derivato da movimenti registrati ed etichettato come calcolato automaticamente. Nessuno ha un equilibrio.
  • 2
    L'intero set algerinoOgni nota e moneta in circolazione, con la banconota da 200 dinari e la moneta da 200 dinari trattati come oggetti diversi.
  • 3
    Scambiare 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.
  • 4
    Protocollo 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
04 · Prelievo di contanti

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.

  • 1
    Classificazione obbligatoriaSpaccatura a tre vie più collezione a sezione trasversale. Niente contanti non categorizzati.
  • 2
    Collezione a sezione trasversaleScrive la voce della cassa e un saldo inter-branch in sospeso in una chiamata atomica. Solo il CFO può risolverlo.
  • 3
    Idempotente 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
05 · Vendita diretta con cambio

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.

  • 1
    Ricevuta e modifica conteggiata separatamenteEntrambi i lati sono conteggi di denominazione, quindi la composizione del cassetto rimane esatta.
  • 2
    Valore netto dell'elemento ugualeIl server registra i movimenti in entrata e in uscita insieme e li mette in rete, con una ricevuta numerata automaticamente.
  • 3
    Modifica 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
06 · Giornale e archivio

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.

  • 1
    Identità per tipoOgni tipo di operazione ha una propria identità visiva in modo che uno spostamento possa essere scansionato a colpo d'occhio.
  • 2
    Archivio di giornoSessione A e sessione B raggruppate, con stato di trasferimento per passaggio di consegne.
  • 3
    Registro di controllo dietro di essoChi, cosa, quando e da quale dispositivo, ha scritto lato server per ogni mutazione.
Prima dichiarare, poi confrontare
07 · Riconciliazione cieca e chiusura

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.

  • 1
    Tre 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.
  • 2
    Debiti differitiLe vendite di credito sono dichiarate separatamente e monitorate come debiti, non nascosti nella cifra in contanti.
  • 3
    Chiusura 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
08 · Trasferimenti e spese

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.

  • 1
    Bloccato 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.
  • 2
    Catena 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.
  • 3
    Ordini di esecuzioneIl cassiere può eseguire soltanto spese già approvate e allega la foto della fattura come prova in un bucket privato.
  • 4
    Collettori di campoUn terzo ruolo mobile viene raccolto dai clienti sul campo con le stesse regole di denominazione.
Haptics su ogni conferma
Sistema di progettazione a 17 componenti
Linguaggio di design smeraldo
Prova della fotocamera per l'archiviazione privata
Modalità demo per i passaggi del client
Richieste di modifica guidate da note vocali

Regole finanziarie.

Invarianti il database applica, qualunque cosa faccia l'app.
Solo appendiciLe transazioni e i movimenti non vengono mai aggiornati o cancellati. Una correzione è una nuova voce inversa collegata.
Saldi derivatiI saldi di branch sono calcolati dal libro mastro in lettura. Non esiste una colonna di equilibrio modificabile da nessuna parte.
Centimetri interiNessun punto fluttuante tocca il denaro. Ogni importo è un numero intero di centesimi.
Conti, non importiI clienti inviano i conteggi delle denominazioni. Il server calcola gli importi e controlla la disponibilità per denominazione prima di qualsiasi deflusso.
Chiavi di idempotenzaOgni mutazione comporta un UUID client con un vincolo unico, quindi i tentativi e i replay offline non possono essere doppi.
Il cliente zero scriveRLS su tutte le 25 tabelle senza politiche di scrittura. Tutte le scritture passano attraverso le funzioni SECURITY DEFINER.

Architettura.

Un client nativo sottile e un Postgres che possiede le regole.
App Android
React Native 0.86, CLI nudo21 schermi, 7 navigatori · Zustand per-feature stores con composizione del cassetto derivato · NativeWind · React Navigation 7 · i18next con una localizzazione araba a 537 linee, RTL in tutto
Tre ruoli mobiliContanti (15 schermi), corrieri (catena di trasferimento), raccoglitori di campo. I ruoli solo Web sono bloccati da una protezione del dispositivo.
Prova della telecameraFattura e foto danneggiate caricate su un bucket privato con i criteri delle cartelle per utente
→
Supabase
Motore di denaro Postgres25 tabelle: succursali, cashboxes, utenti, clienti, campioni, financial_days, transazioni, denominazioni_movimenti, respinte_notes, commercial_dichiarazioni, differite_debitori, trasferimenti, autorizzazioni, spese_richieste, esecuzione_ordini, branch_ledger, audit_log, banche, prestiti, notifiche...
Oltre 15 RPC SECURITY DEFINERopen_financial_day · record_inflow · record_direct_sale · record_cross_branch_inflow · record_change_return · report_rejected_note · declare_commercial · close_financial_day · execute_partial_close · execute_expense_order · platform_login · catena di corriere
Auth + Storage + una funzione EdgeUsername-to-email alias, login a due porte, sessione in AsyncStorage · bucket di prove private · funzione admin-seed-users one-shot che si disattiva
→
Operazioni
Firmato APKBeta sideloaded per il client, firma del rilascio tenuta fuori dal repository
PianificatoCoda offline SQLite che riutilizza i tasti di idempotency · notifiche push · dashboard web per CFO, tesoriere e teste di ramo in un repository separato
Docs21 documenti specifici e decisionali, sintesi del cahier del cliente e un piano di correzione del feedback sul campo

Approfondimenti tecnici.

Sei decisioni dietro un libro mastro di cui ti puoi fidare.

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à.
Nel codice: supabase/migrations/0003_transactions.sql

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.
Nel codice: toServerDenoms in src/features/cashier/api.ts

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.
Nel codice: src/lib/mockAuth.ts, LoginScreen.tsx, RoutingOverlay.tsx

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.
Nel codice: newClientUuid in api.ts

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à.
Nel codice: record_direct_sale, record_cross_branch_inflow

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.
Nel codice: supabase/migrations/0006_rls.sql, docs/12

Flusso di cassa.

Dal cassetto al tesoro, con un ruolo ad ogni passo.
1 · ApertoConta il cassetto per denominazione. Il server apre la giornata finanziaria.
2 · FunzionamentoIntake, vendite dirette con cambio, scambi, spese approvate. Ogni movimento è una riga di appendici.
3 · DichiarareDichiarazione commerciale cieca, debiti differiti registrati separatamente.
4 · ConsegnaIl corriere prende, consegna, conferma il tesoro. Una macchina statale tiene traccia del trasferimento.
5 · SettleIl CFO regola i saldi interprofessionali e rivede il registro di audit e il registro contabile.
Cassa
  • Apri e chiudi la giornata
  • Introito, vendite, cambiamento, scambio
  • Protocollo non circolabile
Corriere
  • Trasferimento della catena di attività
  • Pickup e prova di consegna
Collettore di campo
  • Collezioni di clienti sul campo
  • Stesse regole di denominazione
CFO, tesoriere, testa di ramo
  • Autorizzazioni e insediamenti
  • Pannelli Web (pianificati)
  • Bloccato sul cellulare