Historical Build Phases¶

These pages record how PackyTrace reached its current architecture. They are historical summaries, not normative design or current file inventories. When a phase conflicts with an accepted ADR, the ADR log, Domain, and current Architecture take precedence.

The summaries use past tense and identify the decisions that later superseded an implementation. They intentionally omit task-by-task file lists, raw reset commands, and explanatory metaphors that duplicated the current reference.

Sequence¶

1. Walking Skeleton: first database-to-browser scan path.
2. Anonymous Scan: GS1 resolution, visitor identity, and unknown products.
3. Frontend Rework: scan-first consumer navigation and adapter boundaries.
4. Identity Foundation: Keycloak, accounts, sessions, consent, and the original authentication compromise.
5. Product Passport Polish: source adapters, degradation, localization, and recipes.
6. Shopping List and Scan History: the eighth service and device-local recent history.

For a plain-language description of the current system, use the Bird's-eye overview.