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
32 lines
1.4 KiB
Markdown
32 lines
1.4 KiB
Markdown
# 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](architecture.md) — System design, domain model, and provider contracts
|
|
- [MVP Scope](mvp-scope.md) — In-scope features, non-goals, milestones, and dependency order
|
|
- [Development](development.md) — Local setup and day-to-day commands
|
|
- [Deployment](deployment.md) — Production deployment assumptions and operator guide
|