ai_synth

Commit Graph

Author	SHA1	Message	Date
oabrivard	6f3ff1e9a2	docs: add JSDoc to all frontend API modules, pages, components, utilities Add English JSDoc documentation to 32 source files across the frontend: - API layer (8 files): client CSRF strategy, credential handling, 401 redirect, and endpoint-level docs for auth, settings, sources, syntheses, admin, config, apiKeys - Pages (11 files): Settings export/import, GenerateSynthesis SSE state machine, Home delete confirmation timer, Sources bulk import parsing, SynthesisDetail email/export flows, Login/Register Turnstile lifecycle, AuthVerify token flow, admin Providers/RateLimits/Users - Components (8 files): ApiKeyManager CRUD, Turnstile polling init, Navbar/MobileMenu route detection, Layout/AdminLayout structure, ErrorBoundary retry, Button variants, Toast auto-dismiss timer, LoadingSpinner props - Utilities (2 files): SSE reconnection backoff, dates locale config - Context (1 file): AuthContext session check, isAdmin derived signal No logic changes. TypeScript and vitest pass unchanged. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	3 months ago
oabrivard	5abbf9b9ad	Phase 3: Admin module with provider/model curation, rate limits, user management Backend: - Admin API: CRUD for providers, rate limits, user role management - Public config endpoint for enabled providers/models - AdminUser extractor enforces RBAC on all admin endpoints - Per-provider rate limiter with hot-reload from DB - Audit logging for all admin mutations - Seed data: Gemini, OpenAI, Anthropic providers with default models - Self-demotion prevention on role changes - 30 integration tests, 27 new unit tests Frontend: - Admin layout with sidebar navigation (providers, rate limits, users) - Provider management: enable/disable, model CRUD, default model selection - Rate limit configuration with effective rate display - User management with role badges and promote/demote - Admin link in navbar/mobile menu (visible only to admins) - Settings page: dynamic provider/model selection from admin config - 10 new tests (admin guard, config API) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	3 months ago
oabrivard	355dbf6a5a	Finished phase 1	3 months ago

Author

SHA1

Message

Date

oabrivard

6f3ff1e9a2

docs: add JSDoc to all frontend API modules, pages, components, utilities

Add English JSDoc documentation to 32 source files across the frontend:
- API layer (8 files): client CSRF strategy, credential handling, 401 redirect,
  and endpoint-level docs for auth, settings, sources, syntheses, admin, config, apiKeys
- Pages (11 files): Settings export/import, GenerateSynthesis SSE state machine,
  Home delete confirmation timer, Sources bulk import parsing, SynthesisDetail
  email/export flows, Login/Register Turnstile lifecycle, AuthVerify token flow,
  admin Providers/RateLimits/Users
- Components (8 files): ApiKeyManager CRUD, Turnstile polling init, Navbar/MobileMenu
  route detection, Layout/AdminLayout structure, ErrorBoundary retry, Button variants,
  Toast auto-dismiss timer, LoadingSpinner props
- Utilities (2 files): SSE reconnection backoff, dates locale config
- Context (1 file): AuthContext session check, isAdmin derived signal

No logic changes. TypeScript and vitest pass unchanged.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

oabrivard

5abbf9b9ad

Phase 3: Admin module with provider/model curation, rate limits, user management

Backend:
- Admin API: CRUD for providers, rate limits, user role management
- Public config endpoint for enabled providers/models
- AdminUser extractor enforces RBAC on all admin endpoints
- Per-provider rate limiter with hot-reload from DB
- Audit logging for all admin mutations
- Seed data: Gemini, OpenAI, Anthropic providers with default models
- Self-demotion prevention on role changes
- 30 integration tests, 27 new unit tests

Frontend:
- Admin layout with sidebar navigation (providers, rate limits, users)
- Provider management: enable/disable, model CRUD, default model selection
- Rate limit configuration with effective rate display
- User management with role badges and promote/demote
- Admin link in navbar/mobile menu (visible only to admins)
- Settings page: dynamic provider/model selection from admin config
- 10 new tests (admin guard, config API)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

oabrivard

355dbf6a5a

Finished phase 1

3 Commits (eba721266f2bf424d768e4549f68ff20436991c3)