Đổi channel manager mà không mất đặt phòng: áp dụng tư duy migration dữ liệu cho hệ thống đặt phòng
Ai từng chuyển database production sang hệ thống mới đều biết cảm giác này: hệ thống cũ chạy chưa tốt nhưng vẫn chạy, còn ngày chuyển thì chỉ cần sai một bước là mất dữ liệu thật.
Chủ homestay đổi channel manager (phần mềm đồng bộ lịch, giá với Airbnb, Booking.com, Agoda) cũng gặp đúng bài toán đó. Chỉ khác là "dữ liệu bị mất" ở đây là một vị khách đến nhận phòng mà phòng đã có người ở.
Bài này đi qua quy trình chuyển đổi mà nhóm mình đề xuất cho người dùng, kèm cách hệ thống được thiết kế để quy trình đó an toàn. Nếu bạn làm phần mềm có tích hợp với nền tảng bên ngoài (OTA, cổng thanh toán, CRM…), nhiều ý ở đây dùng lại được.
Bài gốc viết cho chủ nhà (tiếng Việt): Đổi channel manager không mất đặt phòng: checklist từng bước. Bài này là phiên bản kỹ thuật cho lập trình viên.
1. Bốn kiểu hỏng khi chuyển
Gần như mọi sự cố đều thuộc một trong bốn loại. Nhìn bằng con mắt lập trình viên thì đều là chuyện quen:
| Rủi ro | Biểu hiện | Tương đương trong migration |
|---|---|---|
| Hai hệ thống cùng đẩy lên một listing | Giá, phòng trống đổi qua đổi lại; ngày đã có khách bị mở lại | Hai writer cùng ghi một bảng (split-brain) |
| Mỗi listing chỉ một nhà cung cấp | Kết nối mới lỗi, hoặc âm thầm thay kết nối cũ | Ràng buộc duy nhất ở phía hệ thống ngoài |
| Mất đặt phòng tương lai | Khách đến mà không có trên lịch mới | Dữ liệu không được chép đủ |
| Giá hoặc quy tắc bị đặt lại | Listing hiện giá mặc định cũ, mất số đêm tối thiểu | Giá trị mặc định ghi đè dữ liệu thật |
Riêng rủi ro thứ hai cần biết trước cho từng kênh: có OTA khi kết nối nhà cung cấp mới sẽ tự cắt nhà cung cấp cũ, có OTA bắt phải ngắt cái cũ trước. Thứ tự thao tác vì vậy phụ thuộc từng kênh.
2. Nguyên tắc cốt lõi: tại mỗi thời điểm, mỗi listing chỉ có một writer
Đây là luật quan trọng nhất của cả quy trình, và cũng là luật quen thuộc nhất với dân backend: single writer.
Hai hệ thống cùng ghi vào một listing thì không có cách nào biết giá trị nào đúng. Hệ A đẩy giá 1.200.000đ, hệ B đẩy 900.000đ, rồi A lại đẩy… Ngày đã có khách có thể bị hệ kia mở lại vì nó không biết đặt phòng đó tồn tại.
Vì vậy quy trình chia rõ ba trạng thái cho mỗi listing:
[Hệ cũ ghi] ──▶ [Hệ cũ ghi, hệ mới CHỈ ĐỌC] ──▶ [Ngắt hệ cũ] ──▶ [Hệ mới ghi]
Không bao giờ có trạng thái "cả hai cùng ghi".
3. Quy trình chuyển đổi
Cả quá trình nên mất một đến hai tuần, còn bước chuyển chính thức chỉ diễn ra trong một ngày vắng khách.
Bước 1: Backup. Xuất toàn bộ đặt phòng có ngày nhận phòng từ hôm nay trở đi (tên khách, kênh, mã xác nhận, ngày, phòng, số tiền) và bảng giá (giá theo thứ, theo mùa, số đêm tối thiểu, ngày đã đóng). Lưu ở chỗ nằm ngoài cả hai hệ thống. Đây là "snapshot" để đối chiếu và để dựng lại nếu có sự cố.
Bước 2: Chọn cửa sổ bảo trì. Ngày trong tuần, ngoài mùa cao điểm, buổi sáng không có khách nhận phòng. Tránh mấy tuần trước Tết, dịp 30/4, 2/9. Giống như không ai deploy migration lớn vào chiều thứ Sáu.
Bước 3: Kết nối hệ mới ở chế độ chỉ đọc. Hệ mới nhập đặt phòng tương lai và giá (nếu đọc được), nhưng chưa được đẩy gì lên listing đang bán.
Bước 4: Đối chiếu (xem mục 4).
Bước 5: Xác nhận số phòng của từng loại phòng. Đặt 1 khi có 3 thì bán thiếu, đặt 3 khi chỉ có 1 thì trùng phòng.
Bước 6: Ngắt hệ cũ trên từng OTA, lần lượt từng kênh, đánh dấu từng kênh đã xong.
Bước 7: Bật ghi trên hệ mới. Kiểm tra giá, số đêm tối thiểu, phòng trống trên từng OTA có khớp với bản backup ở bước 1 không.
Bước 8: Theo dõi 48 giờ. Đặt phòng mới có về không, đặt phòng ở kênh này có đóng ngày ở kênh khác không, giá có đúng không. Xem hai lần mỗi ngày.

