Example SaaS · Iteration Review

Order Catalog Taxonomy

Completed May 25, 2026 · 2 milestones · PR #50, PR #51

We taught the system every way a customer can order an item — by quantity, by weight, by configurable options and more — so the upcoming online ordering experience is built on a foundation that matches how the store really works.

Watch the 45-second recap

What’s new

Seven ways customers order — now understood by the system

Not every product is a single barcode on a shelf. People order by quantity, by weight, by a configurable option, or “about this much.” The system now recognizes each of these, so when online ordering arrives it can offer the right options for every product.

1Standard pack
2Counted per-unit
3Custom option
4Target-quantity range
5Fixed-each prepared
6Measured-prepared container
7Made-to-order item

For the technically curious

Technical appendix technical detail · optional

Introduced a counter-product taxonomy in the data layer: every product is now classified by pricing unit (per-unit vs each) and one of seven fulfillment shapes, with per-shape invariants enforced and formatter helpers consuming the classification. No customer- or staff-facing output changed — this is foundational schema work.

Notable changes

  • pricingUnit + fulfillmentShape discriminator types (7-shape enum)
  • VALID_FULFILLMENT_MATRIX constant + validateFulfillment() helper
  • Slug-keyed per-product classification across every existing product row
  • Propagated the classification through cart and order-line shapes
  • Updated the seeded demo-1001 snapshot to carry the new fields

Quality & review

411 tests passing (392 + 19 new) tsc --strict: 0 errors Claude review: clean Codex review: clean (1 P2 fixed) Scope narrowed 3× to stay reviewable

Pull requests

PR #50Planning supersession — scoped goal artifact + planning index
PR #51Schema & classification — discriminators, matrix, helper, propagation

What’s next

Building on the foundation

Foundation first: with the data model settled, each next step changes a smaller part of the system and stays easy to review and trust.

Foundation laid.

The system now describes every way customers order at the counter — the online ordering experience is next.