HDPharmacy POS — Ultimate Multi-Device Pharmacy Management, POS Billing & Offline Sync System

# 🏥 HDPharmacy POS — Enterprise Multi-Branch Pharmacy Management & Intelligent Point of Sale System

**HDPharmacy POS** is a modern, high-performance, and rock-solid pharmacy management platform engineered specifically for retail medical stores, multi-branch pharmacy chains, hospital pharmacies, and pharmaceutical distributors.

Crafted with a clean, responsive **White & Pure Blue UI (`#1769E0`)**, lightning-fast barcode checkout (F1–F10 shortcuts), automated **FEFO (First-Expiry First-Out)** batch resolution, **DRAP compliance** (Schedule G & Form-7 Narcotics Register), and an industry-leading **Offline-First Multi-Device Sync Engine**, this software ensures zero downtime and 100% operational continuity.

---

## 🌟 Top Key Highlights

- **⚡ Blazing Fast POS Terminal**: Touch & keyboard barcode scanner optimized (F1–F10 hotkeys), split payment options, hold/recall cart, and instant bill reprint.
- **🔄 Offline-First Multi-Device Synchronization**: Continue billing without internet. Offline transactions automatically sync and resolve conflicts when connection restores.
- **🛡️ DRAP & Clinical Safety Engine**: Automatic drug-drug interaction checker, generic salt alternative finder, and strict Form-7 narcotics register.
- **📦 Intelligent FEFO Inventory**: First-Expiry First-Out batch management prevents expiration losses and highlights near-expiry items (30/60/90 days).
- **📒 Complete Customer & Supplier Khata (Ledger)**: Track credit sales (Udhaar), customer credit limits, recovery receipts, and distributor payment histories.
- **🖨️ Universal Printing Studio**: Native 80mm & 58mm thermal receipt printing, A4 tax invoices, and custom barcode/shelf-label printing.
- **⚙️ Dual Database Engines**: Works seamlessly with **MySQL 8+ / MariaDB** (for cPanel & Cloud VPS) and **SQLite 3** (Instant zero-config setup).
- **🚀 3-Step Browser Web Installer**: 1-click database connection tester, automatic schema builder, and pre-loaded Pakistani medicine database (Panadol, Augmentin, Risek, Brufen, etc.).

---

## 🚀 Comprehensive Feature Breakdown

### 🛒 1. Point of Sale (POS) Billing Counter
- Rapid medicine barcode scanning and generic formula search.
- Unit conversions: Box, Strip, and Loose Tablets/Capsules with auto-calculated pricing.
- Automated FEFO batch selection with manual override privilege.
- Flat and percentage-based discounts with role permission guard.
- Multiple payment modes: Cash, EasyPaisa, JazzCash, Bank Transfer, and Khata Credit.
- Customer loyalty points & credit limit enforcement.
- Hold & recall customer shopping carts for busy checkout counters.

### 💊 2. Pharmacy Inventory & Batch Control
- Complete batch number, manufacturing date, and expiry date tracking.
- Color-coded Near-Expiry dashboard alerts and reorder warning levels.
- Damaged, expired, breakages, and wastage stock adjustment register.
- Inward Purchase Invoices (Goods Receipt Notes / GRN) with cost price, trade price (TP), and retail price (MRP).
- Inter-branch stock transfers with idempotent transfer protection.
- Barcode and shelf price sticker studio with thermal and sheet printing.

### 👥 3. Customer & Supplier Khata (Udhaar Ledger)
- Digital ledger account for credit customers with balance tracking.
- Customizable credit limits and customer CNIC/phone verification.
- Instant printable payment recovery voucher slips.
- Supplier/Distributor khata management with invoice-by-invoice reconciliation.
- Record cash/cheque/online bank payments to pharmaceutical distributors.

### 💵 4. Cash Register & Shift Management
- Shift opening float amount and closing cash declaration.
- Automated Z-Report printout summarizing cash, cards, returns, and digital payments.
- Petty cash and daily pharmacy expense vouchers (staff tea, utility bills, maintenance).

### 📊 5. Financial Reports & Analytics
- Daily, monthly, and custom-range sales & profit margin reports.
- Cost of Goods Sold (COGS), gross revenue, net revenue, and discount analytics.
- Top-selling medicines and high-margin product leaderboards.
- Expiry loss risk reports and low-stock replenishment reports.
- Audit trail logs tracking user actions, price alterations, and inventory deductions.

### 🔐 6. Granular Role-Based Access Control (RBAC)
5 Pre-configured and customizable roles:
1. **System Administrator**: Unrestricted access to all modules, backups, and settings.
2. **Chief Pharmacist**: Clinical safety, batch adjustments, narcotics register, and inventory.
3. **Store Manager**: Purchases, supplier/customer khata, daily shifts, and sales analytics.
4. **Cashier / Accountant**: POS billing, customer payments, cash float, and expense vouchers.
5. **Salesman / Counter Staff**: Fast POS barcode billing, medicine stock lookup, and reprints.

### 🛡️ 7. CodeStar Enterprise Licensing & 1-Click Updater
- Domain locking, real-time license verification, and silent remote controller SDK.
- 1-Click automated updater SDK to deliver software patches smoothly.

---

## 💻 Technology Stack & Architecture

- **Backend**: Native PHP 8.2+ (Clean OOP, MVC Architecture, PSR Standards, High Performance)
- **Frontend**: Responsive Bootstrap 5, Bootstrap Icons, Font Awesome 6, Chart.js
- **Database Support**: MySQL 8.0+ / MariaDB 10.4+ or SQLite 3
- **Mobile/Offline Companion**: Android Room SQLite & PWA Service Worker ready

---

## 🖥️ Server Requirements

- **PHP Version**: PHP 8.2 or higher
- **Extensions**: PDO, PDO_MySQL (or PDO_SQLite), cURL, OpenSSL, Mbstring, JSON
- **Web Server**: Apache (with `mod_rewrite` enabled), Nginx, or LiteSpeed
- **Hosting**: Works on Shared cPanel, Cloud VPS, Dedicated Server, and Localhost (XAMPP / Laragon)

---

## 📦 What's Included in the Download Package?

1. Full HDPharmacy POS Source Code
2. Complete Database Schemas (`schema.sql` for MySQL and `schema_sqlite.sql` for SQLite)
3. Pre-loaded Pakistani Medicine Seeder (Over 20+ top pharmaceutical brands and salts)
4. Automated 3-Step Web Installer with live AJAX connection tester
5. Android Room Offline Sync Companion Code
6. Detailed Installation & Deployment Guide (`INSTALLATION_GUIDE.md`)

---

## 👨‍💻 Support & Customization

Developed with precision and pride by **Haideri Developers**.
Official Contact & WhatsApp**: 03121478091