headquarter/openspec/changes/archive/2026-05-14-frontend-foundation/proposal.md at 8d91a1d1e0f1f078000e51f4fc85aa25fb756fd3

alex/headquarter

Fork 0

Files

T

alex 78aaddb2b5

CI / Web CI (push) Failing after 12s

Details

CI / API CI (push) Failing after 1m1s

Details

docs(openspec): add OpenSpec changes for FN-005, FN-006, FN-008, FN-009, FN-010

- Add frontend-foundation change (FN-005) with 46 tasks
- Add deployment-config change (FN-006) with 27 tasks
- Add runfusion-poc/opencode-poc change (FN-008) with 25 tasks
- Add config-secrets change (FN-009) with 31 tasks
- Add codeserver-spawn change (FN-010) with 38 tasks
- Include project specsheet and configuration
- Archive completed deployment-config change

2026-05-14 17:35:20 +02:00

1.7 KiB

Raw Blame History

Why

The backend API is fully scaffolded with domain models, routers, and authentication dependencies, but the frontend remains a static scaffold page (FN-002). Users cannot sign in, view projects, or interact with any backend functionality. This change delivers the foundational frontend architecture needed to unlock all user-facing MVP features.

What Changes

Authentik OIDC integration: Auth provider with login/logout flow, token management, and automatic user provisioning
Dashboard shell: Responsive layout with header, navigation sidebar, and main content area
Navigation routes: Dashboard, Projects, Repositories, Tools, Settings pages with React Router
Typed API client: Generated or hand-written client for all /api/v1/* endpoints
Project list UI: Display user's projects with create/edit capabilities
Environment config layer: Vite env var integration for API URL, auth endpoints
Auth-guarded routes: Redirect unauthenticated users to login

Capabilities

New Capabilities

auth-oidc: Authentik OIDC authentication flow, token storage, session management
dashboard-shell: Responsive layout with navigation, header, and content area
project-management-ui: Project list, create, edit, delete views
api-client: Typed HTTP client for backend API consumption
route-guards: Authentication-based route protection and redirects

Modified Capabilities

None (this is purely additive to the existing scaffold)

Impact

apps/web/src/: All new frontend code
apps/web/package.json: New dependencies (react-router-dom, @tanstack/react-query, etc.)
apps/api/app/auth/dependencies.py: CORS and auth flow alignment
docs/development.md: Updated frontend development instructions

1.7 KiB Raw Blame History

Why