Skip to content

Architecture Docs Index

Topic docs — read the one matching the area before touching code. System context, layering diagram and the ADR table live in overview.md.

  • data-layer.md — ER diagram, entities, DAOs, migrations, encryption. Read when touching data/db/, bumping @Database, or writing a migration.
  • ingestion-pipeline.md — listener, extractor, filter, CapturePipeline sequence, routing decisions, replay, cross-source dedupe. Read when touching listener/ or capture behavior.
  • parser.md — rules, candidates, amount parsing, confidence, golden fixtures, starter rule sets. Read when touching parser/ or adding bank rules/fixtures.
  • classification.md — the CategoryClassifier seam, keyword implementation, overrides. Read when touching domain/category/ or category keywords.
  • money.md — currency tables, AmountParser, formatters, import path, FX conversion. Read when touching money math or common/Currency.
  • ui.md — navigation graph, screens & ViewModels pattern, shared components, charts, adaptive layout. Read when touching ui/.
  • security.md — threat model, encryption at rest, app lock, masked-content handling. Read when touching lock/crypto/privacy.
  • tooling.md — build stack, icon-catalog generator, 16 KB support, test layout, CI, release process. Read when touching build config or CI.

Decisions: ../adr/ — indexed from overview.md and CONTEXT.md.