BANA

Sales Management Software

Decree 70/2025Bun + HonoVNPAYE2E Encrypted

Next-generation POS platform built for Vietnamese businesses. Decree 70/2025 compliant. Multi-channel. Real-time.

Get Started Developer Docs

55+DB Models

7Schemas

12Services

4Payments

100%Tax Ready

Core Modules

Everything you need to run a modern Vietnamese retail business

📦Products

Catalog management, product variants with SKUs, dynamic pricing engine with rules, fare-based pricing, categories and templates

🛒Orders

Full order lifecycle (draft to completed), cart management with auto-merge, checkout validation, partial payments, refunds and returns

📊Inventory

Multi-location stock tracking, purchase order workflow, 20+ tracking types for audit trail, quantity-on-hand vs available vs reserved

💳Payments

VNPAY QR, NFC card (Phone POS), Smart POS, cash and bank transfer, multi-provider with MQ-Pay orchestration layer

🧾Tax & Invoicing

Real-time e-invoicing via T-VAN and IIAPI, VAT/POS/sale invoice types, digital signatures, complete audit trail

👤Identity

JWT and Basic auth, role-based access (5 levels), employee management, email verification with rate limiting, organizer/merchant mapping

Architecture

Modular microservices built on the IGNIS Framework

Backend Stack

Runtime: Bun (fast, TypeScript-native)
Framework: IGNIS (DI, lifecycle, Hono)
ORM: Drizzle + PostgreSQL
Cache/Queue: Redis + BullMQ
Search: Typesense (CDC sync)
IDs: Snowflake generator

Frontend Stack

Web: React 19 + Vite 7 + TailwindCSS 4
UI: Radix UI + shadcn components
Admin: Redux Toolkit + TanStack
Desktop POS: Tauri 2 (Rust + WebView)
State: ra-core admin framework
i18n: English + Vietnamese

Infrastructure

Events: Redis pub/sub cross-service
WebSocket: ECDH E2E encrypted
Storage: Minio (S3-compatible)
Payments: MQ-Pay multi-provider
Invoicing: T-VAN + IIAPI
Auth: JWT + RBAC (5 roles)

Developer Packages

Backend microservice packages — each independently deployable

@nx/core55 DB models, base classes, auth middleware, Snowflake IDs, soft-delete repository, Zod schemas @nx/identityUser auth (JWT/Basic), sign-up/sign-in, employee management, email verification, RBAC @nx/commerceProduct aggregates, dynamic pricing engine, merchant onboarding, sale channels, categories @nx/saleOrder lifecycle, cart management, checkout, MQ-Pay payment integration, event-driven updates @nx/inventoryMulti-location stock, purchase orders, 20+ tracking types, quantity management, Redis cache @nx/financeWallets (cash/bank/ewallet), income/expense tracking, categories, event-driven transaction recording @nx/paymentPayment orchestration, webhook configs, credential encryption, MQ-Pay bridge, retry dispatch @nx/signalWebSocket service, ECDH-P256 E2E encryption, Redis pub/sub, room messaging, REST API @nx/mq-payVNPAY QR/NFC/Smart POS, transaction lifecycle, BullMQ queues, auto-expiration, IPN handling @nx/searchTypesense integration, CDC real-time sync, filter conversion, multi-collection registry

Frontend Applications

React 19 apps with shared UI kit and core utilities

Admin Client

28-screen dashboard: products, orders, inventory, finance, invoices, settings. Redux + TanStack.

Back Office

Simplified admin for merchant/organizer management. 5 screens, same stack.

POS Desktop

Tauri 2 app with Rust backend, barcode scanning, USB peripherals, offline-capable SQLite.

Quick Navigation

📖 System Overview 🧩 All Modules 👨‍💻 Developer Guide 🔌 Integrations

Bun • Hono • PostgreSQL • Drizzle • Redis • React • Tauri • Typesense • Minio