Facility Connection Manual

Enterprise Healthcare OS • Hospital Integration

Architecture Overview

The PugaCure Healthcare Network establishes a bidirectional, cryptographically secure bridge between individual patients and licensed healthcare facilities.

┌────────────────────────────────┐                 ┌─────────────────────────────────┐
│     PugaCure Patient App       │                 │   Hospital EMR / Facility App   │
│  (Mobile PWA / Web Portal)     │                 │   (Reception / Clinical Core)   │
└───────────────┬────────────────┘                 └────────────────┬────────────────┘
                │                                                   │
                │ 1. Connect Request / QR Code                     │ 2. QR Scan & Patient Verify
                ▼                                                   ▼
  ┌───────────────────────────────────────────────────────────────────────────────┐
  │                    PugaCure Clinical Backbone & Gateway                       │
  │                   Host API URL: https://care.pugatrinicare.com/api/v1         │
  └───────────────────────────────────────┬───────────────────────────────────────┘

Production API Base

https://care.pugatrinicare.com/api/v1

Ingress Host

https://care.pugatrinicare.com

App Implementation

Inside the PugaCure ecosystem, facility routes are invoked using the built-in `api` client, ensuring zero CORS friction and automatic session handling.

TypeScript SDK Helper

import { api } from '@/lib/api';

// Connect patient to a hospital facility
const connectRes = await api.connectFacility({
  patientId: "PAT-PAT101",
  facilityName: "Reddington Hospital Victoria Island",
  relationshipType: "Partner Hospital"
});

// Scan QR badge at facility reception
const scanRes = await api.scanFacilityQr("PUGACURE:PAT-PAT101");
const { patient } = await scanRes.json();

Authentication Modes

Bearer Token

Standard JWT session authorization.

API Key

Long-lived keys for backend-to-backend sync.

Sandbox Mode

X-Test-Mode header for development.

Route Reference

Method	Route	Description	Scope
POST	/api/v1/patient/connect-facility	Patient initiates connection	Patient Bearer
GET	/api/v1/patient/connected-facilities/:patientId	Retrieve linked hospitals	Patient / Facility
GET	/api/v1/patient/facility-requests/:patientId	Pending request status	Patient / Facility
POST	/api/v1/patient/link-hospital	Associate registry ID	Patient / Facility
POST	/api/v1/facility/request	Transfer request (EHR)	Facility Auth
POST	/api/v1/facility/approve	Approve pending request	Facility Admin
GET	/api/v1/facility/verify-patient/:clinicalId	Verify by Clinical ID	Facility Auth
POST	/api/v1/facility/scan-qr	Bedside QR check-in	Facility Auth
GET	/api/v1/facility/patient-records/:clinicalId	Fetch vitals history	Facility Auth
POST	/api/v1/facility/record-finding	Record clinical findings	Facility Auth
POST	/api/v1/facility/wallet-payout	Billing settlement	Facility Admin
GET	/api/v1/external/patients	External EMR query	Facility / API Key
GET	/api/v1/external/patient/:id	Full telemetry profile	Facility / API Key
POST	/api/v1/external/patient/:id/hospital-record	Push lab/discharge record	Facility / API Key
POST	/api/v1/external/patient/:id/test-request	Dispatch lab order	Facility / API Key
POST	/api/v1/external/sync	Bulk state reconciliation	Facility / API Key
POST	/api/v1/external/teleconsult/sessions	Create video session	Facility / API Key

Payloads & Examples

QR Reception Scan

// POST /api/v1/facility/scan-qr
{
  "qrData": "PUGACURE:PAT-PAT101:SECURE_SIG"
}

// Response 200 OK
{
  "success": true,
  "patient": {
    "id": "PAT-PAT101",
    "name": "Adeola Adeleke",
    "bloodGroup": "O+",
    "allergies": ["Penicillin"]
  }
}

External EMR Integration

Python (Requests)

import requests

def log_hospital_record(patient_id, record_type, result_data):
    url = f"https://care.pugatrinicare.com/api/v1/external/patient/{patient_id}/hospital-record"
    headers = {"Authorization": "Bearer pg_live_key"}
    payload = {
        "hospitalName": "Reddington Hospital",
        "recordType": record_type,
        "resultData": result_data
    }
    return requests.post(url, headers=headers, json=payload).json()

Integration Support

For developer credentials, HL7/FHIR bridge configuration, and production ingress white-listing.

Support Email

pugatrinicare@gmail.com

Developer Portal

care.pugatrinicare.com/dev

PUGA TRINICARE