Cấu trúc tài liệu

Tài liệu được chia thành 3 phần chính, tương ứng với kiến trúc hệ thống Bot Bán Hàng.

Apps

Mô tả API nghiệp vụ của các ứng dụng trong hệ thống (Business Logic). Mỗi app là một service độc lập xử lý một nhóm nghiệp vụ cụ thể.

• Schema / Interface — Cấu trúc dữ liệu đầu vào, đầu ra của từng API
• Endpoints — Danh sách API và cách sử dụng
• Business Rules — Luồng xử lý và quy tắc nghiệp vụ

Ví dụ: api_oms quản lý đơn hàng, sản phẩm, tồn kho, giao vận.

Services

Mô tả các dịch vụ tích hợp hệ thống — những module kết nối với bên thứ ba hoặc cung cấp dịch vụ dùng chung cho nhiều app.

• Payment — Cổng thanh toán đa nền tảng (MoMo, ZaloPay, VNPay, Stripe...)
• Delivery — Tích hợp đơn vị vận chuyển (GHN, GHTK, J&T...)

Mỗi service có API riêng để các App trong hệ thống gọi tới.

Component UI

Thư viện component giao diện dùng chung cho các ứng dụng frontend trong hệ sinh thái Bot Bán Hàng.

• Component View — Các component hiển thị (bảng, form, card...)
• Core Component — Các component nền tảng (layout, navigation, theme...)