# kacperkicior/expensetracker architecture

> Architecture diagram of the GitHub repository kacperkicior/expensetracker, 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/kacperkicior/expensetracker
- Repository: https://github.com/kacperkicior/expensetracker

## Overview

This Django application lets users register, organize expenses into categories, review spending, export filtered records, and configure currency and language. Its main flow routes web requests to views, which validate forms and query or update expense data before rendering pages or returning a CSV. The graph also includes profile creation, shared currency context, and the documented language middleware configuration. Source excerpts establish the view, form, model, and signal relationships; unsampled project-level URL wiring is omitted.

Main entry points: [`expenses/views.py`](https://github.com/kacperkicior/expensetracker/blob/main/expenses/views.py) (Expense views), [`expenses/models.py`](https://github.com/kacperkicior/expensetracker/blob/main/expenses/models.py) (User profiles), [`expenses/forms.py`](https://github.com/kacperkicior/expensetracker/blob/main/expenses/forms.py) (Input forms), [`config/settings.py`](https://github.com/kacperkicior/expensetracker/blob/main/config/settings.py) (Request configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interaction"]
  node_routes["Expense routes<br/>[urls.py]"]
  node_views["Expense views<br/>[views.py]"]
  node_pages["Rendered pages"]
  node_csv["CSV export<br/>[views.py]"]
  node_forms["Input forms<br/>[forms.py]"]
end

subgraph group_domain["Expense domain"]
  node_expenses["Expense records<br/>[models.py]"]
  node_categories["Expense categories<br/>[models.py]"]
  node_database[("SQLite database<br/>[settings.py]")]
end

subgraph group_identity["Accounts and preferences"]
  node_registration["Account registration<br/>[views.py]"]
  node_profiles["User profiles<br/>[models.py]"]
  node_profile_signal["Profile creation signal<br/>[signals.py]"]
  node_app_config["App initialization<br/>[apps.py]"]
  node_preferences["Profile settings<br/>[views.py]"]
end

subgraph group_runtime["Shared request context"]
  node_currency_context["Currency context"]
  node_request_config["Request configuration<br/>[settings.py]"]
  node_language_middleware["Language middleware<br/>[middleware.py]"]
end

node_user(("User"))

node_user -->|"requests pages"| node_routes
node_routes -->|"dispatches to"| node_views
node_views -->|"validates input"| node_forms
node_views -->|"queries and saves"| node_expenses
node_views -->|"queries and saves"| node_categories
node_views -->|"renders"| node_pages
node_views -->|"generates export"| node_csv
node_views -->|"persists and queries"| node_database
node_registration -->|"validates signup"| node_forms
node_registration -->|"creates user"| node_profiles
node_app_config -->|"loads signal"| node_profile_signal
node_profile_signal -->|"creates or retrieves"| node_profiles
node_preferences -->|"validates settings"| node_forms
node_preferences -->|"saves profile"| node_profiles
node_currency_context -->|"reads currency"| node_profiles
node_request_config -->|"configures processor"| node_currency_context
node_request_config -->|"configures middleware"| node_language_middleware

click node_routes "https://github.com/kacperkicior/expensetracker/blob/main/expenses/urls.py"
click node_views "https://github.com/kacperkicior/expensetracker/blob/main/expenses/views.py"
click node_pages "https://github.com/kacperkicior/expensetracker/tree/main/expenses/templates"
click node_csv "https://github.com/kacperkicior/expensetracker/blob/main/expenses/views.py"
click node_forms "https://github.com/kacperkicior/expensetracker/blob/main/expenses/forms.py"
click node_expenses "https://github.com/kacperkicior/expensetracker/blob/main/expenses/models.py"
click node_categories "https://github.com/kacperkicior/expensetracker/blob/main/expenses/models.py"
click node_database "https://github.com/kacperkicior/expensetracker/blob/main/config/settings.py"
click node_registration "https://github.com/kacperkicior/expensetracker/blob/main/expenses/views.py"
click node_profiles "https://github.com/kacperkicior/expensetracker/blob/main/expenses/models.py"
click node_profile_signal "https://github.com/kacperkicior/expensetracker/blob/main/expenses/signals.py"
click node_app_config "https://github.com/kacperkicior/expensetracker/blob/main/expenses/apps.py"
click node_preferences "https://github.com/kacperkicior/expensetracker/blob/main/expenses/views.py"
click node_currency_context "https://github.com/kacperkicior/expensetracker/blob/main/expenses/content_processors.py"
click node_request_config "https://github.com/kacperkicior/expensetracker/blob/main/config/settings.py"
click node_language_middleware "https://github.com/kacperkicior/expensetracker/blob/main/expenses/middleware.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_views,node_pages,node_csv,node_forms,node_user toneBlue
class node_expenses,node_categories,node_database toneAmber
class node_registration,node_profiles,node_profile_signal,node_app_config,node_preferences toneMint
class node_currency_context,node_request_config,node_language_middleware toneRose
```

## Components

### Web interaction

- [Expense routes](https://github.com/kacperkicior/expensetracker/blob/main/expenses/urls.py): `expenses/urls.py`
- [Expense views](https://github.com/kacperkicior/expensetracker/blob/main/expenses/views.py): `expenses/views.py`
- [Rendered pages](https://github.com/kacperkicior/expensetracker/tree/main/expenses/templates): `expenses/templates`
- [CSV export](https://github.com/kacperkicior/expensetracker/blob/main/expenses/views.py): `expenses/views.py`
- [Input forms](https://github.com/kacperkicior/expensetracker/blob/main/expenses/forms.py): `expenses/forms.py`

### Expense domain

- [Expense records](https://github.com/kacperkicior/expensetracker/blob/main/expenses/models.py): `expenses/models.py`
- [Expense categories](https://github.com/kacperkicior/expensetracker/blob/main/expenses/models.py): `expenses/models.py`
- [SQLite database](https://github.com/kacperkicior/expensetracker/blob/main/config/settings.py): `config/settings.py`

### Accounts and preferences

- [Account registration](https://github.com/kacperkicior/expensetracker/blob/main/expenses/views.py): `expenses/views.py`
- [User profiles](https://github.com/kacperkicior/expensetracker/blob/main/expenses/models.py): `expenses/models.py`
- [Profile creation signal](https://github.com/kacperkicior/expensetracker/blob/main/expenses/signals.py): `expenses/signals.py`
- [App initialization](https://github.com/kacperkicior/expensetracker/blob/main/expenses/apps.py): `expenses/apps.py`
- [Profile settings](https://github.com/kacperkicior/expensetracker/blob/main/expenses/views.py): `expenses/views.py`

### Shared request context

- [Currency context](https://github.com/kacperkicior/expensetracker/blob/main/expenses/content_processors.py): `expenses/content_processors.py`
- [Request configuration](https://github.com/kacperkicior/expensetracker/blob/main/config/settings.py): `config/settings.py`
- [Language middleware](https://github.com/kacperkicior/expensetracker/blob/main/expenses/middleware.py): `expenses/middleware.py`

### Other components

- **User**

## Connections

- User → Expense routes: requests pages (evidence: `expenses/urls.py`)
- Expense routes → Expense views: dispatches to (evidence: `expenses/urls.py`)
- Expense views → Input forms: validates input (evidence: `expenses/views.py`)
- Expense views → Expense records: queries and saves (evidence: `expenses/views.py`)
- Expense views → Expense categories: queries and saves (evidence: `expenses/views.py`)
- Expense views → Rendered pages: renders (evidence: `expenses/views.py`)
- Expense views → CSV export: generates export (evidence: `expenses/views.py`)
- Expense views → SQLite database: persists and queries (evidence: `expenses/views.py`)
- Account registration → Input forms: validates signup (evidence: `expenses/views.py`)
- Account registration → User profiles: creates user (evidence: `expenses/views.py`)
- App initialization → Profile creation signal: loads signal (evidence: `expenses/apps.py`)
- Profile creation signal → User profiles: creates or retrieves (evidence: `expenses/signals.py`)
- Profile settings → Input forms: validates settings (evidence: `expenses/views.py`)
- Profile settings → User profiles: saves profile (evidence: `expenses/views.py`)
- Currency context → User profiles: reads currency (evidence: `expenses/content_processors.py`)
- Request configuration → Currency context: configures processor (evidence: `config/settings.py`)
- Request configuration → Language middleware: configures middleware (evidence: `config/settings.py`)
