# 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 RunFusion 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