headquarter/openspec/changes/archive/2026-05-17-database-models/proposal.md

Proposal: Database Models

What

Implement SQLAlchemy 2.0 async models and Alembic migrations for all core entities in the Headquarter platform.

Why

All other features (auth, git repos, projects, SSH keys, etc.) depend on a solid database foundation. We need models that:

• Use SQLAlchemy 2.0 async style for performance
• Support all entity relationships defined in the specs
• Have proper migrations for schema versioning
• Include seed data for development

Scope

• User, Project, GitRepository, SSHKey, UserConfig models
• Alembic setup with asyncpg support
• Initial migration creating all tables
• Database seeding script

Success Criteria

• All models defined with correct relationships
• Initial migration runs successfully
• make migrate works
• Seed script creates test data
• Quality gates pass (pytest, mypy, ruff)