# preethi-sri/expense-tracker architecture

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

- Interactive diagram: https://gitdiagram.com/preethi-sri/expense-tracker
- Repository: https://github.com/preethi-sri/expense-tracker

## Overview

This is a Flask personal expense tracker. Users register or log in, then add and delete expenses or view a per-user dashboard filtered by category and month; the dashboard summarizes spending and displays monthly chart data. Flask routes own these operations and use SQLAlchemy models backed by SQLite. The graph separates authentication, expense workflows, persistence, and browser presentation. Source relationships are shown where app.py exposes them; README-documented capabilities are included, while unsampled template wiring is not inferred beyond those statements.

Main entry points: [`app.py`](https://github.com/preethi-sri/expense-tracker/blob/main/app.py) (Expense model), [`templates/index.html`](https://github.com/preethi-sri/expense-tracker/blob/main/templates/index.html) (Dashboard page), [`instance/expenses.db`](https://github.com/preethi-sri/expense-tracker/blob/main/instance/expenses.db) (SQLite database), [`templates/login.html`](https://github.com/preethi-sri/expense-tracker/blob/main/templates/login.html) (Login and registration pages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["Browser presentation"]
  node_auth_pages["Login and registration pages<br/>[login.html]"]
  node_dashboard_page["Dashboard page<br/>[index.html]"]
  node_add_page["Add expense page<br/>[add.html]"]
end

subgraph group_identity["User authentication"]
  node_auth_routes["Authentication routes<br/>[app.py]"]
  node_user_model["User model<br/>[app.py]"]
end

subgraph group_expenses["Expense workflows"]
  node_dashboard["Dashboard and filters<br/>[app.py]"]
  node_expense_entry["Expense entry<br/>[app.py]"]
  node_expense_deletion["Expense deletion<br/>[app.py]"]
end

subgraph group_storage["Persistent data"]
  node_expense_model["Expense model<br/>[app.py]"]
  node_sqlite[("SQLite database<br/>[expenses.db]")]
end

node_browser(("User browser"))
node_chartjs["Chart.js"]

node_browser -->|"submits credentials"| node_auth_routes
node_auth_routes -->|"renders pages"| node_auth_pages
node_auth_routes -->|"checks and creates users"| node_user_model
node_browser -->|"submits expense"| node_expense_entry
node_expense_entry -->|"renders form"| node_add_page
node_expense_entry -->|"creates expense"| node_expense_model
node_browser -->|"requests dashboard"| node_dashboard
node_dashboard -->|"queries and summarizes"| node_expense_model
node_dashboard -->|"renders results"| node_dashboard_page
node_dashboard_page -->|"renders monthly chart"| node_chartjs
node_browser -->|"requests deletion"| node_expense_deletion
node_expense_deletion -->|"deletes expense"| node_expense_model
node_user_model -->|"persists users"| node_sqlite
node_expense_model -->|"persists expenses"| node_sqlite

click node_auth_pages "https://github.com/preethi-sri/expense-tracker/blob/main/templates/login.html"
click node_dashboard_page "https://github.com/preethi-sri/expense-tracker/blob/main/templates/index.html"
click node_add_page "https://github.com/preethi-sri/expense-tracker/blob/main/templates/add.html"
click node_auth_routes "https://github.com/preethi-sri/expense-tracker/blob/main/app.py"
click node_user_model "https://github.com/preethi-sri/expense-tracker/blob/main/app.py"
click node_dashboard "https://github.com/preethi-sri/expense-tracker/blob/main/app.py"
click node_expense_entry "https://github.com/preethi-sri/expense-tracker/blob/main/app.py"
click node_expense_deletion "https://github.com/preethi-sri/expense-tracker/blob/main/app.py"
click node_expense_model "https://github.com/preethi-sri/expense-tracker/blob/main/app.py"
click node_sqlite "https://github.com/preethi-sri/expense-tracker/blob/main/instance/expenses.db"

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_auth_pages,node_dashboard_page,node_add_page,node_browser toneBlue
class node_auth_routes,node_user_model toneAmber
class node_dashboard,node_expense_entry,node_expense_deletion toneMint
class node_expense_model,node_sqlite toneRose
class node_chartjs toneIndigo
```

## Components

### Browser presentation

- [Login and registration pages](https://github.com/preethi-sri/expense-tracker/blob/main/templates/login.html): `templates/login.html`
- [Dashboard page](https://github.com/preethi-sri/expense-tracker/blob/main/templates/index.html): `templates/index.html`
- [Add expense page](https://github.com/preethi-sri/expense-tracker/blob/main/templates/add.html): `templates/add.html`

### User authentication

- [Authentication routes](https://github.com/preethi-sri/expense-tracker/blob/main/app.py): `app.py`
- [User model](https://github.com/preethi-sri/expense-tracker/blob/main/app.py): `app.py`

### Expense workflows

- [Dashboard and filters](https://github.com/preethi-sri/expense-tracker/blob/main/app.py): `app.py`
- [Expense entry](https://github.com/preethi-sri/expense-tracker/blob/main/app.py): `app.py`
- [Expense deletion](https://github.com/preethi-sri/expense-tracker/blob/main/app.py): `app.py`

### Persistent data

- [Expense model](https://github.com/preethi-sri/expense-tracker/blob/main/app.py): `app.py`
- [SQLite database](https://github.com/preethi-sri/expense-tracker/blob/main/instance/expenses.db): `instance/expenses.db`

### Other components

- **User browser**
- **Chart.js**

## Connections

- User browser → Authentication routes: submits credentials (evidence: `README.md`)
- Authentication routes → Login and registration pages: renders pages (evidence: `app.py`)
- Authentication routes → User model: checks and creates users (evidence: `app.py`)
- User browser → Expense entry: submits expense (evidence: `README.md`)
- Expense entry → Add expense page: renders form (evidence: `app.py`)
- Expense entry → Expense model: creates expense (evidence: `app.py`)
- User browser → Dashboard and filters: requests dashboard (evidence: `README.md`)
- Dashboard and filters → Expense model: queries and summarizes (evidence: `app.py`)
- Dashboard and filters → Dashboard page: renders results (evidence: `app.py`)
- Dashboard page → Chart.js: renders monthly chart (evidence: `README.md`)
- User browser → Expense deletion: requests deletion (evidence: `README.md`)
- Expense deletion → Expense model: deletes expense (evidence: `app.py`)
- User model → SQLite database: persists users (evidence: `app.py`)
- Expense model → SQLite database: persists expenses (evidence: `app.py`)
