DAS Form Automation

Data Ascension System (DAS) menyediakan scraping DOM adaptif dan pengisian formulir otomatis untuk ePuskesmas. Menggantikan selektor hardcoded yang rapuh dengan pengenalan bidang cerdas yang belajar pola per-fasilitas dan meningkat seiring waktu.

Tujuan

Formulir ePuskesmas bervariasi antar instalasi Puskesmas dan berubah tanpa pemberitahuan. DAS memindai halaman, membangun tanda tangan bidang, memetakannya ke payload klinis menggunakan pencocokan semantik, dan mengisinya dengan aman. Ia menyimpan pemetaan yang berhasil dan belajar dari koreksi pengguna sehingga kunjungan berulang ke fasilitas yang sama menjadi lebih cepat dan lebih akurat.

Tata letak direktori

lib/scraper/adaptive/
├── dom-scanner.ts           # Fase 1: Ekstrak tanda tangan bidang dari halaman
├── field-classifier.ts      # Klasifikasikan bidang untuk keamanan (klinis vs umum)
├── semantic-mapper.ts        # Fase 2: Orchestrator — cache → mapper lokal → keamanan
├── local-semantic-mapper.ts # Pencocokan semantik lokal berbasis heuristik
├── mapping-cache.ts         # Lapisan 1: Cache statis (cepat, offline)
├── safety-validator.ts      # Ambang batas kepercayaan dan pemeriksaan kategori klinis
├── learning-store.ts        # Fase 3: Loop umpan balik IndexedDB
├── feedback-capture.ts      # Lacak hasil pengisian per bidang
├── cache-promoter.ts        # Promosikan pemetaan yang berhasil ke cache
├── types.ts                 # Tipe bersama untuk semua fase DAS
└── index.ts                 # Ekspor publik

lib/filler/
├── filler-core.ts           # Mesin dispatch peristiwa untuk semua tipe bidang
└── main-world-bridge.ts     # Jembatan yang menyadari jQuery untuk AJAX autocomplete

lib/handlers/
├── page-anamnesa.ts         # Handler halaman anamnesa (keluhan, vital, keadaan fisik)
├── page-diagnosa.ts         # Handler halaman diagnosa (ICD-10, jenis, kasus, prognosa)
└── page-resep.ts            # Handler halaman resep (baris medikasi, signa, aturan pakai)

Abstraksi kunci

FieldSignature

Deskripsi lengkap dari bidang formulir: nama tag, selektor, tipe, atribut (nama, id, placeholder, aria-label), teks label, konteks (ID formulir, header bagian, label saudara), dan posisi.

MappingResult

Output dari pemetaan DAS: bidang yang cocok dengan skor kepercayaan, kunci payload yang tidak dipetakan, peringatan, dan latensi. Pemetaan di bawah ambang batas kepercayaan dikecualikan.

ClinicalFieldCategory

vital_signs | medication | allergy | patient_id | diagnosis | general. Digunakan oleh safety validator untuk memutuskan bidang mana yang memerlukan konfirmasi manusia.

FillResult

Hasil per-bidang dari filler: boolean sukses, pengenal bidang, nilai, metode yang digunakan (direct | autocomplete | select | checkbox | radio), dan kesalahan opsional.

Cara kerja

Alur DAS

flowchart LR
    A[Payload] --> B[DOM Scanner]
    B --> C{Cache hit?}
    C -->|Ya| D[Pulihkan dari cache]
    C -->|Tidak| E[Local Semantic Mapper]
    E --> F[Safety Validator]
    F --> G[Isi Bidang]
    G --> H[Feedback Capture]
    H --> I{Promosikan ke cache?}
    I -->|Ya| J[Perbarui cache]
    I -->|Tidak| K[Learning store]

Fase 1: DOM scanner

lib/scraper/adaptive/dom-scanner.ts menghitung semua bidang formulir interaktif pada halaman. Untuk setiap bidang diekstrak:

• Klasifikasi tipe — text, number, select, checkbox, radio, date, time, textarea, hidden
• Selektor unik — dihitung via ID, nama, atau jalur CSS dengan nth-child
• Resolusi label — <label for>, label pembungkus, aria-label, aria-labelledby, teks berdekatan, atau fallback placeholder
• Konteks — ID formulir induk, header bagian terdekat, label saudara, kelas CSS induk
• Posisi — bounding rect dan visibilitas

Scanner berjalan dalam waktu kurang dari 10ms untuk halaman ePuskesmas tipikal dan menghasilkan array objek FieldSignature.

Fase 2: Semantic mapper

lib/scraper/adaptive/semantic-mapper.ts adalah orchestrator utama. Mengoordinasikan:

