How paulinotech1/mindful-money works
Vault is a browser-first personal finance tracker: the user imports or enters transactions, the browser encrypts and stores ciphertext through the Flask API, then decrypts records locally for finance views. Passkeys protect server access but do not replace the local passphrase-derived vault key. The graph also preserves documented recovery, security management, and manual-expense proof capabilities. The excerpts show the database/session foundations and parts of the browser and ZKP clients; some API relationships below are supported by README statements rather than sampled route bodies.
Main entry points: app.js Finance UI · app.py Flask API · manual_expense_v4_client.js Manual expense proofs · db.py Database lifecycle
Components 15
Browser finance app
- Finance UI
static/app.js - Bank and CSV import
static/simplefin-client.js - Local encryption and analytics
static/app.js - Recovery words
static/recovery-words.js
Vault API
- Flask API
app.py - Passkey sessions
app.py - Ciphertext records
app.py - Security and recovery
app.py
Persistent state
- Database lifecycle
db.py - Tenant and vault data
models.py - PostgreSQL
Proof verification
- Manual expense proofs
static/zkp/manual_expense_v4_client.js - Proof cryptography
static/zkp/manual_expense_v4_core.js - Proof verifier
zkp_verifier.py
Other components
- Vault user
Connections 19
- Vault user → Finance UI: uses
README.md - Finance UI → Bank and CSV import: imports transactions
README.md - Finance UI → Local encryption and analytics: encrypts and analyzes
README.md - Local encryption and analytics → Ciphertext records: uploads ciphertext
README.md - Ciphertext records → Local encryption and analytics: returns ciphertext
README.md - Finance UI → Passkey sessions: signs in
README.md - Finance UI → Security and recovery: manages vault
README.md - Finance UI → Recovery words: uses recovery
- Flask API → Database lifecycle: uses database
app.py - Database lifecycle → Tenant and vault data: seeds identity
db.py - Database lifecycle → PostgreSQL: opens sessions
db.py - Tenant and vault data → PostgreSQL: defines persisted data
models.py - Flask API → Proof verifier: verifies proofs
app.py - Manual expense proofs → Proof cryptography: uses cryptographic helpers
static/zkp/manual_expense_v4_client.js - Manual expense proofs → Flask API: requests challenges
static/zkp/manual_expense_v4_client.js - Flask API → Ciphertext records: routes record operations
app.py - Flask API → Passkey sessions: enforces access
app.py - Flask API → Security and recovery: serves security operations
app.py - Manual expense proofs → Proof verifier: submits proof