Model/docs/adr
Khalim Conn-Kowlessar 772cdd4f5a docs(modelling): #1157 Plan-persistence design review
Outcome of the /grill-with-docs session scoping #1157.

- CONTEXT.md: add **Plan Measure** (the persisted selected Option +
  role-3 attribution + cost); Recommendation stays the candidate.
  Remove Scenario Phase / Plan Phase / Rolled-over Options — multi-phase
  is deferred. Reshape Scenario + Plan to single-phase; fix relationships,
  dialogue, and the "phase" ambiguity note.
- ADR-0005: rewritten to Deferred (multi-phase was speculative
  prospective-client work; single-phase now; future plan_phase back-fill
  path preserved). Stray phase refs cleaned in ADR-0016 / ADR-0009.
- ADR-0017 (new): Plan persistence — reuse the live plan/recommendation
  tables via SQLModel mirrors + a PlanRepository on the UoW; add
  recommendation.plan_id, retire the plan_recommendations m2m; flat
  post-retrofit on plan; idempotent replace; CO2 in tonnes. Unselected
  alternatives + bills noted as deferred directions.
- docs/migrations/recommendation-plan-id.md: the FE-owned Drizzle change.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-03 11:12:54 +00:00
..
0001-two-source-paths.md added architechtural decisions, added to prd 2026-05-13 21:26:18 +00:00
0002-property-aggregate-root.md added architechtural decisions, added to prd 2026-05-13 21:26:18 +00:00
0003-python-writes-landlord-overrides-directly.md move landlord overrides 2026-06-01 15:46:46 +00:00
0003-strict-ingestion-modelling-separation.md docs(ara): composable stage-orchestrator design (ADR-0011 + ADR-0003 amend + CONTEXT) 2026-06-01 16:28:48 +00:00
0004-baseline-performance-lodged-effective-pair.md refactor(property-baseline): rename baseline → property_baseline aggregate (PR #1139 review) 2026-06-01 16:28:48 +00:00
0005-multi-phase-scenarios-per-phase-recompute.md docs(modelling): #1157 Plan-persistence design review 2026-06-03 11:12:54 +00:00
0006-deterministic-kwh-no-baseline-ml.md scaffolding for ml pipeline 2026-05-16 14:15:56 +00:00
0007-kwh-as-ml-target.md scaffolding for ml pipeline 2026-05-16 14:15:56 +00:00
0008-physics-as-feature.md docs: ADR-0008 physics-as-feature + v16.0.0 schema bump 2026-05-17 11:20:40 +00:00
0009-deterministic-sap-calculator.md docs(modelling): #1157 Plan-persistence design review 2026-06-03 11:12:54 +00:00
0010-sap10-calculator-spec-target-and-validation.md refactor: move docs/sap-spec/ contents into domain/sap10_calculator/ 2026-05-26 13:17:18 +00:00
0011-composable-stage-orchestrators.md docs(ara): composable stage-orchestrator design (ADR-0011 + ADR-0003 amend + CONTEXT) 2026-06-01 16:28:48 +00:00
0012-unit-of-work-per-stage-batch-transaction.md refactor(orchestration): wire stages onto the UnitOfWork; per-stage commit (#1138) 2026-06-01 16:28:48 +00:00
0013-calculator-produces-effective-performance-shadow-first.md docs(baseline): Bill Derivation design — fuel as calculator output + rebaselining is assemble-and-score 2026-06-02 18:04:55 +00:00
0014-bill-derivation-from-real-fuel-rates.md feat(baseline): EnergyBreakdown.from_sap_result + COOLING section 2026-06-02 18:28:22 +00:00
0015-mappers-own-cert-normalization.md docs(baseline): Bill Derivation design — fuel as calculator output + rebaselining is assemble-and-score 2026-06-02 18:04:55 +00:00
0016-package-rescore-over-warm-start-optimisation.md docs(modelling): #1157 Plan-persistence design review 2026-06-03 11:12:54 +00:00
0017-plan-persistence-evolve-live-tables.md docs(modelling): #1157 Plan-persistence design review 2026-06-03 11:12:54 +00:00