📖 Bản tiếng Anh (English Edition)

Yêu cầu tiên quyết: Đọc Phần 12 — Đánh Giá Kỹ Sư Go Cấp Cao Tại Việt Nam và Phần 13 — Mô Hình Chi Phí Di Chuyển Magento.

Quản Trị Đội Ngũ Kỹ Sư Việt Nam Trong Dự Án Di Chuyển Magento (Mô Hình Vận Hành 2027)

Tóm tắt cốt lõi: Quản trị thành công một squad kỹ sư tại Việt Nam (GMT+7) từ Bắc Mỹ hoặc Tây Âu đòi hỏi chuyển đổi mức chênh lệch 11 đến 15 múi giờ từ một trở ngại giao tiếp thành một cỗ máy kỹ thuật 24 giờ liên tục (Follow-The-Sun). Bằng cách thiết lập Mô Hình Quản Trị Ưu Tiên Bất Đồng Bộ (Asynchronous-First)—dựa trên Bản Ghi Quyết Định Kiến Trúc (ADR) lưu trữ trên Git, khung giờ đồng bộ 90 phút hằng ngày (08:00–09:30 VN / 17:00–18:30 PT) và các chốt kiểm thử shadow traffic tự động trên CI/CD—các nhà lãnh đạo kỹ thuật sẽ triệt tiêu hoàn toàn tình trạng tắc nghẽn công việc và duy trì nhịp độ bàn giao nhanh chóng.

1. Chu Trình Phát Triển 24 Giờ Liên Tục (Follow-The-Sun)

Mức nghịch đảo múi giờ 12 tiếng đảm bảo luồng công việc diễn ra liên tục cả ngày lẫn đêm nếu được tổ chức bài bản:

sequenceDiagram
    autonumber
    participant Onshore as Kiến Trúc Sư / PM Quốc Tế (US Pacific: GMT-7)
    participant Git as GitHub & Kho Lưu Trữ ADR (Async Hub)
    participant Vietnam as Squad Go Nòng Cốt Tại Việt Nam (GMT+7)
    participant CI as Pipeline CI/CD & Môi Trường Shadow Test

    Note over Onshore,Vietnam: Giai Đoạn 1: Khung Giờ Đồng Bộ (08:00 - 09:30 VN / 17:00 - 18:30 PT)
    Onshore->>Vietnam: Họp standup nhanh, làm rõ yêu cầu nghiệp vụ, gỡ vướng PR
    Vietnam->>Onshore: Demo microservice vừa bóc tách & chỉ số đồng bộ CDC

    Note over Vietnam,CI: Giai Đoạn 2: Kỹ Sư Việt Nam Triển Khai Ban Ngày (09:30 - 18:00 VN)
    Vietnam->>Vietnam: Lập trình mã nguồn Go, viết unit test & benchmark
    Vietnam->>CI: Đẩy Git branches, kích hoạt xác thực lưu lượng shadow
    CI-->>Vietnam: Báo cáo xác thực (P99 latency < 45ms, tính toàn vẹn 100%)
    Vietnam->>Git: Tạo Pull Request kèm link ADR & video Loom giải thích

    Note over Onshore,Git: Giai Đoạn 3: Đội Ngũ Quốc Tế Đánh Giá Ban Ngày (09:00 - 17:00 PT)
    Onshore->>Git: Review PR, ký duyệt nghiệm thu kỹ thuật, merge vào main
    Onshore->>Git: Ban hành đặc tả RFC mới cho service tiếp theo

2. Chuẩn Hóa Kiến Trúc Bằng Bản Ghi Quyết Định (ADR)

Để loại trừ nguy cơ hiểu sai yêu cầu và giảm thiểu chu kỳ refactor tốn kém giữa các múi giờ, mọi quyết định kỹ thuật phải được ghi nhận thành Bản Ghi Quyết Định Kiến Trúc (Architecture Decision Record - ADR) lưu trữ trực tiếp trong repository Git dưới thư mục docs/adr/:

# ADR-014: Áp Dụng Mô Hình Transactional Outbox Cho Sự Kiện Đặt Hàng Checkout

## Trạng Thái
Đã chấp thuận (Được US Architect & VN Tech Lead ký duyệt ngày 15/02/2027)

## Bối Cảnh Nghiệp Vụ
Trong quá trình bóc tách checkout, việc lưu bản ghi đơn hàng vào PostgreSQL và phát sự kiện 
OrderCreated lên Apache Kafka phải đảm bảo tính nguyên tử (Atomicity). Việc ghi đồng thời vào 
2 nơi độc lập (dual-write) sẽ gây ra tình trạng bất đồng bộ tồn kho khi Kafka broker bị nghẽn mạng.

