Arsitektur

Sentra Assist adalah ekstensi peramban Manifest V3 yang dibangun dengan WXT. Ia menjalankan tiga konteks runtime utama — UI sidepanel React, service worker background, dan content script yang menjembatani akses ke halaman ePuskesmas. Seluruh logika klinis berjalan di peramban; panggilan jaringan terbatas pada autentikasi, polling dashboard bridge, dan reranking LLM opsional.

Lapis sistem

graph TD
    subgraph "Ekstensi Peramban"
        SP[UI Sidepanel<br/>React + Tailwind]
        BG[Background Script<br/>Service Worker]
        CS[Content Scripts<br/>DOM Bridge]
    end

    subgraph "Clinical Engine"
        ED[Emergency Detector<br/>Protokol 4-gerbang]
        IDE[Iskandar Diagnosis Engine<br/>KB + LLM opsional]
        DS[Drug Safety<br/>DDI + Dosis]
        DAS[DAS<br/>Scrape + Auto-fill]
    end

    subgraph "Eksternal"
        DB[Sentra Dashboard<br/>Auth + Bridge API]
        LLM[DeepSeek / Ollama<br/>Reranking opsional]
    end

    SP <-->|pesan terstruktur| BG
    BG <-->|orkestrasi| ED
    BG <-->|alur diagnosis| IDE
    BG <-->|pemeriksaan obat| DS
    CS <-->|scrape / fill| DAS
    SP <-->|panggilan langsung| DAS
    BG <-->|auth + polling| DB
    IDE -.->|opsional| LLM

Alur data: encounter tipikal

sequenceDiagram
    actor Klinisi
    participant Page as Halaman ePuskesmas
    participant CS as Content Script
    participant SP as Sidepanel
    participant BG as Background
    participant IDE as Diagnosis Engine
    participant Bridge as Dashboard Bridge

    Klinisi->>Page: Membuka encounter pasien
    Page->>CS: Event page load
    CS->>SP: Data pasien ter-scrape
    SP->>BG: Meminta diagnosis
    BG->>IDE: Jalankan alur get-suggestions
    IDE->>IDE: Gerbang darurat (4 gerbang)
    IDE->>IDE: Symptom matcher + epidemiologi
    IDE->>Bridge: Opsional: rerank LLM
    Bridge-->>IDE: Saran terurut
    IDE-->>BG: Saran + flag keselamatan
    BG-->>SP: Render kartu diagnosis
    SP-->>Klinisi: UI traffic-light
    Klinisi->>SP: Menerima saran
    SP->>CS: Picu auto-fill
    CS->>Page: Isi kolom diagnosa / resep

Konteks runtime

Sidepanel (entrypoints/sidepanel/)

Sidepanel adalah UI yang berhadapan dengan klinisi. Sidepanel ini adalah sidepanel standar Chrome (API sidePanel Manifest V3) yang dirender dengan React. Tanggung jawab utama:

• Menampilkan konteks pasien dan saran diagnosis
• Merender alert darurat (sistem traffic light)
• Menjadi host untuk clinical workbench (differential diagnosis, visualisasi trajectory)
• Memicu aksi auto-fill DAS
• Pengaturan dan UI konfigurasi

Entry point adalah entrypoints/sidepanel/main.tsx, yang me-mount ApprovedSentraAssistApp.tsx.

Background script (entrypoints/background.ts)

Background script adalah service worker yang menangani:

• Perutean pesan antara sidepanel, content script, dan offscreen document
• Polling autentikasi magic-link
• Polling dashboard bridge untuk sinkronisasi pasien dan hasil engine kanonik
• Orkestrasi CDSS (mengkoordinasikan alur diagnosis)
• Penjadwalan berbasis Chrome Alarms untuk tugas periodik

Content scripts (entrypoints/content.ts, entrypoints/inject.content.ts)

Content script berjalan dalam konteks halaman ePuskesmas:

• content.ts — content script standar yang men-scrape data DOM dan berkomunikasi dengan background script melalui @webext-core/messaging.
• inject.content.ts — diinjeksikan ke main world ketika ePuskesmas membutuhkan eksekusi main-world untuk manipulasi formulir.

Manajemen state

State ekstensi dikelola oleh store Zustand (lib/store.ts) dengan persistensi chrome.storage.local. Store menyimpan encounter aktif, konteks pasien, saran diagnosis, dan state UI. Store memiliki TTL 24 jam pada data encounter untuk mencegah informasi basi.

Direktori utama

Batasan keamanan

graph LR
    subgraph "Ekstensi Peramban"
        SP[Sidepanel]
        BG[Background]
        CS[Content Script]
    end
    subgraph "Jaringan Eksternal"
        API[Sentra Dashboard API]
        LLM[DeepSeek / Ollama]
    end
    subgraph "Halaman Host"
        EP[ePuskesmas EMR]
    end

    SP <-->|pesan terstruktur| BG
    BG <-->|HTTPS + API key| API
    BG -.->|opsional| LLM
    CS <-->|DOM saja| EP
    SP -.->|chrome.sidePanel| SP

• Content script hanya dapat membaca/menulis DOM ePuskesmas. Ia tidak memiliki akses jaringan.
• Background script menangani semua panggilan API eksternal. API key disimpan di chrome.storage.local, tidak pernah di content script.
• Data pasien di-hash dengan SHA-256 (lib/api/pii-guard.ts) sebelum permintaan jaringan apa pun.
• PII di-mask (utils/name-masking.ts) di log dan UI.

Output build

WXT membangun ekstensi ke dalam .output/:

Halaman terkait

• Panduan memulai — cara build dan menjalankan secara lokal
• Iskandar Diagnosis Engine — pipeline CDSS inti
• Deteksi darurat — protokol keselamatan 4-gerbang
• Otomasi formulir DAS — adaptive DOM scraping dan auto-fill