--- path: /studio/yemaya/budget-management surface: studio domain: yemaya auth: signed-in + studio entitlement source: apps/oshun/web/src/app/studio/yemaya/budget-management/page.tsx status: walked last_walked: - '2026-07-03 real-dev-infra Playwright addendum — anonymous redirect, Yemaya-admin browser auth, live optimizer catalog and optimize POST through the real BFF, route map, quick actions, local and BFF validation, fail-closed loading/auth/error branches, pending-submit lockout, mobile containment, 44 px controls, and direct BFF auth/schema gates. Evidence: WALKTHROUGH/results/v1-real-infra-run-2026-06-22.md §264' - '2026-05-29 automated runtime walk (Playwright headless) — render, /v1 data (2xx), console/page-errors, expected content, screenshot verified; live screen-reader, touch, offline, and telemetry-delivery checks pending a manual AT pass. Evidence: WALKTHROUGH/results/runtime-sweep-2026-05-29.md; body re-derived 2026-06-03 from current source (lane-console architecture)' --- # Studio · Yemaya · Budget Management ## Purpose Admin lane console that wires the real `@yemaya/budget-management` quality/budget/time ("iron triangle") optimizer: pick an optimization strategy and stakeholder weights and get the deterministic score, the cost / time / quality impacts, and concrete recommendations for a production budget. ## Entry points - Studio index quick-actions. - No breadcrumb panel on this page. - Reachable from `/studio/yemaya/crew-management` (which links here); this page links out to `/studio/yemaya/scheduling`. - Direct URL / bookmark (signed-in + studio entitlement). ## Layout regions `page.tsx` renders `ShellLayout active="studio"` and: - **Workspace panel** (`StudioYemayaBudgetManagementWorkspace`, `data-yemaya-budget-management-workspace`): - `

` "Yemaya Budget Management Workspace". - Summary `

`: "Run the production iron-triangle optimizer — pick a strategy and stakeholder weights to see the cost / time / quality impacts and the concrete recommendations." - **Optimize lane** — loading / unauthorized / error / ready-form / pending submit / result. - **Route Map panel** (`data-yemaya-budget-management-route-map`): `

` "Route Map" with five entries (`data-yemaya-budget-management-route-map-entry`, `data-route-path`). - **Quick-action panel** (`data-yemaya-budget-management-quick-actions`): two `quickAction` links with per-action selectors. ## States - [x] **Loading** — `data-yemaya-bm-loading` ("Loading optimizer…") before the catalog GET resolves. - [x] **Unauthorized** — 401/403 → `data-yemaya-bm-unauthorized` ("Access restricted.") with reason "Yemaya workspace scope required to view budget management.". - [x] **Error** — non-OK / malformed catalog → `data-yemaya-bm-error`. - [x] **Ready-form** — strategy ``. - [x] **Cost weight** — `` (aria-label "cost weight"). - [x] **Time weight** — `` (aria-label "time weight"). - [x] **Quality weight** — `` (aria-label "quality weight"). - [x] **"Run optimizer"** submit (`data-yemaya-bm-optimize-submit`) — POSTs `{ strategy, weights: { cost, time, quality } }`. ### Route map `data-yemaya-budget-management-route-map` — five entries: - [x] `/studio/yemaya/budget-management` - [x] `/studio/yemaya/budget-management/scenes/[sceneId]` - [x] `/studio/yemaya/budget-management/exports/[exportId]` - [x] `/studio/yemaya/budget-management/revisions/[revisionId]` - [x] `/studio/yemaya/budget-management/governance/[policyId]` ### Quick actions - [x] **"Open Yemaya Scheduling workspace"** → `/studio/yemaya/scheduling`. - [x] **"Back to Studio workspace index"** → `/studio`. ## Data & contracts - **Reads**: `GET /v1/admin/yemaya/budget-management` (catalog; `strategies`) on mount with `buildBffAuthHeaders()`, `cache: 'no-store'`. - **Writes**: `POST /v1/admin/yemaya/budget-management/optimize` → `{ optimization: { result: { strategy, score, costSavings, timeImpact, qualityImpact, recommendations }, normalizedWeights, constraints } }`. - **Realtime**: None. - **Caching**: client `fetch` on mount, no-store; aborted on unmount. - **Auth/role check**: admin-scoped, fail-closed; route additionally signed-in + studio via the proxy gate. ## Automated coverage - `apps/oshun/web/e2e/studio-yemaya-budget-godot.spec.ts` opens the page in the real Next shell, forwards browser `/v1/admin/yemaya/budget-management` GET and `/optimize` POST requests to the live local BFF with the page's bearer token, and asserts the exact balanced optimizer score (`0.85`), impacts, normalized weights, recommendations, auth headers, and submitted body. - The same spec covers anonymous redirect, non-admin 403 rendering, controlled loading/503 catalog failure, local zero-sum weight validation with zero POSTs, BFF write-error surfacing, pending-submit lockout, route-map entries, quick-action hrefs, mobile no-overflow, 44 px controls, and direct BFF 401/403/400/200 contract gates. ## Cross-references - Workspace source: `apps/oshun/web/src/components/studio/StudioYemayaBudgetManagementWorkspace.tsx` - Route map source: `apps/oshun/web/src/components/studio/StudioYemayaBudgetManagementRouteMap.ts` - Page source: `apps/oshun/web/src/app/studio/yemaya/budget-management/page.tsx` - Sibling: [`studio-yemaya-crew-management.md`](./studio-yemaya-crew-management.md) - Studio overview: [`studio-overview.md`](../../studio-overview.md) - Feature spec: [`V1/features.md`](../../../../V1/features.md) ## Open questions / known gaps - [ ] The route-map children (`scenes`/`exports`/`revisions`/`governance`) are a sitemap contract; verify which dynamic pages exist. - [ ] The optimizer is stateless (no persisted budget ledger); confirm whether a saved-scenario store is planned.