Skip to content

Comprehensive Component Glossary

1. Edge & Interoperability Layer

  • Android POS App: The primary edge interface. Built in React Native, it handles sales, local stock tracking, clinical data entry, and reorder approvals. Optimized for offline use.

  • LocalDB (WatermelonDB): High-performance reactive local database for edge devices. Enables 100% offline functionality and background synchronization once connectivity is restored.

  • Mediator / API Gateway: The central orchestration engine based on the OpenHIM pattern. Secures registry access, enforces identity verification (NMC/NPC/NID), and generates non-repudiable audit trails.

  • OIDC / Auth: Identity and access management layer. Verifies JSON Web Tokens (JWT) for health workers and assigns facility-scoped permissions.

2. Core Registries (Master Data)

  • Client Registry (CR): The Master Patient Index (MPI). Uniquely identifies patients via National ID (NID) and phone. Foundational for preventing record fragmentation.

  • Facility Registry (FR): Canonical index of all physical pharmacies and clinics. Includes GPS coordinates necessary for 3PL routing and regulatory license status.

  • Distributor Registry (DR): Directory of suppliers. Contains B2B integration endpoints, lead times, and negotiated GPO contract pricing for automated procurement.

  • Logistics Registry (LOG): Master data for delivery partners (e.g., Pathao, local 3PLs). Standardizes tasks for inbound tracking and outbound patient deliveries.

  • Worker Registry (HWR): Index of verified health practitioners. Stores license numbers that MUST be validated by the NMC (Doctors) or NPC (Pharmacists) to authorize clinical authorship.

  • Terminology Service (TS): The clinical source of truth for code sets (ICD-10, SNOMED, RxNorm). Ensures semantic interoperability across the network.

3. Domain Services (Transactional)

  • Inventory Service: Transactional engine tracking live stock counts, batches, and expiries. Linked to LOG to track "In-Transit" stock.

  • Subscription Service: Manages medication adherence for chronic patients. Tracks recurring 30/60/90-day cycles and triggers FHIR Subscription resources to coordinate dispatch.

  • Scheduling Service: FHIR-compliant booking engine. Manages doctor availability slots and patient appointment history at registered pharmacies.

  • Shared Health Record (SHR): The clinical vault. Stores encounters, observations, and prescriptions in a portable International Patient Summary (IPS) format with AES-256 encryption.

  • Finance Service (FIS): Financial orchestrator. Manages GPO margins (1%), routes insurance claims to openIMIS, and requests dynamic payment QR codes.

  • Product Registry (PR): Commercial SKU catalog. Maps physical local drug barcodes to standardized clinical entries and GPO Master SKUs.

4. National Ecosystem & Regulators

  • NMC / NPC (Councils): Nepal Medical Council & Pharmacy Council. PharmaNet performs real-time license verification against these bodies to ensure care integrity.

  • National ID (NID): Nepal's central identity source. PharmaNet uses it for deterministic patient matching.

  • openIMIS: National Health Insurance platform. Integrated via FHIR Coverage and Claim APIs to enable cashless sales at the POS.

  • 3PL (Logistics Channels): External delivery networks (like Pathao) that execute the tasks generated by the Logistics Registry.