headquarter/docs/architecture/.pi-map.md

docs/architecture

dir: docs/architecture

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

role

Documents the technical architecture and design decisions for the "Headquarter" full-stack web application across all system 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 details for the Headquarter application | dep: PostgreSQL, SQLAlchemy, Alembic, Authentik, Docker Compose, PgBouncer
• deployment.md | Documents the containerized deployment architecture for a web application called "Headquarter" using Docker, Traefik, and microservices. | dep: Docker, Traefik, React, Vite, nginx, FastAPI, Python 3.11, PostgreSQL 15, Redis 7, Authentik, OAuth2/OIDC, Alembic, PgBouncer
• 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 architecture decision records (ADRs) covering four-tier documentation structure: backend (FastAPI), frontend (React SPA), database (PostgreSQL), and deployment (Docker/Traefik microservices).

tags

documents, backend, architecture, fastapi, application, alembic, authentik, docker

symbols

workflows

dirty