# dhineshkrishna/expensetracker architecture

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

- Interactive diagram: https://gitdiagram.com/dhineshkrishna/expensetracker
- Repository: https://github.com/dhineshkrishna/expensetracker

## Overview

This repository is an Expense Management API. A client sends expense creation, listing, or summary requests; the server routes them to HTTP handlers, which delegate to the service and SQLite repository and return JSON. The service assigns missing UUIDs and creation timestamps; listing supports category/date filtering, sorting, and a calculated total, while summary aggregates spending by category. The graph follows the sampled Go source; the README documents retry safety and in-memory storage as capabilities, but their implementations are not shown.

Main entry points: [`cmd/server/main.go`](https://github.com/dhineshkrishna/expensetracker/blob/main/cmd/server/main.go) (HTTP Server), [`internal/repository/sqllite_expense_repo.go`](https://github.com/dhineshkrishna/expensetracker/blob/main/internal/repository/sqllite_expense_repo.go) (SQLite Repository), [`internal/handler/expense_handler.go`](https://github.com/dhineshkrishna/expensetracker/blob/main/internal/handler/expense_handler.go) (Create Handler), [`internal/repository/expense_repository.go`](https://github.com/dhineshkrishna/expensetracker/blob/main/internal/repository/expense_repository.go) (Repository Contract)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_server["HTTP Server<br/>[main.go]"]
  node_create_handler["Create Handler<br/>[expense_handler.go]"]
  node_list_handler["List Handler<br/>[expense_handler.go]"]
  node_summary_handler["Summary Handler<br/>[expense_handler.go]"]
end

subgraph group_logic["Expense Logic"]
  node_create_service["Create Expense<br/>[expense_service.go]"]
  node_list_service["Query Expenses<br/>[expense_service.go]"]
  node_summary_service["Summarize Spending<br/>[expense_service.go]"]
  node_category_filters["Category And Dates"]
  node_sort_total["Sort And Total"]
  node_category_summary["Category Totals"]
end

subgraph group_storage["SQLite Storage"]
  node_repo_contract["Repository Contract"]
  node_sqlite_repo["SQLite Repository"]
  node_db_init["Database Setup<br/>[sqllite.go]"]
  node_expense_db[("Expense Database<br/>[expenses.db]")]
end

subgraph group_domain["Domain Model"]
  node_expense_model["Expense Record<br/>[expense.go]"]
end

node_client(("API Client"))

node_client -->|"sends requests"| node_server
node_server -->|"routes POST"| node_create_handler
node_server -->|"routes GET"| node_list_handler
node_server -->|"routes summary"| node_summary_handler
node_create_handler -->|"creates expense"| node_create_service
node_list_handler -->|"queries expenses"| node_list_service
node_summary_handler -->|"requests totals"| node_summary_service
node_create_service -->|"calls Create"| node_repo_contract
node_list_service -->|"calls Get"| node_repo_contract
node_summary_service -->|"calls GetSummary"| node_repo_contract
node_server -->|"initializes"| node_db_init
node_server -->|"constructs"| node_sqlite_repo
node_sqlite_repo -->|"implements"| node_repo_contract
node_db_init -->|"creates schema"| node_expense_db
node_sqlite_repo -->|"reads and writes"| node_expense_db
node_create_service -->|"sets ID and time"| node_expense_model
node_create_handler -->|"decodes request"| node_expense_model
node_sqlite_repo -->|"filters query"| node_category_filters
node_sqlite_repo -->|"sorts and totals"| node_sort_total
node_sqlite_repo -->|"aggregates by category"| node_category_summary
node_create_handler -->|"returns JSON"| node_client
node_list_handler -->|"returns JSON"| node_client
node_summary_handler -->|"returns JSON"| node_client

click node_server "https://github.com/dhineshkrishna/expensetracker/blob/main/cmd/server/main.go"
click node_create_handler "https://github.com/dhineshkrishna/expensetracker/blob/main/internal/handler/expense_handler.go"
click node_list_handler "https://github.com/dhineshkrishna/expensetracker/blob/main/internal/handler/expense_handler.go"
click node_summary_handler "https://github.com/dhineshkrishna/expensetracker/blob/main/internal/handler/expense_handler.go"
click node_create_service "https://github.com/dhineshkrishna/expensetracker/blob/main/internal/service/expense_service.go"
click node_list_service "https://github.com/dhineshkrishna/expensetracker/blob/main/internal/service/expense_service.go"
click node_summary_service "https://github.com/dhineshkrishna/expensetracker/blob/main/internal/service/expense_service.go"
click node_repo_contract "https://github.com/dhineshkrishna/expensetracker/blob/main/internal/repository/expense_repository.go"
click node_sqlite_repo "https://github.com/dhineshkrishna/expensetracker/blob/main/internal/repository/sqllite_expense_repo.go"
click node_db_init "https://github.com/dhineshkrishna/expensetracker/blob/main/internal/db/sqllite.go"
click node_expense_db "https://github.com/dhineshkrishna/expensetracker/blob/main/cmd/server/expenses.db"
click node_expense_model "https://github.com/dhineshkrishna/expensetracker/blob/main/internal/domain/expense.go"
click node_category_filters "https://github.com/dhineshkrishna/expensetracker/blob/main/internal/repository/sqllite_expense_repo.go"
click node_sort_total "https://github.com/dhineshkrishna/expensetracker/blob/main/internal/repository/sqllite_expense_repo.go"
click node_category_summary "https://github.com/dhineshkrishna/expensetracker/blob/main/internal/repository/sqllite_expense_repo.go"

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_server,node_create_handler,node_list_handler,node_summary_handler,node_client toneBlue
class node_create_service,node_list_service,node_summary_service,node_category_filters,node_sort_total,node_category_summary toneAmber
class node_repo_contract,node_sqlite_repo,node_db_init,node_expense_db toneMint
class node_expense_model toneRose
```

## Components

### HTTP API

- [HTTP Server](https://github.com/dhineshkrishna/expensetracker/blob/main/cmd/server/main.go): `cmd/server/main.go`
- [Create Handler](https://github.com/dhineshkrishna/expensetracker/blob/main/internal/handler/expense_handler.go): `internal/handler/expense_handler.go`
- [List Handler](https://github.com/dhineshkrishna/expensetracker/blob/main/internal/handler/expense_handler.go): `internal/handler/expense_handler.go`
- [Summary Handler](https://github.com/dhineshkrishna/expensetracker/blob/main/internal/handler/expense_handler.go): `internal/handler/expense_handler.go`

### Expense Logic

- [Create Expense](https://github.com/dhineshkrishna/expensetracker/blob/main/internal/service/expense_service.go): `internal/service/expense_service.go`
- [Query Expenses](https://github.com/dhineshkrishna/expensetracker/blob/main/internal/service/expense_service.go): `internal/service/expense_service.go`
- [Summarize Spending](https://github.com/dhineshkrishna/expensetracker/blob/main/internal/service/expense_service.go): `internal/service/expense_service.go`
- [Category And Dates](https://github.com/dhineshkrishna/expensetracker/blob/main/internal/repository/sqllite_expense_repo.go): `internal/repository/sqllite_expense_repo.go`
- [Sort And Total](https://github.com/dhineshkrishna/expensetracker/blob/main/internal/repository/sqllite_expense_repo.go): `internal/repository/sqllite_expense_repo.go`
- [Category Totals](https://github.com/dhineshkrishna/expensetracker/blob/main/internal/repository/sqllite_expense_repo.go): `internal/repository/sqllite_expense_repo.go`

### SQLite Storage

- [Repository Contract](https://github.com/dhineshkrishna/expensetracker/blob/main/internal/repository/expense_repository.go): `internal/repository/expense_repository.go`
- [SQLite Repository](https://github.com/dhineshkrishna/expensetracker/blob/main/internal/repository/sqllite_expense_repo.go): `internal/repository/sqllite_expense_repo.go`
- [Database Setup](https://github.com/dhineshkrishna/expensetracker/blob/main/internal/db/sqllite.go): `internal/db/sqllite.go`
- [Expense Database](https://github.com/dhineshkrishna/expensetracker/blob/main/cmd/server/expenses.db): `cmd/server/expenses.db`

### Domain Model

- [Expense Record](https://github.com/dhineshkrishna/expensetracker/blob/main/internal/domain/expense.go): `internal/domain/expense.go`

### Other components

- **API Client**

## Connections

- API Client → HTTP Server: sends requests (evidence: `cmd/server/main.go`)
- HTTP Server → Create Handler: routes POST (evidence: `cmd/server/main.go`)
- HTTP Server → List Handler: routes GET (evidence: `cmd/server/main.go`)
- HTTP Server → Summary Handler: routes summary (evidence: `cmd/server/main.go`)
- Create Handler → Create Expense: creates expense (evidence: `internal/handler/expense_handler.go`)
- List Handler → Query Expenses: queries expenses (evidence: `internal/handler/expense_handler.go`)
- Summary Handler → Summarize Spending: requests totals (evidence: `internal/handler/expense_handler.go`)
- Create Expense → Repository Contract: calls Create (evidence: `internal/service/expense_service.go`)
- Query Expenses → Repository Contract: calls Get (evidence: `internal/service/expense_service.go`)
- Summarize Spending → Repository Contract: calls GetSummary (evidence: `internal/service/expense_service.go`)
- HTTP Server → Database Setup: initializes (evidence: `cmd/server/main.go`)
- HTTP Server → SQLite Repository: constructs (evidence: `cmd/server/main.go`)
- SQLite Repository → Repository Contract: implements
- Database Setup → Expense Database: creates schema (evidence: `internal/db/sqllite.go`)
- SQLite Repository → Expense Database: reads and writes (evidence: `internal/repository/sqllite_expense_repo.go`)
- Create Expense → Expense Record: sets ID and time (evidence: `internal/service/expense_service.go`)
- Create Handler → Expense Record: decodes request (evidence: `internal/handler/expense_handler.go`)
- SQLite Repository → Category And Dates: filters query (evidence: `internal/repository/sqllite_expense_repo.go`)
- SQLite Repository → Sort And Total: sorts and totals (evidence: `internal/repository/sqllite_expense_repo.go`)
- SQLite Repository → Category Totals: aggregates by category (evidence: `internal/repository/sqllite_expense_repo.go`)
- Create Handler → API Client: returns JSON (evidence: `internal/handler/expense_handler.go`)
- List Handler → API Client: returns JSON (evidence: `internal/handler/expense_handler.go`)
- Summary Handler → API Client: returns JSON (evidence: `internal/handler/expense_handler.go`)
