How anhsirksai/campfire-income-statement works
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: IncomeStatementServiceImpl.java Statement service · page.tsx Statement page · ComparativeStatementTable.tsx Comparative table · IncomeStatementController.java Statement endpoint
Components 19
Statement interface
- Statement page
frontend/src/app/page.tsx - Date range form
frontend/src/components/DateRangeForm.tsx - Comparative table
frontend/src/components/ComparativeStatementTable.tsx - Period comparison
frontend/src/lib/statement/comparative.ts - API client
frontend/src/lib/api/client.ts - Money formatting
frontend/src/lib/format/money.ts
Request and reporting
- Statement endpoint
backend/src/main/java/com/campfire/ledger/controller/IncomeStatementController.java - Statement service
backend/src/main/java/com/campfire/ledger/service/IncomeStatementServiceImpl.java - Normal balance strategy
backend/src/main/java/com/campfire/ledger/strategy/NormalBalanceStrategyFactory.java - Statement response
backend/src/main/java/com/campfire/ledger/model/dto/IncomeStatementResponse.java
Ledger data
- Startup data loader
backend/src/main/java/com/campfire/ledger/config/LedgerDataLoader.java - Ledger repository
backend/src/main/java/com/campfire/ledger/repository/JdbcLedgerRepository.java - Journal line queries
backend/src/main/java/com/campfire/ledger/dao/JournalLineDao.java - Ledger SQL
backend/src/main/java/com/campfire/ledger/query/LedgerQueries.java - H2 ledger
Ledger validation
- Request validation
backend/src/main/java/com/campfire/ledger/validation/ValidationRegistry.java - Validation rules
validation/src/main/java/com/campfire/validation/rules
Other components
- User
- HTTP client
Connections 20
- User → Statement page: opens
README.md - Statement page → Date range form: collects dates
- Statement page → API client: requests statement
- API client → HTTP client: sends request
README.md - HTTP client → Statement endpoint: calls endpoint
README.md - Statement endpoint → Request validation: validates period
backend/src/main/java/com/campfire/ledger/controller/IncomeStatementController.java - Request validation → Validation rules: applies rules
README.md - Statement endpoint → Statement service: requests statement
backend/src/main/java/com/campfire/ledger/controller/IncomeStatementController.java - Statement service → Ledger repository: loads balances
backend/src/main/java/com/campfire/ledger/service/IncomeStatementServiceImpl.java - Ledger repository → Journal line queries: queries balances
backend/src/main/java/com/campfire/ledger/repository/JdbcLedgerRepository.java - Journal line queries → Ledger SQL: executes SQL
backend/src/main/java/com/campfire/ledger/dao/JournalLineDao.java - Journal line queries → H2 ledger: reads totals
- Statement service → Normal balance strategy: normalizes balances
backend/src/main/java/com/campfire/ledger/service/IncomeStatementServiceImpl.java - Statement service → Statement response: builds response
backend/src/main/java/com/campfire/ledger/service/IncomeStatementServiceImpl.java - Statement response → HTTP client: returns data
- Startup data loader → Request validation: validates ledger
backend/src/main/java/com/campfire/ledger/config/LedgerDataLoader.java - Startup data loader → H2 ledger: loads ledger
README.md - Statement response → Comparative table: renders statement
- Comparative table → Period comparison: formats periods
- Comparative table → Money formatting: formats amounts