OTA_GUIDE.md

🚀 OTA Deployment Guide

Quy trình kiểm tra trước khi OTA

1. Kiểm tra TypeScript

bun run type-check

Kiểm tra lỗi TypeScript trong toàn bộ project.

2. Chạy tất cả validation

bun run validate

Chạy tất cả các kiểm tra (hiện tại chỉ có type-check, có thể mở rộng thêm lint, test, v.v.)

3. Kiểm tra trước OTA

bun run pre-ota

Chạy tất cả validation và hiển thị thông báo sẵn sàng cho OTA.

---

OTA Commands (Đã tích hợp validation)

Các lệnh OTA sau tự động chạy validation trước khi deploy:

Development

bun run ota:dev

Preview/Staging

bun run ota:preview

Production

bun run ota:prod

---

Quy trình làm việc khuyến nghị

Khi pull code mới về

1. Cài đặt dependencies

   bun install

2. Kiểm tra TypeScript

   bun run type-check

   • ✅ Nếu pass → Tiếp tục
   • ❌ Nếu có lỗi → Fix lỗi trước

3. Test local

   bun start

   Kiểm tra app chạy ổn trên simulator/device

4. Deploy OTA

   # Development
   bun run ota:dev
   
   # Preview
   bun run ota:preview
   
   # Production
   bun run ota:prod

---

Troubleshooting

Lỗi TypeScript

# Xem chi tiết lỗi
bun run type-check

# Thường gặp:
# - Missing types
# - Type mismatch
# - Import errors

Validation failed

• Kiểm tra lỗi TypeScript
• Fix tất cả lỗi trước khi OTA
• Không bỏ qua validation!

OTA không cập nhật

# Clear cache và thử lại
bun run ota:dev -- --clear-cache

---

Best Practices

✅ Luôn chạy validation trước khi OTA

✅ Test trên local trước

✅ Deploy lên dev/preview trước khi production

✅ Kiểm tra app sau khi OTA

✅ Có rollback plan

❌ Không skip validation

❌ Không deploy trực tiếp lên production

❌ Không deploy khi có lỗi TypeScript

---

Mở rộng thêm validation

Nếu muốn thêm lint hoặc test vào validation, update package.json:

{
  "scripts": {
    "lint": "eslint . --ext .ts,.tsx",
    "test": "jest",
    "validate": "bun run type-check && bun run lint && bun run test"
  }
}