Converts the entity model into the user experience map: how estimators move through the system, which views exist, how they navigate between them, and how entities change state along the way.
Related docs: foundation/ · entities/ · other/
Reading order
Top-down:
- Estimator journey — end-to-end narrative from Tender creation through submission. The spine of the product experience.
- View inventory — every distinct view in v1 with purpose, primary user, key content, and key interactions.
- Navigation map — primary nav structure, view-to-view transitions, breadcrumbs.
- Lifecycle states — consolidated state machines for every entity that has one. Resolves the provisional state lists called out in the concept map.
Sub-flows for the highest-complexity interactions (reference material, read in order or as needed):
- Worksheet build-up — drag Resources, add Variables and Calculation Blocks, manage Content Blocks, handle snapshot divergence.
- Rate-edit mechanics — the three rate-edit actions (per-instance / apply-to-Estimate / fork) and the cascade they trigger.
- Price Book Adjudication — six-step workflow for rate adjudication over Resources.
- Subcontract Package Adjudication — six-step workflow for package-level adjudication over Item bundles.
- Commercials — sequenced Rule application, scope targeting, Submission Value overrides, Publisher output.
- Anomaly Review — three-layer check pipeline (rules, Reference Rates, historical AI).
Scope
v1 (Alpha + Release per proposal milestones).