How to: Membuat Middleware Bridging untuk Sistem Legacy SIMRS & ERP
N
Kembali ke Blog

How to: Membuat Middleware Bridging untuk Sistem Legacy SIMRS & ERP

Tutorial
Nugroho Setiawan · Konsultan IT & Full Stack Developer 22 Nov 2026 6 min baca 1,190 kata 0 views
Panduan praktis membangun middleware bridging untuk sistem legacy: pemetaan titik integrasi, adapter Node.js, idempotensi, antrean retry, dan observability.

Di banyak rumah sakit di Yogyakarta dan Magelang, sistem inti masih berjalan di atas teknologi 15–20 tahun lalu: SIMRS berbasis Delphi 7 dengan MySQL 5.1, atau bahkan FoxPro yang menyimpan data di file .DBF. Ketika kewajiban integrasi datang — V-Claim BPJS, antrean online, hingga SatuSehat dengan FHIR R4 — tim IT dihadapkan pada dua pilihan mahal: mengganti seluruh SIMRS, atau membangun jembatan. Opsi kedua jauh lebih realistis. Bridging middleware memungkinkan data pasien, SEP, dan hasil penunjang mengalir ke sistem eksternal tanpa menyentuh satu baris kode aplikasi lama. Artikel ini membahas langkah konkretnya: memetakan titik integrasi, menulis adapter yang tahan gagal, dan menjaga transaksi tetap idempoten. Contoh kode memakai Node.js 20 LTS, Express 4.19, dan Axios 1.7 — stack ringan yang cukup dijalankan di VPS 2 vCPU/4 GB RAM.

1. Memetakan Titik Integrasi Sebelum Menulis Kode

Kesalahan paling umum adalah langsung membuka editor dan menulis endpoint. Padahal 30–40% waktu proyek bridging habis di fase pemetaan. Mulailah dengan inventarisasi: daftar semua pertukaran data yang dibutuhkan, siapa pengirimnya, arahnya, dan seberapa kritis kegagalannya. Di satu proyek SIMRS tipe C dengan 180 tempat tidur, hasil inventarisasi biasanya menyusut dari keluhan “integrasi semuanya” menjadi 12–14 endpoint nyata, dan 3 di antaranya menyumbang 80% trafik harian.

Untuk sisi legacy, jangan pernah menebak skema. Minta akses read-only ke database, lalu dokumentasikan tabel kunci: master pasien (NORM, NAMA, TGL_LAHIR, ALAMAT), kunjungan (NO_KUNJUNGAN, TGL_MASUK, KODE_POLI, STATUS_PULANG), dan transaksi penunjang. Catat anomali yang akan menjebak Anda: tanggal tersimpan sebagai VARCHAR dengan format tidak konsisten, kode poliklinik tidak ternormalisasi, atau nama pasien yang mengandung karakter pipe — masalah klasik ketika data dikirim lewat HL7 v2.

Buat kontrak antarmuka tertulis sebelum implementasi. Untuk SatuSehat, kontraknya sudah jelas: FHIR R4 dengan resource Patient, Encounter, Observation, dan MedicationRequest. Untuk BPJS V-Claim, formatnya JSON/REST dengan signature dan timestamp. Untuk alat laboratorium, Anda mungkin masih berurusan dengan HL7 v2.5 atau ASTM E1394 lewat port serial. Tuliskan kontrak ini di satu dokumen, lengkap dengan contoh request dan response, lalu review bersama vendor SIMRS sebelum coding dimulai.

Satu hal yang sering dilewatkan: sepakati siapa pemilik data ketika terjadi konflik. Jika hasil lab di SIMRS berbeda dengan yang dikirim ke SatuSehat, mana yang jadi acuan? Tanpa kesepakatan tertulis, tim IT akan menghabiskan berjam-jam rapat rekonsiliasi setiap bulan.

2. Membangun Adapter Express + Axios dengan Lapisan Transformasi

Middleware bridging pada dasarnya adalah kumpulan adapter. Setiap adapter punya tiga tanggung jawab: mengambil data dari sumber, mentransformasi ke format target, dan mengirimkannya dengan aman. Pisahkan ketiganya dalam modul berbeda agar perubahan format FHIR tidak merusak kode pembacaan database. Contoh di bawah adalah adapter minimal untuk mengubah satu baris tabel PASIEN menjadi resource Patient FHIR R4.

import express from 'express';
// pool: mysql2/promise, user DB legacy read-only
const app = express();
app.get('/bridge/patient/:noRm', async (req, res) => {
  const [rows] = await pool.query(
    'SELECT NORM, NAMA, TGL_LAHIR FROM PASIEN WHERE NORM = ?', [req.params.noRm]);
  if (!rows.length) return res.status(404).json({ error: 'patient not found' });
  const p = rows[0];
  res.json({ resourceType: 'Patient', id: String(p.NORM),
    name: [{ text: p.NAMA.trim() }],
    birthDate: new Date(p.TGL_LAHIR).toISOString().slice(0, 10) });
});
app.listen(8081);

Perhatikan detail kecil yang menentukan: String(p.NORM) karena FHIR mensyaratkan id bertipe string, sementara kolom NORM di MySQL 5.1 umumnya INT. Fungsi toISOString().slice(0,10) menormalkan datetime ke format YYYY-MM-DD yang valid. Nama di-trim karena data legacy sering mengandung spasi ganda dari input keyboard operator.

Untuk sisi klien, gunakan satu instance Axios dengan konfigurasi global alih-alih memanggil axios.get tersebar. Set timeout 15 detik untuk endpoint BPJS dan 30 detik untuk SatuSehat, karena cold start layanan pemerintah bisa lambat. Tambahkan interceptor yang menyisipkan header X-Correlation-Id berupa UUID v4 di setiap request — ini akan menyelamatkan Anda saat menelusuri log enam bulan kemudian.

