| name | routes-admin |
| description | Work on Madoc TS admin route handlers, request/response patterns, and admin HTTP endpoints. Use when adding or modifying admin routes in services/madoc-ts. |
Admin Routes (Madoc TS)
Goal
Document admin route conventions so management endpoints follow existing auth and handler patterns.
Scope
- Admin HTTP route modules
- Admin route handler patterns and middleware
- Admin request/response expectations
Non-scope
- Site or global routes
- Frontend React route definitions
- Auth server internals
Key Entry Points
services/madoc-ts/src/routes/admin/
services/madoc-ts/src/routes/root.ts
services/madoc-ts/src/routes/global/
Quick Start Workflow
- Review
services/madoc-ts/src/routes/admin/ for existing handler patterns.
- Confirm shared middleware in
services/madoc-ts/src/routes/root.ts or services/madoc-ts/src/routes/global/.
- Add or update the admin route module following existing conventions.
Common Tasks
- Add a new admin endpoint
- Update admin handler responses
- Add route-level middleware for admin routes
Pitfalls
- Missing authorization checks for admin-only operations
- Inconsistent response shapes across admin endpoints
- Misplacing admin routes under site routes
Suggested Checks
- Admin route request smoke test
- Admin route auth test