Chain Store Member Wallet
A prepaid member wallet shared across a chain: top up at any store, spend at any store, and every yuan records where it came from and where it went
A member prepaid-balance system for chain stores, shown here with a five-venue bar chain. Three clients update each other in real time: the cashier tablet opens cards, takes top-ups and scans member pay codes; the member's phone shows the balance and a pay code that refreshes every 30 seconds, and large payments must be approved by the member on the phone, with the result reaching the till instantly; the owner watches a live dashboard, store reports and inter-store settlement on a computer. Every transaction records whose money it is: top up at store A, spend at store B, and the ledger says exactly that. Direct-owned and franchise settlement switch with one toggle; in franchise mode, monthly flows are netted pair by pair into statements. The books are built not to go wrong: amounts are integer cents, the ledger is append-only, every operation carries a unique key so retries and double taps charge once, and balances are kept in three places that are reconciled every day. Tests include 50 concurrent charges on one member, 10,000 random operations checked step by step against an independent model, and killing the database three times under load, all passing. Deployed on premises with one Docker command, LAN HTTPS and daily backups. The demo video is a screen recording of the real system (Chinese subtitles); stores and members are fictional. Designed by me, built together with AI.
- 01
Cashier tablet: open cards, top-up plans (e.g. pay 10,000, get 2,000 bonus), scan member pay codes
- 02
Member phone: balance split into principal and bonus; pay code refreshes every 30 s and works once
- 03
Large payments approved by the member on the phone, result pushed to the till in real time
- 04
Cross-store: first in, first out; every yuan records the store it was topped up at and the store it was spent at
- 05
Reversals, refunds (principal only, bonus forfeited) and freezing; the day is locked after closing
- 06
Back office: live dashboard, store reports with CSV export, direct / franchise toggle, monthly settlement statements
- 07
Built not to go wrong: append-only ledger, unique keys against double charging, three balances reconciled daily
- 08
FastAPI + PostgreSQL + Vue 3, on-premises Docker deployment, LAN HTTPS, daily backups



