Kiến Trúc Business OS

MCV Business OS gom các sản phẩm của MCV vào một portal thống nhất tại app.mcv.network, trong khi các domain sản phẩm vẫn giữ vai trò marketing, SEO và lead generation.

Bản Đồ Domain

Domain	Vai trò
mcv.network	Corporate, investor profile, SEO, About, roadmap
app.mcv.network	Unified Business OS portal
docs.mcv.network	Documentation và runbook
api.mcv.network	API gateway, webhook, partner integrations
status.mcv.network	Uptime, incident và service health
matchingvietnam.com	Market Access product site
zenify.cx	WordPress marketing site cho AI CRM
web.zenify.cx	Zenify CRM product app cho khách hàng
vinecom.net	Agentic AI product site

Phase 1 Scope

Phase 1 tập trung vào nền móng dữ liệu và vận hành:

• Chuẩn hóa app.mcv.network thành portal thống nhất thay cho app.mcv.network.
• Tạo lớp dữ liệu Market Access trong Laravel core.
• Đồng bộ supplier, product, category và inquiry từ MatchingVietnam.
• Giữ MatchingVietnam như source system, không trộn Botble CMS vào core portal.
• Cập nhật docs để mọi thay đổi kiến trúc có lịch sử rõ ràng.

Phase 2 Scope

Phase 2 chuyển MatchingVietnam thành public storefront + SEO:

• Vendor/customer dashboard trên MatchingVietnam handoff sang app.mcv.network.
• SSO dùng signed payload HMAC, TTL ngắn, không chia sẻ password giữa hai hệ thống.
• MatchingVietnam tiếp tục giữ catalog/product/storefront và SEO traffic.
• Business OS trở thành nơi quản trị tài khoản, ví, marketplace, affiliate, service và vận hành seller.

Phase 3 Scope

Phase 3 hoàn thiện Billing OS cho hợp đồng dịch vụ/subscription:

• Admin tạo hợp đồng B2B, setup fee, lịch thu định kỳ và billing email.
• Business OS sinh từng billing cycle với ageing, reminder count và trạng thái paid/due/overdue.
• Khách hàng tạo QR Pay cho từng kỳ dịch vụ bằng InfoCMS.
• Admin có dashboard công nợ, lọc/search, tạo QR, gửi reminder thủ công và đánh dấu đã thu.
• Automation gửi reminder theo mốc 7 ngày trước hạn, đúng hạn, quá hạn 3/7/15 ngày.
• Callback InfoCMS tự đánh dấu billing cycle paid và gửi email xác nhận cho khách hàng/admin.

Phase 4 Scope

Phase 4 chuẩn hóa Publisher, Vendor và Agency thành một workspace Seller thống nhất:

• Một Account có thể vừa mua vừa bán, không bị khóa bởi role cứng.
• Quyền bán được mô hình hóa bằng capability: can_sell_products, can_sell_inventory, can_sell_services, can_manage_storefronts.
• MatchingVietnam tiếp tục là storefront public + SEO cho Market Access, nhưng module sản phẩm được dùng như catalog gốc cho Business OS.
• Seller có thể đăng bán sản phẩm vật lý, sản phẩm phi vật lý, dịch vụ, media inventory, affiliate offer và quản lý đơn hàng từ app.mcv.network.
• Business OS giữ ví, escrow, compliance, billing, notification và báo cáo vận hành.

Storefront Strategy

Storefront	Dùng cho	Runtime
MCV marketplace storefront	Listing trực tiếp trong app và marketplace chung	Laravel Business OS
MatchingVietnam storefront	Sản phẩm Market Access, SEO và lead xuất khẩu	Botble Laravel
WordPress domain riêng	Landing page/SEO/brand site riêng cho Seller	WordPress managed site

Website WordPress domain riêng lấy pattern từ pkthientam.com: hero có CTA rõ, trust metrics, logo/proof strip, section giới thiệu, danh mục dịch vụ/sản phẩm, lý do tin tưởng, đội ngũ/case proof, testimonial, form lead và footer đầy đủ. WordPress chỉ phục vụ content/SEO/conversion; đơn hàng, ví, thanh toán, compliance và billing vẫn quay về Business OS.

