# anhsirksai/campfire-income-statement architecture

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

- Interactive diagram: https://gitdiagram.com/anhsirksai/campfire-income-statement
- Repository: https://github.com/anhsirksai/campfire-income-statement

## Overview

This full-stack app produces date-range income statements for Northwind Coffee Roasters, optionally split by month, quarter, or year. Users choose a range in the Next.js interface; the backend validates it, retrieves posted ledger balances, builds statement sections and subtotals, and returns a response for display. Startup also loads and validates ledger data; the README documents 13 data-integrity rules. The graph includes those major capabilities, but some subsystem links are documented only in the README or source index; unsampled implementation details are not inferred.

Main entry points: [`backend/src/main/java/com/campfire/ledger/service/IncomeStatementServiceImpl.java`](https://github.com/anhsirksai/campfire-income-statement/blob/main/backend/src/main/java/com/campfire/ledger/service/IncomeStatementServiceImpl.java) (Statement service), [`frontend/src/app/page.tsx`](https://github.com/anhsirksai/campfire-income-statement/blob/main/frontend/src/app/page.tsx) (Statement page), [`frontend/src/components/ComparativeStatementTable.tsx`](https://github.com/anhsirksai/campfire-income-statement/blob/main/frontend/src/components/ComparativeStatementTable.tsx) (Comparative table), [`backend/src/main/java/com/campfire/ledger/controller/IncomeStatementController.java`](https://github.com/anhsirksai/campfire-income-statement/blob/main/backend/src/main/java/com/campfire/ledger/controller/IncomeStatementController.java) (Statement endpoint)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Statement interface"]
  node_page["Statement page<br/>[page.tsx]"]
  node_dateform["Date range form<br/>[DateRangeForm.tsx]"]
  node_table["Comparative table"]
  node_comparative["Period comparison<br/>[comparative.ts]"]
  node_api_client["API client<br/>[client.ts]"]
  node_money["Money formatting<br/>[money.ts]"]
end

subgraph group_api["Request and reporting"]
  node_controller["Statement endpoint"]
  node_service["Statement service"]
  node_strategy["Normal balance strategy"]
  node_response["Statement response"]
end

subgraph group_ledger["Ledger data"]
  node_loader["Startup data loader"]
  node_repository["Ledger repository"]
  node_dao["Journal line queries"]
  node_queries["Ledger SQL<br/>[LedgerQueries.java]"]
  node_database[("H2 ledger")]
end

subgraph group_validation["Ledger validation"]
  node_request_validation["Request validation"]
  node_rules["Validation rules"]
end

node_user(("User"))
node_http(("HTTP client"))

node_user -->|"opens"| node_page
node_page -.->|"collects dates"| node_dateform
node_page -.->|"requests statement"| node_api_client
node_api_client -->|"sends request"| node_http
node_http -->|"calls endpoint"| node_controller
node_controller -->|"validates period"| node_request_validation
node_request_validation -->|"applies rules"| node_rules
node_controller -->|"requests statement"| node_service
node_service -->|"loads balances"| node_repository
node_repository -->|"queries balances"| node_dao
node_dao -->|"executes SQL"| node_queries
node_dao -.->|"reads totals"| node_database
node_service -->|"normalizes balances"| node_strategy
node_service -->|"builds response"| node_response
node_response -.->|"returns data"| node_http
node_loader -->|"validates ledger"| node_request_validation
node_loader -->|"loads ledger"| node_database
node_response -.->|"renders statement"| node_table
node_table -.->|"formats periods"| node_comparative
node_table -.->|"formats amounts"| node_money

click node_page "https://github.com/anhsirksai/campfire-income-statement/blob/main/frontend/src/app/page.tsx"
click node_dateform "https://github.com/anhsirksai/campfire-income-statement/blob/main/frontend/src/components/DateRangeForm.tsx"
click node_table "https://github.com/anhsirksai/campfire-income-statement/blob/main/frontend/src/components/ComparativeStatementTable.tsx"
click node_comparative "https://github.com/anhsirksai/campfire-income-statement/blob/main/frontend/src/lib/statement/comparative.ts"
click node_api_client "https://github.com/anhsirksai/campfire-income-statement/blob/main/frontend/src/lib/api/client.ts"
click node_money "https://github.com/anhsirksai/campfire-income-statement/blob/main/frontend/src/lib/format/money.ts"
click node_controller "https://github.com/anhsirksai/campfire-income-statement/blob/main/backend/src/main/java/com/campfire/ledger/controller/IncomeStatementController.java"
click node_request_validation "https://github.com/anhsirksai/campfire-income-statement/blob/main/backend/src/main/java/com/campfire/ledger/validation/ValidationRegistry.java"
click node_rules "https://github.com/anhsirksai/campfire-income-statement/tree/main/validation/src/main/java/com/campfire/validation/rules"
click node_loader "https://github.com/anhsirksai/campfire-income-statement/blob/main/backend/src/main/java/com/campfire/ledger/config/LedgerDataLoader.java"
click node_service "https://github.com/anhsirksai/campfire-income-statement/blob/main/backend/src/main/java/com/campfire/ledger/service/IncomeStatementServiceImpl.java"
click node_strategy "https://github.com/anhsirksai/campfire-income-statement/blob/main/backend/src/main/java/com/campfire/ledger/strategy/NormalBalanceStrategyFactory.java"
click node_repository "https://github.com/anhsirksai/campfire-income-statement/blob/main/backend/src/main/java/com/campfire/ledger/repository/JdbcLedgerRepository.java"
click node_dao "https://github.com/anhsirksai/campfire-income-statement/blob/main/backend/src/main/java/com/campfire/ledger/dao/JournalLineDao.java"
click node_queries "https://github.com/anhsirksai/campfire-income-statement/blob/main/backend/src/main/java/com/campfire/ledger/query/LedgerQueries.java"
click node_response "https://github.com/anhsirksai/campfire-income-statement/blob/main/backend/src/main/java/com/campfire/ledger/model/dto/IncomeStatementResponse.java"

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_page,node_dateform,node_table,node_comparative,node_api_client,node_money,node_user,node_http toneBlue
class node_controller,node_service,node_strategy,node_response toneAmber
class node_loader,node_repository,node_dao,node_queries,node_database toneMint
class node_request_validation,node_rules toneRose
```

## Components

### Statement interface

- [Statement page](https://github.com/anhsirksai/campfire-income-statement/blob/main/frontend/src/app/page.tsx): `frontend/src/app/page.tsx`
- [Date range form](https://github.com/anhsirksai/campfire-income-statement/blob/main/frontend/src/components/DateRangeForm.tsx): `frontend/src/components/DateRangeForm.tsx`
- [Comparative table](https://github.com/anhsirksai/campfire-income-statement/blob/main/frontend/src/components/ComparativeStatementTable.tsx): `frontend/src/components/ComparativeStatementTable.tsx`
- [Period comparison](https://github.com/anhsirksai/campfire-income-statement/blob/main/frontend/src/lib/statement/comparative.ts): `frontend/src/lib/statement/comparative.ts`
- [API client](https://github.com/anhsirksai/campfire-income-statement/blob/main/frontend/src/lib/api/client.ts): `frontend/src/lib/api/client.ts`
- [Money formatting](https://github.com/anhsirksai/campfire-income-statement/blob/main/frontend/src/lib/format/money.ts): `frontend/src/lib/format/money.ts`

### Request and reporting

- [Statement endpoint](https://github.com/anhsirksai/campfire-income-statement/blob/main/backend/src/main/java/com/campfire/ledger/controller/IncomeStatementController.java): `backend/src/main/java/com/campfire/ledger/controller/IncomeStatementController.java`
- [Statement service](https://github.com/anhsirksai/campfire-income-statement/blob/main/backend/src/main/java/com/campfire/ledger/service/IncomeStatementServiceImpl.java): `backend/src/main/java/com/campfire/ledger/service/IncomeStatementServiceImpl.java`
- [Normal balance strategy](https://github.com/anhsirksai/campfire-income-statement/blob/main/backend/src/main/java/com/campfire/ledger/strategy/NormalBalanceStrategyFactory.java): `backend/src/main/java/com/campfire/ledger/strategy/NormalBalanceStrategyFactory.java`
- [Statement response](https://github.com/anhsirksai/campfire-income-statement/blob/main/backend/src/main/java/com/campfire/ledger/model/dto/IncomeStatementResponse.java): `backend/src/main/java/com/campfire/ledger/model/dto/IncomeStatementResponse.java`

### Ledger data

- [Startup data loader](https://github.com/anhsirksai/campfire-income-statement/blob/main/backend/src/main/java/com/campfire/ledger/config/LedgerDataLoader.java): `backend/src/main/java/com/campfire/ledger/config/LedgerDataLoader.java`
- [Ledger repository](https://github.com/anhsirksai/campfire-income-statement/blob/main/backend/src/main/java/com/campfire/ledger/repository/JdbcLedgerRepository.java): `backend/src/main/java/com/campfire/ledger/repository/JdbcLedgerRepository.java`
- [Journal line queries](https://github.com/anhsirksai/campfire-income-statement/blob/main/backend/src/main/java/com/campfire/ledger/dao/JournalLineDao.java): `backend/src/main/java/com/campfire/ledger/dao/JournalLineDao.java`
- [Ledger SQL](https://github.com/anhsirksai/campfire-income-statement/blob/main/backend/src/main/java/com/campfire/ledger/query/LedgerQueries.java): `backend/src/main/java/com/campfire/ledger/query/LedgerQueries.java`
- **H2 ledger**

### Ledger validation

- [Request validation](https://github.com/anhsirksai/campfire-income-statement/blob/main/backend/src/main/java/com/campfire/ledger/validation/ValidationRegistry.java): `backend/src/main/java/com/campfire/ledger/validation/ValidationRegistry.java`
- [Validation rules](https://github.com/anhsirksai/campfire-income-statement/tree/main/validation/src/main/java/com/campfire/validation/rules): `validation/src/main/java/com/campfire/validation/rules`

### Other components

- **User**
- **HTTP client**

## Connections

- User → Statement page: opens (evidence: `README.md`)
- Statement page → Date range form: collects dates
- Statement page → API client: requests statement
- API client → HTTP client: sends request (evidence: `README.md`)
- HTTP client → Statement endpoint: calls endpoint (evidence: `README.md`)
- Statement endpoint → Request validation: validates period (evidence: `backend/src/main/java/com/campfire/ledger/controller/IncomeStatementController.java`)
- Request validation → Validation rules: applies rules (evidence: `README.md`)
- Statement endpoint → Statement service: requests statement (evidence: `backend/src/main/java/com/campfire/ledger/controller/IncomeStatementController.java`)
- Statement service → Ledger repository: loads balances (evidence: `backend/src/main/java/com/campfire/ledger/service/IncomeStatementServiceImpl.java`)
- Ledger repository → Journal line queries: queries balances (evidence: `backend/src/main/java/com/campfire/ledger/repository/JdbcLedgerRepository.java`)
- Journal line queries → Ledger SQL: executes SQL (evidence: `backend/src/main/java/com/campfire/ledger/dao/JournalLineDao.java`)
- Journal line queries → H2 ledger: reads totals
- Statement service → Normal balance strategy: normalizes balances (evidence: `backend/src/main/java/com/campfire/ledger/service/IncomeStatementServiceImpl.java`)
- Statement service → Statement response: builds response (evidence: `backend/src/main/java/com/campfire/ledger/service/IncomeStatementServiceImpl.java`)
- Statement response → HTTP client: returns data
- Startup data loader → Request validation: validates ledger (evidence: `backend/src/main/java/com/campfire/ledger/config/LedgerDataLoader.java`)
- Startup data loader → H2 ledger: loads ledger (evidence: `README.md`)
- Statement response → Comparative table: renders statement
- Comparative table → Period comparison: formats periods
- Comparative table → Money formatting: formats amounts
