alex/headquarter
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(project-map): regenerate .pi-map artifacts across the repo

Browse Source
This commit is contained in:
Developer
2026-06-17 11:31:24 +00:00
parent 0dd5f2317b
commit 93da9b42a2
683 changed files with 5075 additions and 4965 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/architecture/.pi-map.index.md
+1 -1
View File
@@ -2,7 +2,7 @@
dir: docs/architecture
## role
Provides technical documentation for the "Headquarter" application's system architecture across all layers.
Documents the technical architecture and design decisions for the "Headquarter" full-stack web application across all system layers.
## parent
index: docs/.pi-map.index.md
map: docs/.pi-map.md
docs/architecture/.pi-map.md
+5 -5
View File
@@ -4,16 +4,16 @@ dir: docs/architecture
index: docs/architecture/.pi-map.index.md
## role
Provides technical documentation for the "Headquarter" application's system architecture across all layers.
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 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
- 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
Documentation-as-code approach with markdown files organized by architectural concern (backend, database, deployment, frontend) covering a full-stack FastAPI/React/PostgreSQL system with real-time features and containerized deployment.
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, database
documents, backend, architecture, fastapi, application, alembic, authentik, docker
## symbols
-
## workflows
docs/architecture/decisions/.pi-map.md
+4 -4
View File
@@ -6,12 +6,12 @@ index: docs/architecture/decisions/.pi-map.index.md
## role
Documents key architectural decisions made during the project's development to provide historical context and rationale for technology choices.
## files
- adr-001-session-auth.md | Documents the architectural decision to use session-based authentication with HMAC-signed httpOnly cookies for OAuth2 flow instead of JWT alternatives | dep: Authentik, Traefik, OAuth2, HMAC-SHA256
- adr-002-async-sqlalchemy.md | Architecture decision record documenting the choice to use SQLAlchemy 2.0 with async PostgreSQL via asyncpg for an async-capable Python application | dep: SQLAlchemy 2.0, PostgreSQL, asyncpg, Alembic
- adr-001-session-auth.md | Documents the architectural decision to use session-based authentication with HMAC-signed httpOnly cookies for an OAuth2 application. | dep: Authentik, Traefik, OAuth2, HMAC-SHA256
- adr-002-async-sqlalchemy.md | Architecture Decision Record documenting the choice to use SQLAlchemy 2.0 with async PostgreSQL via asyncpg for an async-capable Python application | dep: SQLAlchemy 2.0, PostgreSQL, asyncpg, Alembic
## arch
Lightweight ADR (Architecture Decision Record) pattern using numbered, markdown-formatted documents with consistent structure covering context, decision, consequences, and status.
Lightweight ADR (Architecture Decision Record) pattern using numbered markdown files with consistent naming convention (adr-NNN-title.md) for traceable, versioned decision documentation.
## tags
adr, async, session, sqlalchemy, decision, hmac, oauth2, 001
adr, async, session, sqlalchemy, decision, hmac, oauth2, application
## symbols
-
## workflows