# shenek/ucelofka architecture

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

## Overview

Ucelofka is a Rust invoice-management application with a command-line interface, a terminal UI, and a web entry point, backed by versioned YAML data models. The main workflow dispatches CLI commands to domain actions; the storage layer reads and writes records, while invoice construction combines issuer, customer, account, and entry data. The tree and excerpts support the CLI and TUI structure, but do not show enough web routing or action-to-storage calls to map those connections confidently.

Main entry points: [`ucelofka-data/src/lib.rs`](https://github.com/shenek/ucelofka/blob/master/ucelofka-data/src/lib.rs) (Versioned data models), [`ucelofka-data/src/invoice/v2.rs`](https://github.com/shenek/ucelofka/blob/master/ucelofka-data/src/invoice/v2.rs) (Invoice models), [`ucelofka/src/actions`](https://github.com/shenek/ucelofka/tree/master/ucelofka/src/actions) (Domain actions), [`ucelofka/src/tui`](https://github.com/shenek/ucelofka/tree/master/ucelofka/src/tui) (TUI domain screens)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application entry points"]
  node_main["CLI dispatcher<br/>[main.rs]"]
  node_web["Web entry point<br/>[web.rs]"]
end

subgraph group_domain["Domain actions"]
  node_actions["Domain actions"]
  node_invoice_action["Invoice actions<br/>[invoice.rs]"]
  node_project_action["Project actions<br/>[project.rs]"]
  node_template_action["Template actions<br/>[template.rs]"]
end

subgraph group_data["Data and persistence"]
  node_storage[("YAML record storage<br/>[storage.rs]")]
  node_schemas["Versioned data models<br/>[lib.rs]"]
  node_account_model["Account model<br/>[v1.rs]"]
  node_customer_model["Customer models<br/>[v1.rs]"]
  node_identification_model["Identification model<br/>[v1.rs]"]
  node_identity_model["Identity models<br/>[v1.rs]"]
  node_entry_model["Entry model<br/>[v1.rs]"]
  node_invoice_model["Invoice models<br/>[v2.rs]"]
  node_template_model["Template model<br/>[v1.rs]"]
end

subgraph group_interfaces["User interfaces"]
  node_tui_app["TUI navigation<br/>[app.rs]"]
  node_tui_screens["TUI domain screens"]
  node_tui_list["TUI list widget<br/>[list.rs]"]
  node_tui_table["TUI table widget<br/>[table.rs]"]
  node_web_handlers["Web domain handlers"]
end

node_user(("CLI user"))

node_user -->|"runs commands"| node_main
node_main -->|"dispatches CLI"| node_actions
node_main -->|"starts web"| node_web
node_actions -->|"includes"| node_invoice_action
node_actions -->|"includes"| node_project_action
node_actions -->|"includes"| node_template_action
node_schemas -->|"exports model"| node_account_model
node_schemas -->|"exports model"| node_customer_model
node_schemas -->|"exports model"| node_identification_model
node_schemas -->|"exports model"| node_identity_model
node_schemas -->|"exports model"| node_entry_model
node_schemas -->|"exports model"| node_invoice_model
node_schemas -->|"exports model"| node_template_model
node_invoice_model -->|"uses types"| node_customer_model
node_invoice_model -->|"uses types"| node_identity_model
node_invoice_model -->|"uses types"| node_account_model
node_invoice_model -->|"uses types"| node_entry_model
node_invoice_model -->|"uses type"| node_identification_model
node_tui_app -->|"renders screens"| node_tui_screens
node_tui_screens -->|"renders list"| node_tui_list
node_tui_screens -->|"renders table"| node_tui_table
node_tui_screens -->|"uses actions"| node_actions
node_web_handlers -->|"uses actions"| node_actions

click node_main "https://github.com/shenek/ucelofka/blob/master/ucelofka/src/main.rs"
click node_web "https://github.com/shenek/ucelofka/blob/master/ucelofka/src/web.rs"
click node_actions "https://github.com/shenek/ucelofka/tree/master/ucelofka/src/actions"
click node_invoice_action "https://github.com/shenek/ucelofka/blob/master/ucelofka/src/actions/invoice.rs"
click node_project_action "https://github.com/shenek/ucelofka/blob/master/ucelofka/src/actions/project.rs"
click node_template_action "https://github.com/shenek/ucelofka/blob/master/ucelofka/src/actions/template.rs"
click node_storage "https://github.com/shenek/ucelofka/blob/master/ucelofka/src/storage.rs"
click node_schemas "https://github.com/shenek/ucelofka/blob/master/ucelofka-data/src/lib.rs"
click node_account_model "https://github.com/shenek/ucelofka/blob/master/ucelofka-data/src/account/v1.rs"
click node_customer_model "https://github.com/shenek/ucelofka/blob/master/ucelofka-data/src/customer/v1.rs"
click node_identification_model "https://github.com/shenek/ucelofka/blob/master/ucelofka-data/src/identification/v1.rs"
click node_identity_model "https://github.com/shenek/ucelofka/blob/master/ucelofka-data/src/identity/v1.rs"
click node_entry_model "https://github.com/shenek/ucelofka/blob/master/ucelofka-data/src/entry/v1.rs"
click node_invoice_model "https://github.com/shenek/ucelofka/blob/master/ucelofka-data/src/invoice/v2.rs"
click node_template_model "https://github.com/shenek/ucelofka/blob/master/ucelofka-data/src/template/v1.rs"
click node_tui_app "https://github.com/shenek/ucelofka/blob/master/ucelofka/src/tui/app.rs"
click node_tui_screens "https://github.com/shenek/ucelofka/tree/master/ucelofka/src/tui"
click node_tui_list "https://github.com/shenek/ucelofka/blob/master/ucelofka/src/tui/list.rs"
click node_tui_table "https://github.com/shenek/ucelofka/blob/master/ucelofka/src/tui/table.rs"
click node_web_handlers "https://github.com/shenek/ucelofka/tree/master/ucelofka/src/web"

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_main,node_web,node_user toneBlue
class node_actions,node_invoice_action,node_project_action,node_template_action toneAmber
class node_storage,node_schemas,node_account_model,node_customer_model,node_identification_model,node_identity_model,node_entry_model,node_invoice_model,node_template_model toneMint
class node_tui_app,node_tui_screens,node_tui_list,node_tui_table,node_web_handlers toneRose
```

## Components

### Application entry points

- [CLI dispatcher](https://github.com/shenek/ucelofka/blob/master/ucelofka/src/main.rs): `ucelofka/src/main.rs`
- [Web entry point](https://github.com/shenek/ucelofka/blob/master/ucelofka/src/web.rs): `ucelofka/src/web.rs`

### Domain actions

- [Domain actions](https://github.com/shenek/ucelofka/tree/master/ucelofka/src/actions): `ucelofka/src/actions`
- [Invoice actions](https://github.com/shenek/ucelofka/blob/master/ucelofka/src/actions/invoice.rs): `ucelofka/src/actions/invoice.rs`
- [Project actions](https://github.com/shenek/ucelofka/blob/master/ucelofka/src/actions/project.rs): `ucelofka/src/actions/project.rs`
- [Template actions](https://github.com/shenek/ucelofka/blob/master/ucelofka/src/actions/template.rs): `ucelofka/src/actions/template.rs`

### Data and persistence

- [YAML record storage](https://github.com/shenek/ucelofka/blob/master/ucelofka/src/storage.rs): `ucelofka/src/storage.rs`
- [Versioned data models](https://github.com/shenek/ucelofka/blob/master/ucelofka-data/src/lib.rs): `ucelofka-data/src/lib.rs`
- [Account model](https://github.com/shenek/ucelofka/blob/master/ucelofka-data/src/account/v1.rs): `ucelofka-data/src/account/v1.rs`
- [Customer models](https://github.com/shenek/ucelofka/blob/master/ucelofka-data/src/customer/v1.rs): `ucelofka-data/src/customer/v1.rs`
- [Identification model](https://github.com/shenek/ucelofka/blob/master/ucelofka-data/src/identification/v1.rs): `ucelofka-data/src/identification/v1.rs`
- [Identity models](https://github.com/shenek/ucelofka/blob/master/ucelofka-data/src/identity/v1.rs): `ucelofka-data/src/identity/v1.rs`
- [Entry model](https://github.com/shenek/ucelofka/blob/master/ucelofka-data/src/entry/v1.rs): `ucelofka-data/src/entry/v1.rs`
- [Invoice models](https://github.com/shenek/ucelofka/blob/master/ucelofka-data/src/invoice/v2.rs): `ucelofka-data/src/invoice/v2.rs`
- [Template model](https://github.com/shenek/ucelofka/blob/master/ucelofka-data/src/template/v1.rs): `ucelofka-data/src/template/v1.rs`

### User interfaces

- [TUI navigation](https://github.com/shenek/ucelofka/blob/master/ucelofka/src/tui/app.rs): `ucelofka/src/tui/app.rs`
- [TUI domain screens](https://github.com/shenek/ucelofka/tree/master/ucelofka/src/tui): `ucelofka/src/tui`
- [TUI list widget](https://github.com/shenek/ucelofka/blob/master/ucelofka/src/tui/list.rs): `ucelofka/src/tui/list.rs`
- [TUI table widget](https://github.com/shenek/ucelofka/blob/master/ucelofka/src/tui/table.rs): `ucelofka/src/tui/table.rs`
- [Web domain handlers](https://github.com/shenek/ucelofka/tree/master/ucelofka/src/web): `ucelofka/src/web`

### Other components

- **CLI user**

## Connections

- CLI user → CLI dispatcher: runs commands
- CLI dispatcher → Domain actions: dispatches CLI (evidence: `ucelofka/src/main.rs`)
- CLI dispatcher → Web entry point: starts web (evidence: `ucelofka/src/main.rs`)
- Domain actions → Invoice actions: includes (evidence: `ucelofka/src/actions.rs`)
- Domain actions → Project actions: includes (evidence: `ucelofka/src/actions.rs`)
- Domain actions → Template actions: includes (evidence: `ucelofka/src/actions.rs`)
- Versioned data models → Account model: exports model (evidence: `ucelofka-data/src/lib.rs`)
- Versioned data models → Customer models: exports model (evidence: `ucelofka-data/src/lib.rs`)
- Versioned data models → Identification model: exports model (evidence: `ucelofka-data/src/lib.rs`)
- Versioned data models → Identity models: exports model (evidence: `ucelofka-data/src/lib.rs`)
- Versioned data models → Entry model: exports model (evidence: `ucelofka-data/src/lib.rs`)
- Versioned data models → Invoice models: exports model (evidence: `ucelofka-data/src/lib.rs`)
- Versioned data models → Template model: exports model (evidence: `ucelofka-data/src/lib.rs`)
- Invoice models → Customer models: uses types (evidence: `ucelofka-data/src/invoice/v2.rs`)
- Invoice models → Identity models: uses types (evidence: `ucelofka-data/src/invoice/v2.rs`)
- Invoice models → Account model: uses types (evidence: `ucelofka-data/src/invoice/v2.rs`)
- Invoice models → Entry model: uses types (evidence: `ucelofka-data/src/invoice/v2.rs`)
- Invoice models → Identification model: uses type (evidence: `ucelofka-data/src/invoice/v2.rs`)
- TUI navigation → TUI domain screens: renders screens (evidence: `ucelofka/src/tui/app.rs`)
- TUI domain screens → TUI list widget: renders list (evidence: `ucelofka/src/tui/identity.rs`)
- TUI domain screens → TUI table widget: renders table (evidence: `ucelofka/src/tui/identity.rs`)
- TUI domain screens → Domain actions: uses actions (evidence: `ucelofka/src/tui/identity.rs`)
- Web domain handlers → Domain actions: uses actions (evidence: `ucelofka/src/web/customer.rs`)
