How tks18/personal-finance-etl works
Personal Finance ETL is a local-first financial evidence and analytics platform. Users launch runs through the CLI or desktop, which invoke the application facade and pipeline orchestrator; the pipeline acquires and transforms financial evidence, reconstructs investment and household state, reconciles it, and publishes analytics for tax, wealth, FIRE, and BI decisions. The README documents capabilities broader than the sampled implementation excerpts; those branches are represented at supported source-directory paths. Edges are limited to explicit README claims or SOURCE INDEX references, so some internal handoffs remain unshown.
Main entry points: investments Investment accounting · gold.py Gold decision marts · ingestion Evidence ingestion · household Household finance
Components 22
User interfaces
- CLI
src/personal_finance_etl/presentation/cli/app.py - Desktop app
src/personal_finance_etl/presentation/desktop/app.py - Engine facade
src/personal_finance_etl/application/facade.py
Evidence pipeline
- Run orchestrator
src/personal_finance_etl/application/pipeline/orchestrator.py - Pipeline executor
src/personal_finance_etl/application/pipeline/execution.py - Evidence ingestion
src/personal_finance_etl/application/ingestion - File and market providers
src/personal_finance_etl/infrastructure/providers - Bronze evidence
src/personal_finance_etl/infrastructure/warehouse/bronze.py - Canonical transforms
src/personal_finance_etl/domain/household/transforms - Silver facts
src/personal_finance_etl/infrastructure/warehouse/silver.py
Financial analysis
- Household finance
src/personal_finance_etl/domain/household - Investment accounting
src/personal_finance_etl/application/investments - Investment reconciliation
src/personal_finance_etl/domain/investments/reconciliation/engine.py - Market and FX analytics
src/personal_finance_etl/domain/market - Tax evidence
src/personal_finance_etl/application/tax/tax_service.py - Wealth analytics
src/personal_finance_etl/application/wealth/wealth_service.py - FIRE forecasting
src/personal_finance_etl/domain/fire - Financial rules
src/personal_finance_etl/config/financial_rules
Operational state
- Run and artifact records
src/personal_finance_etl/infrastructure/control_plane
Analytics publication
- Gold decision marts
src/personal_finance_etl/infrastructure/warehouse/gold.py
Other components
- Finance user
- BI and analytics
Connections 27
- Finance user → CLI: runs
README.md - Finance user → Desktop app: runs
README.md - CLI → Engine facade: invokes
src/personal_finance_etl/presentation/cli/app.py - Desktop app → Engine facade: invokes
src/personal_finance_etl/presentation/desktop/app.py - Engine facade → Run orchestrator: starts run
src/personal_finance_etl/application/facade.py - Run orchestrator → Pipeline executor: delegates phases
src/personal_finance_etl/application/pipeline/orchestrator.py - Pipeline executor → Evidence ingestion: acquires evidence
README.md - Evidence ingestion → File and market providers: uses providers
README.md - Evidence ingestion → Run and artifact records: records runs
README.md - Evidence ingestion → Bronze evidence: synchronizes evidence
README.md - Bronze evidence → Canonical transforms: feeds
README.md - Canonical transforms → Silver facts: canonicalizes
README.md - Silver facts → Household finance: supports reconstruction
README.md - Silver facts → Investment accounting: supports reconstruction
README.md - Investment accounting → Investment reconciliation: compares state
README.md - Investment accounting → Tax evidence: provides realized economics
README.md - Household finance → Tax evidence: provides context
README.md - Household finance → Wealth analytics: contributes state
README.md - Investment accounting → Wealth analytics: contributes state
README.md - Market and FX analytics → Investment accounting: supplies market data
src/personal_finance_etl/application/investments/isin_service/pipeline.py - Wealth analytics → FIRE forecasting: models uncertainty
README.md - Household finance → Gold decision marts: publishes analytics
README.md - Investment accounting → Gold decision marts: publishes analytics
README.md - Tax evidence → Gold decision marts: publishes evidence
README.md - FIRE forecasting → Gold decision marts: publishes forecasts
README.md - Gold decision marts → BI and analytics: serves marts
README.md - Financial rules → Investment accounting: configures analysis
src/personal_finance_etl/application/investments/isin_service/pipeline.py