Resolving locale, route permissions, and workspace projection.
Current scope: Gest
Category: 10_normative | Version: v1.0.0
Owner: DOCUMENT_CUSTODIAN | Review cycle: 90 days
Approval Authority: GOVERNANCE_ADMIN
Read-only Documentation Portal. Editing and mutation endpoints are disabled.
METADATA INCOMPLETE: Document ID, Version, Status, Owner Role, Last Review Date, Next Review Date, Change Log
This document is the Sprint 03 frontend boundary map for auction actions.
It is intentionally code-first and blunt.
Labels used here:
VERIFIEDINFERREDUNVERIFIEDREALMIXEDUI-FIRSTSHELLMISSINGThe auction web surface is now split into four explicit layers:
canonicalRead
compatibility
session
futureDurable
| Layer | Status | Evidence | Purpose |
| --- | --- | --- | --- |
| canonicalRead | VERIFIED MIXED | apps/web/src/ui/auctions/canonicalRead/portalReadBoundary.ts | Canonical web read-consumption seam for auction list/detail pages. Still receives mixed truth because portal/api.ts can degrade to compatibility or mock data. |
| compatibility | VERIFIED UI-FIRST | apps/web/src/ui/auctions/compatibility/sessionAuctionMutationPort.ts | Explicit mutation implementation for the public portal today. This is not durable backend behavior. |
| session | VERIFIED UI-FIRST | apps/web/src/ui/auctions/session/bidOverlay.ts, apps/web/src/ui/auctions/session/fulfillmentOverlay.ts, apps/web/src/ui/auctions/session/transportSelectionOverlay.ts | Browser sessionStorage scaffolding for bid, Buy Now, fulfillment, and transport pre-commit state. |
| futureDurable | VERIFIED MISSING | apps/web/src/ui/auctions/futureDurable/auctionMutationPort.ts | Stable future mutation seam. Real durable public bidder writes are not implemented yet. |
VERIFIED MIXED
Auction pages now consume reads through:
Current consumers:
Important limit:
VERIFIED UI-FIRST
Public bidder mutations now route through:
Current mutation operations:
submitBid()buyNow()selectTransportPreCommit()advanceFulfillment()Current main consumer:
This is intentionally explicit:
VERIFIED UI-FIRST
Actual session-backed overlay state lives under:
Consumers:
Legacy wrapper files remain for import stability:
Those wrappers are no longer the implementation home.
VERIFIED MISSING
The future seam is:
It defines:
AuctionMutationPort interfacefutureDurableAuctionMutationPortDurableAuctionMutationNotImplementedErrorThis is where a real public durable mutation path should be attached later.
VERIFIED REALsvc-tendersVERIFIED MIXEDportal/api.ts still has compatibility and mock fallback behaviorVERIFIED UI-FIRSTThose are now structurally explicit as compatibility + session behavior.
canonicalRead/portalReadBoundary.tsportal/api.tscompatibility/ or session/AuctionMutationPortcanonicalRead is now structurally separated from public mutationssession/That does not make the public auction action surface durable. It makes the current non-durable reality much harder to misunderstand.