chihlasm/resolutionflow
1
0
Fork 0
Code Issues 23 Pull Requests 1 Actions Packages Projects Releases Wiki Activity

docs: database migration strategy guide #44

Merged
chihlasm merged 1 commits from docs/migration-strategy into main 2026-02-08 22:49:49 +00:00
Conversation 1 Commits 1 Files Changed 1 +163
chihlasm commented 2026-02-08 22:48:49 +00:00 (Migrated from github.com)
Copy Link

Summary

  • Add docs/DATABASE-MIGRATIONS.md covering migration conventions, known issues, and full history

Contents

  • Naming conventions (sequential 001-027 vs hash-based)
  • Revision chain navigation (alembic heads, alembic history)
  • Creating new migrations (auto-detect, manual, offline)
  • Known issues: circular FK workaround, NULL UUID casting, conditional update gotcha
  • Full migration history table (31 migrations)
  • Squash policy (deferred)

Test plan

  • Documentation only — no code changes

🤖 Generated with Claude Code

## Summary - Add `docs/DATABASE-MIGRATIONS.md` covering migration conventions, known issues, and full history ## Contents - Naming conventions (sequential 001-027 vs hash-based) - Revision chain navigation (`alembic heads`, `alembic history`) - Creating new migrations (auto-detect, manual, offline) - Known issues: circular FK workaround, NULL UUID casting, conditional update gotcha - Full migration history table (31 migrations) - Squash policy (deferred) ## Test plan - [x] Documentation only — no code changes 🤖 Generated with [Claude Code](https://claude.com/claude-code)
railway-app[bot] commented 2026-02-08 22:49:02 +00:00 (Migrated from github.com)
Copy Link

🚅 Deployed to the patherly-pr-44 environment in selfless-grace

Service Status Web Updated (UTC)
patherly 🕒 Building (View Logs) Feb 8, 2026 at 10:49 pm
hopeful-liberation 🕒 Building (View Logs) Feb 8, 2026 at 10:49 pm
<!-- railway-bot-comment-version=2 --> <!-- railway-project-id="22b9b58c-271b-42e5-a10e-6fdec8d00134" railway-project-name="selfless-grace" --> 🚅 Deployed to the [patherly-pr-44](https://railway.com/project/22b9b58c-271b-42e5-a10e-6fdec8d00134?environmentId=514ac270-e2b1-4489-88c0-8aa3a39750fa) environment in **[selfless-grace](https://railway.com/project/22b9b58c-271b-42e5-a10e-6fdec8d00134)** | **Service** | **Status** | **Web** | **Updated** (UTC) | | :--- | :--- | :--- | :--- | | patherly | 🕒 Building ([View Logs](https://railway.com/project/22b9b58c-271b-42e5-a10e-6fdec8d00134/service/95f556ff-5264-4116-a0c2-618a2fc53ba4?id=4ab2b581-34f1-4260-8146-eb4f5e59b601&environmentId=514ac270-e2b1-4489-88c0-8aa3a39750fa)) | | Feb 8, 2026 at 10:49 pm | | hopeful-liberation | 🕒 Building ([View Logs](https://railway.com/project/22b9b58c-271b-42e5-a10e-6fdec8d00134/service/e1db2ee3-d241-4f45-abe4-c9c5fdf483d5?id=461dcd7f-30f4-4dd2-bc0d-f9589ee31146&environmentId=514ac270-e2b1-4489-88c0-8aa3a39750fa)) | | Feb 8, 2026 at 10:49 pm |
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
Clear labels
10x-analysis
From 10x product analysis
 backend
FastAPI/Python work
 bug
Something isn't working
 collaboration
Team sharing, escalation, notifications
 database
PostgreSQL/schema changes
 documentation
Documentation updates
 duplicate
This issue or pull request already exists
 enhancement
Improvement to existing feature
 feature
New functionality
 frontend
React work
 good first issue
Good for newcomers
 help wanted
Extra attention is needed
 integration
PSA, external service integrations
 intelligence
Analytics, AI, data-driven features
 invalid
This doesn't seem right
 priority: high
Do this soon
 priority: low
Nice to have
 priority: medium
Important but not urgent
 question
Further information is requested
 quick-win
Low effort, high value
 strategic
Long-term strategic bet
 ux
User experience improvements
 wontfix
This will not be worked on
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
chihlasm
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: chihlasm/resolutionflow#44
Delete Branch "docs/migration-strategy"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?