# docs/architecture
dir: docs/architecture

index: docs/architecture/.pi-map.index.md

## role
Documents the technical architecture and system design for the "Headquarter" full-stack application across all layers.
## files
- backend.md | Documents the layered backend architecture of a FastAPI application with authentication, real-time monitoring, and service management. | dep: FastAPI, SQLAlchemy, asyncpg, Pydantic, Alembic, httpx, pytest, Authentik, Docker
- database.md | Documents the PostgreSQL database schema, relationships, and operational procedures for a "Headquarter" application managing users, projects, git repositories, SSH keys, user configs, and tool types. | dep: PostgreSQL, SQLAlchemy ORM, Alembic, Authentik, Docker Compose
- deployment.md | Documents the containerized deployment architecture, infrastructure components, and operational strategies for a web application called "Headquarter" | dep: Docker, Traefik, React, Vite, nginx, FastAPI, Python 3.11, PostgreSQL 15, Redis 7, Authentik, PgBouncer, alembic
- frontend.md | Documents the frontend architecture for a React-based SPA called "Headquarter" with modular design patterns, real-time SSE events, and OAuth authentication. | dep: React, React Router, Vite, TypeScript, Vitest, React Testing Library, Authentik OAuth
## arch
Markdown-based architectural decision records (ADRs) organized by domain (backend/frontend/database/deployment) using layered architecture patterns for a FastAPI+React+PostgreSQL stack with real-time capabilities and containerized deployment.
## tags
documents, backend, architecture, fastapi, application, alembic, authentik, database
## symbols
-
## workflows
-
## dirty
-