Modules Overview

BANA is built with a modular architecture — use only what you need, scale when you grow.

System Architecture

Core Modules Phase A

Essential features for sales management, tax compliance, and business operations.

#	Module	Description	Phase	Priority
1	User Management	Accounts, authentication (JWT + OTP), role-scoped access	P1-P2	HIGH
2	Permissions	Casbin RBAC — roles, permissions, grants, scoped access	P1-P2	HIGH
3	Commerce	Organization + Merchant + Sale Channels + Categories	P1-P2	HIGH
4	Device	POS terminals, mobile apps, peripherals	P1-P3	HIGH
5	Product	Catalog — products, variants, pricing, categories, identifiers	P1-P3	HIGH
6	Inventory	Stock tracking, purchase orders, materials (BOM), tickets	P1-P3	HIGH
7	Orders	Sale lifecycle — cart, checkout, kitchen, POS sessions, reservations	P1-P2	HIGH
8	Payment & Transaction	Payment webhooks, finance wallets, transaction ledger	P1-P2	HIGH
9	CRM	Customer profiles, loyalty points, subscribers, inquiries	P1-P3	MEDIUM
10	Tax & Invoice	E-invoicing, VNPAY IIAPI, T-VAN, buyer self-service claims	P1	HIGH
11	Reports	POS session reports (X/Z), sales analytics, category breakdown	P1-P3	MEDIUM
12	Expenses	Finance wallets, income/expense tracking, auto-transactions	P1-P2	MEDIUM

Core Module Groups

ACCESS CONTROL          BUSINESS STRUCTURE       CATALOG
├── User Management     ├── Commerce             ├── Product
└── Permissions         └── Device               └── Inventory

SALES FLOW              COMPLIANCE & REPORTING
├── Orders              ├── Tax & Invoice
├── Payment             ├── Reports
└── CRM                 └── Expenses

Extended Modules Phase B

Advanced features for business growth and customer engagement.

Module	Description	Depends on
Loyalty	Customer loyalty programs, tiers, rewards	CRM, Orders
Marketing	Marketing automation, campaigns	CRM
Campaign	Promotional campaigns, discount rules	Product, Orders
AI Features	AI-powered insights, forecasting	Reports, All data
Webshop	Online store builder	Product, Orders, Payment

Industry Solutions Phase C

Specialized features for specific business sectors.

Solution	Description	Key Differentiator
Retail	Multi-channel retail	Barcode-heavy, inventory focus, multi-location
F&B	Food & Beverage	Kitchen tickets, recipes (BOM), table management
Services	Personal services	Appointment booking, staff scheduling
Hospitality	Hotels & Accommodation	Room management, reservations, check-in/out
Pharmacy	Pharmaceutical retail	Batch/lot tracking, expiry management, regulations
Production	Small manufacturing	BOM, production orders, material consumption

Use Cases

Use Case	Description
POS	Point-of-sale operations
Sample Data	Demo data for testing

How Modules Connect

Getting Started

1. Start here → Core Modules for essential functionality
2. Grow → Extended Modules for loyalty, marketing, AI
3. Specialize → Industry Solutions for your business sector