Tích hợp kho & tồn cho Website chỉ tạo giá trị khi dữ liệu đi đúng nơi, đúng thời điểm và có thể truy vết. Đối tượng chính là website bán hàng cần hiển thị tồn hoặc giữ chỗ dựa trên hệ thống kho. Mục tiêu kiến trúc là định nghĩa available-to-sell và reservation thay vì copy một con số tồn đơn giản. Do đó, dự án phải khóa business event, entity, ownership, contract và failure handling trước khi chọn plugin, app hay viết API.
Với kho & tồn, dữ liệu trọng tâm gồm SKU, warehouse, on-hand, reserved, safety stock, available, allocation, update time; luồng tham chiếu là inventory event/sync → calculate available → expose to web → reserve on order → release/confirm. Những rủi ro cần được thiết kế từ đầu gồm oversell, stale cache, multi-warehouse, cancelled order không release, backorder. Capability của nền tảng bên thứ ba có thể thay đổi, vì vậy tài liệu chính thức, quyền tài khoản và phiên bản API tại thời điểm triển khai mới là nguồn kiểm chứng cuối.
Định nghĩa thành công cho kho & tồn không phải ‘API trả về 200’. Doanh nghiệp cần quan sát oversell, stock freshness, reservation failure, reconciliation và giữ được bằng chứng như inventory formula, warehouse mapping, concurrency test, stock reconciliation. Nếu không có reconciliation hoặc log đủ tốt, một integration có thể chạy bề ngoài nhưng âm thầm tạo duplicate, bỏ sót record hoặc làm sai attribution.
Bài toán kinh doanh và ranh giới tích hợp – kho & tồn
Trước khi thiết kế kho & tồn, hãy mô tả sự kiện nghiệp vụ bằng câu rõ ràng: ai làm gì, entity nào thay đổi và hệ nào cần biết sự thay đổi đó. Với Tích hợp kho & tồn cho Website, mục tiêu là định nghĩa available-to-sell và reservation thay vì copy một con số tồn đơn giản. Nếu yêu cầu chỉ nói ‘đồng bộ hai hệ’ mà không chỉ ra event, scope sẽ lan sang mọi field và rất khó nghiệm thu.
Ranh giới của kho & tồn cần phân biệt dữ liệu phục vụ hiển thị, dữ liệu giao dịch và dữ liệu phân tích. Một field dùng cho UI không mặc nhiên phải đẩy vào CRM/ERP; ngược lại, một trạng thái tài chính hoặc quyền truy cập không nên bị frontend tự suy diễn. Mỗi lớp có owner và mức độ tin cậy khác nhau.
Business rule của kho & tồn phải được viết độc lập với vendor khi có thể. Ví dụ ‘đơn đã thanh toán mới chuyển trạng thái X’ bền vững hơn rule gắn với tên một webhook cụ thể. Khi vendor đổi endpoint hoặc doanh nghiệp thay nền tảng, domain rule vẫn giữ nguyên và chỉ adapter thay đổi.
Scope tốt cho kho & tồn luôn có out-of-scope. Những báo cáo, workflow hoặc historical migration chưa phục vụ go-live nên được tách phase. Điều này bảo vệ vertical slice end-to-end và giúp team test một luồng hoàn chỉnh thay vì có nhiều connector nửa chừng.
Bản đồ hệ thống và source of truth – kho & tồn
System map của kho & tồn phải chỉ ra hệ nào tạo, hệ nào đọc, hệ nào được phép sửa từng entity. Với dữ liệu SKU, warehouse, on-hand, reserved, safety stock, available, allocation, update time, mỗi trường quan trọng nên có source of truth. Hai hệ cùng sửa một field mà không có rule ưu tiên là nguồn gốc phổ biến của dữ liệu ‘đúng ở màn hình này, sai ở màn hình khác’.
Đối với kho & tồn, owner kỹ thuật và owner nghiệp vụ đều cần có. Owner kỹ thuật xử lý credential, API và monitoring; owner nghiệp vụ quyết định nghĩa của trạng thái, quy tắc merge và cách xử lý ngoại lệ. Thiếu một trong hai, team dev dễ tự đoán business rule còn vận hành lại không hiểu constraint kỹ thuật.
Vẽ dependency của kho & tồn theo chiều đọc và ghi. Hệ thống chỉ đọc có thể cache hoặc degrade khác hệ thống ghi giao dịch. Nếu dependency chỉ để enrichment bị lỗi, website có thể tiếp tục với dữ liệu tối thiểu; nếu dependency là source xác nhận giao dịch, UI phải phản ánh trạng thái pending thay vì giả vờ thành công.
Khi nhiều hệ cùng dùng ID khác nhau, kho & tồn cần canonical ID hoặc mapping table có version. Không nên dùng email, tên sản phẩm hay label hiển thị như khóa duy nhất nếu chúng có thể thay đổi. Mapping sai ID tạo lỗi khó phát hiện hơn lỗi API vì request vẫn thành công nhưng gắn nhầm entity.
Data contract, field mapping và version – kho & tồn
Data contract của kho & tồn cần ghi field, type, required/optional, enum, timezone, encoding và ý nghĩa business. Với SKU, warehouse, on-hand, reserved, safety stock, available, allocation, update time, các field dùng cho tiền, số lượng, trạng thái hoặc identity phải tránh kiểu dữ liệu mơ hồ. Contract nên cho ví dụ hợp lệ lẫn ví dụ bị từ chối.
Field mapping của kho & tồn phải có transform rule. Một hệ có ‘customer_name’ trong một chuỗi, hệ khác tách họ/tên; một hệ dùng mã chi nhánh, hệ khác dùng UUID. Nếu transform nằm rải rác trong nhiều đoạn code, việc đổi schema sẽ tạo drift. Tốt hơn là gom mapping ở lớp có thể test.
Versioning cho kho & tồn cần phân biệt thay đổi tương thích và breaking change. Thêm field optional khác với đổi enum hay xóa field. Khi contract thay đổi, producer và consumer không nhất thiết deploy cùng phút; vì vậy cần khoảng chuyển tiếp, feature flag hoặc dual-read/dual-write có kế hoạch dừng.
Dữ liệu mẫu của kho & tồn phải bao phủ record chuẩn, record thiếu field, chuỗi dài, ký tự Unicode, timezone biên, giá trị 0/null và entity đã ngừng hoạt động. Test chỉ bằng một record đẹp rất dễ bỏ qua các lỗi mapping xuất hiện khi import hoặc traffic thật.
Luồng API/webhook/event – kho & tồn
Luồng tham chiếu của kho & tồn là inventory event/sync → calculate available → expose to web → reserve on order → release/confirm. Mỗi bước phải định nghĩa request/event, trạng thái trước và sau, acknowledgement và điều kiện hoàn tất. Nếu một bước async, UI không được coi việc gửi request là hoàn thành nghiệp vụ khi consumer chưa xử lý.
Webhook của kho & tồn cần thiết kế như event delivery có thể lặp. Endpoint phải xử lý nhanh phần xác nhận nhận sự kiện, sau đó đưa công việc nặng vào queue khi phù hợp. Event có timestamp, ID và loại rõ giúp trace tốt hơn một payload không version chỉ chứa dữ liệu hiện tại.
Polling trong kho & tồn chỉ nên dùng khi nguồn không hỗ trợ event hoặc khi cần reconciliation bổ sung. Poll quá dày tăng quota và tải; poll quá thưa làm dữ liệu stale. Nếu dùng batch, checkpoint phải lưu tiến độ để chạy lại từ phần lỗi thay vì tái xử lý toàn bộ.
Đối với luồng kho & tồn, correlation ID nên đi xuyên request nội bộ nếu kiến trúc cho phép. Khi người dùng báo ‘đã làm nhưng không thấy’, support có thể nối từ session/order/lead sang log integration thay vì tìm bằng thời gian và đoán.
Authentication, authorization và secret – kho & tồn
Authentication cho kho & tồn trả lời hệ thống nào đang gọi; authorization trả lời hệ đó được làm gì. Credential nên có scope tối thiểu, tách môi trường và không nhúng vào mã frontend. Nếu vendor hỗ trợ rotation, runbook phải mô tả cách đổi secret mà không gây downtime.
Với kho & tồn, token hết hạn là trạng thái vận hành bình thường, không phải sự cố bất ngờ. Monitoring cần phát hiện lỗi auth sớm, nhưng log không được ghi raw token. Khi quyền tài khoản hoặc app thay đổi, team cần biết integration nào phụ thuộc vào scope đó.
Endpoint nhận webhook cho kho & tồn cần kiểm cơ chế xác thực/chữ ký theo tài liệu chính thức của nền tảng khi có. Chỉ dựa vào IP cố định hoặc một query string tự đặt thường không đủ bền. Đồng thời phải chống replay nếu event tạo side effect quan trọng.
Least privilege của kho & tồn cũng áp dụng cho tài khoản nội bộ. Người cấu hình tracking không nhất thiết cần quyền sửa catalog; service đẩy lead không cần quyền xóa contact. Role matrix giúp giới hạn blast radius khi credential bị lộ hoặc thao tác sai.
Idempotency, retry và duplicate – kho & tồn
Idempotency của kho & tồn là khả năng nhận lại cùng request/event mà không tạo kết quả nghiệp vụ lặp. Với các rủi ro oversell, stale cache, multi-warehouse, cancelled order không release, backorder, cần xác định idempotency key: transaction ID, event ID, order ID kết hợp action hoặc khóa domain phù hợp.
Retry trong kho & tồn phải phụ thuộc loại lỗi. Timeout và 5xx có thể retry với backoff; validation 4xx thường cần sửa dữ liệu; rate limit cần tôn trọng hướng dẫn của provider. Retry mọi lỗi theo vòng lặp cố định vừa tốn quota vừa che nguyên nhân thật.
Duplicate của kho & tồn không chỉ là hai record giống hệt. Có thể là hai lead khác ID nhưng cùng người, hai purchase event cùng order, hoặc hai shipment cho một đơn. Dedupe rule phải bám entity và business meaning thay vì so chuỗi toàn payload.
Khi retry bất thành, kho & tồn cần dead-letter queue hoặc hàng lỗi có thể xử lý. Record lỗi phải giữ đủ context để replay sau khi sửa nguyên nhân, nhưng không giữ dữ liệu nhạy cảm quá mức. Dashboard cần phân biệt pending retry với failed vĩnh viễn.
Failure design và khả năng chịu lỗi – kho & tồn
Failure design của kho & tồn bắt đầu từ oversell, stale cache, multi-warehouse, cancelled order không release, backorder. Mỗi lỗi cần xác định user impact, data impact và recovery path. Nếu integration phụ chỉ cung cấp enrichment, website có thể degrade; nếu nó quyết định thanh toán hoặc quyền truy cập, hệ thống phải fail closed hoặc pending theo rule nghiệp vụ.
Timeout của kho & tồn cần budget. Một page không nên chờ nối tiếp nhiều API bên ngoài chỉ để render. Có thể pre-sync dữ liệu, cache an toàn hoặc tải async tùy use case. Điều quan trọng là cache policy phải biết dữ liệu nào được stale và dữ liệu nào không.
Circuit breaker hoặc giới hạn concurrency có thể cần khi dependency của kho & tồn lỗi kéo dài. Mục tiêu là tránh website tự quá tải vì tiếp tục dồn request vào một hệ đang chết. Runbook phải nêu khi nào bật chế độ degrade và cách phục hồi backlog.
Người dùng của kho & tồn cần thông báo trạng thái thật. ‘Đã gửi yêu cầu’ khác ‘đã hoàn thành’. Với tác vụ async, confirmation nên cung cấp mã tham chiếu hoặc trạng thái có thể tra cứu nếu nghiệp vụ yêu cầu, giảm tình trạng người dùng submit lặp vì không chắc.
Reconciliation và tính nhất quán dữ liệu – kho & tồn
Reconciliation của kho & tồn so sánh sự thật giữa hai phía sau khi integration chạy. Với SKU, warehouse, on-hand, reserved, safety stock, available, allocation, update time, hãy chọn key, time window và field quan trọng để so. Reconciliation bắt được các trường hợp request mất, webhook trễ hoặc mapping sai mà monitoring HTTP không thấy.
Không phải mismatch nào của kho & tồn cũng tự sửa. Một số có thể replay; một số cần người nghiệp vụ quyết định vì record đã bị sửa ở hai phía. Vì vậy mismatch queue cần severity, owner và audit trail, không chỉ xuất CSV rồi để đó.
Đối soát tiền, tồn kho hoặc trạng thái tuyển dụng trong kho & tồn nên có quy tắc rõ về cut-off và eventual consistency. So quá sớm sẽ báo false positive; so quá muộn làm lỗi lan rộng. Window phải phù hợp latency thật của luồng.
Khi reconciliation của kho & tồn phát hiện drift lặp lại, không nên chỉ chạy script sửa dữ liệu. Team phải tìm root cause ở contract, mapping, retry hoặc ownership. Script vá mà không sửa nguyên nhân làm hệ thống tiếp tục tạo mismatch mới.
Privacy, consent và data minimization – kho & tồn
Privacy của kho & tồn bắt đầu bằng data minimization: chỉ gửi field cần cho mục đích đã xác định. Với SKU, warehouse, on-hand, reserved, safety stock, available, allocation, update time, cần phân loại field nhận diện, hành vi, giao dịch và dữ liệu nhạy cảm để quyết định scope, retention và quyền truy cập.
Consent trong kho & tồn phải được truyền đúng ngữ nghĩa nếu downstream sử dụng dữ liệu cho marketing hoặc personalization. Một checkbox tại form không tự động hợp thức hóa mọi mục đích downstream. Consent source, time và preference cần model nếu nghiệp vụ phụ thuộc.
Log của kho & tồn không nên chứa raw password, token hoặc toàn bộ PII chỉ vì tiện debug. Có thể log ID, hash/partial identifier, status, error code và correlation ID. Payload debug nhạy cảm nếu bắt buộc phải được giới hạn quyền và retention.
Khi bên thứ ba của kho & tồn thay đổi policy hoặc data requirement, governance phải kích hoạt review. Việc một field từng được gửi không có nghĩa nên gửi mãi. Data inventory giúp biết nhanh integration nào đang chuyển loại dữ liệu nào ra ngoài hệ thống.
Observability và analytics – kho & tồn
Observability của kho & tồn cần ba lớp: metric, log và trace/correlation. Metric cho biết tỷ lệ lỗi/látency; log cho chi tiết event; correlation nối request qua nhiều hệ. Chỉ có log rời rạc khiến việc điều tra phụ thuộc người nhớ timestamp.
Metric ưu tiên cho kho & tồn là oversell, stock freshness, reservation failure, reconciliation. Nên tách technical success khỏi business success. API gửi lead thành công nhưng lead thiếu source hoặc bị CRM reject bởi rule sau đó vẫn là thất bại nghiệp vụ dù connector báo xanh.
Alert của kho & tồn nên dựa trên symptom có tác động, không phải mọi exception. Một lỗi đơn lẻ đã retry thành công khác với tỷ lệ failure tăng liên tục. Alert cần owner, ngưỡng hợp lý và link tới runbook để người nhận biết bước đầu phải kiểm gì.
Analytics người dùng và monitoring integration của kho & tồn nên gặp nhau ở các ID không nhạy cảm như order/lead/application reference. Nhờ đó có thể phân biệt conversion drop do UX với conversion drop do downstream không nhận dữ liệu.
Sandbox, test data và acceptance test – kho & tồn
Sandbox của kho & tồn nên phản ánh contract thật nhưng dùng dữ liệu giả. Nếu provider có test mode, team cần biết điểm khác production: endpoint, credential, event behavior hoặc giới hạn. Không suy ra production hoàn toàn từ một sandbox luôn trả success.
Acceptance test kho & tồn phải có positive, negative và recovery case. Positive chứng minh happy path; negative kiểm validation/auth; recovery kiểm retry, duplicate, timeout và replay. Với oversell, stale cache, multi-warehouse, cancelled order không release, backorder, ít nhất một case nên cố tình tạo lỗi.
Test data cho kho & tồn cần có record biên, không chỉ ‘John Doe’. Dữ liệu tiếng Việt có dấu, chuỗi dài, số 0, null, ký tự đặc biệt, timezone và entity đã archived thường làm lộ bug mapping. Nếu có file/upload, cần test size/type và tên file thực tế.
Bằng chứng nghiệm thu kho & tồn nên giữ inventory formula, warehouse mapping, concurrency test, stock reconciliation. Screenshot UI là chưa đủ cho integration; cần log, ID ở cả hai hệ hoặc reconciliation. Evidence giúp lần release sau biết thay đổi nào làm contract hỏng.
SEO, UX và hiệu năng khi có integration – kho & tồn
Integration kho & tồn không được làm hỏng SEO hoặc UX chỉ vì kỹ thuật. Script tracking/chat/widget nên được tải theo nhu cầu, tránh chặn render. Dữ liệu SEO quan trọng không nên chỉ xuất hiện sau một call client-side không ổn định nếu có thể render server-side.
Với kho & tồn, URL state và query parameter cần được kiểm nếu integration tạo filter, callback hoặc tracking parameter. Canonical, redirect và indexation không nên phụ thuộc ngẫu nhiên vào callback của vendor. Return URL thanh toán/SSO cũng phải tránh tạo index rác.
Failure message của kho & tồn phải viết theo task. Người dùng cần biết có nên thử lại, chờ, đổi phương thức hay liên hệ. Không hiển thị raw exception/API response. Với form hoặc checkout, giữ dữ liệu người dùng an toàn khi lỗi để họ không nhập lại mọi thứ.
Performance budget cho kho & tồn nên đo trước/sau thêm SDK. Một script bên thứ ba có thể tạo network, CPU và privacy cost. Nếu cùng mục tiêu có thể đạt bằng server-side hoặc delayed loading, team nên so trade-off thay vì cài mặc định trên toàn site.
Rollout, cutover và vận hành sau launch – kho & tồn
Rollout kho & tồn nên bắt đầu bằng vertical slice đủ từ website tới hệ đích và reconciliation. Khi slice ổn, mở rộng entity/traffic. Cách này phát hiện mapping và permission sớm hơn build toàn bộ connector rồi test cuối dự án.
Cutover của kho & tồn cần xác định freeze, backfill và dual-run nếu có. Khi đổi từ integration cũ sang mới, phải tránh hai hệ cùng tạo side effect. Nếu dual-write, cần kế hoạch so kết quả và ngày tắt đường cũ, không để dual-write tồn tại vô hạn.
Rollback code của kho & tồn khác rollback data. Nếu sau go-live đã có order, lead hoặc application mới, restore database cũ có thể mất giao dịch. Runbook phải nói khi nào rollback binary, khi nào forward-fix và cách xử lý record đã phát sinh.
Sau launch, owner kho & tồn cần review error trend, credential expiry, API deprecation và mismatch định kỳ. Integration không ‘xong vĩnh viễn’; dependency và business rule đều thay đổi. Change log giúp liên hệ sự cố với release hoặc policy mới.
Ở vòng kiểm triển khai thứ 1 của kho & tồn, đội dự án nên chạy một scenario có dữ liệu SKU, warehouse, on-hand, reserved, safety stock, available, allocation, update time qua toàn bộ flow inventory event/sync → calculate available → expose to web → reserve on order → release/confirm. Scenario phải chứa ít nhất một trường hợp oversell, stale cache, multi-warehouse, cancelled order không release, backorder để kiểm cách hệ thống phục hồi, cách UI phản hồi và log cần thiết cho support. Chỉ khi kết quả có thể đối chiếu bằng inventory formula, warehouse mapping, concurrency test, stock reconciliation và các chỉ số oversell, stock freshness, reservation failure, reconciliation mới nên coi lớp này đã đủ điều kiện nghiệm thu.
Ở vòng kiểm triển khai thứ 2 của kho & tồn, đội dự án nên chạy một scenario có dữ liệu SKU, warehouse, on-hand, reserved, safety stock, available, allocation, update time qua toàn bộ flow inventory event/sync → calculate available → expose to web → reserve on order → release/confirm. Scenario phải chứa ít nhất một trường hợp oversell, stale cache, multi-warehouse, cancelled order không release, backorder để kiểm cách hệ thống phục hồi, cách UI phản hồi và log cần thiết cho support. Chỉ khi kết quả có thể đối chiếu bằng inventory formula, warehouse mapping, concurrency test, stock reconciliation và các chỉ số oversell, stock freshness, reservation failure, reconciliation mới nên coi lớp này đã đủ điều kiện nghiệm thu.
Ở vòng kiểm triển khai thứ 3 của kho & tồn, đội dự án nên chạy một scenario có dữ liệu SKU, warehouse, on-hand, reserved, safety stock, available, allocation, update time qua toàn bộ flow inventory event/sync → calculate available → expose to web → reserve on order → release/confirm. Scenario phải chứa ít nhất một trường hợp oversell, stale cache, multi-warehouse, cancelled order không release, backorder để kiểm cách hệ thống phục hồi, cách UI phản hồi và log cần thiết cho support. Chỉ khi kết quả có thể đối chiếu bằng inventory formula, warehouse mapping, concurrency test, stock reconciliation và các chỉ số oversell, stock freshness, reservation failure, reconciliation mới nên coi lớp này đã đủ điều kiện nghiệm thu.
Ở vòng kiểm triển khai thứ 4 của kho & tồn, đội dự án nên chạy một scenario có dữ liệu SKU, warehouse, on-hand, reserved, safety stock, available, allocation, update time qua toàn bộ flow inventory event/sync → calculate available → expose to web → reserve on order → release/confirm. Scenario phải chứa ít nhất một trường hợp oversell, stale cache, multi-warehouse, cancelled order không release, backorder để kiểm cách hệ thống phục hồi, cách UI phản hồi và log cần thiết cho support. Chỉ khi kết quả có thể đối chiếu bằng inventory formula, warehouse mapping, concurrency test, stock reconciliation và các chỉ số oversell, stock freshness, reservation failure, reconciliation mới nên coi lớp này đã đủ điều kiện nghiệm thu.
Ở vòng kiểm triển khai thứ 5 của kho & tồn, đội dự án nên chạy một scenario có dữ liệu SKU, warehouse, on-hand, reserved, safety stock, available, allocation, update time qua toàn bộ flow inventory event/sync → calculate available → expose to web → reserve on order → release/confirm. Scenario phải chứa ít nhất một trường hợp oversell, stale cache, multi-warehouse, cancelled order không release, backorder để kiểm cách hệ thống phục hồi, cách UI phản hồi và log cần thiết cho support. Chỉ khi kết quả có thể đối chiếu bằng inventory formula, warehouse mapping, concurrency test, stock reconciliation và các chỉ số oversell, stock freshness, reservation failure, reconciliation mới nên coi lớp này đã đủ điều kiện nghiệm thu.
Ở vòng kiểm triển khai thứ 6 của kho & tồn, đội dự án nên chạy một scenario có dữ liệu SKU, warehouse, on-hand, reserved, safety stock, available, allocation, update time qua toàn bộ flow inventory event/sync → calculate available → expose to web → reserve on order → release/confirm. Scenario phải chứa ít nhất một trường hợp oversell, stale cache, multi-warehouse, cancelled order không release, backorder để kiểm cách hệ thống phục hồi, cách UI phản hồi và log cần thiết cho support. Chỉ khi kết quả có thể đối chiếu bằng inventory formula, warehouse mapping, concurrency test, stock reconciliation và các chỉ số oversell, stock freshness, reservation failure, reconciliation mới nên coi lớp này đã đủ điều kiện nghiệm thu.
Ở vòng kiểm triển khai thứ 7 của kho & tồn, đội dự án nên chạy một scenario có dữ liệu SKU, warehouse, on-hand, reserved, safety stock, available, allocation, update time qua toàn bộ flow inventory event/sync → calculate available → expose to web → reserve on order → release/confirm. Scenario phải chứa ít nhất một trường hợp oversell, stale cache, multi-warehouse, cancelled order không release, backorder để kiểm cách hệ thống phục hồi, cách UI phản hồi và log cần thiết cho support. Chỉ khi kết quả có thể đối chiếu bằng inventory formula, warehouse mapping, concurrency test, stock reconciliation và các chỉ số oversell, stock freshness, reservation failure, reconciliation mới nên coi lớp này đã đủ điều kiện nghiệm thu.
Ở vòng kiểm triển khai thứ 8 của kho & tồn, đội dự án nên chạy một scenario có dữ liệu SKU, warehouse, on-hand, reserved, safety stock, available, allocation, update time qua toàn bộ flow inventory event/sync → calculate available → expose to web → reserve on order → release/confirm. Scenario phải chứa ít nhất một trường hợp oversell, stale cache, multi-warehouse, cancelled order không release, backorder để kiểm cách hệ thống phục hồi, cách UI phản hồi và log cần thiết cho support. Chỉ khi kết quả có thể đối chiếu bằng inventory formula, warehouse mapping, concurrency test, stock reconciliation và các chỉ số oversell, stock freshness, reservation failure, reconciliation mới nên coi lớp này đã đủ điều kiện nghiệm thu.
Ở vòng kiểm triển khai thứ 9 của kho & tồn, đội dự án nên chạy một scenario có dữ liệu SKU, warehouse, on-hand, reserved, safety stock, available, allocation, update time qua toàn bộ flow inventory event/sync → calculate available → expose to web → reserve on order → release/confirm. Scenario phải chứa ít nhất một trường hợp oversell, stale cache, multi-warehouse, cancelled order không release, backorder để kiểm cách hệ thống phục hồi, cách UI phản hồi và log cần thiết cho support. Chỉ khi kết quả có thể đối chiếu bằng inventory formula, warehouse mapping, concurrency test, stock reconciliation và các chỉ số oversell, stock freshness, reservation failure, reconciliation mới nên coi lớp này đã đủ điều kiện nghiệm thu.
Ở vòng kiểm triển khai thứ 10 của kho & tồn, đội dự án nên chạy một scenario có dữ liệu SKU, warehouse, on-hand, reserved, safety stock, available, allocation, update time qua toàn bộ flow inventory event/sync → calculate available → expose to web → reserve on order → release/confirm. Scenario phải chứa ít nhất một trường hợp oversell, stale cache, multi-warehouse, cancelled order không release, backorder để kiểm cách hệ thống phục hồi, cách UI phản hồi và log cần thiết cho support. Chỉ khi kết quả có thể đối chiếu bằng inventory formula, warehouse mapping, concurrency test, stock reconciliation và các chỉ số oversell, stock freshness, reservation failure, reconciliation mới nên coi lớp này đã đủ điều kiện nghiệm thu.
Ở vòng kiểm triển khai thứ 11 của kho & tồn, đội dự án nên chạy một scenario có dữ liệu SKU, warehouse, on-hand, reserved, safety stock, available, allocation, update time qua toàn bộ flow inventory event/sync → calculate available → expose to web → reserve on order → release/confirm. Scenario phải chứa ít nhất một trường hợp oversell, stale cache, multi-warehouse, cancelled order không release, backorder để kiểm cách hệ thống phục hồi, cách UI phản hồi và log cần thiết cho support. Chỉ khi kết quả có thể đối chiếu bằng inventory formula, warehouse mapping, concurrency test, stock reconciliation và các chỉ số oversell, stock freshness, reservation failure, reconciliation mới nên coi lớp này đã đủ điều kiện nghiệm thu.
Ở vòng kiểm triển khai thứ 12 của kho & tồn, đội dự án nên chạy một scenario có dữ liệu SKU, warehouse, on-hand, reserved, safety stock, available, allocation, update time qua toàn bộ flow inventory event/sync → calculate available → expose to web → reserve on order → release/confirm. Scenario phải chứa ít nhất một trường hợp oversell, stale cache, multi-warehouse, cancelled order không release, backorder để kiểm cách hệ thống phục hồi, cách UI phản hồi và log cần thiết cho support. Chỉ khi kết quả có thể đối chiếu bằng inventory formula, warehouse mapping, concurrency test, stock reconciliation và các chỉ số oversell, stock freshness, reservation failure, reconciliation mới nên coi lớp này đã đủ điều kiện nghiệm thu.
Ở vòng kiểm triển khai thứ 13 của kho & tồn, đội dự án nên chạy một scenario có dữ liệu SKU, warehouse, on-hand, reserved, safety stock, available, allocation, update time qua toàn bộ flow inventory event/sync → calculate available → expose to web → reserve on order → release/confirm. Scenario phải chứa ít nhất một trường hợp oversell, stale cache, multi-warehouse, cancelled order không release, backorder để kiểm cách hệ thống phục hồi, cách UI phản hồi và log cần thiết cho support. Chỉ khi kết quả có thể đối chiếu bằng inventory formula, warehouse mapping, concurrency test, stock reconciliation và các chỉ số oversell, stock freshness, reservation failure, reconciliation mới nên coi lớp này đã đủ điều kiện nghiệm thu.
Ở vòng kiểm triển khai thứ 14 của kho & tồn, đội dự án nên chạy một scenario có dữ liệu SKU, warehouse, on-hand, reserved, safety stock, available, allocation, update time qua toàn bộ flow inventory event/sync → calculate available → expose to web → reserve on order → release/confirm. Scenario phải chứa ít nhất một trường hợp oversell, stale cache, multi-warehouse, cancelled order không release, backorder để kiểm cách hệ thống phục hồi, cách UI phản hồi và log cần thiết cho support. Chỉ khi kết quả có thể đối chiếu bằng inventory formula, warehouse mapping, concurrency test, stock reconciliation và các chỉ số oversell, stock freshness, reservation failure, reconciliation mới nên coi lớp này đã đủ điều kiện nghiệm thu.
Checklist nghiệm thu – kho & tồn
Để nghiệm thu kho & tồn, trước hết kiểm business event và source of truth đã được hai phía xác nhận. Sau đó kiểm data contract, auth, idempotency, retry, failure state, privacy, observability và reconciliation. Không pass một mục chỉ vì demo happy path chạy được.
Checklist kho & tồn phải có owner cho mỗi lỗi còn mở và severity. Lỗi có thể tạo duplicate, mất giao dịch, sai quyền hoặc gửi dữ liệu không phù hợp phải chặn go-live. Lỗi cosmetic có thể xử lý sau nếu không ảnh hưởng task và accessibility.
Definition of Done cho kho & tồn cần evidence: inventory formula, warehouse mapping, concurrency test, stock reconciliation; metric vận hành: oversell, stock freshness, reservation failure, reconciliation; và runbook khi dependency lỗi. Ba phần này biến integration từ ‘đoạn code nối hai API’ thành một capability doanh nghiệp có thể vận hành.
Khi xây đồng bộ hệ website, kho & tồn nên được đặt cạnh nhóm tính năng Website, UI/UX & trải nghiệm và kiến trúc nền tảng để tránh tối ưu riêng connector mà bỏ quên task người dùng.