Context
PR #90 removed Alembic migrations from the project. The rationale was simplification for the thesis project scope. However, this needs documentation for future maintainers.
Problem Statement
Without migrations:
- Schema changes require manual database recreation
- Production deployments need documented process
- No rollback capability for schema changes
- Future contributors may be confused by lack of migrations
Proposed Solution
Document the chosen approach in api/README.md:
- SQLModel's
create_all() handles schema creation
- For production: use Supabase's built-in migration tools or manual SQL
- Document schema change process for future maintainers
- Note trade-offs of current approach vs migrations
Acceptance Criteria
Technical Notes
- SQLModel creates tables via
SQLModel.metadata.create_all(engine)
- Supabase provides SQL editor for manual migrations
- For thesis scope, this approach is sufficient
Context
PR #90 removed Alembic migrations from the project. The rationale was simplification for the thesis project scope. However, this needs documentation for future maintainers.
Problem Statement
Without migrations:
Proposed Solution
Document the chosen approach in
api/README.md:create_all()handles schema creationAcceptance Criteria
api/README.mdTechnical Notes
SQLModel.metadata.create_all(engine)