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

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

## role
Archive directory containing design documents and proposals for implementing SQLAlchemy 2.0 async database models and Alembic migrations for a PostgreSQL-backed API application.
## 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
Document-driven design with OpenAPI specification metadata, structured planning artifacts (proposal/design/tasks), and async SQLAlchemy 2.0 ORM pattern targeting PostgreSQL with Alembic migration management.
## tags
sqlalchemy, alembic, database, defines, models, migrations, design, async
## symbols
-
## workflows
-
## dirty
-
