Db Migration Consistency

Khi nào dùng

• Thêm migration mới trong db/migration.
• Đổi schema ảnh hưởng entity/repository/query.
• Tối ưu index hoặc ràng buộc dữ liệu.

Mục tiêu

• Migrate an toàn, không phá dữ liệu hiện có.
• Đồng bộ schema, entity và query usage.
• Dễ rollback hoặc giảm rủi ro khi deploy.

Quy trình chuẩn

1. Xác định impact map: bảng, cột, FK, index, query path bị ảnh hưởng.
2. Thiết kế migration theo hướng tương thích tiến (forward-compatible) trước khi cleanup.
3. Đồng bộ code:
   • Entity fields và constraints.
   • Repository query.
   • Service mapping.
4. Rà performance:
   • Index cho cột filter/join/order.
   • Tránh full scan ở query nóng.
5. Kiểm tra dữ liệu cũ có đi qua migration an toàn.
6. Thêm validation test tối thiểu cho luồng chính bị ảnh hưởng.