Maydohuyetap

Hướng Dẫn Vận Hành Hệ Thống "Eddie Howe" Cho Nền Tảng Thương Mại Điện Tử & Chăm Sóc Sức Khỏe Cấp 2 (Tier 2)

February 8, 2026

Hướng Dẫn Vận Hành Hệ Thống "Eddie Howe" Cho Nền Tảng Thương Mại Điện Tử & Chăm Sóc Sức Khỏe Cấp 2 (Tier 2)

Phạm Vi Áp Dụng & Điều Kiện Tiên Quyết

Hướng dẫn này được thiết kế cho các quản trị viên hệ thống và kỹ sư triển khai phụ trách nền tảng tích hợp thương mại điện tử (ecommerce) và dịch vụ chăm sóc sức khỏe (health/medical) cấp 2 (Tier 2) tại thị trường Việt Nam, sử dụng tên mã "Eddie Howe".

Điều kiện tiên quyết:

  • Đã có tài khoản quản trị với đầy đủ quyền truy cập vào bảng điều khiển (Admin Dashboard).
  • Hệ thống cơ sở hạ tầng (máy chủ, cơ sở dữ liệu, mạng) đã được triển khai và kiểm tra.
  • Tên miền chính thức đã được đăng ký và cấu hình. Lưu ý: Tuyệt đối không sử dụng tên miền hết hạn (expired-domain) cho môi trường sản xuất vì lý do bảo mật và uy tín.
  • Đã nắm vững các quy định pháp lý về bảo mật dữ liệu y tế và thương mại điện tử tại Việt Nam.

Quy Trình Vận Hành Chi Tiết

Quy trình dưới đây mô tả việc thiết lập một luồng dịch vụ tích hợp điển hình: "Đặt lịch khám bệnh và Thanh toán Trực tuyến".

  1. Bước 1: Đăng nhập và Truy cập Mô-đun Tích hợp
    Đăng nhập vào Bảng điều khiển Quản trị. Trên thanh điều hướng chính, di chuột đến mục "Cấu hình Hệ thống" và chọn "Tích hợp Dịch vụ - Eddie Howe".
    Mô tả giao diện: Bạn sẽ thấy một màn hình chia làm hai phần chính: bên trái là danh sách các dịch vụ y tế (khám tổng quát, tư vấn chuyên khoa...), bên phải là các cổng thanh toán (Ngân hàng nội địa, Ví điện tử).
  2. Bước 2: Liên kết Dịch vụ Y tế với Sản phẩm Cửa hàng
    Trong danh sách dịch vụ y tế, nhấp vào "Khám tổng quát Tiêu chuẩn". Một cửa sổ cấu hình sẽ hiện ra. 
    {
  "service_id": "MED_CHECKUP_STD",
  "linked_ecom_sku": "ECOMM_HEALTH_STD_001",
  "price": 850000,
  "duration_minutes": 30,
  "prerequisites": ["Mẫu khai báo y tế"]
}
    Nhập hoặc chọn SKU tương ứng từ danh mục sản phẩm thương mại điện tử (ECOMM_HEALTH_STD_001). Thiết lập giá và các điều kiện đi kèm. Nhấn "Liên kết & Đồng bộ".
  3. Bước 3: Cấu hình Quy trình Thanh toán
    Chuyển sang tab "Cấu hình Thanh toán". Kích hoạt ít nhất một cổng thanh toán nội địa Việt Nam (VD: VNPay).
    Nhập thông tin cấu hình bắt buộc: 
    Payment Gateway: VNPay
Merchant Code: YOUR_VNP_MERCHANT_CODE
Checksum Key: [Nhập khóa bảo mật]
Return URL: https://yourdomain.vn/payment/confirm
    Lưu cấu hình. Hệ thống sẽ chạy kiểm tra kết nối tự động.
  4. Bước 4: Kiểm thử Luồng Dịch vụ Hoàn chỉnh
    Từ giao diện chính, chọn "Chạy Kiểm thử Mô phỏng".
    1. Mô phỏng hành vi người dùng: Chọn dịch vụ "Khám tổng quát Tiêu chuẩn" -> Thêm vào giỏ hàng.
    2. Điền thông tin mẫu khai báo y tế số.
    3. Chọn phương thức thanh toán "VNPay".
    4. Theo dõi log hệ thống để xác nhận: "Đơn hàng ECOMM_HEALTH_STD_001 được tạo" -> "Lịch hẹn MED_CHECKUP_STD được đặt" -> "Chuyển hướng đến cổng VNPay thành công".
  5. Bước 5: Kích hoạt và Giám sát
    Sau khi kiểm thử thành công, trên giao diện chính, chuyển trạng thái của luồng dịch vụ từ "Thử nghiệm" sang "Đang hoạt động". Sử dụng bảng điều khiển giám sát để theo dõi các chỉ số: số lượt đặt lịch thành công, tỷ lệ giao dịch thất bại, thời gian phản hồi API.

Sự cố Thường gặp & Cách Khắc phục

Dưới đây là các sự cố phổ biến khi vận hành hệ thống "Eddie Howe":

  • Sự cố 1: Lỗi "Không thể đồng bộ SKU" ở Bước 2.
    Nguyên nhân: Mã SKU nhập vào không tồn tại trong danh mục sản phẩm thương mại điện tử hoặc định dạng không đúng.
    Cách khắc phục: Sử dụng chức năng tìm kiếm/trình chọn SKU được cung cấp, không nhập thủ công. Kiểm tra lại danh mục sản phẩm trên nền tảng thương mại điện tử.
  • Sự cố 2: Kiểm tra kết nối cổng thanh toán thất bại ở Bước 3.
    Nguyên nhân: Khóa bảo mật (Checksum Key) không chính xác, cấu hình mạng (Firewall) chặn kết nối đến máy chủ cổng thanh toán.
    Cách khắc phục: Xác nhận lại Khóa bảo mật với bên cung cấp cổng thanh toán. Liên hệ với đội ngũ quản trị mạng để đảm bảo các địa chỉ IP của VNPay (ví dụ) được phép ra/vào.
  • Sự cố 3: Người dùng cuối báo cáo "Lịch hẹn không được tạo" sau khi thanh toán thành công.
    Nguyên nhân: Lỗi trong luồng webhook, API callback từ cổng thanh toán về hệ thống không được xử lý.
    Cách khắc phục: Kiểm tra mục "Nhật ký Webhook" trong bảng điều khiển. Xác minh rằng URL nhận webhook đang hoạt động và xác thực chữ ký dữ liệu đến là chính xác. Đảm bảo dịch vụ xử lý hàng đợi (queue) đang chạy.
  • Sự cố 4: Cảnh báo "Tên miền không đáng tin cậy" trên trình duyệt.
    Nguyên nhân: Chứng chỉ SSL/TLS cho tên miền của bạn đã hết hạn hoặc được cấp cho một tên miền khác. Đặc biệt nguy hiểm nếu sử dụng tên miền hết hạn mua lại.
    Cách khắc phục: Gia hạn hoặc cấp lại chứng chỉ SSL hợp lệ từ nhà cung cấp uy tín (VD: Let's Encrypt, các nhà cung cấp tại Việt Nam). Tuyệt đối không sử dụng tên miền đã hết hạn cho các dịch vụ nhạy cảm như y tế.
Eddie Howehealth健康medical