Three-Tier Platform Connection
How All Three Roles Connect
A unified ledger links every actor in real time — from distributor batch to patient doorstep.
STEP 01
Wholesaler
Batch Distribution
B2B ORDER
Credit Verified
FIFO LOCK
Auto-allocated
STEP 02
Retailer
Pharmacy Store
B2C ORDER
Rx Upload
NMC CHECK
Class-A only
STEP 03
Patient
B2C Consumer
WEBSOCKET
Live sync
INVOICE
VAT generated
STEP 04
Ledger
Double-Entry Settlement
Wholesale Distributor Module
Everything a Distributor Needs
The Wholesaler portal is the backbone of MedHub — handling batch ingestion, Code128 barcode printing, pricing tiers, advance credit management, multi-staff access, and deep analytics all in one dashboard.
100%
Batch Traceability
FIFO
Auto Allocation
1-Click
Invoice Print
Live
Analytics Charts
1
Stock Batch Registration
Register each drug batch with manufacturer name, manufacturing date, expiry date, tablets per strip, strips per box, cost per box, and maximum retail price.
EXPIRY DATECOST PRICEMRSP PRICEUNIT CONFIG
2
Auto Code128 Barcode Generation
System auto-generates a unique Code128 barcode for each batch entry — printable as physical stickers for shelf labeling and POS scanning.
CODE128UNIQUE IDPRINTABLESCANNABLE
3
B2B Price List Management
Configure product pricing tiers visible to registered pharmacies. Products can be flagged as B2B-available or hidden from the wholesale catalogue.
PRICING TIERSVISIBILITYDISCOUNTCATALOGUE
4
Incoming Order Management
Review and approve pharmacy B2B orders. Dispatch triggers automatic FIFO batch allocation, stock deduction, VAT invoice generation, and WebSocket notification.
ORDER REVIEWDISPATCHINVOICE GENSTATUS UPDATE
5
Settlement & Payment Ledger
Track pharmacy advance balances, set credit limits per pharmacy, and view the full double-entry ledger for every transaction with complete audit trail.
ADVANCE BALCREDIT LIMITDOUBLE ENTRYAUDIT LOG
6
Analytics & Reports Dashboard
Real-time charts for daily/monthly revenue, best-selling products by volume and margin, near-expiry batch alerts, and multi-staff activity monitoring.
REVENUE CHARTTOP PRODUCTSEXPIRY ALERTSSTAFF LOGS
Retail Pharmacy Module
Complete Retail Pharmacy Workflow
Retail pharmacies get a full-featured store management platform — from purchasing stock via the B2B portal to walk-in POS billing and online patient order management.
1
B2B Wholesale Purchasing
Browse the wholesale catalogue, place purchase orders, and the system automatically verifies advance balance and allocates the earliest-expiring batch.
ORDER CREATIONADVANCE CHECKFIFO BATCHCREDIT LIMIT
2
Walk-in POS Counter
Physical walk-in sales terminal with barcode scanning for instant product lookup, real-time stock deduction, and one-click VAT-compliant invoice printing.
BARCODE SCANSTOCK DEDUCTVAT INVOICETHERMAL PRINT
3
Online B2C Order Fulfillment
Receive patient online orders, review uploaded prescription images for Class-A drugs, verify NMC license numbers, and mark for dispatch.
ONLINE ORDERSRX REVIEWNMC CHECKDISPATCH
4
Customer & Billing Management
Maintain a full customer database with order history, manage billing cycles, issue credit notes, and process medicine return requests.
CUSTOMER DBORDER HISTORYCREDIT NOTESRETURNS
Real-time Inventory
Advance Balance
Supplier Bills
Sales Analytics
DDA Compliance
Staff Multi-Login
Patient searches nearby pharmacy by radius
Selects medicine & uploads NMC prescription
Pharmacy verifies Rx & doctor NMC number
Order dispatched with tracking & notification
B2C Consumer Platform
Buy Verified Medicines Online
Patients use the public-facing B2C portal to search pharmacies by radius, browse available stock, and order medicines with doorstep delivery. Class-A prescription drugs require NMC-verified doctor credentials.
Geolocation Radius Pharmacy Finder
Uses Haversine formula with PostGIS coordinates to locate pharmacies stocking the required medicine within a selected km radius.
Class-A NMC Prescription Check
Upload prescription image and enter prescribing doctor's NMC registration number. Pharmacy staff manually verify both before dispatch approval.
Single Flat Delivery Fee
A flat delivery fee is set per pharmacy — automatically added to the order total. No hidden charges on any medicine purchase.
Real-Time Order Tracking
WebSocket-powered live order status transitions: Pending → Verified → Dispatched → Delivered — with instant in-app notifications.
Complete Platform Capabilities
9 Specialized Modules,
One Unified Codebase
TRACEABILITY
End-to-End Drug Traceability
Every tablet tracked from manufacturer batch to final patient sale via Code128 barcodes. Enables rapid counterfeit detection and batch recall.
FIFO INVENTORY
Automatic FIFO Stock Allocation
System selects the earliest-expiring batch automatically on every order, minimizing write-offs and preventing expired stock from being dispensed.
POS TERMINAL
Walk-In Counter POS
Barcode scanner terminal at pharmacy counter. Scan to identify product, auto-deduct from inventory, calculate VAT, and print thermal receipt.
GEO SEARCH
Haversine Radius Medicine Finder
Patients submit GPS coordinates; PostGIS finds pharmacies within radius that have the required medicine in stock — live availability check.
REAL-TIME
WebSocket Live Dashboard Sync
All order status changes, stock updates, and payment confirmations broadcast instantly via WebSocket — no polling, no page refresh needed.
SECURITY
JWT Role-Based Authentication
Separate JWT tokens per role. Bcrypt-hashed passwords. Subscription expiry auto-enforcement. Middleware-level route isolation.
BILLING ENGINE
Automated VAT Invoice Generation
Instant A4 and thermal-format invoice generation for every transaction with VAT breakdown, batch reference, and pharma-compliant layout.
POSTGIS
Spatial Database & Analytics
PostgreSQL with PostGIS powers coordinate-based geospatial queries, atomic FIFO ledger transactions, and complex analytics joins.
SUPERADMIN
Superadmin Compliance Matrix
Centralized dashboard to approve partner registrations (PAN/DDA/NMC verification), manage subscription tiers, and audit all system activity.
Multi-Tier Identity & Compliance
PAN, DDA & NMC Verification System
No unverified actor can transact. The Superadmin manually audits every registration — creating a zero-tolerance environment for unregulated pharmaceutical distribution.
🏢
Wholesaler: PAN & VAT Tax Registration
Distributors submit Permanent Account Number (PAN), VAT registration certificate, and trade license. Superadmin manually activates the wholesale account after audit.
💊
Pharmacy: DDA Drug Administration License
Retail pharmacies must hold a valid Drug Administration Department (DDA) license number. Verified before first B2B stock purchase is permitted.
🩺
Doctor: NMC Council License for Rx Drugs
Class-A restricted medicines require the prescribing doctor's Nepal Medical Council (NMC) number plus an uploaded prescription photo before dispatch.
🔒
Subscription-Gated Access Control
All business accounts must maintain active subscriptions. Expired accounts are auto-redirected to renewal — blocking API access and dashboard entry.
Verification Matrix — Trust LayerSUPERADMIN LOCK
All partners receive Superadmin approval before any B2B or B2C transaction is permitted.
Interactive Sandboxes
Try Core Platform Features Live
No account needed. Interact with live simulations of geo search, Rx token generation, and POS billing.
TECH STACKNext.js 16TypeScriptPostgreSQLPostGISPrisma ORMWebSocketsJWT AuthbcryptReactLucide