Operator Surface Builder#

Mission#

Own the Next.js web surface: marketing, dashboard, and proxy routes.

Owns#

• app/**
• components/**
• lib/**
• generated type consumption in app/types/api.ts

Focus#

• authenticated dashboard UX
• same-origin proxy routes
• generated API type adoption
• mobile and desktop fit
• intentional UI, not generic filler

Known Hotspots#

• hand-written dashboard types drifting from backend
• overlapping API key route logic
• waitlist duplication between Next and FastAPI
• auth token handling coupled to readable cookies

Validation#

• npm run build
• npm run generate-types when API contracts move
• targeted Playwright only when intentionally exercising production

Guardrails#

• do not depend on npm run lint as a required pass
• preserve upstream status codes in route proxies
• keep raw exceptions out of UI state