Tái sử dụng MatchingVietnam làm commerce engine

MCV Network không nên duy trì hai luồng mua bán song song. MatchingVietnam đã có module ecommerce, vendor dashboard, product management, cart, checkout và order management hoàn chỉnh hơn, vì vậy MatchingVietnam sẽ trở thành commerce engine cho toàn bộ nghiệp vụ đăng bán, đặt mua, quản lý sản phẩm và storefront.

MCV Business OS tại app.mcv.network đóng vai trò operating back-office: quản trị vận hành, tài chính kế toán, ví, đối soát, compliance, invoice, payout, subscription và dashboard tổng hợp.

Nguyên tắc quyết định

MatchingVietnam là nơi người bán quản lý sản phẩm, tồn kho, storefront, đơn hàng và fulfillment thương mại.
MCV Business OS là nơi kiểm soát ví, ledger, top-up, escrow, payout, chứng từ, hóa đơn, phân quyền, SSO và vận hành nội bộ.
mcv.network là corporate/marketing/SEO/investor site, không xử lý checkout.
Mọi sản phẩm dịch vụ muốn bán public sẽ được publish qua MatchingVietnam.
Business OS chỉ hiển thị dữ liệu commerce đã đồng bộ để vận hành, không tạo thêm một checkout/order engine cạnh tranh.

Ranh giới trách nhiệm

Nghiệp vụ	Hệ thống chủ	Ghi chú
Public storefront	MatchingVietnam	Product listing, category, SEO, detail page
Seller product management	MatchingVietnam	Tái sử dụng vendor/product module của Botble ecommerce
Cart, checkout, order	MatchingVietnam	Người mua đặt hàng tại MatchingVietnam
Vendor dashboard thương mại	MatchingVietnam	Quản lý sản phẩm, đơn, tồn kho, trạng thái fulfillment
SSO và hồ sơ người dùng	MCV Business OS	Identity hub, profile một nơi
Ví, top-up, escrow	MCV Business OS	InfoCMS, Stripe, ledger, reserve/release
Kế toán, invoice, payout	MCV Business OS	MISA meInvoice, chứng từ, đối soát
Admin vận hành MCV	MCV Business OS	Duyệt quyền, tài chính, compliance, thống kê
Marketing corporate	mcv.network	About, roadmap, investor, SEO corporate

Luồng mục tiêu

flowchart LR
  Buyer["Buyer"] --> MV["MatchingVietnam storefront"]
  Seller["Seller / Vendor"] --> MVAdmin["MatchingVietnam vendor dashboard"]
  MVAdmin --> MV
  MV --> Checkout["Cart / Checkout / Order"]
  Checkout --> Order["MatchingVietnam order"]
  Order --> Sync["Order sync / webhook"]
  Sync --> OS["MCV Business OS"]
  OS --> Ledger["Wallet ledger"]
  OS --> Escrow["Escrow reserve / release"]
  OS --> Invoice["Invoice / tax artifact"]
  OS --> Payout["Seller payout"]
  OS --> Admin["MCV admin operations"]

Luồng seller

sequenceDiagram
  participant S as Seller
  participant OS as MCV Business OS
  participant MV as MatchingVietnam
  participant A as MCV Admin

  S->>OS: Đăng nhập SSO / cập nhật profile
  S->>OS: Gửi bằng chứng quyền bán hàng
  A->>OS: Duyệt seller capability
  OS->>MV: Cấp quyền vendor qua SSO/sync
  S->>MV: Quản lý sản phẩm, giá, tồn kho, storefront
  MV-->>OS: Đồng bộ product/order summary phục vụ vận hành

Luồng buyer

sequenceDiagram
  participant B as Buyer
  participant MV as MatchingVietnam
  participant OS as MCV Business OS
  participant Pay as Payment providers

  B->>MV: Xem sản phẩm / dịch vụ / inventory
  B->>MV: Thêm vào giỏ và tạo đơn
  MV->>OS: Gửi order intent / payment request
  OS->>OS: Kiểm tra ví hoặc yêu cầu top-up
  OS->>Pay: Tạo QR/Stripe payment khi cần
  Pay-->>OS: Payment callback
  OS-->>MV: Xác nhận thanh toán / escrow reserved
  MV->>B: Cập nhật trạng thái đơn

Dữ liệu đồng bộ

MatchingVietnam cần gửi về MCV Business OS các nhóm dữ liệu sau:

Product summary: product id, seller id, slug, title, category, type, price, currency, stock, status.
Order lifecycle: order id, buyer, seller, line items, gross amount, currency, status, created/updated timestamps.
Fulfillment events: accepted, shipped/delivered, buyer accepted, cancelled, disputed.
Financial events: payment required, paid, escrow reserved, release requested, refund requested.
Seller store data: store id, owner account, public URL, status.

