Changelog

All notable changes to Zerahx POS will be documented here.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Version 1.11.0

Released on 2026-03-02

Added

KRA eTIMS VSCU Integration 🇰🇪
Real-time automated tax invoice transmission for all POS and manual sales.
Virtual Sales Control Unit (VSCU) architecture with zero-latency background processing.
Automated eTIMS Credit Note generation for approved product returns.
Automatic Void Notifications for cancelled sales to KRA.
Mandatory KRA field persistence: `hsCode`, `taxCategory`, `customerPin`, and `customerName`.
Regulatory Compliance Dashboard: New module for monitoring eTIMS health scores and manual synchronization.
Enhanced Compliance PDF Outputs: All receipts and invoices now include mandatory KRA QR codes and verification hashes.
High-Fidelity Simulation Mode: End-to-end testing environment with realistic fiscal identifiers.

Version 1.10.0

Released on 2026-03-02

Added

eCommerce & External Order Integration 🛒
Seamless bridge between online storefronts and Zerahx POS.
New Integrated Orders Dashboard for managing web orders (Pending, Approved, Completed).
Background fulfillment engine with atomic inventory and financial synchronization.
Automatic patient linking and CRM integration for web customers.
"Compare-and-Swap" concurrency protection to prevent duplicate fulfillment.
Gross-tax normalization: Web prices are automatically split into net revenue and tax records for POS compliance.
Linked Sale ID tracking for direct audit trails from web order to POS transaction.
Multi-branch isolation for external order processing.

Version 1.9.0

Released on 2026-01-12

Added

Global Currency Localization 🌏
Full support for business-specific currency symbols across all modules.
Real-time localization of sales history, returns, and financial summaries.
Finance Reports Dashboard 📊
Centralized oversight of insurance claims, expenses, and cash operations.
Interactive settlement analytics with insurer performance tracking.
Expense intelligence and automated cash variance monitoring.
Configurable Loyalty Engine 💎
Granular control over loyalty point earning and redemption rules.
Customizable thresholds to fit different promotional strategies.

Fixed

System Stability 🛡️
Resolved runtime errors in the Insurance Claims tracker related to data processing.
Hardened financial analytics reports with defensive data handling to prevent dashboard crashes.
Fixed API response synchronization in paginated administration modules.

Version 1.8.0

Released on 2025-12-03

Added

Card Payment Integration 💳
Accept Visa, Mastercard, and other card payments via Flutterwave
PCI DSS compliant - card data never touches your servers
Automatic checkout completion when payment is confirmed
Secure redirect to Flutterwave's payment page
Support for overpayments with card payments
Card payment status tracking in sales history
Admin settings for Flutterwave credentials configuration

Changed

Payment Options 💰
Added "Card (Visa/Mastercard)" option to payment modal
Updated payment flow to support multiple payment gateways
Enhanced payment section on landing page with card payment details
New Flutterwave integration utility functions
Card payment API endpoints (initiate, callback, webhook)
Flutterwave credentials management (API + UI)
Card transaction tracking and verification
Automatic sale completion for card payments

Version 1.7.0

Released on 2025-12-03

Added

M-Pesa STK Push Auto-Completion 💳
Automatic checkout completion after successful M-Pesa payment
Faster checkout process - no manual M-Pesa code entry needed (when configured)
Stock automatically updated when payment is confirmed
Seamless payment experience for customers
Automatic fallback to manual entry if M-Pesa is not configured
Overpayment Handling 💰
Record customer overpayments (tips, goodwill, rounding)
Accurate financial tracking
Overpayment displayed on receipts
Works with all payment methods (Cash, M-Pesa, Other)
Ensures complete revenue tracking
Payment Status Tracking 📊
Visual indicators in sales history showing payment status
See which payments are pending, completed, or failed at a glance
Payment status included in sales reports
Better visibility into payment processing
Enhanced Website 🎨
Updated homepage with comprehensive feature showcase
Clear explanation of M-Pesa integration
"How It Works" guide for new users
Better presentation of system capabilities

Fixed

Fixed navigation menu display issues
Improved payment processing reliability
Better handling of payment failures
Enhanced system stability

Changed

Sales History 📈
Payment status now visible in sales table
Sales reports automatically exclude incomplete payments
Improved sales data visibility
M-Pesa Payment Flow 💳
Improved payment process for better user experience
Customer can add tips/overpayment after main payment
Automatic completion when payment is confirmed

