Tài liệu Developer
BANA là nền tảng Point of Sale thế hệ mới cho hộ kinh doanh và doanh nghiệp nhỏ Việt Nam (F&B, bán lẻ, dịch vụ). Đây là monorepo Bun dựng trên IGNIS Framework (microservice dependency-injection), với app desktop/cầm tay Tauri và stack web React. Mới với sản phẩm? Xem BANA là gì?
Số liệu chuẩn nằm ở Platform Facts
Danh mục dịch vụ, số liệu, dependency stack và messaging seam (Kafka + Debezium CDC, không phải Redis pub/sub) được duy trì ở Platform Facts, tự sinh từ source. Trang này link tới các trang chi tiết - không bao giờ lặp lại version, port hay số đếm.
Bắt đầu
| Hướng dẫn | Bạn sẽ học gì |
|---|---|
| Getting Started | Clone, cài đặt, build, chạy service đầu tiên |
| Hệ thống Build | Target Makefile, đồ thị phụ thuộc, build Docker |
| Tham chiếu Môi trường | Mọi biến môi trường của tất cả service |
| Git Workflow | Nhánh, commit, MR, review code, glab |
| IGNIS Patterns | Phân cấp application, DI, controller factory, pattern model |
Kiến trúc & tham chiếu
| Trang | Nội dung |
|---|---|
| Kiến trúc Hệ thống | Danh mục dịch vụ, chuỗi phụ thuộc, ánh xạ schema, ma trận component |
| Kiến trúc Sự kiện | Kafka event, Debezium CDC, WebSocket topic, HTTP webhook |
| Hướng dẫn Cơ sở Dữ liệu | 14 schema PostgreSQL, Drizzle ORM, quy trình migration |
| Hướng dẫn Testing | Bun test runner, preload mocking, mock factory |
| Bảo mật | Ranh giới tin cậy, xác thực, xử lý PII, hardening |
| Platform Facts | Registry chuẩn, số liệu, dependency stack, version hạ tầng |
Toàn cảnh hệ thống
Topology đầy đủ, đồ thị phụ thuộc và phân cấp Issuer/Verifier: Kiến trúc Hệ thống. Danh mục dịch vụ live: Platform Facts.
Package backend
18 package IGNIS dùng chung @nx/core (base class, 14 schema DB, tiện ích). Danh mục đầy đủ kèm port, vai trò và phụ thuộc: Tổng quan Package Backend.
| Mảng | Package |
|---|---|
| Nền tảng | core |
| Identity & catalog | identity · commerce · search · asset |
| Bán hàng | sale · pricing · inventory |
| Tiền & tuân thủ | payment · finance · ledger · invoice · taxation |
| Platform | signal · outreach · licensing · gateway · helpdesk |
App frontend & tích hợp
| Bề mặt | Ở đâu |
|---|---|
| App frontend (POS, back office, UI kit) | Applications · Frontend Patterns |
| Tích hợp bên thứ ba (thanh toán VNPAY, hóa đơn điện tử, T-VAN) | Integrations |
| Triển khai, cluster, observability | Infrastructure |
Đi tiếp đâu
| Bạn là… | Bắt đầu với |
|---|---|
| Dev backend mới | Getting Started → Core → IGNIS Patterns |
| Dev frontend | Applications → Frontend Patterns |
| SRE / DevOps | Infrastructure → Platform Facts |
| Dev tích hợp | Integrations → Kiến trúc Sự kiện |