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

docs/architecture/decisions

dir: docs/architecture/decisions

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 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 files with consistent naming convention (adr-NNN-title.md) for traceable, versioned decision documentation.

tags

adr, async, session, sqlalchemy, decision, hmac, oauth2, application

symbols

workflows

dirty