Thứ tự rất quan trọng: tại mỗi thời điểm chỉ một hệ thống được ghi vào một listing.
Hệ thống mới hỗ trợ quy trình này thế nào
Quy trình chỉ an toàn khi phần mềm được thiết kế cho nó. Mấy quyết định thiết kế trong hệ thống của nhóm mình:
- Kết nối xong là chỉ đọc. Không có gì được đẩy lên listing đang bán cho đến khi người dùng xác nhận số phòng và bật chạy thật. Đây là bước 3 ở trên, được ép bằng code chứ không trông vào việc người dùng nhớ.
- Đọc được gì thì nhập, không đọc an toàn được thì báo. Với Airbnb, giá thật của listing (giá đêm, giá cuối tuần, các khoản phí) được nhập ở chế độ chỉ đọc. Phần nào không đọc được an toàn thì hiện ra cho người dùng, không đoán. Một con số đoán sai rồi bị đẩy lên kênh còn tệ hơn một ô trống.
- Không bao giờ đẩy giá bằng 0 hoặc giá tạm. Nếu bước nhập giá thiếu dữ liệu, giá trị mặc định không được phép đè lên listing đang bán.
4. Đối chiếu: đếm trước, đi vào chi tiết sau
Đây là bước phát hiện đặt phòng bị mất, nên phải làm thành bảng chứ không liếc qua. Cách làm giống kiểm tra một lần migration dữ liệu: so số lượng theo từng nhóm trước, chỉ đi vào từng bản ghi ở nhóm bị lệch.
Ví dụ homestay 4 phòng bán trên Airbnb, Booking.com, Agoda:
| Kênh | Đặt phòng tương lai trên extranet | Đã nhập vào hệ mới | Khớp? | Việc cần làm |
|---|---|---|---|---|
| Airbnb | 18 | 18 | Có | Kiểm tra ngẫu nhiên 3 ngày |
| Booking.com | 11 | 10 | Không | Tìm đặt phòng thiếu, thêm tay |
| Agoda | 6 | 6 | Có | Kiểm tra ngẫu nhiên 2 ngày |
| Trực tiếp / qua Zalo | 4 | 0 | Không | Nhập tay từ file đã xuất |

