docs(be): update comprehensive README with layered architecture, 24 modules, and API reference
Key Changes & Additions
Backend (finwise-miniapp-be/README.md)
-
Layered Architecture & Invariants: Documented the strict
Route -> Validation -> Controller -> Service -> Repository -> Databaseflow, ACID balance invariants, UTC+7Asia/Ho_Chi_Minhtimezone boundary rules, and the Zero Hallucination AI DSL policy. -
24 Complete Modules & API Reference: Comprehensive reference table of all
/api/v1/...endpoints across Auth, Dynamic RBAC 2.0, Audit Logs, Wallets, Transactions, Cash Flow Forecast, Anomaly Detection, Subscriptions, Developer API Keys, Webhooks, and Cloudflare R2 Uploads. -
Infrastructure & Caching: Detailed Redis distributed locking (
ioredis), background cron/worker architecture, and Google Gemini AI token usage tracking. -
Environment & Setup: Full table of environment variables, seed credentials (
admin@finwise.local, etc.), Jest/Supertest testing commands, and Docker Compose / PM2 deployment guides.
Monorepo Root (README.md)
- Created an overarching repository README connecting frontend, backend, deep-dive architecture docs, ERD references, and quickstart commands.