Metodologi Standarisasi, Quality Gate, dan Kueri SQL
Visualisasi pada aplikasi ini hanyalah lapisan hilir dari alur deterministik: inspeksi byte file sumber, pemadanan kode wilayah Kemendagri–BPS, pemeriksaan 14 aturan kualitas, dan publikasi snapshot atomik.
Semantik nilai nol, kosong, dan diblokir
Larangan keras terhadap fillna(0) | Kondisi data sumber | Representasi DB | Tampilan UI |
| Tercatat eksplisit bernilai 0 (mis. PKM Rawat Inap Kota Balikpapan) | value=0, validated | 0 unit |
| Kosong, tanda strip (-), atau TAD pada sumber | NULL, missing_in_source | — (Tidak tercatat) |
| Tahun pembilang & penyebut tidak sepadan (mis. rasio 2025) | NULL, year_mismatch | — (Tahun tak sepadan) |
| Gagal aturan kualitas kritis (mis. korupsi serial waktu Excel) | NULL, blocked_quality | Diblokir DQ |
Temuan nyata pada file Satu Data Kaltim
Terbukti pada audit 18 Nov 2026 - Label CSV berisi byte XLSX (SRC-DOC): File 1 TENAGA DOKTER.csv memiliki magic bytes PK\x03\x04 dan SHA-256 identik dengan 1-dokter.xlsx.
- Salah ketik kode wilayah duplikat (SRC-DOC): Baris Kota Bontang (R65) tertulis berkode 6472.0 (milik Kota Samarinda); diselesaikan lewat kamus otoritas nama dan dicatat pada DQ-003.
- Benturan kode Kemendagri vs BPS: SRC-PKM-RI dan SRC-PKM-NRI memakai kode BPS (6402=Kutai Barat) sedangkan SRC-DOC memakai Kemendagri (6402=Kutai Kartanegara).
- Korupsi serial waktu Excel (SRC-DOC-RATIO-BAD): Rasio 45,05 berubah menjadi 1,877083 hari dan penduduk kabupaten terpotong desimal; dikarantina penuh oleh DQ-005 & DQ-009.
Tabel jembatan kode wilayah resmi (Kepmendagri vs BPS)
Mencegah pertukaran data 4 kabupaten saat penggabungan lintas sumber | Wilayah administratif | Level | Kode Kanonik (Kemendagri) | Numerik Kemendagri | Numerik BPS | Status kesamaan kode |
| Kabupaten Paser | Kabupaten | 64.01 | 6401 | 6401 | Identik |
| Kabupaten Kutai Kartanegara | Kabupaten | 64.02 | 6402 | 6403 | Wajib jembatan kode |
| Kabupaten Berau | Kabupaten | 64.03 | 6403 | 6405 | Wajib jembatan kode |
| Kabupaten Kutai Barat | Kabupaten | 64.07 | 6407 | 6402 | Wajib jembatan kode |
| Kabupaten Kutai Timur | Kabupaten | 64.08 | 6408 | 6404 | Wajib jembatan kode |
| Kabupaten Penajam Paser Utara | Kabupaten | 64.09 | 6409 | 6409 | Identik |
| Kabupaten Mahakam Ulu | Kabupaten | 64.11 | 6411 | 6411 | Identik |
| Kota Balikpapan | Kota | 64.71 | 6471 | 6471 | Identik |
| Kota Samarinda | Kota | 64.72 | 6472 | 6472 | Identik |
| Kota Bontang | Kota | 64.74 | 6474 | 6474 | Identik |
Contoh kueri SQL pelacakan rasio ke sel sumber (PostgreSQL 16+)
Memisahkan tabel curated_facts dan derived_facts via derived_fact_inputs SELECT
r.region_code,
r.short_name AS wilayah,
df.value_numeric AS dokter_per_100rb,
num_cf.value_numeric AS jumlah_tenaga_medis,
num_cf.source_locator AS sel_dokter,
den_cf.value_numeric AS jumlah_penduduk,
den_cf.source_locator AS sel_penduduk
FROM published_snapshots ps
JOIN snapshot_derived_facts sdf ON sdf.snapshot_id = ps.snapshot_id
JOIN derived_facts df ON df.derived_fact_id = sdf.derived_fact_id
JOIN regions r ON r.region_code = df.region_code
JOIN derived_fact_inputs num_e ON num_e.derived_fact_id = df.derived_fact_id AND num_e.input_role = 'numerator'
JOIN curated_facts num_cf ON num_cf.fact_id = num_e.source_fact_id
JOIN derived_fact_inputs den_e ON den_e.derived_fact_id = df.derived_fact_id AND den_e.input_role = 'denominator'
JOIN curated_facts den_cf ON den_cf.fact_id = den_e.source_fact_id
WHERE ps.status = 'active'
AND df.metric_code = 'doctor_per_100k'
AND df.reference_year = 2024
ORDER BY df.value_numeric DESC;