Repository navigation
Features
Ivan William Harsono edited this page Nov 17, 2026
·
4 revisions
Bahasa / Language: English · Bahasa Indonesia
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)
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
-
Data types — 33 classes with
to_array(). They are plain Python objects;Noneand""are dropped from the output, and no validation happens at this layer. -
Builders — one
snake_casefluent API per resource, returningdictfrombuild(). -
HTTP —
SSRequest, synchronous, with token refresh, retry and a request log. -
Responses —
SSResponseandSSValidationError, which turn anOperationOutcomeinto rule numbers and affected paths.
-
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 —
SSValidationErrormaps 558 Ministry rule numbers, so an error message can be answered programmatically instead of by eye. -
Retry classification —
ErrorClassifierreturnsretryable, 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.
- 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
requestsis 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.
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)
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
-
Tipe data — 33 kelas dengan
to_array(). Objek Python biasa;Nonedan""dibuang dari keluaran, dan tidak ada validasi di lapisan ini. -
Builder — satu API lancar
snake_caseper resource,build()mengembalikandict. -
HTTP —
SSRequest, sinkron, dengan penyegaran token, ulangan, dan log permintaan. -
Respons —
SSResponsedanSSValidationError, yang mengubahOperationOutcomemenjadi nomor aturan dan path terdampak.
-
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 —
SSValidationErrormemetakan 558 nomor aturan Kementerian, jadi pesan galat bisa dijawab secara program, bukan dengan mata. -
Klasifikasi ulangan —
ErrorClassifiermengembalikanretryable, 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.
- 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
requestssatu 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.