AUCTION DETAIL CONTROLLER BOUNDARY

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

Auction Detail Controller Boundary

Purpose

This note documents the Sprint 05 boundary cleanup for the auction detail flow in apps/web.

The goal of this layer is not to make bidder mutations look durable. The goal is to make the current truth model explicit in code:

canonicalRead remains the visible source for auction detail/list reads
bidder mutations remain UI-FIRST and compatibility-backed
session overlays remain explicit
the future durable mutation seam remains visible and intentionally separate

VERIFIED module structure

Top-level entry:

apps/web/src/portal/components/AuctionDetailClient.tsx

Controller / view-model layer:

Loading workspace

Loading module

Loading workspace

AUCTION DETAIL CONTROLLER BOUNDARY

Auction Detail Controller Boundary

Purpose

VERIFIED module structure

Responsibility ownership

`AuctionDetailClient.tsx`

`useAuctionDetailController.tsx`

`useAuctionSessionOverlays.ts`

`useAuctionBidderIdentity.ts`

`compatibilityActionAdapter.ts`

What moved out of `AuctionDetailClient`

What still remains intentionally centralized

Truth model after Sprint 05

Canonical read

Compatibility mutation

Session overlays

Future durable mutation seam

What future durable mutation work should attach to

Loading workspace

Loading module

Loading workspace

Auction Detail Controller Boundary

Purpose

VERIFIED module structure

Responsibility ownership

AuctionDetailClient.tsx

useAuctionDetailController.tsx

useAuctionSessionOverlays.ts

useAuctionBidderIdentity.ts

compatibilityActionAdapter.ts

What moved out of AuctionDetailClient

What still remains intentionally centralized

Truth model after Sprint 05

Canonical read

Compatibility mutation

Session overlays

Future durable mutation seam

What future durable mutation work should attach to

`AuctionDetailClient.tsx`

`useAuctionDetailController.tsx`

`useAuctionSessionOverlays.ts`

`useAuctionBidderIdentity.ts`

`compatibilityActionAdapter.ts`

What moved out of `AuctionDetailClient`