chore: track all project map and index files

Add generated .pi-map.md and .pi-map.index.md files across the repository
so the project navigation maps are shared and versioned. These artifacts
are maintained by project_map_init/patch/validate and must be kept in
sync with source edits.

Note: .cache/ remains ignored (added in previous commit).

docs/deployment/.pi-map.index.md

@@ -0,0 +1,22 @@
+# docs/deployment (index)
+dir: docs/deployment
+
+## role
+Provides deployment documentation and operational guides for installing, configuring, and running the Headquarter application in production environments.
+## parent
+index: docs/.pi-map.index.md
+map: docs/.pi-map.md
+## children
+-
+## files
+- authentik.md
+- docker.md
+- environment.md
+- traefik.md
+## links
+index: docs/deployment/.pi-map.index.md
+map: docs/deployment/.pi-map.md
+## workflows
+-
+## dirty
+-

docs/deployment/.pi-map.md

@@ -0,0 +1,22 @@
+# docs/deployment
+dir: docs/deployment
+
+index: docs/deployment/.pi-map.index.md
+
+## role
+Provides deployment documentation and operational guides for installing, configuring, and running the Headquarter application in production environments.
+## files
+- authentik.md | Documents how to configure Authentik as an OAuth2 provider for the Headquarter application | dep: Authentik, Headquarter, OAuth2, Python
+- docker.md | Provides deployment instructions for a multi-container "Headquarter" application using Docker Compose in development and production environments | dep: Docker, Docker Compose, FastAPI, React, Vite, PostgreSQL, Redis, Traefik, Alembic, Authentik, Let's Encrypt
+- environment.md | Documents all environment variables used by the Headquarter application, including their defaults, construction rules, and security requirements.
+- traefik.md | Documents how to configure and deploy Traefik as a reverse proxy with automatic HTTPS for a "Headquarter" application using Docker Compose and Docker labels. | dep: Traefik, Docker, Docker Compose, Let's Encrypt, DNS
+## arch
+Documentation-as-code approach using Markdown files organized by infrastructure component (reverse proxy, identity provider, container orchestration, configuration management), following a modular microservices deployment pattern with Docker Compose.
+## tags
+docker, authentik, headquarter, traefik, application, documents, environment, configure
+## symbols
+-
+## workflows
+-
+## dirty
+-