Bungkus setiap adapter dalam blok try/catch yang mengembalikan struktur error konsisten: kode, pesan, dan apakah error tersebut retryable. Error 400 dari BPJS karena nomor kartu tidak valid tidak boleh diretrying; error 503 harus. Perbedaan ini yang mencegah antrean penuh oleh job yang mustahil berhasil.

3. Idempotensi, Antrean, dan Observability

Di rumah sakit dengan 1.200 kunjungan per hari, bridging tidak bisa berjalan sinkron penuh. Operator mendaftarkan pasien jam 08.00, tetapi SatuSehat bisa saja timeout. Jika Anda mengirim ulang tanpa penjagaan, Anda berisiko membuat Encounter ganda. Solusinya idempotensi: sebelum mengirim, periksa tabel bridge_log berdasarkan kunci unik (nomor SEP atau nomor kunjungan). Jika statusnya sent, lewati. Jika failed dan masih di bawah batas percobaan, kirim ulang.

Gunakan BullMQ 5.x dengan Redis 7.2 untuk antrean. Konfigurasi yang terbukti stabil: attempts: 5 dengan exponential backoff 30 detik, serta removeOnComplete: 1000 agar Redis tidak membengkak. Untuk trafik 1.200 transaksi/hari, satu worker dengan konkurensi 10 sudah lebih dari cukup.

  • Catat durasi setiap panggilan eksternal dan kirim ke Prometheus; alert jika p95 melewati 5 detik.
  • Simpan payload request dan response mentah minimal 30 hari untuk audit dan rekonsiliasi klaim.
  • Jalankan proses sebagai service systemd atau PM2 dengan auto-restart, bukan node index.js di dalam screen.

Untuk observability, satu dashboard Grafana dengan empat panel sudah memadai: tingkat keberhasilan per endpoint, panjang antrean, latensi p95, dan jumlah job gagal 24 jam terakhir. Tim IT rumah sakit tidak butuh platform observability mahal; mereka butuh sinyal yang bisa ditindaklanjuti pada jam 02.00 ketika bridging mati.

Best Practices

  1. Akses database legacy hanya lewat user read-only dan view khusus bridging — jangan pernah menulis balik ke tabel inti SIMRS.
  2. Terapkan idempotency key per transaksi (nomor SEP, nomor kunjungan) dengan unique index di tabel log.
  3. Set timeout eksplisit 15–30 detik dan retry maksimal 5 kali dengan exponential backoff.
  4. Simpan payload mentah minimal 30 hari, terenkripsi, dengan retensi terpisah dari backup harian.
  5. Pantau error rate per endpoint; alert otomatis jika melewati 2% dalam 15 menit atau antrean melebihi 50 job.

FAQ

Apakah middleware bridging harus selalu memakai Node.js?

Tidak. Node.js dipilih karena I/O-bound, ringan, dan cepat dikembangkan. Jika tim internal lebih kuat di PHP, Laravel 11 dengan queue worker juga bekerja baik. Kuncinya bukan bahasa, melainkan pemisahan adapter, idempotensi, dan antrean retry.

Bagaimana menangani SIMRS legacy yang sama sekali tidak punya API?

Baca langsung dari database dengan user read-only, atau — jika skema terlalu berisiko — gunakan RPA ringan untuk mengekstrak laporan periodik. Untuk alat laboratorium, bridging dilakukan di level protokol serial (ASTM E1394) lewat konverter ke HL7 v2 atau JSON.

Berapa lama pembangunan bridging ke SatuSehat?

Untuk satu rumah sakit dengan 3–4 resource prioritas (Patient, Encounter, Observation), fase pemetaan 1–2 minggu, implementasi 3–4 minggu, dan uji coba paralel 2 minggu. Tambahkan waktu untuk verifikasi kredensial dan sandbox yang kadang butuh 5–10 hari kerja.

Bagaimana menjaga keamanan data pasien saat bridging?

Wajib TLS 1.2+ di semua koneksi keluar, kredensial di secret manager (bukan hardcode di repo), dan masking NIK pada log. Terapkan prinsip least privilege: adapter hanya boleh membaca kolom yang benar-benar dibutuhkan.

Membangun middleware bridging bukan proyek sekali jadi — ia berevolusi seiring bertambahnya endpoint dan berubahnya spesifikasi dari BPJS maupun SatuSehat. Yang membedakan proyek sukses dan gagal biasanya bukan pilihan framework, melainkan disiplin pada pemetaan kontrak, idempotensi, dan observability sejak hari pertama. Jika tim IT Anda sedang menyiapkan integrasi SIMRS, SIM Klinik, ERP, POS, atau website dan butuh pendampingan teknis, kami menyediakan layanan konsultasi IT dan pengembangan aplikasi untuk wilayah Yogyakarta (DIY) dan Magelang, Jawa Tengah — mulai dari audit kesiapan integrasi hingga implementasi dan serah terima kode.

Artikel ini bagian dari edukasi Nugroho Setiawan, konsultan IT Jogja. Solusi terkait: SIMRS Integrator Bridging BPJS & SatuSehat. Butuh konsultasi gratis?

Terakhir diperbarui 22 Nov 2026

Komentar

Komentar ditinjau sebelum tampil.

Belum ada komentar. Jadilah yang pertama!

Butuh bantuan implementasi atau dashboard data?

Saya membantu konsultasi IT, pengembangan aplikasi, dan visualisasi data untuk rumah sakit, klinik, dan bisnis di Yogyakarta (DIY), Magelang, dan sekitarnya.

WhatsApp Jasa Visualisasi Data Demo VizStudio
Produk & Solusi SIMRS ERP Portfolio Konsultasi Gratis