Đếm đặt phòng tương lai của từng kênh ở cả hai nơi, rồi xem kỹ những kênh bị lệch.
Khi khớp số rồi vẫn kiểm tra ngẫu nhiên vài ngày, vì số khớp chưa chắc dữ liệu đúng: một đặt phòng có thể vào sai phòng, sai ngày, hoặc đã hủy mà vẫn được nhập như còn hiệu lực.
Dòng cuối là cái bẫy kinh điển: dữ liệu không đi qua tích hợp. Khách quen nhắn Zalo rồi chuyển khoản thì không kết nối kênh nào nhập được. Những đặt phòng đó chỉ nằm trong file backup. Không nhập tay trước khi chạy thật thì những ngày đó sẽ bị mở bán. Trong migration nào cũng có một nguồn dữ liệu "nằm ngoài hệ thống" như vậy, và nó luôn là thứ bị quên.
5. Kế hoạch rollback: viết ra trước, không nghĩ lúc đang cháy
Giống một migration tử tế, kế hoạch quay lại phải có trước ngày chuyển:
- Giữ tài khoản hệ cũ ít nhất hai tuần sau khi hệ mới chạy ổn. Đừng hủy gói sớm.
- Giữ file backup. Đó là dữ liệu để dựng lại.
- Biết cách đảo ngược từng kênh: ngắt hệ mới trên kênh đó trước, rồi mới kết nối lại hệ cũ. Không bao giờ để cả hai cùng kết nối, kể cả lúc đang rollback.
- Có "phanh tay": trong lúc xử lý sự cố, chặn các ngày sắp tới ngay trên extranet. Đóng nhầm thì chỉ mất doanh thu, mở nhầm thì có thể trùng phòng.
- Định trước điều kiện rollback, ví dụ: "Thiếu một đặt phòng hoặc sai giá mà trong một ngày không giải thích được thì quay lại kênh đó." Điều kiện viết sẵn giúp quyết định nhanh, không cãi nhau lúc đang rối.
Thiết kế để rollback luôn rẻ: ngắt kết nối không bao giờ xóa
Rollback chỉ đơn giản khi ngắt kết nối là thao tác không phá hủy. Trong hệ thống của nhóm mình, ngắt một kênh chỉ dừng đồng bộ. Listing trên OTA, đánh giá, lịch sử và các đặt phòng trên đó không bị xóa.
Phía bên trong, việc dọn dẹp dữ liệu ở nhà cung cấp kết nối cũng được làm bền vững bằng một teardown queue:
- Khi người dùng ngắt kết nối, các id cần gỡ ở phía nhà cung cấp được ghi vào bảng
teardown_taskstrong cùng transaction với thay đổi ở DB của mình. - Sau khi commit mới gọi API để gỡ. Nếu API lỗi, dòng task vẫn còn và được thử lại sau.
- Index duy nhất trên
(kind, externalId)kèmskipDuplicates, nên ghi lại một task đã có không làm hỏng transaction bao quanh. - Teardown chỉ giảm dữ liệu ở phía nhà cung cấp, không bao giờ đẩy giá hay phòng trống, nên chạy được cả khi hệ thống đang ở chế độ chỉ đọc.
- Có thứ tự: kênh phải được gỡ trước chỗ nghỉ mà nó gắn vào, vì gỡ ngược thì API báo lỗi.
Nhờ vậy không bao giờ có tình huống "bên mình đã xóa, bên kia vẫn còn giữ dữ liệu" chỉ vì một lần API chập chờn.
6. Checklist
Cho người dùng:
- Backup đặt phòng tương lai và bảng giá ra chỗ nằm ngoài cả hai hệ thống.
- Chọn ngày vắng khách, ngoài mùa cao điểm.
- Kết nối hệ mới ở chế độ chỉ đọc.
- Đối chiếu số đặt phòng theo từng kênh, chỉ đào sâu ở kênh lệch. Nhập tay đặt phòng ngoài OTA.
- Xác nhận số phòng của từng loại phòng.
- Ngắt hệ cũ từng kênh, rồi mới bật ghi trên hệ mới.
- Theo dõi 48 giờ, giữ hệ cũ hai tuần.
Cho người làm phần mềm:
- Kết nối mới mặc định chỉ đọc, bật ghi là một hành động có chủ đích.
- Không đoán dữ liệu thiếu, hiện ra cho người dùng.
- Không bao giờ đẩy giá trị mặc định (giá 0, giá tạm) lên dữ liệu đang chạy thật.
- Ngắt kết nối không phá hủy, để rollback luôn rẻ.
- Thao tác với hệ thống ngoài đi qua outbox/queue ghi trong cùng transaction, có thử lại và idempotent.
Bài học chung: một lần chuyển đổi an toàn không đến từ việc không bao giờ sai, mà từ việc mỗi rủi ro có một bước kiểm tra phát hiện ra nó, và mỗi bước đều quay lại được.
Bài gốc (tiếng Việt, viết cho chủ nhà): Đổi channel manager không mất đặt phòng: checklist từng bước. Các bài khác của nhóm ở blog Santara AI.
Bài viết được soạn với sự hỗ trợ của AI, từ bài gốc trên blog Santara AI và mã nguồn của nhóm.
All rights reserved