# kimithora/veloura architecture

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

- Interactive diagram: https://gitdiagram.com/kimithora/veloura
- Repository: https://github.com/kimithora/veloura

## Overview

Veloura Accounting is a Django accounting application for recording company finances. Its documented workflow is to configure company, partner, accounting-period, and bank-account data, record bank transactions that create journal entries, and use accounting records for ledgers and financial statements. The README also describes capital tracking and a service-side profit-sharing workflow. The supplied tree contains no Django application source, so feature components have null paths and relationships are limited to README-documented behavior; implementation details cannot be verified.

Main entry points: [`db.sqlite3`](https://github.com/kimithora/veloura/blob/main/db.sqlite3) (SQLite Database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_accounting["Accounting"]
  node_company_setup["Company Setup"]
  node_periods["Accounting Periods"]
  node_coa["Chart of Accounts"]
  node_journal_entries["Journal Entries"]
  node_journal_actions["Journal Actions"]
  node_general_ledger["General Ledger"]
  node_trial_balance["Trial Balance"]
  node_income_statement["Income Statement"]
  node_balance_sheet["Balance Sheet"]
end

subgraph group_banking_capital["Banking & Capital"]
  node_partners["Partners"]
  node_bank_accounts["Bank Accounts"]
  node_bank_transactions["Bank Transactions"]
  node_capital_history["Capital History"]
  node_profit_sharing["Profit Sharing"]
  node_profit_snapshot["Snapshots & Approval"]
end

subgraph group_access_services["Access & Services"]
  node_django_admin["Django Admin"]
  node_access_control["Login & Roles"]
  node_audit_trail["Audit Trail"]
end

node_user(("User"))
node_sqlite[("SQLite Database<br/>[db.sqlite3]")]

node_user -->|"manages setup"| node_django_admin
node_user -->|"logs in"| node_access_control
node_user -->|"records transactions"| node_bank_transactions
node_django_admin -->|"configures"| node_company_setup
node_django_admin -->|"configures"| node_partners
node_django_admin -->|"configures"| node_periods
node_django_admin -->|"configures"| node_bank_accounts
node_bank_transactions -->|"automatically journals"| node_journal_entries
node_user -->|"creates"| node_journal_entries
node_user -->|"posts or reverses"| node_journal_actions
node_user -->|"views"| node_general_ledger
node_user -->|"views"| node_trial_balance
node_user -->|"views"| node_income_statement
node_user -->|"views"| node_balance_sheet
node_user -->|"tracks contributions"| node_capital_history
node_user -->|"simulates allocation"| node_profit_sharing
node_profit_sharing -->|"supports snapshots"| node_profit_snapshot
node_journal_entries -.->|"persists records"| node_sqlite
node_bank_transactions -.->|"persists records"| node_sqlite
node_audit_trail -.->|"persists events"| node_sqlite

click node_sqlite "https://github.com/kimithora/veloura/blob/main/db.sqlite3"

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_company_setup,node_periods,node_coa,node_journal_entries,node_journal_actions,node_general_ledger,node_trial_balance,node_income_statement,node_balance_sheet,node_user toneBlue
class node_partners,node_bank_accounts,node_bank_transactions,node_capital_history,node_profit_sharing,node_profit_snapshot,node_sqlite toneAmber
class node_django_admin,node_access_control,node_audit_trail toneMint
```

## Components

### Accounting

- **Company Setup**
- **Accounting Periods**
- **Chart of Accounts**
- **Journal Entries**
- **Journal Actions**
- **General Ledger**
- **Trial Balance**
- **Income Statement**
- **Balance Sheet**

### Banking & Capital

- **Partners**
- **Bank Accounts**
- **Bank Transactions**
- **Capital History**
- **Profit Sharing**
- **Snapshots & Approval**

### Access & Services

- **Django Admin**
- **Login & Roles**
- **Audit Trail**

### Other components

- **User**
- [SQLite Database](https://github.com/kimithora/veloura/blob/main/db.sqlite3): `db.sqlite3`

## Connections

- User → Django Admin: manages setup (evidence: `README.md`)
- User → Login & Roles: logs in (evidence: `README.md`)
- User → Bank Transactions: records transactions (evidence: `README.md`)
- Django Admin → Company Setup: configures (evidence: `README.md`)
- Django Admin → Partners: configures (evidence: `README.md`)
- Django Admin → Accounting Periods: configures (evidence: `README.md`)
- Django Admin → Bank Accounts: configures (evidence: `README.md`)
- Bank Transactions → Journal Entries: automatically journals (evidence: `README.md`)
- User → Journal Entries: creates (evidence: `README.md`)
- User → Journal Actions: posts or reverses (evidence: `README.md`)
- User → General Ledger: views (evidence: `README.md`)
- User → Trial Balance: views (evidence: `README.md`)
- User → Income Statement: views (evidence: `README.md`)
- User → Balance Sheet: views (evidence: `README.md`)
- User → Capital History: tracks contributions (evidence: `README.md`)
- User → Profit Sharing: simulates allocation (evidence: `README.md`)
- Profit Sharing → Snapshots & Approval: supports snapshots (evidence: `README.md`)
- Journal Entries → SQLite Database: persists records
- Bank Transactions → SQLite Database: persists records
- Audit Trail → SQLite Database: persists events