hecigo

    Tích hợp có cổng nghiệm thu.

    Mỗi bước có đầu ra cụ thể và một quyết định của bạn ở cuối. Không đạt thì dừng, bạn giữ những gì đã làm.

    Bắt đầu bằng Discovery
    1. 01Khảo sát tích hợp
    2. 02POC trên dữ liệu thật
    3. 03Triển khai chính thức
    4. 04Vận hành định kỳ

    1. 01 · 1-2 tuần

      Khảo sát tích hợp

      Bạn nhận Bản đánh giá kỹ thuật viết ra, đủ chi tiết để bất kỳ ai báo giá chính xác.

      • Bản đồ luồng dữ liệu hiện tại và luồng đích
      • Bảng ánh xạ trường dự thảo: nguồn, biến đổi, đích
      • Đánh giá API hai đầu: webhook, giới hạn tần suất, phân trang
      • Đề cương POC kèm tiêu chí nghiệm thu

      Cổng Bạn đọc bản đánh giá rồi quyết định có làm POC hay không.

    2. 02 · 2-3 tuần

      POC trên dữ liệu thật

      Bạn nhận Một luồng chạy trên 20 tới 50 giao dịch thật, kèm số đo và mã nguồn POC.

      • Đối chiếu tay toàn bộ giao dịch, nguồn với đích
      • Gửi lại 5 sự kiện, đích không được có bản trùng
      • Đo P50 và P95 từ log
      • Ngắt hệ thống đích, kiểm backlog đẩy đủ khi khôi phục

      Cổng Đạt hết tiêu chí thì chốt phạm vi production, không đạt thì dừng.

    3. 03 · 4-8 tuần

      Triển khai chính thức

      Bạn nhận Middleware chạy production, có giám sát, cảnh báo, nhật ký tra được và runbook.

      • Đủ trường hợp biên: sửa, huỷ, trả một phần, gộp, tách
      • Chống trùng, thử lại, DLQ, đối soát theo lịch
      • Cảnh báo hàng đợi tồn, tỉ lệ lỗi, độ trễ vượt ngưỡng
      • Chạy song song với quy trình cũ trước khi cắt

      Cổng Bạn chọn tự vận hành theo runbook hay giao hecigo vận hành định kỳ.

    4. 04 · hằng tháng

      Vận hành định kỳ

      Bạn nhận Một đầu mối chịu trách nhiệm khi middleware hỏng, kèm báo cáo hằng tháng.

      • Giám sát, cảnh báo, xử lý sự cố trong giờ cam kết
      • Đối soát định kỳ kèm báo cáo chênh lệch
      • Cập nhật bảo mật, vá phiên bản, hạn mức thay đổi nhỏ
      • Báo cáo tháng: số giao dịch, tỉ lệ thành công, P95

      Cổng Mỗi tháng bạn đọc báo cáo, rồi quyết định tiếp tục hay chuyển sang bàn giao.

    5. Nhánh rẽ, bất kỳ lúc nào · bất kỳ lúc nào

      Bàn giao

      Bạn nhận Đủ mã nguồn, dữ liệu và tài liệu để đội khác chạy tiếp mà không cần gọi hecigo.

      • Mã nguồn tuỳ biến, quyền sở hữu ghi trong hợp đồng
      • Lược đồ database và toàn bộ dữ liệu ánh xạ
      • Cấu hình triển khai, biến môi trường đã ẩn bí mật
      • Runbook và một buổi chuyển giao cho đội tiếp nhận

      Cổng Bạn tự vận hành hoặc giao cho đơn vị khác tiếp quản.

    Cơ chế đi kèm mọi tích hợp

    Gửi lại hai lần vẫn một bản ghi. Đích sập thì sự kiện nằm chờ, rồi tự đi tiếp.

    pos → crm · sync
    Một sự kiện đi qua khoá chống trùng, bản gửi lặp bị chặn; CRM trả 503, hàng đợi thử lại 1, 2 rồi 4 giây; hết lượt thì vào DLQ và được replay sang CRM, CRM trả 201.

    Khảo sát tích hợp

    Khảo sát tích hợp là bước chúng tôi đọc API và dữ liệu thật của cả hai hệ thống trước khi ai báo giá. Bạn cấp tài khoản chỉ đọc hoặc API key sandbox, dành 60 tới 90 phút với người hiểu nghiệp vụ, và gửi mẫu dữ liệu đã ẩn thông tin nhạy cảm. Chúng tôi trả về bản đồ luồng dữ liệu, bảng ánh xạ trường, đánh giá API hai đầu, khoá chống trùng đề xuất, danh sách rủi ro và đề cương POC. Bước này có thu phí, vì đề xuất không nhìn dữ liệu thật thì buộc phải đoán. Bản đánh giá thuộc về bạn, mang sang đơn vị khác cũng được.

    POC trên dữ liệu thật

    POC là bước chứng minh cách tiếp cận đúng trên dữ liệu thật: một luồng nghiệp vụ, 20 tới 50 giao dịch, chạy trên staging hoặc tài khoản test của hệ thống đích. Hai bên thống nhất tiêu chí nghiệm thu trước khi viết dòng mã đầu tiên. Chúng tôi đối chiếu tay từng giao dịch, chủ động gửi lại 5 sự kiện rồi đếm bản ghi đích, đo P50 và P95 từ log, chặn 2 webhook để xem đối soát có tự phát hiện và bù không, và cố ý ngắt hệ thống đích để kiểm backlog tự đẩy hết khi đích sống lại. Không đạt thì dừng, bạn vẫn giữ bản đánh giá và mã nguồn POC.

    Triển khai chính thức

    Triển khai chính thức là bước dựng đủ các luồng đã chốt sau POC, đủ trường hợp biên: sửa, huỷ, trả hàng một phần, gộp, tách. Mỗi sự kiện mang khoá chống trùng dạng source:type:id:version, và database giữ khoá đó bằng ràng buộc unique, nên gửi lại bao nhiêu lần cũng chỉ ra một bản ghi. Ghi lỗi thì thử lại với backoff cộng jitter, hết lượt thì vào hàng đợi lỗi (DLQ) phát lại được. Đối soát đếm số lượng mỗi giờ và so từng mã mỗi đêm. Hệ thống mới chạy song song với quy trình cũ trước khi cắt, và kết thúc bằng runbook cùng một buổi bàn giao.

    Vận hành định kỳ

    Vận hành định kỳ là việc chúng tôi nhận trách nhiệm cho lớp middleware theo tháng sau khi lên production, trên hạ tầng của hecigo hoặc của bạn. Chúng tôi giám sát, nhận cảnh báo và xử lý sự cố trong giờ cam kết, chạy đối soát và gửi báo cáo chênh lệch, cập nhật bảo mật và vá phiên bản. Mỗi tháng có hạn mức cho thay đổi nhỏ như thêm trường ánh xạ. Báo cáo tháng ghi số giao dịch, tỉ lệ thành công, P95 đo từ log, sự cố và cách xử lý. Thêm luồng mới, nối hệ thống thứ ba, hay viết lại khi bên thứ ba đổi API phá tương thích thì tính riêng.

    Bàn giao

    Bàn giao là lối ra, và nó nằm trong hợp đồng từ ngày ký chứ không phải lời hứa miệng. Bạn nhận mã nguồn tuỳ biến với quyền sở hữu ghi rõ trong hợp đồng, lược đồ cơ sở dữ liệu cùng toàn bộ dữ liệu ánh xạ, cấu hình triển khai (compose, mẫu biến môi trường đã ẩn giá trị bí mật, quy trình build), và runbook ghi cách chạy, cách theo dõi, cách xử lý các lỗi thường gặp. Cuối cùng là một buổi chuyển giao cho đội tiếp nhận. Bạn kích hoạt bàn giao ở bất kỳ bước nào, hoặc mua riêng nếu muốn tự vận hành từ đầu.