Skip to content

Features

Ivan William Harsono edited this page Nov 17, 2026 · 4 revisions

Features

Bahasa / Language: English · Bahasa Indonesia

Python 3.10+ FHIR R4 PyPI


English

What is in the package

Measured from the source tree, not from a release note:

141  payload builders          satusehat_integration/builder/
141  parsers                   satusehat_integration/parser/
 33  data type classes         satusehat_integration/datatype/datatypes.py
 28  terminology modules       satusehat_integration/terminology/
  8  queue modules             satusehat_integration/queue/
144  R5 builder modules        satusehat_integration/r5/builder/
148  R4 resources (3,716 element paths)  satusehat_integration/conformance/_r4_elements_generated.py
2,080 passing tests (+2 skipped)

The four layers

DataType classes      PayloadBuilder            SSRequest                SATUSEHAT API
Identifier            PatientBuilder()          ss.post("Patient", …)    POST /fhir-r4/v1/Patient
HumanName     →       .add_name(…)       →      response.is_success()    GET  /fhir-r4/v1/Patient/{id}
CodeableConcept       .set_gender("male")       response.get_resource_id()
Reference             .build() → dict
  1. Data types — 33 classes with to_array(). They are plain Python objects; None and "" are dropped from the output, and no validation happens at this layer.
  2. Builders — one snake_case fluent API per resource, returning dict from build().
  3. HTTP — SSRequest, synchronous, with token refresh, retry and a request log.
  4. Responses — SSResponse and SSValidationError, which turn an OperationOutcome into rule numbers and affected paths.

Correctness features

  • R4 element guard — 148 R4 resources and 3,716 element paths, so a builder that sets an element outside the specification can be caught before the request is sent (conformance/r4_element_guard.py).
  • Rule numbers — SSValidationError maps 558 Ministry rule numbers, so an error message can be answered programmatically instead of by eye.
  • Retry classification — ErrorClassifier returns retryable, so a queue never has to guess which 400s are worth retrying.
  • R5 namespace, additive — 144 modules mirror the R4 builders for the newer specification without changing R4 imports.

What it deliberately does not do

  • No business rules. It does not know which fields your clinic requires; that belongs to the application.
  • No persistence. No database, no cache directory, no files in $HOME.
  • No async. Synchronous by design: the server is the bottleneck and requests is one dependency fewer than an event loop.
  • Seven builders target names that are not FHIR R4 resources (BillingStatus, ChargeItemResponse, GenomicStudy, ImagingManifest, ImagingSelection, PurificationDecision, ResourceGuide); they exist because SATUSEHAT's own catalogue used them, and a real R4 server rejects them.

Bahasa Indonesia

Isi paket

Diukur dari kode sumber, bukan dari catatan rilis:

141  payload builder          satusehat_integration/builder/
141  parser                    satusehat_integration/parser/
 33  kelas tipe data          satusehat_integration/datatype/datatypes.py
 28  modul terminologi        satusehat_integration/terminology/
  8  modul antrean            satusehat_integration/queue/
144  modul builder R5         satusehat_integration/r5/builder/
148  resource R4 (3.716 jalur elemen)  satusehat_integration/conformance/_r4_elements_generated.py
2.080 uji lulus (+2 dilewati)

Empat lapisan

Kelas DataType        PayloadBuilder            SSRequest                API SATUSEHAT
Identifier            PatientBuilder()          ss.post("Patient", …)    POST /fhir-r4/v1/Patient
HumanName     →       .add_name(…)       →      response.is_success()    GET  /fhir-r4/v1/Patient/{id}
CodeableConcept       .set_gender("male")       response.get_resource_id()
Reference             .build() → dict
  1. Tipe data — 33 kelas dengan to_array(). Objek Python biasa; None dan "" dibuang dari keluaran, dan tidak ada validasi di lapisan ini.
  2. Builder — satu API lancar snake_case per resource, build() mengembalikan dict.
  3. HTTP — SSRequest, sinkron, dengan penyegaran token, ulangan, dan log permintaan.
  4. Respons — SSResponse dan SSValidationError, yang mengubah OperationOutcome menjadi nomor aturan dan path terdampak.

Fitur kebenaran data

  • Penjaga elemen R4 — 148 resource R4 dan 3.716 jalur elemen, sehingga builder yang menyetel elemen di luar spesifikasi bisa tertangkap sebelum permintaan dikirim (conformance/r4_element_guard.py).
  • Nomor aturan — SSValidationError memetakan 558 nomor aturan Kementerian, jadi pesan galat bisa dijawab secara program, bukan dengan mata.
  • Klasifikasi ulangan — ErrorClassifier mengembalikan retryable, sehingga antrean tidak perlu menebak 400 mana yang layak diulang.
  • Namespace R5, aditif — 144 modul mencerminkan builder R4 untuk spesifikasi yang lebih baru tanpa mengubah impor R4.

Yang sengaja tidak dilakukan

  • Tanpa aturan bisnis. Paket ini tidak tahu field mana yang wajib di klinik Anda; itu urusan aplikasi.
  • Tanpa penyimpanan. Tidak ada basis data, direktori cache, atau berkas di $HOME.
  • Tanpa async. Sinkron sejak awal: server adalah hambatannya, dan requests satu dependensi lebih sedikit daripada event loop.
  • Tujuh builder menyasar nama yang bukan resource FHIR R4 (BillingStatus, ChargeItemResponse, GenomicStudy, ImagingManifest, ImagingSelection, PurificationDecision, ResourceGuide); semuanya ada karena katalog SATUSEHAT sendiri pernah memakainya, dan server R4 sungguhan menolaknya.

Clone this wiki locally