# 2026-05-17-database-models
dir: 2026-05-17-database-models

index: 2026-05-17-database-models/.pi-map.index.md

## role
Database persistence layer providing SQLAlchemy 2.0 async ORM models and Alembic migration infrastructure for PostgreSQL data management in the Headquarter platform API.
## files
- .openspec.yaml | Defines an OpenAPI specification file metadata with schema type and creation date
- README.md | Defines a project for implementing SQLAlchemy database models and Alembic migrations for core entities. | dep: SQLAlchemy, Alembic
- design.md | Defines the database schema design, technology choices, and project structure for an async SQLAlchemy-based PostgreSQL ORM in an API application. | dep: SQLAlchemy 2.0, asyncpg, Alembic, pydantic-settings, PostgreSQL
- proposal.md | Proposes implementing SQLAlchemy 2.0 async database models and Alembic migrations for core entities in the Headquarter platform | dep: SQLAlchemy 2.0, Alembic, asyncpg, pytest, mypy, ruff
- tasks.md | Tracks completed implementation tasks for building a SQLAlchemy-based async database layer with models, migrations, seeding, and testing for an API application. | dep: SQLAlchemy, Alembic, Pydantic-settings, PostgreSQL, pytest, mypy, ruff
## arch
Async SQLAlchemy 2.0 declarative ORM with Alembic migration tooling, following repository pattern for data access, with model-driven schema design and automated migration generation for PostgreSQL backend.
## tags
sqlalchemy, alembic, database, defines, models, migrations, design, async
## symbols
-
## workflows
-
## dirty
-