Thiết kế theo module
24 domain API được tổ chức độc lập trong modular monolith; web có workspace riêng cho từng phòng ban và có thể tách dịch vụ theo tải hoặc ranh giới nghiệp vụ.
NestJS modules · Next.js workspaces · 28 migrations
BLUEPRINTAS-BUILT · v1.1MEGA ONE · BLUEPRINT HỆ THỐNG HIỆN TẠIMột nền tảng vận hành.
Một nền tảng vận hành.
Mười bốn không gian nghiệp vụ.
Blueprint này mô tả đúng phần mềm đang hiện diện trên production: kiến trúc, ranh giới module, dữ liệu dùng chung, API, quyền, luồng liên phòng ban và điều kiện kích hoạt các kết nối bên ngoài.
Production đã xác minhRelease 20260821T170459ZChốt ngày 22/08/2026
01 · TÓM TẮT ĐIỀU HÀNH
One PlatformMEGA ONE hiện là gì?
One Data
MEGA ONE không còn là website giới thiệu hoặc một bảng tác vụ dùng chung.
Đây là modular monolith vận hành doanh nghiệp, có 14 workspace phòng ban, cổng đối tác/học viên/tuyển dụng, API phiên bản hóa, dữ liệu PostgreSQL và kho file MinIO.
Đã triển khai
Có giao diện, API và dữ liệu/domain tương ứng.
Sẵn sàng cấu hình
Có adapter/feature flag, chờ credential hoặc sandbox.
Không mô phỏng production
Thiếu điều kiện thì connector tiếp tục khóa.
02 · ĐỊNH HƯỚNG KIẾN TRÚC
Sáu nguyên tắc đã được hiện thực
Nguyên tắc được chứng minh bằng cấu trúc hệ thống, không chỉ là tuyên bố thiết kế.
Ưu tiên cấu hình
Workflow, trạng thái, hạn mức duyệt, chính sách giá, thuế, lương, SLA, ca làm và feature flag được quản lý theo dữ liệu và ngày hiệu lực.
Master Data · Effective date · Workflow designerKhông phụ thuộc cơ cấu hiện tại
Pháp nhân, chi nhánh, phòng ban, chức danh và người dùng là dữ liệu gốc; tên hiện tại không được nhúng cứng vào logic nghiệp vụ.
Legal Entity · Branch · Department · EmployeeOne Data & phân quyền
Customer/Site, Product/Model, Serial/Lot, Employee, Partner và Warehouse được dùng xuyên module; phạm vi quyền kết hợp vai trò, đơn vị và dữ liệu.
Role · Department · Branch · Legal Entity · Data ScopeSẵn sàng tích hợp
API v1, integration outbox, webhook, idempotency, optimistic version và dead-letter queue tạo nền cho AMIS, ngân hàng, kênh Marketing và AI.
372 API paths · 118 schemas · Event outboxCó thể tiếp quản lâu dài
Source code, migration, Docker Compose, OpenAPI, cấu hình, backup và Blueprint As-built được quản lý như các thành phần bàn giao bắt buộc.
Source · Database · API · Deployment · Runbook03 · KIẾN TRÚC KỸ THUẬT AS-BUILT
Modular monolith có đường mở rộng rõ ràng
Mỗi lớp có trách nhiệm và ranh giới riêng; trao đổi nội bộ qua API/event thay vì cập nhật chéo dữ liệu.
01Lớp trải nghiệmNgười dùng và đối tác
Next.js Web
Mobile chuyên biệt
Cổng bên ngoài
Cộng tác02Lớp nghiệp vụAPI phiên bản hóa
03Lõi dùng chungOne Data & kiểm soát
Authentication & RBACMaster DataWorkflowAuditNotificationIdempotencyIntegration Outbox
04Dữ liệu & hạ tầngTriển khai production
PostgreSQL 17332 bảng chuẩn hóa
MinIO / S3Media và chứng từ
Docker ComposeAPI · Web · DB · Storage
Nginx & TLSmegaone.metaflow.vn
Quyết định kiến trúc:Giữ một backend để giao dịch xuyên module nhất quán; ranh giới service/controller/DTO/table/event cho phép tách dịch vụ khi tải hoặc ownership thực tế yêu cầu.
04 · DANH MỤC ỨNG DỤNG
Mỗi phòng ban là một workspace riêng
Dashboard, Kanban, timeline, lịch, bản đồ và workbench được dùng theo đúng nghiệp vụ; không ép mọi tính năng vào cùng một kiểu bảng.
Ban điều hành
Đã triển khaiĐiều hành
Trung tâm chỉ huy, mục tiêu toàn doanh nghiệp, kế hoạch và phê duyệt liên phòng ban.
- Mục tiêu doanh nghiệp
- Phê duyệt liên phòng ban
- Cảnh báo & rủi ro
- Quyết định & hành động
Kinh doanh
Đã triển khaiKinh doanh
Mục tiêu, kế hoạch, hoạt động thị trường, Clinic 360 và doanh thu trên cùng một không gian.
- Lead đa kênh
- Customer 360°
- Pipeline & báo giá
- Đi thị trường & GPS
Marketing
Đã triển khaiMarketing
Chiến lược, chiến dịch, nội dung, đa kênh, Lead, sự kiện và ROI trên một hành trình có kiểm soát.
- Mục tiêu thương hiệu
- Campaign & Content Studio
- DAM & xuất bản
- Lead & attribution
Hỗ trợ lâm sàng
Đã triển khaiHỗ trợ lâm sàng
Điều phối chuyên gia, Demo lâm sàng, biên bản và hỗ trợ ứng dụng.
- Hộp case
- Demo & lắp đặt
- Đào tạo khách hàng
- Tri thức chuyên môn
Kỹ thuật & Bảo hành
Đã triển khaiKỹ thuật hiện trường
Điều hành dịch vụ hiện trường, bảo hành và bảo trì theo Customer · Site · Serial.
- Điều phối kỹ sư
- Thiết bị 360°
- Work Order
- Bảo trì & bảo hành
Kho & Thiết bị
Đã triển khaiKho
Sổ kho vận hành gốc: Lot-Date, Serial, FEFO/FIFO và luồng duyệt xuyên Kho Thủ Đức – Bình Dương.
- Nhập–xuất–chuyển
- FEFO/FIFO
- Lot/Serial
- Kiểm kê & rủi ro
Giao nhận
Đã triển khaiGiao nhận
Điều phối chuyến, giao–nhận thiết bị, POD và biên bản bàn giao.
- Điều phối chuyến
- Tuyến & điểm giao
- POD
- Hàng hoàn & đối soát
Tài chính & Kế toán
Đã triển khaiTài chính & Kế toán
Sổ phụ vận hành, hóa đơn, công nợ, ngân quỹ, thuế và đối soát AMIS có kiểm soát.
- Hóa đơn & công nợ
- Đề nghị chi
- Ngân hàng & đối soát
- Khóa kỳ & thuế
Mua hàng trong nước
Đã triển khaiMua hàng trong nước
PR, RFQ, so sánh nhà cung cấp, PO, nhận hàng và đối chiếu công nợ.
- PR & kế hoạch mua
- RFQ & so sánh giá
- PO hàng hóa/dịch vụ
- Nghiệm thu & đối chiếu
Mua hàng quốc tế
Đã triển khaiMua hàng quốc tế
Nhu cầu nhập, RFQ quốc tế, PO/PI, tiến độ sản xuất, thanh toán và bàn giao XNK.
- Nhu cầu nhập
- RFQ quốc tế
- PO/PI/Hợp đồng
- Tiến độ & thanh toán
Xuất nhập khẩu
Đã triển khaiXuất nhập khẩu
Control Tower cho booking, shipment, chứng từ, khai báo, landed cost và phối hợp nhập kho.
- Shipment & booking
- Bộ chứng từ
- Hải quan
- Landed cost
Học viện
Đã triển khaiHọc viện MegaVet
Khóa học, lớp, học viên, tri thức sản phẩm và chứng nhận.
- Course Builder
- Lớp & MEGA Meeting
- Học phí & SePay
- Chứng nhận & QR
Nhân sự
Đã triển khaiNhân sự
Hệ điều hành nhân sự: tuyển–dùng–phát triển–giữ chân, chấm công, lương và tuân thủ trên một dữ liệu gốc.
- Hồ sơ & tổ chức
- Tuyển dụng
- Chấm công & lương
- Hiệu suất & tuân thủ
IT & Quản trị nền tảng
Sẵn sàng mở rộngQuản trị nền tảng
User, Role, Master Data, Workflow, API, audit, backup và tích hợp.
- Service Desk
- RBAC & Master Data
- Integration Health
- Backup & audit
05 · LUỒNG LIÊN PHÒNG BAN
Dữ liệu đi theo chuỗi giá trị
Module nguồn phát event; module đích ghi vào dữ liệu của chính mình và giữ tham chiếu để truy vết.
Từ nhu cầu thị trường đến thu tiền
Marketing→Sales→Kho→Giao nhận→Application / Kỹ thuật→Finance→Sau bán
Từ nhập khẩu đến tồn sẵn sàng bán
Mua hàng quốc tế→Xuất nhập khẩu→Kho→Finance→Sales
Từ nhu cầu mua đến thanh toán
Phòng ban→Mua hàng trong nước→Nhà cung cấp→Kho / Nghiệm thu→Finance
Từ nhân sự mới đến cấp quyền
HR→Platform→Quản lý→Academy→Offboarding & thu hồi
Quy tắc bắt buộcKhông cho module A cập nhật trực tiếp bảng nghiệp vụ của module B.Mỗi event có reference, version, retry và audit.Lỗi vượt ngưỡng chuyển dead-letter để có owner xử lý.
06 · ONE DATA & PHÂN QUYỀN
Một định danh, nhiều ngữ cảnh nghiệp vụ
Master Data được tái sử dụng xuyên module; mỗi app chỉ sở hữu phần giao dịch thuộc domain của mình.
ONEDATANguồn dữ liệu thống nhất
ACCESS DECISION
Ai được làm gì với dữ liệu nào?
Role×Department×Branch×Legal Entity×Data Scope
- Nhân viên: dữ liệu được giao hoặc dữ liệu của mình.
- Quản lý: đội ngũ và chi nhánh thuộc phạm vi.
- Vai trò nhạy cảm: lương, giá vốn, ngân hàng, GPS và export cấp riêng.
- Đối tác: chỉ hồ sơ thuộc đúng tổ chức và lời mời.
07 · API & TÍCH HỢP
API-first, production có điều kiện
Connector chỉ được bật sau khi MegaVet cung cấp license, credential, sandbox, chính sách dữ liệu và người phê duyệt.
Tích hợp nội bộ MEGA ONEOutbox, webhook, retry, dead-letter và notification giữa các domainĐang hoạt động
PostgreSQL & MinIO/S3Dữ liệu giao dịch, media, bằng chứng, tài liệu và URL tải có kiểm soátĐang hoạt động
MapLibre & MEGA MeetingBản đồ nghiệp vụ; phòng họp nội bộ không phụ thuộc link bên ngoàiĐang hoạt động
AMIS · meInvoice · BankHub · Ngân hàngBút toán, hóa đơn điện tử, sao kê, đối soát và lệnh thanh toánChờ credential production
Meta · Instagram · Zalo OA · Google/TikTok AdsInbox, xuất bản, quảng cáo, webhook và performanceChờ app review/credential
SePay · MISA KYSO · VNPT SmartCAHọc phí, webhook thanh toán và ký chứng nhậnChờ kích hoạt production
Forwarder/Customs APIGửi bộ hồ sơ và nhận số tờ khai, phân luồng, thuế, biên nhậnChờ sandbox đối tác
08 · BẢO MẬT & VẬN HÀNH
Kiểm soát nằm trong luồng nghiệp vụ
Bảo mật không chỉ là đăng nhập; quyền, lịch sử, chống trùng và rollback phải đi cùng từng giao dịch.
Phân quyền theo phạm vi
Role–Department–Branch–Legal Entity–Data Scope; guard riêng theo domain.
Audit và phiên bản
Ghi actor, thời gian, nguồn, thay đổi trước/sau; dữ liệu đã khóa không sửa trực tiếp.
Chống ghi nhận trùng
Idempotency key, external reference, optimistic version và kiểm soát replay webhook.
Bảo vệ file
Object storage tách database; checksum, version và thiết kế URL ký thời hạn ngắn.
Khôi phục có kiểm soát
Backup database trước release, health check trước chuyển phiên bản và khả năng rollback.
Feature flag connector
Kết nối ngoài mặc định tắt đến khi có license, sandbox, credential và người duyệt.
PRODUCTION TOPOLOGYmegaone.metaflow.vn
Nginx/TLS→Next.js :3100→NestJS :4000→PostgreSQL + MinIO
Release bất biến · health check · database backup trước deploy · symlink rollback09 · KIỂM THỬ, NGHIỆM THU & BÀN GIAO
Blueprint phải truy ngược được bằng chứng
Không dùng việc “có màn hình” làm bằng chứng hoàn thành một luồng nghiệp vụ.
Chất lượng mã nguồn
- Typecheck toàn workspace
- Build production
- Test Web/API/domain
- Không có route lỗi sau basePath
UAT nghiệp vụ
- Luồng đầu–cuối theo phòng ban
- Phê duyệt và phân quyền
- Retry, offline và xung đột
- Truy ngược dữ liệu nguồn
Migration & đối soát
- Staging có sourceRef/checksum
- Dedupe và xử lý ngoại lệ
- Đối soát số lượng/tổng tiền
- Owner nghiệp vụ ký xác nhận
Bàn giao tiếp quản
- Source code và migration
- OpenAPI và cấu hình
- Docker/deployment/runbook
- Backup/restore và audit
KHẢO SÁT30/30phiếu hoàn thành
→YÊU CẦU1.183requirement items
→TRACEABILITY1.183liên kết tính năng/UAT
→NGHIỆM THU1đợt tích hợp toàn hệ thống
Nguyên tắc chốt Blueprint
Nội dung “đã triển khai” phải có bằng chứng trong source, database, API hoặc production. Nội dung phụ thuộc nhà cung cấp được giữ ở trạng thái sẵn sàng cấu hình cho đến khi kiểm thử production hợp lệ.