# jelle2003/fintracker architecture

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

- Interactive diagram: https://gitdiagram.com/jelle2003/fintracker
- Repository: https://github.com/jelle2003/fintracker

## Overview

FINTRACK is a Flask personal-finance application. Users enter account context and financial records, then review dashboards, goals, portfolio analytics, alerts, market information, and AI advice. The sampled backend is concentrated in one large application module, with SQLAlchemy models and a database extension; the README documents additional capabilities whose implementation was not sampled. Edges reflect explicit README workflows or source-index references, so some internal feature wiring is intentionally omitted.

Main entry points: [`backend/app/app.py`](https://github.com/jelle2003/fintracker/blob/main/backend/app/app.py) (Web application), [`backend/app/models.py`](https://github.com/jelle2003/fintracker/blob/main/backend/app/models.py) (Financial models), [`frontend/index.html`](https://github.com/jelle2003/fintracker/blob/main/frontend/index.html) (Dashboard), [`frontend/transactions.html`](https://github.com/jelle2003/fintracker/blob/main/frontend/transactions.html) (Transactions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_dashboard["Dashboard<br/>[index.html]"]
  node_transactions_ui["Transactions<br/>[transactions.html]"]
  node_account_ui["Account settings<br/>[account.html]"]
  node_goals_ui["Savings goals<br/>[goals.html]"]
  node_investing_ui["Investing<br/>[investing.html]"]
  node_market_ui["Market and news<br/>[market.html]"]
  node_alerts_ui["Alerts<br/>[notifications.html]"]
  node_admin_ui["Admin<br/>[admin.html]"]
end

subgraph group_finance["Personal finance"]
  node_cashflow["Income and expenses<br/>[app.py]"]
  node_goals["Goal tracking<br/>[app.py]"]
  node_portfolio["Portfolio and ledger<br/>[app.py]"]
end

subgraph group_insight["Analysis and insights"]
  node_market_data["Market data<br/>[app.py]"]
  node_ai_advisor["AI advisor<br/>[app.py]"]
  node_alerts["Financial alerts<br/>[app.py]"]
  node_analytics["Dashboard analytics<br/>[app.py]"]
end

subgraph group_platform["Accounts and persistence"]
  node_web_app["Web application<br/>[app.py]"]
  node_accounts["Accounts and security<br/>[app.py]"]
  node_models["Financial models<br/>[models.py]"]
  node_database[("SQLAlchemy database<br/>[database.py]")]
end

node_user(("User"))
node_gemini{{"Gemini AI"}}
node_external_data{{"Market data sources"}}

node_user -->|"uses"| node_web_app
node_user -->|"sets preferences"| node_account_ui
node_user -->|"reviews finances"| node_dashboard
node_user -->|"filters and exports"| node_transactions_ui
node_user -->|"tracks goals"| node_goals_ui
node_user -->|"manages portfolio"| node_investing_ui
node_user -->|"views markets"| node_market_ui
node_user -->|"reviews alerts"| node_alerts_ui
node_user -->|"manages users"| node_admin_ui
node_web_app -->|"handles records"| node_cashflow
node_web_app -->|"handles goals"| node_goals
node_web_app -->|"handles investments"| node_portfolio
node_web_app -->|"loads market view"| node_market_data
node_web_app -->|"provides advice"| node_ai_advisor
node_web_app -->|"provides alerts"| node_alerts
node_web_app -->|"provides dashboard"| node_analytics
node_web_app -->|"authenticates users"| node_accounts
node_web_app -->|"uses models"| node_models
node_models -->|"uses extension"| node_database
node_market_data -.->|"fetches data"| node_external_data
node_ai_advisor -.->|"requests analysis"| node_gemini

click node_dashboard "https://github.com/jelle2003/fintracker/blob/main/frontend/index.html"
click node_transactions_ui "https://github.com/jelle2003/fintracker/blob/main/frontend/transactions.html"
click node_account_ui "https://github.com/jelle2003/fintracker/blob/main/frontend/account.html"
click node_goals_ui "https://github.com/jelle2003/fintracker/blob/main/frontend/goals.html"
click node_investing_ui "https://github.com/jelle2003/fintracker/blob/main/frontend/investing.html"
click node_market_ui "https://github.com/jelle2003/fintracker/blob/main/frontend/market.html"
click node_alerts_ui "https://github.com/jelle2003/fintracker/blob/main/frontend/notifications.html"
click node_admin_ui "https://github.com/jelle2003/fintracker/blob/main/frontend/admin.html"
click node_web_app "https://github.com/jelle2003/fintracker/blob/main/backend/app/app.py"
click node_cashflow "https://github.com/jelle2003/fintracker/blob/main/backend/app/app.py"
click node_goals "https://github.com/jelle2003/fintracker/blob/main/backend/app/app.py"
click node_portfolio "https://github.com/jelle2003/fintracker/blob/main/backend/app/app.py"
click node_market_data "https://github.com/jelle2003/fintracker/blob/main/backend/app/app.py"
click node_ai_advisor "https://github.com/jelle2003/fintracker/blob/main/backend/app/app.py"
click node_alerts "https://github.com/jelle2003/fintracker/blob/main/backend/app/app.py"
click node_analytics "https://github.com/jelle2003/fintracker/blob/main/backend/app/app.py"
click node_accounts "https://github.com/jelle2003/fintracker/blob/main/backend/app/app.py"
click node_models "https://github.com/jelle2003/fintracker/blob/main/backend/app/models.py"
click node_database "https://github.com/jelle2003/fintracker/blob/main/backend/app/database.py"

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_dashboard,node_transactions_ui,node_account_ui,node_goals_ui,node_investing_ui,node_market_ui,node_alerts_ui,node_admin_ui,node_user toneBlue
class node_cashflow,node_goals,node_portfolio toneAmber
class node_market_data,node_ai_advisor,node_alerts,node_analytics toneMint
class node_web_app,node_accounts,node_models,node_database toneRose
class node_gemini,node_external_data toneIndigo
```

## Components

### User experience

- [Dashboard](https://github.com/jelle2003/fintracker/blob/main/frontend/index.html): `frontend/index.html`
- [Transactions](https://github.com/jelle2003/fintracker/blob/main/frontend/transactions.html): `frontend/transactions.html`
- [Account settings](https://github.com/jelle2003/fintracker/blob/main/frontend/account.html): `frontend/account.html`
- [Savings goals](https://github.com/jelle2003/fintracker/blob/main/frontend/goals.html): `frontend/goals.html`
- [Investing](https://github.com/jelle2003/fintracker/blob/main/frontend/investing.html): `frontend/investing.html`
- [Market and news](https://github.com/jelle2003/fintracker/blob/main/frontend/market.html): `frontend/market.html`
- [Alerts](https://github.com/jelle2003/fintracker/blob/main/frontend/notifications.html): `frontend/notifications.html`
- [Admin](https://github.com/jelle2003/fintracker/blob/main/frontend/admin.html): `frontend/admin.html`

### Personal finance

- [Income and expenses](https://github.com/jelle2003/fintracker/blob/main/backend/app/app.py): `backend/app/app.py`
- [Goal tracking](https://github.com/jelle2003/fintracker/blob/main/backend/app/app.py): `backend/app/app.py`
- [Portfolio and ledger](https://github.com/jelle2003/fintracker/blob/main/backend/app/app.py): `backend/app/app.py`

### Analysis and insights

- [Market data](https://github.com/jelle2003/fintracker/blob/main/backend/app/app.py): `backend/app/app.py`
- [AI advisor](https://github.com/jelle2003/fintracker/blob/main/backend/app/app.py): `backend/app/app.py`
- [Financial alerts](https://github.com/jelle2003/fintracker/blob/main/backend/app/app.py): `backend/app/app.py`
- [Dashboard analytics](https://github.com/jelle2003/fintracker/blob/main/backend/app/app.py): `backend/app/app.py`

### Accounts and persistence

- [Web application](https://github.com/jelle2003/fintracker/blob/main/backend/app/app.py): `backend/app/app.py`
- [Accounts and security](https://github.com/jelle2003/fintracker/blob/main/backend/app/app.py): `backend/app/app.py`
- [Financial models](https://github.com/jelle2003/fintracker/blob/main/backend/app/models.py): `backend/app/models.py`
- [SQLAlchemy database](https://github.com/jelle2003/fintracker/blob/main/backend/app/database.py): `backend/app/database.py`

### Other components

- **User**
- **Gemini AI**
- **Market data sources**

## Connections

- User → Web application: uses (evidence: `README.md`)
- User → Account settings: sets preferences (evidence: `README.md`)
- User → Dashboard: reviews finances (evidence: `README.md`)
- User → Transactions: filters and exports (evidence: `README.md`)
- User → Savings goals: tracks goals (evidence: `README.md`)
- User → Investing: manages portfolio (evidence: `README.md`)
- User → Market and news: views markets (evidence: `README.md`)
- User → Alerts: reviews alerts (evidence: `README.md`)
- User → Admin: manages users (evidence: `README.md`)
- Web application → Income and expenses: handles records (evidence: `README.md`)
- Web application → Goal tracking: handles goals (evidence: `README.md`)
- Web application → Portfolio and ledger: handles investments (evidence: `README.md`)
- Web application → Market data: loads market view (evidence: `backend/app/app.py`)
- Web application → AI advisor: provides advice (evidence: `README.md`)
- Web application → Financial alerts: provides alerts (evidence: `README.md`)
- Web application → Dashboard analytics: provides dashboard (evidence: `README.md`)
- Web application → Accounts and security: authenticates users (evidence: `backend/app/app.py`)
- Web application → Financial models: uses models (evidence: `backend/app/app.py`)
- Financial models → SQLAlchemy database: uses extension (evidence: `backend/app/models.py`)
- Market data → Market data sources: fetches data
- AI advisor → Gemini AI: requests analysis