Zenify As Merchant

Zenify được mô hình hóa như một merchant trong MCV Business OS:

• zenify.cx làm marketing/SEO và điều hướng khách vào CRM.
• web.zenify.cx xử lý trải nghiệm CRM, workspace và trial/signup.
• Mỗi signup từ Zenify gọi webhook POST /integrations/zenify/signups về Business OS bằng HMAC.
• Business OS tạo hoặc cập nhật User, customer Account, Zenify merchant account và ServiceContract.
• Billing, reminder, QR Pay, profile và quyền truy cập dài hạn được quản trị tại app.mcv.network.

Chi tiết triển khai nằm ở trang Zenify Merchant OS.

Kiến Trúc Ưu Tiên PHP/Laravel

flowchart LR
    MCV["mcv.network<br/>Corporate + SEO"]
    App["app.mcv.network<br/>Laravel Business OS"]
    API["api.mcv.network<br/>API Gateway"]
    Docs["docs.mcv.network<br/>Docusaurus"]
    Status["status.mcv.network<br/>Status Page"]
    Matching["matchingvietnam.com<br/>Botble Laravel"]
    Zenify["zenify.cx<br/>WordPress Marketing"]
    ZenifyApp["web.zenify.cx<br/>CRM App"]
    ZenifyMerchant["Zenify merchant account<br/>Billing + entitlement"]
    Vinecom["vinecom.net<br/>Agentic AI Product Site"]

    MCV --> App
    Matching --> App
    Zenify --> App
    ZenifyApp --> App
    ZenifyApp --> ZenifyMerchant
    ZenifyMerchant --> App
    Vinecom --> App
    App --> API
    API --> App
    App --> Docs
    API --> Status
    App --> Status

Data Store

Production Business OS dùng PostgreSQL làm database chính cho app.mcv.network.

• SQLite chỉ dùng cho local development hoặc backup lịch sử trước migration.
• PostgreSQL là nguồn dữ liệu production cho user, account, wallet, billing, marketplace, affiliate, subscription và integration mapping.
• Các workflow có ghi tiền hoặc callback ngân hàng phải chạy trên PostgreSQL để tránh lỗi file permission, write lock và giới hạn concurrent write của SQLite.
• Backup production cần ưu tiên pg_dump/database snapshot; không còn dựa vào copy database.sqlite.

Microservices Direction

Laravel vẫn là ưu tiên chính, nhưng tách module theo boundary rõ ràng để có thể nâng cấp thành microservices khi tải tăng:

Service Boundary	Phase 1	Future Split
Identity & Account	Laravel module	Auth service
Wallet & Billing	Laravel module	Ledger/payment service
Seller Commerce	Laravel module + MatchingVietnam adapter	Catalog/order service
Marketplace	Laravel module	Marketplace service
Affiliate	Laravel module	Tracking/conversion service
Market Access	Laravel module + sync adapter	Catalog/lead service
Notification	Laravel mail service	Email/SMS event service
API Gateway	Laravel routes/proxy	Dedicated gateway

Nguyên tắc: tách bằng database table, service class, command và API contract trước; chỉ tách runtime/deploy sau khi có nhu cầu thật.

English Summary

MCV Business OS uses app.mcv.network as the unified Laravel portal, while product domains remain focused on marketing and acquisition. zenify.cx is the WordPress marketing surface, while web.zenify.cx remains the CRM product app and connects back to Business OS for SSO, customer master data, subscription and billing entitlement. Phase 1 creates the Market Access data layer, Phase 2 connects MatchingVietnam through SSO, Phase 3 turns service contracts and recurring billing into an operational Billing OS, and Phase 4 unifies Publisher, Vendor, and Agency into Seller Commerce with Laravel, MatchingVietnam, and WordPress storefront options.