Version 1.6.0

Released on 2025-11-29

Added

Data Backup System 💾
Create backups of your pharmacy data
Download backups for safekeeping
Automatic backup before system reset
Easy backup management from Settings page
Data Restoration 🔄
Restore your pharmacy from a backup
Simple restore process with confirmation
Restore previous data if needed
Safe restoration with progress indicators

Fixed

Fixed system statistics display issues
Improved system monitoring accuracy

Version 1.5.0

Released on 2025-11-20

Added

Touch Screen Support 🖥️
Full support for touch screen monitors
Larger buttons and controls for easier tapping
Optimized interface for touch interactions
Better readability on touch devices
Automatic interface adaptation for touch screens

Fixed

Improved touch screen compatibility
Better accessibility for all devices

Changed

Login Page 🔐
Cleaner, more focused login interface
Improved user experience

Version 1.4.0

Released on 2025-XX-XX

Added

(Version 1.4.0 features will be documented here)

Version 1.3.0

Released on 2025-11-15

Added

Advanced Inventory Analytics 🎯
Product value classification (ABC analysis)
Stock age tracking and analysis
Category performance metrics
Reorder efficiency insights
Stock turnover analysis
Customer Loyalty Program 🎁
Points-based rewards system
Tiered membership (Bronze, Silver, Gold, Platinum)
Automatic points on purchases
Loyalty tracking and history
Customizable program settings
Supplier Performance Tracking 📊
Delivery time tracking
Quality metrics and ratings
Price trend analysis
Supplier scorecards
Performance comparison tools
Enhanced Reorder Suggestions 🤖
Supplier-specific recommendations
Batch ordering suggestions
Price comparison across suppliers
Lead time considerations
Customer Communication 📧
SMS/Email notifications
Prescription refill reminders
Stock availability alerts
Promotional messaging
Communication preferences
Multi-Branch Dashboard 🏢
Chain-wide analytics
Branch performance comparison
Cross-branch inventory visibility
Centralized reporting
Advanced Prescription Management 💊
Allergy warnings
Medication adherence tracking
Prescription templates
Patient medication history
Financial Analytics 📊
Cash flow forecasting
Profit margin analysis
Break-even analysis
Financial health scoring
Purchase Order Automation ⚙️
Auto-generate purchase orders
Batch PO creation
Draft and approval workflow
Customer Segmentation 🎯
Customer lifetime value calculation
Buying pattern analysis
Customer segmentation (VIP, Loyal, Regular, etc.)
Personalized recommendations

Fixed

Fixed financial accuracy in reports
Fixed reports when products are deleted
Improved inventory analytics calculations
Enhanced financial reporting accuracy
Added financial accuracy documentation
Added feature recommendations document

Version 1.2.0

Released on 2025-11-XX

Added

Product Catalog System
Global product catalog with pre-seeded products
Browse and search products by category
Quick product entry from catalog
Comprehensive product categories
Product Management Improvements
Faster product updates
Better product editing experience
Improved mobile and tablet support

Fixed

Fixed product catalog functionality
Improved product list updates
Enhanced product management reliability

Version 1.1.0

Released on 2025-11-XX

Added

Stock Take System
Complete inventory counting system
Variance calculation and reporting
Adjustment workflow with approval
Progress tracking
Export to CSV
Stock Transfer System
Transfer inventory between pharmacies
Approval workflow
Receiving interface
Automatic stock updates
Branch pharmacy support
Branch Management
Support for multiple pharmacy locations
Branch creation and management
Stock transfers between branches
Notification System
In-app notifications for transfers
System event notifications
Help System
Contextual help and tooltips
User guidance throughout the system

Fixed

Improved pharmacy name consistency
Fixed branch display issues
Enhanced stock transfer reliability
Better system performance

Version 1.0.0

Released on 2025-11-XX

Added

Initial production release
Core POS functionality
Multi-tenant pharmacy architecture
Product management
Sales processing
Stock management
Stock movement tracking
Purchase order system
Patient management
Prescription management
Returns management
Cash drawer management
Reporting and analytics
User management and roles
Settings management
Subscription system
Audit trail and system logs

Security

Authentication and authorization
Enhanced system security
Data isolation per pharmacy
Secure password hashing
1.0.0 - Initial production release

For the complete changelog, see CHANGELOG.md