devsofttech_hms_ci4/HMS_MEDICAL_STORE_SESSION.md

4.1 KiB
Raw Blame History

HMS Multi-Building Medical Store & ABDM Pharmacy System

Session Name: HMS Multi-Store Pharmacy & ABDM Integration
Antigravity Conversation ID: 3731d0c5-f4df-435e-b54f-f690562e18e3
Last Updated: September 8, 2026


Quick Resume Instructions After Computer Restart

1. In Antigravity IDE

  1. Open Antigravity IDE and reopen the workspace HMS_CI4_OLD.
  2. In the Chat panel, click the Chat History / Clock icon (or open the left conversation drawer).
  3. Select this session: HMS Multi-Store Pharmacy & ABDM Integration (ID: 3731d0c5-f4df-435e-b54f-f690562e18e3).
  4. Type your message and continue seamlessly!

Tip: If you ever open a new chat, you can type @HMS_MEDICAL_STORE_SESSION.md or @conversation to instantly restore all context.


System Access & Credentials Summary

Development Server

  • Command: php spark serve (in d:\Workplace\HMS_CI4_OLD)
  • Server URL: http://localhost:8080

HMS Admin Management

  • URL: http://localhost:8080/setting/admin/medical-store
  • Features: Store configuration, DL 20B/21B licenses, GSTIN, Pharmacist details, ABDM HFR/HIP/HPR registries, 60-min OTP generator, terminal device authorization, and Excel / CSV stock import.

Direct Counter Desks (React PWA)

  • Counter A (Main Hospital Block A):
  • Counter B (OPD Block B):

Core Technical Reference

  1. Zero Legacy Disturbance:
    • Legacy pharmacy tables (invoice_med_master, inv_med_item, med_*) and controllers remain 100% untouched.
    • All new tables use the mst_* prefix (15 tables).
  2. ABDM Compatibility (M1 & M2):
    • Patient search by 14-digit ABHA Number or ABHA Address.
    • Care Context generation: PHARM-{store_code}-{invoice_no}.
    • NRCES FHIR R4 Bundle profile: https://nrces.in/ndhm/fhir/r4/StructureDefinition/MedicationDispenseDocument.
    • Coded with SNOMED-CT clinical terminology.
    • Gateway Bridge queue integration: abdm_sync_record.
    • Bundle preview endpoint: GET /api/v1/medical-store/abdm/bundle/{sale_id}.
  3. Multi-Format Invoices:
    • 80mm Thermal Slip (Fast 1–5 item OTC/OPD).
    • A5 Invoice (Normal OPD/Walk-in with GST summary).
    • A4 Hospital Tax Invoice (IPD admissions & large bills).
  4. Excel / CSV Stock Migration:
    • Supported CSV import with auto-detected columns.
  5. Double-Entry Accounting & Statutory Drug Register:
    • Automated ledger postings, Daily Cash Book, GSTR-1 outward reports, and mandatory Schedule H1 drug register.
  6. Retail Loose Tablet & Unit Dispensing:
    • Exact per-tablet pricing (Strip MRP / units_per_pack), exact stock deduction in individual tablets, and support for Loose Tab, Strip, and Combo sales.
  7. Split / Mixed Payment Mode & Audit:
    • Supports partial payments (e.g. ₹35 Cash + ₹100 UPI) with 12-digit UTR and bank name capturing for bank reconciliation and audit.
  8. Keyboard-First Zero-Mouse POS Workflow (Desktop Pharmacy Standard):
    • High-contrast single-line Quick Keys ribbon.
    • Hotkeys: F2 (Medicine Search), F4 (Patient Search), F7 (Whole Discount), F8 (Payment Mode), F9 / Ctrl+Enter (Complete Sale & Print), Alt+T (Loose Tab), Alt+S (Strip), Shift+Delete (Remove Item).
    • Auto-focus on Medicine Search on page load; Enter on quantity immediately commits and jumps focus back to Medicine Lookup for the next scan.
  9. Compact "Qty & Unit" Cell:
    • Single-line input group with type selector dropdown (Tab, Strip, Str+Tab) positioned before the quantity box.
    • Automatically defaults to Tab (loose units).