MCV Business OS cần gửi sang MatchingVietnam:

SSO identity token.
Seller capability status.
Wallet/payment status.
Escrow reserved/released status.
Invoice/payout/compliance status.

Các bước triển khai

Đóng băng phát triển checkout mới trong app.mcv.network.
Chuyển các nút mua public trên mcv.network sang URL sản phẩm/checkout tại MatchingVietnam.
Chuyển seller product management trong Business OS thành link/launcher sang vendor dashboard MatchingVietnam.
Chuẩn hóa SSO: đăng nhập một lần từ MatchingVietnam sang Business OS và ngược lại.
Xây webhook/order sync từ MatchingVietnam về api.mcv.network hoặc app.mcv.network.
Trong Business OS, thay các màn hình order tự xử lý bằng màn hình operations/read-model lấy từ MatchingVietnam.
Gắn wallet, escrow, invoice, payout vào lifecycle order được đồng bộ.
Tắt hoặc ẩn các route legacy của marketplace checkout trong Business OS sau khi dữ liệu đã migrate.

Route định hướng

Người dùng bấm	Điều hướng mới
Buy trên `mcv.network`	MatchingVietnam product detail hoặc checkout
Seller / Products trên Business OS	MatchingVietnam vendor product dashboard
Seller / Orders trên Business OS	Business OS operations view, dữ liệu từ MatchingVietnam
Billing / Top-up	Business OS
Admin / Transactions	Business OS
Admin / Users / Roles	Business OS

Menu tại app.mcv.network được chia lại theo ranh giới hệ thống:

Commerce Engine: link sang MatchingVietnam để quản lý products, orders, vendors và public storefront.
Vận hành MCV: duyệt quyền seller, hồ sơ tuân thủ, đối soát affiliate, thành viên và ngôn ngữ marketing.
Tài chính & kế toán: giao dịch, hợp đồng dịch vụ, ví, subscription, invoice và payout.
Seller trên Matching: vendor dashboard, quản lý sản phẩm, thêm sản phẩm, cấu hình cửa hàng, đơn bán và doanh thu Matching.
Mua hàng trên Matching: storefront, đơn mua và hóa đơn mua hàng.
Dữ liệu legacy: các module guest post, agency service và inventory cũ chỉ dùng để đối chiếu/migrate, không phát triển thêm checkout mới.

Merchant onboarding và eKYC

Khi merchant/customer đăng ký trên MatchingVietnam, MatchingVietnam gọi server-to-server về app.mcv.network/integrations/matching/merchants bằng HMAC. Business OS sẽ tự động tạo hoặc cập nhật user, account, wallet và external source mapping tương ứng.

Luồng kiểm soát spam và eKYC hiện tại:

Form đăng ký customer có honeypot hidden field và timestamp tối thiểu để chặn bot submit tức thì.
Đăng ký customer bị rate limit theo IP + email.
Đăng ký vendor bị rate limit theo IP + customer.
Vendor phải khai tên pháp lý công ty, mã số thuế/số đăng ký kinh doanh và địa chỉ đăng ký.
Nếu bật document verification, vendor bắt buộc upload giấy đăng ký kinh doanh và giấy tờ người đại diện.
Business OS tạo account seller ở trạng thái pending khi eKYC chưa được duyệt, chỉ bật can_sell_products khi vendor đã verified.

Các lớp eKYC nâng cao cần build tiếp:

Kiểm tra domain email tạm, disposable email và IP reputation.
OTP email/phone bắt buộc trước khi submit vendor.
OCR giấy ĐKKD, trích MST/tên pháp lý và đối chiếu với VietQR Business API.
Kiểm tra trùng MST, trùng giấy tờ, trùng số điện thoại và fingerprint thiết bị.
Face match/liveness nếu merchant cá nhân hoặc ngành rủi ro cao.
Risk score để admin ưu tiên duyệt hồ sơ đáng ngờ.

Ghi chú vận hành

Trong giai đoạn chuyển đổi, các module guest post, agency service, software slot đang có trong Business OS được xem là legacy marketplace modules. Chỉ dùng để đối chiếu dữ liệu cũ hoặc migrate sang product/order model của MatchingVietnam. Không mở rộng thêm checkout ở các module này.

Nguyên tắc quyết định​

Ranh giới trách nhiệm​

Luồng mục tiêu​

Luồng seller​

Luồng buyer​

Dữ liệu đồng bộ​

Các bước triển khai​

Route định hướng​

Menu Business OS sau tái cấu trúc​

Merchant onboarding và eKYC​

Ghi chú vận hành​