Dự án khách hàng
MBL
Hệ thống vận hành cửa hàng và phân phối nội dung số
01
Tổng quan dự án
Đang vận hành08/2026 – nay
Hai hệ thống cho cùng một khách hàng, chạy chung một VPS: hệ bán hàng tại cửa hàng và hệ link tải nội dung số cho các máy game Unity. Mình làm một mình; cả hai hệ đang vận hành thật và vẫn được hoàn thiện.
02
Bối cảnh và bài toán
Khách hàng cần hai thứ. Thứ nhất là hệ bán hàng tại cửa hàng, nơi nhân viên tư vấn, thu ngân và quản trị viên cùng làm việc trên đơn hàng, tồn kho và doanh thu. Điểm khó nằm ở khâu phối hợp: khách không phải xách hàng đi vòng cửa hàng, nhân viên tư vấn không phải rời khách để đi lấy hàng, và món hàng cuối cùng không được hứa cho hai người. Thứ hai là hệ link tải nội dung số cho các máy game Unity đặt tại chỗ.
03
Phạm vi và yêu cầu
- Hệ bán hàng, nhân viên tư vấn (điện thoại): nhập mã của khách để mở giỏ hàng, tìm sản phẩm, xem tồn kho, thêm vào giỏ, ghi chú và gửi đơn.
- Hệ bán hàng, thu ngân (máy bàn): xem các giỏ đang mở, lấy hàng thật, thêm hoặc bớt nếu khách đổi ý, rồi xác nhận đã thu tiền hoặc huỷ giỏ.
- Hệ bán hàng, quản trị viên (máy bàn): quản lý sản phẩm và tồn kho, xem doanh thu, số đơn theo trạng thái và năng suất của từng nhân viên.
- Hệ link tải: máy game hiển thị một mã ngắn kèm QR, người chơi mở liên kết trên điện thoại để tải nhạc hoặc ảnh; có dashboard thống kê lượt tải.
- Yêu cầu được chốt dần thành một danh sách quyết định, ghi lại kèm lý do, để người làm tiếp không phải đoán.
04
Vai trò và trách nhiệm của mình
Mình làm một mình: lắng nghe và làm rõ yêu cầu, viết kế hoạch, điều phối ứng dụng AI triển khai, rồi thẩm định và nghiệm thu.
Phần AI hỗ trợ. Ứng dụng AI viết phần lớn mã theo kế hoạch mình đã duyệt. Mình chịu trách nhiệm về yêu cầu, phương án, review, kiểm thử, nghiệm thu, bảo mật và bàn giao.
05
Luồng nghiệp vụ
Điện thoại
Nhân viên tư vấn
- Nhận mã (số thứ tự) của khách
- Mở giỏ hàng theo mã
- Tìm sản phẩm, xem tồn kho, thêm vào giỏ
- Ghi chú và gửi đơn
Hàng được giữ trong kho ngay khi thêm vào giỏ.
Máy bàn
Thu ngân
- Thấy giỏ vừa được gửi
- Lấy hàng thật theo giỏ; thêm hoặc bớt nếu khách đổi ý
- Xác nhận đã thu tiền, hoặc huỷ giỏ
Xác nhận thì trừ kho; huỷ thì nhả lại hàng đã giữ.
Máy bàn
Quản trị viên
- Xem doanh thu và số đơn theo trạng thái
- Quản lý sản phẩm và tồn kho
- Xem năng suất của từng nhân viên
06
Phân tích hệ thống
Vai trò và phân quyền
Điện thoại
Nhân viên tư vấn
Tạo giỏ, thêm hoặc bớt sản phẩm, ghi chú, gửi đơn.
Máy bàn
Thu ngân
Xem mọi giỏ, thêm hoặc bớt sản phẩm, xác nhận đã thu tiền, huỷ giỏ.
Máy bàn
Quản trị viên
Quản lý sản phẩm và tồn kho, xem doanh thu và năng suất nhân viên.
- Hai hệ thống tách riêng nhưng chạy chung một VPS: backend NestJS với Prisma và PostgreSQL, chạy bằng Docker Compose phía sau Nginx; dashboard viết bằng React và Vite.
- Các vai của hệ bán hàng dùng chung một backend; màn hình hiển thị theo vai của người đăng nhập, không theo tên miền.
- Luồng dữ liệu chính của hệ bán hàng: giỏ hàng, giữ hàng trong kho, xác nhận thu tiền (trừ kho) hoặc huỷ (nhả hàng), sổ cái sự kiện của đơn, rồi báo cáo doanh thu và năng suất.
07
Quyết định và đánh đổi
Giữ hàng ngay khi thêm vào giỏ, giữ đến khi thu ngân xác nhận hoặc huỷ
- Lý do
- Để hai khách không cùng mua được món cuối cùng: khách không bị hứa rồi tới quầy mới biết hết hàng.
- Giới hạn
- Giỏ bị bỏ quên sẽ giữ hàng không ai mua, nên cần cách để thu ngân hoặc quản trị viên thấy và nhả các giỏ treo quá lâu.
Ghi người tạo giỏ và người thêm từng dòng; chỉ quản trị viên xem
- Lý do
- Một giỏ có thể qua nhiều tay (nhân viên tư vấn, thu ngân, đổi ca). Có dữ liệu ở mức từng dòng thì sau này đổi cách tính thưởng chỉ cần đổi truy vấn, không phải đổi dữ liệu.
- Giới hạn
- Cách tính thưởng cuối cùng là quyết định vận hành của cửa hàng, không phải quyết định kỹ thuật.
Doanh thu cộng từ sổ cái sự kiện của đơn, không cộng trực tiếp trên đơn
- Lý do
- Một đơn có thể được xác nhận rồi trả lại, rồi xác nhận lại nhiều vòng. Cộng trên đơn thì không còn biết tiền đã đi thế nào, và khoản trả lại sẽ trừ nhầm vào ngày hôm sau.
Tách hai hệ thống, chỉ dùng chung máy chủ
- Lý do
- Mỗi hệ có mã nguồn, cơ sở dữ liệu và cấu hình riêng để triển khai hệ này không làm hệ kia khởi động lại.
- Giới hạn
- Phải vận hành hai bộ cấu hình và hai lịch sao lưu thay vì một.
Thêm tên miền thứ hai làm phương án dự phòng DNS
- Lý do
- Ngày 29/09/2026 nhà cung cấp DNS gặp sự cố; tên miền thứ hai, thêm qua Cloudflare, giúp hệ thống tiếp tục phục vụ mà không phải sửa mã.
- Giới hạn
- Hai tên miền chạy song song, nên có thêm một thứ phải theo dõi.
08
Kiểm thử và nghiệm thu
- Có bộ kiểm thử tự động cho các nghiệp vụ chính (xác thực, đơn hàng, kho, báo cáo) và các phép kiểm hợp đồng giao diện.
- Yêu cầu của khách hàng được chốt thành một danh sách quyết định đã đóng, không còn câu hỏi treo, trước khi đưa vào vận hành; đó là cơ sở để đối chiếu khi nghiệm thu.
09
Kết quả đã xác minh
- Cả hai hệ thống đang vận hành thật (từ tháng 08/2026) và vẫn được hoàn thiện.
- Có tài liệu bàn giao cho người làm tiếp.
- Ngày 29/09/2026 nhà cung cấp DNS gặp sự cố; hệ thống tiếp tục phục vụ nhờ thêm tên miền thứ hai qua Cloudflare, không phải đổi mã.
10
Công nghệ
- NestJS
- Prisma
- PostgreSQL
- React
- Vite
- Docker
- Nginx
- Cloudflare