alex
62640daf36
- Update architecture.md with spawn service and auth proxy sections - Update deployment.md with production stack details - Update development.md with spawn workflow documentation - Update mvp-scope.md, project-brief.md, tool-manifest-spec.md - Update conversation-handoff.md with current status - Replace all RunFusion references with OpenCode
1.4 KiB
1.4 KiB
Project Brief: Headquarter
What
Headquarter is a hosted workspace and tool-orchestration platform. Authenticated users create Git-backed projects and launch containerized development tools—starting with OpenCode and code-server—each exposed via its own HTTPS subdomain.
Why
Cloud IDEs and CI dashboards are convenient but lock users into proprietary platforms. Headquarter gives developers the same convenience with full control over their runtime environments, source code, and routing.
Who
- Individual developers who want self-hosted workspaces
- Small teams that outgrow cloud IDEs but do not want to build orchestration from scratch
- Operators who prefer Docker Compose and Traefik over Kubernetes for simple deployments
Confirmed Stack
- Frontend: React + Vite + TypeScript
- Backend: FastAPI + SQLAlchemy 2.0 + Pydantic v2
- Database: PostgreSQL 17
- Auth: Authentik OIDC
- Runtime: Docker Compose (Portainer-managed)
- Routing: Traefik subdomain-based
Canonical Documentation
- Architecture — System design, domain model, and provider contracts
- MVP Scope — In-scope features, non-goals, milestones, and dependency order
- Development — Local setup and day-to-day commands
- Deployment — Production deployment assumptions and operator guide