Master Wilayah Administratif Indonesia

Master Wilayah Administratif (master_regions) adalah entitas data spasial fondasional yang menjadi rujukan tunggal pembagian wilayah Republik Indonesia di seluruh ekosistem Nexa Intelligence Platform. Entitas ini menaungi 38 Provinsi, 514 Kabupaten/Kota, hingga tingkat Kecamatan dan Kelurahan.

Data ini menjadi jangkar bagi seluruh visualisasi peta interaktif (Choropleth Map), agregasi data kewilayahan (Situational Digital Twin), penentuan yurisdiksi kepolisian, serta pelacakan distribusi logistik pemilu dan pengadaan daerah.

1. Struktur Hierarki Wilayah 4 Tingkat

Wilayah administratif Indonesia disusun dalam relasi hierarkis induk-anak (parent-child):

Tingkat 1: PROVINSI (38 Provinsi di Indonesia)
 └── Tingkat 2: KABUPATEN / KOTA (514 Daerah Tingkat II)
      └── Tingkat 3: KECAMATAN (Distrik)
           └── Tingkat 4: KELURAHAN / DESA

Klasifikasi & Cakupan Level

2. Skema Tabel PostgreSQL master_regions

Tabel master_regions di PostgreSQL menyimpan seluruh simpul administratif dengan relasi rekursif:

CREATE TABLE master_regions (
    id INTEGER PRIMARY KEY,
    parent_id INTEGER REFERENCES master_regions(id),
    region_name TEXT NOT NULL,              -- Nama baku (misal: "Jawa Timur", "Kota Surabaya")
    region_level TEXT NOT NULL,             -- 'province', 'city', 'district', 'village'
    public_id UUID NOT NULL UNIQUE DEFAULT gen_random_uuid()
);

-- Indeks performa relasi hierarkis
CREATE INDEX idx_regions_parent ON master_regions(parent_id);
CREATE INDEX idx_regions_level ON master_regions(region_level);

Kamus Variasi Ejaan Daerah (region_spellings)

Karena artikel berita siber dan media sosial sering menggunakan nama singkatan atau variasi bahasa daerah (misal: "Jogja", "DIY", "Jateng", "Sulsel", "Kota Bandung" vs "Bandung"), backend memelihara kamus pemetaan ejaan untuk menjamin akurasi normalisasi lokasi:

"jogja" / "diy" / "yogyakarta"  ──►  ID 34: "D.I. Yogyakarta"
"sulsel" / "sulawesi selatan"    ──►  ID 73: "Sulawesi Selatan"
"surabaya" / "sby"              ──►  ID 3578: "Kota Surabaya"

3. Peran Master Wilayah dalam Ekosistem Platform

Master wilayah administratif bertindak sebagai simpul penghubung (hub) bagi berbagai domain data lainnya:

                                  ┌───────────────────────────────┐
                                  │   master_regions (38 Prov)    │
                                  └───────────────┬───────────────┘
                                                  │
         ┌───────────────────┬────────────────────┼───────────────────┬───────────────────┐
         ▼                   ▼                    ▼                   ▼                   ▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ organization_   │ │ fact_           │ │ kpu_            │ │ cctv_           │ │ province_       │
│ nodes           │ │ procurement_    │ │ presidential_   │ │ directory       │ │ dashboard       │
│ (Polres/Polda)  │ │ regions (LPSE)  │ │ aggregates (TPS)│ │ (Kamera ATCS)   │ │ (Digital Twin)  │
└─────────────────┘ └─────────────────┘ └─────────────────┘ └─────────────────┘ └─────────────────┘

1. Jangkar Visualisasi Peta Choropleth: ID wilayah provinsi (11–94) dipetakan ke kode fitur poligon pada berkas GeoJSON Indonesia 38 provinsi di modul peta dashboard frontend Next.js.
2. Kompilasi Situational Digital Twin: Worker agregasi mengelompokkan data artikel berita, percakapan media sosial, dan tren harga bahan pangan harian berdasarkan region_id untuk menyusun ringkasan situasi provinsi.
3. Foreign Key Lintas Domain:
   • organization_nodes.region_id: Memetakan kantor kepolisian (Polda/Polres) ke wilayah hukum fisiknya.
   • fact_procurement_regions.region_id: Mengikat paket tender lelang ke pemerintah daerah yang menganggarkan.
   • kpu_presidential_aggregates.region_id: Mengagregasi perolehan suara Pilpres/Pilkada hingga tingkat kabupaten/kota.
   • cctv_directory.region_id: Menghubungkan titik kamera streaming lalu lintas ke pemerintah kota terkait.