# amedge821/expense-tracker architecture

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

## Overview

Expense Tracker is a small command-line app: it loads saved expenses at startup, then routes menu choices to add, view, or total expenses. Adding validates the amount, updates the in-memory list, and saves it; the CSV file provides persistence. The graph is based on the README and the single excerpted source file.

Main entry points: [`tracker.py`](https://github.com/amedge821/expense-tracker/blob/main/tracker.py) (Menu loop)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_user(("User"))
node_menu["Menu loop<br/>[tracker.py]"]
node_add["Add expense<br/>[tracker.py]"]
node_view["View expenses<br/>[tracker.py]"]
node_total["Calculate total<br/>[tracker.py]"]
node_csv[("Expenses CSV")]

node_user -->|"chooses option"| node_menu
node_menu -->|"prompts and displays"| node_user
node_menu -->|"loads at startup"| node_csv
node_menu -->|"dispatches to"| node_add
node_menu -->|"dispatches to"| node_view
node_menu -->|"dispatches to"| node_total
node_add -->|"saves expenses"| node_csv
node_view -->|"prints expenses"| node_user
node_total -->|"returns total"| node_menu

click node_menu "https://github.com/amedge821/expense-tracker/blob/main/tracker.py"
click node_add "https://github.com/amedge821/expense-tracker/blob/main/tracker.py"
click node_view "https://github.com/amedge821/expense-tracker/blob/main/tracker.py"
click node_total "https://github.com/amedge821/expense-tracker/blob/main/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_user,node_view toneBlue
class node_menu,node_add,node_total toneTeal
class node_csv toneAmber
```

## Components

### Other components

- **User**
- [Menu loop](https://github.com/amedge821/expense-tracker/blob/main/tracker.py): `tracker.py`
- [Add expense](https://github.com/amedge821/expense-tracker/blob/main/tracker.py): `tracker.py`
- [View expenses](https://github.com/amedge821/expense-tracker/blob/main/tracker.py): `tracker.py`
- [Calculate total](https://github.com/amedge821/expense-tracker/blob/main/tracker.py): `tracker.py`
- **Expenses CSV**

## Connections

- User → Menu loop: chooses option (evidence: `tracker.py`)
- Menu loop → User: prompts and displays (evidence: `tracker.py`)
- Menu loop → Expenses CSV: loads at startup (evidence: `tracker.py`)
- Menu loop → Add expense: dispatches to (evidence: `tracker.py`)
- Menu loop → View expenses: dispatches to (evidence: `tracker.py`)
- Menu loop → Calculate total: dispatches to (evidence: `tracker.py`)
- Add expense → Expenses CSV: saves expenses (evidence: `tracker.py`)
- View expenses → User: prints expenses (evidence: `tracker.py`)
- Calculate total → Menu loop: returns total (evidence: `tracker.py`)
