How kenlasko/monize works
Monize is a self-hostable personal-finance application for managing accounts, transactions, investments, and household finances. Its central user workflow is recording or importing financial activity, organizing it against accounts and payees, and reviewing balances and reports. Distinct branches add bank synchronization, email-receipt processing with optional AI review, investment pricing, and backup/restore. The sampled sources show selected AI, receipt, bank-sync, and database calls; other major capabilities are retained from the README and tree without asserting unsampled implementation links.
Main entry points: email-receipt-pipeline.service.ts Email receipts · ai-query.service.ts Query execution · bank-sync Bank synchronization · accounts Accounts and loans
Components 23
Finance records
- Accounts and loans
backend/src/accounts - Transactions
backend/src/transactions/transactions.controller.ts - Payees and categories
backend/src/payees/payees.service.ts - Transaction rules
backend/src/transaction-rules/transaction-rules-applier.service.ts - Shared expenses
backend/src/shared-expenses/shared-review.service.ts
Import automation
- Bank synchronization
backend/src/bank-sync - Email receipts
backend/src/email-receipts/pipeline/email-receipt-pipeline.service.ts - Receipt preview
backend/src/email-receipts/parsers/email-receipt-parser-preview.service.ts - Financial imports
backend/src
AI assistance
- AI financial queries
backend/src/ai/query/ai-query.controller.ts - Query execution
backend/src/ai/query/ai-query.service.ts - AI providers and context
backend/src/ai - Financial query tools
backend/src/ai/query/tool-executor.service.ts - AI review inbox
backend/src/ai-review/ai-review-requests.controller.ts - Confirmed AI actions
backend/src/ai/actions/ai-action.types.ts
Investments
- Securities and pricing
backend/src/securities - Bond valuation
backend/src/bonds/engine/bond-engine.ts - Forecasts and reports
backend/src/accounts
Access and recovery
- Authentication
backend/src/auth/auth.controller.ts - Attachments
backend/src/attachments/attachments.controller.ts - Backup and restore
backend/src/backup/backup.controller.ts - PostgreSQL data
backend/src/common/db/scoped-db.ts
Other components
- User
Connections 19
- User → Transactions: records activity
- User → Accounts and loans: manages accounts
- Bank synchronization → Transactions: imports bank activity
- Email receipts → AI review inbox: queues review
backend/src/email-receipts/pipeline/email-receipt-pipeline.service.ts - Receipt preview → Email receipts: previews parsing
- AI financial queries → Query execution: executes query
backend/src/ai/query/ai-query.controller.ts - Query execution → AI providers and context: selects provider
backend/src/ai/query/ai-query.service.ts - Query execution → Financial query tools: runs tools
backend/src/ai/query/ai-query.service.ts - AI review inbox → Confirmed AI actions: confirms through
backend/src/ai-review/ai-review-requests.controller.ts - Securities and pricing → User: supports price entry
- Bond valuation → User: values holdings
- Backup and restore → User: exports or restores
- Attachments → User: stores documents
- Authentication → User: authenticates
- Bank synchronization → PostgreSQL data: reads and writes
backend/src/bank-sync/bank-sync-preview.service.ts - Email receipts → PostgreSQL data: processes records
backend/src/email-receipts/pipeline/email-receipt-pipeline.service.ts - Accounts and loans → Forecasts and reports: supports forecasting
- User → Shared expenses: tracks shared costs
- User → Financial imports: imports financial files