Bridging Documentation ADAMLIS - SIMRS KHANZA

ADAMLIS - SIMRS KHANZA

Bridging ADAMLIS – SIMRS Khanza memungkinkan integrasi data pemeriksaan laboratorium secara otomatis dari pengiriman order hingga hasil kembali ke sistem rumah sakit.

SYSTEM OVERVIEW


AdamLIS adalah Laboratory Information System (LIS) yang dirancang untuk integrasi dengan berbagai SIMRS termasuk SIMRS Khanza.

Sistem bridging memungkinkan:

  • sinkronisasi registrasi pasien
  • sinkronisasi order pemeriksaan
  • pengiriman hasil laboratorium
  • integrasi analyzer

INTEGRATION MODEL


AdamLIS mendukung 3 model integrasi. 

MODEL

ARAH DATA

DB Sharing

SIMRS ↔ LIS

API POST

SIMRS → LIS

API GET

LIS → SIMRS

ENTERPRISE ARCHITECTURE


 

COMPONENT ARCHITECTURE


COMPONENT

DESCRIPTION

SIMRS Khanza

Sistem Informasi Rumah Sakit

AdamLIS Bridge

API Gateway

AdamLIS Core

LIS Engine

Analyzer

Alat Laboratorium

DATA FLOW


Registration flow

SEQUENCE DIAGRAM






INSTALLATION GUIDE


 
Clone Repository: git clone https://github.com/wahanameditek/bridging_khanza-adamlis.git

Install Dependencies: npm install

ENVIRONMENT CONFIGURATION



Buat file
.env

PORT=3000

DB_HOST=127.0.0.1
DB_PORT=3306
DB_USER=adamlis
DB_PASSWORD=secret
DB_NAME=adamlis

USE_API_KEY=true
API_KEY_1=xxxxx
API_KEY_2=xxxxx

RUNNING SERVICE



Development: npm run dev

Production: npm start

RUNNING WITH DOCKER



docker compose up -d

HEALTH CHECK


Endpoint: GET /health

Response:

{

 "status": "ok"

}

SIMRS KHANZA CONFIGURATION


File konfigurasi: database.xml

Contoh konfigurasi:

<bridging>

    <adamlis>

        <url>http://192.168.100.11/adam-lis</url>

        <apikey>xxxx</apikey>

        <method>GET</method>

    </adamlis>

</bridging>

DATA MAPPING


Mapping Regitrasi

ADAMLIS

KHANZA

no_reg

no_registrasi

waktu_registrasi

tgl_registrasi


Mapping Pasien

ADAMLIS

KHANZA

no_rm

no_rkm_medis

nama

nm_pasien

Mapping Pemeriksaan

ADAMLIS

KHANZA

kode_tindakan

kd_jenis_prw


API SPECIFICATION


Semua endpoint menggunakan:  Content-Type: application/json


REGISTRATION API


Endpoint:   GET /adam-lis/bridging/{limit}/{no_registrasi}

Contoh: http://192.168.100.11/adam-lis/bridging/10/20181101J001

RESPONSE EXAMPLE


{

 "success": true,

 "payload": [

  {

    "no_reg": "20181101J001",

    "pasien": {

      "nama": "SAHMAN"

    }

  }

 ]

}

RESULT API


Endpoint:  POST /adam-lis/hasil

Request:

{

 "header":{

   "no_lab":"B07/260216/0002"

 },

 "detail":[

   {

     "item_pemeriksaan_kode":"HB",

     "hasil_pemeriksaan":"13.5"

   }

 ]

}


DATABASE ERD


Endpoint:  POST /adam-lis/hasil

Request:


AUDIT SYSTEM


Semua Request dicatat pada tabel:   bridge_audit

Field:

FIELD

DESCRIPTION

endpoint

API endpoint

api_key

key yang digunakan

ip_address

alamat client


SECURITY


Rekomendasi produksi:

  • HTTPS
  • API Key
  • Firewall
  • Rate limiting

PERFORMANCE OPTIMIZATION


Disarankan:

  • indexing database
  • caching
  • queue processing

INTEGRATION BEST PRACTICE


Untuk integrasi skala RS besar:

  • gunakan retry mechanism
  • gunakan monitoring
  • gunakan centralized logging

TROUBLESHOOTING


Data tidak muncul

Periksa:

  • nomor registrasi
  • mapping tabel

Unauthorized

Periksa header: X-API-KEY


ENTERPRISE INTEGRATION MODULE


AdamLIS mendukung integrasi lanjutan:

  • HL7
  • ASTM
  • REST API
  • Message Queue


DOCUMENT VERSION


FIELD

DATE

DESCRIPTION

2.0 

2026 

Enterprise Edition


SUPPORT


Adamlabs Support:  project@adamlabs.id ​