How anamelesswolf/ledger works
Ledger is a personal-finance manager whose main workflow is recording and organizing expenses, then reviewing balances and financial activity across cards, wallets, budgets, subscriptions, and financing accounts. The Angular SPA presents these workflows; the Express/TypeORM backend exposes API routes and persists domain data in MySQL. The README also documents offline-first mobile expense capture and database schema/seed management; mobile client implementation is not represented in the supplied source tree. Several feature-specific UI and API links are inferred from product structure, so those edges are dashed and uncited.
Main entry points: index.ts Express API · app.routes.ts Angular SPA · walletManageController.ts Wallet management · monthlyController.ts Monthly API
Components 26
Finance interface
- Angular SPA
frontend/src/app/app.routes.ts - Expense workflows
frontend/src/app/expense - Card workflows
frontend/src/app/card - Wallet workflows
frontend/src/app/wallet - Monthly financing
frontend/src/app/monthly - Budget workflows
frontend/src/app/budget - Accounts
frontend/src/app/account - Subscriptions
frontend/src/app/subscription - Settings catalogs
frontend/src/app/settings
Finance API
- Express API
backend/src/index.ts - Expense API
backend/src/controllers/expenseController.ts - Card API
backend/src/controllers/creditcardController.ts - Wallet management
backend/src/controllers/walletManageController.ts - Monthly API
backend/src/controllers/monthlyController.ts - Account API
backend/src/controllers/accountController.ts - Other feature APIs
backend/src/controllers
Finance data
- Expense records
backend/src/models/expenses - Ledger records
backend/src/models/ledger - Banking records
backend/src/models/banking - Catalog records
backend/src/models/catalogs - Settings records
backend/src/models/settings
Mobile sync
- Mobile sync service
backend/src/services/mobileSync/MobileSyncService.ts - Sync persistence
backend/src/services/mobileSync/TypeOrmMobileSyncStore.ts
Other components
- Finance user
- MySQL database
- Offline mobile client
Connections 40
- Finance user → Angular SPA: uses
README.md - Angular SPA → Expense workflows: routes to
frontend/src/app/app.routes.ts - Angular SPA → Card workflows: routes to
frontend/src/app/app.routes.ts - Angular SPA → Wallet workflows: routes to
frontend/src/app/app.routes.ts - Angular SPA → Monthly financing: routes to
frontend/src/app/app.routes.ts - Angular SPA → Budget workflows: routes to
frontend/src/app/app.routes.ts - Angular SPA → Accounts: routes to
frontend/src/app/app.routes.ts - Angular SPA → Subscriptions: routes to
frontend/src/app/app.routes.ts - Angular SPA → Settings catalogs: routes to
frontend/src/app/app.routes.ts - Expense workflows → Express API: requests data
- Card workflows → Express API: requests data
- Wallet workflows → Express API: requests data
- Monthly financing → Express API: requests data
- Budget workflows → Express API: requests data
- Accounts → Express API: requests data
- Subscriptions → Express API: requests data
- Settings catalogs → Express API: requests data
- Express API → Expense API: mounts routes
- Express API → Card API: mounts routes
backend/src/controllers/creditcardController.ts - Express API → Wallet management: mounts routes
backend/src/controllers/walletManageController.ts - Express API → Monthly API: mounts routes
backend/src/controllers/monthlyController.ts - Express API → Account API: mounts routes
backend/src/controllers/accountController.ts - Express API → Other feature APIs: mounts routes
backend/src/controllers/accountController.ts - Expense API → Expense records: reads and writes
- Card API → Ledger records: reads and writes
backend/src/controllers/creditcardController.ts - Card API → Banking records: reads
backend/src/controllers/creditcardController.ts - Wallet management → Ledger records: reads and writes
backend/src/controllers/walletManageController.ts - Wallet management → Settings records: reads and writes
backend/src/controllers/walletManageController.ts - Wallet management → Catalog records: reads
backend/src/controllers/walletManageController.ts - Wallet management → Expense records: reads
backend/src/controllers/walletManageController.ts - Monthly API → Banking records: reads and writes
backend/src/controllers/monthlyController.ts - Monthly API → Ledger records: reads
backend/src/controllers/monthlyController.ts - Monthly API → Expense records: reads
backend/src/controllers/monthlyController.ts - Account API → Ledger records: reads and writes
backend/src/controllers/accountController.ts - Account API → Catalog records: reads
backend/src/controllers/accountController.ts - Account API → Settings records: reads
backend/src/controllers/accountController.ts - Express API → MySQL database: initializes connection
backend/src/index.ts - Offline mobile client → Mobile sync service: syncs expenses
- Mobile sync service → Sync persistence: uses store
- Sync persistence → MySQL database: persists records