H1Document
Status: canonical hub for the in-app document feature set.
H2Focus Strip
| Now | Lock | Do Not Break | Next Closure |
|---|---|---|---|
| Document engine specs | projection, not truth | Folio engine and commercial totals | wait for canonical order snapshot, then wire projections |
| State | Meaning |
|---|---|
| built/locked | ProjectDocument/DocumentPage, Folio actions |
| built/partial | document-order bridge, trip pricing action |
| docs-ahead | true document-to-offer commit action |
This folder covers the document instrument, document-to-offer behavior, document-to-trip orchestration, and section contracts used by the app.
H2Canonical files
H2Related hubs
H2Archive notes
- historical document-planning notes live in
archive/ - older roadmap and import-spec drafts are archived there instead of being deleted
H2Folder rule
- Keep app-facing document truth here.
- Keep older variants in
archive/if they become superseded.
H2Canonical boundary
The document is a working instrument and projection surface. It is not the business truth for Trip, Offer, Order, or payment state.
H2Code Audit - 2026-04-26
H3Built / locked
- The active document engine uses
ProjectDocumentplusDocumentPage. - Folio actions provide page-surface writes, page insertion, pagination commit, and aggregate reads.
- Document actions include creation, listing, assistant application, trip pricing computation, and order/document bridge experiments.
H3Built / partial
documentToOrder()bridges a document-bound offer to an order, but it should be treated as partial until it preserves committed line-item economics exactly.computeTripPricingAction()safely delegates to the Trips engine and keeps pricing authority outside the document UI.
H3Docs-ahead / pending
commitDocumentToOffer.tsis currently a pagination commit file by content. The commercial document-to-offer action is still pending or misnamed.- Document line-item blocks can recompute totals for display/edit fallbacks; commercial documents need canonical totals passed in.
H3Critical next step
Wait for the canonical Offer -> Order snapshot action, then update document projection tools to call/read that path instead of recomputing commercial totals.