# kenlasko/monize architecture

> Architecture diagram of the GitHub repository kenlasko/monize, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kenlasko/monize
- Repository: https://github.com/kenlasko/monize

## Overview

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: [`backend/src/email-receipts/pipeline/email-receipt-pipeline.service.ts`](https://github.com/kenlasko/monize/blob/main/backend/src/email-receipts/pipeline/email-receipt-pipeline.service.ts) (Email receipts), [`backend/src/ai/query/ai-query.service.ts`](https://github.com/kenlasko/monize/blob/main/backend/src/ai/query/ai-query.service.ts) (Query execution), [`backend/src/bank-sync`](https://github.com/kenlasko/monize/tree/main/backend/src/bank-sync) (Bank synchronization), [`backend/src/accounts`](https://github.com/kenlasko/monize/tree/main/backend/src/accounts) (Accounts and loans)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_finance["Finance records"]
  node_accounts["Accounts and loans"]
  node_transactions["Transactions"]
  node_payees["Payees and categories<br/>[payees.service.ts]"]
  node_rules["Transaction rules"]
  node_shared["Shared expenses"]
end

subgraph group_automation["Import automation"]
  node_bank["Bank synchronization"]
  node_receipts["Email receipts"]
  node_receiptpreview["Receipt preview"]
  node_import["Financial imports"]
end

subgraph group_intelligence["AI assistance"]
  node_aiquery["AI financial queries"]
  node_queryservice["Query execution"]
  node_ai["AI providers and context"]
  node_aitools["Financial query tools"]
  node_review["AI review inbox"]
  node_actions["Confirmed AI actions<br/>[ai-action.types.ts]"]
end

subgraph group_investments["Investments"]
  node_securities["Securities and pricing"]
  node_bonds["Bond valuation<br/>[bond-engine.ts]"]
  node_reports["Forecasts and reports"]
end

subgraph group_platform["Access and recovery"]
  node_auth["Authentication<br/>[auth.controller.ts]"]
  node_attachments["Attachments"]
  node_backup["Backup and restore"]
  node_database[("PostgreSQL data<br/>[scoped-db.ts]")]
end

node_person(("User"))

node_person -.->|"records activity"| node_transactions
node_person -.->|"manages accounts"| node_accounts
node_bank -.->|"imports bank activity"| node_transactions
node_receipts -->|"queues review"| node_review
node_receiptpreview -.->|"previews parsing"| node_receipts
node_aiquery -->|"executes query"| node_queryservice
node_queryservice -->|"selects provider"| node_ai
node_queryservice -->|"runs tools"| node_aitools
node_review -.->|"confirms through"| node_actions
node_securities -.->|"supports price entry"| node_person
node_bonds -.->|"values holdings"| node_person
node_backup -.->|"exports or restores"| node_person
node_attachments -.->|"stores documents"| node_person
node_auth -.->|"authenticates"| node_person
node_bank -->|"reads and writes"| node_database
node_receipts -->|"processes records"| node_database
node_accounts -.->|"supports forecasting"| node_reports
node_person -.->|"tracks shared costs"| node_shared
node_person -.->|"imports financial files"| node_import

click node_accounts "https://github.com/kenlasko/monize/tree/main/backend/src/accounts"
click node_transactions "https://github.com/kenlasko/monize/blob/main/backend/src/transactions/transactions.controller.ts"
click node_payees "https://github.com/kenlasko/monize/blob/main/backend/src/payees/payees.service.ts"
click node_rules "https://github.com/kenlasko/monize/blob/main/backend/src/transaction-rules/transaction-rules-applier.service.ts"
click node_shared "https://github.com/kenlasko/monize/blob/main/backend/src/shared-expenses/shared-review.service.ts"
click node_bank "https://github.com/kenlasko/monize/tree/main/backend/src/bank-sync"
click node_receipts "https://github.com/kenlasko/monize/blob/main/backend/src/email-receipts/pipeline/email-receipt-pipeline.service.ts"
click node_receiptpreview "https://github.com/kenlasko/monize/blob/main/backend/src/email-receipts/parsers/email-receipt-parser-preview.service.ts"
click node_import "https://github.com/kenlasko/monize/tree/main/backend/src"
click node_aiquery "https://github.com/kenlasko/monize/blob/main/backend/src/ai/query/ai-query.controller.ts"
click node_queryservice "https://github.com/kenlasko/monize/blob/main/backend/src/ai/query/ai-query.service.ts"
click node_ai "https://github.com/kenlasko/monize/tree/main/backend/src/ai"
click node_aitools "https://github.com/kenlasko/monize/blob/main/backend/src/ai/query/tool-executor.service.ts"
click node_review "https://github.com/kenlasko/monize/blob/main/backend/src/ai-review/ai-review-requests.controller.ts"
click node_actions "https://github.com/kenlasko/monize/blob/main/backend/src/ai/actions/ai-action.types.ts"
click node_securities "https://github.com/kenlasko/monize/tree/main/backend/src/securities"
click node_bonds "https://github.com/kenlasko/monize/blob/main/backend/src/bonds/engine/bond-engine.ts"
click node_reports "https://github.com/kenlasko/monize/tree/main/backend/src/accounts"
click node_auth "https://github.com/kenlasko/monize/blob/main/backend/src/auth/auth.controller.ts"
click node_attachments "https://github.com/kenlasko/monize/blob/main/backend/src/attachments/attachments.controller.ts"
click node_backup "https://github.com/kenlasko/monize/blob/main/backend/src/backup/backup.controller.ts"
click node_database "https://github.com/kenlasko/monize/blob/main/backend/src/common/db/scoped-db.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_accounts,node_transactions,node_payees,node_rules,node_shared,node_person toneBlue
class node_bank,node_receipts,node_receiptpreview,node_import toneAmber
class node_aiquery,node_queryservice,node_ai,node_aitools,node_review,node_actions toneMint
class node_securities,node_bonds,node_reports toneRose
class node_auth,node_attachments,node_backup,node_database toneIndigo
```

## Components

### Finance records

- [Accounts and loans](https://github.com/kenlasko/monize/tree/main/backend/src/accounts): `backend/src/accounts`
- [Transactions](https://github.com/kenlasko/monize/blob/main/backend/src/transactions/transactions.controller.ts): `backend/src/transactions/transactions.controller.ts`
- [Payees and categories](https://github.com/kenlasko/monize/blob/main/backend/src/payees/payees.service.ts): `backend/src/payees/payees.service.ts`
- [Transaction rules](https://github.com/kenlasko/monize/blob/main/backend/src/transaction-rules/transaction-rules-applier.service.ts): `backend/src/transaction-rules/transaction-rules-applier.service.ts`
- [Shared expenses](https://github.com/kenlasko/monize/blob/main/backend/src/shared-expenses/shared-review.service.ts): `backend/src/shared-expenses/shared-review.service.ts`

### Import automation

- [Bank synchronization](https://github.com/kenlasko/monize/tree/main/backend/src/bank-sync): `backend/src/bank-sync`
- [Email receipts](https://github.com/kenlasko/monize/blob/main/backend/src/email-receipts/pipeline/email-receipt-pipeline.service.ts): `backend/src/email-receipts/pipeline/email-receipt-pipeline.service.ts`
- [Receipt preview](https://github.com/kenlasko/monize/blob/main/backend/src/email-receipts/parsers/email-receipt-parser-preview.service.ts): `backend/src/email-receipts/parsers/email-receipt-parser-preview.service.ts`
- [Financial imports](https://github.com/kenlasko/monize/tree/main/backend/src): `backend/src`

### AI assistance

- [AI financial queries](https://github.com/kenlasko/monize/blob/main/backend/src/ai/query/ai-query.controller.ts): `backend/src/ai/query/ai-query.controller.ts`
- [Query execution](https://github.com/kenlasko/monize/blob/main/backend/src/ai/query/ai-query.service.ts): `backend/src/ai/query/ai-query.service.ts`
- [AI providers and context](https://github.com/kenlasko/monize/tree/main/backend/src/ai): `backend/src/ai`
- [Financial query tools](https://github.com/kenlasko/monize/blob/main/backend/src/ai/query/tool-executor.service.ts): `backend/src/ai/query/tool-executor.service.ts`
- [AI review inbox](https://github.com/kenlasko/monize/blob/main/backend/src/ai-review/ai-review-requests.controller.ts): `backend/src/ai-review/ai-review-requests.controller.ts`
- [Confirmed AI actions](https://github.com/kenlasko/monize/blob/main/backend/src/ai/actions/ai-action.types.ts): `backend/src/ai/actions/ai-action.types.ts`

### Investments

- [Securities and pricing](https://github.com/kenlasko/monize/tree/main/backend/src/securities): `backend/src/securities`
- [Bond valuation](https://github.com/kenlasko/monize/blob/main/backend/src/bonds/engine/bond-engine.ts): `backend/src/bonds/engine/bond-engine.ts`
- [Forecasts and reports](https://github.com/kenlasko/monize/tree/main/backend/src/accounts): `backend/src/accounts`

### Access and recovery

- [Authentication](https://github.com/kenlasko/monize/blob/main/backend/src/auth/auth.controller.ts): `backend/src/auth/auth.controller.ts`
- [Attachments](https://github.com/kenlasko/monize/blob/main/backend/src/attachments/attachments.controller.ts): `backend/src/attachments/attachments.controller.ts`
- [Backup and restore](https://github.com/kenlasko/monize/blob/main/backend/src/backup/backup.controller.ts): `backend/src/backup/backup.controller.ts`
- [PostgreSQL data](https://github.com/kenlasko/monize/blob/main/backend/src/common/db/scoped-db.ts): `backend/src/common/db/scoped-db.ts`

### Other components

- **User**

## Connections

- User → Transactions: records activity
- User → Accounts and loans: manages accounts
- Bank synchronization → Transactions: imports bank activity
- Email receipts → AI review inbox: queues review (evidence: `backend/src/email-receipts/pipeline/email-receipt-pipeline.service.ts`)
- Receipt preview → Email receipts: previews parsing
- AI financial queries → Query execution: executes query (evidence: `backend/src/ai/query/ai-query.controller.ts`)
- Query execution → AI providers and context: selects provider (evidence: `backend/src/ai/query/ai-query.service.ts`)
- Query execution → Financial query tools: runs tools (evidence: `backend/src/ai/query/ai-query.service.ts`)
- AI review inbox → Confirmed AI actions: confirms through (evidence: `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 (evidence: `backend/src/bank-sync/bank-sync-preview.service.ts`)
- Email receipts → PostgreSQL data: processes records (evidence: `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
