Skip to content

Sub-Domain Blueprint: Finance Reporting

Domain: Finance (Ledger, Budget, AP, AR) Logical Sub-Domain: Reporting (Analytics) Physical Packages: @sd/mod-finance/reporting Related Documents: Data Definition Context: This document defines the Standard Financial Statements (Balance Sheet, P&L). Status: Stable (v2.5)

1. Mandate

The Reporting Sub-Domain aggregates Ledger data into consumption-ready views. It provides Real-Time financial visibility to the Board and Treasurer, including Budget Variance and Net Worth calculations.

2. Capabilities

Capability Description Component
Balance Sheet Net Worth snapshot (Assets - Libs = Equity). getBalanceSheet
Profit & Loss Income vs Expenses over a period. getProfitAndLoss
Budget Variance Comparing Actuals vs Budget Targets. getBudgetVariance
Traceability Breakdown of costs per Unit/Asset (Cost Accounting). TraceabilityReport

3. Process Models

A. Generating Monthly P&L

Happy Path: Admin views Jan 2026 Report.

sequenceDiagram
    participant Admin
    participant Service as ReportingService
    participant GL as LedgerService

    Admin->>Service: getP&L(Jan 1, Jan 31)
    Service->>GL: getEntries(Jan 1, Jan 31)
    Service->>Service: Filter Revenue/Expense Accounts
    Service->>Service: Sum Balances
    Service-->>Admin: P&L { NetIncome: $5000 }

5. Interface Definitions

ReportingService

  • getBalanceSheet(date): Promise<BalanceSheet>
  • getProfitAndLoss(start, end): Promise<PL>
  • getBudgetVariance(year): Promise<Variance>

6. Changelog

Date Author Description Reference
2026-01-24 Antigravity Initial creation Implementation Plan