# riddhibhatia05/expense-tracker-project architecture

> Architecture diagram of the GitHub repository riddhibhatia05/expense-tracker-project, 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/riddhibhatia05/expense-tracker-project
- Repository: https://github.com/riddhibhatia05/expense-tracker-project

## Overview

This is a small Python expense tracker with a command-line implementation and a separate, limited Tkinter interface. The main CLI workflow accepts expense and category actions, keeps records in memory, and offers Excel export and spending summaries. The GUI currently supports adding validated expenses only. README capabilities such as search, budgets, and visualizations are described as optional, but are not evidenced as implemented in the sampled source, so they are omitted. The graph reflects the two inspected source files; no persistent expense store is shown.

Main entry points: [`Expense_Tracker_Project.py`](https://github.com/riddhibhatia05/expense-tracker-project/blob/main/Expense_Tracker_Project.py) (Expense manager), [`GUI_Expense_Tracker.py`](https://github.com/riddhibhatia05/expense-tracker-project/blob/main/GUI_Expense_Tracker.py) (Expense form)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI Tracker"]
  node_cli_menu["CLI menu"]
  node_expense_tracker["Expense manager"]
  node_expense_records["Expense records"]
  node_excel_export["Excel export"]
  node_spending_summary["Spending summary"]
  node_xlsx_file["Excel workbook"]
end

subgraph group_gui["GUI Tracker"]
  node_gui_app["Expense form"]
  node_gui_records["GUI records"]
end

node_cli_user(("CLI user"))
node_gui_user(("GUI user"))

node_cli_user -->|"chooses actions"| node_cli_menu
node_cli_menu -->|"calls operations"| node_expense_tracker
node_expense_tracker -->|"updates records"| node_expense_records
node_expense_tracker -->|"exports records"| node_excel_export
node_expense_tracker -->|"calculates totals"| node_spending_summary
node_excel_export -->|"writes workbook"| node_xlsx_file
node_gui_user -->|"enters expense"| node_gui_app
node_gui_app -->|"appends expense"| node_gui_records

click node_cli_menu "https://github.com/riddhibhatia05/expense-tracker-project/blob/main/Expense_Tracker_Project.py"
click node_expense_tracker "https://github.com/riddhibhatia05/expense-tracker-project/blob/main/Expense_Tracker_Project.py"
click node_expense_records "https://github.com/riddhibhatia05/expense-tracker-project/blob/main/Expense_Tracker_Project.py"
click node_excel_export "https://github.com/riddhibhatia05/expense-tracker-project/blob/main/Expense_Tracker_Project.py"
click node_spending_summary "https://github.com/riddhibhatia05/expense-tracker-project/blob/main/Expense_Tracker_Project.py"
click node_gui_app "https://github.com/riddhibhatia05/expense-tracker-project/blob/main/GUI_Expense_Tracker.py"
click node_gui_records "https://github.com/riddhibhatia05/expense-tracker-project/blob/main/GUI_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_cli_menu,node_expense_tracker,node_expense_records,node_excel_export,node_spending_summary,node_xlsx_file,node_cli_user,node_gui_user toneBlue
class node_gui_app,node_gui_records toneAmber
```

## Components

### CLI Tracker

- [CLI menu](https://github.com/riddhibhatia05/expense-tracker-project/blob/main/Expense_Tracker_Project.py): `Expense_Tracker_Project.py`
- [Expense manager](https://github.com/riddhibhatia05/expense-tracker-project/blob/main/Expense_Tracker_Project.py): `Expense_Tracker_Project.py`
- [Expense records](https://github.com/riddhibhatia05/expense-tracker-project/blob/main/Expense_Tracker_Project.py): `Expense_Tracker_Project.py`
- [Excel export](https://github.com/riddhibhatia05/expense-tracker-project/blob/main/Expense_Tracker_Project.py): `Expense_Tracker_Project.py`
- [Spending summary](https://github.com/riddhibhatia05/expense-tracker-project/blob/main/Expense_Tracker_Project.py): `Expense_Tracker_Project.py`
- **Excel workbook**

### GUI Tracker

- [Expense form](https://github.com/riddhibhatia05/expense-tracker-project/blob/main/GUI_Expense_Tracker.py): `GUI_Expense_Tracker.py`
- [GUI records](https://github.com/riddhibhatia05/expense-tracker-project/blob/main/GUI_Expense_Tracker.py): `GUI_Expense_Tracker.py`

### Other components

- **CLI user**
- **GUI user**

## Connections

- CLI user → CLI menu: chooses actions (evidence: `Expense_Tracker_Project.py`)
- CLI menu → Expense manager: calls operations (evidence: `Expense_Tracker_Project.py`)
- Expense manager → Expense records: updates records (evidence: `Expense_Tracker_Project.py`)
- Expense manager → Excel export: exports records (evidence: `Expense_Tracker_Project.py`)
- Expense manager → Spending summary: calculates totals (evidence: `Expense_Tracker_Project.py`)
- Excel export → Excel workbook: writes workbook (evidence: `Expense_Tracker_Project.py`)
- GUI user → Expense form: enters expense (evidence: `GUI_Expense_Tracker.py`)
- Expense form → GUI records: appends expense (evidence: `GUI_Expense_Tracker.py`)
