# 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 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
## arch
Lightweight ADR (Architecture Decision Record) pattern using numbered, markdown-formatted documents with consistent structure covering context, decision, consequences, and status.
## tags
adr, async, session, sqlalchemy, decision, hmac, oauth2, 001
## symbols
-
## workflows
-
## dirty
-