## Quyết Định Kỹ Thuật
Bắt buộc áp dụng Transactional Outbox Pattern thông qua Debezium PostgreSQL CDC Connector:
1. Microservice Go ghi đồng thời bản ghi đơn hàng và bản ghi sự kiện outbox trong cùng 1 database transaction.
2. Debezium đọc WAL logs từ bảng `order_outbox_events` và stream vào topic `orders.events.v1`.
3. Cấu hình Kafka retention 7 ngày với chính sách compact cleanup.

## Đánh Giá Hệ Quả
- Tích cực: Loại bỏ 100% rủi ro đơn hàng ma hoặc sự kiện Kafka mồ côi khi đứt kết nối mạng.
- Tiêu cực: Làm tăng 15ms độ trễ truyền phát sự kiện tới các dịch vụ thông báo hạ nguồn.
- Kiểm thử: Bắt buộc có test case tự động rollback xóa bản ghi outbox khi database gặp sự cố.

3. Kịch Bản Diễn Tập Chuyển Đổi Hệ Thống (Cutover Protocol 48 Giờ)

Thời điểm cutover chính thức không bao giờ được phó mặc cho sự may rủi. Đội ngũ dự án bắt buộc phải thực hiện tối thiểu 3 lần diễn tập cutover hoàn chỉnh trên môi trường staging trước khi đổi DNS Cloudflare:

flowchart TD
    StartCutover["T-24h: Đóng Băng Mọi Thay Đổi Schema Catalog Magento"] --> SyncAudit["T-12h: Kiểm Tra Lệch Offset CDC & Đối Soát Checksum"]
    SyncAudit --> ParityCheck{"Độ Trễ CDC < 100ms & Khớp Dữ Liệu = 100%?"}
    
    ParityCheck -- Không Đạt --> AbortGate["Hủy Bỏ Cutover: Xử Lý Điểm Nghẽn CDC Pipeline"]
    ParityCheck -- Đạt --> TrafficShift["T-0: Điều Hướng Lưu Lượng Cloudflare (10% -> 50% -> 100%)"]
    
    TrafficShift --> MetricsGate{"Tỷ Lệ Lỗi < 0.01% & P99 Latency < 45ms?"}
    MetricsGate -- Thất Bại --> AutoRollback["ROLLBACK TỰ ĐỘNG: Hoàn Lưu Lượng Về Lại Monolith Magento 2"]
    MetricsGate -- Thành Công --> Decommission["T+4h: Khóa Quyền Ghi MySQL Magento & Hoàn Tất Di Chuyển"]

Tiêu Chí Quyết Định Go / No-Go:

1. Toàn Vẹn Dữ Liệu: Đối soát checksum giữa các bảng PostgreSQL mới và MySQL master Magento đạt tỷ lệ tuyệt đối 100.000% trên tập mẫu kiểm thử 100,000 SKU hoạt động.
2. Độ Trễ Đồng Bộ (CDC Lag): Độ trễ consumer lag trên Debezium Kafka không vượt quá 50 records trong điều kiện giả lập tải đỉnh.
3. Ngân Sách Lỗi (Error Budget): Tỷ lệ lỗi HTTP 5xx không vượt quá 0.01% (dưới 1 lỗi trên 10,000 requests) trong 60 phút liên tục.
4. Trần Độ Trễ Ứng Dụng: Thời gian phản hồi P99 của API POST /api/v1/cart/checkout phải dưới 120ms ở mức tải gấp 5 lần lưu lượng giao dịch đỉnh.

4. Nhịp Sinh Hoạt Đội Ngũ & Văn Hóa Hợp Tác Xuyên Biên Giới

Một đội ngũ kỹ sư gắn kết, duy trì hiệu suất cao giữa các trung tâm công nghệ quốc tế và nhân sự Việt Nam được xây dựng trên sự minh bạch:

• Standup Hằng Ngày Bất Đồng Bộ: Đăng tải trên Slack trước 09:15 sáng (GMT+7) với cấu trúc: (1) Những gì đã hoàn thành và gắn link PR; (2) Mục tiêu commit trong ngày; (3) Các vướng mắc kỹ thuật cần kiến trúc sư quốc tế review.
• SLA Duyệt Mã Nguồn (Code Review): Các PR được tạo trước 17:00 (GMT+7) sẽ được kiến trúc sư quốc tế xem xét và phản hồi trước 10:00 sáng giờ bờ Tây Mỹ, đảm bảo không có thời gian chết chờ đợi.
• Chuẩn Mực Giao Tiếp Tiếng Anh: Toàn bộ tài liệu kiến trúc, mô tả PR, ticket Jira và ADR đều được viết bằng tiếng Anh chuẩn kỹ thuật. Mã nguồn Go tuân thủ nghiêm ngặt định dạng godoc.
• Giao Lưu Kỹ Thuật Định Kỳ: Tổ chức cho các Tech Lead quốc tế sang thăm và làm việc trực tiếp tại văn phòng Việt Nam định kỳ giúp gia tăng sự tin cậy và gắn kết lâu dài.

Câu Hỏi Thường Gặp (FAQ)