🛒 B9POS - Multi-Variant Point of Sale Management System
A comprehensive, production-ready cloud-based Point of Sale Management System built with FastAPI 0.115.5 backend and Next.js 16.1.1 frontend. Supports multiple POS variants: Restaurant POS, Super Shop POS, Hardware POS, and Sanitary POS. Features 39+ modules, 150+ API endpoints, dealer-to-shopkeeper ordering ecosystem, real-time inventory, POS billing, finance & accounting, comprehensive reporting, and complete business management.
Backend Architecture
FastAPI Primary Engine
Ultra-fast asynchronous API engine with high-performance async operations, RESTful API design, automatic API documentation (OpenAPI/Swagger), and type-safe request/response handling
Flask Microservices
Service layer with Flask for microservices architecture, modular service design, independent service scaling, and service-to-service communication
Microservice Architecture
Scalable microservices-based architecture pattern with independent service deployment, service discovery, load balancing, fault tolerance, and resilience
Layered Architecture
Domain Layer (business logic), Application Layer (use cases), Infrastructure Layer (data access), and API Layer (HTTP endpoints)
Asynchronous Processing
High-performance async operations with non-blocking I/O, concurrent request handling, and background job processing
Cloud Scalable
Deployable on AWS, Azure, GCP with auto-scaling capabilities, load balancing, and multi-region deployment support
Docker
Containerized deployment for consistent environments across development, staging, and production
Kubernetes
Container orchestration for auto-scaling, management, service discovery, and high availability
Kafka
Apache Kafka for real-time event streaming, message queuing, and event-driven architecture
Frontend Architecture
Next.js 15 (App Router)
React 19 + TypeScript
Zustand + React Query
Client & server state management
React Hook Form + Zod
Form validation
TanStack Table
POS lists & data tables
Protected Routes
Middleware-based access control
Dynamic Metadata
SEO engine
Multi-Variant POS Support
B9POS supports multiple POS variants tailored for different business types, each with specialized features and workflows.
Restaurant POS
Table management, menu items, order processing, kitchen display system, bill splitting, waiter assignment, table status tracking, and restaurant-specific reporting.
Super Shop POS
Large retail stores, supermarkets, grocery stores, multi-category products, bulk pricing, loyalty programs, and advanced inventory management.
Hardware POS
Hardware stores, construction materials, tools, building supplies, bulk items, measurement units, and contractor account management.
Sanitary POS
Sanitary ware stores, bathroom fixtures, plumbing supplies, installation services, showroom management, and project-based sales.
39+ Complete POS Modules
Dashboard
Real-time analytics dashboard with total sales, total purchase, profit/loss overview, remaining stock alerts, pending orders, dealer-to-shopkeeper order overview, and daily/monthly analytics with real-time insights.
Dealer → Shopkeeper Ordering System
B2B ordering ecosystem: Shopkeeper features - Browse dealer products, request orders, track order status (Pending, Confirmed, On the way, Delivered), auto-stock update. Dealer features - Receive orders, approve/reject, manage pricing/discounts, track balances, send invoices, manage credit limits.
POS Billing System
Fast POS billing with product search, barcode scanning, cart management, discount/tax/VAT calculations, multiple payment methods, invoice printing, digital receipt sending via email/SMS, and support for Restaurant/Super Shop/Hardware/Sanitary POS variants.
Products & Inventory Management
Complete product management with categories, attributes, variants, units, collections, tags. Automatic stock updates on sale/purchase, damage stock tracking, low stock alerts, product-supplier linking, and comprehensive inventory tracking.
Purchase Management
Purchase entry, purchase return processing, dealer purchase from supplier, automatic stock-in, expense/cost addition, supplier invoice management, and purchase order tracking.
Sales Management
Complete sales list, sales return processing, pending sales tracking, sales summary reporting with detailed analytics, export capabilities, and sales performance tracking.
Customers & Suppliers
Customer list and balance tracking, supplier list and ledger management, supplier due tracking, credit system with credit limits and payment terms, customer-supplier relationship management.
Expense Management
Daily expense tracking, expense categories, category-wise expense management, monthly cost reports, expense approval workflow, budget tracking, and expense analytics.
Income Management
Income tracking, income categories, income source management, income reports, and income analytics for comprehensive financial management.
Finance & Accounts
Multiple bank accounts management, cash flow tracking, cash in/cash out transactions, complete transaction history, payment methods configuration, multi-currency support, fund transfers, and withdrawals.
Invoice Management
Create and edit invoices, invoice templates, multiple payment methods, invoice printing, digital receipts, invoice status tracking, and invoice history management.
Reports & Analytics
Sales reports, purchase reports, profit/loss reports, stock reports, customer ledger, supplier ledger, expense reports, financial reports, agent reports, product reports, inventory reports - all exportable to PDF/Excel/CSV formats.
User Management
User accounts management, role assignment, user types (company, dealer, shopkeeper, agent, customer, admin), user profiles, and user activity tracking.
RBAC (Role-Based Access Control)
Dynamic RBAC system with database-driven roles, permissions, and modules. Granular permission control, role management, and module-level access control.
Agent Management
Agent assignment, shop-agent relationships, agent performance tracking, agent commission management, and agent activity monitoring.
Shop Management
Shop creation and management, shop profiles, shop settings, logo and banner management, shop status tracking, and multi-shop support.
Companies & Relationships
Company-dealer relationships, relationship management, credit limits, payment terms, discount management, and relationship status tracking.
Shopkeeper Orders
Shopkeeper order management, order approval/rejection, order modification, order status tracking, order cancellation, and order history.
Marketplace
Business connections, marketplace orders, storefront management, ledger tracking, connection types (supplier, dealer), and marketplace analytics.
Referrals
Referral code generation, referral validation, referral tracking, commission management, and referral analytics.
Subscriptions
Subscription plans management, user subscriptions, subscription payment processing, subscription invoices, payment transactions, and subscription lifecycle management.
Settings & Configuration
General settings, invoice settings, currency management, payment methods, notification settings (WhatsApp, SMS), theme settings, login page customization, and system configuration.
Media Management
File upload, media library, image management, logo/banner support, media organization, and media preview capabilities.
Collections
Product collections management, collection organization, collection-based product grouping, and collection display management.
Product Tags
Product tagging system, tag management, tag-based product filtering, and tag organization.
Product Units
Product unit management, unit conversion, unit-based pricing, and unit tracking.
Product Attributes
Product attributes management, attribute values, variant management, and attribute-based product filtering.
Currencies
Multi-currency support, currency management, exchange rate tracking, and currency-based pricing.
Payment Methods
Payment method configuration, payment method management, payment gateway integration, and payment method tracking.
Purchase Returns
Purchase return processing, return approval, return tracking, stock adjustment on returns, and return reports.
Sale Returns
Sales return processing, return approval, return tracking, stock adjustment on returns, refund management, and return reports.
Transactions
Complete transaction management, transaction history, transaction filtering, transaction reports, and transaction analytics.
Withdraws
Withdrawal management, withdrawal requests, withdrawal approval, withdrawal tracking, and withdrawal reports.
Notifications
In-app notifications, notification preferences, notification history, and notification management.
File Upload
File upload system, image upload, document upload, file management, and upload history.
User Types & Roles
Enterprise-Grade Security
JWT Authentication
Secure token-based authentication with token rotation
CSRF Protection
Cross-site request forgery protection
SQL Injection Prevention
Parameterized queries and input sanitization
Input Validation
Server-side validation for all inputs
Role-Based Access
Granular permission system with module and action-level control
Server-Side Encryption
Data encryption at rest and in transit
IP Blocking
Advanced IP blocking and rate limiting
Secure CORS
Configured CORS policies for API security
Encrypted Cookies
Secure cookie-based session management
Pydantic Validation
Input validation with Pydantic models
Field-Level Access
Granular field-level permission control
Cloud Features
Technology Stack
Backend
- FastAPI 0.115.5 (Python 3.11+)
- PostgreSQL 15+ Database
- SQLAlchemy 2.0.36 ORM
- Alembic Migrations
- JWT Authentication
- Dynamic RBAC System
- Multi-Tenant Architecture
Frontend
- Next.js 16.1.1 (App Router)
- React 19.2.3
- TypeScript 5.9.3
- Tailwind CSS 4.1.18
- TanStack Query 5.90.12
- Zustand State Management
- React Hook Form + Zod