# apps/api/alembic
dir: apps/api/alembic

index: apps/api/alembic/.pi-map.index.md

## role
Database migration tooling that manages schema versioning and changes for the API's PostgreSQL database using Alembic with async SQLAlchemy.
## files
- env.py | Configures Alembic database migration environment with async SQLAlchemy support for a project. | dep: alembic, sqlalchemy, sqlalchemy.ext.asyncio, logging.config, asyncio, src.config, src.models
- script.py.mako | Alembic database migration script template that generates upgrade/downgrade functions for SQLAlchemy schema migrations | dep: alembic, sqlalchemy
## arch
Template-driven migration pattern using Alembic's declarative configuration with async engine setup, environment context management, and auto-generated revision scripts with upgrade/downgrade function pairs.
## tags
sqlalchemy, alembic, database, migration, asyncio, config, src, env
## symbols
-
## workflows
- change alembic behavior
  read: env.py, script.py.mako
- explore alembic subdirectories
  index: apps/api/alembic/versions/.pi-map.index.md
## dirty
-