stack/v1/packages/forge/examples/sample-brief.md

class

class
technical

Brief: Add User Preferences API Endpoint

Source PRD

mosaic-stack PRD — Mission Control Dashboard

Scope

Add a REST endpoint for storing and retrieving user dashboard preferences (layout, theme, sidebar state). This enables the Mission Control dashboard to persist user customization.

Success Criteria

1. GET /api/users/:id/preferences returns stored preferences (JSON)
2. PUT /api/users/:id/preferences stores/updates preferences
3. Preferences persist across sessions
4. Default preferences returned for users with no stored preferences
5. Only the authenticated user can read/write their own preferences

Estimated Complexity

Medium — new endpoint, new DB table, auth integration

Dependencies

• Requires existing auth system (JWT guards)
• Requires existing user entity in database