# suriya283/expense-tracker architecture

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

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

## Overview

This repository combines a Flask expense-tracking web app with a separate console tracker. The web workflow routes browser requests through Flask handlers, form helpers, and MySQL operations; the console program independently manages JSON-backed expenses and offers filtering, summaries, editing, and deletion. The excerpts establish the web call chain and console capabilities, but provide no templates or database schema, so those internals are not mapped.

Main entry points: [`Smart_personal_expense_tracker.py`](https://github.com/suriya283/expense-tracker/blob/main/Smart_personal_expense_tracker.py) (Console menu), [`app.py`](https://github.com/suriya283/expense-tracker/blob/main/app.py) (Flask routes), [`DB.py`](https://github.com/suriya283/expense-tracker/blob/main/DB.py) (Expense SQL), [`Utilities.py`](https://github.com/suriya283/expense-tracker/blob/main/Utilities.py) (Form operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_routes["Flask routes<br/>[app.py]"]
  node_form_ops["Form operations<br/>[Utilities.py]"]
end

subgraph group_data["Persistence"]
  node_mysql_ops["Expense SQL<br/>[DB.py]"]
end

subgraph group_cli["Console tracker"]
  node_console_menu["Console menu"]
  node_expense_entry["Expense entry"]
  node_expense_views["Expense views"]
  node_expense_summaries["Expense summaries"]
  node_expense_edits["Edit expenses"]
  node_expense_deletion["Delete expenses"]
  node_json_store["JSON expense file"]
end

node_browser(("Browser user"))
node_mysql[("MySQL database")]

node_browser -->|"sends requests"| node_routes
node_routes -->|"calls form helpers"| node_form_ops
node_routes -->|"deletes expense"| node_mysql_ops
node_form_ops -->|"calls data operations"| node_mysql_ops
node_mysql_ops -->|"queries and writes"| node_mysql
node_browser -.->|"uses console"| node_console_menu
node_console_menu -.->|"dispatches entry"| node_expense_entry
node_console_menu -.->|"dispatches views"| node_expense_views
node_console_menu -.->|"dispatches summaries"| node_expense_summaries
node_console_menu -.->|"dispatches edits"| node_expense_edits
node_console_menu -.->|"dispatches deletion"| node_expense_deletion
node_expense_entry -.->|"writes expenses"| node_json_store
node_expense_views -.->|"reads expenses"| node_json_store
node_expense_summaries -.->|"reads expenses"| node_json_store
node_expense_edits -.->|"updates expenses"| node_json_store
node_expense_deletion -.->|"removes expenses"| node_json_store

click node_routes "https://github.com/suriya283/expense-tracker/blob/main/app.py"
click node_form_ops "https://github.com/suriya283/expense-tracker/blob/main/Utilities.py"
click node_mysql_ops "https://github.com/suriya283/expense-tracker/blob/main/DB.py"
click node_console_menu "https://github.com/suriya283/expense-tracker/blob/main/Smart_personal_expense_tracker.py"
click node_expense_entry "https://github.com/suriya283/expense-tracker/blob/main/Smart_personal_expense_tracker.py"
click node_expense_views "https://github.com/suriya283/expense-tracker/blob/main/Smart_personal_expense_tracker.py"
click node_expense_summaries "https://github.com/suriya283/expense-tracker/blob/main/Smart_personal_expense_tracker.py"
click node_expense_edits "https://github.com/suriya283/expense-tracker/blob/main/Smart_personal_expense_tracker.py"
click node_expense_deletion "https://github.com/suriya283/expense-tracker/blob/main/Smart_personal_expense_tracker.py"
click node_json_store "https://github.com/suriya283/expense-tracker/blob/main/Smart_personal_expense_tracker.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_routes,node_form_ops,node_browser toneBlue
class node_mysql_ops,node_mysql toneAmber
class node_console_menu,node_expense_entry,node_expense_views,node_expense_summaries,node_expense_edits,node_expense_deletion,node_json_store toneMint
```

## Components

### Web application

- [Flask routes](https://github.com/suriya283/expense-tracker/blob/main/app.py): `app.py`
- [Form operations](https://github.com/suriya283/expense-tracker/blob/main/Utilities.py): `Utilities.py`

### Persistence

- [Expense SQL](https://github.com/suriya283/expense-tracker/blob/main/DB.py): `DB.py`

### Console tracker

- [Console menu](https://github.com/suriya283/expense-tracker/blob/main/Smart_personal_expense_tracker.py): `Smart_personal_expense_tracker.py`
- [Expense entry](https://github.com/suriya283/expense-tracker/blob/main/Smart_personal_expense_tracker.py): `Smart_personal_expense_tracker.py`
- [Expense views](https://github.com/suriya283/expense-tracker/blob/main/Smart_personal_expense_tracker.py): `Smart_personal_expense_tracker.py`
- [Expense summaries](https://github.com/suriya283/expense-tracker/blob/main/Smart_personal_expense_tracker.py): `Smart_personal_expense_tracker.py`
- [Edit expenses](https://github.com/suriya283/expense-tracker/blob/main/Smart_personal_expense_tracker.py): `Smart_personal_expense_tracker.py`
- [Delete expenses](https://github.com/suriya283/expense-tracker/blob/main/Smart_personal_expense_tracker.py): `Smart_personal_expense_tracker.py`
- [JSON expense file](https://github.com/suriya283/expense-tracker/blob/main/Smart_personal_expense_tracker.py): `Smart_personal_expense_tracker.py`

### Other components

- **Browser user**
- **MySQL database**

## Connections

- Browser user → Flask routes: sends requests (evidence: `app.py`)
- Flask routes → Form operations: calls form helpers (evidence: `app.py`)
- Flask routes → Expense SQL: deletes expense (evidence: `app.py`)
- Form operations → Expense SQL: calls data operations (evidence: `Utilities.py`)
- Expense SQL → MySQL database: queries and writes (evidence: `DB.py`)
- Browser user → Console menu: uses console
- Console menu → Expense entry: dispatches entry (evidence: `Smart_personal_expense_tracker.py`)
- Console menu → Expense views: dispatches views (evidence: `Smart_personal_expense_tracker.py`)
- Console menu → Expense summaries: dispatches summaries (evidence: `Smart_personal_expense_tracker.py`)
- Console menu → Edit expenses: dispatches edits (evidence: `Smart_personal_expense_tracker.py`)
- Console menu → Delete expenses: dispatches deletion (evidence: `Smart_personal_expense_tracker.py`)
- Expense entry → JSON expense file: writes expenses (evidence: `Smart_personal_expense_tracker.py`)
- Expense views → JSON expense file: reads expenses (evidence: `Smart_personal_expense_tracker.py`)
- Expense summaries → JSON expense file: reads expenses (evidence: `Smart_personal_expense_tracker.py`)
- Edit expenses → JSON expense file: updates expenses (evidence: `Smart_personal_expense_tracker.py`)
- Delete expenses → JSON expense file: removes expenses (evidence: `Smart_personal_expense_tracker.py`)
