# rhyneulan/s.e.t-system architecture

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

- Interactive diagram: https://gitdiagram.com/rhyneulan/s.e.t-system
- Repository: https://github.com/rhyneulan/s.e.t-system

## Overview

S.E.T. is a command-line student expense tracker. A user selects a category to add budget or record an expense; the transaction updates the remaining budget and expense totals and records a log. The menu also presents totals, transaction history, budget comparisons, highest spending, and warnings, and offers reset tools. The graph reflects the shown Python calls and file-backed stores; the README is empty, so no additional documented capabilities or relationships are available.

Main entry points: [`main.py`](https://github.com/rhyneulan/s.e.t-system/blob/main/main.py) (Menu dispatch), [`set_value.py`](https://github.com/rhyneulan/s.e.t-system/blob/main/set_value.py) (Add or deduct), [`summary.py`](https://github.com/rhyneulan/s.e.t-system/blob/main/summary.py) (Totals and history), [`logs.py`](https://github.com/rhyneulan/s.e.t-system/blob/main/logs.py) (Transaction logging)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["CLI application"]
  node_menu["Menu dispatch<br/>[main.py]"]
  node_console["Console clearing<br/>[cleaner.py]"]
end

subgraph group_transactions["Budget transactions"]
  node_category["Category selection<br/>[category.py]"]
  node_transaction["Add or deduct<br/>[set_value.py]"]
  node_budget["Budget storage logic<br/>[balance.py]"]
  node_expense["Expense storage logic<br/>[expense.py]"]
  node_logger["Transaction logging<br/>[logs.py]"]
end

subgraph group_reporting["Reports and analysis"]
  node_summary["Totals and history<br/>[summary.py]"]
  node_analysis["Spending analysis<br/>[analysis.py]"]
end

subgraph group_storage["File storage"]
  node_budgetfile[("Budget file<br/>[budgets.txt]")]
  node_expensefile[("Expense file<br/>[expense.txt]")]
  node_logsfile[("Log file<br/>[logs.txt]")]
end

node_user(("User"))

node_user -->|"selects options"| node_menu
node_menu -->|"clears console"| node_console
node_menu -->|"dispatches transactions"| node_transaction
node_menu -->|"dispatches reports"| node_summary
node_menu -->|"dispatches analysis"| node_analysis
node_menu -->|"clears logs"| node_logger
node_menu -->|"resets budget"| node_budget
node_menu -->|"resets expenses"| node_expense
node_transaction -->|"chooses category"| node_category
node_transaction -->|"reads and saves"| node_budget
node_transaction -->|"reads and saves"| node_expense
node_transaction -->|"records transaction"| node_logger
node_budget -->|"reads and writes"| node_budgetfile
node_expense -->|"reads and writes"| node_expensefile
node_logger -->|"reads and appends"| node_logsfile
node_summary -->|"reads expenses"| node_expensefile
node_summary -->|"reads budgets"| node_budgetfile
node_summary -->|"loads logs"| node_logger
node_analysis -->|"reads budgets"| node_budgetfile
node_analysis -->|"reads expenses"| node_expensefile

click node_menu "https://github.com/rhyneulan/s.e.t-system/blob/main/main.py"
click node_console "https://github.com/rhyneulan/s.e.t-system/blob/main/cleaner.py"
click node_category "https://github.com/rhyneulan/s.e.t-system/blob/main/category.py"
click node_transaction "https://github.com/rhyneulan/s.e.t-system/blob/main/set_value.py"
click node_budget "https://github.com/rhyneulan/s.e.t-system/blob/main/balance.py"
click node_expense "https://github.com/rhyneulan/s.e.t-system/blob/main/expense.py"
click node_logger "https://github.com/rhyneulan/s.e.t-system/blob/main/logs.py"
click node_summary "https://github.com/rhyneulan/s.e.t-system/blob/main/summary.py"
click node_analysis "https://github.com/rhyneulan/s.e.t-system/blob/main/analysis.py"
click node_budgetfile "https://github.com/rhyneulan/s.e.t-system/blob/main/budgets.txt"
click node_expensefile "https://github.com/rhyneulan/s.e.t-system/blob/main/expense.txt"
click node_logsfile "https://github.com/rhyneulan/s.e.t-system/blob/main/logs.txt"

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_menu,node_console,node_user toneBlue
class node_category,node_transaction,node_budget,node_expense,node_logger toneAmber
class node_summary,node_analysis toneMint
class node_budgetfile,node_expensefile,node_logsfile toneRose
```

## Components

### CLI application

- [Menu dispatch](https://github.com/rhyneulan/s.e.t-system/blob/main/main.py): `main.py`
- [Console clearing](https://github.com/rhyneulan/s.e.t-system/blob/main/cleaner.py): `cleaner.py`

### Budget transactions

- [Category selection](https://github.com/rhyneulan/s.e.t-system/blob/main/category.py): `category.py`
- [Add or deduct](https://github.com/rhyneulan/s.e.t-system/blob/main/set_value.py): `set_value.py`
- [Budget storage logic](https://github.com/rhyneulan/s.e.t-system/blob/main/balance.py): `balance.py`
- [Expense storage logic](https://github.com/rhyneulan/s.e.t-system/blob/main/expense.py): `expense.py`
- [Transaction logging](https://github.com/rhyneulan/s.e.t-system/blob/main/logs.py): `logs.py`

### Reports and analysis

- [Totals and history](https://github.com/rhyneulan/s.e.t-system/blob/main/summary.py): `summary.py`
- [Spending analysis](https://github.com/rhyneulan/s.e.t-system/blob/main/analysis.py): `analysis.py`

### File storage

- [Budget file](https://github.com/rhyneulan/s.e.t-system/blob/main/budgets.txt): `budgets.txt`
- [Expense file](https://github.com/rhyneulan/s.e.t-system/blob/main/expense.txt): `expense.txt`
- [Log file](https://github.com/rhyneulan/s.e.t-system/blob/main/logs.txt): `logs.txt`

### Other components

- **User**

## Connections

- User → Menu dispatch: selects options (evidence: `main.py`)
- Menu dispatch → Console clearing: clears console (evidence: `main.py`)
- Menu dispatch → Add or deduct: dispatches transactions (evidence: `main.py`)
- Menu dispatch → Totals and history: dispatches reports (evidence: `main.py`)
- Menu dispatch → Spending analysis: dispatches analysis (evidence: `main.py`)
- Menu dispatch → Transaction logging: clears logs (evidence: `main.py`)
- Menu dispatch → Budget storage logic: resets budget (evidence: `main.py`)
- Menu dispatch → Expense storage logic: resets expenses (evidence: `main.py`)
- Add or deduct → Category selection: chooses category (evidence: `set_value.py`)
- Add or deduct → Budget storage logic: reads and saves (evidence: `set_value.py`)
- Add or deduct → Expense storage logic: reads and saves (evidence: `set_value.py`)
- Add or deduct → Transaction logging: records transaction (evidence: `set_value.py`)
- Budget storage logic → Budget file: reads and writes (evidence: `balance.py`)
- Expense storage logic → Expense file: reads and writes (evidence: `expense.py`)
- Transaction logging → Log file: reads and appends (evidence: `logs.py`)
- Totals and history → Expense file: reads expenses (evidence: `summary.py`)
- Totals and history → Budget file: reads budgets (evidence: `summary.py`)
- Totals and history → Transaction logging: loads logs (evidence: `summary.py`)
- Spending analysis → Budget file: reads budgets (evidence: `analysis.py`)
- Spending analysis → Expense file: reads expenses (evidence: `analysis.py`)
