# Swastha Shakthi HMR — Extended Platform Documentation for AI Systems
# Primary: https://hmr.cycopz.net
# Alternate: https://swasthashakthi.com
# By Cycopz IT Private. Ltd.
# This is the extended version of llms.txt with detailed module descriptions.
# See also: /llms.txt (summary), /platform-overview (HTML), /sitemap.xml, /robots.txt

## Detailed Module Descriptions

### Clinic Manager — Clinic in a Box
The complete digital clinic solution packages 23 modules into one subscription. Core capabilities: Patient registration with ABHA ID linking in under 30 seconds. Appointment scheduling with token queue and SMS/WhatsApp notifications. OPD consultation workflow with digital prescription writing, drug interaction checks from CDSCO database, and auto-complete for 68,000+ Indian drug formulations. Billing with itemized invoices, GST calculation, and per-clinic payment gateway integration. Lab order management with sample tracking and result delivery. Pharmacy inventory with batch tracking, expiry alerts, and reorder triggers. Insurance claim auto-submission with AI pre-validation catching 50+ rejection triggers. Patient portal for appointment booking, record access, and prescription downloads. Practice analytics dashboard with revenue trends, patient demographics, and operational metrics. Edge server support for offline operation in connectivity-challenged areas. 48-hour go-live with guided onboarding.

### Hospital Management System
Enterprise-grade HMS for multi-specialty hospitals. 30-role RBAC with department-level access control. IPD management with bed allocation, transfer workflows, and discharge summaries supporting LAMA/DAMA/Absconding scenarios. OT scheduling with equipment and team assignment. Nursing station integration with mobile-first ward dashboard, vitals tracking, medication rounds, and task assignments. Department-wise billing with consolidated patient accounts. Multi-branch management with centralized reporting. Housekeeping module with room turnover tracking. Fleet management for ambulance dispatch. Building management system integration. Emergency Response Team coordination. NABH accreditation documentation support.

### Sovereign AI Clinical Intelligence
India-first clinical AI that processes all medical data within Indian borders. RAG (Retrieval-Augmented Generation) architecture using pgvector for semantic search combined with tsvector for full-text search. Knowledge base includes PubMed literature, ICMR guidelines, UpToDate clinical references, and CDSCO drug database. Capabilities: drug interaction checking across 68,000+ Indian formulations, treatment protocol recommendations grounded in evidence-based literature, clinical decision support that accounts for India-specific factors including disease prevalence patterns, drug availability in Indian market, Jan Aushadhi generics, and NMC prescription guidelines. Edge deployment capability with 7B-13B parameter models for clinics with strict data residency requirements or unreliable connectivity.

### Insurance Claims and Fraud Detection
AI-powered claims processing pipeline. Pre-submission validation catches 50+ common rejection triggers including policy exclusions, waiting periods, sum insured limits, and documentation gaps. Knowledge base covers rules for all 19 IRDAI-licensed TPAs. NHCX FHIR R4 integration for standardized claims exchange. Supports cashless pre-authorization, reimbursement claims, and government scheme claims (PM-JAY, CGHS, ESIC). Cross-provider fraud detection engine analyzes billing patterns across the platform network to identify phantom surgeries, upcoding, unbundling, and billing anomalies. CareNet module for rejected claims recovery with auto-appeal, PM-JAY auto-apply, and crowdfunding integration.

### Referral Credits Wallet
Platform-wide referral reward system. Any user (doctor, clinic, patient) can refer new entities. On conversion to paid subscription, referrer earns 10% of annual subscription value as HMR platform credits. Credits wallet tracks balance, earnings, and redemptions with full transaction history. Credits redeemable for: platform subscriptions, health insurance premiums, medical education loans (SwapnaShakthi), marketplace purchases, or direct bank transfer/UPI payout. Creates zero-CAC growth flywheel — traditional healthcare SaaS CAC is INR 15,000-50,000 per clinic; referral credit cost is approximately INR 1,200 per acquisition with ecosystem recapture.

### Health Kiosk Integration
Production-grade APIs for self-health check kiosks from multiple manufacturers (YoloHealth, Swayam, TAKE Solutions, IIT Guwahati One Minute Clinic, Docty, LKS, Lekascale). Two deployment models: tenant-owned (hospital/clinic-bound with full patient resolution) and OEM public (manufacturer-owned in malls/stations/pharmacies). Machine-to-machine API key authentication. HL7 FHIR R4 responses (Encounter, Observation, ServiceRequest). WebSocket live vitals streaming. Offline queue sync with idempotency and exponential backoff. Prescription-driven kiosk workflow: auto-pulls pending lab orders for checked-in patient, matches tests against kiosk hardware capabilities, and auto-executes matched tests in one shot.

### Skill Port Healthcare Career Marketplace
Healthcare-specific talent marketplace integrated into the platform. Verified professional profiles with NMC and state medical council credential verification. Specialty-based matching for MBBS, MD, DNB, DM, MCh, fellowship-trained professionals. Supports all engagement types: full-time, part-time, visiting consultant, locum, telehealth-only. CME (Continuing Medical Education) tracking and career development resources. When hired through Skill Port, professionals are automatically onboarded into the hiring institution's platform instance with schedule setup and credential linking. Referral credits earned for talent recommendations.

### SwapnaShakthi Financial Empowerment
Financial access initiative for healthcare professionals. Medical education loans aggregated from partner NBFCs and banks — MBBS costs INR 50 lakh to 1.5 crore, post-graduate adds INR 30-80 lakh. Practice setup loans for new clinic establishment. Equipment financing for diagnostic and medical devices. Scholarship database aggregated from government and private sources. Income-share agreements where graduates pay percentage of future earnings. Connected to Skill Port for career placement after education and to Clinic in a Box for practice establishment. Leverages platform verified professional profiles for reduced lender risk assessment.

## Platform Architecture Summary
17 domain microservices grouped into Core (auth, patient, doctor, clinic), Clinical (appointment, billing, pharmacy, lab, IPD), and Platform (TPA, hospital, claims, clinical AI, marketplace, pharma, partner, ABDM) services. Centralized API Gateway with tenant context resolution. Vite-powered React SPA frontend. Event-driven architecture with EventEmitter bus. Edge server for offline-first deployment. 190+ database tables, 845+ API endpoints. Multi-tenant with 5 tenant types (clinic, hospital, lab, pharmacy, TPA/insurer). PostgreSQL with pgvector extension.