1. Pencarian cache — mapping-cache.ts memeriksa apakah halaman persis ini (berdasarkan URL + hash bidang) pernah dipetakan sebelumnya. Cache hit memulihkan pemetaan dalam waktu kurang dari 50ms.
2. Pemetaan semantik lokal — local-semantic-mapper.ts menggunakan heuristik untuk mencocokkan kunci payload ke bidang: kesamaan teks label, pencocokan nama/ID, pola spesifik ePuskesmas, dan konteks header bagian.
3. Validasi keamanan — safety-validator.ts menegakkan ambang batas kepercayaan (default 0.8), mengklasifikasikan bidang berdasarkan kategori klinis, dan menandai bidang kritis untuk konfirmasi manusia.
4. Promosi cache — pemetaan dengan kepercayaan >= 0.9 disimpan dalam cache untuk waktu berikutnya.

Fase 3: Learning store

lib/scraper/adaptive/learning-store.ts memelihara database IndexedDB dari hasil pengisian. Setiap upaya pengisian mencatat:

• Kunci payload, selektor bidang, kepercayaan, hasil (success | auto_corrected | failed | rejected | timeout)
• Tipe halaman (anamnesa, diagnosa, resep, soap)
• ID sesi dan timestamp

Statistik agregat melacak tingkat keberhasilan per pemetaan. Ketika pemetaan mencapai kriteria promosi (minimum upaya, tingkat keberhasilan, kepercayaan, dan periode stabilitas), ia dipromosikan ke cache statis.

Auto-fill: mesin dispatch peristiwa

lib/filler/filler-core.ts mengirimkan rantai peristiwa yang benar untuk setiap tipe bidang:

• Text / textarea — focus → input → change → blur
• Select — change saja
• Checkbox — click → change
• Radio — click → change
• Autocomplete — focus → simulasikan pengetikan → keydown → tunggu dropdown → klik item

Filler menggunakan native value setters untuk melewati override React/jQuery, melewati bidang yang sudah memiliki nilai yang dimasukkan pengguna, dan menyorot bidang yang diisi dengan pulsa visual singkat. Ia tidak pernah memodifikasi bidang token CSRF.

Page handlers

Anamnesa (lib/handlers/page-anamnesa.ts)

Mengisi halaman anamnesa termasuk:

• Keluhan utama dan keluhan tambahan (force override)
• Tanda vital (sistolik, diastolik, MAP, nadi, pernapasan, suhu, glukosa, SpO2)
• Penilaian nyeri (skala nyeri via range slider, detail PQRST)
• Pemeriksaan fisik (checkbox keadaan fisik dengan handler onclick, 15 textarea sistem tubuh)
• Peta anatomi (diagram tubuh interaktif — klik penanda, isi bidang popup)
• Status psikososial (radio buttons)
• Nama dokter dan perawat (autocomplete via main-world bridge)

Diagnosa (lib/handlers/page-diagnosa.ts)

Mengisi halaman diagnosa termasuk:

• Kode ICD-10 (text atau autocomplete)
• Nama diagnosis (text)
• Jenis (PRIMER/SEKUNDER) dan Kasus (BARU/LAMA) via dropdown select
• Prognosa (dipetakan ke nilai numerik ePuskesmas)
• Checkbox penyakit kronis
• Nama dokter dan perawat
• Auto-klik "Tambah" untuk mengommit baris diagnosis

Resep (lib/handlers/page-resep.ts)

Mengisi halaman resep dengan pengisi baris cascading:

• Bidang global: alergi, berat badan, tinggi badan, prioritas
• Nama dokter dan perawat (autocomplete via bridge)
• Baris medikasi: nama obat (autocomplete dengan retry kandidat yang menyadari stok), racikan, jumlah, signa, aturan pakai, keterangan
• Commit deterministik: klik "Tambah" dan verifikasi baris telah di-commit sebelum melanjutkan

Handler resep mencakup telemetri untuk setiap transisi state baris dan menangani kasus tepi seperti peringatan stok tidak mencukupi, ketidakcocokan formulasi, dan duplikasi obat.

Titik masuk untuk modifikasi

File kunci

• lib/scraper/adaptive/dom-scanner.ts — Fase 1. Mengekstrak tanda tangan bidang lengkap dari halaman ePuskesmas apa pun.
• lib/scraper/adaptive/semantic-mapper.ts — Orchestrator fase 2. Mengoordinasikan cache, mapper lokal, safety validator, dan promosi cache.
• lib/scraper/adaptive/learning-store.ts — Fase 3. Loop umpan balik berbasis IndexedDB dengan statistik agregat dan kriteria promosi.
• lib/filler/filler-core.ts — Mesin dispatch peristiwa. Menangani semua tipe bidang dengan native setters dan bypass kerangka kerja.
• lib/handlers/page-anamnesa.ts — Handler halaman anamnesa. Handler paling kompleks; mencakup peta anatomi dan keadaan fisik.
• lib/handlers/page-diagnosa.ts — Handler halaman diagnosa. Mencakup pemetaan ICD-10, checkbox penyakit kronis, dan auto-commit.
• lib/handlers/page-resep.ts — Handler halaman resep. Pengisi baris cascading dengan seleksi medikasi yang menyadari stok dan verifikasi commit.

Halaman terkait

• Iskandar Diagnosis Engine — Menghasilkan saran diagnosis yang didorong DAS ke formulir ePuskesmas
• Dashboard Bridge — Menyediakan data pasien yang dapat disinkronkan DAS ke formulir