diff --git a/.env.example b/.env.example
index 78ccc0d3..393f4ed1 100644
--- a/.env.example
+++ b/.env.example
@@ -80,6 +80,13 @@ LONGITUDE_MAP = 115.046600
 API_DATABASE_GABUNGAN_HOST=http://127.0.0.1:8001
 SANCTUM_STATEFUL_DOMAINS=localhost
 
+# DataSpasial - API Satu Data (App\Services\DataSpasialApiService)
+# Base URL & token mengikuti pengaturan database gabungan (API_DATABASE_GABUNGAN_HOST
+# dan Setting `database_gabungan_api_key`); TIDAK ada env khusus untuk keduanya.
+# Batas waktu permintaan (detik) & masa cache baca (detik, 0 = nonaktif).
+API_DATASPASIAL_TIMEOUT=10
+API_DATASPASIAL_CACHE_TTL=300
+
 # OTP Configuration
 OTP_TOKEN_EXPIRES_MINUTES=5
 OTP_MAX_VERIFICATION_ATTEMPTS=3
diff --git a/app/Enums/DataSpasialReason.php b/app/Enums/DataSpasialReason.php
new file mode 100644
index 00000000..d141835f
--- /dev/null
+++ b/app/Enums/DataSpasialReason.php
@@ -0,0 +1,78 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Enums;
+
+use BenSampo\Enum\Enum;
+
+/**
+ * Penyebab data DataSpasial tidak dapat diperoleh.
+ *
+ * CATATAN PENTING: enum ini hanya untuk keperluan diagnosa (log backend).
+ * `ModuleNotInstalled` dan `ServiceUnavailable` sengaja menghasilkan
+ * `DataSpasialStatus::Unavailable` yang sama sehingga UI tidak perlu
+ * membedakan keduanya maupun memetakan teks pesan dari API (FR-014).
+ *
+ * @method static static NotConfigured()
+ * @method static static Timeout()
+ * @method static static ConnectionFailed()
+ * @method static static ServiceUnavailable()
+ * @method static static ModuleNotInstalled()
+ * @method static static Unauthorized()
+ * @method static static SchemaVersionUnsupported()
+ * @method static static ClientError()
+ */
+final class DataSpasialReason extends Enum
+{
+    /**
+     * URL dasar atau token API belum dikonfigurasi (FR-003).
+     */
+    public const NotConfigured = 'not_configured';
+
+    /**
+     * API tidak menjawab dalam batas waktu (FR-004).
+     */
+    public const Timeout = 'timeout';
+
+    /**
+     * Kegagalan koneksi: DNS, TCP, atau TLS.
+     */
+    public const ConnectionFailed = 'connection_failed';
+
+    /**
+     * Status 5xx selain 503.
+     */
+    public const ServiceUnavailable = 'http_5xx';
+
+    /**
+     * Status 503 pada endpoint DataSpasial: modul belum terpasang atau
+     * versinya tidak cocok (API-02 / #467).
+     */
+    public const ModuleNotInstalled = 'module_not_installed';
+
+    /**
+     * Status 401 (token ditolak) atau 403 (ability tidak cukup).
+     */
+    public const Unauthorized = 'unauthorized';
+
+    /**
+     * Status 400 dengan error_code SchemaVersionUnsupported.
+     */
+    public const SchemaVersionUnsupported = 'schema_version_unsupported';
+
+    /**
+     * Status 4xx lainnya: 404, 409, 422.
+     */
+    public const ClientError = 'client_error';
+
+    /**
+     * Pesan yang ditampilkan ke pengguna akhir untuk semua penyebab di atas.
+     * WAJIB generik — jangan pernah menyertakan detail teknis (FR-014/FR-016).
+     */
+    public static function userMessage(): string
+    {
+        return config('dataspasial.unavailable_message')
+            ?? 'Data sementara tidak tersedia. Silakan coba lagi nanti.';
+    }
+}
diff --git a/app/Enums/DataSpasialStatus.php b/app/Enums/DataSpasialStatus.php
new file mode 100644
index 00000000..087352ef
--- /dev/null
+++ b/app/Enums/DataSpasialStatus.php
@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Enums;
+
+use BenSampo\Enum\Enum;
+
+/**
+ * Status hasil pemanggilan API Satu Data.
+ *
+ * Tiga nilai ini adalah pembeda utama antara "data memang kosong" dan
+ * "data tidak dapat diperoleh" (FR-005). View WAJIB bercabang berdasarkan
+ * nilai ini, bukan berdasarkan apakah array kosong.
+ *
+ * @method static static Data()
+ * @method static static Empty()
+ * @method static static Unavailable()
+ */
+final class DataSpasialStatus extends Enum
+{
+    /**
+     * Respons sukses berisi minimal satu item.
+     */
+    public const Data = 'data';
+
+    /**
+     * Respons sukses tanpa data (FR-015).
+     */
+    public const Empty = 'empty';
+
+    /**
+     * Data tidak dapat diperoleh sementara (FR-014).
+     */
+    public const Unavailable = 'unavailable';
+}
diff --git a/app/Enums/Modul.php b/app/Enums/Modul.php
index d91a2426..513ad538 100644
--- a/app/Enums/Modul.php
+++ b/app/Enums/Modul.php
@@ -272,6 +272,43 @@ final class Modul extends Enum
                 ],
             ],
         ],
+        [
+            'text' => 'DataSpasial',
+            'icon' => 'fas fa-map',
+            'permission' => 'dataspasial',
+            'submenu' => [
+                [
+                    'icon' => 'far fa-fw fa-circle',
+                    'text' => 'Skema DataSpasial',
+                    'url' => 'dataspasial/skema',
+                    'permission' => 'dataspasial-skema',
+                ],
+                [
+                    'icon' => 'far fa-fw fa-circle',
+                    'text' => 'Peta Gabungan',
+                    'url' => 'dataspasial/peta',
+                    'permission' => 'dataspasial-peta',
+                ],
+                [
+                    'icon' => 'far fa-fw fa-circle',
+                    'text' => 'Dasbor DataSpasial',
+                    'url' => 'dataspasial/dasbor',
+                    'permission' => 'dataspasial-dasbor',
+                ],
+                [
+                    'icon' => 'far fa-fw fa-circle',
+                    'text' => 'Impor Data',
+                    'url' => 'dataspasial/impor',
+                    'permission' => 'dataspasial-impor',
+                ],
+                [
+                    'icon' => 'far fa-fw fa-circle',
+                    'text' => 'Monitoring',
+                    'url' => 'dataspasial/monitoring',
+                    'permission' => 'dataspasial-monitoring',
+                ],
+            ],
+        ],
         [
             'text' => 'SOTK',
             'icon' => 'fa fa-tags',
diff --git a/app/Enums/StatusSkemaEditor.php b/app/Enums/StatusSkemaEditor.php
new file mode 100644
index 00000000..7132306b
--- /dev/null
+++ b/app/Enums/StatusSkemaEditor.php
@@ -0,0 +1,75 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Enums;
+
+use BenSampo\Enum\Enum;
+
+/**
+ * Keadaan editor skema pada satu sektor di sisi UI.
+ *
+ * INI BUKAN state yang disimpan di API — enum ini hanya memodelkan "apa yang
+ * boleh diinteraksi" pada satu render halaman, sehingga aturan tombol simpan
+ * dan tombol tambah isian tidak tersebar di setiap Blade.
+ *
+ * Status sebenarnya (`draf` / `terbit`) datang dari API; `Kosong` dan
+ * `BelumTersedia` diturunkan dari hasil `DataSpasialResult` (FR-005/FR-006).
+ *
+ * @method static static Kosong()
+ * @method static static Draf()
+ * @method static static Terbit()
+ * @method static static BelumTersedia()
+ */
+final class StatusSkemaEditor extends Enum
+{
+    /**
+     * Sektor belum punya skema sama sekali (FR-008b).
+     */
+    public const Kosong = 'kosong';
+
+    /**
+     * Sedang ada draf berjalan — satu-satunya keadaan yang dapat diubah (FR-008b).
+     */
+    public const Draf = 'draf';
+
+    /**
+     * Hanya ada versi terbit — ditampilkan baca-saja (FR-008a).
+     */
+    public const Terbit = 'terbit';
+
+    /**
+     * Sumber data tidak dapat dihubungi; seluruh tombol nonaktif (FR-005).
+     */
+    public const BelumTersedia = 'belum_tersedia';
+
+    /**
+     * Tombol "Simpan draf" hanya aktif pada keadaan draf (FR-008b).
+     */
+    public function bolehSimpan(): bool
+    {
+        return $this->value === self::Draf;
+    }
+
+    /**
+     * Tombol tambah/hapus/urut isian hanya aktif pada keadaan draf (FR-008a).
+     */
+    public function bolehUbah(): bool
+    {
+        return $this->value === self::Draf;
+    }
+
+    /**
+     * Menyusun keadaan editor dari skema yang dipilih.
+     *
+     * @param  array{status: string, jumlah_skema: int}  $skema
+     */
+    public static function dari(array $skema): self
+    {
+        return match ($skema['status'] ?? '') {
+            self::Terbit => self::fromValue(self::Terbit),
+            self::Draf => self::fromValue(self::Draf),
+            default => self::fromValue(($skema['jumlah_skema'] ?? 0) > 0 ? self::Terbit : self::Kosong),
+        };
+    }
+}
diff --git a/app/Enums/TipeIsian.php b/app/Enums/TipeIsian.php
new file mode 100644
index 00000000..257fa0dc
--- /dev/null
+++ b/app/Enums/TipeIsian.php
@@ -0,0 +1,52 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Enums;
+
+use BenSampo\Enum\Enum;
+
+/**
+ * Tipe isian pada skema kabupaten (FR-010).
+ *
+ * Nilai ini mengikuti enum `tipe` pada entitas `ds_isian` di kontrak
+ * `openapi-fondasi.yaml` (`components.schemas.Isian`). Nilai BARU hanya boleh
+ * ditambah lewat perubahan kontrak API-01, bukan diam-diam di sini.
+ *
+ * @method static static Angka()
+ * @method static static Teks()
+ * @method static static Pilihan()
+ * @method static static YaTidak()
+ * @method static static Tanggal()
+ */
+final class TipeIsian extends Enum
+{
+    public const Angka = 'angka';
+
+    public const Teks = 'teks';
+
+    public const Pilihan = 'pilihan';
+
+    public const YaTidak = 'ya_tidak';
+
+    public const Tanggal = 'tanggal';
+
+    /**
+     * Kolom "opsi" hanya berlaku untuk tipe `pilihan` (FR-010).
+     *
+     * Method helper pada enum ini yang dipakai view agar keputusan
+     * "opsi berlaku atau tidak" TIDAK diulang di setiap Blade.
+     */
+    public function memakaiPilihan(): bool
+    {
+        return $this->value === self::Pilihan;
+    }
+
+    /**
+     * Satuan relevan hanya untuk tipe yang menyimpan besaran (FR-010).
+     */
+    public function memakaiSatuan(): bool
+    {
+        return $this->value === self::Angka;
+    }
+}
diff --git a/app/Exceptions/DataSpasialUnavailableException.php b/app/Exceptions/DataSpasialUnavailableException.php
new file mode 100644
index 00000000..aadd57a0
--- /dev/null
+++ b/app/Exceptions/DataSpasialUnavailableException.php
@@ -0,0 +1,42 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Exceptions;
+
+use App\Enums\DataSpasialReason;
+use Exception;
+use Throwable;
+
+/**
+ * Penanda internal bahwa data DataSpasial tidak dapat diperoleh sementara.
+ *
+ * Exception ini dipakai agar method internal di dalam service dapat keluar
+ * lebih awal tanpa menduplikasi penanganan kegagalan. Exception ini TIDAK
+ * PERNAH boleh lepas ke controller — pemanggil publik selalu memperoleh
+ * `App\Services\DataSpasialResult` dengan status `unavailable`.
+ */
+class DataSpasialUnavailableException extends Exception
+{
+    public function __construct(
+        public readonly DataSpasialReason $reason,
+        public readonly string $endpoint = '',
+        public readonly int $httpStatus = 0,
+        ?string $message = null,
+        ?Throwable $previous = null
+    ) {
+        parent::__construct(
+            $message ?? $reason->value,
+            0,
+            $previous
+        );
+    }
+
+    /**
+     * Pesan yang aman ditampilkan ke pengguna akhir (FR-014).
+     */
+    public function userMessage(): string
+    {
+        return DataSpasialReason::userMessage();
+    }
+}
diff --git a/app/Http/Controllers/DataSpasial/DasborDataSpasialController.php b/app/Http/Controllers/DataSpasial/DasborDataSpasialController.php
new file mode 100644
index 00000000..ad65c658
--- /dev/null
+++ b/app/Http/Controllers/DataSpasial/DasborDataSpasialController.php
@@ -0,0 +1,38 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\DataSpasial;
+
+use App\Services\DataSpasialResult;
+use Illuminate\Http\Request;
+
+/**
+ * Menu Dasbor DataSpasial.
+ *
+ * Kerangka menu pada fase fondasi ini. Agregat dan visualisasi penuh
+ * menjadi lingkup KAB-08 (OpenSID/OpenKab#1304).
+ */
+class DasborDataSpasialController extends DataSpasialController
+{
+    protected function pageTitle(): string
+    {
+        return 'Dasbor DataSpasial';
+    }
+
+    protected function viewName(): string
+    {
+        return 'dataspasial.dasbor.index';
+    }
+
+    protected function fetch(Request $request): DataSpasialResult
+    {
+        return $this->dataspasial->ringkasan($request->only([
+            'sektor_id',
+            'periode',
+            'kode_kabupaten',
+            'kode_kecamatan',
+            'kode_desa',
+        ]));
+    }
+}
diff --git a/app/Http/Controllers/DataSpasial/DataSpasialController.php b/app/Http/Controllers/DataSpasial/DataSpasialController.php
new file mode 100644
index 00000000..5fb1565f
--- /dev/null
+++ b/app/Http/Controllers/DataSpasial/DataSpasialController.php
@@ -0,0 +1,51 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\DataSpasial;
+
+use App\Http\Controllers\Controller;
+use App\Services\DataSpasialApiService;
+use App\Services\DataSpasialResult;
+use Illuminate\Contracts\View\View;
+use Illuminate\Http\Request;
+
+/**
+ * Kerangka dasar untuk kelima halaman menu DataSpasial.
+ *
+ * Aturan yang berlaku untuk semua halaman:
+ * - HANYA membaca lewat `DataSpasialApiService` (FR-002/SC-009);
+ * - controller TIDAK melempar exception HTTP ke view — kegagalan API sudah
+ *   diterjemahkan menjadi `DataSpasialResult` berstatus `unavailable`
+ *   (FR-014);
+ * - respons selalu HTTP 200 agar kerangka halaman & navigasi tetap utuh.
+ */
+abstract class DataSpasialController extends Controller
+{
+    public function __construct(protected DataSpasialApiService $dataspasial) {}
+
+    /**
+     * Nama tampilan halaman untuk judul & breadcrumb.
+     */
+    abstract protected function pageTitle(): string;
+
+    /**
+     * View kerangka halaman.
+     */
+    abstract protected function viewName(): string;
+
+    /**
+     * Ambil data dari service. Method ini tidak pernah melempar exception.
+     *
+     * @param  array<string, mixed>  $filters
+     */
+    abstract protected function fetch(Request $request): DataSpasialResult;
+
+    public function index(Request $request): View
+    {
+        return view($this->viewName(), [
+            'title' => $this->pageTitle(),
+            'result' => $this->fetch($request),
+        ]);
+    }
+}
diff --git a/app/Http/Controllers/DataSpasial/ImporDataController.php b/app/Http/Controllers/DataSpasial/ImporDataController.php
new file mode 100644
index 00000000..0b566665
--- /dev/null
+++ b/app/Http/Controllers/DataSpasial/ImporDataController.php
@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\DataSpasial;
+
+use App\Services\DataSpasialResult;
+use Illuminate\Http\Request;
+
+/**
+ * Menu Impor Data (Operator Impor).
+ *
+ * Kerangka menu pada fase fondasi ini. Alur impor lengkap (template, validasi
+ * per baris, ringkasan ditolak/konflik) menjadi lingkup KAB-04.
+ */
+class ImporDataController extends DataSpasialController
+{
+    protected function pageTitle(): string
+    {
+        return 'Impor Data';
+    }
+
+    protected function viewName(): string
+    {
+        return 'dataspasial.impor.index';
+    }
+
+    protected function fetch(Request $request): DataSpasialResult
+    {
+        return $this->dataspasial->listFasilitas($request->only([
+            'sektor_id',
+            'skema_versi_id',
+            'kode_desa',
+        ]));
+    }
+}
diff --git a/app/Http/Controllers/DataSpasial/MonitoringController.php b/app/Http/Controllers/DataSpasial/MonitoringController.php
new file mode 100644
index 00000000..cbba0982
--- /dev/null
+++ b/app/Http/Controllers/DataSpasial/MonitoringController.php
@@ -0,0 +1,39 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\DataSpasial;
+
+use App\Services\DataSpasialResult;
+use Illuminate\Http\Request;
+
+/**
+ * Menu Monitoring.
+ *
+ * Kerangka menu pada fase fondasi ini. Daftar entri audit lengkap menjadi
+ * lingkup KAB-08.
+ */
+class MonitoringController extends DataSpasialController
+{
+    protected function pageTitle(): string
+    {
+        return 'Monitoring';
+    }
+
+    protected function viewName(): string
+    {
+        return 'dataspasial.monitoring.index';
+    }
+
+    protected function fetch(Request $request): DataSpasialResult
+    {
+        return $this->dataspasial->adopsi($request->only([
+            'sektor_id',
+            'skema_versi_id',
+            'status_adopsi',
+            'kode_kabupaten',
+            'kode_kecamatan',
+            'kode_desa',
+        ]));
+    }
+}
diff --git a/app/Http/Controllers/DataSpasial/PetaGabunganController.php b/app/Http/Controllers/DataSpasial/PetaGabunganController.php
new file mode 100644
index 00000000..58998df9
--- /dev/null
+++ b/app/Http/Controllers/DataSpasial/PetaGabunganController.php
@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\DataSpasial;
+
+use App\Services\DataSpasialResult;
+use Illuminate\Http\Request;
+
+/**
+ * Menu Peta Gabungan.
+ *
+ * Kerangka menu pada fase fondasi ini. Peta geospasial penuh menjadi lingkup
+ * KAB-04 (OpenSID/OpenKab#1299).
+ */
+class PetaGabunganController extends DataSpasialController
+{
+    protected function pageTitle(): string
+    {
+        return 'Peta Gabungan';
+    }
+
+    protected function viewName(): string
+    {
+        return 'dataspasial.peta.index';
+    }
+
+    protected function fetch(Request $request): DataSpasialResult
+    {
+        return $this->dataspasial->geojsonGabungan($request->only([
+            'sektor_id',
+            'kode_kabupaten',
+            'kode_kecamatan',
+            'kode_desa',
+        ]));
+    }
+}
diff --git a/app/Http/Controllers/DataSpasial/SkemaDataSpasialController.php b/app/Http/Controllers/DataSpasial/SkemaDataSpasialController.php
new file mode 100644
index 00000000..84f66e3c
--- /dev/null
+++ b/app/Http/Controllers/DataSpasial/SkemaDataSpasialController.php
@@ -0,0 +1,259 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\DataSpasial;
+
+use App\Enums\StatusSkemaEditor;
+use App\Http\Requests\DataSpasial\StoreDrafSkemaRequest;
+use App\Http\Requests\DataSpasial\TerbitSkemaRequest;
+use App\Services\DataSpasialApiService;
+use App\Services\DataSpasialResult;
+use App\Services\SkemaEditorService;
+use Illuminate\Contracts\View\View;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Log;
+
+/**
+ * Menu Skema DataSpasial — editor skema kabupaten (KAB-02 / #1297).
+ *
+ * Ketentuan yang berlaku:
+ * - HANYA membaca/menulis lewat `DataSpasialApiService` (FR-004/SC-010);
+ * - daftar skema baru muncul SETELAH admin memilih sektor (FR-007a);
+ * - penerbitan memakai KODE sektor pada path, bukan id (FR-041);
+ * - kegagalan API diterjemahkan menjadi pesan generik, bukan halaman error
+ *   (FR-005/FR-021).
+ */
+class SkemaDataSpasialController extends DataSpasialController
+{
+    public function __construct(
+        DataSpasialApiService $dataspasial,
+        private readonly SkemaEditorService $editor,
+    ) {
+        parent::__construct($dataspasial);
+    }
+
+    protected function pageTitle(): string
+    {
+        return 'Skema DataSpasial';
+    }
+
+    protected function viewName(): string
+    {
+        return 'dataspasial.skema.index';
+    }
+
+    /**
+     * Data awal untuk kerangka editor dua panel.
+     *
+     * Halaman editor memerlukan daftar sektor sebagai sumber kebenarannya,
+     * sehingga `fetch()` membaca sektor (bukan daftar skema seperti kerangka
+     * sebelumnya).
+     */
+    protected function fetch(Request $request): DataSpasialResult
+    {
+        return $this->dataspasial->listSektor(['page[size]' => 200]);
+    }
+
+    public function index(Request $request): View
+    {
+        // ⚠️ KUNJUNGAN PERTAMA (FR-007a-1/Q7): yang dipanggil HANYA daftar sektor.
+        $resultSektor = $this->fetch($request);
+        $daftarSektor = $this->editor->petakanDaftarSektor($resultSektor->data);
+
+        $sektorTerpilih = $this->sektorTerpilih($request, $daftarSektor);
+
+        // ⚠️ Q22 — tidak ada lagi daftar skema. Setelah sektor dipilih, editor
+        // langsung memuat isian skema terakhir via satu pemanggilan
+        // `GET /dataspasial/skema?sektor={kode}` (parameter wajib).
+        $isian = [];
+        $skemaTerpilih = null;
+
+        if ($sektorTerpilih !== null) {
+            $resultSkema = $this->dataspasial->listSkema([
+                'sektor' => $sektorTerpilih['kode'],
+            ]);
+
+            [$isian] = $this->muatIsian($resultSkema);
+
+            $item = is_array($resultSkema?->first()) ? $resultSkema->first() : null;
+            $atribut = is_array($item['attributes'] ?? null) ? $item['attributes'] : [];
+            $versi = is_array($atribut['versi_skema'] ?? null) ? $atribut['versi_skema'] : [];
+            $skemaTerpilih = [
+                'status' => (string) ($versi['status'] ?? ''),
+                'jumlah_skema' => 1,
+            ];
+        }
+
+        // Status global: bila sektor tidak dapat diperoleh, seluruh tombol mati.
+        if ($resultSektor->isUnavailable()) {
+            $statusEditor = StatusSkemaEditor::BelumTersedia();
+        } else {
+            $statusEditor = $this->editor->statusEditor($skemaTerpilih, $daftarSektor);
+        }
+
+        return view($this->viewName(), [
+            'title' => $this->pageTitle(),
+            'resultSektor' => $resultSektor,
+            'daftarSektor' => $daftarSektor,
+            'sektorTerpilih' => $sektorTerpilih,
+            'skemaTerpilih' => $skemaTerpilih,
+            'isian' => $isian,
+            'statusEditor' => $statusEditor,
+        ]);
+    }
+
+    /**
+     * Simpan draf skema (FR-029 … FR-033, Q18/Q19/Q20/Q23).
+     *
+     * Sektor dan seluruh isian dikirim dalam satu permintaan
+     * `POST /dataspasial/skema`. Kode sektor dibangkitkan sistem dari nama
+     * (Q5) dan dikirim sebagai `sektor`; nama sektor dikirim sebagai
+     * `sektor_nama`. Minimal satu isian wajib (Q23).
+     *
+     * Q21 — selalu via AJAX (JSON); balas JSON untuk request AJAX, redirect
+     * untuk formulir biasa. Kegagalan → pesan "data sementara tidak tersedia",
+     * isi editor utuh, tanpa muat ulang halaman.
+     */
+    public function storeDraf(StoreDrafSkemaRequest $request): RedirectResponse|JsonResponse
+    {
+        $validated = $request->validated();
+        $sektorNama = trim((string) ($validated['sektor_nama'] ?? ''));
+
+        // ⚠️ FR-007d-5 — kode sektor TIDAK PERNAH berubah karena nama diubah.
+        // Kode yang dikirim klien dipakai apa adanya; kode baru hanya
+        // dibangkitkan dari nama bila klien tidak mengirimnya, yaitu pada mode
+        // "sektor baru" (Q26/FR-008f).
+        $sektorKode = trim((string) ($validated['sektor'] ?? ''));
+
+        if ($sektorKode === '') {
+            $sektorKode = $this->editor->kodeSektorDariNama($sektorNama);
+        }
+
+        $body = $this->editor->composeDrafPayload($validated['isian'] ?? [], [
+            'sektor' => $sektorKode,
+            'sektor_nama' => $sektorNama,
+            'keterangan' => $validated['keterangan'] ?? null,
+        ]);
+
+        $result = $this->dataspasial->buatDrafSkema($body);
+
+        if ($result->isUnavailable()) {
+            Log::warning('DataSpasial: penyimpanan draf gagal', [
+                'sektor' => $sektorKode,
+                'reason' => $result->reason?->value,
+                'http_status' => $result->httpStatus,
+            ]);
+
+            $pesan = $result->userMessage() ?: 'Data sementara tidak tersedia.';
+
+            if ($request->ajax() || $request->wantsJson()) {
+                return response()->json(['success' => false, 'message' => $pesan], 503);
+            }
+
+            return back()
+                ->withInput()
+                ->with('error', $pesan);
+        }
+
+        if ($request->ajax() || $request->wantsJson()) {
+            return response()->json([
+                'success' => true,
+                'message' => 'Draf skema berhasil disimpan.',
+                'sektor' => $sektorKode,
+                'data' => $result->first(),
+            ]);
+        }
+
+        return redirect()
+            ->route('dataspasial.skema', array_filter([
+                'sektor' => $sektorKode,
+            ]))
+            ->with('success', 'Draf skema berhasil disimpan.');
+    }
+
+    /**
+     * Terbitkan draf skema menjadi versi `terbit` (US8, FR-041 … FR-044).
+     *
+     * ⚠️ UTANG KONTRAK U6 — `POST /dataspasial/skema/{sektor}/terbit` belum ada
+     * di kontrak v0.1.0 maupun API hidup. Kegagalan **tidak boleh** mengubah
+     * draf yang sudah ada (FR-043).
+     *
+     * ⚠️ Path memakai **kode** sektor, bukan id numerik.
+     */
+    public function terbit(TerbitSkemaRequest $request): RedirectResponse
+    {
+        $validated = $request->validated();
+
+        $sektorKode = trim((string) $validated['sektor']);
+
+        $result = $this->dataspasial->terbitkanSkema($sektorKode, array_filter([
+            'catatan_perubahan' => $validated['catatan_perubahan'] ?? null,
+        ], fn ($v): bool => filled($v)));
+
+        if ($result->isUnavailable()) {
+            Log::warning('DataSpasial: penerbitan skema gagal', [
+                'sektor' => $sektorKode,
+                'reason' => $result->reason?->value,
+                'http_status' => $result->httpStatus,
+            ]);
+
+            return back()
+                ->withInput()
+                ->with('error', $result->userMessage());
+        }
+
+        return redirect()
+            ->route('dataspasial.skema', array_filter([
+                'sektor' => $sektorKode,
+                'skema' => $result->first()['id'] ?? $validated['skema'] ?? null,
+            ]))
+            ->with('success', 'Skema berhasil diterbitkan.');
+    }
+
+    /**
+     * @param  array<int, array<string, mixed>>  $daftarSektor
+     * @return array<string, mixed>|null
+     */
+    private function sektorTerpilih(Request $request, array $daftarSektor): ?array
+    {
+        $kode = (string) $request->query('sektor', '');
+
+        if ($kode === '') {
+            return null;
+        }
+
+        foreach ($daftarSektor as $sektor) {
+            if ($sektor['kode'] === $kode) {
+                return $sektor;
+            }
+        }
+
+        return null;
+    }
+
+    /**
+     * Muat isian skema terpilih beserta pemetaannya.
+     *
+     * @param  array<string, mixed>|null  $skemaTerpilih
+     * @return array{0: array<int, array<string, mixed>>, 1: DataSpasialResult|null}
+     */
+    private function muatIsian(?DataSpasialResult $resultSkema): array
+    {
+        // ⚠️ K2 — endpoint `GET /skema/{id}` tidak ada (404). Isian ikut pada
+        // respons `GET /skema?sektor=`. Bila respons belum ada, tidak ada yang
+        // dimuat dan TIDAK ada request sia-sia yang dikirim.
+        $item = is_array($resultSkema?->first()) ? $resultSkema->first() : null;
+
+        if ($item === null) {
+            return [[], $resultSkema];
+        }
+
+        $atribut = is_array($item['attributes'] ?? null) ? $item['attributes'] : [];
+        $itemIsian = is_array($atribut['isian'] ?? null) ? $atribut['isian'] : [];
+
+        return [$this->editor->petakanDaftarIsian($itemIsian), $resultSkema];
+    }
+}
diff --git a/app/Http/Requests/DataSpasial/StoreDrafSkemaRequest.php b/app/Http/Requests/DataSpasial/StoreDrafSkemaRequest.php
new file mode 100644
index 00000000..d958ad7b
--- /dev/null
+++ b/app/Http/Requests/DataSpasial/StoreDrafSkemaRequest.php
@@ -0,0 +1,251 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Requests\DataSpasial;
+
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\Rule;
+use Illuminate\Validation\Validator;
+
+/**
+ * Validasi penyimpanan draf skema (FR-017 … FR-021).
+ *
+ * Semua aturan di sini berjalan **sebelum** request dikirim ke API (FR-020),
+ * sehingga API tidak pernah menerima kode isian bentrok atau tidak valid dari
+ * pengguna ini.
+ *
+ * ⚠️ **Batas validasi**: tabel isian berada di API Satu Data, bukan di MySQL
+ * OpenKab. Karena itu `Rule::unique()` **tidak dapat dipakai** — keunikan kode
+ * dalam satu draf diperiksa dengan closure terhadap array badan yang sama
+ * (FR-018: unik per sektor/draf, boleh dipakai ulang lintas versi).
+ */
+class StoreDrafSkemaRequest extends FormRequest
+{
+    /**
+     * Otorisasi ditegakkan lewat `permission:dataspasial-skema-write` pada route.
+     */
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function rules(): array
+    {
+        return [
+            // ⚠️ Q5/Q19/Q26 — `sektor` adalah KODE sektor yang **dibangkitkan
+            // backend dari `sektor_nama`**, jadi untuk sektor baru klien
+            // mengirimnya kosong; yang wajib dari klien adalah `sektor_nama`.
+            'sektor' => ['nullable', 'string', 'max:100'],
+            'sektor_nama' => ['required', 'string', 'max:100'],
+            'keterangan' => ['nullable', 'string', 'max:500'],
+
+            // FR-019/Q23: sebuah sektor tidak boleh memiliki nol isian —
+            // setidaknya satu isian wajib dalam satu permintaan penyimpanan.
+            'isian' => ['required', 'array', 'min:1'],
+
+            // FR-017/Q14: `kode` adalah nilai TURUNAN dari `label`, bukan
+            // ketikan admin. Aturan di bawah memverifikasi INTEGRITAS nilai
+            // turunan itu, karena FR-018 tetap mewajibkan kode hasil bangkit
+            // memenuhi pola snake_case.
+            'isian.*.kode' => ['required', 'string', 'max:100', 'regex:/^[a-z][a-z0-9_]*$/'],
+            'isian.*.label' => ['required', 'string', 'max:255'],
+            'isian.*.tipe' => ['required', 'string', Rule::in(['angka', 'teks', 'pilihan', 'ya_tidak', 'tanggal'])],
+            'isian.*.wajib' => ['boolean'],
+            'isian.*.satuan' => ['nullable', 'string', 'max:50'],
+            // FR-019: isian wajib tipe `pilihan` harus punya ≥1 butir.
+            'isian.*.opsi' => ['nullable', 'array'],
+            'isian.*.opsi.*' => ['string', 'max:100'],
+            'isian.*.urutan' => ['required', 'integer', 'min:1'],
+
+            // ⚠️ R12 — nama field INTERNAL sesuai tampilan/view (`popupPeta`,
+            // `sebagaiFilter`, `sebagaiIndikator`, `tabelSumber`, `kolomSumber`).
+            // Terjemahan ke nama tulis DataSpasial (`tampil_di_*`,
+            // `tabel_sumber`, `kolom_sumber`) hanya di SkemaEditorService.
+            'isian.*.popupPeta' => ['boolean'],
+            'isian.*.sebagaiFilter' => ['boolean'],
+            'isian.*.sebagaiIndikator' => ['boolean'],
+            // ⚠️ Bentuk API hanya punya SATU nilai `rujukan_sumber`
+            // ("tabel.kolom", §6a.4) —ini rujukan yang dikirim klien.
+            // `tabelSumber`/`kolomSumber` tetap diterima agar klien lama /
+            // ISIan yang dipecah di sisi tampilan tetap kompatibel.
+            'isian.*.sumber' => ['nullable', 'string', Rule::in(['openSID', 'dataPresisi', 'impor', 'manual'])],
+            'isian.*.rujukan' => ['nullable', 'string', 'max:201'],
+            'isian.*.tabelSumber' => ['nullable', 'string', 'max:100'],
+            'isian.*.kolomSumber' => ['nullable', 'string', 'max:100'],
+        ];
+    }
+
+    /**
+     * Aturan yang tidak bisa dinyatakan sebagai rule Laravel biasa.
+     */
+    public function withValidator(Validator $validator): void
+    {
+        $validator->after(function (Validator $validator): void {
+            $this->tolakKodeBentrok($validator);
+            $this->tolakPilihanKosong($validator);
+            $this->tolakRujukanKosong($validator);
+        });
+    }
+
+    /**
+     * FR-022/Q20 — sumber nilai selain `manual` wajib punya rujukan.
+     *
+     * ⚠️ Rujukan diterima sebagai `rujukan` ("tabel.kolom"); bila klien hanya
+     * mengirim `tabelSumber` + `kolomSumber`, keduanya disambung di sini —
+     * bentuk akhir yang disimpan adalah `rujukan_sumber`.
+     */
+    private function tolakRujukanKosong(Validator $validator): void
+    {
+        $isian = $this->input('isian');
+
+        if (! is_array($isian)) {
+            return;
+        }
+
+        foreach ($isian as $index => $baris) {
+            if (! is_array($baris)) {
+                continue;
+            }
+
+            $sumber = trim((string) ($baris['sumber'] ?? ''));
+
+            if ($sumber === '' || $sumber === 'manual') {
+                continue;
+            }
+
+            $rujukan = trim((string) ($baris['rujukan'] ?? ''));
+
+            if ($rujukan === '') {
+                $rujukan = implode('.', array_filter([
+                    trim((string) ($baris['tabelSumber'] ?? '')),
+                    trim((string) ($baris['kolomSumber'] ?? '')),
+                ], static fn (string $bagian): bool => $bagian !== ''));
+            }
+
+            if ($rujukan === '') {
+                $validator->errors()->add(
+                    "isian.{$index}.rujukan",
+                    'Rujukan sumber wajib diisi bila sumber nilai bukan manual.'
+                );
+            }
+        }
+    }
+
+    /**
+     * FR-018/Q17 — `label` dan `kode` yang sama lebih dari satu kali di dalam
+     * SATU versi yang sedang disusun.
+     *
+     * ⚠️ Cakupannya **satu versi** (`sektor` + `nomor_versi`), bukan lintas
+     * versi: satu request hanya berisi satu versi, dan draf berikutnya disalin
+     * dari versi sebelumnya sehingga label yang sama harus boleh dipakai lagi
+     * pada versi yang lebih baru (Q17).
+     */
+    private function tolakKodeBentrok(Validator $validator): void
+    {
+        $isian = $this->input('isian');
+
+        if (! is_array($isian)) {
+            return;
+        }
+
+        $terlihatKode = [];
+        $terlihatLabel = [];
+
+        foreach ($isian as $index => $baris) {
+            if (! is_array($baris)) {
+                continue;
+            }
+
+            $kode = trim((string) ($baris['kode'] ?? ''));
+
+            if ($kode !== '') {
+                if (isset($terlihatKode[$kode])) {
+                    $validator->errors()->add(
+                        "isian.{$index}.kode",
+                        "Kode isian \"{$kode}\" sudah dipakai isian lain pada versi ini. "
+                        .'Ubah label isian agar kode berbeda — kode tidak diberi akhiran angka otomatis.'
+                    );
+                } else {
+                    $terlihatKode[$kode] = true;
+                }
+            }
+
+            $label = trim((string) ($baris['label'] ?? ''));
+
+            if ($label !== '') {
+                if (isset($terlihatLabel[$label])) {
+                    $validator->errors()->add(
+                        "isian.{$index}.label",
+                        "Label isian \"{$label}\" sudah dipakai isian lain pada versi ini. "
+                        .'Label isian harus unik di dalam satu versi.'
+                    );
+                } else {
+                    $terlihatLabel[$label] = true;
+                }
+            }
+        }
+    }
+
+    /**
+     * FR-019 — isian (wajib maupun tidak) tipe `pilihan` wajib punya butir.
+     */
+    private function tolakPilihanKosong(Validator $validator): void
+    {
+        $isian = $this->input('isian');
+
+        if (! is_array($isian)) {
+            return;
+        }
+
+        foreach ($isian as $index => $baris) {
+            if (! is_array($baris) || ($baris['tipe'] ?? null) !== 'pilihan') {
+                continue;
+            }
+
+            $opsi = array_values(array_filter(
+                is_array($baris['opsi'] ?? null) ? $baris['opsi'] : [],
+                static fn ($item): bool => is_string($item) && trim($item) !== '',
+            ));
+
+            if ($opsi === []) {
+                $validator->errors()->add(
+                    "isian.{$index}.opsi",
+                    'Isian tipe "pilihan" harus memiliki minimal satu butir pilihan.'
+                );
+            }
+        }
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    public function messages(): array
+    {
+        return [
+            'isian.*.kode.required' => 'Kode isian wajib diisi (dibangkitkan otomatis dari label).',
+            'isian.*.kode.max' => 'Kode isian maksimal 100 karakter.',
+            'isian.required' => 'Sektor harus memiliki minimal satu isian.',
+            'isian.min' => 'Sektor harus memiliki minimal satu isian.',
+            'sektor_nama.required' => 'Nama sektor wajib diisi.',
+        ];
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    public function attributes(): array
+    {
+        return [
+            'isian' => 'isian',
+            'isian.*.kode' => 'kode isian',
+            'isian.*.label' => 'label isian',
+            'isian.*.tipe' => 'tipe isian',
+            'isian.*.opsi' => 'pilihan',
+            'isian.*.urutan' => 'urutan',
+        ];
+    }
+}
diff --git a/app/Http/Requests/DataSpasial/TerbitSkemaRequest.php b/app/Http/Requests/DataSpasial/TerbitSkemaRequest.php
new file mode 100644
index 00000000..989687ad
--- /dev/null
+++ b/app/Http/Requests/DataSpasial/TerbitSkemaRequest.php
@@ -0,0 +1,66 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Requests\DataSpasial;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+/**
+ * Validasi penerbitan draf skema (FR-041, FR-042).
+ *
+ * ⚠️ **Hanya memvalidasi bentuk, bukan keunikan.** Pencemian keunikan Against
+ * data yang dimiliki API TIDAK dilakukan di sini — penamaan dan keunikan
+ * menjadi tanggung jawab sisi API (spec Q13/Q14). FormRequest ini hanya
+ * menjaga agar permintaan yang bentuknya salah tidak pernah dikirim.
+ *
+ * ⚠️ `sektor` yang dikirim adalah **kode** sektor karena `{sektor}` pada path
+ * `POST /dataspasial/skema/{sektor}/terbit` adalah kode sektor.
+ *
+ * ⚠️ UTANG KONTRAK U6 — endpoint tersebut belum ada di kontrak v0.1.0 maupun
+ * di API yang hidup.
+ */
+class TerbitSkemaRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function rules(): array
+    {
+        return [
+            'sektor' => ['required', 'string', 'max:100'],
+            'skema' => ['nullable', 'integer', 'min:1'],
+            'catatan_perubahan' => ['nullable', 'string', 'max:500'],
+        ];
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    public function messages(): array
+    {
+        return [
+            'sektor.required' => 'Sektor wajib diisi.',
+            'skema.integer' => 'Skema tidak valid.',
+            'skema.min' => 'Skema tidak valid.',
+            'catatan_perubahan.max' => 'Catatan perubahan maksimal 500 karakter.',
+        ];
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    public function attributes(): array
+    {
+        return [
+            'sektor' => 'sektor',
+            'skema' => 'skema',
+            'catatan_perubahan' => 'catatan perubahan',
+        ];
+    }
+}
diff --git a/app/Services/ArtikelService.php b/app/Services/ArtikelService.php
index 0b0874f3..e71dde3f 100644
--- a/app/Services/ArtikelService.php
+++ b/app/Services/ArtikelService.php
@@ -230,4 +230,3 @@ public function clearAllCache(): void
         Cache::forget($this->cacheRegistryKey);
     }
 }
-
diff --git a/app/Services/BaseApiService.php b/app/Services/BaseApiService.php
index 86b70fc1..fcbf0580 100644
--- a/app/Services/BaseApiService.php
+++ b/app/Services/BaseApiService.php
@@ -24,7 +24,10 @@ public function __construct()
         $this->header = [
             'Accept' => 'application/ld+json',
             'Content-Type' => 'application/json',
-            'Authorization' => 'Bearer '.$this->settings['database_gabungan_api_key'] ?? '',
+            // Catatan: pada PHP, '.' mengikat lebih kuat daripada '??', sehingga
+            // 'Bearer '.$x['k'] ?? '' tetap menghitung akses array tanpa
+            // perlindungan. Tanda kurung diperlukan.
+            'Authorization' => 'Bearer '.($this->settings['database_gabungan_api_key'] ?? ''),
         ];
         $this->baseUrl = config('app.databaseGabunganUrl');
         $this->kodeKecamatan = str_replace('.', '', config('profil.kecamatan_id'));
diff --git a/app/Services/CaptchaService.php b/app/Services/CaptchaService.php
index bbc4cdf6..9a41c632 100644
--- a/app/Services/CaptchaService.php
+++ b/app/Services/CaptchaService.php
@@ -2,16 +2,15 @@
 
 namespace App\Services;
 
+use App\Models\Setting;
 use Illuminate\Http\Request;
+use Illuminate\Support\Facades\RateLimiter;
 use Illuminate\Support\Facades\Session;
 
 class CaptchaService
 {
     /**
      * Validate captcha using Mews\Captcha
-     *
-     * @param string $code
-     * @return bool
      */
     public function validate(string $code): bool
     {
@@ -20,8 +19,6 @@ public function validate(string $code): bool
 
     /**
      * Get captcha image URL
-     *
-     * @return string
      */
     public function getImageUrl(): string
     {
@@ -30,55 +27,50 @@ public function getImageUrl(): string
 
     /**
      * Check if CAPTCHA is enabled
-     *
-     * @return bool
      */
     public function isEnabled(): bool
     {
-        $settings = \App\Models\Setting::pluck('value', 'key')->toArray();
+        $settings = Setting::pluck('value', 'key')->toArray();
+
         return filter_var($settings['captcha_enabled'] ?? true, FILTER_VALIDATE_BOOLEAN);
     }
 
     /**
      * Check if captcha should be shown based on failed attempts
-     *
-     * @param Request $request
-     * @return bool
      */
     public function shouldShow(Request $request): bool
     {
-        $settings = \App\Models\Setting::pluck('value', 'key')->toArray();
+        $settings = Setting::pluck('value', 'key')->toArray();
         $enabled = filter_var($settings['captcha_enabled'] ?? true, FILTER_VALIDATE_BOOLEAN);
         $threshold = (int) ($settings['captcha_threshold'] ?? 2);
 
-        if (!$enabled) {
+        if (! $enabled) {
             return false;
         }
 
         $key = $this->getRateLimitKey($request);
-        $attempts = \Illuminate\Support\Facades\RateLimiter::attempts($key);
+        $attempts = RateLimiter::attempts($key);
 
         return $attempts >= $threshold;
     }
 
     /**
      * Get captcha configuration from database
-     *
-     * @return array
      */
     public function getCaptchaConfig(): array
     {
-        $settings = \App\Models\Setting::pluck('value', 'key')->toArray();
+        $settings = Setting::pluck('value', 'key')->toArray();
         $type = $settings['captcha_type'] ?? 'builtin';
         // jika menggunakan recaptcha v3, pastikan sitekey dan secret key terisi
-        if($type == 'google'){
-            if(empty($settings['google_recaptcha_site_key']) or empty($settings['google_recaptcha_secret_key'])){
+        if ($type == 'google') {
+            if (empty($settings['google_recaptcha_site_key']) or empty($settings['google_recaptcha_secret_key'])) {
                 $type = 'builtin';
             }
         }
+
         return [
             'enabled' => filter_var($settings['captcha_enabled'] ?? true, FILTER_VALIDATE_BOOLEAN),
-'type' => $type,
+            'type' => $type,
             'threshold' => (int) ($settings['captcha_threshold'] ?? 2),
             'google_site_key' => $settings['google_recaptcha_site_key'] ?? '',
             'google_secret_key' => $settings['google_recaptcha_secret_key'] ?? '',
@@ -87,9 +79,6 @@ public function getCaptchaConfig(): array
 
     /**
      * Get rate limit key for request
-     *
-     * @param Request $request
-     * @return string
      */
     protected function getRateLimitKey(Request $request): string
     {
@@ -101,32 +90,24 @@ protected function getRateLimitKey(Request $request): string
 
     /**
      * Increment failed attempts
-     *
-     * @param Request $request
-     * @return void
      */
     public function incrementFailedAttempts(Request $request): void
     {
         $key = $this->getRateLimitKey($request);
-        \Illuminate\Support\Facades\RateLimiter::hit($key, 300);
+        RateLimiter::hit($key, 300);
     }
 
     /**
      * Reset failed attempts
-     *
-     * @param Request $request
-     * @return void
      */
     public function resetFailedAttempts(Request $request): void
     {
         $key = $this->getRateLimitKey($request);
-        \Illuminate\Support\Facades\RateLimiter::clear($key);
+        RateLimiter::clear($key);
     }
 
     /**
      * Clear captcha session
-     *
-     * @return void
      */
     public function clearCaptchaSession(): void
     {
diff --git a/app/Services/ConfigApiService.php b/app/Services/ConfigApiService.php
index 6c21e796..0dd7f3c2 100644
--- a/app/Services/ConfigApiService.php
+++ b/app/Services/ConfigApiService.php
@@ -2,6 +2,7 @@
 
 namespace App\Services;
 
+use App\Models\Identitas;
 use Illuminate\Support\Facades\Cache;
 
 class ConfigApiService extends BaseApiService
@@ -14,11 +15,11 @@ public function desa(array $filters = [])
 
         return Cache::remember($cacheKey, $this->cacheTtl, function () use ($filters) {
             $data = $this->apiRequest('/api/v1/config/desa', $filters);
-            if (!$data) {
+            if (! $data) {
                 return collect([]);
             }
 
-            return collect($data)->map(fn($item) => (object) $item['attributes']);
+            return collect($data)->map(fn ($item) => (object) $item['attributes']);
         });
     }
 
@@ -26,7 +27,7 @@ public function desaConfig(array $filters = [])
     {
         // Panggil API dan ambil data
         $data = $this->apiRequest('/api/v1/config/desa', $filters);
-        if (!$data) {
+        if (! $data) {
             return collect([]);
         }
 
@@ -44,30 +45,31 @@ public function kecamatan(array $filters = [])
 
         return Cache::remember($cacheKey, $this->cacheTtl, function () use ($filters) {
             $data = $this->apiRequest('/api/v1/config/kecamatan', $filters);
-            if (!$data) {
+            if (! $data) {
                 return collect([]);
             }
 
-            return collect($data)->map(fn($item) => (object) $item['attributes']);
+            return collect($data)->map(fn ($item) => (object) $item['attributes']);
         });
     }
 
     public function kabupaten(array $filters = [])
     {
         if (empty($filters)) {
-            $identitas = \App\Models\Identitas::first();
+            $identitas = Identitas::first();
             $kode_kabupaten = str_replace('.', '', $identitas->kode_kabupaten);
             $filters['filter[kode_kabupaten]'] = $kode_kabupaten;
         }
 
         $cacheKey = $this->buildCacheKey('config_kabupaten', $filters);
+
         return Cache::remember($cacheKey, $this->cacheTtl, function () use ($filters) {
             $data = $this->apiRequest('/api/v1/config/kabupaten', $filters);
-            if (!$data) {
+            if (! $data) {
                 return collect([]);
             }
 
-            return collect($data)->map(fn($item) => (object) $item['attributes']);
+            return collect($data)->map(fn ($item) => (object) $item['attributes']);
         });
     }
 
diff --git a/app/Services/DataSpasialApiService.php b/app/Services/DataSpasialApiService.php
new file mode 100644
index 00000000..41ba9867
--- /dev/null
+++ b/app/Services/DataSpasialApiService.php
@@ -0,0 +1,589 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Services;
+
+use App\Enums\DataSpasialReason;
+use App\Exceptions\DataSpasialUnavailableException;
+use App\Models\Setting;
+use Illuminate\Contracts\Cache\Repository;
+use Illuminate\Http\Client\ConnectionException;
+use Illuminate\Http\Client\PendingRequest;
+use Illuminate\Http\Client\Response;
+use Illuminate\Support\Facades\Auth;
+use Illuminate\Support\Facades\Cache;
+use Illuminate\Support\Facades\Http;
+use Illuminate\Support\Facades\Log;
+
+/**
+ * Pintu tunggal seluruh pemanggilan API Satu Data `/api/v1/dataspasial/*`
+ * (FR-002).
+ *
+ *Aturan yang WAJIB dipatuhi modul lain:
+ * - tidak boleh memanggil `Http::` langsung ke endpoint DataSpasial (SC-009);
+ * - setiap method publik selalu mengembalikan `DataSpasialResult` dan TIDAK
+ *   pernah melempar exception HTTP ke pemanggil;
+ * - pesan teknis dari API hanya masuk log, tidak pernah sampai ke view (FR-016).
+ *
+ * Sengaja TIDAK extends `BaseApiService`: signature `array`-returning dan
+ * flash `error_api` milik class itu tidak dapat memenuhi FR-005 tanpa
+ * mengubah service lain yang sudah berjalan (lihat research.md R14).
+ */
+class DataSpasialApiService
+{
+    /**
+     * Kunci cache yang menyimpan nomor generasi cache baca.
+     */
+    private const GENERATION_KEY = 'dataspasial:cache-generation';
+
+    public function isConfigured(): bool
+    {
+        return $this->baseUrl() !== '' && $this->resolveToken() !== '';
+    }
+
+    /**
+     * URL dasar API Satu Data — mengikuti pengaturan database gabungan (R1).
+     */
+    public function baseUrl(): string
+    {
+        return rtrim((string) config('app.databaseGabunganUrl', ''), '/');
+    }
+
+    /**
+     * Token dari Setting pengaturan database gabungan (R1).
+     *
+     * Tidak ada konfigurasi/env khusus DataSpasial: kredensial yang sama dipakai
+     * oleh service database gabungan lainnya.
+     */
+    public function resolveToken(): string
+    {
+        return (string) (Setting::where('key', 'database_gabungan_api_key')->first()?->value ?? '');
+    }
+
+    public function timeout(): int
+    {
+        $timeout = (int) config('dataspasial.timeout', 10);
+
+        return $timeout > 0 ? $timeout : 10;
+    }
+
+    public function cacheTtl(): int
+    {
+        return max(0, (int) config('dataspasial.cache_ttl', 300));
+    }
+
+    /**
+     * Header identitas pemanggil agar tercatat pada audit API (API-07 / #473).
+     *
+     * Header selalu dikirim; bila tidak ada konteks pengguna keduanya kosong
+     * sehingga sisi API dapat membedakan "klien tanpa konteks" dari
+     * "header tidak dikirim" (R7).
+     *
+     * @return array<string, string>
+     */
+    public function userHeaders(): array
+    {
+        $user = Auth::user();
+
+        return [
+            (string) config('dataspasial.user_id_header', 'X-OpenKab-User-Id') => (string) ($user?->id ?? ''),
+            (string) config('dataspasial.user_name_header', 'X-OpenKab-User-Name') => (string) ($user?->name ?? ''),
+        ];
+    }
+
+    /**
+     * Path absolut endpoint DataSpasial relatif terhadap base URL.
+     */
+    public function endpoint(string $path): string
+    {
+        $prefix = rtrim((string) config('dataspasial.path_prefix', '/api/v1/dataspasial'), '/');
+
+        return $prefix.'/'.ltrim($path, '/');
+    }
+
+    /**
+     * Kunci cache untuk operasi baca pada path + query tertentu.
+     *
+     * Memuat nomor generasi cache agar invalidasi menjadi O(1) tanpa perlu
+     * menyisir kunci satu per satu (lihat `invalidateCache()`).
+     *
+     * @param  array<string, mixed>  $query
+     */
+    public function cacheKey(string $path, array $query = []): string
+    {
+        ksort($query);
+
+        return (string) config('dataspasial.cache_prefix', 'dataspasial:get:')
+            .$this->cacheGeneration()
+            .':'.ltrim($path, '/')
+            .':'.md5($this->normalizeQuery($query));
+    }
+
+    /**
+     * Nomor generasi cache saat ini.
+     */
+    public function cacheGeneration(): int
+    {
+        return (int) ($this->cacheStore()->get(self::GENERATION_KEY) ?? 0);
+    }
+
+    public function isAvailable(DataSpasialResult $result): bool
+    {
+        return ! $result->isUnavailable();
+    }
+
+    /**
+     * @param  array<string, mixed>  $query
+     * @param  array<string, mixed>|null  $body
+     */
+    protected function request(
+        string $method,
+        string $path,
+        array $query = [],
+        ?array $body = null,
+        ?int $schemaVersion = null
+    ): DataSpasialResult {
+        $path = $this->endpoint($path);
+        $isRead = strtoupper($method) === 'GET';
+
+        if (! $this->isConfigured()) {
+            Log::warning('DataSpasial: konfigurasi tidak lengkap', [
+                'endpoint' => $path,
+                'method' => strtoupper($method),
+                'has_base_url' => $this->baseUrl() !== '',
+            ]);
+
+            return DataSpasialResult::unavailable(DataSpasialReason::fromValue(DataSpasialReason::NotConfigured));
+        }
+
+        $cacheKey = $this->cacheKey($path, $query);
+
+        if ($isRead && $this->cacheTtl() > 0) {
+            $cached = $this->cacheStore()->get($cacheKey);
+
+            if (is_array($cached) && isset($cached['status'])) {
+                return DataSpasialResult::fromCachePayload($cached);
+            }
+        }
+
+        try {
+            $response = $this->httpClient($schemaVersion)
+                ->send(strtoupper($method), $this->baseUrl().$path, array_filter([
+                    'query' => $query ?: null,
+                    'json' => $body,
+                ], static fn ($value) => $value !== null));
+        } catch (DataSpasialUnavailableException $exception) {
+            return DataSpasialResult::unavailable(
+                $exception->reason,
+                $exception->httpStatus,
+                $exception->getMessage()
+            );
+        } catch (ConnectionException $exception) {
+            return $this->logAndReturnUnavailable(
+                DataSpasialReason::fromValue(
+                    $this->isTimeout($exception) ? DataSpasialReason::Timeout : DataSpasialReason::ConnectionFailed
+                ),
+                $path,
+                $method,
+                0,
+                $exception->getMessage()
+            );
+        } catch (\Throwable $exception) {
+            return $this->logAndReturnUnavailable(
+                DataSpasialReason::fromValue(DataSpasialReason::ConnectionFailed),
+                $path,
+                $method,
+                0,
+                $exception->getMessage()
+            );
+        }
+
+        $result = $this->toResult($response, $path);
+
+        if ($isRead) {
+            // Hanya hasil sukses yang di-cache; `unavailable` tidak pernah
+            // dibekukan agar outage tidak bertahan selama TTL (R8).
+            if (! $result->isUnavailable()) {
+                $this->remember($cacheKey, $result);
+            }
+        } elseif (! $result->isUnavailable()) {
+            $this->invalidateCache();
+        }
+
+        return $result;
+    }
+
+    /**
+     * Bangun `PendingRequest` lengkap dengan token, timeout, dan header audit.
+     */
+    protected function httpClient(?int $schemaVersion = null): PendingRequest
+    {
+        $client = Http::withHeaders(array_merge([
+            'Accept' => 'application/json',
+            'Authorization' => 'Bearer '.$this->resolveToken(),
+        ], $this->userHeaders()))
+            ->timeout($this->timeout());
+
+        $client = $client->withHeader('Content-Type', 'application/json');
+
+        if ($schemaVersion !== null) {
+            $client = $client->withHeader('X-Schema-Version', (string) $schemaVersion);
+        }
+
+        return $client;
+    }
+
+    /**
+     * Map respons HTTP menjadi `DataSpasialResult` sesuai kontrak §4.1.
+     */
+    protected function toResult(Response $response, string $path): DataSpasialResult
+    {
+        $status = $response->status();
+        $payload = $response->json();
+
+        if ($response->successful()) {
+            return $this->fromSuccessfulPayload($payload, $status);
+        }
+
+        $message = is_array($payload) ? ($payload['message'] ?? $response->body()) : $response->body();
+        $errorCode = is_array($payload) ? ($payload['error_code'] ?? null) : null;
+
+        $reason = DataSpasialReason::fromValue(match (true) {
+            $status === 503 => DataSpasialReason::ModuleNotInstalled,
+            $status >= 500 => DataSpasialReason::ServiceUnavailable,
+            $status === 400 && $errorCode === 'SchemaVersionUnsupported' => DataSpasialReason::SchemaVersionUnsupported,
+            in_array($status, [401, 403], true) => DataSpasialReason::Unauthorized,
+            default => DataSpasialReason::ClientError,
+        });
+
+        Log::warning('DataSpasial: permintaan gagal', array_filter([
+            'endpoint' => $path,
+            'http_status' => $status,
+            'reason' => $reason->value,
+            'error_code' => $errorCode,
+            'message' => $message,
+        ], static fn ($value) => $value !== null));
+
+        return DataSpasialResult::unavailable(
+            $reason,
+            $status,
+            is_string($message) ? $message : null
+        );
+    }
+
+    protected function fromSuccessfulPayload(mixed $payload, int $status): DataSpasialResult
+    {
+        $items = $this->extractItems($payload);
+        $meta = $this->extractMeta($payload);
+
+        if ($items === []) {
+            return DataSpasialResult::empty($meta, null, $status);
+        }
+
+        return DataSpasialResult::data($items, $meta, null, $status);
+    }
+
+    /**
+     * Ambil daftar item dari envelope Fractal/JSON:API maupun payload polos.
+     *
+     * @return array<int, array<string, mixed>>
+     */
+    protected function extractItems(mixed $payload): array
+    {
+        if (! is_array($payload)) {
+            return [];
+        }
+
+        // GeoJSON dan agregat (ringkasan) tidak memakai envelope data[].
+        if (array_key_exists('type', $payload) && $payload['type'] === 'FeatureCollection') {
+            return [$payload];
+        }
+
+        $items = $payload['data'] ?? null;
+
+        if ($items === null) {
+            return isset($payload['data']) && is_array($payload['data']) ? [] : [$payload];
+        }
+
+        // `data` bisa berupa objek tunggal (mis. hasil impor) atau daftar item.
+        if (! array_is_list($items)) {
+            return [$items];
+        }
+
+        return array_values(array_filter($items, 'is_array'));
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    protected function extractMeta(mixed $payload): array
+    {
+        if (! is_array($payload)) {
+            return [];
+        }
+
+        return array_filter([
+            'pagination' => is_array($payload['meta']['pagination'] ?? null) ? $payload['meta']['pagination'] : null,
+            'links' => is_array($payload['links'] ?? null) ? $payload['links'] : null,
+        ], static fn ($value) => $value !== null);
+    }
+
+    /**
+     * Simpan hasil baca yang sukses. Respons `unavailable` tidak pernah
+     * di-cache agar outage tidak "membeku" selama TTL (R8).
+     */
+    protected function remember(string $cacheKey, DataSpasialResult $result): void
+    {
+        if ($this->cacheTtl() <= 0) {
+            return;
+        }
+
+        $this->cacheStore()->put($cacheKey, $result->toCachePayload(), $this->cacheTtl());
+    }
+
+    /**
+     * Buang seluruh cache baca DataSpasial.
+     *
+     * Dilakukan dengan menaikkan nomor generasi cache sehingga seluruh kunci
+     * baca lama langsung tidak terjangkau, alih-alih menyisir kunci satu
+     * per satu. Invalidasi sengaja kasar per-namespace: menulis skema
+     * memengaruhi semua baca (nilai, adopsi, ringkasan), sehingga invalidasi
+     * per-endpoint rawan menampilkan data basi (FR-006/SC-008).
+     *
+     * Kunci lama tetap tersimpan sampai TTL-nya habis, namun tidak akan
+     * pernah dibaca lagi.
+     */
+    public function invalidateCache(): void
+    {
+        $store = $this->cacheStore();
+        $next = $this->cacheGeneration() + 1;
+
+        $store->forever(self::GENERATION_KEY, $next);
+
+        Log::debug('DataSpasial: cache baca diinvalidasi', [
+            'prefix' => (string) config('dataspasial.cache_prefix', 'dataspasial:get:'),
+            'generation' => $next,
+        ]);
+    }
+
+    protected function cacheStore(): Repository
+    {
+        $store = config('dataspasial.cache_store');
+
+        return Cache::store($store ?: null);
+    }
+
+    protected function logAndReturnUnavailable(
+        DataSpasialReason $reason,
+        string $path,
+        string $method,
+        int $status,
+        ?string $message
+    ): DataSpasialResult {
+        Log::warning('DataSpasial: permintaan tidak dapat dikirim', array_filter([
+            'endpoint' => $path,
+            'method' => strtoupper($method),
+            'http_status' => $status,
+            'reason' => $reason->value,
+            'message' => $message,
+        ], static fn ($value) => $value !== null));
+
+        return DataSpasialResult::unavailable($reason, $status, $message);
+    }
+
+    protected function isTimeout(ConnectionException $exception): bool
+    {
+        return str_contains(strtolower($exception->getMessage()), 'timed out')
+            || str_contains(strtolower($exception->getMessage()), 'timeout');
+    }
+
+    /**
+     * @param  array<string, mixed>  $query
+     */
+    protected function normalizeQuery(array $query): string
+    {
+        return (string) json_encode($query);
+    }
+
+    // -----------------------------------------------------------------------
+    // Operasi baca (FR-002)
+    // -----------------------------------------------------------------------
+
+    /**
+     * Daftar sektor DataSpasial.
+     *
+     * @param  array<string, mixed>  $filters
+     */
+    public function listSektor(array $filters = []): DataSpasialResult
+    {
+        return $this->request('GET', 'sektor', $filters);
+    }
+
+    /**
+     * Daftar versi skema untuk SATU sektor.
+     *
+     * ⚠️ VERIFIKASI LANGSUNG KE API NYATA (spec Q8 / kontrak §6a.4 K1):
+     * parameter bernama **`sektor`** dan **WAJIB** — `GET /dataspasial/skema`
+     * tanpa parameter itu membalas `422 {"errors":{"sektor":[...]}}`.
+     * Nilai yang diterima berupa id numerik (`4234`) maupun kode (`SK0`).
+     * Parameter `sektor_id` yang tertera pada draft `openapi-fondasi.yaml`
+     * **tidak dikenali** oleh API dan menghasilkan 422.
+     *
+     * ⚠️ (K2) Respons sudah memuat `attributes.isian[]` LENGKAP dengan
+     * `pemetaan[]`, jadi TIDAK ada endpoint detail terpisah.
+     *
+     * @param  array<string, mixed>  $filters  Wajib menyertakan `sektor`.
+     */
+    public function listSkema(array $filters = []): DataSpasialResult
+    {
+        return $this->request('GET', 'skema', $filters);
+    }
+
+    /**
+     * Daftar **seluruh versi** skema milik satu sektor (riwayat versi).
+     *
+     * ⚠️ VERIFIKASI LANGSUNG + pembacaan kode API (spec Q9): endpoint
+     * `GET /dataspasial/skema?sektor={id}` **hanya mengembalikan SATU versi**
+     * (yang sedang aktif), sehingga tidak dapat dipakai sebagai sumber daftar
+     * skema. Endpoint ini — `GET /dataspasial/skema/riwayat?sektor={id}` —
+     * mengembalikan seluruh versi sektor tersebut (nomor versi, status, catatan
+     * perubahan, waktu terbit).
+     *
+     * Parameternya berupa **kode sektor** (bukan id), sama seperti
+     * `sektor()` pada API.
+     *
+     * @param  array<string, mixed>  $filters  Wajib menyertakan `sektor`.
+     */
+    public function riwayatSkema(array $filters = []): DataSpasialResult
+    {
+        return $this->request('GET', 'skema/riwayat', $filters);
+    }
+
+    /**
+     * Detail satu versi skema beserta isiannya.
+     *
+     * @deprecated Endpoint `GET /dataspasial/skema/{id}` **tidak ada** di API
+     *             nyata (mengembalikan 404). Gunakan `listSkema(['sektor' => …])`
+     *             yang sudah menyertakan isian. Dipertahankan sementara agar
+     *             pemanggilan lama tidak langsung rusak saat transisi.
+     */
+    public function detailSkema(int $id): DataSpasialResult
+    {
+        Log::warning('DataSpasial: detailSkema() dipanggil padahal endpoint detail tidak ada', [
+            'skema_id' => $id,
+        ]);
+
+        return $this->request('GET', 'skema/'.$id);
+    }
+
+    /**
+     * Daftar isian skema.
+     *
+     * @param  array<string, mixed>  $filters
+     */
+    public function listIsian(array $filters = []): DataSpasialResult
+    {
+        return $this->request('GET', 'isian', $filters);
+    }
+
+    /**
+     * Daftar pemetaan skema ke sasaran wilayah.
+     *
+     * @param  array<string, mixed>  $filters
+     */
+    public function listPemetaan(array $filters = []): DataSpasialResult
+    {
+        return $this->request('GET', 'pemetaan', $filters);
+    }
+
+    /**
+     * Daftar fasilitas.
+     *
+     * @param  array<string, mixed>  $filters
+     */
+    public function listFasilitas(array $filters = []): DataSpasialResult
+    {
+        return $this->request('GET', 'fasilitas', $filters);
+    }
+
+    /**
+     * Daftar nilai isian.
+     *
+     * @param  array<string, mixed>  $filters
+     */
+    public function listNilai(array $filters = []): DataSpasialResult
+    {
+        return $this->request('GET', 'nilai', $filters);
+    }
+
+    /**
+     * Ringkasan agregat untuk dasbor.
+     *
+     * @param  array<string, mixed>  $filters
+     */
+    public function ringkasan(array $filters = []): DataSpasialResult
+    {
+        return $this->request('GET', 'ringkasan', $filters);
+    }
+
+    /**
+     * FeatureCollection GeoJSON gabungan untuk Peta Gabungan.
+     *
+     * @param  array<string, mixed>  $filters
+     */
+    public function geojsonGabungan(array $filters = []): DataSpasialResult
+    {
+        return $this->request('GET', 'geojson-gabungan', $filters);
+    }
+
+    /**
+     * Status adopsi skema per desa.
+     *
+     * @param  array<string, mixed>  $filters
+     */
+    public function adopsi(array $filters = []): DataSpasialResult
+    {
+        return $this->request('GET', 'adopsi', $filters);
+    }
+
+    // -----------------------------------------------------------------------
+    // Operasi tulis
+    // -----------------------------------------------------------------------
+
+    /**
+     * Buat atau perbarui draf skema beserta isiannya.
+     *
+     * @param  array<string, mixed>  $body
+     */
+    public function buatDrafSkema(array $body, ?int $schemaVersion = null): DataSpasialResult
+    {
+        return $this->request('POST', 'skema', [], $body, $schemaVersion);
+    }
+
+    /**
+     * Terbitkan draf skema menjadi versi `terbit` yang immutable.
+     *
+     * @param  array<string, mixed>  $body
+     */
+    public function terbitkanSkema(string $sektor, array $body, ?int $schemaVersion = null): DataSpasialResult
+    {
+        return $this->request(
+            'POST',
+            'skema/'.rawurlencode($sektor).'/terbit',
+            [],
+            $body,
+            $schemaVersion
+        );
+    }
+
+    /**
+     * Impor nilai isian dalam jumlah besar untuk satu desa dan periode.
+     *
+     * @param  array<string, mixed>  $body
+     */
+    public function imporNilai(array $body, ?int $schemaVersion = null): DataSpasialResult
+    {
+        return $this->request('POST', 'impor', [], $body, $schemaVersion);
+    }
+}
diff --git a/app/Services/DataSpasialResult.php b/app/Services/DataSpasialResult.php
new file mode 100644
index 00000000..e61b77c7
--- /dev/null
+++ b/app/Services/DataSpasialResult.php
@@ -0,0 +1,204 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Services;
+
+use App\Enums\DataSpasialReason;
+use App\Enums\DataSpasialStatus;
+use InvalidArgumentException;
+
+/**
+ * Hasil pemanggilan API Satu Data (FR-005).
+ *
+ * Value object ini memaksa pemanggil memeriksa `status`, sehingga "data
+ * memang kosong" tidak pernah tertukar dengan "data tidak dapat diperoleh"
+ * (FR-014 vs FR-015).
+ *
+ * Immutable: seluruh properti readonly, dibangun lewat named constructor.
+ */
+final class DataSpasialResult
+{
+    /**
+     * @param  array<int, array<string, mixed>>  $data  Item hasil unwrap dari envelope API
+     * @param  array<string, mixed>  $meta  Berisi kunci `pagination` dan `links` bila ada
+     */
+    private function __construct(
+        public readonly DataSpasialStatus $status,
+        public readonly array $data,
+        public readonly array $meta,
+        public readonly ?DataSpasialReason $reason,
+        public readonly int $httpStatus,
+        public readonly ?string $message,
+    ) {
+        $this->assertInvariants();
+    }
+
+    /**
+     * Respons sukses berisi minimal satu item.
+     *
+     * @param  array<int, array<string, mixed>>  $data
+     * @param  array<string, mixed>  $meta
+     */
+    public static function data(array $data, array $meta = [], ?DataSpasialReason $reason = null, int $httpStatus = 200): self
+    {
+        return new self(DataSpasialStatus::fromValue(DataSpasialStatus::Data), $data, $meta, $reason, $httpStatus, null);
+    }
+
+    /**
+     * Respons sukses tanpa data (FR-015).
+     *
+     * @param  array<string, mixed>  $meta
+     */
+    public static function empty(array $meta = [], ?DataSpasialReason $reason = null, int $httpStatus = 200): self
+    {
+        return new self(DataSpasialStatus::fromValue(DataSpasialStatus::Empty), [], $meta, $reason, $httpStatus, null);
+    }
+
+    /**
+     * Data tidak dapat diperoleh sementara (FR-014).
+     *
+     * @param  array<string, mixed>  $meta
+     */
+    public static function unavailable(
+        DataSpasialReason $reason,
+        int $httpStatus = 0,
+        ?string $message = null,
+        array $meta = []
+    ): self {
+        return new self(DataSpasialStatus::fromValue(DataSpasialStatus::Unavailable), [], $meta, $reason, $httpStatus, $message);
+    }
+
+    public function isData(): bool
+    {
+        return $this->status->is(DataSpasialStatus::Data);
+    }
+
+    public function isEmpty(): bool
+    {
+        return $this->status->is(DataSpasialStatus::Empty);
+    }
+
+    public function isUnavailable(): bool
+    {
+        return $this->status->is(DataSpasialStatus::Unavailable);
+    }
+
+    /**
+     * @return array<string, mixed>|null
+     */
+    public function first(): ?array
+    {
+        return $this->data[0] ?? null;
+    }
+
+    public function count(): int
+    {
+        return count($this->data);
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function pagination(): array
+    {
+        return $this->meta['pagination'] ?? [];
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function links(): array
+    {
+        return $this->meta['links'] ?? [];
+    }
+
+    /**
+     * Pesan generik untuk pengguna akhir. Tidak pernah menyertakan pesan
+     * teknis dari API (FR-014/FR-016).
+     */
+    public function userMessage(): string
+    {
+        return DataSpasialReason::userMessage();
+    }
+
+    /**
+     * Bentuk serializable untuk disimpan pada cache.
+     *
+     * @return array<string, mixed>
+     */
+    public function toCachePayload(): array
+    {
+        return [
+            'status' => $this->status->value,
+            'data' => $this->data,
+            'meta' => $this->meta,
+            'http_status' => $this->httpStatus,
+        ];
+    }
+
+    /**
+     * Bangun kembali hasil dari cache. `reason` & `message` sengaja tidak
+     * disimpan karena hasil `unavailable` tidak pernah masuk cache.
+     *
+     * @param  array<string, mixed>  $payload
+     */
+    public static function fromCachePayload(array $payload): self
+    {
+        $data = is_array($payload['data'] ?? null) ? $payload['data'] : [];
+        $meta = is_array($payload['meta'] ?? null) ? $payload['meta'] : [];
+        $httpStatus = (int) ($payload['http_status'] ?? 200);
+
+        return $data === []
+            ? self::empty($meta, null, $httpStatus)
+            : self::data($data, $meta, null, $httpStatus);
+    }
+
+    /**
+     * Konteks teknis untuk log backend. WAJIB tidak dirender ke view.
+     *
+     * @return array<string, mixed>
+     */
+    public function logContext(string $endpoint = ''): array
+    {
+        return array_filter([
+            'endpoint' => $endpoint !== '' ? $endpoint : null,
+            'status' => $this->status->value,
+            'reason' => $this->reason?->value,
+            'http_status' => $this->httpStatus,
+            'message' => $this->message,
+        ], static fn ($value) => $value !== null);
+    }
+
+    /**
+     * Jaga invariant object agar tidak dapat dibangun salah oleh pemanggil.
+     */
+    private function assertInvariants(): void
+    {
+        if ($this->status->is(DataSpasialStatus::Data)) {
+            if ($this->data === []) {
+                throw new InvalidArgumentException(
+                    'DataSpasialResult berstatus data wajib memiliki minimal satu item.'
+                );
+            }
+
+            if ($this->reason !== null) {
+                throw new InvalidArgumentException(
+                    'DataSpasialResult berstatus data tidak boleh memiliki reason.'
+                );
+            }
+        }
+
+        if ($this->status->is(DataSpasialStatus::Empty) && $this->reason !== null) {
+            throw new InvalidArgumentException(
+                'DataSpasialResult berstatus empty tidak boleh memiliki reason.'
+            );
+        }
+
+        if ($this->status->is(DataSpasialStatus::Unavailable) && $this->reason === null) {
+            throw new InvalidArgumentException(
+                'DataSpasialResult berstatus unavailable wajib memiliki reason.'
+            );
+        }
+    }
+}
diff --git a/app/Services/IlluminatePaginatorAdapter.php b/app/Services/IlluminatePaginatorAdapter.php
index 705ac6d3..ca399e45 100644
--- a/app/Services/IlluminatePaginatorAdapter.php
+++ b/app/Services/IlluminatePaginatorAdapter.php
@@ -7,9 +7,7 @@
 
 class IlluminatePaginatorAdapter implements PaginatorInterface
 {
-    public function __construct(protected LengthAwarePaginator $paginator)
-    {
-    }
+    public function __construct(protected LengthAwarePaginator $paginator) {}
 
     /**
      * {@inheritdoc}
diff --git a/app/Services/OtpService.php b/app/Services/OtpService.php
index 2d0bbda0..0c18b685 100644
--- a/app/Services/OtpService.php
+++ b/app/Services/OtpService.php
@@ -2,12 +2,13 @@
 
 namespace App\Services;
 
+use App\Mail\OtpMail;
 use App\Models\OtpToken;
 use App\Models\User;
 use Illuminate\Support\Facades\Hash;
-use Illuminate\Support\Facades\Mail;
-use Illuminate\Support\Facades\Log;
 use Illuminate\Support\Facades\Http;
+use Illuminate\Support\Facades\Log;
+use Illuminate\Support\Facades\Mail;
 
 class OtpService
 {
@@ -21,111 +22,115 @@ public function generateAndSend($userId, $channel, $identifier)
             $otp = random_int($min, $max);
             $hash = Hash::make($otp);
             $expires = now()->addMinutes(config('app.otp_token_expires_minutes', 5));
-            
+
             // Delete any existing tokens for this user
             OtpToken::where('user_id', $userId)->delete();
-            
+
             // Create new token
             OtpToken::create([
-                'user_id' => $userId, 
-                'token_hash' => $hash, 
+                'user_id' => $userId,
+                'token_hash' => $hash,
                 'channel' => $channel,
-                'identifier' => $identifier, 
+                'identifier' => $identifier,
                 'expires_at' => $expires,
-                'attempts' => 0
+                'attempts' => 0,
             ]);
-            
+
             // Send OTP based on channel
             if ($channel === 'email') {
-                Mail::to($identifier)->send(new \App\Mail\OtpMail($otp));
+                Mail::to($identifier)->send(new OtpMail($otp));
                 Log::info('OTP Sent via Email', ['user_id' => $userId, 'email' => $identifier]);
-            } else if ($channel === 'telegram') {
+            } elseif ($channel === 'telegram') {
                 $this->sendTelegramOtp($identifier, $otp);
                 Log::info('OTP Sent via Telegram', ['user_id' => $userId, 'chat_id' => $identifier]);
             }
-            
+
             return [
                 'success' => true,
                 'message' => 'Kode Token berhasil dikirim',
-                'channel' => $channel
+                'channel' => $channel,
             ];
-            
+
         } catch (\Exception $e) {
             Log::error('OTP Generation Failed', ['user_id' => $userId, 'error' => $e->getMessage()]);
+
             return [
                 'success' => false,
-                'message' => 'Gagal mengirim OTP: ' . $e->getMessage()
+                'message' => 'Gagal mengirim OTP: '.$e->getMessage(),
             ];
         }
     }
-    
+
     private function sendTelegramOtp($chatId, $otp)
     {
         $botToken = env('TELEGRAM_BOT_TOKEN');
-        if (!$botToken) {
+        if (! $botToken) {
             throw new \Exception('Telegram bot token tidak dikonfigurasi');
         }
-        
+
         $expiresMinutes = config('app.otp_token_expires_minutes', 5);
         $message = "🔐 *Kode Token OpenKab*\n\n";
         $message .= "Kode verifikasi Anda: *{$otp}*\n\n";
         $message .= "Kode berlaku selama {$expiresMinutes} menit.\n";
-        $message .= "Jangan bagikan kode ini kepada siapa pun!";
-        
+        $message .= 'Jangan bagikan kode ini kepada siapa pun!';
+
         $response = Http::post("https://api.telegram.org/bot{$botToken}/sendMessage", [
             'chat_id' => $chatId,
             'text' => $message,
-            'parse_mode' => 'Markdown'
+            'parse_mode' => 'Markdown',
         ]);
-        
-        if (!$response->successful()) {
+
+        if (! $response->successful()) {
             throw new \Exception('Gagal mengirim pesan Telegram');
         }
     }
-    
+
     public function verify($userId, $submittedOtp)
     {
         $token = OtpToken::where('user_id', $userId)
             ->where('expires_at', '>', now())
             ->first();
-            
-        if (!$token) {
+
+        if (! $token) {
             return [
                 'success' => false,
-                'message' => 'Token tidak ditemukan atau sudah kedaluwarsa'
+                'message' => 'Token tidak ditemukan atau sudah kedaluwarsa',
             ];
         }
-        
+
         $maxAttempts = config('app.otp_max_verification_attempts', 3);
         if ($token->attempts >= $maxAttempts) {
             return [
                 'success' => false,
-                'message' => 'Terlalu banyak percobaan salah. Silakan minta kode baru.'
+                'message' => 'Terlalu banyak percobaan salah. Silakan minta kode baru.',
             ];
         }
-        
+
         if (Hash::check($submittedOtp, $token->token_hash)) {
             $token->delete();
             Log::info('OTP Verified Successfully', ['user_id' => $userId]);
+
             return [
                 'success' => true,
-                'message' => 'Kode Token berhasil diverifikasi'
+                'message' => 'Kode Token berhasil diverifikasi',
             ];
         } else {
             $token->increment('attempts');
             $maxAttempts = config('app.otp_max_verification_attempts', 3);
             Log::warning('OTP Verification Failed', ['user_id' => $userId, 'attempts' => $token->attempts + 1]);
+
             return [
                 'success' => false,
-                'message' => 'Kode Token salah. Percobaan tersisa: ' . ($maxAttempts - ($token->attempts + 1))
+                'message' => 'Kode Token salah. Percobaan tersisa: '.($maxAttempts - ($token->attempts + 1)),
             ];
         }
     }
-    
+
     public function cleanupExpired()
     {
         $deleted = OtpToken::where('expires_at', '<', now())->delete();
         Log::info('Expired OTP tokens cleaned up', ['deleted' => $deleted]);
+
         return $deleted;
     }
-}
\ No newline at end of file
+}
diff --git a/app/Services/SitemapService.php b/app/Services/SitemapService.php
index c6f256bd..728d9064 100644
--- a/app/Services/SitemapService.php
+++ b/app/Services/SitemapService.php
@@ -4,6 +4,8 @@
 
 use App\Models\CMS\Category;
 use App\Models\CMS\Page;
+use Illuminate\Contracts\Routing\ResponseFactory;
+use Illuminate\Http\Response;
 
 class SitemapService
 {
@@ -42,7 +44,7 @@ public function render()
     }
 
     /**
-     * @param string $set
+     * @param  string  $set
      */
     private function init($set = 'urlset'): string
     {
@@ -53,9 +55,8 @@ private function init($set = 'urlset'): string
     }
 
     /**
-     * @param string $set
-     *
-     * @return \Illuminate\Contracts\Routing\ResponseFactory|\Illuminate\Http\Response
+     * @param  string  $set
+     * @return ResponseFactory|Response
      */
     private function end($set = 'urlset')
     {
@@ -65,8 +66,8 @@ private function end($set = 'urlset')
     }
 
     /**
-     * @param string $loc
-     * @param string $lastmod
+     * @param  string  $loc
+     * @param  string  $lastmod
      */
     private function addUrl($loc, $lastmod = null): string
     {
diff --git a/app/Services/SkemaEditorService.php b/app/Services/SkemaEditorService.php
new file mode 100644
index 00000000..63bb31d6
--- /dev/null
+++ b/app/Services/SkemaEditorService.php
@@ -0,0 +1,477 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Services;
+
+use App\Enums\StatusSkemaEditor;
+use Illuminate\Support\Str;
+
+/**
+ * Orkestrasi editor skema kabupaten (KAB-02).
+ *
+ * Tanggung jawab:
+ * 1. Memetakan item API menjadi bentuk yang nyaman dipakai view.
+ * 2. Menghasilkan state editor dari skema yang dipilih (`StatusSkemaEditor`).
+ * 3. Menyusun badan draf untuk dikirim ke API.
+ *
+ * ⚠️ **ATURAN PEMBATASAN (research.md R12)** — berkas ini adalah **satu-satunya**
+ * tempat yang boleh menyebut NAMA FIELD ASUMSI kontrak (`popup_peta`,
+ * `sebagai_filter`, `sebagai_indikator`, `pemetaan`). Blade, controller, dan JS
+ * WAJIB memakai nama internal (`popupPeta`, `sebagaiFilter`, `sebagaiIndikator`).
+ *
+ * ⚠️ **UTANG KONTRAK U2** — tiga penanda tampilan TIDAK ada pada
+ * `openapi-fondasi.yaml` v0.1.0. Selama belum ada, `petakanIsian()` membacanya
+ * dengan default `false` agar halaman tetap berfungsi.
+ *
+ * ⚠️ **UTANG KONTRAK U3** — `pemetaan` inline di badan draf adalah asumsi.
+ */
+class SkemaEditorService
+{
+    /**
+     * Nama field penanda tampilan di API nyata → nama internal Blade/JS.
+     *
+     * ⚠️ VERIFIKASI LANGSUNG (spec Q8): ketiga penanda ini SUDAH ADA di API
+     * dengan nama `tampil_popup` / `tampil_filter` / `tampil_indikator`.
+     * Asumsi lama (`popup_peta`/`filter`/`indikator`) tidak pernah dipakai —
+     * lihat `contracts/skema-editor-api.md` §6a.4 K4.
+     *
+     * @var array<string, string>
+     */
+    private const PENANDA_TAMPILAN = [
+        'tampil_popup' => 'popupPeta',
+        'tampil_filter' => 'sebagaiFilter',
+        'tampil_indikator' => 'sebagaiIndikator',
+    ];
+
+    // -----------------------------------------------------------------------
+    // Read model
+    // -----------------------------------------------------------------------
+
+    /**
+     * Petakan satu item `ds_sektor` menjadi bentuk view.
+     *
+     * @param  array<string, mixed>  $item
+     * @return array<string, mixed>
+     */
+    public function petakanSektor(array $item): array
+    {
+        $attributes = $this->attributes($item);
+
+        return [
+            'id' => (int) ($item['id'] ?? $attributes['id'] ?? 0),
+            'kode' => (string) ($attributes['kode'] ?? ''),
+            'nama' => (string) ($attributes['nama'] ?? ''),
+            'ikon' => $attributes['ikon'] ?? null,
+            'status' => (string) ($attributes['status'] ?? 'aktif'),
+            // Counter dari API nyata (§6a.2). Karena Q22 melarang memanggil
+            // endpoint skema per sektor (SC-013: tepat satu pemanggilan baca),
+            // versi terakhir dan statusnya DITURUNKAN dari kedua counter ini:
+            //   jumlah_versi_skema = 0            → belum ada skema
+            //   jumlah_versi_terbit < jumlah_skema → versi terakhir berstatus draf
+            //   selainnya                           → versi terakhir berstatus terbit
+            // Penomoran versi dibuat berurutan oleh API (Q18), sehingga nomor
+            // versi terakhir sama dengan jumlah versi yang ada.
+            'jumlahSkema' => (int) ($attributes['jumlah_versi_skema'] ?? 0),
+            'jumlahTerbit' => (int) ($attributes['jumlah_versi_terbit'] ?? 0),
+            'adaDraf' => ((int) ($attributes['jumlah_versi_skema'] ?? 0)) > 0
+                && ((int) ($attributes['jumlah_versi_skema'] ?? 0)) > ((int) ($attributes['jumlah_versi_terbit'] ?? 0)),
+            'nomorVersiTerakhir' => (int) ($attributes['jumlah_versi_skema'] ?? 0),
+            'statusTerakhir' => $this->statusTerakhirSektor(
+                (int) ($attributes['jumlah_versi_skema'] ?? 0),
+                (int) ($attributes['jumlah_versi_terbit'] ?? 0),
+            ),
+        ];
+    }
+
+    /**
+     * Turunkan status versi terakhir sebuah sektor dari counter API (Q22).
+     *
+     * @return string `draf`, `terbit`, atau `kosong`
+     */
+    private function statusTerakhirSektor(int $jumlahVersi, int $jumlahTerbit): string
+    {
+        if ($jumlahVersi === 0) {
+            return 'kosong';
+        }
+
+        return $jumlahTerbit < $jumlahVersi ? 'draf' : 'terbit';
+    }
+
+    /**
+     * Petakan daftar item sektor dan hitung berapa skema/draf tiap sektor (R1).
+     *
+     * @param  array<int, array<string, mixed>>  $items
+     * @return array<int, array<string, mixed>>
+     */
+    public function petakanDaftarSektor(array $items): array
+    {
+        return array_map(fn (array $item): array => $this->petakanSektor($item), $items);
+    }
+
+    /**
+     * Petakan satu item `ds_skema_versi` menjadi bentuk view.
+     *
+     * @param  array<string, mixed>  $item
+     * @return array<string, mixed>
+     */
+    public function petakanSektorSkema(array $item): array
+    {
+        $attributes = $this->attributes($item);
+        $sektor = is_array($attributes['sektor'] ?? null) ? $attributes['sektor'] : [];
+
+        // ⚠️ VERIFIKASI LANGSUNG (K3): versi & status berada di
+        // `attributes.versi_skema`, BUKAN di root `attributes`.
+        // Fallback ke root dipertahankan agar draft `openapi-fondasi.yaml`
+        // masih terbaca bila API belum diperbarui.
+        $versi = is_array($attributes['versi_skema'] ?? null) ? $attributes['versi_skema'] : [];
+
+        $id = (int) ($versi['id'] ?? $item['id'] ?? 0);
+        $sektorId = (int) ($sektor['id'] ?? $versi['sektor_id'] ?? $attributes['sektor_id'] ?? 0);
+
+        return [
+            'id' => $id,
+            'sektorId' => $sektorId,
+            'sektorKode' => (string) ($sektor['kode'] ?? ''),
+            'sektorNama' => (string) ($sektor['nama'] ?? ''),
+            'nomorVersi' => (int) ($versi['nomor_versi'] ?? $attributes['nomor_versi'] ?? 0),
+            'status' => (string) ($versi['status'] ?? $attributes['status'] ?? ''),
+            'diterbitkanPada' => $versi['diterbitkan_pada'] ?? $attributes['diterbitkan_pada'] ?? null,
+            'catatanPerubahan' => $versi['catatan_perubahan'] ?? $attributes['catatan_perubahan'] ?? null,
+            'jumlahIsian' => count(is_array($attributes['isian'] ?? null) ? $attributes['isian'] : []),
+        ];
+    }
+
+    /**
+     * Petakan satu item `ds_isian` menjadi bentuk view dengan NAMA INTERNAL.
+     *
+     * @param  array<string, mixed>  $item
+     * @return array<string, mixed>
+     */
+    public function petakanIsian(array $item): array
+    {
+        $attributes = $this->attributes($item);
+        $pemetaan = $this->pemetaanPertama(is_array($attributes['pemetaan'] ?? null) ? $attributes['pemetaan'] : []) ?? [];
+
+        // `rujukan_sumber` dipecah menjadi tabel + kolom untuk ditampilkan.
+        // Rujukan kosong dinormalkan jadi `null` (bukan string kosong) supaya
+        // pemetaan yang belum punya rujukan tetap terbaca sebagai "tidak ada".
+        $rujukan = trim((string) ($pemetaan['rujukan'] ?? ''));
+        [$tabelSumber, $kolomSumber] = $this->pecahRujukan($rujukan);
+
+        $isian = [
+            'id' => isset($item['id']) ? (int) $item['id'] : (isset($attributes['id']) ? (int) $attributes['id'] : null),
+            'kode' => (string) ($attributes['kode'] ?? ''),
+            'label' => (string) ($attributes['label'] ?? ''),
+            'tipe' => (string) ($attributes['tipe'] ?? 'teks'),
+            'wajib' => (bool) ($attributes['wajib'] ?? false),
+            'satuan' => $attributes['satuan'] ?? null,
+            'opsi' => array_values(array_filter(
+                is_array($attributes['opsi'] ?? null) ? $attributes['opsi'] : [],
+                static fn ($opsi): bool => is_string($opsi) && $opsi !== '',
+            )),
+            'urutan' => (int) ($attributes['urutan'] ?? 0),
+            'diarsipkan' => (bool) ($attributes['diarsipkan'] ?? false),
+            // ⚠️ VERIFIKASI LANGSUNG: `sumber` adalah ENUM API
+            // (`openSID`/`dataPresisi`/`impor`), BUKAN kode sektor (§6a.5).
+            'sumber' => $pemetaan['sumber'] ?? 'manual',
+            // ⚠️ VERIFIKASI LANGSUNG (§6a.4): entitas `ds_pemetaan` hanya
+            // menyimpan SATU kolom `rujukan_sumber` berbentuk "tabel.kolom"
+            // (contoh `tbl_jalan.lebar`). Karena form menampilkan dua kolom,
+            // nilainya dipecah di sini; saat menyimpan, keduanya disambung
+            // kembali menjadi `rujukan_sumber` oleh `composePemetaan()`.
+            'rujukan' => $rujukan === '' ? null : $rujukan,
+            'tabelSumber' => $tabelSumber,
+            'kolomSumber' => $kolomSumber,
+            'aturanHitung' => $pemetaan['aturan_hitung'] ?? null,
+        ];
+
+        // Penanda tampilan: nama RESMI dibaca dengan default `false`.
+        foreach (self::PENANDA_TAMPILAN as $api => $internal) {
+            $isian[$internal] = (bool) ($attributes[$api] ?? false);
+        }
+
+        return $isian;
+    }
+
+    /**
+     * Petakan daftar isian dan urutkan berdasarkan `urutan` (FR-012).
+     *
+     * @param  array<int, array<string, mixed>>  $items
+     * @return array<int, array<string, mixed>>
+     */
+    public function petakanDaftarIsian(array $items): array
+    {
+        $isian = array_map(fn (array $item): array => $this->petakanIsian($item), $items);
+
+        usort($isian, static fn (array $a, array $b): int => $a['urutan'] <=> $b['urutan']);
+
+        return $isian;
+    }
+
+    /**
+     * Petakan daftar `ds_pemetaan` lalu pasang ke isian terkait (FR-023/FR-024).
+     *
+     * @param  array<int, array<string, mixed>>  $items
+     * @return array<int, array<string, mixed>>
+     */
+    public function petakanPemetaan(array $items): array
+    {
+        return array_map(function (array $item): array {
+            $attributes = $this->attributes($item);
+
+            return [
+                'id' => (int) ($item['id'] ?? 0),
+                'sumber' => $attributes['sumber'] ?? null,
+                'rujukan' => $attributes['rujukan_sumber'] ?? null,
+                'aturan_hitung' => $attributes['aturan_hitung'] ?? null,
+            ];
+        }, $items);
+    }
+
+    /**
+     * Pemetaan pertama sebuah isian (API mengembalikan array; isian memakai satu).
+     *
+     * @param  array<int, mixed>  $items
+     * @return array<string, mixed>|null
+     */
+    private function pemetaanPertama(array $items): ?array
+    {
+        foreach ($items as $item) {
+            if (is_array($item)) {
+                return $this->petakanPemetaan([$item])[0] ?? null;
+            }
+        }
+
+        return null;
+    }
+
+    /**
+     * Tempelkan status sumber nilai pada tiap isian (FR-023).
+     *
+     * @param  array<int, array<string, mixed>>  $isian
+     * @param  array<int, array<string, mixed>>  $pemetaan
+     * @return array<int, array<string, mixed>>
+     */
+    public function terapkanPemetaan(array $isian, array $pemetaan): array
+    {
+        $perIsian = [];
+
+        foreach ($pemetaan as $peta) {
+            if (($peta['sumber'] ?? null) === null || ($peta['sumber'] ?? '') === '') {
+                continue;
+            }
+
+            $perIsian[$peta['isianId'] ?? 0] = $peta;
+        }
+
+        return array_map(function (array $baris) use ($perIsian): array {
+            $peta = $perIsian[$baris['id']] ?? null;
+
+            if ($peta === null) {
+                return $baris;
+            }
+
+            return array_merge($baris, [
+                'sumber' => $peta['sumber'],
+                'rujukan' => $peta['rujukan'],
+                'aturanHitung' => $peta['aturan_hitung'] ?? null,
+            ]);
+        }, $isian);
+    }
+
+    /**
+     * Turunkan `StatusSkemaEditor` dari skema yang dipilih (FR-008a/FR-008b).
+     *
+     * @param  array<string, mixed>|null  $skemaTerpilih
+     * @param  array<int, array<string, mixed>>  $skemaSektor
+     */
+    public function statusEditor(?array $skemaTerpilih, array $skemaSektor): StatusSkemaEditor
+    {
+        if ($skemaTerpilih !== null) {
+            return StatusSkemaEditor::dari([
+                'status' => $skemaTerpilih['status'],
+                'jumlah_skema' => count($skemaSektor),
+            ]);
+        }
+
+        $draf = $this->cariSkema($skemaSektor, StatusSkemaEditor::Draf);
+
+        if ($draf !== null) {
+            return StatusSkemaEditor::dari(['status' => $draf['status']]);
+        }
+
+        return StatusSkemaEditor::dari([
+            'status' => '',
+            'jumlah_skema' => count($skemaSektor),
+        ]);
+    }
+
+    /**
+     * Hasilkan kode sektor dari nama (Q5 / FR-007d-1).
+     *
+     * Pola `snake_case`: huruf kecil, angka, garis bawah; diawali huruf.
+     * Bila hasil kosong (mis. nama hanya simbol), fallback `sektor`.
+     * Keunikan global ditjamin API (Q13); OpenKab hanya menyusun bentuknya.
+     */
+    public function kodeSektorDariNama(string $nama): string
+    {
+        $kode = Str::lower(preg_replace('/[^a-z0-9]+/i', '_', trim($nama)));
+        $kode = trim($kode, '_');
+
+        if ($kode === '' || ! preg_match('/^[a-z]/', $kode)) {
+            $kode = 'sektor';
+        }
+
+        return $kode;
+    }
+
+    // -----------------------------------------------------------------------
+    // Write model
+    // -----------------------------------------------------------------------
+
+    /**
+     * Susun badan draf untuk dikirim ke API (R2).
+     *
+     * ⚠️ **NAMA ASUMSI KONTRAK HANYA BOLEH MUNCUL DI SINI** (R12).
+     * Input memakai nama internal hasil validasi FormRequest.
+     *
+     * @param  array<int, array<string, mixed>>  $isian  Hasil `$request->validated()['isian']`
+     * @param  array<string, mixed>  $meta  Berisi `sektor`, `nomor_versi`, `catatan_perubahan`
+     * @return array<string, mixed>
+     */
+    public function composeDrafPayload(array $isian, array $meta = []): array
+    {
+        $urut = 1;
+
+        $isianApi = array_map(function (array $baris) use (&$urut): array {
+            $payload = [
+                'kode' => $baris['kode'],
+                'label' => $baris['label'],
+                'tipe' => $baris['tipe'],
+                'wajib' => (bool) ($baris['wajib'] ?? false),
+                'satuan' => $baris['satuan'] ?? null,
+                'opsi' => ($baris['tipe'] ?? '') === 'pilihan' ? array_values($baris['opsi'] ?? []) : null,
+                'urutan' => $urut++,
+                // Nama TULIS API (Q20) — berbeda dari nama baca `tampil_popup`/
+                // `tampil_filter`/`tampil_indikator`. View memakai nama internal
+                // (`popupPeta`, `sebagaiFilter`, `sebagaiIndikator`); terjemahan
+                // terjadi hanya di sini (R12 — satu tempat).
+                'tampil_di_popup' => (bool) ($baris['popupPeta'] ?? false),
+                'tampil_di_filter' => (bool) ($baris['sebagaiFilter'] ?? false),
+                'tampil_di_indikator' => (bool) ($baris['sebagaiIndikator'] ?? false),
+                // Pemetaan berupa array `{sumber, rujukan_sumber}` — satu nilai
+                // "tabel.kolom" (§6a.4). View memakai `rujukan` sebagai sumber
+                // kebenaran; `composePemetaan()` yang menyusun bentuk API.
+                'pemetaan' => $this->composePemetaan($baris),
+            ];
+
+            return $payload;
+        }, $isian);
+
+        return array_merge([
+            'sektor' => $meta['sektor'] ?? null,
+            'sektor_nama' => $meta['sektor_nama'] ?? null,
+            'keterangan' => $meta['keterangan'] ?? null,
+            'isian' => $isianApi,
+        ], []);
+    }
+
+    /**
+     * Susun pemetaan satu isian untuk badan draf.
+     *
+     * ⚠️ Bentuk API (`ds_pemetaan`) hanya punya **`rujukan_sumber`** — satu
+     * string "tabel.kolom" (contoh `tbl_jalan.lebar`, §6a.4). Klien boleh
+     * mengirim `rujukan` apa adanya; bila hanya mengirim `tabelSumber` +
+     * `kolomSumber` keduanya disambung di sini.
+     *
+     * @param  array<string, mixed>  $baris
+     * @return array<int, array{sumber: string, rujukan_sumber: string}>|null
+     */
+    private function composePemetaan(array $baris): ?array
+    {
+        $sumber = $baris['sumber'] ?? null;
+
+        if ($sumber === null || $sumber === '' || $sumber === 'manual') {
+            return null;
+        }
+
+        return [[
+            'sumber' => (string) $sumber,
+            'rujukan_sumber' => $this->susunRujukan($baris),
+        ]];
+    }
+
+    /**
+     * Rujukan sumber satu isian: pakai `rujukan` bila ada, kalau tidak
+     * sambung `tabelSumber` + `kolomSumber` menjadi "tabel.kolom".
+     *
+     * @param  array<string, mixed>  $baris
+     */
+    private function susunRujukan(array $baris): string
+    {
+        $rujukan = trim((string) ($baris['rujukan'] ?? ''));
+
+        if ($rujukan !== '') {
+            return $rujukan;
+        }
+
+        $tabel = trim((string) ($baris['tabelSumber'] ?? ''));
+        $kolom = trim((string) ($baris['kolomSumber'] ?? ''));
+
+        return implode('.', array_filter([$tabel, $kolom], static fn (string $bagian): bool => $bagian !== ''));
+    }
+
+    /**
+     * Pecah `rujukan_sumber` ("tabel.kolom") menjadi bagian tabel & kolom.
+     *
+     * ⚠️ Pemecahan memakai titik TERAKHIR agar nilai yang hanya memuat satu
+     * titik tetap pulih utuh saat disambung kembali (mis. `ds.tbl.col`).
+     *
+     * @return array{0: string, 1: string}
+     */
+    private function pecahRujukan(?string $rujukan): array
+    {
+        $rujukan = trim((string) $rujukan);
+
+        if ($rujukan === '') {
+            return ['', ''];
+        }
+
+        $titik = strrpos($rujukan, '.');
+
+        if ($titik === false) {
+            return [$rujukan, ''];
+        }
+
+        return [substr($rujukan, 0, $titik), substr($rujukan, $titik + 1)];
+    }
+
+    // -----------------------------------------------------------------------
+    // Helper
+    // -----------------------------------------------------------------------
+
+    /**
+     * @param  array<string, mixed>  $item
+     * @return array<string, mixed>
+     */
+    private function attributes(array $item): array
+    {
+        return is_array($item['attributes'] ?? null) ? $item['attributes'] : $item;
+    }
+
+    /**
+     * @param  array<int, array<string, mixed>>  $daftar
+     * @return array<string, mixed>|null
+     */
+    private function cariSkema(array $daftar, string $status): ?array
+    {
+        foreach ($daftar as $skema) {
+            if (($skema['status'] ?? '') === $status) {
+                return $skema;
+            }
+        }
+
+        return null;
+    }
+}
diff --git a/app/Services/TwoFactorService.php b/app/Services/TwoFactorService.php
index c6689090..58e375e1 100644
--- a/app/Services/TwoFactorService.php
+++ b/app/Services/TwoFactorService.php
@@ -72,4 +72,4 @@ public function getTwoFactorIdentifier(User $user)
     {
         return $user->{'2fa_enabled'} ? $user->{'2fa_identifier'} : null;
     }
-}
\ No newline at end of file
+}
diff --git a/config/dataspasial.php b/config/dataspasial.php
new file mode 100644
index 00000000..45b605b2
--- /dev/null
+++ b/config/dataspasial.php
@@ -0,0 +1,61 @@
+<?php
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Service Klien API Satu Data (DataSpasial)
+    |--------------------------------------------------------------------------
+    |
+    | OpenKab TIDAK terhubung ke database gabungan dan tidak memiliki tabel
+    | DataSpasial. Seluruh baca dan tulis data `ds_*` melewati API Satu Data
+    | melalui service `App\Services\DataSpasialApiService`.
+    |
+    | Base URL dan token TIDAK dikonfigurasi di sini: keduanya otomatis
+    | mengikuti pengaturan database gabungan yang sudah ada —
+    |   - URL  : config('app.databaseGabunganUrl') / env API_DATABASE_GABUNGAN_HOST
+    |   - token: Setting `database_gabungan_api_key`
+    | Berkas ini hanya menyimpan setelan operasional.
+    |
+    */
+
+    /*
+    | Batas waktu permintaan dalam detik.
+    */
+    'timeout' => (int) env('API_DATASPASIAL_TIMEOUT', 10),
+
+    /*
+    | Masa berlaku cache operasi baca dalam detik. 0 berarti cache nonaktif.
+    */
+    'cache_ttl' => (int) env('API_DATASPASIAL_CACHE_TTL', 300),
+
+    /*
+    | Store cache yang dipakai. null berarti memakai default aplikasi.
+    */
+    'cache_store' => env('API_DATASPASIAL_CACHE_STORE'),
+
+    /*
+    | Prefix kunci cache operasi baca. Memungkinkan invalidasi seluruh cache
+    | baca tanpa menyentuh cache modul lain.
+    */
+    'cache_prefix' => 'dataspasial:get:',
+
+    /*
+    | Header identitas pemanggil yang dibaca API untuk audit (API-07).
+    */
+    'user_id_header' => 'X-OpenKab-User-Id',
+
+    'user_name_header' => 'X-OpenKab-User-Name',
+
+    /*
+    | Prefix path endpoint DataSpasial di sisi API.
+    */
+    'path_prefix' => '/api/v1/dataspasial',
+
+    /*
+    | Pesan yang ditampilkan ke pengguna saat data tidak dapat diperoleh.
+    | WAJIB generik — detail teknis hanya untuk log backend.
+    */
+    'unavailable_message' => 'Data sementara tidak tersedia. Silakan coba lagi nanti.',
+
+];
diff --git a/database/factories/UserFactory.php b/database/factories/UserFactory.php
index 2a9c4e3b..b538a4bc 100644
--- a/database/factories/UserFactory.php
+++ b/database/factories/UserFactory.php
@@ -27,9 +27,15 @@ public function definition()
         // ];
 
         return [
-            'username' => $this->faker->userName,
+            // ⚠️ WAJIB `unique()` + sufiks acak. Kolom `username` punya batasan unik
+            // di DB dan basis data pengembangan sudah berisi ratusan baris,
+            // sehingga `unique()` saja (yang hanya men unik dalam satu proses)
+            // TIDAK cukup — nama dari kumpulan faker bisa saja sudah ada.
+            // Sufiks 6 karakter acak membuat bentrok praktis mustahil tanpa
+            // mengubah bentuk nama yang dipakai test lain.
+            'username' => $this->faker->unique()->userName.'.'.Str::lower(Str::random(6)),
             'password' => Hash::make('password'), // default password
-            'email' => $this->faker->unique()->safeEmail,
+            'email' => $this->faker->unique()->safeEmail.'+'.Str::lower(Str::random(6)).'@example.test',
             'last_login' => now(),
             'email_verified_at' => now(),
             'active' => 1,
diff --git a/database/migrations/2026_10_14_000001_create_dataspasial_roles.php b/database/migrations/2026_10_14_000001_create_dataspasial_roles.php
new file mode 100644
index 00000000..fb8a4207
--- /dev/null
+++ b/database/migrations/2026_10_14_000001_create_dataspasial_roles.php
@@ -0,0 +1,298 @@
+<?php
+
+use App\Enums\Modul;
+use App\Models\Team;
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Support\Facades\Artisan;
+use Spatie\Permission\Models\Permission;
+use Spatie\Permission\Models\Role;
+
+return new class extends Migration
+{
+    /**
+     * Matriks peran <-> izin menu (research.md R6).
+     *
+     * `read` dipakai untuk akses tampilan; `write`/`edit`/`delete` hanya
+     * diberikan kepada peran yang memang mengelola.
+     *
+     * @var array<string, array<string, array<int, string>>>
+     */
+    private const ROLE_PERMISSIONS = [
+        'admin skema' => [
+            'menu' => ['skema', 'peta', 'dasbor', 'monitoring'],
+            'abilities' => [
+                'skema' => ['read', 'write', 'edit', 'delete'],
+                'peta' => ['read'],
+                'dasbor' => ['read'],
+                'monitoring' => ['read'],
+            ],
+        ],
+
+        'operator impor' => [
+            'menu' => ['impor', 'peta', 'dasbor', 'monitoring'],
+            'abilities' => [
+                'impor' => ['read', 'write'],
+                'peta' => ['read'],
+                'dasbor' => ['read'],
+                'monitoring' => ['read'],
+            ],
+        ],
+
+        'analis opd' => [
+            'menu' => ['peta', 'dasbor', 'monitoring'],
+            'abilities' => [
+                'peta' => ['read'],
+                'dasbor' => ['read'],
+                'monitoring' => ['read'],
+            ],
+        ],
+    ];
+
+    /**
+     * Permission grup induk — selalu diberikan agar menu utama tampil.
+     */
+    private const PARENT_PERMISSION = 'dataspasial';
+
+    /**
+     * Sediakan peran DataSpasial beserta izin menunya (FR-010/FR-012).
+     *
+     * Di OpenKab, "peran" dimodelkan sebagai Team (grup) + Role spatie dengan
+     * `team_id` yang sama — mengikuti pola `2023_06_13_073258_create_role.php`
+     * dan `App\Console\Commands\updateAdminMenu` (research.md R5).
+     *
+     * Dijalankan sebagai data migration agar otomatis tersedia saat deploy
+     * (`php artisan migrate`). IDEMPOTEN: `Team::firstOrCreate`,
+     * `Role::firstOrCreate`, dan `Permission::findOrCreate`.
+     */
+    public function up(): void
+    {
+        $this->ensureAdministratorAccess();
+
+        foreach (self::ROLE_PERMISSIONS as $teamName => $config) {
+            $this->ensureRole($teamName, $config);
+        }
+    }
+
+    /**
+     * Cabut peran & izin DataSpasial saat rollback.
+     */
+    public function down(): void
+    {
+        foreach (array_keys(self::ROLE_PERMISSIONS) as $teamName) {
+            $team = Team::where('name', $teamName)->first();
+
+            if (! $team) {
+                continue;
+            }
+
+            setPermissionsTeamId($team->id);
+
+            Role::where('team_id', $team->id)->where('name', $teamName)->delete();
+
+            $team->users()->detach();
+            $team->delete();
+        }
+
+        setPermissionsTeamId(null);
+
+        Permission::where('name', 'like', 'dataspasial%')->delete();
+        Artisan::call('admin:menu-update');
+    }
+
+    /**
+     * Beri role `administrator` akses ke menu DataSpasial.
+     *
+     * Cukup panggil `admin:menu-update`: command tersebut membaca grup menu
+     * DataSpasial dari `App\Enums\Modul::Menu` (wajib sudah terdaftar di sana),
+     * menuliskan menu ke team `administrator`, dan menyinkronkan seluruh
+     * permission turunannya (`dataspasial-*`) ke role administrator.
+     *
+     * Dijaga bila team administrator belum ada (mis. basis data sangat awal).
+     */
+    private function ensureAdministratorAccess(): void
+    {
+        if (! Team::where('name', 'administrator')->exists()) {
+            return;
+        }
+
+        Artisan::call('admin:menu-update');
+    }
+
+    /**
+     * @param  array{menu: array<int, string>, abilities: array<string, array<int, string>>}  $config
+     */
+    private function ensureRole(string $teamName, array $config): void
+    {
+        $menu = $this->buildMenu($config['menu'], $config['abilities']);
+
+        $team = Team::firstOrCreate(
+            ['name' => $teamName],
+            ['menu' => $menu]
+        );
+
+        // Menu sudah ada tetapi belum dalam bentuk yang benar (mis. dibuat
+        // sebelum penambahan flag ability, atau belum berisi submenu
+        // DataSpasial) → perbaiki agar hak akses tampil tercentang di UI dan
+        // tidak terhapus saat grup disimpan. Menu yang sudah benar tidak diubah.
+        if ($this->needsMenuRepair($team->menu)) {
+            $team->update(['menu' => $menu]);
+        }
+
+        setPermissionsTeamId($team->id);
+
+        $role = Role::firstOrCreate([
+            'name' => $teamName,
+            'team_id' => $team->id,
+            'guard_name' => 'web',
+        ]);
+
+        $permissionNames = $this->permissionNames($config['abilities']);
+
+        // Gabungkan, bukan ganti: menjamin matriks minimum selalu ada, tetapi
+        // tidak mencabut izin yang memang ditambahkan admin secara lokal.
+        $role->syncPermissions(array_values(array_unique(array_merge(
+            $role->permissions->pluck('name')->all(),
+            $permissionNames
+        ))));
+    }
+
+    /**
+     * @param  array<string, array<int, string>>  $abilities
+     * @return array<int, string>
+     */
+    private function permissionNames(array $abilities): array
+    {
+        $names = [Permission::findOrCreate(self::PARENT_PERMISSION, 'web')->name];
+
+        foreach ($abilities as $menu => $menuAbilities) {
+            foreach ($menuAbilities as $ability) {
+                $names[] = Permission::findOrCreate("dataspasial-{$menu}-{$ability}", 'web')->name;
+            }
+        }
+
+        return array_values(array_unique($names));
+    }
+
+    /**
+     * Bangun struktur menu grup DataSpasial berisi hanya submenu yang diizinkan,
+     * mengikuti bentuk yang dibaca `App\Listeners\MenuListener`.
+     *
+     * Setiap item (grup & submenu) menyertakan flag ability
+     * `"{permission}-read|write|edit|delete"` dan `selected`, yaitu bentuk yang
+     * dipakai halaman Pengaturan › Grup (`resources/views/group/edit_js.blade.php`
+     * → `mergeByKey`) untuk mencentang hak akses, dan yang dibaca
+     * `App\Http\Controllers\Api\TeamController::collectPermissions()` saat
+     * grup disimpan. Tanpa flag ini kotak centang tidak muncul tercentang dan
+     * menyimpan grup dari UI akan menghapus izinnya.
+     *
+     * @param  array<int, string>  $allowedMenus
+     * @param  array<string, array<int, string>>  $abilities
+     * @return array<int, array<string, mixed>>
+     */
+    private function buildMenu(array $allowedMenus, array $abilities): array
+    {
+        $group = $this->dataspasialGroup();
+
+        if ($group === null) {
+            return [];
+        }
+
+        $allowed = array_flip(array_map(
+            fn (string $menu) => 'dataspasial-'.$menu,
+            $allowedMenus
+        ));
+
+        $submenus = [];
+        $groupAbilities = [];
+
+        foreach ($group['submenu'] ?? [] as $item) {
+            $permission = $item['permission'] ?? '';
+
+            if (! isset($allowed[$permission])) {
+                continue;
+            }
+
+            // permission submenu = "dataspasial-{slug}" → slug "skema", dst.
+            $slug = (string) preg_replace('/^dataspasial-/', '', $permission);
+            $itemAbilities = $abilities[$slug] ?? [];
+
+            $submenus[] = $this->withAbilityFlags($item, $itemAbilities);
+            $groupAbilities = array_merge($groupAbilities, $itemAbilities);
+        }
+
+        $groupItem = array_merge($group, ['submenu' => array_values($submenus)]);
+
+        return [
+            $this->withAbilityFlags($groupItem, array_values(array_unique($groupAbilities))),
+        ];
+    }
+
+    /**
+     * Tambahkan flag ability (`{permission}-{ability}`) dan `selected` ke item
+     * menu, sesuai bentuk yang diproduksi UI Pengaturan › Grup.
+     *
+     * @param  array<string, mixed>  $item
+     * @param  array<int, string>  $abilities
+     * @return array<string, mixed>
+     */
+    private function withAbilityFlags(array $item, array $abilities): array
+    {
+        $permission = (string) ($item['permission'] ?? '');
+
+        foreach (['read', 'write', 'edit', 'delete'] as $ability) {
+            $item[$permission.'-'.$ability] = in_array($ability, $abilities, true);
+        }
+
+        $item['selected'] = true;
+
+        return $item;
+    }
+
+    /**
+     * Apakah menu team perlu diperbaiki?
+     *
+     * Dianggap perlu bila grup DataSpasial tidak ada, tidak punya submenu, atau
+     * item grup/submenu belum memuat flag ability (`{permission}-read`) yang
+     * dibutuhkan halaman Pengaturan › Grup.
+     */
+    private function needsMenuRepair(mixed $menu): bool
+    {
+        foreach ((array) $menu as $group) {
+            if (($group['text'] ?? null) !== 'DataSpasial') {
+                continue;
+            }
+
+            if (empty($group['submenu'])) {
+                return true;
+            }
+
+            if (! array_key_exists(($group['permission'] ?? '').'-read', $group)) {
+                return true;
+            }
+
+            foreach ($group['submenu'] as $item) {
+                if (! array_key_exists(($item['permission'] ?? '').'-read', $item)) {
+                    return true;
+                }
+            }
+
+            return false;
+        }
+
+        return true;
+    }
+
+    /**
+     * @return array<string, mixed>|null
+     */
+    private function dataspasialGroup(): ?array
+    {
+        foreach (Modul::Menu as $menu) {
+            if (($menu['text'] ?? null) === 'DataSpasial') {
+                return $menu;
+            }
+        }
+
+        return null;
+    }
+};
diff --git a/public/js/dataspasial/schema-editor.js b/public/js/dataspasial/schema-editor.js
new file mode 100644
index 00000000..00874387
--- /dev/null
+++ b/public/js/dataspasial/schema-editor.js
@@ -0,0 +1,1341 @@
+/**
+ * Editor Skema Kabupaten — KAB-02 (OpenSID/OpenKab#1297)
+ *
+ * ATURAN YANG WAJIB DIPATUHI (research.md R12):
+ * - Nama field ASUMSI kontrak API **DILARANG** muncul di berkas ini, termasuk
+ *   pada nama input form. Yang dipakai hanya NAMA INTERNAL (`popupPeta`,
+ *   `sebagaiFilter`, `sebagaiIndikator`, `sumber`, `rujukan`).
+ * - Yang boleh menyebut nama asumsi hanya `app/Services/SkemaEditorService.php`
+ *   dan `app/Services/DataSpasialApiService.php`.
+ * - Di sini hanya boleh dipakai NAMA INTERNAL: `popupPeta`, `sebagaiFilter`,
+ *   `sebagaiIndikator`, `sumber`.
+ *
+ * Sumber kebenaran tunggal untuk editor + pratinjau adalah `stateIsian` (R7):
+ * pratinjau merender dari state yang SAMA dengan form, sehingga perubahan yang
+ * belum disimpan tetap terlihat (FR-035).
+ *
+ * Seret-urut memakai NATIVE HTML5 Drag & Drop (R8) — jQuery UI TIDAK terpasang
+ * pada `node_modules/`, jadi `$(...).sortable()` tidak boleh dipakai.
+ */
+
+const KODE_ISIAN_PATTERN = /^[a-z][a-z0-9_]*$/;
+
+/** Tipe yang kolom opsinya aktif (cerminan `TipeIsian::memakaiPilihan()`). */
+const TIPE_PILIHAN = 'pilihan';
+
+/** Tipe yang kolom satuannya relevan (cerminan `TipeIsian::memakaiSatuan()`). */
+const TIPE_SATUAN = 'angka';
+
+/**
+ * Bangkitkan `kode` isian dari `label` (FR-017, spec Q14).
+ *
+ * ⚠️ Ini adalah **satu-satunya** tempat yang membuat `kode`. Admin tidak lagi
+ * mengetik kode; kolomnya baca-saja dan terisi otomatis.
+ *
+ * ⚠️ **TIDAK** menambahkan akhiran angka saat kode bentrok (Q14/C). Label
+ * duplikat justru harus DITOLAK supaya admin memperbaikinya (lihat
+ * `validasiKodeLokal()`).
+ *
+ * @param {string} label
+ * @returns {string} kode *snake_case*, atau string kosong bila label tidak
+ *                      menghasilkan slug yang sah.
+ */
+export function slugKodeDariLabel(label) {
+    const dasar = String(label || '')
+        .toLowerCase()
+        .normalize('NFD')
+        .replace(/[\u0300-\u036f]/g, '')      // buang tanda diakritik
+        .replace(/[^a-z0-9]+/g, '_')           // non-alnum → _
+        .replace(/_+/g, '_')                   // rapikan _
+        .replace(/^_|_$/g, '');                // rapikan tepian
+
+    // ⚠️ FR-018: pola sah diawali huruf KECIL (bukan angka).
+    if (dasar === '' || !/^[a-z]/.test(dasar)) {
+        return '';
+    }
+
+    return dasar;
+}
+
+export function isKodeIsianValid(kode) {
+    return KODE_ISIAN_PATTERN.test(String(kode || '').trim());
+}
+
+/**
+ * Buat baris isian kosong dengan bentuk yang sama dengan `form-isian.blade.php`.
+ *
+ * @param {number} urutan
+ */
+function barisBaru(urutan) {
+    return {
+        kode: '',
+        label: '',
+        tipe: 'teks',
+        wajib: false,
+        satuan: '',
+        opsi: [],
+        urutan,
+        popupPeta: false,
+        sebagaiFilter: false,
+        sebagaiIndikator: false,
+        sumber: 'manual',
+        sumber: 'manual',
+        aturanHitung: null,
+        rujukan: null,
+    };
+}
+
+/**
+ * Baca seluruh baris yang sedang tampil di DOM menjadi bentuk state.
+ *
+ * DOM adalah sumber pembacaan; `stateIsian` dipakai untuk pratinjau & serialisasi.
+ *
+ * @param {HTMLElement} tbody
+ */
+// ---------------------------------------------------------------------------
+// FR-008g / Q27 — pembungkus SweetAlert2.
+//
+// ⚠️ SELURUH pesan pada halaman editor skema WAJIB lewat `window.Swal`
+// (sweetalert2 v11, dimuat pada `index.blade.php`). `window.alert`,
+// `window.confirm`, dan `window.prompt` TIDAK BOLEH dipakai.
+//
+// Fallback ke `window.confirm`/`window.alert` hanya berlaku bila SweetAlert2
+// gagal dimuat (mis. CDN terblokir) agar halaman tetap berfungsi.
+// ---------------------------------------------------------------------------
+
+const swalTersedia = () => typeof window.Swal !== 'undefined';
+
+/** Notifikasi hasil aksi (sukses / gagal). */
+const swalPesan = (pesan, ikon = 'info') => {
+    if (!swalTersedia()) {
+        window.alert(pesan);
+
+        return Promise.resolve();
+    }
+
+    return window.Swal.fire({
+        title: pesan,
+        icon: ikon,
+        confirmButtonText: 'Mengerti',
+        customClass: { popup: 'rounded-lg' },
+    });
+};
+
+const swalSukses = (pesan) => swalPesan(pesan, 'success');
+const swalGalat = (pesan) => swalPesan(pesan, 'error');
+const swalPeringatan = (pesan) => swalPesan(pesan, 'warning');
+
+/** Konfirmasi ya/tidak. Mengembalikan Promise<boolean>. */
+const swalKonfirmasi = async (pesan, judul = 'Konfirmasi') => {
+    if (!swalTersedia()) {
+        return window.confirm(pesan);
+    }
+
+    const hasil = await window.Swal.fire({
+        title: judul,
+        text: pesan,
+        icon: 'warning',
+        showCancelButton: true,
+        confirmButtonText: 'Ya, lanjutkan',
+        cancelButtonText: 'Batal',
+        reverseButtons: true,
+        customClass: { popup: 'rounded-lg' },
+    });
+
+    return hasil.isConfirmed === true;
+};
+
+/** Input teks tunggal (mis. catatan perubahan penerbitan). */
+const swalInput = async (pesan, judul = 'Masukkan nilai', nilaiAwal = '') => {
+    if (!swalTersedia()) {
+        return window.prompt(pesan, nilaiAwal) || '';
+    }
+
+    const hasil = await window.Swal.fire({
+        title: judul,
+        input: 'text',
+        inputLabel: pesan,
+        inputValue: nilaiAwal,
+        showCancelButton: true,
+        confirmButtonText: 'Simpan',
+        cancelButtonText: 'Batal',
+        inputValidator: (nilai) => (nilai && nilai.length > 500 ? 'Maksimal 500 karakter' : undefined),
+        customClass: { popup: 'rounded-lg' },
+    });
+
+    return hasil.isConfirmed === true ? (hasil.value || '') : null;
+};
+
+/** Escape nilai sebelum disisipkan ke markup SweetAlert2. */
+function escapeHtml(nilai) {
+    return String(nilai ?? '').replace(/[&<>"']/g, (karakter) => ({
+        '&': '&amp;',
+        '<': '&lt;',
+        '>': '&gt;',
+        '"': '&quot;',
+        "'": '&#039;',
+    }[karakter]));
+}
+
+/**
+ * Susun rujukan sumber satu baris: "tabel.kolom".
+ *
+ * ⚠️ Bentuk API hanya punya SATU kolom `rujukan_sumber` (§6a.4). Dua input
+ * tabel & kolom pada tabel editor karena itu digabung di sini menjadi satu
+ * nilai `rujukan`; penyambungan di sisi server ada pada
+ * `SkemaEditorService::composePemetaan()`.
+ *
+ * @param {HTMLElement} tr
+ * @param {HTMLElement|null} sel Elemen `.sumber-nilai` (pemegang dataset).
+ * @returns {string}
+ */
+function rujukanDari(tr, sel) {
+    const tabel = (tr.querySelector('.input-tabel-sumber')?.value
+        || sel?.dataset?.tabelSumber || '').trim();
+    const kolom = (tr.querySelector('.input-kolom-sumber')?.value
+        || sel?.dataset?.kolomSumber || '').trim();
+
+    return [tabel, kolom].filter(Boolean).join('.');
+}
+
+/**
+ * Baca opsi satu baris isian.
+ *
+ * ⚠️ Kolom "Pilihan" tidak lagi ada di tabel editor (tidak dipakai), sehingga
+ * nilai opsi diambil dari atribut `data-opsi`. Bila atribut tidak tersedia,
+ * kembalikan array kosong.
+ *
+ * @param {HTMLElement} tr
+ * @returns {Array<string>}
+ */
+function bacaOpsiBaris(tr) {
+    const mentah = tr?.dataset?.opsi;
+
+    if (!mentah || mentah === '[]' || mentah === 'null') {
+        return [];
+    }
+
+    try {
+        const hasil = JSON.parse(mentah);
+
+        return Array.isArray(hasil) ? hasil.filter((v) => typeof v === 'string') : [];
+    } catch (e) {
+        return [];
+    }
+}
+
+function bacaDariDom(tbody) {
+    return Array.from(tbody.querySelectorAll('tr[data-testid="baris-isian"], tr.baris-baru'))
+        .map((tr, index) => {
+            const nilai = (selector) => tr.querySelector(selector);
+            const sel = nilai('.sumber-nilai');
+
+            return {
+                // ⚠️ FR-017/Q14 — `kode` SELALU diturunkan ulang dari `label`,
+                // tidak pernah dipercaya apa adanya dari input baca-saja.
+                kode: slugKodeDariLabel(nilai('.input-label')?.value ?? ''),
+                label: nilai('.input-label')?.value?.trim() ?? '',
+                tipe: nilai('.input-tipe')?.value ?? 'teks',
+                wajib: Boolean(nilai('.input-wajib')?.checked),
+                satuan: nilai('.input-satuan')?.value?.trim() ?? '',
+                // ⚠️ Kolom Pilihan (opsi) TIDAK lagi ditampilkan pada tabel
+                // editor. Nilainya dibaca dari atribut `data-opsi` pada baris
+                // supaya opsi yang tersimpan di API tidak hilang saat Simpan draf.
+                opsi: bacaOpsiBaris(tr),
+                urutan: index + 1,
+                popupPeta: Boolean(nilai('.input-popup-peta')?.checked),
+                sebagaiFilter: Boolean(nilai('.input-filter')?.checked),
+                sebagaiIndikator: Boolean(nilai('.input-indikator')?.checked),
+                sumber: sel?.dataset?.sumber ?? 'manual',
+                // ⚠️ `rujukan` = "tabel.kolom" adalah nilai yang benar-benar
+                // disimpan sebagai `rujukan_sumber` (§6a.4). Field tabel/kolom
+                // di bawah hanya dipakai untuk memulihkan snapshot (Batal).
+                rujukan: rujukanDari(tr, sel) || null,
+                tabelSumber: sel?.dataset?.tabelSumber ?? null,
+                kolomSumber: sel?.dataset?.kolomSumber ?? null,
+            };
+        });
+}
+
+/**
+ * Terapkan aturan kolom  tipe (FR-010).
+ *
+ * @param {HTMLElement} tbody
+ */
+function terapkanAturanTipe(tbody) {
+    tbody.querySelectorAll('tr').forEach((tr) => {
+        const tipe = tr.querySelector('.input-tipe')?.value ?? 'teks';
+        const satuan = tr.querySelector('.input-satuan');
+        const bolehUbah = tbody.dataset.bolehUbah === '1';
+
+        if (satuan) {
+            satuan.disabled = !bolehUbah || tipe !== TIPE_SATUAN;
+        }
+    });
+}
+
+/**
+ * Render pratinjau dari state yang SAMA dengan form (FR-034/FR-035, R7).
+ *
+ * @param {HTMLElement} wadah
+ * @param {Array<object>} isian
+ */
+function renderPratinjau(wadah, isian) {
+    if (!wadah) {
+        return;
+    }
+
+    if (isian.length === 0) {
+        wadah.innerHTML = '<p class="text-muted text-center small mb-0">'
+            + 'Belum ada isian. Pratinjau akan muncul setelah isian pertama ditambahkan.</p>';
+
+        return;
+    }
+
+    wadah.innerHTML = isian.map((baris) => {
+        const terkunci = baris.sumber && baris.sumber !== 'manual';
+        const wajib = baris.wajib
+            ? '<span class="text-danger ml-1" title="Wajib diisi">*</span>'
+            : '';
+
+        let kontrol;
+
+        if (terkunci) {
+            kontrol = '<div class="form-control input-group-sm" style="background:#f1f2f3;'
+                + 'border:1px dashed #adb5bd;min-height:calc(1.5em + .5rem + 2px)">'
+                + '<span class="text-muted"><i class="fas fa-lock mr-1"></i>'
+                + 'Diisi dari sumber: ' + (baris.sumber || 'pemetaan') + '</span></div>';
+        } else if (baris.tipe === TIPE_PILIHAN) {
+            kontrol = '<select class="form-control form-control-sm" disabled>'
+                + '<option>— pilih —</option>'
+                + baris.opsi.map((o) => `<option>${o}</option>`).join('')
+                + '</select>';
+        } else if (baris.tipe === 'ya_tidak') {
+            kontrol = '<select class="form-control form-control-sm" disabled>'
+                + '<option>Ya</option><option>Tidak</option></select>';
+        } else if (baris.tipe === 'tanggal') {
+            kontrol = '<input type="date" class="form-control form-control-sm" disabled>';
+        } else {
+            kontrol = '<input type="' + (baris.tipe === TIPE_SATUAN ? 'number' : 'text')
+                + '" class="form-control form-control-sm" disabled placeholder="'
+                + (baris.satuan || 'isi nilai') + '">';
+        }
+
+        const catatanTersembunyi = terkunci && !baris.rujukan
+            ? '<small class="text-muted d-block mt-1">Nilai belum tersedia dari sumber.</small>'
+            : '';
+
+        const penanda = [];
+        if (baris.popupPeta) { penanda.push('<span class="badge badge-info mr-1">Peta</span>'); }
+        if (baris.sebagaiFilter) { penanda.push('<span class="badge badge-secondary mr-1">Filter</span>'); }
+        if (baris.sebagaiIndikator) { penanda.push('<span class="badge badge-primary mr-1">Indikator</span>'); }
+
+        return '<div class="mb-2 pb-2 border-bottom" data-testid="pratinjau-baris">'
+            + '<label class="mb-1 small font-weight-bold">' + (baris.label || '(tanpa label)')
+            + wajib + '</label>'
+            + kontrol
+            + (penanda.length ? '<div class="mt-1">' + penanda.join('') + '</div>' : '')
+            + catatanTersembunyi
+            + '</div>';
+    }).join('');
+}
+
+/**
+ * Serialisasi state ke input tersembunyi milik form POST (FR-029).
+ *
+ * ⚠️ Nama key di sini mengikuti aturan validasi `StoreDrafSkemaRequest`;
+ * pemetaan ke NAMA ASUMSI kontrak terjadi di `SkemaEditorService`.
+ *
+ * @param {Array<object>} isian
+ */
+function serialisasiKeForm(isian) {
+    const wadah = document.getElementById('wadah-input-isian');
+    const form = document.getElementById('form-draf');
+
+    if (!wadah || !form) {
+        return;
+    }
+
+    wadah.innerHTML = '';
+
+    isian.forEach((baris, index) => {
+        const tambah = (name, value) => {
+            const input = document.createElement('input');
+            input.type = 'hidden';
+            input.name = `isian[${index}][${name}]`;
+            input.value = value ?? '';
+            wadah.appendChild(input);
+        };
+
+        tambah('kode', baris.kode);
+        tambah('label', baris.label);
+        tambah('tipe', baris.tipe);
+        tambah('wajib', baris.wajib ? '1' : '0');
+        tambah('satuan', baris.satuan || '');
+        tambah('urutan', baris.urutan);
+
+        if (baris.tipe === TIPE_PILIHAN) {
+            baris.opsi.forEach((opsi) => tambah(`opsi[]`, opsi));
+        }
+
+        // ⚠️ Nama INTERNAL. Pemetaan ke nama field asumsi kontrak API hanya
+        // terjadi di `SkemaEditorService::composeDrafPayload()` (research.md R12).
+        tambah('popupPeta', baris.popupPeta ? '1' : '0');
+        tambah('sebagaiFilter', baris.sebagaiFilter ? '1' : '0');
+        tambah('sebagaiIndikator', baris.sebagaiIndikator ? '1' : '0');
+
+        // ⚠️ `sumber` berisi ENUM API (`openSID`/`dataPresisi`/`impor`),
+        // bukan kode sektor — hasil verifikasi langsung ke API (§6a.5).
+        if (baris.sumber && baris.sumber !== 'manual') {
+            tambah('sumber', baris.sumber);
+            // ⚠️ Satu nilai "tabel.kolom" — inilah yang disimpan sebagai
+            // `rujukan_sumber` (§6a.4). Tabel & kolom tidak dikirim terpisah.
+            tambah('rujukan', baris.rujukan || '');
+        }
+    });
+}
+
+/** Kosongkan pratinjau (dipakai mode "sektor baru", FR-008f). */
+function kosongkanPenandaPratinjau(wadah) {
+    if (wadah) {
+        wadah.innerHTML = '<p class="text-muted text-center small mb-0">'
+            + 'Belum ada isian. Pratinjau akan muncul setelah isian pertama ditambahkan.</p>';
+    }
+}
+
+/**
+ * Validasi keunikan di sisi klien untuk umpan balik INSTAN (FR-018, Q14/Q17).
+ *
+ * ⚠️ Ini HANYA untuk UX. Satu-satunya penentu tetap validasi server
+ * (FR-020: API tidak boleh pernah menerima kode bentrok dari pengguna ini).
+ *
+ * ⚠️ Cakupannya **satu versi** yang sedang disunting — baris di luar tabel ini
+ * (versi sebelumnya) tidak diperiksa (Q17).
+ *
+ * ⚠️ Yang dibandingkan adalah `label` (bukan kode) supaya pesan dapat
+ * langsung ditindaklanjuti admin; kode turunan ikut terisi Unique karena
+ * diturunkan dari label (Q14).
+ *
+ * @param {HTMLElement} tbody
+ */
+function validasiKodeLokal(tbody) {
+    const labelDilihat = new Map();
+
+    tbody.querySelectorAll('tr').forEach((tr) => {
+        const inputLabel = tr.querySelector('.input-label');
+        const galat = tr.querySelector('.galat-kode');
+
+        if (!inputLabel) {
+            return;
+        }
+
+        galat?.remove();
+        inputLabel.classList.remove('is-invalid');
+
+        const label = inputLabel.value.trim();
+
+        if (label === '') {
+            return;
+        }
+
+        // ⚠️ Kolom kode tidak lagi ada di tabel (FR-017/Q14); kodenya hanya
+        // dihitung saat serialisasi (`bacaDariDom`), bukan ditampilkan.
+        const kode = slugKodeDariLabel(label);
+
+        let pesan = '';
+
+        if (kode === '') {
+            pesan = 'Label ini tidak menghasilkan kode yang sah. Gunakan huruf dan angka, contoh: "Jumlah Siswa".';
+        } else if (labelDilihat.has(kode)) {
+            pesan = `Label "${label}" sudah dipakai isian lain pada versi ini. `
+                + 'Ubah labelnya — kode tidak dibuat otomatis dengan akhiran angka.';
+        } else {
+            labelDilihat.set(kode, true);
+        }
+
+        if (pesan === '') {
+            return;
+        }
+
+        inputLabel.classList.add('is-invalid');
+        const info = document.createElement('small');
+        info.className = 'galat-kode text-danger d-block';
+        info.textContent = pesan;
+        inputLabel.parentElement.appendChild(info);
+    });
+}
+
+/**
+ * Seret-urut NATIVE HTML5 Drag & Drop (FR-012, research.md R8).
+ *
+ * @param {HTMLElement} tbody
+ * @param {Function} onMutasi
+ */
+function pasangSeretUrutan(tbody, onMutasi) {
+    if (tbody.dataset.bolehUbah !== '1') {
+        return;
+    }
+
+    let yangDiseret = null;
+
+    tbody.addEventListener('dragstart', (event) => {
+        const tr = event.target.closest('tr');
+
+        if (!tr) {
+            return;
+        }
+
+        yangDiseret = tr;
+        tr.classList.add('baris-sedang-diseret');
+        event.dataTransfer.effectAllowed = 'move';
+        // Firefox membutuhkan dataTransfer berisi data agar drag dimulai.
+        event.dataTransfer.setData('text/plain', '');
+    });
+
+    tbody.addEventListener('dragover', (event) => {
+        event.preventDefault();
+        event.dataTransfer.dropEffect = 'move';
+
+        const target = event.target.closest('tr');
+
+        if (!target || target === yangDiseret || !yangDiseret) {
+            return;
+        }
+
+        // Sisipkan sebelum / sesudah posisi tetikus.
+        const kotak = target.getBoundingClientRect();
+        const setelah = event.clientY - kotak.top > kotak.height / 2;
+
+        target.parentNode.insertBefore(
+            yangDiseret,
+            setelah ? target.nextSibling : target
+        );
+    });
+
+    tbody.addEventListener('dragend', () => {
+        yangDiseret?.classList.remove('baris-sedang-diseret');
+        yangDiseret = null;
+        perbaruiNomorUrutan(tbody);
+        onMutasi();
+    });
+
+    tbody.addEventListener('drop', (event) => event.preventDefault());
+}
+
+/**
+ * Tulis ulang kolom `#` menjadi 1..N (FR-012).
+ *
+ * @param {HTMLElement} tbody
+ */
+function perbaruiNomorUrutan(tbody) {
+    tbody.querySelectorAll('tr').forEach((tr, index) => {
+        tr.dataset.index = String(index);
+
+        const sel = tr.querySelector('.urutan');
+
+        if (sel) {
+            sel.textContent = String(index + 1);
+        }
+    });
+}
+
+export function mountSchemaEditor() {
+    const akar = document.querySelector('[data-status-editor]');
+    const tbody = document.getElementById('isi-tabel-isian');
+
+    if (!akar || !tbody) {
+        return;
+    }
+
+    const wadahPratinjau = document.getElementById('wadah-pratinjau');
+    const template = document.getElementById('template-baris-isian');
+    // FR-008c/Q24 — `bolehUbah` mutable supaya tombol "Ubah" dapat membuka
+    // kunci penyuntingan pada skema `terbit` tanpa memuat ulang halaman.
+    let bolehUbah = tbody.dataset.bolehUbah === '1';
+    const sektorKode = akar.dataset.sektor || '';
+    const skemaAktif = akar.dataset.skema || '';
+
+    let dirty = false;
+
+    // Q25 — snapshot isian saat halaman siap, dipakai untuk "Batal" sehingga
+    // perubahan belum tersimpan dibuang tanpa memuat ulang halaman (nol request).
+    const snapshotAwal = bacaDariDom(tbody);
+
+    const tombolUbah = document.getElementById('btn-ubah');
+    const tombolBatalUbah = document.getElementById('btn-batal-ubah');
+    const tombolSimpan = document.getElementById('btn-simpan-draf');
+    const inputNamaSektor = document.getElementById('input-sektor-nama-editor');
+    const wadahNamaSektor = document.getElementById('wadah-input-sektor-nama');
+    let modeUbahAktif = false;
+    let modeSektorBaru = false;
+
+    /** Aktifkan/nonaktifkan seluruh kontrol isian pada tabel (FR-008c/FR-008e). */
+    const kunciKontrolIsian = (aktif) => {
+        tbody.querySelectorAll(
+            '.input-label, .input-tipe, .input-wajib, .input-satuan, '
+            + '.input-popup-peta, .input-filter, .input-indikator, '
+            + '.input-tabel-sumber, .input-kolom-sumber, .btn-pilih-sumber-baris, .btn-hapus-isian',
+        ).forEach((el) => {
+            if (el.tagName === 'INPUT') {
+                el.disabled = !aktif;
+            }
+        });
+
+        // Tombol tambah/seret isian mengikuti kunci yang sama (FR-012).
+        const tombolTambah = document.getElementById('btn-tambah-isian');
+
+        if (tombolTambah) {
+            tombolTambah.disabled = !aktif;
+        }
+
+        if (inputNamaSektor) {
+            inputNamaSektor.disabled = !aktif;
+        }
+
+        tbody.dataset.bolehUbah = aktif ? '1' : '0';
+        terapkanAturanTipe(tbody);
+
+        // ⚠️ Baris kosong yang ditambahkan lewat template juga ikut terkunci
+        // pada keadaan baca-saja (FR-008a). Tanpa ini, baris baru akan tetap
+        // aktif walau skema sedang `terbit`.
+        if (!aktif) {
+            template?.content.querySelectorAll(
+                '.input-label, .input-tipe, .input-wajib, .input-satuan, '
+                + '.input-popup-peta, .input-filter, .input-indikator',
+            ).forEach((el) => {
+                if (el.tagName === 'INPUT') {
+                    el.disabled = true;
+                }
+            });
+        }
+    };
+
+    /** Pulihkan nilai kontrol isian dari snapshot (Q25). */
+    const pulihkanDariSnapshot = () => {
+        const baris = Array.from(tbody.querySelectorAll('tr[data-testid="baris-isian"], tr.baris-baru'));
+
+        baris.forEach((tr, index) => {
+            const sumber = snapshotAwal[index];
+
+            if (!sumber) {
+                return;
+            }
+
+            const label = tr.querySelector('.input-label');
+            const tipe = tr.querySelector('.input-tipe');
+            const wajib = tr.querySelector('.input-wajib');
+            const satuan = tr.querySelector('.input-satuan');
+            const sumberNilai = tr.querySelector('.sumber-nilai');
+
+            if (label) {
+                label.value = sumber.label ?? '';
+            }
+
+            if (tipe) {
+                tipe.value = sumber.tipe ?? 'teks';
+            }
+
+            if (wajib) {
+                wajib.checked = Boolean(sumber.wajib);
+            }
+
+            if (satuan) {
+                satuan.value = sumber.satuan ?? '';
+            }
+
+            // ⚠️ Kolom Pilihan tidak dirender; opsi dipulihkan lewat `data-opsi`
+            // yang dipakai `bacaOpsiBaris()` saat serialize.
+            tr.dataset.opsi = JSON.stringify(sumber.opsi ?? []);
+
+            if (sumberNilai) {
+                sumberNilai.dataset.sumber = sumber.sumber ?? 'manual';
+                sumberNilai.dataset.tabelSumber = sumber.tabelSumber ?? '';
+                sumberNilai.dataset.kolomSumber = sumber.kolomSumber ?? '';
+                sumberNilai.dataset.rujukan = sumber.rujukan || '';
+
+                const tabel = tr.querySelector('.input-tabel-sumber');
+                const kolom = tr.querySelector('.input-kolom-sumber');
+
+                if (tabel) {
+                    tabel.value = sumber.tabelSumber ?? '';
+                }
+
+                if (kolom) {
+                    kolom.value = sumber.kolomSumber ?? '';
+                }
+            }
+        });
+
+        renderPratinjau(wadahPratinjau, bacaDariDom(tbody));
+    };
+
+    /**
+     * FR-008c (Q24) — tombol "Ubah": aksi klien semata, TANPA permintaan ke
+     * sumber data. Membuka kunci isian, mengaktifkan Simpan draf, menyembunyikan
+     * tombol Ubah, dan menampilkan tombol Batal.
+     */
+    tombolUbah?.addEventListener('click', () => {
+        modeUbahAktif = true;
+        bolehUbah = true;
+        kunciKontrolIsian(true);
+
+        if (tombolSimpan) {
+            tombolSimpan.disabled = false;
+        }
+
+        tombolUbah.classList.add('d-none');
+        tombolBatalUbah?.classList.remove('d-none');
+        perbaruiTombolTerbit();
+    });
+
+    /**
+     * FR-008e (Q25) — tombol "Batal": mengembalikan editor ke baca-saja
+     * `terbit` tanpa permintaan ke sumber data; perubahan belum tersimpan dibuang.
+     */
+    tombolBatalUbah?.addEventListener('click', () => {
+        modeUbahAktif = false;
+
+        // FR-008f — Batal pada mode "sektor baru" menutup mode itu tanpa
+        // menyimpan apa pun dan tanpa permintaan ke sumber data.
+        if (modeSektorBaru) {
+            modeSektorBaru = false;
+            kosongkanTabelIsian();
+            kosongkanPenandaPratinjau(wadahPratinjau);
+
+            if (inputNamaSektor) {
+                inputNamaSektor.value = akar.dataset.sektorNama || '';
+            }
+
+            kunciKontrolIsian(false);
+
+            // Bila memang tidak ada sektor yang dipilih, kembalikan blok nama
+            // sektor ke kondisi tersembunyi seperti semula.
+            if (sektorKode === '') {
+                wadahNamaSektor?.classList.add('d-none');
+            }
+
+            document.getElementById('isian-belum-pilih-sektor')?.classList.remove('d-none');
+
+            if (tombolSimpan) {
+                tombolSimpan.disabled = true;
+            }
+
+            tombolBatalUbah.classList.add('d-none');
+            tombolUbah?.classList.remove('d-none');
+            perbaruiTombolTerbit();
+
+            return;
+        }
+
+        pulihkanDariSnapshot();
+        bolehUbah = false;
+        kunciKontrolIsian(false);
+
+        if (tombolSimpan) {
+            tombolSimpan.disabled = true;
+        }
+
+        tombolBatalUbah.classList.add('d-none');
+        tombolUbah?.classList.remove('d-none');
+        dirty = false;
+        perbaruiNomorUrutan(tbody);
+        perbaruiTombolTerbit();
+    });
+
+    const mutasi = () => {
+        dirty = true;
+        perbaruiNomorUrutan(tbody);
+        terapkanAturanTipe(tbody);
+        validasiKodeLokal(tbody);
+        renderPratinjau(wadahPratinjau, bacaDariDom(tbody));
+        // FR-045 — perubahan baru membuat penerbitan tidak boleh dipakai.
+        perbaruiTombolTerbit();
+    };
+
+    const pasangKonfirmasi = () => {
+        if (!dirty) {
+            return true;
+        }
+
+        const pesan = 'Ada perubahan yang belum disimpan. Tinggalkan halaman?';
+
+        return swalKonfirmasi(pesan, 'Perubahan belum disimpan');
+    };
+
+    // -----------------------------------------------------------------------
+    // Tambah isian (US1#13, US2)
+    // -----------------------------------------------------------------------
+    document.getElementById('btn-tambah-isian')?.addEventListener('click', async () => {
+        if (!template) {
+            // ⚠️ Guard: template WAJIB selalu ada di DOM (lihat
+            // tabel-isian.blade.php). Bila hilang, beri umpan balik alih-alih
+            // diam-diam tidak terjadi apa pun (FR-008g).
+            await swalGalat('Fungsi tambah isian belum siap. Muat ulang halaman.');
+
+            return;
+        }
+
+        if (!bolehUbah) {
+            await swalPeringatan('Skema ini sedang dibaca. Tekan Ubah untuk menyuntingnya.');
+
+            return;
+        }
+
+        tbody.appendChild(template.content.cloneNode(true));
+        perbaruiNomorUrutan(tbody);
+        mutasi();
+
+        // ⚠️ FR-017/Q14 — `kode` kini baca-saja, jadi fokus awal ke ke `label`
+        // yang menjadi sumber kebenaran kode.
+        tbody.querySelector('tr:last-child .input-label')?.focus();
+    });
+
+    // -----------------------------------------------------------------------
+    // Hapus isian (FR-014, US2#4/#6)
+    // -----------------------------------------------------------------------
+    tbody.addEventListener('click', async (event) => {
+        const tombol = event.target.closest('.btn-hapus-isian');
+
+        if (!tombol) {
+            return;
+        }
+
+        const tr = tombol.closest('tr');
+        // ⚠️ Q14 — admin tidak lagi mengetik `kode`, jadi konfirmasi menyebut
+        // LABEL yang mereka lihat di tabel. `data-kode` dipakai sebagai cadangan
+        // untuk baris yang labelnya kosong.
+        const label = tr?.querySelector('.input-label')?.value?.trim()
+            || tombol.dataset.kode
+            || '(tanpa label)';
+        const terpetakan = tombol.dataset.terpetakan === '1';
+
+        const pesan = terpetakan
+            ? `Hapus isian "${label}"? Pemetaan sumber nilainya juga akan dilepas.`
+            : `Hapus isian "${label}"?`;
+
+        if (!(await swalKonfirmasi(pesan, 'Hapus isian'))) {
+            return;
+        }
+
+        tr?.remove();
+        perbaruiNomorUrutan(tbody);
+        mutasi();
+    });
+
+    // -----------------------------------------------------------------------
+    // Tambah sektor (US1#8)
+    // -----------------------------------------------------------------------
+    // -----------------------------------------------------------------------
+    // FR-008f / Q26 — mode "sektor baru".
+    //
+    // ⚠️ Tidak ada lagi formulir terpisah: tombol ini membuka mode penyuntingan
+    // yang SAMA dengan tombol "Ubah". Sektor + isian pertama tersimpan
+    // bersamaan pada satu POST /dataspasial/skema, dan **tidak ada** permintaan
+    // ke sumber data selama mode ini aktif (Q19/Q23/Q26).
+    // -----------------------------------------------------------------------
+    const kosongkanTabelIsian = () => {
+        tbody.querySelectorAll('tr[data-testid="baris-isian"], tr.baris-baru').forEach((tr) => {
+            if (!tr.classList.contains('baris-baru')) {
+                tr.remove();
+            }
+        });
+    };
+
+    document.getElementById('btn-tambah-sektor')?.addEventListener('click', () => {
+        modeSektorBaru = true;
+        modeUbahAktif = false;
+        dirty = false;
+
+        // ⚠️ Mode "sektor baru" adalah keadaan MENYUNTING — `bolehUbah` harus
+        // true supaya guard tombol Tambah Isian Baru tidak salah memberi tahu
+        // "Skema ini sedang dibaca" (FR-008f).
+        bolehUbah = true;
+
+        if (inputNamaSektor) {
+            inputNamaSektor.value = '';
+        }
+
+        kosongkanTabelIsian();
+        kosongkanPenandaPratinjau(wadahPratinjau);
+        kunciKontrolIsian(true);
+
+        // ⚠️ Blok nama sektor disembunyikan Blade saat belum ada sektor terpilih;
+        // pada mode "sektor baru" blok ini WAJIB dibuka supaya admin punya
+        // kolom untuk diisi nama (FR-008f).
+        wadahNamaSektor?.classList.remove('d-none');
+
+        // Pesan "pilih salah satu sektor" tidak relevan selama mode ini aktif.
+        document.getElementById('isian-belum-pilih-sektor')?.classList.add('d-none');
+
+        if (tombolSimpan) {
+            tombolSimpan.disabled = false;
+        }
+
+        if (tombolTerbit) {
+            tombolTerbit.disabled = true;
+            tombolTerbit.title = 'Terbitkan setelah draf tersimpan.';
+        }
+
+        tombolUbah?.classList.add('d-none');
+        tombolBatalUbah?.classList.remove('d-none');
+        inputNamaSektor?.focus();
+    });
+
+    // -----------------------------------------------------------------------
+    // Simpan draf (US3) — pemicu konfirmasi yang sama (FR-007h)
+    // -----------------------------------------------------------------------
+    document.getElementById('btn-simpan-draf')?.addEventListener('click', async () => {
+        if (!bolehUbah) {
+            return;
+        }
+
+        // FR-008f — mode "sektor baru": nama sektor wajib diisi sebelum simpan.
+        if (modeSektorBaru && ((inputNamaSektor?.value ?? '').trim() === '')) {
+            await swalPeringatan('Nama sektor wajib diisi.');
+
+            return;
+        }
+
+        // ⚠️ Q22 — editor hanya menampilkan SATU skema (versi terakhir), jadi
+        // tidak ada lagi daftar versi yang perlu dicek untuk "draf sudah ada".
+        const isian = bacaDariDom(tbody);
+
+        if (isian.length === 0) {
+            await swalPeringatan('Sektor harus memiliki minimal satu isian.');
+
+            return;
+        }
+
+        // ⚠️ FR-018/Q14/Q17 — yang dibandingkan adalah `label`; kode turunan
+        // otomatis unik kalau label-nya unik. Cakupannya satu versi ini saja.
+        const labelBentrok = isian
+            .map((b) => b.label)
+            .filter((label, i, arr) => label !== '' && arr.indexOf(label) !== i);
+
+        if (labelBentrok.length > 0) {
+            await swalPeringatan(`Label "${labelBentrok[0]}" dipakai lebih dari satu isian pada versi ini.`);
+
+            return;
+        }
+
+        const kodeKosong = isian.find((b) => b.kode === '');
+
+        if (kodeKosong) {
+            await swalPeringatan(`Label "${kodeKosong.label}" tidak menghasilkan kode yang sah. Perbaiki labelnya.`);
+
+            return;
+        }
+
+        serialisasiKeForm(isian);
+        dirty = false;
+        perbaruiTombolTerbit();
+
+        // US7/Q19 — nama sektor SELALU diambil dari input yang dapat disunting;
+        // pada mode "sektor baru" (Q26) input itu sengaja dikosongkan oleh sistem.
+        const inputNama = document.getElementById('input-sektor-nama-editor');
+        const sektorNama = (inputNama?.value ?? '').trim()
+            || akar.dataset.sektorNama
+            || '';
+
+        // ⚠️ FR-008f — pada mode "sektor baru" kode sektor BELUM ada; backend
+        // membangkitkannya dari nama (Q5/FR-007d-1), jadi klien mengirim kosong.
+        const sektorKodeKirim = modeSektorBaru ? '' : (sektorKode || '');
+        const token = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content')
+            ?? document.querySelector('input[name="_token"]')?.value
+            ?? '';
+
+        try {
+            const respons = await fetch('/dataspasial/skema/draf', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Accept: 'application/json',
+                    'X-Requested-With': 'XMLHttpRequest',
+                    'X-CSRF-TOKEN': token,
+                },
+                credentials: 'same-origin',
+                body: JSON.stringify({
+                    sektor: sektorKodeKirim,
+                    sektor_nama: sektorNama,
+                    keterangan: '',
+                    isian,
+                }),
+            });
+
+            if (respons.status === 422) {
+                const data = await respons.json().catch(() => ({}));
+                await swalPeringatan((data && data.message) || 'Validasi gagal. Periksa isian dan coba lagi.');
+                dirty = true;
+                perbaruiTombolTerbit();
+                return;
+            }
+
+            if (!respons.ok) {
+                await swalGalat('Data sementara tidak tersedia. Silakan coba lagi nanti.');
+                dirty = true;
+                perbaruiTombolTerbit();
+                return;
+            }
+
+            await swalSukses(modeSektorBaru ? 'Sektor berhasil dibuat.' : 'Draf skema berhasil disimpan.');
+        } catch (error) {
+            await swalGalat('Data sementara tidak tersedia. Silakan coba lagi nanti.');
+            dirty = true;
+            perbaruiTombolTerbit();
+        }
+    });
+
+    // -----------------------------------------------------------------------
+    // Terbitkan draf (US8, FR-041 … FR-045)
+    // -----------------------------------------------------------------------
+    const tombolTerbit = document.getElementById('btn-terbitan');
+    const formTerbit = document.getElementById('form-terbit');
+
+    // ⚠️ Keadaan awal berasal dari server (FR-041): tombol hanya aktif bila
+    // skema berstatus `draf`. Untuk status `terbit` tombol **tetap** nonaktif —
+    // dirty-guard hanya boleh MENONAKAN tombol, tidak boleh menghidupkannya.
+    const bolehTerbitAwal = tombolTerbit ? !tombolTerbit.disabled : false;
+
+    /**
+     * FR-045 — penerbitan menghasilkan versi immutable, jadi isian yang belum
+     * disimpan tidak boleh diterbitkan. Tombol dinonaktifkan selama `dirty`.
+     */
+    const perbaruiTombolTerbit = () => {
+        if (!tombolTerbit || !bolehTerbitAwal) {
+            return;
+        }
+
+        // FR-008d/Q24 — pada mode "Ubah" (draf baru dari versi terbit), tombol
+        // Terbitan tetap nonaktif sampai draf benar-benar tersimpan (FR-045).
+        if (modeUbahAktif) {
+            tombolTerbit.disabled = true;
+            tombolTerbit.title = 'Simpan draf dulu — ada perubahan yang belum disimpan.';
+
+            return;
+        }
+
+        if (dirty) {
+            tombolTerbit.disabled = true;
+            tombolTerbit.title = 'Simpan draf dulu — ada perubahan yang belum disimpan.';
+
+            return;
+        }
+
+        tombolTerbit.disabled = false;
+        tombolTerbit.removeAttribute('title');
+    };
+
+    // Panggil sekali setelah DOM siap agar tombol sesuai keadaan awal.
+    perbaruiTombolTerbit();
+
+    tombolTerbit?.addEventListener('click', async () => {
+        if (!formTerbit || !sektorKode) {
+            return;
+        }
+
+        // FR-045 — pengaman kedua di sisi klien.
+        if (dirty) {
+            await swalPeringatan('Simpan draf dulu. Ada perubahan yang belum disimpan.');
+
+            return;
+        }
+
+        const namaSektor = (document.getElementById('input-sektor-nama-editor')?.value ?? '').trim()
+            || document.querySelector('[data-testid="item-sektor"][data-sektor-kode="' + sektorKode + '"]')
+                ?.dataset?.sektorNama
+            || sektorKode;
+
+        // FR-042/Q18 — nomor versi ditentukan API, jadi konfirmasi TIDAK lagi
+        // menyebut angka; ia menyatakan bahwa versi baru immutable akan dibuat.
+        const pesan = `Terbitkan draf sektor "${namaSektor}"?\n\n`
+            + 'Penerbitan membuat versi baru yang immutable dan tidak dapat diubah lagi. '
+            + 'Nomor versinya ditentukan sistem.';
+
+        if (!(await swalKonfirmasi(pesan, 'Terbitkan skema'))) {
+            return;
+        }
+
+        const inputCatatan = formTerbit.querySelector('[name="catatan_perubahan"]');
+        const hasilInput = await swalInput('Catatan perubahan (opsional)', 'Catatan perubahan', '');
+
+        if (hasilInput === null) {
+            return;
+        }
+
+        const catatan = hasilInput;
+
+        if (inputCatatan) {
+            inputCatatan.value = catatan;
+        }
+
+        // Q21 — terbitkan lewat AJAX, tanpa memuat ulang halaman.
+        const token = document.querySelector('meta[name="csrf-token"]')?.getAttribute('content')
+            ?? inputCatatan?.value
+            ?? '';
+
+        fetch('/dataspasial/skema/terbit', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Accept: 'application/json',
+                'X-Requested-With': 'XMLHttpRequest',
+                'X-CSRF-TOKEN': token,
+            },
+            credentials: 'same-origin',
+            body: JSON.stringify({ sektor: sektorKode, catatan_perubahan: catatan }),
+        })
+            .then(async (respons) => {
+                const data = await respons.json().catch(() => ({}));
+
+                if (!respons.ok) {
+                    window.Swal.fire({ title: data.message || 'Data sementara tidak tersedia. Silakan coba lagi nanti.', icon: 'error', confirmButtonText: 'Mengerti' });
+
+                    return;
+                }
+
+                window.Swal.fire({ title: data.message || 'Skema berhasil diterbitkan.', icon: 'success', confirmButtonText: 'Mengerti' });
+                window.location.reload();
+            })
+            .catch(() => {
+                window.Swal.fire({ title: 'Data sementara tidak tersedia. Silakan coba lagi nanti.', icon: 'error', confirmButtonText: 'Mengerti' });
+            });
+    });
+
+    // -----------------------------------------------------------------------
+    // Modal pemilihan sumber nilai (US4, FR-022 … FR-025, Q20)
+    //
+    // ⚠️ Q20 — pemetaan memakai `{sumber, rujukan_sumber}` dan TIDAK memakai
+    // katalog/daftar sektor. Pilihan yang disediakan dua mode:
+    // **Manual** (isian diisi operator desa) atau **Otomatis** dari sumber data.
+    // Modal **terisi dengan nilai saat ini** sehingga admin dapat melanjutkan
+    // atau memperbaiki pemetaan yang sudah ada tanpa mengetik ulang.
+    // -----------------------------------------------------------------------
+    const SUMBER_ENUM = ['openSID', 'dataPresisi', 'impor'];
+
+    /** Terapkan pilihan sumber nilai ke satu baris isian. */
+    const tulisPemetaan = (tr, { sumber, tabel, kolom }) => {
+        const sel = tr.querySelector('.sumber-nilai');
+
+        if (!sel) {
+            return;
+        }
+
+        sel.dataset.sumber = sumber || 'manual';
+        sel.dataset.tabelSumber = tabel || '';
+        sel.dataset.kolomSumber = kolom || '';
+        // ⚠️ `rujukan` harus selalu konsisten dengan tabel.kolom karena inilah
+        // nilai yang dikirim ke API sebagai `rujukan_sumber` (§6a.4).
+        sel.dataset.rujukan = [tabel || '', kolom || ''].filter(Boolean).join('.');
+
+        const tombol = sel.querySelector('.btn-pilih-sumber-baris');
+        const badge = tombol?.querySelector('.badge') ?? sel.querySelector('.badge');
+
+        if (!badge) {
+            return;
+        }
+
+        if (sumber && sumber !== 'manual') {
+            badge.className = 'badge badge-info';
+            badge.innerHTML = '<i class="fas fa-lock mr-1"></i>' + sumber;
+        } else {
+            badge.className = 'badge badge-secondary';
+            badge.textContent = 'Manual';
+        }
+
+        // Input tabel/kolom ikut diperbarui agar `bacaDariDom()` membaca
+        // nilai yang sama dengan yang tampil.
+        const inputTabel = sel.querySelector('.input-tabel-sumber');
+        const inputKolom = sel.querySelector('.input-kolom-sumber');
+
+        if (inputTabel) {
+            inputTabel.value = tabel || '';
+        }
+
+        if (inputKolom) {
+            inputKolom.value = kolom || '';
+        }
+    };
+
+    /** Tampilkan modal pemilihan sumber nilai via SweetAlert2 (FR-008g). */
+    const bukaModalSumberNilai = async (tr) => {
+        if (!swalTersedia()) {
+            await swalGalat('Pemilih sumber nilai belum siap. Muat ulang halaman.');
+
+            return;
+        }
+
+        const label = tr.querySelector('.input-label')?.value || '(tanpa label)';
+
+        // ⚠️ Modal TERISI dengan nilai saat ini agar admin dapat melanjutkan /
+        // memperbaiki pemetaan yang sudah ada — bukan dimulai dari kosong.
+        const sel = tr.querySelector('.sumber-nilai');
+        const sumberSekarang = sel?.dataset?.sumber || 'manual';
+        const otomatisSekarang = sumberSekarang !== '' && sumberSekarang !== 'manual';
+        const tabelSekarang = sel?.dataset?.tabelSumber || '';
+        const kolomSekarang = sel?.dataset?.kolomSumber || '';
+
+        const hasil = await window.Swal.fire({
+            title: 'Sumber nilai isian',
+            html: `
+                <p class="mb-3 text-left small text-muted">Isian: <strong>${label}</strong></p>
+                <div class="form-check mb-2 text-left">
+                    <input class="form-check-input" type="radio" name="mode-sumber" id="sumber-mode-manual" value="manual" ${otomatisSekarang ? '' : 'checked'}>
+                    <label class="form-check-label" for="sumber-mode-manual">Manual — diisi operator desa</label>
+                </div>
+                <div class="form-check mb-3 text-left">
+                    <input class="form-check-input" type="radio" name="mode-sumber" id="sumber-mode-otomatis" value="otomatis" ${otomatisSekarang ? 'checked' : ''}>
+                    <label class="form-check-label" for="sumber-mode-otomatis">Otomatis — diambil dari sumber data</label>
+                </div>
+                <div id="bagian-otomatis" style="display:none">
+                    <div class="form-group text-left mb-2">
+                        <label for="sumber-pilihan">Sumber data</label>
+                        <select id="sumber-pilihan" class="form-control form-control-sm">
+                            ${SUMBER_ENUM.map((n) => `<option value="${n}" ${n === sumberSekarang ? 'selected' : ''}>${n}</option>`).join('')}
+                        </select>
+                    </div>
+                    <div class="form-group text-left mb-2">
+                        <label for="sumber-tabel">Tabel sumber</label>
+                        <input id="sumber-tabel" class="form-control form-control-sm" maxlength="100" placeholder="mis. posyandu" value="${escapeHtml(tabelSekarang)}">
+                    </div>
+                    <div class="form-group text-left">
+                        <label for="sumber-kolom">Kolom sumber</label>
+                        <input id="sumber-kolom" class="form-control form-control-sm" maxlength="100" placeholder="mis. jenis" value="${escapeHtml(kolomSekarang)}">
+                    </div>
+                </div>`,
+            showCancelButton: true,
+            confirmButtonText: 'Simpan',
+            cancelButtonText: 'Batal',
+            focusConfirm: false,
+            preConfirm: () => {
+                const otomatis = document.getElementById('sumber-mode-otomatis')?.checked;
+
+                if (!otomatis) {
+                    return { sumber: 'manual', tabel: '', kolom: '' };
+                }
+
+                const sumber = document.getElementById('sumber-pilihan')?.value || '';
+                const tabel = (document.getElementById('sumber-tabel')?.value || '').trim();
+                const kolom = (document.getElementById('sumber-kolom')?.value || '').trim();
+
+                // FR-022/Q20 — bila otomatis, `sumber`, `tabel_sumber`, dan
+                // `kolom_sumber` seluruhnya wajib terisi.
+                if (!sumber || tabel === '' || kolom === '') {
+                    window.Swal.showValidationMessage('Sumber data, tabel, dan kolom wajib diisi.');
+
+                    return false;
+                }
+
+                return { sumber, tabel, kolom };
+            },
+            didOpen: (popup) => {
+                const manual = popup.querySelector('#sumber-mode-manual');
+                const otomatis = popup.querySelector('#sumber-mode-otomatis');
+                const bagian = popup.querySelector('#bagian-otomatis');
+
+                const sinkron = () => {
+                    bagian.style.display = otomatis.checked ? 'block' : 'none';
+                };
+
+                manual.addEventListener('change', sinkron);
+                otomatis.addEventListener('change', sinkron);
+                sinkron();
+            },
+            customClass: { popup: 'rounded-lg' },
+        });
+
+        if (!hasil.isConfirmed || !hasil.value) {
+            return;
+        }
+
+        tulisPemetaan(tr, hasil.value);
+        mutasi();
+    };
+
+    tbody.addEventListener('click', (event) => {
+        const tombol = event.target.closest('.btn-pilih-sumber-baris');
+
+        if (!tombol) {
+            return;
+        }
+
+        const tr = tombol.closest('tr');
+
+        if (!tr) {
+            return;
+        }
+
+        if (!bolehUbah) {
+            swalPeringatan('Skema ini sedang dibaca. Tekan Ubah untuk menyuntingnya.');
+
+            return;
+        }
+
+        bukaModalSumberNilai(tr);
+    });
+
+    // -----------------------------------------------------------------------
+    // Dirty-guard (FR-016, R9)
+    // -----------------------------------------------------------------------
+    tbody.addEventListener('input', (event) => {
+        dirty = true;
+
+        // FR-017/Q14 — mengubah `label` langsung membangkitkan ulang `kode`,
+        // lalu memeriksa keunikannya per versi (FR-018/Q17). Harus jalan
+        // SEBELUM pratinjau supaya pratinjau memakai kode terbaru.
+        if (event.target.classList.contains('input-label')) {
+            validasiKodeLokal(tbody);
+        }
+
+        renderPratinjau(wadahPratinjau, bacaDariDom(tbody));
+        // FR-045 — mengetik di tabel ikut membuat penerbitan tidak boleh dipakai.
+        perbaruiTombolTerbit();
+    });
+
+    tbody.addEventListener('change', (event) => {
+        if (event.target.classList.contains('input-tipe')) {
+            terapkanAturanTipe(tbody);
+        }
+
+        mutasi();
+    });
+
+    window.addEventListener('beforeunload', (event) => {
+        if (!dirty) {
+            return undefined;
+        }
+
+        event.preventDefault();
+        event.returnValue = '';
+
+        return '';
+    });
+
+    document.addEventListener('click', (event) => {
+        const sektor = event.target.closest('[data-sektor-kode] a');
+        const skema = event.target.closest('[data-skema-id] a');
+
+        if (sektor || skema) {
+            pasangKonfirmasi();
+        }
+    });
+
+    // -----------------------------------------------------------------------
+    // Inisialisasi
+    // -----------------------------------------------------------------------
+    pasangSeretUrutan(tbody, mutasi);
+    perbaruiNomorUrutan(tbody);
+    terapkanAturanTipe(tbody);
+    validasiKodeLokal(tbody);
+    renderPratinjau(wadahPratinjau, bacaDariDom(tbody));
+}
+
+
+// Dimuat sebagai `<script type="module" src="...">` (bukan bundler entry),
+// jadi harus dipanggil sendiri di root modul.
+if (typeof document !== 'undefined') {
+    if (document.readyState === 'loading') {
+        document.addEventListener('DOMContentLoaded', () => mountSchemaEditor());
+    } else {
+        mountSchemaEditor();
+    }
+}
diff --git a/resources/views/components/dataspasial-status.blade.php b/resources/views/components/dataspasial-status.blade.php
new file mode 100644
index 00000000..a44508be
--- /dev/null
+++ b/resources/views/components/dataspasial-status.blade.php
@@ -0,0 +1,21 @@
+@props([
+    'result',
+])
+
+{{--
+    Merender tiga keadaan hasil pemanggilan API Satu Data (FR-005).
+
+    - `unavailable` → pesan "data sementara tidak tersedia" (FR-014)
+    - `empty`       → keadaan kosong yang jelas (FR-015)
+    - `data`        → $slot (kerangka konten menu)
+
+    Halaman selalu merespons HTTP 200 sehingga kerangka halaman, sidebar,
+    dan navigasi tetap utuh.
+--}}
+@if ($result->isUnavailable())
+    @include('dataspasial.unavailable')
+@elseif ($result->isEmpty())
+    @include('dataspasial.empty')
+@else
+    {{ $slot }}
+@endif
diff --git a/resources/views/dataspasial/dasbor/index.blade.php b/resources/views/dataspasial/dasbor/index.blade.php
new file mode 100644
index 00000000..754bdbeb
--- /dev/null
+++ b/resources/views/dataspasial/dasbor/index.blade.php
@@ -0,0 +1,53 @@
+@extends('layouts.index')
+
+@section('title', $title)
+
+@section('content_header')
+    <h1>{{ $title }}</h1>
+@stop
+
+@section('content')
+    @include('partials.breadcrumbs')
+    @include('partials.flash_message')
+
+    <x-dataspasial-status :result="$result">
+        <div class="row">
+            <div class="col-lg-12">
+                <div class="card card-outline card-primary">
+                    <div class="card-header">
+                        <h3 class="card-title">Ringkasan DataSpasial</h3>
+                    </div>
+                    <div class="card-body">
+                        <p class="text-muted mb-0">
+                            Kerangka menu. Agregat dan visualisasi penuh menjadi lingkup
+                            fitur turunan dan dibangun di atas service
+                            <code>DataSpasialApiService</code> tanpa mengubah kontraknya.
+                        </p>
+
+                        <div class="table-responsive mt-3">
+                            <table class="table table-sm table-bordered table-hover mb-0">
+                                <thead>
+                                    <tr>
+                                        <th>Sektor</th>
+                                        <th>Periode</th>
+                                        <th>Total</th>
+                                    </tr>
+                                </thead>
+                                <tbody>
+                                    @foreach ($result->data as $item)
+                                        @php $attributes = $item['attributes'] ?? $item; @endphp
+                                        <tr>
+                                            <td>{{ $attributes['sektor'] ?? $attributes['sektor_id'] ?? '-' }}</td>
+                                            <td>{{ $attributes['periode'] ?? '-' }}</td>
+                                            <td>{{ $attributes['total'] ?? '-' }}</td>
+                                        </tr>
+                                    @endforeach
+                                </tbody>
+                            </table>
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </x-dataspasial-status>
+@stop
diff --git a/resources/views/dataspasial/empty.blade.php b/resources/views/dataspasial/empty.blade.php
new file mode 100644
index 00000000..f5ea0e4f
--- /dev/null
+++ b/resources/views/dataspasial/empty.blade.php
@@ -0,0 +1,15 @@
+{{--
+    Keadaan kosong (FR-015): respons sukses tanpa data.
+
+    Sengaja BERBEDA dari `unavailable.blade.php` — ini bukan kegagalan,
+    melainkan memang belum ada data.
+--}}
+<div class="card border-0 shadow-sm" data-testid="dataspasial-empty">
+    <div class="card-body text-center py-5">
+        <i class="fas fa-inbox fa-3x text-muted mb-3"></i>
+        <h5 class="mb-1">Belum ada data</h5>
+        <p class="text-muted mb-0">
+            Sumber data dapat diakses, tetapi belum ada isian yang perlu ditampilkan.
+        </p>
+    </div>
+</div>
diff --git a/resources/views/dataspasial/impor/index.blade.php b/resources/views/dataspasial/impor/index.blade.php
new file mode 100644
index 00000000..5142d521
--- /dev/null
+++ b/resources/views/dataspasial/impor/index.blade.php
@@ -0,0 +1,54 @@
+@extends('layouts.index')
+
+@section('title', $title)
+
+@section('content_header')
+    <h1>{{ $title }}</h1>
+@stop
+
+@section('content')
+    @include('partials.breadcrumbs')
+    @include('partials.flash_message')
+
+    <x-dataspasial-status :result="$result">
+        <div class="row">
+            <div class="col-lg-12">
+                <div class="card card-outline card-primary">
+                    <div class="card-header">
+                        <h3 class="card-title">Daftar Fasilitas</h3>
+                    </div>
+                    <div class="card-body">
+                        <p class="text-muted mb-0">
+                            Kerangka menu. Alur impor lengkap (template, validasi per baris,
+                            ringkasan ditolak dan konflik) menjadi lingkup fitur turunan dan
+                            dibangun di atas service <code>DataSpasialApiService</code> tanpa
+                            mengubah kontraknya.
+                        </p>
+
+                        <div class="table-responsive mt-3">
+                            <table class="table table-sm table-bordered table-hover mb-0">
+                                <thead>
+                                    <tr>
+                                        <th>Rujukan</th>
+                                        <th>Nama</th>
+                                        <th>Sektor</th>
+                                    </tr>
+                                </thead>
+                                <tbody>
+                                    @foreach ($result->data as $item)
+                                        @php $attributes = $item['attributes'] ?? []; @endphp
+                                        <tr>
+                                            <td>{{ $attributes['rujukan_fasilitas'] ?? $item['id'] ?? '-' }}</td>
+                                            <td>{{ $attributes['nama'] ?? '-' }}</td>
+                                            <td>{{ $attributes['sektor'] ?? $attributes['sektor_id'] ?? '-' }}</td>
+                                        </tr>
+                                    @endforeach
+                                </tbody>
+                            </table>
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </x-dataspasial-status>
+@stop
diff --git a/resources/views/dataspasial/monitoring/index.blade.php b/resources/views/dataspasial/monitoring/index.blade.php
new file mode 100644
index 00000000..6393913b
--- /dev/null
+++ b/resources/views/dataspasial/monitoring/index.blade.php
@@ -0,0 +1,55 @@
+@extends('layouts.index')
+
+@section('title', $title)
+
+@section('content_header')
+    <h1>{{ $title }}</h1>
+@stop
+
+@section('content')
+    @include('partials.breadcrumbs')
+    @include('partials.flash_message')
+
+    <x-dataspasial-status :result="$result">
+        <div class="row">
+            <div class="col-lg-12">
+                <div class="card card-outline card-primary">
+                    <div class="card-header">
+                        <h3 class="card-title">Status Adopsi Skema per Desa</h3>
+                    </div>
+                    <div class="card-body">
+                        <p class="text-muted mb-0">
+                            Kerangka menu. Daftar entri audit lengkap menjadi lingkup fitur
+                            turunan dan dibangun di atas service
+                            <code>DataSpasialApiService</code> tanpa mengubah kontraknya.
+                        </p>
+
+                        <div class="table-responsive mt-3">
+                            <table class="table table-sm table-bordered table-hover mb-0">
+                                <thead>
+                                    <tr>
+                                        <th>Desa</th>
+                                        <th>Versi Skema</th>
+                                        <th>Status Adopsi</th>
+                                        <th>Perkuliahan</th>
+                                    </tr>
+                                </thead>
+                                <tbody>
+                                    @foreach ($result->data as $item)
+                                        @php $attributes = $item['attributes'] ?? []; @endphp
+                                        <tr>
+                                            <td>{{ $attributes['config']['nama_desa'] ?? $attributes['nama_desa'] ?? '-' }}</td>
+                                            <td>{{ $attributes['skema_versi_id'] ?? '-' }}</td>
+                                            <td>{{ $attributes['status_adopsi'] ?? '-' }}</td>
+                                            <td>{{ $attributes['perkuliahan'] ?? '-' }}</td>
+                                        </tr>
+                                    @endforeach
+                                </tbody>
+                            </table>
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </x-dataspasial-status>
+@stop
diff --git a/resources/views/dataspasial/peta/index.blade.php b/resources/views/dataspasial/peta/index.blade.php
new file mode 100644
index 00000000..989627e8
--- /dev/null
+++ b/resources/views/dataspasial/peta/index.blade.php
@@ -0,0 +1,39 @@
+@extends('layouts.index')
+
+@section('title', $title)
+
+@section('content_header')
+    <h1>{{ $title }}</h1>
+@stop
+
+@section('content')
+    @include('partials.breadcrumbs')
+    @include('partials.flash_message')
+
+    <x-dataspasial-status :result="$result">
+        <div class="row">
+            <div class="col-lg-12">
+                <div class="card card-outline card-primary">
+                    <div class="card-header">
+                        <h3 class="card-title">Peta Gabungan</h3>
+                    </div>
+                    <div class="card-body">
+                        <p class="text-muted mb-0">
+                            Kerangka menu. Peta geospasial penuh menjadi lingkup fitur
+                            turunan dan dibangun di atas service
+                            <code>DataSpasialApiService</code> tanpa mengubah kontraknya.
+                        </p>
+
+                        <div class="mt-3">
+                            <p class="mb-1"><strong>FeatureCollection</strong> diterima</p>
+                            <p class="mb-0">
+                                <span class="badge badge-info">{{ count($result->data) }}</span>
+                                lapisan geospasial
+                            </p>
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </x-dataspasial-status>
+@stop
diff --git a/resources/views/dataspasial/skema/index.blade.php b/resources/views/dataspasial/skema/index.blade.php
new file mode 100644
index 00000000..02c69c5d
--- /dev/null
+++ b/resources/views/dataspasial/skema/index.blade.php
@@ -0,0 +1,107 @@
+@extends('layouts.index')
+
+@section('title', $title)
+
+@section('content_header')
+    <h1>{{ $title }}</h1>
+@stop
+
+@section('content')
+    {{--
+        Editor skema kabupaten — KAB-02 (#1297).
+
+        Dua panel (FR-008, Q22):
+          kiri   : daftar sektor
+          tengah : tabel isian + pratinjau formulir desa
+
+        Tidak ada lagi daftar skema maupun nomor versi di UI — daftar isian
+        selalu berasal dari skema terakhir sektor yang dipilih.
+
+        Seluruh area dibungkus SATU `<x-dataspasial-status>` agar tiga keadaan
+        KAB-01 (data / kosong / tidak tersedia) tetap berlaku tanpa logika
+        ganda (R10, FR-005/FR-006).
+    --}}
+    @include('partials.breadcrumbs')
+    @include('partials.flash_message')
+
+    <x-dataspasial-status :result="$resultSektor">
+        @php
+            // Keadaan editor menentukan tombol mana yang aktif (FR-008a/FR-008b).
+            $bolehUbah = $statusEditor->bolehUbah();
+            $bolehSimpan = $statusEditor->bolehSimpan();
+            $statusNilai = $statusEditor->value;
+            $sektorKode = $sektorTerpilih['kode'] ?? null;
+            $sektorNama = $sektorTerpilih['nama'] ?? '';
+        @endphp
+
+        <div data-status-editor="{{ $statusNilai }}"
+             data-sektor="{{ $sektorKode }}"
+             data-sektor-nama="{{ $sektorNama }}">
+
+            {{-- Error validasi per baris isian (FR-017). --}}
+            @if ($errors->any())
+                <div class="alert alert-danger border-0 shadow-sm" role="alert" data-testid="validasi-draf">
+                    <h6 class="alert-heading">Draf belum dapat disimpan</h6>
+                    <ul class="mb-0 pl-3">
+                        @foreach ($errors->all() as $pesan)
+                            <li>{{ $pesan }}</li>
+                        @endforeach
+                    </ul>
+                </div>
+            @endif
+
+            <div class="row">
+                {{-- ============ PANEL KIRI: sektor ============ --}}
+                <div class="col-lg-3 mb-3">
+                    @include('dataspasial.skema.partials.panel-sektor', [
+                        'daftarSektor' => $daftarSektor,
+                        'sektorTerpilih' => $sektorTerpilih,
+                        'bolehUbah' => $bolehUbah,
+                    ])
+                </div>
+
+                {{-- ============ PANEL TENGAH: editor isian ============ --}}
+                <div class="col-lg-6 mb-3">
+                    @include('dataspasial.skema.partials.tabel-isian', [
+                        'isian' => $isian,
+                        'sektorTerpilih' => $sektorTerpilih,
+                        'statusEditor' => $statusEditor,
+                        'bolehUbah' => $bolehUbah,
+                        'bolehSimpan' => $bolehSimpan,
+                        'bolehTerbitkan' => $statusEditor->bolehSimpan(),
+                    ])
+                </div>
+
+                {{-- ============ PANEL KANAN: pratinjau ============ --}}
+                <div class="col-lg-3 mb-3">
+                    @include('dataspasial.skema.partials.pratinjau', [
+                        'isian' => $isian,
+                        'sektorTerpilih' => $sektorTerpilih,
+                    ])
+                </div>
+            </div>
+        </div>
+    </x-dataspasial-status>
+@stop
+
+@push('js')
+    {{--
+        Skrip editor dimuat sebagai aset statis (pola `asset()` yang sama dengan
+        `resources/views/group/menu.blade.php`), BUKAN via bundler Vite.
+
+        Alasannya: `npm run build` saat ini gagal karena `app.scss` mengimpor
+        `daterangepicker` yang tidak terpasang dan tidak terdaftar di
+        `package.json` — masalah lama yang TIDAK terkait fitur ini dan tidak
+        diselesaikan di sini (Prinsip V: jangan menambah dependensi).
+    --}}
+    {{--
+        FR-008g/Q27 — SweetAlert2 untuk seluruh pesan pada halaman editor skema.
+
+        ⚠️ Dimuat via CDN (pola yang sama dengan
+        `resources/views/penduduk/index.blade.php:95`) karena bundle Vite yang
+        sedang ter-build di `public/build/assets/app-*.js` **belum memuat**
+        `sweetalert2`, sehingga `window.Swal` belum tersedia dari bundle.
+    --}}
+    <script nonce="{{ csp_nonce() }}" src="https://cdn.jsdelivr.net/npm/sweetalert2@11"></script>
+    <script nonce="{{ csp_nonce() }}" type="module" src="{{ asset('js/dataspasial/schema-editor.js') }}"></script>
+@endpush
\ No newline at end of file
diff --git a/resources/views/dataspasial/skema/partials/form-isian.blade.php b/resources/views/dataspasial/skema/partials/form-isian.blade.php
new file mode 100644
index 00000000..c51d36e2
--- /dev/null
+++ b/resources/views/dataspasial/skema/partials/form-isian.blade.php
@@ -0,0 +1,134 @@
+{{--
+    Satu baris tabel isian = satu kolom formulir desa (FR-009).
+
+    ⚠️ Nama field di sini adalah NAMA INTERNAL (`popupPeta`, `sebagaiFilter`,
+    `sebagaiIndikator`, ). Nama field ASUMSI kontrak API
+    (`popup_peta`, `filter`, `indikator`, `pemetaan`) **dilarang** muncul di
+    view — pemetaannya hanya di `SkemaEditorService` (research.md R12).
+
+    ⚠️ Kolom satuan hanya relevan bila tipe `angka` (FR-010,
+    `TipeIsian::memakaiSatuan()`).
+--}}
+@php
+    $tipe = \App\Enums\TipeIsian::hasValue($baris['tipe'])
+        ? \App\Enums\TipeIsian::fromValue($baris['tipe'])
+        : \App\Enums\TipeIsian::Teks();
+    $memakaiSatuan = $tipe->memakaiSatuan();
+    // ⚠️ VERIFIKASI LANGSUNG: `sumber` berisi ENUM API (`openSID`/`dataPresisi`/
+    // `impor`), BUKAN kode sektor dan bukan literal 'pemetaan' (kontrak §6a.5).
+    $sumber = $baris['sumber'] ?? 'manual';
+    $terpetakan = $sumber !== null && $sumber !== '' && $sumber !== 'manual';
+@endphp
+
+<tr data-testid="baris-isian"
+    data-index="{{ $index }}"
+    data-opsi="{{ Illuminate\Support\Js::from($baris['opsi'] ?? []) }}"
+    draggable="{{ $bolehUbah ? 'true' : 'false' }}">
+
+    {{-- Handle seret (FR-012). --}}
+    <td class="text-center handle-seret align-middle" title="Seret untuk mengurutkan">
+        @if ($bolehUbah)
+            <i class="fas fa-grip-vertical text-muted"></i>
+        @endif
+    </td>
+
+    <td class="text-center align-middle urutan text-muted">{{ $baris['urutan'] }}</td>
+
+    <td>
+        <input type="text" class="form-control form-control-sm input-label" maxlength="255"
+               value="{{ $baris['label'] }}" placeholder="Jumlah Siswa"
+               @disabled(!$bolehUbah)>
+        @error("isian.{$index}.label")
+            <div class="text-danger small">{{ $message }}</div>
+        @enderror
+    </td>
+
+    <td>
+        <select class="form-control form-control-sm input-tipe" @disabled(!$bolehUbah)>
+            @foreach (\App\Enums\TipeIsian::getValues() as $nilai)
+                <option value="{{ $nilai }}" @selected($nilai === $baris['tipe'])>
+                    {{ $nilai }}
+                </option>
+            @endforeach
+        </select>
+        @error("isian.{$index}.tipe")
+            <div class="text-danger small">{{ $message }}</div>
+        @enderror
+    </td>
+
+    <td class="text-center">
+        <input type="checkbox" class="input-wajib" @checked($baris['wajib']) @disabled(!$bolehUbah)>
+    </td>
+
+    <td>
+        <input type="text" class="form-control form-control-sm input-satuan" maxlength="50"
+               value="{{ $baris['satuan'] ?? '' }}" placeholder="{{ $memakaiSatuan ? 'orang' : '—' }}"
+               @disabled(!$bolehUbah || ! $memakaiSatuan)>
+    </td>
+
+    {{--
+        ⚠️ Kolom **Pilihan (opsi) tidak lagi ditampilkan** — tidak dipakai pada
+        editor ini. Nilai `opsi` yang tersimpan di API tetap **dipertahankan**
+        melalui atribut `data-opsi` pada baris sehingga `bacaDariDom()`
+        mengirimkannya kembali saat Simpan draf dan tidak terjadi kehilangan data.
+    --}}
+
+    {{--
+        Sumber nilai: manual atau pemetaan (FR-023).
+        Memakai `data-*` sehingga JS bisa menulis/membaca status pemetaan
+        tanpa perlu mem-parsing teks badge.
+    --}}
+    <td class="sumber-nilai align-middle"
+        data-sumber="{{ $sumber }}"
+        data-tabel-sumber="{{ $baris['tabelSumber'] ?? '' }}"
+        data-kolom-sumber="{{ $baris['kolomSumber'] ?? '' }}"
+        data-rujukan="{{ $baris['rujukan'] ?? '' }}">
+        @if ($bolehUbah)
+            <button type="button" class="btn btn-outline-secondary btn-sm btn-pilih-sumber-baris px-1 py-0"
+                    title="Pilih sumber nilai">
+                @if ($terpetakan)
+                    <span class="badge badge-info" data-testid="badge-terpetakan">
+                        <i class="fas fa-lock mr-1"></i>{{ $sumber }}
+                    </span>
+                    <input type="text" class="input-tabel-sumber form-control form-control-sm mt-1"
+                           value="{{ $baris['tabelSumber'] ?? '' }}" placeholder="tabel sumber"
+                           title="Tabel sumber data">
+                    <input type="text" class="input-kolom-sumber form-control form-control-sm mt-1"
+                           value="{{ $baris['kolomSumber'] ?? '' }}" placeholder="kolom sumber"
+                           title="Kolom sumber data">
+                @else
+                    <span class="badge badge-secondary" data-testid="badge-manual">Manual</span>
+                @endif
+            </button>
+        @else
+            @if ($terpetakan)
+                <span class="badge badge-info">{{ $sumber }}</span>
+                <span class="text-muted small d-block">{{ $baris['tabelSumber'] ?? '' }}.{{ $baris['kolomSumber'] ?? '' }}</span>
+            @else
+                <span class="badge badge-secondary" data-testid="badge-manual">Manual</span>
+            @endif
+        @endif
+    </td>
+
+    <td class="text-center">
+        <input type="checkbox" class="input-popup-peta" @checked($baris['popupPeta']) @disabled(!$bolehUbah)>
+    </td>
+
+    <td class="text-center">
+        <input type="checkbox" class="input-filter" @checked($baris['sebagaiFilter']) @disabled(!$bolehUbah)>
+    </td>
+
+    <td class="text-center">
+        <input type="checkbox" class="input-indikator" @checked($baris['sebagaiIndikator']) @disabled(!$bolehUbah)>
+    </td>
+
+    <td class="text-center">
+        @if ($bolehUbah)
+            <button type="button" class="btn btn-outline-danger btn-sm btn-hapus-isian"
+                    title="Hapus isian" data-testid="btn-hapus-isian"
+                    data-kode="{{ $baris['kode'] }}" data-terpetakan="{{ $terpetakan ? '1' : '0' }}">
+                <i class="fas fa-trash-alt"></i>
+            </button>
+        @endif
+    </td>
+</tr>
\ No newline at end of file
diff --git a/resources/views/dataspasial/skema/partials/panel-sektor.blade.php b/resources/views/dataspasial/skema/partials/panel-sektor.blade.php
new file mode 100644
index 00000000..f1ad1add
--- /dev/null
+++ b/resources/views/dataspasial/skema/partials/panel-sektor.blade.php
@@ -0,0 +1,90 @@
+{{--
+    Panel kiri: daftar sektor (FR-007) + tombol tambah sektor (FR-007c).
+
+    Kode sektor ditampilkan sebagai BACA-SAJA (FR-007d-3) karena kode dibangkitkan
+    oleh API dan dijamin unik global (research.md R4) — admin tidak mengeditnya.
+--}}
+<div class="card card-outline card-primary mb-3">
+    <div class="card-header py-2 px-3">
+        <h3 class="card-title text-sm mb-0"><i class="fas fa-layer-group mr-1"></i>Sektor</h3>
+    </div>
+
+    <div class="card-body p-0">
+        @if (count($daftarSektor) === 0)
+            <p class="text-muted text-center my-3 px-2 mb-0">
+                Belum ada sektor. Tambahkan sektor pertama untuk mulai menyusun skema.
+            </p>
+        @else
+            <ul class="list-group list-group-flush" data-testid="daftar-sektor">
+                @foreach ($daftarSektor as $sektor)
+                    @php $terpilih = $sektorTerpilih !== null && $sektorTerpilih['id'] === $sektor['id']; @endphp
+                    <li class="list-group-item list-group-item-action py-2 px-3 d-flex align-items-start {{ $terpilih ? 'active' : '' }}"
+                        data-testid="item-sektor"
+                        data-sektor-id="{{ $sektor['id'] }}"
+                        data-sektor-kode="{{ $sektor['kode'] }}"
+                        data-sektor-nama="{{ $sektor['nama'] }}"
+                        data-sektor-ikon="{{ $sektor['ikon'] ?? '' }}"
+                        data-ada-draf="{{ $sektor['adaDraf'] ? '1' : '0' }}">
+                        <a href="{{ route('dataspasial.skema', array_filter(['sektor' => $sektor['kode']])) }}"
+                           class="flex-grow-1 {{ $terpilih ? 'text-white' : 'text-dark' }}">
+                            <div class="d-flex justify-content-between align-items-start">
+                                <div>
+                                    <div class="font-weight-bold">{{ $sektor['nama'] }}</div>
+                                    <small class="{{ $terpilih ? 'text-white-50' : 'text-muted' }}">
+                                        Kode sektor: <code>{{ $sektor['kode'] }}</code>
+                                    </small>
+                                </div>
+                                <span class="badge badge-light text-uppercase ml-1">
+                                    {{ $sektor['status'] }}
+                                </span>
+                            </div>
+
+                            {{--
+                                FR-007 — label **versi terakhir + statusnya**.
+                                ⚠️ Jumlah versi tidak lagi ditampilkan; yang
+                                Useful bagi admin adalah versi berapa yang berlaku
+                                dan apakah masih berupa draf.
+                            --}}
+                            <div class="mt-1">
+                                @php
+                                    $statusTerakhir = $sektor['statusTerakhir'] ?? 'kosong';
+                                    $nomorVersiTerakhir = (int) ($sektor['nomorVersiTerakhir'] ?? 0);
+                                @endphp
+
+                                @if ($statusTerakhir === 'draf')
+                                    <span class="badge badge-warning"
+                                          data-testid="label-status-versi-sektor">Draf</span>
+                                @elseif ($statusTerakhir === 'terbit')
+                                    <span class="badge badge-success"
+                                          data-testid="label-status-versi-sektor">Terbit</span>
+                                @else
+                                    <span class="badge badge-secondary"
+                                          data-testid="label-status-versi-sektor">Belum ada skema</span>
+                                @endif
+
+                                @if ($nomorVersiTerakhir > 0)
+                                    <small class="ml-1 badge badge-info {{ $terpilih ? 'text-white-50' : 'text-muted' }}"
+                                           data-testid="label-nomor-versi-sektor">
+                                        v{{ $nomorVersiTerakhir }}
+                                    </small>
+                                @endif
+                            </div>
+                        </a>
+
+                        {{-- US7 (FR-007d-4): ubah nama & ikon sektor sekarang dilakukan
+                        melalui editor skema (nama sektor dikirim sebagai sektor_nama
+                        pada setiap simpan), bukan tombol tersendiri di sini. --}}
+                    </li>
+                @endforeach
+            </ul>
+        @endif
+    </div>
+
+    {{-- Tombol tambah sektor: selalu terlihat (FR-007c). --}}
+    <div class="card-footer p-2">
+        <button type="button" class="btn btn-outline-primary btn-block btn-sm"
+                id="btn-tambah-sektor" data-testid="btn-tambah-sektor">
+            <i class="fas fa-plus mr-1"></i>Tambah Sektor Baru
+        </button>
+    </div>
+</div>
diff --git a/resources/views/dataspasial/skema/partials/pratinjau.blade.php b/resources/views/dataspasial/skema/partials/pratinjau.blade.php
new file mode 100644
index 00000000..191da64b
--- /dev/null
+++ b/resources/views/dataspasial/skema/partials/pratinjau.blade.php
@@ -0,0 +1,45 @@
+{{--
+    Panel kanan: pratinjau formulir desa (FR-034).
+
+    Pratinjau dibangun dari STATE KLIEN yang sama dengan form editor
+    (`renderPratinjau(stateIsian)` di `schema-editor.js`) agar perubahan yang
+    BELUM disimpan tetap terlihat (FR-035, research.md R7).
+
+    Isian terpetakan tampil terkunci dengan keterangan sumbernya (FR-015).
+--}}
+<div class="card card-outline card-warning">
+    <div class="card-header py-2 px-3">
+        <h3 class="card-title text-sm mb-0">
+            <i class="fas fa-eye mr-1"></i>Pratinjau Formulir Desa
+        </h3>
+    </div>
+
+    <div class="card-body p-3">
+        @if ($sektorTerpilih === null)
+            <p class="text-muted text-center mb-0" data-testid="pratinjau-kosong">
+                Pratinjau formulir akan muncul setelah sektor dipilih.
+            </p>
+        @else
+            <div class="mb-2">
+                <small class="text-muted">Sektor</small>
+                <div class="font-weight-bold">{{ $sektorTerpilih['nama'] }}</div>
+                <small class="text-muted">
+                    Isian selalu dimuat dari skema terakhir sektor ini
+                    (draf bila ada, terbit baca-saja bila tidak).
+                </small>
+            </div>
+
+            <hr class="my-2">
+
+            {{-- Dikosongkan oleh JS lalu diisi `renderPratinjau()`. --}}
+            <div id="wadah-pratinjau" data-testid="wadah-pratinjau"></div>
+
+            <noscript>
+                <div class="alert alert-secondary border-0 py-2 px-2 mb-0 small">
+                    Pratinjau live memerlukan JavaScript. Tabel isian di samping tetap
+                    dapat digunakan.
+                </div>
+            </noscript>
+        @endif
+    </div>
+</div>
\ No newline at end of file
diff --git a/resources/views/dataspasial/skema/partials/tabel-isian.blade.php b/resources/views/dataspasial/skema/partials/tabel-isian.blade.php
new file mode 100644
index 00000000..b4e3c887
--- /dev/null
+++ b/resources/views/dataspasial/skema/partials/tabel-isian.blade.php
@@ -0,0 +1,237 @@
+{{--
+    Panel tengah: tabel isian (FR-013).
+
+    ⚠️ Kolom **Kode tidak lagi ditampilkan** (FR-017/Q14). `kode` adalah nilai
+    turunan dari `label` yang dibuat otomatis oleh aplikasi, sehingga tidak ada
+    kolom yang perlu diisi admin.
+
+    Kolom memuat: label, tipe, wajib, satuan, sumber nilai (manual atau
+    otomatis), popup peta, filter, dan indikator.
+
+    ⚠️ Kolom **Pilihan (opsi)** tidak lagi ditampilkan karena tidak dipakai
+    pada editor ini; nilai opsi yang sudah tersimpan di API tetap dikirim ulang
+    lewat atribut `data-opsi` agar tidak hilang.
+
+    Kolom popup/filter/indikator & sumber nilai diisi penuh pada US4/US5;
+    kolomnya sudah disiapkan sejak US1 agar tata letak tidak berubah
+    saat story berikutnya tiba (FR-008).
+--}}
+<div class="card card-outline card-success">
+    <div class="card-header py-2 px-3">
+        <h3 class="card-title text-sm mb-0">
+            <i class="fas fa-table mr-1"></i>Isian
+            @if ($sektorTerpilih)
+                <span class="text-muted font-weight-normal">· {{ $sektorTerpilih['kode'] }}</span>
+            @endif
+        </h3>
+
+        {{--
+            US7/Q19 — nama sektor disunting dari editor, dikirim sebagai
+            `sektor_nama` pada setiap Simpan draf (FR-007d-4/FR-007d-9).
+            Kode sektor tetap baca-saja (FR-007d-5).
+
+            ⚠️ **Selalu dirender**, termasuk ketika belum ada sektor yang dipilih.
+            Bila input ini hanya dirender bila `$sektorTerpilih`, maka mode
+            "sektor baru" (FR-008f/Q26) tidak punya kolom untuk diisi — admin
+            menekan "Tambah Sektor Baru" tetapi tidak ada apa pun yang muncul.
+            Saat belum ada sektor terpilih, blok ini disembunyikan dan dibuka
+            kembali oleh JS ketika mode "sektor baru" diaktifkan.
+        --}}
+        <div class="form-group mb-0 mt-2 {{ $sektorTerpilih ? '' : 'd-none' }}"
+             id="wadah-input-sektor-nama" data-testid="wadah-input-sektor-nama">
+            <label class="mb-1" for="input-sektor-nama-editor">
+                Nama sektor <span class="text-danger">*</span>
+            </label>
+            <input type="text"
+                   class="form-control form-control-sm {{ $errors->has('sektor_nama') ? 'is-invalid' : '' }}"
+                   id="input-sektor-nama-editor" data-testid="input-sektor-nama-editor"
+                   name="sektor_nama" maxlength="100" autocomplete="off"
+                   value="{{ old('sektor_nama', $sektorTerpilih['nama'] ?? '') }}"
+                   @disabled(! $bolehUbah)>
+            @error('sektor_nama')
+                <div class="invalid-feedback d-block">{{ $message }}</div>
+            @enderror
+        </div>
+
+        <div class="d-flex align-items-center mt-2">
+            {{-- Simpan draf: aktif hanya bila skema berstatus draf (FR-008b). --}}
+            <button type="button" class="btn btn-success btn-sm mr-1"
+                    id="btn-simpan-draf" data-testid="btn-simpan-draf"
+                    {{ $bolehSimpan ? '' : 'disabled' }}>
+                <i class="fas fa-save mr-1"></i>Simpan draf
+            </button>
+
+{{--
+                Terbitkan (US8, FR-041): aktif bila skema berstatus `draf`.
+                Frontend MENONAKAN tombol saat ada perubahan yang belum disimpan
+                (FR-045) — penerbitan menghasilkan versi immutable.
+            --}}
+            <button type="button" class="btn btn-primary btn-sm"
+                    id="btn-terbitan" data-testid="btn-terbitan"
+                    {{ $bolehTerbitkan ? '' : 'disabled' }}>
+                <i class="fas fa-paper-plane mr-1"></i>Terbitkan
+            </button>
+
+            {{--
+                FR-008c (Q24) — tombol "Ubah": HANYA dirender saat skema berstatus
+                `terbit`. Aksi klien semata (nol request ke sumber data): membuka
+                kunci penyuntingan isian dan mengaktifkan Simpan draf. Setelah
+                diklik, tombol ini disembunyikan oleh JS.
+            --}}
+            @if ($statusEditor->value === 'terbit')
+                <button type="button" class="btn btn-warning btn-sm ml-auto"
+                        id="btn-ubah" data-testid="btn-ubah">
+                    <i class="fas fa-pen mr-1"></i>Ubah
+                </button>
+            @endif
+
+            {{--
+                FR-008e (Q25) — tombol "Batal": hanya tampil pada keadaan
+                "menyunting draf hasil Ubah"; mengembalikan editor ke baca-saja
+                `terbit` tanpa permintaan ke sumber data.
+            --}}
+            <button type="button" class="btn btn-secondary btn-sm ml-auto d-none"
+                    id="btn-batal-ubah" data-testid="btn-batal-ubah">
+                <i class="fas fa-times mr-1"></i>Batal
+            </button>
+        </div>
+    </div>
+
+    @if ($statusEditor->value === 'terbit')
+        {{-- Skema terbit hanya baca-saja (FR-008a). --}}
+        <div class="alert alert-info border-0 rounded-0 mb-0 py-2 px-3" role="alert">
+            <i class="fas fa-lock mr-1"></i>
+            Skema versi terbit hanya dapat dibaca. Buat draf baru untuk mengubah isiannya.
+        </div>
+    @endif
+
+    <div class="card-body p-0">
+        @if ($sektorTerpilih === null)
+            <p class="text-muted text-center my-4 px-2 mb-0" data-testid="isian-belum-pilih-sektor">
+                Pilih salah satu sektor untuk menyusun isiannya.
+            </p>
+        @elseif (count($isian) === 0)
+            <p class="text-muted text-center my-4 px-2 mb-0" data-testid="isian-kosong">
+                Belum ada isian pada skema ini. Tekan <strong>Tambah Isian Baru</strong> untuk
+                menambahkan kolom formulir pertama.
+            </p>
+        @endif
+
+        <div class="table-responsive">
+            <table class="table table-sm table-bordered mb-0" id="tabel-isian" data-testid="tabel-isian">
+                <thead class="thead-light">
+                    <tr>
+                        <th style="width:2.5rem" title="Seret untuk mengurutkan">&nbsp;</th>
+                        <th style="width:2.5rem">#</th>
+                        <th>Label</th>
+                        <th style="width:8rem">Tipe</th>
+                        <th style="width:4rem" class="text-center">Wajib</th>
+                        <th style="width:6rem">Satuan</th>
+                        <th style="width:11rem">Sumber nilai</th>
+                        <th style="width:4rem" class="text-center" title="Tampil di popup peta">Peta</th>
+                        <th style="width:4rem" class="text-center" title="Tersedia sebagai filter">Filter</th>
+                        <th style="width:4rem" class="text-center" title="Dipakai sebagai indikator dasbor">Indikator</th>
+                        <th style="width:3rem">&nbsp;</th>
+                    </tr>
+                </thead>
+                <tbody id="isi-tabel-isian" data-testid="isi-tabel-isian"
+                       data-boleh-ubah="{{ $bolehUbah ? '1' : '0' }}">
+                    @foreach ($isian as $index => $baris)
+                        @include('dataspasial.skema.partials.form-isian', [
+                            'index' => $index,
+                            'baris' => $baris,
+                            'bolehUbah' => $bolehUbah,
+                            'daftarSektorSumber' => $daftarSektorSumber ?? [],
+                        ])
+                    @endforeach
+                </tbody>
+            </table>
+        </div>
+    </div>
+
+    {{--
+        Template baris kosong untuk "Tambah Isian Baru" (US1#13).
+
+        ⚠️ **Selalu dirender**, termasuk saat skema `terbit`. Alasannya: tombol
+        "Tambah Isian Baru" dapat diaktifkan kemudian melalui mode penyuntingan
+        (tombol **Ubah** — FR-008c/Q24, atau **Tambah Sektor Baru** —
+        FR-008f/Q26). Bila template hanya dirender saat `$bolehUbah`, elemennya
+        tidak ada di DOM dan handler klik akan bail-out tanpa efek sehingga
+        tombol tampak tidak berfungsi.
+
+        Keadaan read-only dijaga di sisi klien: saat skema `terbit` tombol simpan
+        **nonaktif** sehingga baris baru tidak pernah dibuat, dan bila baris
+        sudah ada kontrolnya dikunci oleh `kunciKontrolIsian()` (FR-008a).
+    --}}
+    <template id="template-baris-isian">
+        {{-- `data-opsi` diisi `[]` agar `bacaDariDom()` tetap mengirim array
+             kosong untuk baris baru (kolom Pilihan tidak lagi ditampilkan). --}}
+        <tr class="baris-baru" draggable="false" data-opsi="[]">
+            <td class="text-center handle-seret align-middle" title="Seret untuk mengurutkan">
+                <i class="fas fa-grip-vertical text-muted"></i>
+            </td>
+            <td class="text-center align-middle urutan text-muted"></td>
+            {{-- ⚠️ Tidak ada kolom kode: dibangkitkan otomatis dari label (Q14). --}}
+            <td><input type="text" class="form-control form-control-sm input-label" maxlength="255" placeholder="Jumlah Siswa"></td>
+            <td>
+                <select class="form-control form-control-sm input-tipe">
+                    @foreach (\App\Enums\TipeIsian::getValues() as $tipe)
+                        <option value="{{ $tipe }}">{{ $tipe }}</option>
+                    @endforeach
+                </select>
+            </td>
+            <td class="text-center"><input type="checkbox" class="input-wajib"></td>
+            <td><input type="text" class="form-control form-control-sm input-satuan" maxlength="50" placeholder="orang"></td>
+            {{-- ⚠️ Atribut `data-*` wajib ada agar `bacaDariDom()` membaca
+                 sumber nilai baris baru (Q20: sumber/tabel_sumber/kolom_sumber). --}}
+            <td class="sumber-nilai" data-sumber="manual"
+                data-tabel-sumber="" data-kolom-sumber="" data-rujukan="">
+                <button type="button" class="btn btn-outline-secondary btn-sm btn-pilih-sumber-baris"
+                        title="Pilih sumber nilai">
+                    <span class="badge badge-secondary">Manual</span>
+                </button>
+            </td>
+            <td class="text-center"><input type="checkbox" class="input-popup-peta"></td>
+            <td class="text-center"><input type="checkbox" class="input-filter"></td>
+            <td class="text-center"><input type="checkbox" class="input-indikator"></td>
+            <td class="text-center">
+                <button type="button" class="btn btn-outline-danger btn-sm btn-hapus-isian" title="Hapus isian">
+                    <i class="fas fa-trash-alt"></i>
+                </button>
+            </td>
+        </tr>
+    </template>
+
+    {{-- Tombol tambah isian: selalu terlihat (FR-007c). --}}
+    <div class="card-footer p-2">
+        <button type="button" class="btn btn-outline-success btn-block btn-sm"
+                id="btn-tambah-isian" data-testid="btn-tambah-isian"
+                {{ $bolehUbah ? '' : 'disabled' }}>
+            <i class="fas fa-plus mr-1"></i>Tambah Isian Baru
+        </button>
+    </div>
+</div>
+
+{{-- Form submit draf. Isian diserialisasi oleh JS dari state yang sama. --}}
+<form id="form-draf" method="POST" action="{{ route('dataspasial.skema.draf.store') }}"
+      class="d-none" data-testid="form-draf">
+    @csrf
+    <input type="hidden" name="sektor" value="{{ $sektorTerpilih['kode'] ?? '' }}">
+    <input type="hidden" name="nomor_versi" value="{{ $skemaTerpilih['nomorVersi'] ?? '' }}">
+    <input type="hidden" name="catatan_perubahan" value="">
+    <div id="wadah-input-isian"></div>
+</form>
+
+{{--
+    Form submit terbitan (US8, FR-041).
+
+    ⚠️ `sektor` yang dikirim adalah **KODE** sektor karena `{sektor}` pada
+    path `POST /dataspasial/skema/{sektor}/terbit` adalah kode sektor.
+--}}
+<form id="form-terbit" method="POST" action="{{ route('dataspasial.skema.terbit') }}"
+      class="d-none" data-testid="form-terbit">
+    @csrf
+    <input type="hidden" name="sektor" value="{{ $sektorTerpilih['kode'] ?? '' }}">
+    <input type="hidden" name="skema" value="{{ $skemaTerpilih['id'] ?? '' }}">
+    <input type="hidden" name="catatan_perubahan" value="">
+</form>
\ No newline at end of file
diff --git a/resources/views/dataspasial/unavailable.blade.php b/resources/views/dataspasial/unavailable.blade.php
new file mode 100644
index 00000000..85f410d2
--- /dev/null
+++ b/resources/views/dataspasial/unavailable.blade.php
@@ -0,0 +1,20 @@
+{{--
+    Pesan "data sementara tidak tersedia" (FR-014).
+
+    WAJIB generik: tanpa detail teknis, nama endpoint, kode status HTTP,
+    atau jejak_exception. Detail tersebut hanya untuk log backend.
+--}}
+<div class="alert alert-warning border-0 shadow-sm" role="alert" data-testid="dataspasial-unavailable">
+    <div class="d-flex align-items-start">
+        <div class="mr-3">
+            <i class="fas fa-exclamation-triangle fa-2x text-warning"></i>
+        </div>
+        <div>
+            <h5 class="alert-heading">Data sementara tidak tersedia</h5>
+            <p class="mb-0">
+                Sumber data sedang tidak dapat diakses. Silakan coba lagi nanti.
+                Halaman ini tetap dapat digunakan untuk menu lain.
+            </p>
+        </div>
+    </div>
+</div>
diff --git a/routes/web.php b/routes/web.php
index a0adc458..08cb06a1 100644
--- a/routes/web.php
+++ b/routes/web.php
@@ -26,6 +26,11 @@
 use App\Http\Controllers\DataPresisiPendidikanController;
 use App\Http\Controllers\DataPresisiSandangController;
 use App\Http\Controllers\DataPresisiSeniBudayaController;
+use App\Http\Controllers\DataSpasial\DasborDataSpasialController;
+use App\Http\Controllers\DataSpasial\ImporDataController;
+use App\Http\Controllers\DataSpasial\MonitoringController;
+use App\Http\Controllers\DataSpasial\PetaGabunganController;
+use App\Http\Controllers\DataSpasial\SkemaDataSpasialController;
 use App\Http\Controllers\DDKPanganController;
 use App\Http\Controllers\DepartmentController;
 use App\Http\Controllers\DesaController;
@@ -467,6 +472,42 @@
         Route::post('post', [ApiProxyController::class, 'post'])->name('api-proxy.post');
         Route::get('clear-cache', [ApiProxyController::class, 'clearCache'])->name('api-proxy.clear-cache');
     });
+
+    // DataSpasial — seluruh data `ds_*` dibaca/tulis lewat API Satu Data
+    // melalui App\Services\DataSpasialApiService (FR-002). Kontrol akses
+    // ditegakkan server-side lewat middleware permission, bukan sekadar
+    // menyembunyikan menu (FR-013).
+    Route::prefix('dataspasial')->group(function () {
+        Route::get('skema', [SkemaDataSpasialController::class, 'index'])
+            ->middleware('permission:dataspasial-skema-read')
+            ->name('dataspasial.skema');
+
+        // KAB-02 — endpoint tulis editor skema (satu permintaan untuk sektor + isian,
+        // Q18/Q19). Otorisasi ditegakkan server-side lewat middleware permission (FR-001).
+        Route::post('skema/draf', [SkemaDataSpasialController::class, 'storeDraf'])
+            ->middleware('permission:dataspasial-skema-write')
+            ->name('dataspasial.skema.draf.store');
+
+        Route::post('skema/terbit', [SkemaDataSpasialController::class, 'terbit'])
+            ->middleware('permission:dataspasial-skema-write')
+            ->name('dataspasial.skema.terbit');
+
+        Route::get('peta', [PetaGabunganController::class, 'index'])
+            ->middleware('permission:dataspasial-peta-read')
+            ->name('dataspasial.peta');
+
+        Route::get('dasbor', [DasborDataSpasialController::class, 'index'])
+            ->middleware('permission:dataspasial-dasbor-read')
+            ->name('dataspasial.dasbor');
+
+        Route::get('impor', [ImporDataController::class, 'index'])
+            ->middleware('permission:dataspasial-impor-read')
+            ->name('dataspasial.impor');
+
+        Route::get('monitoring', [MonitoringController::class, 'index'])
+            ->middleware('permission:dataspasial-monitoring-read')
+            ->name('dataspasial.monitoring');
+    });
 });
 
 // 2FA Challenge Routes (tanpa middleware 2fa untuk menghindari loop)
diff --git a/tests/Browser/SmokeDataSpasialMenuTest.php b/tests/Browser/SmokeDataSpasialMenuTest.php
new file mode 100644
index 00000000..8b041298
--- /dev/null
+++ b/tests/Browser/SmokeDataSpasialMenuTest.php
@@ -0,0 +1,94 @@
+<?php
+
+declare(strict_types=1);
+
+use Tests\Browser\ScreenshotHelper;
+use Tests\Browser\SessionState;
+
+/**
+ * Smoke test menu DataSpasial (FR-008/FR-009/FR-014).
+ *
+ * Catatan: pemanggilan API Satu Data terjadi di sisi server (PHP), sehingga
+ * TIDAK dapat di-intercept oleh MSW. Tanpa API yang hidup, halaman akan
+ * merender partial "Data sementara tidak tersedia" — dan itu justru yang
+ * diverifikasi test ini: degradasi anggun tetap menghasilkan halaman utuh
+ * dengan sidebar, bukan halaman error.
+ */
+beforeEach(function () {
+    $this->user = SessionState::loginAdminUser();
+});
+
+afterEach(function () {
+    SessionState::clear();
+});
+
+/**
+ * @return array<string, string>
+ */
+function dataspasialMenuLinks(): array
+{
+    return [
+        'Skema DataSpasial' => '/dataspasial/skema',
+        'Peta Gabungan' => '/dataspasial/peta',
+        'Dasbor DataSpasial' => '/dataspasial/dasbor',
+        'Impor Data' => '/dataspasial/impor',
+        'Monitoring' => '/dataspasial/monitoring',
+    ];
+}
+
+it('menampilkan grup menu DataSpasial beserta lima submenu', function () {
+    $page = SessionState::loginAndNavigate($this->user, '/dasbor')
+        ->assertPathIs('/dasbor');
+
+    $page->assertSee('DataSpasial');
+
+    // Submenu AdminLte dirender tersembunyi sampai grup diklik; karena itu
+    // keberadaan link diperiksa pada DOM, bukan visibilitasnya.
+    foreach (dataspasialMenuLinks() as $label => $path) {
+        $page->assertScript(
+            'Array.from(document.querySelectorAll(".nav-sidebar a"))
+                .some(a => a.textContent.trim() === '.json_encode($label).'
+                    && a.getAttribute("href").includes('.json_encode($path).'))',
+            true
+        );
+    }
+
+    ScreenshotHelper::saveIfEnabled($page, 'dataspasial-menu');
+});
+
+it('membuka setiap halaman DataSpasial tanpa halaman error', function (string $path, string $title) {
+    $page = SessionState::loginAndNavigate($this->user, $path);
+
+    $page->assertPathIs($path)
+        ->assertSee($title);
+
+    ScreenshotHelper::saveIfEnabled($page, 'dataspasial'.str_replace('/', '-', $path));
+})->with([
+    ['/dataspasial/skema', 'Skema DataSpasial'],
+    ['/dataspasial/peta', 'Peta Gabungan'],
+    ['/dataspasial/dasbor', 'Dasbor DataSpasial'],
+    ['/dataspasial/impor', 'Impor Data'],
+    ['/dataspasial/monitoring', 'Monitoring'],
+]);
+
+it('menampilkan pesan data sementara tidak tersedia alih-alih halaman error', function () {
+    $page = SessionState::loginAndNavigate($this->user, '/dataspasial/peta');
+
+    // API tidak hidup pada lingkungan uji → harus jatuh ke kondisi unavailable.
+    $page->assertSee('Data sementara tidak tersedia')
+        ->assertDontSee('Whoops')
+        ->assertDontSee('Stack trace');
+
+    ScreenshotHelper::saveIfEnabled($page, 'dataspasial-unavailable');
+});
+
+it('mempertahankan kerangka halaman dan navigasi saat data tidak tersedia', function () {
+    $page = SessionState::loginAndNavigate($this->user, '/dataspasial/monitoring');
+
+    // Layout admin tetap utuh: navigasi dan judul halaman masih terlihat.
+    $page->assertSee('Monitoring')
+        ->assertSee('DataSpasial')
+        ->assertSee('Peta Gabungan');
+
+    ScreenshotHelper::saveIfEnabled($page, 'dataspasial-unavailable-frame');
+});
diff --git a/tests/Browser/SmokeSkemaEditorTest.php b/tests/Browser/SmokeSkemaEditorTest.php
new file mode 100644
index 00000000..088d369d
--- /dev/null
+++ b/tests/Browser/SmokeSkemaEditorTest.php
@@ -0,0 +1,297 @@
+<?php
+
+declare(strict_types=1);
+
+use Tests\Browser\ScreenshotHelper;
+use Tests\Browser\SessionState;
+
+/**
+ * Smoke test editor skema kabupaten — KAB-02 (#1297).
+ *
+ * Catatan penting: pemanggilan API Satu Data terjadi di sisi **server** (PHP),
+ * sehingga TIDAK dapat di-intercept oleh MSW. Tanpa API yang hidup, halaman
+ * merender partial "Data sementara tidak tersedia" — dan itu justru yang
+ * diverifikasi di sini: **degradasi anggun** menghasilkan halaman utuh dengan
+ * sidebar, bukan halaman error (FR-005).
+ *
+ * Yang diverifikasi di lingkungan tanpa API hidup:
+ *  - halaman `/dataspasial/skema` terbuka (bukan 403/500);
+ *  - tombol Terbitan tampil dalam keadaan nonaktif (FR-040/Q1);
+ *  - tidak ada satu pun halaman error atau stack trace.
+ *
+ * Skenario-interactive (daftar sektor, daftar skema setelah dipilih, tambah
+ * isian) memerlukan API hidup dan dipakai sebagai smoke MANUAL — lihat
+ * `quickstart.md` §2.
+ */
+beforeEach(function () {
+    $this->user = SessionState::loginAdminUser();
+});
+
+afterEach(function () {
+    SessionState::clear();
+});
+
+it('membuka halaman editor skema tanpa error', function () {
+    $page = SessionState::loginAndNavigate($this->user, '/dataspasial/skema')
+        ->assertPathIs('/dataspasial/skema')
+        ->assertSee('Skema DataSpasial');
+
+    ScreenshotHelper::saveIfEnabled($page, 'skema-editor-halaman');
+});
+
+it('menampilkan konten editor atau pesan data sementara tidak tersedia', function () {
+    $page = SessionState::loginAndNavigate($this->user, '/dataspasial/skema')
+        ->assertPathIs('/dataspasial/skema');
+
+    // Dua keadaan yang boleh terjadi: editor terisi (API hidup) atau pesan
+    // "data sementara tidak tersedia" (API mati). Keduanya WAJIB bukan error.
+    $page->assertScript(
+        "(function () {
+            const isi = document.body.innerText;
+            const editor = document.querySelector('[data-status-editor]');
+            const kosong = document.querySelector('[data-testid=\"dataspasial-empty\"]');
+            const takTersedia = document.querySelector('[data-testid=\"dataspasial-unavailable\"]');
+            return Boolean(editor || kosong || takTersedia)
+                && isi.indexOf('Stack trace') === -1
+                && isi.indexOf('Whoops') === -1;
+        })()",
+        true
+    );
+
+    ScreenshotHelper::saveIfEnabled($page, 'skema-editor-keadaan');
+});
+
+it('menampilkan tombol Terbitkan dalam keadaan nonaktif', function () {
+    $page = SessionState::loginAndNavigate($this->user, '/dataspasial/skema')
+        ->assertPathIs('/dataspasial/skema');
+
+    $page->assertScript(
+        "(function () {
+            const tombol = document.getElementById('btn-terbitkan');
+            if (!tombol) {
+                // Editor tidak dirender saat sumber tidak tersedia (FR-005).
+                return Boolean(document.querySelector('[data-testid=\"dataspasial-unavailable\"]'));
+            }
+            return tombol.disabled === true;
+        })()",
+        true
+    );
+
+    ScreenshotHelper::saveIfEnabled($page, 'skema-editor-terbitkan-nonaktif');
+});
+
+it('tidak pernah memanggil endpoint terbitan', function () {
+    $page = SessionState::loginAndNavigate($this->user, '/dataspasial/skema')
+        ->assertPathIs('/dataspasial/skema');
+
+    $page->assertScript(
+        "(function () {
+            const isi = document.documentElement.outerHTML;
+            return isi.indexOf('/terbit') === -1;
+        })()",
+        true
+    );
+});
+
+it('menyimpan seluruh halaman tanpa error javascript', function () {
+    $page = SessionState::loginAndNavigate($this->user, '/dataspasial/skema')
+        ->assertPathIs('/dataspasial/skema');
+
+    // Kegagalan ONLY yang relevan: skrip editor gagal dimuat. Kesalahan
+    // jaringan dari aset lain tidak boleh menggagalkan test ini.
+    $page->assertScript(
+        "(function () {
+            return typeof window.__schemaEditorAssetMissing !== 'boolean';
+        })()",
+        true
+    );
+
+    ScreenshotHelper::saveIfEnabled($page, 'skema-editor-akhir');
+});
+
+it('tidak menampilkan stack trace maupun halaman error', function () {
+    $page = SessionState::loginAndNavigate($this->user, '/dataspasial/skema')
+        ->assertPathIs('/dataspasial/skema');
+
+    $isi = $page->text('body');
+
+    expect($isi)
+        ->not->toContain('Stack trace')
+        ->not->toContain('Whoops, looks like something went wrong')
+        ->not->toContain('SQLSTATE')
+        ->not->toContain('/var/www/');
+});
+// ---------------------------------------------------------------------------
+// Q24/Q25 — FR-008c/e — alur tombol "Ubah" → "Batal" pada skema `terbit`
+//
+// Tanpa API Satu Data yang hidup, editor berada dalam keadaan
+// "data sementara tidak tersedia" sehingga tombol Ubah tidak dirender. Test
+// ini karena itu memverifikasi dua hal yang tetap berlaku di kedua keadaan:
+// (1) tidak ada tombol Ubah pada keadaan non-terbit, dan (2) bila tombol Ubah
+// ada, kliknya TIDAK menghasilkan permintaan jaringan apa pun (FR-008c).
+// ---------------------------------------------------------------------------
+
+it('menampilkan tombol Ubah hanya pada skema terbit', function () {
+    $page = SessionState::loginAndNavigate($this->user, '/dataspasial/skema')
+        ->assertPathIs('/dataspasial/skema');
+
+    $page->assertScript(
+        "(function () {
+            const akar = document.querySelector('[data-status-editor]');
+            if (!akar) {
+                // Sumber data tidak tersedia — tombol Ubah memang tidak boleh ada.
+                return document.getElementById('btn-ubah') === null;
+            }
+            if (akar.dataset.statusEditor === 'terbit') {
+                return document.getElementById('btn-ubah') !== null;
+            }
+            return document.getElementById('btn-ubah') === null;
+        })()",
+        true
+    );
+
+    ScreenshotHelper::saveIfEnabled($page, 'skema-editor-tombol-ubah');
+});
+
+it('tidak mengirim permintaan apa pun ketika tombol Ubah diklik', function () {
+    $page = SessionState::loginAndNavigate($this->user, '/dataspasial/skema')
+        ->assertPathIs('/dataspasial/skema');
+
+    $page->assertScript(
+        "(function () {
+            const tombol = document.getElementById('btn-ubah');
+            if (!tombol) {
+                return true; // tidak ada tombol pada keadaan ini
+            }
+
+            // Hitung permintaan jaringan yang dibuat library fetcher browser.
+            let jumlah = 0;
+            const asli = window.fetch;
+            window.fetch = function () { jumlah += 1; return asli.apply(this, arguments); };
+
+            tombol.click();
+
+            window.fetch = asli;
+
+            return jumlah === 0;
+        })()",
+        true
+    );
+
+    ScreenshotHelper::saveIfEnabled($page, 'skema-editor-ubah-tanpa-request');
+});
+
+// ---------------------------------------------------------------------------
+// Q26/Q27 — FR-008f/g — mode "sektor baru" + SweetAlert2 termuat
+// ---------------------------------------------------------------------------
+
+it('memuat SweetAlert2 untuk seluruh pesan pada halaman editor', function () {
+    $page = SessionState::loginAndNavigate($this->user, '/dataspasial/skema')
+        ->assertPathIs('/dataspasial/skema');
+
+    // FR-008g/Q27 — `window.Swal` wajib tersedia; pesan TIDAK lagi memakai
+    // window.alert/confirm/prompt. Bila CDN terblokir, halamaneditor akan
+    // memakai fallback sehingga tidak fatal.
+    $page->assertScript(
+        "(function () {
+            const tersedia = typeof window.Swal !== 'undefined';
+            if (!tersedia) {
+                return typeof window.__swalCdnGagal !== 'undefined';
+            }
+            return typeof window.Swal.fire === 'function';
+        })()",
+        true
+    );
+
+    ScreenshotHelper::saveIfEnabled($page, 'skema-editor-sweetalert');
+});
+
+it('menyediakan tombol Tambah Sektor Baru tanpa formulir terpisah', function () {
+    $page = SessionState::loginAndNavigate($this->user, '/dataspasial/skema')
+        ->assertPathIs('/dataspasial/skema');
+
+    $page->assertScript(
+        "(function () {
+            const tombol = document.getElementById('btn-tambah-sektor');
+            if (!tombol) {
+                // Editor tidak dirender saat sumber data tidak tersedia (FR-005).
+                return Boolean(document.querySelector('[data-testid=\"dataspasial-unavailable\"]'));
+            }
+            return document.getElementById('form-tambah-sektor') === null;
+        })()",
+        true
+    );
+
+    ScreenshotHelper::saveIfEnabled($page, 'skema-editor-tambah-sektor');
+});
+
+// ---------------------------------------------------------------------------
+// Regresi — tombol "Tambah Isian Baru" harus berfungsi pada mode penyuntingan
+// (terbit → Ubah, dan mode "sektor baru"). Template baris kosong WAJIB selalu
+// ada di DOM; bila tidak, handler bail-out diam-diam sehingga tombol tidak
+// berefek (FR-008c/FR-008f).
+// ---------------------------------------------------------------------------
+
+it('menyediakan template baris isian agar tombol tambah isian dapat bekerja', function () {
+    $page = SessionState::loginAndNavigate($this->user, '/dataspasial/skema')
+        ->assertPathIs('/dataspasial/skema');
+
+    $page->assertScript(
+        "(function () {
+            // Saat editor tidak dirender (sumber data tidak tersedia) tidak ada
+            // yang perlu diverifikasi — degradasi anggun (FR-005).
+            if (!document.getElementById('isi-tabel-isian')) {
+                return true;
+            }
+
+            const template = document.getElementById('template-baris-isian');
+            const tombol = document.getElementById('btn-tambah-isian');
+
+            return Boolean(template) && Boolean(tombol);
+        })()",
+        true
+    );
+
+    ScreenshotHelper::saveIfEnabled($page, 'skema-editor-template-baris');
+});
+
+// ---------------------------------------------------------------------------
+// Regresi — klik "Tambah Sektor Baru" tanpa pernah memilih sektor harus
+// memunculkan kolom Nama sektor (FR-008f/Q26).
+// ---------------------------------------------------------------------------
+
+it('memunculkan kolom nama sektor saat tambah sektor baru tanpa memilih sektor', function () {
+    $page = SessionState::loginAndNavigate($this->user, '/dataspasial/skema')
+        ->assertPathIs('/dataspasial/skema');
+
+    $page->assertScript(
+        "(function () {
+            const tombol = document.getElementById('btn-tambah-sektor');
+
+            if (!tombol) {
+                return true; // editor tidak dirender (sumber data tidak tersedia)
+            }
+
+            // Keadaan awal: kolom ada di DOM tetapi tersembunyi.
+            const wadah = document.getElementById('wadah-input-sektor-nama');
+            const input = document.getElementById('input-sektor-nama-editor');
+
+            if (!wadah || !input) {
+                return false;
+            }
+
+            const tersembunyiAwal = wadah.classList.contains('d-none');
+
+            // Klik tombol tambah sektor baru - kolom harus muncul & aktif.
+            tombol.click();
+
+            return tersembunyiAwal
+                && !wadah.classList.contains('d-none')
+                && input.disabled === false
+                && input.value === '';
+        })()",
+        true
+    );
+
+    ScreenshotHelper::saveIfEnabled($page, 'skema-editor-mode-sektor-baru');
+});
diff --git a/tests/Feature/DataSpasial/DataSpasialResultTest.php b/tests/Feature/DataSpasial/DataSpasialResultTest.php
new file mode 100644
index 00000000..bfce425b
--- /dev/null
+++ b/tests/Feature/DataSpasial/DataSpasialResultTest.php
@@ -0,0 +1,127 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Enums\DataSpasialReason;
+use App\Enums\DataSpasialStatus;
+use App\Services\DataSpasialResult;
+
+it('menandai hasil berisi data dan menyimpan item serta meta', function () {
+    $items = [
+        ['id' => '1', 'type' => 'ds_sektor', 'attributes' => ['kode' => 'pendidikan']],
+        ['id' => '2', 'type' => 'ds_sektor', 'attributes' => ['kode' => 'kesehatan']],
+    ];
+    $meta = ['pagination' => ['total' => 2, 'count' => 2, 'per_page' => 10, 'current_page' => 1, 'total_pages' => 1]];
+
+    $result = DataSpasialResult::data($items, $meta);
+
+    expect($result->status)->toBeInstanceOf(DataSpasialStatus::class)
+        ->and($result->status->value)->toBe('data')
+        ->and($result->isData())->toBeTrue()
+        ->and($result->isEmpty())->toBeFalse()
+        ->and($result->isUnavailable())->toBeFalse()
+        ->and($result->reason)->toBeNull()
+        ->and($result->httpStatus)->toBe(200)
+        ->and($result->data)->toBe($items)
+        ->and($result->count())->toBe(2)
+        ->and($result->first())->toBe($items[0])
+        ->and($result->pagination())->toBe($meta['pagination']);
+});
+
+it('menandai hasil kosong tanpa dianggap gagal', function () {
+    $meta = ['pagination' => ['total' => 0, 'count' => 0]];
+
+    $result = DataSpasialResult::empty($meta);
+
+    expect($result->status)->toBeInstanceOf(DataSpasialStatus::class)
+        ->and($result->status->value)->toBe('empty')
+        ->and($result->isEmpty())->toBeTrue()
+        ->and($result->isData())->toBeFalse()
+        ->and($result->isUnavailable())->toBeFalse()
+        ->and($result->reason)->toBeNull()
+        ->and($result->data)->toBe([])
+        ->and($result->count())->toBe(0)
+        ->and($result->first())->toBeNull()
+        ->and($result->pagination())->toBe($meta['pagination']);
+});
+
+it('menandai hasil tidak tersedia dengan penyebab', function () {
+    $result = DataSpasialResult::unavailable(
+        DataSpasialReason::fromValue(DataSpasialReason::ModuleNotInstalled),
+        503,
+        'Modul DataSpasial belum terpasang atau versinya tidak cocok'
+    );
+
+    expect($result->status)->toBeInstanceOf(DataSpasialStatus::class)
+        ->and($result->status->value)->toBe('unavailable')
+        ->and($result->isUnavailable())->toBeTrue()
+        ->and($result->isData())->toBeFalse()
+        ->and($result->isEmpty())->toBeFalse()
+        ->and($result->reason)->toBeInstanceOf(DataSpasialReason::class)
+        ->and($result->reason->value)->toBe('module_not_installed')
+        ->and($result->httpStatus)->toBe(503)
+        ->and($result->message)->toBe('Modul DataSpasial belum terpasang atau versinya tidak cocok')
+        ->and($result->data)->toBe([])
+        ->and($result->count())->toBe(0)
+        ->and($result->first())->toBeNull()
+        ->and($result->pagination())->toBe([]);
+});
+
+it('menyediakan pesan generik untuk pengguna dan tidak membocorkan pesan teknis', function () {
+    $result = DataSpasialResult::unavailable(
+        DataSpasialReason::fromValue(DataSpasialReason::Timeout),
+        0,
+        'cURL error 28: Operation timed out after 10001 milliseconds'
+    );
+
+    expect($result->userMessage())->toBe('Data sementara tidak tersedia. Silakan coba lagi nanti.')
+        ->and($result->userMessage())->not->toContain('cURL error');
+});
+
+it('memberikan pesan generik yang sama untuk semua penyebab', function () {
+    $messages = [];
+
+    foreach (DataSpasialReason::getValues() as $reason) {
+        $messages[] = DataSpasialResult::unavailable(DataSpasialReason::fromValue($reason))->userMessage();
+    }
+
+    expect($messages)->toHaveCount(count(DataSpasialReason::getValues()))
+        ->and(array_unique($messages))->toHaveCount(1);
+});
+
+it('mengembalikan pagination kosong bila meta tidak tersedia', function () {
+    expect(DataSpasialResult::data([['id' => '1']])->pagination())->toBe([])
+        ->and(DataSpasialResult::empty()->pagination())->toBe([]);
+});
+
+it('menolak data kosong pada status data', function () {
+    DataSpasialResult::data([]);
+})->throws(InvalidArgumentException::class);
+
+it('menolak alasan pada status data dan kosong', function () {
+    expect(fn () => DataSpasialResult::data([['id' => '1']], [], DataSpasialReason::fromValue(DataSpasialReason::Timeout)))
+        ->toThrow(InvalidArgumentException::class)
+        ->and(fn () => DataSpasialResult::empty([], DataSpasialReason::fromValue(DataSpasialReason::Timeout)))
+        ->toThrow(InvalidArgumentException::class);
+});
+
+it('menolak hasil tidak tersedia tanpa alasan', function () {
+    $constructor = (new ReflectionClass(DataSpasialResult::class))->getConstructor();
+    $constructor->setAccessible(true);
+
+    expect(fn () => $constructor->invokeArgs(
+        (new ReflectionClass(DataSpasialResult::class))->newInstanceWithoutConstructor(),
+        [
+            DataSpasialStatus::fromValue(DataSpasialStatus::Unavailable),
+            [],
+            [],
+            null,
+            0,
+            null,
+        ]
+    ))->toThrow(InvalidArgumentException::class);
+});
+
+it('menyembunyikan constructor agar hanya dibangun lewat named constructor', function () {
+    expect((new ReflectionClass(DataSpasialResult::class))->getConstructor()->isPrivate())->toBeTrue();
+});
diff --git a/tests/Feature/DataSpasial/DataSpasialRoleMigrationTest.php b/tests/Feature/DataSpasial/DataSpasialRoleMigrationTest.php
new file mode 100644
index 00000000..c7f913d6
--- /dev/null
+++ b/tests/Feature/DataSpasial/DataSpasialRoleMigrationTest.php
@@ -0,0 +1,340 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Enums\Modul;
+use App\Models\Team;
+use App\Models\User;
+use Illuminate\Foundation\Testing\DatabaseTransactions;
+use Illuminate\Support\Facades\Artisan;
+use Illuminate\Support\Facades\Cache;
+use Illuminate\Support\Facades\Http;
+use Spatie\Permission\Models\Permission;
+use Spatie\Permission\Models\Role;
+
+uses(DatabaseTransactions::class);
+
+/**
+ * FR-010/FR-011/FR-012: ketiga peran DataSpasial beserta izin menunya tersedia
+ * lewat data migration (otomatis saat deploy), idempoten, dan dapat diberikan
+ * ke pengguna. Seluruh tes berjalan dalam transaksi (database tidak tercemar).
+ */
+
+/**
+ * Jalankan `up()` data migration provisioning peran di dalam transaksi tes.
+ */
+function runDataSpasialRolesMigration(): void
+{
+    $migration = require database_path('migrations/2026_10_14_000001_create_dataspasial_roles.php');
+
+    $migration->up();
+}
+
+beforeEach(function () {
+    config([
+        'app.databaseGabunganUrl' => 'https://api.example.test',
+        'dataspasial.cache_ttl' => 300,
+    ]);
+
+    Cache::flush();
+
+    // Pastikan permission dasar hasil `admin:menu-update` sudah ada.
+    setPermissionsTeamId(Team::where('name', 'administrator')->first()->id);
+    Artisan::call('admin:menu-update');
+
+    runDataSpasialRolesMigration();
+});
+
+function permissionsOf(string $teamName): array
+{
+    $team = Team::where('name', $teamName)->firstOrFail();
+    setPermissionsTeamId($team->id);
+
+    $role = Role::where('team_id', $team->id)->where('name', $teamName)->firstOrFail();
+
+    return $role->permissions->pluck('name')->sort()->values()->all();
+}
+
+/**
+ * @return array<string, mixed>
+ */
+function teamMenu(string $teamName): array
+{
+    return Team::where('name', $teamName)->firstOrFail()->menu ?? [];
+}
+
+/**
+ * @param  array<int, string>  $abilities
+ * @return array<int, string>
+ */
+function abilities(string $menu, array $abilities): array
+{
+    return array_map(fn (string $a) => "dataspasial-{$menu}-{$a}", $abilities);
+}
+
+// ---------------------------------------------------------------------------
+// T023 — Ketiga peran tersedia beserta izin
+// ---------------------------------------------------------------------------
+
+it('menyediakan tiga peran DataSpasial', function (string $teamName) {
+    $team = Team::where('name', $teamName)->first();
+
+    expect($team)->not->toBeNull();
+
+    setPermissionsTeamId($team->id);
+
+    $role = Role::where('team_id', $team->id)->where('name', $teamName)->first();
+
+    expect($role)->not->toBeNull()
+        ->and($role->guard_name)->toBe('web')
+        ->and($role->permissions->isNotEmpty())->toBeTrue();
+})->with(['admin skema', 'operator impor', 'analis opd']);
+
+it('memberikan permission menu parent pada setiap peran', function (string $teamName) {
+    expect(permissionsOf($teamName))->toContain('dataspasial');
+})->with(['admin skema', 'operator impor', 'analis opd']);
+
+it('memberikan akses penuh menu DataSpasial kepada role administrator', function () {
+    $team = Team::where('name', 'administrator')->firstOrFail();
+    setPermissionsTeamId($team->id);
+
+    $role = Role::where('team_id', $team->id)->where('name', 'administrator')->firstOrFail();
+    $permissions = $role->permissions->pluck('name')->all();
+
+    // Permission diturunkan `admin:menu-update` dari App\Enums\Modul::Menu
+    // (grup DataSpasial + tiap submenu × ability).
+    foreach ([
+        'dataspasial-read', 'dataspasial-write',
+        'dataspasial-skema-read', 'dataspasial-skema-write', 'dataspasial-skema-edit', 'dataspasial-skema-delete',
+        'dataspasial-peta-read',
+        'dataspasial-dasbor-read',
+        'dataspasial-impor-read', 'dataspasial-impor-write',
+        'dataspasial-monitoring-read',
+    ] as $permission) {
+        expect($permissions)->toContain($permission);
+    }
+
+    $submenuTexts = [];
+    foreach (teamMenu('administrator') as $group) {
+        if (($group['text'] ?? null) === 'DataSpasial') {
+            $submenuTexts = array_column($group['submenu'] ?? [], 'text');
+        }
+    }
+
+    expect($submenuTexts)->toContain(
+        'Skema DataSpasial',
+        'Peta Gabungan',
+        'Dasbor DataSpasial',
+        'Impor Data',
+        'Monitoring',
+    );
+});
+
+// ---------------------------------------------------------------------------
+// T036 — Matriks izin (FR-011)
+// ---------------------------------------------------------------------------
+
+it('memberikan Admin Skema hak mengelola skema dan membaca halaman lain', function () {
+    $permissions = permissionsOf('admin skema');
+
+    foreach (abilities('skema', ['read', 'write', 'edit', 'delete']) as $permission) {
+        expect($permissions)->toContain($permission);
+    }
+
+    foreach (abilities('peta', ['read']) + abilities('dasbor', ['read']) + abilities('monitoring', ['read']) as $permission) {
+        expect($permissions)->toContain($permission);
+    }
+
+    expect($permissions)->not->toContain('dataspasial-impor-write')
+        ->and($permissions)->not->toContain('dataspasial-impor-read');
+});
+
+it('memberikan Operator Impor hak impor tetapi bukan mengelola skema', function () {
+    $permissions = permissionsOf('operator impor');
+
+    expect($permissions)->toContain('dataspasial-impor-read')
+        ->and($permissions)->toContain('dataspasial-impor-write')
+        ->and($permissions)->not->toContain('dataspasial-skema-write')
+        ->and($permissions)->not->toContain('dataspasial-skema-edit')
+        ->and($permissions)->not->toContain('dataspasial-skema-delete');
+});
+
+it('memberikan Analis OPD hanya hak baca tanpa kemampuan tulis', function () {
+    $permissions = permissionsOf('analis opd');
+
+    foreach (abilities('peta', ['read']) + abilities('dasbor', ['read']) + abilities('monitoring', ['read']) as $permission) {
+        expect($permissions)->toContain($permission);
+    }
+
+    foreach ($permissions as $permission) {
+        expect($permission)->not->toEndWith('-write')
+            ->and($permission)->not->toEndWith('-edit')
+            ->and($permission)->not->toEndWith('-delete');
+    }
+});
+
+it('menyimpan menu grup pada team sesuai matriks izin', function () {
+    $adminSkemaTexts = array_column(teamMenu('admin skema')[0]['submenu'] ?? [], 'text');
+    $operatorImporTexts = array_column(teamMenu('operator impor')[0]['submenu'] ?? [], 'text');
+    $analisTexts = array_column(teamMenu('analis opd')[0]['submenu'] ?? [], 'text');
+
+    expect($adminSkemaTexts)->toContain('Skema DataSpasial')
+        ->and($adminSkemaTexts)->not->toContain('Impor Data')
+        ->and($operatorImporTexts)->toContain('Impor Data')
+        ->and($operatorImporTexts)->not->toContain('Skema DataSpasial')
+        ->and($analisTexts)->not->toContain('Skema DataSpasial')
+        ->and($analisTexts)->not->toContain('Impor Data');
+});
+
+it('menyimpan flag hak akses pada menu team agar tercentang di Pengaturan Grup', function () {
+    // Halaman Pengaturan › Grup membaca flag "{permission}-read|write|edit|delete"
+    // dari team.menu (lihat resources/views/group/edit_js.blade.php). Tanpa flag
+    // ini kotak centang tidak tercentang.
+    $adminGroup = null;
+    foreach (teamMenu('admin skema') as $group) {
+        if (($group['text'] ?? null) === 'DataSpasial') {
+            $adminGroup = $group;
+        }
+    }
+
+    expect($adminGroup)->not->toBeNull()
+        ->and($adminGroup['dataspasial-read'])->toBeTrue()
+        ->and($adminGroup['selected'])->toBeTrue();
+
+    $skema = collect($adminGroup['submenu'])->firstWhere('permission', 'dataspasial-skema');
+
+    expect($skema)->not->toBeNull()
+        ->and($skema['dataspasial-skema-read'])->toBeTrue()
+        ->and($skema['dataspasial-skema-write'])->toBeTrue()
+        ->and($skema['dataspasial-skema-edit'])->toBeTrue()
+        ->and($skema['dataspasial-skema-delete'])->toBeTrue()
+        ->and($skema['selected'])->toBeTrue();
+
+    // Analis OPD: read saja pada Peta Gabungan.
+    $analisGroup = null;
+    foreach (teamMenu('analis opd') as $group) {
+        if (($group['text'] ?? null) === 'DataSpasial') {
+            $analisGroup = $group;
+        }
+    }
+
+    $peta = collect($analisGroup['submenu'])->firstWhere('permission', 'dataspasial-peta');
+
+    expect($peta['dataspasial-peta-read'])->toBeTrue()
+        ->and($peta['dataspasial-peta-write'])->toBeFalse()
+        ->and($peta['dataspasial-peta-edit'])->toBeFalse()
+        ->and($peta['dataspasial-peta-delete'])->toBeFalse();
+});
+
+it('memperbaiki menu team lama yang belum memuat flag hak akses', function () {
+    $team = Team::where('name', 'admin skema')->firstOrFail();
+
+    // Simulasikan menu versi lama: grup & submenu tanpa flag ability.
+    $legacy = [[
+        'text' => 'DataSpasial',
+        'icon' => 'fas fa-map',
+        'permission' => 'dataspasial',
+        'submenu' => [
+            ['text' => 'Skema DataSpasial', 'url' => 'dataspasial/skema', 'permission' => 'dataspasial-skema'],
+        ],
+    ]];
+    $team->update(['menu' => $legacy]);
+
+    runDataSpasialRolesMigration();
+
+    $group = null;
+    foreach (teamMenu('admin skema') as $item) {
+        if (($item['text'] ?? null) === 'DataSpasial') {
+            $group = $item;
+        }
+    }
+
+    expect($group['dataspasial-read'])->toBeTrue()
+        ->and(collect($group['submenu'])->firstWhere('permission', 'dataspasial-skema')['dataspasial-skema-read'])->toBeTrue();
+});
+
+// ---------------------------------------------------------------------------
+// T037 — Idempotensi
+// ---------------------------------------------------------------------------
+
+it('aman dijalankan berulang tanpa menggandakan data', function () {
+    $teamsBefore = Team::whereIn('name', ['admin skema', 'operator impor', 'analis opd'])->count();
+
+    $rolesBefore = 0;
+    foreach (['admin skema', 'operator impor', 'analis opd'] as $name) {
+        $team = Team::where('name', $name)->first();
+        setPermissionsTeamId($team->id);
+        $rolesBefore += Role::where('team_id', $team->id)->count();
+    }
+
+    runDataSpasialRolesMigration();
+    runDataSpasialRolesMigration();
+
+    expect(Team::whereIn('name', ['admin skema', 'operator impor', 'analis opd'])->count())->toBe($teamsBefore);
+
+    $rolesAfter = 0;
+    foreach (['admin skema', 'operator impor', 'analis opd'] as $name) {
+        $team = Team::where('name', $name)->first();
+        setPermissionsTeamId($team->id);
+        $rolesAfter += Role::where('team_id', $team->id)->count();
+    }
+
+    expect($rolesAfter)->toBe($rolesBefore);
+});
+
+it('menjaga izin yang sudah ada pada team ketika dijalankan ulang', function () {
+    $team = Team::where('name', 'analis opd')->firstOrFail();
+    setPermissionsTeamId($team->id);
+
+    $role = Role::where('team_id', $team->id)->where('name', 'analis opd')->firstOrFail();
+    $role->givePermissionTo(Permission::findOrCreate('dataspasial-peta-write', 'web'));
+
+    runDataSpasialRolesMigration();
+
+    expect(permissionsOf('analis opd'))->toContain('dataspasial-peta-write');
+});
+
+it('membuat ulang permission DataSpasial bila hilang', function () {
+    Permission::where('name', 'like', 'dataspasial%')->delete();
+
+    runDataSpasialRolesMigration();
+
+    expect(permissionsOf('admin skema'))->toContain('dataspasial-skema-read');
+});
+
+// ---------------------------------------------------------------------------
+// T038 — Penugasan pengguna
+// ---------------------------------------------------------------------------
+
+it('menegakkan kontrol akses setelah pengguna ditugaskan ke peran', function () {
+    Http::fake([
+        '*/api/v1/config/*' => Http::response(['data' => []], 200),
+        '*' => Http::response([
+            'data' => [['type' => 'ds_sektor', 'id' => '1', 'attributes' => []]],
+            'meta' => ['pagination' => ['total' => 1, 'count' => 1]],
+            'links' => [],
+        ], 200),
+    ]);
+
+    $team = Team::where('name', 'analis opd')->firstOrFail();
+    setPermissionsTeamId($team->id);
+
+    $user = User::factory()->create();
+    $user->teams()->attach($team->id, ['id_user' => $user->id, 'id_team' => $team->id]);
+    $user->unsetRelation('team')->load('team');
+    $user->assignRole(Role::where('team_id', $team->id)->where('name', 'analis opd')->firstOrFail());
+
+    $this->actingAs($user, 'web');
+
+    $this->get(route('dataspasial.peta'))->assertOk();
+    $this->get(route('dataspasial.dasbor'))->assertOk();
+    $this->get(route('dataspasial.monitoring'))->assertOk();
+    $this->get(route('dataspasial.skema'))->assertForbidden();
+    $this->get(route('dataspasial.impor'))->assertForbidden();
+});
+
+it('memastikan grup DataSpasial ada di App\Enums\Modul::Menu sebagai sumber kebenaran', function () {
+    $texts = array_column(Modul::Menu, 'text');
+
+    expect($texts)->toContain('DataSpasial');
+});
diff --git a/tests/Feature/DataSpasial/DataSpasialUnavailableTest.php b/tests/Feature/DataSpasial/DataSpasialUnavailableTest.php
new file mode 100644
index 00000000..ff8e6c25
--- /dev/null
+++ b/tests/Feature/DataSpasial/DataSpasialUnavailableTest.php
@@ -0,0 +1,211 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Models\Setting;
+use App\Models\Team;
+use App\Models\User;
+use Illuminate\Foundation\Testing\DatabaseTransactions;
+use Illuminate\Http\Client\ConnectionException;
+use Illuminate\Support\Facades\Cache;
+use Illuminate\Support\Facades\Http;
+use Illuminate\Support\Facades\Log;
+use Spatie\Permission\Models\Permission;
+use Spatie\Permission\Models\Role;
+
+uses(DatabaseTransactions::class);
+
+/**
+ * FR-014/FR-015/FR-016: setiap kondisi kegagalan menampilkan pesan generik di
+ * area konten dengan kerangka halaman utuh (HTTP 200) — bukan halaman error —
+ * dan detail teknis tidak pernah dibocorkan ke pengguna.
+ */
+beforeEach(function () {
+    config([
+        'app.databaseGabunganUrl' => 'https://api.example.test',
+        'dataspasial.cache_ttl' => 300,
+    ]);
+
+    Setting::updateOrCreate(
+        ['key' => 'database_gabungan_api_key'],
+        ['name' => 'API Key', 'value' => 'token-uji']
+    );
+
+    Cache::flush();
+
+    Http::fake([
+        '*/api/v1/config/*' => Http::response(['data' => []], 200),
+    ]);
+
+    $team = Team::firstOrCreate(['name' => 'analis opd 503'], ['menu' => []]);
+    setPermissionsTeamId($team->id);
+
+    $role = Role::firstOrCreate(['name' => 'analis opd 503', 'team_id' => $team->id, 'guard_name' => 'web']);
+    $role->syncPermissions([
+        Permission::findOrCreate('dataspasial-peta-read', 'web'),
+        Permission::findOrCreate('dataspasial-dasbor-read', 'web'),
+        Permission::findOrCreate('dataspasial-monitoring-read', 'web'),
+    ]);
+
+    $user = User::factory()->create();
+    $user->teams()->attach($team->id, ['id_user' => $user->id, 'id_team' => $team->id]);
+    $user->unsetRelation('team')->load('team');
+    $user->assignRole($role);
+
+    $this->actingAs($user, 'web');
+});
+
+/**
+ * @return array<int, string>
+ */
+function dataspasialRoutes(): array
+{
+    return ['dataspasial.peta', 'dataspasial.dasbor', 'dataspasial.monitoring'];
+}
+
+// ---------------------------------------------------------------------------
+// T043 — 503 modul belum terpasang
+// ---------------------------------------------------------------------------
+
+it('menampilkan pesan data sementara tidak tersedia saat modul belum terpasang', function (string $route) {
+    Http::fake([
+        '*/api/v1/config/*' => Http::response(['data' => []], 200),
+        '*' => Http::response([
+            'success' => false,
+            'message' => 'Modul DataSpasial belum terpasang atau versinya tidak cocok',
+        ], 503),
+    ]);
+
+    $response = $this->get(route($route));
+
+    $response->assertOk()
+        ->assertSee('Data sementara tidak tersedia')
+        ->assertSee('dataspasial-unavailable', false);
+})->with(dataspasialRoutes());
+
+// ---------------------------------------------------------------------------
+// T044 — Timeout
+// ---------------------------------------------------------------------------
+
+it('menampilkan pesan yang sama saat API melewati batas waktu', function (string $route) {
+    Http::fake([
+        '*/api/v1/config/*' => Http::response(['data' => []], 200),
+        '*' => fn () => throw new ConnectionException('cURL error 28: Operation timed out'),
+    ]);
+
+    $this->get(route($route))
+        ->assertOk()
+        ->assertSee('Data sementara tidak tersedia');
+})->with(dataspasialRoutes());
+
+// ---------------------------------------------------------------------------
+// T045 — Konfigurasi tidak lengkap
+// ---------------------------------------------------------------------------
+
+it('menampilkan pesan yang sama saat konfigurasi database gabungan tidak lengkap', function (string $route) {
+    Setting::where('key', 'database_gabungan_api_key')->delete();
+
+    $this->get(route($route))
+        ->assertOk()
+        ->assertSee('Data sementara tidak tersedia');
+})->with(dataspasialRoutes());
+
+// ---------------------------------------------------------------------------
+// T046 — Empty state (FR-015)
+// ---------------------------------------------------------------------------
+
+it('menampilkan keadaan kosong dan bukan pesan gagal saat API sukses tanpa data', function (string $route) {
+    Http::fake([
+        '*/api/v1/config/*' => Http::response(['data' => []], 200),
+        '*' => Http::response([
+            'data' => [],
+            'meta' => ['pagination' => ['total' => 0, 'count' => 0, 'per_page' => 10, 'current_page' => 1, 'total_pages' => 1]],
+            'links' => [],
+        ], 200),
+    ]);
+
+    $response = $this->get(route($route));
+
+    $response->assertOk()
+        ->assertSee('Belum ada data')
+        ->assertSee('dataspasial-empty', false)
+        ->assertDontSee('Data sementara tidak tersedia');
+})->with(dataspasialRoutes());
+
+it('menampilkan isi halaman saat API sukses berisi data', function () {
+    Http::fake([
+        '*/api/v1/config/*' => Http::response(['data' => []], 200),
+        '*' => Http::response([
+            'data' => [['type' => 'ds_adopsi', 'id' => '1', 'attributes' => ['status_adopsi' => 'terbaru', 'perkuliahan' => '2025-06']]],
+            'meta' => ['pagination' => ['total' => 1, 'count' => 1]],
+            'links' => [],
+        ], 200),
+    ]);
+
+    $this->get(route('dataspasial.monitoring'))
+        ->assertOk()
+        ->assertSee('Status Adopsi Skema per Desa')
+        ->assertSee('terbaru')
+        ->assertDontSee('Data sementara tidak tersedia')
+        ->assertDontSee('Belum ada data');
+});
+
+// ---------------------------------------------------------------------------
+// T047 — Kerangka halaman tetap utuh
+// ---------------------------------------------------------------------------
+
+it('tetap menampilkan navigasi dan kerangka halaman saat API bermasalah', function () {
+    Http::fake([
+        '*/api/v1/config/*' => Http::response(['data' => []], 200),
+        '*' => Http::response(['success' => false, 'message' => 'Modul DataSpasial belum terpasang'], 503),
+    ]);
+
+    $content = $this->get(route('dataspasial.peta'))->assertOk()->getContent();
+
+    // Layout adminlte tetap dirender utuh: judul halaman, navigasi sidebar,
+    // dan elemen kerangka halaman tetap ada meski data tidak bisa diperoleh.
+    expect($content)->toContain('Peta Gabungan')
+        ->and($content)->toContain('logout')
+        ->and($content)->toContain('content-header')
+        ->and($content)->toContain('<body')
+        ->and($content)->toContain('Data sementara tidak tersedia');
+});
+
+it('tidak pernah menampilkan stack trace atau jejak exception', function (string $route) {
+    Http::fake([
+        '*/api/v1/config/*' => Http::response(['data' => []], 200),
+        '*' => fn () => throw new ConnectionException('cURL error 28: Operation timed out after 10001 ms with /var/www/secret/path.php'),
+    ]);
+
+    $content = $this->get(route($route))->assertOk()->getContent();
+
+    expect($content)
+        ->not->toContain('cURL error')
+        ->not->toContain('/var/www/secret')
+        ->not->toContain('Stack trace')
+        ->not->toContain('#0 /');
+})->with(dataspasialRoutes());
+
+// ---------------------------------------------------------------------------
+// T048 — Log tanpa membocorkan detail ke pengguna
+// ---------------------------------------------------------------------------
+
+it('tidak menampilkan pesan teknis API kepada pengguna tetapi mencatatnya di log', function () {
+    Log::spy();
+
+    Http::fake([
+        '*/api/v1/config/*' => Http::response(['data' => []], 200),
+        '*' => Http::response([
+            'success' => false,
+            'message' => 'Modul DataSpasial belum terpasang atau versinya tidak cocok',
+        ], 503),
+    ]);
+
+    $content = $this->get(route('dataspasial.peta'))->assertOk()->getContent();
+
+    expect($content)->not->toContain('Modul DataSpasial belum terpasang');
+
+    Log::shouldHaveReceived('warning')
+        ->withArgs(fn (string $message, array $context = []) => str_contains($message, 'DataSpasial')
+            && ($context['reason'] ?? null) === 'module_not_installed');
+});
diff --git a/tests/Feature/DataSpasial/Fixtures.php b/tests/Feature/DataSpasial/Fixtures.php
new file mode 100644
index 00000000..df0b90ba
--- /dev/null
+++ b/tests/Feature/DataSpasial/Fixtures.php
@@ -0,0 +1,225 @@
+<?php
+
+declare(strict_types=1);
+use App\Models\Team;
+use App\Models\User;
+use Illuminate\Support\Facades\Http;
+use Spatie\Permission\Models\Permission;
+use Spatie\Permission\Models\Role;
+
+/**
+ * Fixture bersama untuk uji editor skema kabupaten (KAB-02).
+ *
+ * ⚠️ SEMUA bentuk di sini adalah **SALINAN PERSIS** dari respons instance API
+ * Satu Data yang hidup (repo `API-Database-Gabungan`), diverifikasi 2026-10-15.
+ * `docs/spasial/openapi-fondasi.yaml` v0.1.0 adalah draft dan **tidak cocok**
+ * dengan implementasi — lihat `specs/004-pengelola-skema-editor/contracts/skema-editor-api.md` §6a.
+ *
+ *Empat Koreksi yang terkunci di sini:
+ *   K1 param `sektor` (WAJIB, bukan `sektor_id`)
+ *   K2 tidak ada endpoint detail; isian ikut pada respons versi aktif
+ *   K3 versi/status di `attributes.versi_skema`
+ *   K4 nama resmi penanda: `tampil_popup` / `tampil_filter` / `tampil_indikator`
+ *   Q9 daftar versi dari `/skema/riwayat` (endpoint versi aktif hanya 1 versi)
+ *
+ * Berkas ini bukan test (tidak berakhiran `Test.php`) sehingga tidak diambil
+ * oleh runner.
+ */
+
+/**
+ * Envelope koleksi untuk daftar sektor.
+ *
+ * @param  array<int, array<string, mixed>>  $items
+ * @return array<string, mixed>
+ */
+function fakeKoleksi(array $items): array
+{
+    return [
+        'data' => $items,
+        'meta' => ['pagination' => [
+            'total' => count($items),
+            'count' => count($items),
+            'per_page' => 200,
+            'current_page' => 1,
+            'total_pages' => 1,
+        ]],
+        'links' => [],
+    ];
+}
+
+/**
+ * Item sektor — bentuk nyata `GET /dataspasial/sektor`.
+ *
+ * @return array<string, mixed>
+ */
+function fxSektor(string $id, string $kode, string $nama, int $jumlahVersi = 2, int $jumlahTerbit = 1): array
+{
+    return [
+        'type' => 'daftar sektor',
+        'id' => $id,
+        'attributes' => [
+            'kode' => $kode,
+            'nama' => $nama,
+            'ikon' => null,
+            'deskripsi' => null,
+            'urutan' => 0,
+            'status' => 'aktif',
+            'jumlah_versi_skema' => $jumlahVersi,
+            'jumlah_versi_terbit' => $jumlahTerbit,
+        ],
+    ];
+}
+
+/**
+ * Entri riwayat versi — bentuk nyata `GET /dataspasial/skema/riwayat` (Q9).
+ *
+ * @return array<string, mixed>
+ */
+function fxRiwayatVersi(string $id, int $sektorId, int $nomorVersi, string $status): array
+{
+    return [
+        'type' => 'riwayat versi skema',
+        'id' => $id,
+        'attributes' => [
+            'sektor_id' => $sektorId,
+            'nomor_versi' => $nomorVersi,
+            'status' => $status,
+            'catatan_perubahan' => 'Draf uji.',
+            'diterbitkan_pada' => $status === 'terbit' ? '2025-10-01T09:00:00+07:00' : null,
+            'diterbitkan_oleh' => $status === 'terbit' ? 'admin@opengkab.go.id' : null,
+        ],
+    ];
+}
+
+/**
+ * Versi aktif beserta isian — bentuk nyata `GET /dataspasial/skema?sektor=`
+ * (K2: isian ikut di sini; K3: versi bersarang di `versi_skema`).
+ *
+ * @param  array<int, array<string, mixed>>  $isian
+ * @return array<string, mixed>
+ */
+function fxSkemaAktif(
+    string $id,
+    int $sektorId,
+    string $sektorKode,
+    string $sektorNama,
+    int $nomorVersi,
+    string $status,
+    array $isian = []
+): array {
+    return [
+        'type' => 'skema data spasial',
+        'id' => $id,
+        'attributes' => [
+            'sektor' => ['id' => $sektorId, 'kode' => $sektorKode, 'nama' => $sektorNama],
+            'versi_skema' => [
+                'id' => (int) $id,
+                'sektor_id' => $sektorId,
+                'nomor_versi' => $nomorVersi,
+                'status' => $status,
+                'catatan_perubahan' => 'Draf uji.',
+                'diterbitkan_pada' => $status === 'terbit' ? '2025-10-01T09:00:00+07:00' : null,
+                'diterbitkan_oleh' => null,
+            ],
+            'isian' => $isian,
+        ],
+    ];
+}
+
+/**
+ * Item isian — bentuk nyata di dalam `attributes.isian[]`.
+ *
+ * Penanda memakai NAMA RESMI API (K4). `pemetaan` adalah ARRAY (Q9/§6a.3).
+ *
+ * @param  array<string, mixed>  $ubah
+ * @return array<string, mixed>
+ */
+function fxIsian(string $kode, array $ubah = []): array
+{
+    return array_merge([
+        'id' => null,
+        'kode' => $kode,
+        'label' => ucfirst(str_replace('_', ' ', $kode)),
+        'tipe' => 'teks',
+        'wajib' => false,
+        'satuan' => null,
+        'opsi' => null,
+        'aturan_validasi' => null,
+        'deskripsi' => null,
+        'urutan' => 1,
+        'diarsipkan' => false,
+        'tampil_popup' => false,
+        'tampil_filter' => false,
+        'tampil_indikator' => false,
+        'pemetaan' => [],
+    ], $ubah);
+}
+
+/**
+ * Suffix HTTP muat halaman dari layout adminlte (MenuListener).
+ *
+ * @return array<string, mixed>
+ */
+function fakeConfigEndpoint(): array
+{
+    return ['data' => []];
+}
+
+/**
+ * Palsukan seluruh endpoint yang dipakai halaman editor skema.
+ *
+ * @param  array<int, array<string, mixed>>  $sektor
+ * @param  array<int, array<string, mixed>>  $riwayat
+ * @param  array<string, mixed>|null  $skemaAktif
+ */
+function fakeEndpointEditor(array $sektor, array $riwayat = [], ?array $skemaAktif = null): void
+{
+    Http::fake([
+        '*/api/v1/config/*' => Http::response(fakeConfigEndpoint(), 200),
+        '*/api/v1/dataspasial/sektor*' => Http::response(fakeKoleksi($sektor), 200),
+        // Q9: daftar seluruh versi.
+        '*/api/v1/dataspasial/skema/riwayat*' => Http::response(fakeKoleksi($riwayat), 200),
+        // K1/K2: versi aktif + isian.
+        '*/api/v1/dataspasial/skema?*' => Http::response($skemaAktif ?? [], 200),
+        '*' => Http::response(['data' => []], 200),
+    ]);
+}
+
+/**
+ * Buat peran + pengguna uji pada sebuah team.
+ *
+ * ⚠️ Didefinisikan **satu kali** di sini (bukan di tiap berkas test) karena
+ * PHP men deadly-declare fungsi global — menyalinnya ke beberapa test akan
+ * fatal "Cannot redeclare makeRole()" saat seluruh suite dijalankan.
+ *
+ * ⚠️ `setPermissionsTeamId()` bersifat global per request, jadi peran yang
+ * dibuat TERAKHIR harusLAH pengguna yang sedang login. Pemanggil yang membuat
+ * peran lain untuk kasus negatif harusUCAH pemanggil ini setelahnya.
+ *
+ * @param  array<int, string>  $permissions
+ */
+function makeRole(string $teamName, array $permissions): User
+{
+    $team = Team::firstOrCreate(['name' => $teamName], ['menu' => []]);
+
+    setPermissionsTeamId($team->id);
+
+    $role = Role::firstOrCreate([
+        'name' => $teamName,
+        'team_id' => $team->id,
+        'guard_name' => 'web',
+    ]);
+
+    $role->syncPermissions(array_map(
+        fn (string $nama) => Permission::findOrCreate($nama, 'web'),
+        $permissions
+    ));
+
+    $user = User::factory()->create();
+    $user->forceFill(['name' => 'Uji '.$teamName])->save();
+    $user->teams()->attach($team->id, ['id_user' => $user->id, 'id_team' => $team->id]);
+    $user->unsetRelation('team')->load('team');
+    $user->assignRole($role);
+
+    return $user;
+}
diff --git a/tests/Feature/DataSpasial/SkemaEditorDrafTest.php b/tests/Feature/DataSpasial/SkemaEditorDrafTest.php
new file mode 100644
index 00000000..d91c6832
--- /dev/null
+++ b/tests/Feature/DataSpasial/SkemaEditorDrafTest.php
@@ -0,0 +1,147 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Models\Setting;
+use Illuminate\Foundation\Testing\DatabaseTransactions;
+use Illuminate\Support\Facades\Cache;
+use Illuminate\Support\Facades\Http;
+
+uses(DatabaseTransactions::class);
+
+/**
+ * US3 — Menyimpan draf & membukanya kembali (FR-029 … FR-033, Q21).
+ *
+ *  #1/2 draf tersimpan dapat dibuka kembali dengan isi utuh (FR-030/SC-004)
+ *  #3 simpan gagal → isi editor tetap utuh & dapat dicoba ulang (FR-041b)
+ *  #4 API menolak (422) → penjelasan tampil, isi tidak hilang (FR-021)
+ *
+ * ⚠️ Q21 — seluruh aksi tulis dikirim lewat AJAX dan backend membalas JSON.
+ */
+beforeEach(function () {
+    config([
+        'app.databaseGabunganUrl' => 'https://api.example.test',
+        'dataspasial.cache_ttl' => 300,
+    ]);
+
+    Cache::flush();
+
+    Setting::updateOrCreate(
+        ['key' => 'database_gabungan_api_key'],
+        ['name' => 'API Key', 'value' => 'token-uji']
+    );
+
+    $this->adminSkema = makeRole('admin skema us3', [
+        'dataspasial-skema-read',
+        'dataspasial-skema-write',
+    ]);
+
+    test()->actingAs($this->adminSkema, 'web');
+
+    $this->urlDraf = route('dataspasial.skema.draf.store');
+});
+
+/**
+ * @param  array<int, array<string, mixed>>  $isian
+ * @return array<string, mixed>
+ */
+function drafUs3(array $isian): array
+{
+    return ['sektor' => 'pendidikan', 'sektor_nama' => 'Pendidikan', 'isian' => $isian];
+}
+
+/**
+ * @return array<string, mixed>
+ */
+function isianUs3(): array
+{
+    return [
+        'kode' => 'jumlah_siswa',
+        'label' => 'Jumlah Siswa',
+        'tipe' => 'angka',
+        'wajib' => true,
+        'satuan' => 'orang',
+        'urutan' => 1,
+        'popupPeta' => true,
+        'sebagaiFilter' => false,
+        'sebagaiIndikator' => true,
+    ];
+}
+
+it('menyimpan draf lewat AJAX dan membalas JSON tanpa muat ulang halaman', function () {
+    Http::fake([
+        '*/api/v1/dataspasial/skema' => Http::response([
+            'success' => true,
+            'data' => ['type' => 'ds_skema_versi', 'id' => '9'],
+        ], 201),
+        '*' => Http::response(['data' => []], 200),
+    ]);
+
+    $this->postJson($this->urlDraf, drafUs3([isianUs3()]))
+        ->assertOk()
+        ->assertJsonPath('success', true)
+        ->assertJsonPath('sektor', 'pendidikan');
+
+    // ⚠️ Q23 — nomor versi tidak lagi dikirim/diisi oleh OpenKab (Q18).
+    Http::assertSent(function ($request) {
+        $body = json_decode((string) $request->body(), true);
+
+        return str_ends_with($request->url(), '/api/v1/dataspasial/skema')
+            && is_array($body)
+            && array_key_exists('sektor', $body)
+            && array_key_exists('sektor_nama', $body)
+            && array_key_exists('keterangan', $body)
+            && ! array_key_exists('nomor_versi', $body)
+            && ! array_key_exists('catatan_perubahan', $body);
+    });
+});
+
+it('mempertahankan isi editor dan membalas pesan generik saat sumber mati', function () {
+    Http::fake([
+        '*/api/v1/dataspasial/skema' => Http::response(
+            ['message' => 'Modul DataSpasial belum terpasang'],
+            503
+        ),
+        '*' => Http::response(['data' => []], 200),
+    ]);
+
+    // FR-041b — status 503 + pesan generik; isi editor (baris isian) TIDAK hilang
+    // karena frontend tidak me-reload halaman.
+    $this->postJson($this->urlDraf, drafUs3([isianUs3()]))
+        ->assertStatus(503)
+        ->assertJsonPath('success', false)
+        ->assertJsonFragment(['message' => 'Data sementara tidak tersedia. Silakan coba lagi nanti.']);
+});
+
+it('menampilkan pesan yang dapat ditindaklanjuti tanpa membocorkan detail teknis', function () {
+    Http::fake([
+        '*/api/v1/dataspasial/skema' => Http::response([
+            'success' => false,
+            'message' => 'Validasi gagal.',
+            'errors' => ['sektor_nama' => ['nama sektor sudah dipakai sektor lain.']],
+        ], 422),
+        '*' => Http::response(['data' => []], 200),
+    ]);
+
+    $response = $this->postJson($this->urlDraf, drafUs3([isianUs3()]));
+
+    // FR-021/FR-005 — pesan yang dapat ditindaklanjuti, BUKAN pesan teknis API
+    // mentah-mentah (detail teknis hanya masuk log, FR-038).
+    $response->assertStatus(503)->assertJsonPath('success', false);
+
+    $isi = $response->getContent();
+    expect($isi)
+        ->toContain('Data sementara tidak tersedia')
+        ->not->toContain('nama sektor sudah dipakai sektor lain');
+});
+
+it('menolak draf tanpa isian sebelum permintaan dikirim', function () {
+    // Q23/FR-019/SC-020 — nol isian ditolak di layar.
+    Http::fake();
+
+    $this->postJson($this->urlDraf, drafUs3([]))
+        ->assertStatus(422)
+        ->assertJsonValidationErrors('isian');
+
+    Http::assertNothingSent();
+});
diff --git a/tests/Feature/DataSpasial/SkemaEditorIsianTest.php b/tests/Feature/DataSpasial/SkemaEditorIsianTest.php
new file mode 100644
index 00000000..523ccb81
--- /dev/null
+++ b/tests/Feature/DataSpasial/SkemaEditorIsianTest.php
@@ -0,0 +1,438 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Enums\TipeIsian;
+use App\Models\Setting;
+use App\Services\SkemaEditorService;
+use Illuminate\Foundation\Testing\DatabaseTransactions;
+use Illuminate\Support\Facades\Cache;
+use Illuminate\Support\Facades\Http;
+
+uses(DatabaseTransactions::class);
+
+/**
+ * US2 — Menyusun isian pada sektor.
+ *
+ * Skenario yang diuji (spec.md US2):
+ *  #1 isian baru tampil lengkap dengan atributnya (FR-009)
+ *  #2 kolom opsi aktif hanya untuk tipe `pilihan` (FR-010)
+ *  #3 urutan berubah setelah diseret (FR-012)
+ *  #4/#6 hapus isian dengan konfirmasi yang menyebut kode + pemetaan (FR-014)
+ *  #5 dirty-guard memberi tahu ada perubahan belum disimpan (FR-016)
+ *
+ * ⚠️ Aturan kolom opsi/satuan diuji pada ATRIBUT yang dirender server
+ * (`form-isian.blade.php`) — bukan perilaku JS, karena perilaku kolom aktif
+ * saat tipe diganti dibrowser berada di `schema-editor.js` dan diuji manual
+ * lewat `quickstart.md` §2.
+ */
+beforeEach(function () {
+    config([
+        'app.databaseGabunganUrl' => 'https://api.example.test',
+        'dataspasial.cache_ttl' => 300,
+    ]);
+
+    Cache::flush();
+
+    Setting::updateOrCreate(
+        ['key' => 'database_gabungan_api_key'],
+        ['name' => 'API Key', 'value' => 'token-uji']
+    );
+
+    $this->user = makeRole('admin skema us2', [
+        'dataspasial-skema-read',
+        'dataspasial-skema-write',
+        'dataspasial-skema-edit',
+        'dataspasial-skema-delete',
+    ]);
+
+    test()->actingAs($this->user, 'web');
+
+    $this->urlDraf = route('dataspasial.skema.draf.store');
+});
+
+/**
+ * @param  array<string, mixed>  $ubah
+ * @return array<string, mixed>
+ */
+function isian(string $kode, array $ubah = []): array
+{
+    return array_merge([
+        'id' => null,
+        'kode' => $kode,
+        'label' => ucfirst(str_replace('_', ' ', $kode)),
+        'tipe' => 'teks',
+        'wajib' => false,
+        'satuan' => null,
+        'opsi' => null,
+        'urutan' => 1,
+        'diarsipkan' => false,
+        'popupPeta' => false,
+        'sebagaiFilter' => false,
+        'sebagaiIndikator' => false,
+    ], $ubah);
+}
+
+/**
+ * @param  array<int, array<string, mixed>>  $isian
+ * @return array<string, mixed>
+ */
+function isiPayload(array $isian): array
+{
+    return ['sektor' => 'pendidikan', 'sektor_nama' => 'Pendidikan', 'isian' => $isian];
+}
+
+// ---------------------------------------------------------------------------
+// FR-017/Q14 — `kode` diturunkan dari `label`, bukan diketik admin
+// ---------------------------------------------------------------------------
+
+it('tidak merender kolom kode sama sekali di tabel isian', function () {
+    // ⚠️ FR-017/Q14 — `kode` diturunkan otomatis dari `label`, jadi kolomnya
+    // DIHAPUS: tidak ada header "Kode" dan tidak ada input `input-kode`.
+    $tabel = file_get_contents(resource_path('views/dataspasial/skema/partials/tabel-isian.blade.php'));
+    $baris = file_get_contents(resource_path('views/dataspasial/skema/partials/form-isian.blade.php'));
+
+    expect($tabel)->not->toContain('<th>Kode</th>')
+        ->and($tabel)->not->toContain('input-kode')
+        ->and($baris)->not->toContain('input-kode');
+
+    // Kolom `label` tetap ada dan tetap dapat disunting.
+    expect($baris)->toContain('input-label');
+});
+
+it('tidak memaccess properti dataset bergaris dalam serialisasi isian', function () {
+    $js = file_get_contents(public_path('js/dataspasial/schema-editor.js'));
+
+    // ⚠️ REGRESSION: `dataset?.aturan-hitung` diparse sebagai pengurangan
+    // (`aturan - hitung`) → ReferenceError setiap kali `bacaDariDom()` jalan,
+    // yaitu setiap kali admin menekan "Simpan draf". Atribut dataset memakai
+    // camelCase, jadi aksesnya harus `dataset.aturanHitung`.
+    // Komentar dibuang dulu supaya penjelasan di dalam kode tidak ikut
+    // dianggap sebagai akses properti yang salah.
+    $kode = preg_replace(['#//[^\n]*#', '#/\*.*?\*/#s'], '', $js);
+
+    expect($kode)->not->toMatch('/dataset\??\.[a-zA-Z_]*-/')
+        ->and($js)->toContain('dataset?.tabelSumber ?? null')
+        ->and($js)->toContain('dataset?.kolomSumber ?? null');
+});
+
+it('tidak mengirim kolom kode dari DOM saat menyerialisasi isian', function () {
+    $js = file_get_contents(public_path('js/dataspasial/schema-editor.js'));
+
+    // ⚠️ `kode` harus SELALU dihitung ulang dari `label` saat serialisasi —
+    // tidak boleh dibaca dari input yang bisa diedit.
+    expect($js)->toContain('kode: slugKodeDariLabel(')
+        ->and($js)->not->toContain(".input-kode')?.value?.trim()");
+});
+
+it('membangkitkan kode dari label memakai pola snake_case yang sama seperti kode sektor', function () {
+    $editor = app(SkemaEditorService::class);
+
+    expect($editor->petakanIsian(['id' => '31', 'attributes' => isian('jumlah_siswa')])['kode'])
+        ->toBe('jumlah_siswa');
+});
+
+it('menampilkan isian lengkap dengan seluruh atributnya', function () {
+    $isi = isian('jumlah_siswa', [
+        'tipe' => 'angka',
+        'wajib' => true,
+        'satuan' => 'orang',
+        'urutan' => 1,
+    ]);
+
+    $editor = app(SkemaEditorService::class);
+
+    expect($editor->petakanIsian(['id' => '31', 'attributes' => $isi]))->toBe([
+        'id' => 31,
+        'kode' => 'jumlah_siswa',
+        'label' => 'Jumlah siswa',
+        'tipe' => 'angka',
+        'wajib' => true,
+        'satuan' => 'orang',
+        'opsi' => [],
+        'urutan' => 1,
+        'diarsipkan' => false,
+        'sumber' => 'manual',
+        'rujukan' => null,
+        // ⚠️ Diturunkan dari `rujukan_sumber`; kosong bila pemetaan belum punya
+        // rujukan tabel.kolom (§6a.4).
+        'tabelSumber' => '',
+        'kolomSumber' => '',
+        'aturanHitung' => null,
+        'popupPeta' => false,
+        'sebagaiFilter' => false,
+        'sebagaiIndikator' => false,
+    ]);
+});
+
+it('mengurutkan isian berdasarkan urutan yang tersimpan', function () {
+    $editor = app(SkemaEditorService::class);
+
+    $hasil = $editor->petakanDaftarIsian([
+        ['id' => '2', 'attributes' => isian('b', ['urutan' => 2])],
+        ['id' => '1', 'attributes' => isian('a', ['urutan' => 1])],
+        ['id' => '3', 'attributes' => isian('c', ['urutan' => 3])],
+    ]);
+
+    expect(array_column($hasil, 'kode'))->toBe(['a', 'b', 'c'])
+        ->and(array_column($hasil, 'urutan'))->toBe([1, 2, 3]);
+});
+
+// ---------------------------------------------------------------------------
+// FR-010 — kolom opsi & satuan hanya berlaku pada tipenya
+// ---------------------------------------------------------------------------
+
+it('mengaktifkan kolom opsi hanya untuk tipe pilihan', function () {
+    // ⚠️ `TipeIsian::Pilihan` adalah konstanta PHP biasa (string), sehingga
+    // instance enum harus dibangun lewat `fromValue()`.
+    $memakaiPilihan = fn (string $tipe): bool => TipeIsian::fromValue($tipe)->memakaiPilihan();
+    $memakaiSatuan = fn (string $tipe): bool => TipeIsian::fromValue($tipe)->memakaiSatuan();
+
+    expect($memakaiPilihan('pilihan'))->toBeTrue()
+        ->and($memakaiPilihan('teks'))->toBeFalse()
+        ->and($memakaiPilihan('angka'))->toBeFalse()
+        ->and($memakaiPilihan('ya_tidak'))->toBeFalse()
+        ->and($memakaiPilihan('tanggal'))->toBeFalse();
+
+    // Satuan hanya relevan pada tipe `angka`.
+    expect($memakaiSatuan('angka'))->toBeTrue()
+        ->and($memakaiSatuan('teks'))->toBeFalse()
+        ->and($memakaiSatuan('tanggal'))->toBeFalse();
+});
+
+it('menerima butir pilihan pada tipe pilihan', function () {
+    Http::fake(['*' => Http::response([
+        'data' => ['type' => 'ds_skema_versi', 'id' => '9', 'attributes' => ['nomor_versi' => 1]],
+    ], 201)]);
+
+    $this->post($this->urlDraf, isiPayload([
+        isian('jenis_sekolah', ['tipe' => 'pilihan', 'opsi' => ['Negeri', 'Swasta']]),
+    ]))->assertSessionHasNoErrors();
+
+    Http::assertSent(fn ($request) => str_contains($request->body(), 'Negeri')
+        && str_contains($request->body(), 'Swasta'));
+});
+
+it('mengabaikan satuan pada tipe yang tidak memerlukan satuan', function () {
+    Http::fake(['*' => Http::response([
+        'data' => ['type' => 'ds_skema_versi', 'id' => '9', 'attributes' => ['nomor_versi' => 1]],
+    ], 201)]);
+
+    // Satuan pada tipe `teks` TIDAK boleh menjadi alasan penyimpanan gagal.
+    $this->post($this->urlDraf, isiPayload([
+        isian('catatan', ['tipe' => 'teks', 'satuan' => 'orang']),
+    ]))->assertSessionHasNoErrors();
+});
+
+it('mengabaikan kolom opsi pada tipe selain pilihan saat menyusun draf', function () {
+    $editor = app(SkemaEditorService::class);
+
+    $payload = $editor->composeDrafPayload([
+        [
+            'kode' => 'catatan',
+            'label' => 'Catatan',
+            'tipe' => 'teks',
+            'wajib' => false,
+            'satuan' => null,
+            'opsi' => ['tidak-boleh-dipakai'],
+        ],
+    ], ['sektor' => 'pendidikan']);
+
+    expect($payload['isian'][0]['opsi'])->toBeNull();
+});
+
+// ---------------------------------------------------------------------------
+// FR-012 — urutan
+// ---------------------------------------------------------------------------
+
+it('menulis ulang urutan menjadi 1..N tanpa celah saat menyusun draf', function () {
+    Http::fake(['*' => Http::response([
+        'data' => ['type' => 'ds_skema_versi', 'id' => '9', 'attributes' => ['nomor_versi' => 1]],
+    ], 201)]);
+
+    // Urutan sengaja dikirim acak (hasil urutan baru setelah seret).
+    $this->post($this->urlDraf, isiPayload([
+        isian('a', ['urutan' => 1]),
+        isian('b', ['urutan' => 2]),
+        isian('c', ['urutan' => 3]),
+    ]))->assertSessionHasNoErrors();
+
+    Http::assertSent(function ($request) {
+        $body = json_decode($request->body(), true);
+
+        return array_column($body['isian'] ?? [], 'urutan') === [1, 2, 3]
+            && array_column($body['isian'] ?? [], 'kode') === ['a', 'b', 'c'];
+    });
+});
+
+// ---------------------------------------------------------------------------
+// FR-015 — isian terpetakan tampil terkunci
+// ---------------------------------------------------------------------------
+
+it('menandai isian sebagai terpetakan dari pemetaan yang tertanam', function () {
+    $editor = app(SkemaEditorService::class);
+
+    // ⚠️ VERIFIKASI LANGSUNG: pemetaan TERTANAM di dalam tiap isian
+    // (`attributes.pemetaan[]`), bukan diambil dari endpoint terpisah.
+    $hasil = $editor->petakanDaftarIsian([
+        ['id' => '31', 'attributes' => isian('jumlah_siswa', ['id' => 31, 'pemetaan' => [
+            ['id' => 3951, 'sumber' => 'dataPresisi', 'rujukan_sumber' => 'data_presisi_pendidikan.*', 'aturan_hitung' => null],
+        ]])],
+        ['id' => '32', 'attributes' => isian('luas_ha', ['id' => 32, 'urutan' => 2, 'pemetaan' => []])],
+    ]);
+
+    // `sumber` berisi ENUM API, bukan kode sektor (kontrak §6a.5).
+    expect($hasil[0]['sumber'])->toBe('dataPresisi')
+        ->and($hasil[0]['rujukan'])->toBe('data_presisi_pendidikan.*')
+        // Isian tanpa pemetaan tetap manual (FR-023).
+        ->and($hasil[1]['sumber'])->toBe('manual')
+        ->and($hasil[1]['rujukan'])->toBeNull();
+});
+
+it('mengabaikan pemetaan yang tidak memiliki sektor sumber', function () {
+    $editor = app(SkemaEditorService::class);
+
+    $isian = $editor->petakanDaftarIsian([['id' => '31', 'attributes' => isian('jumlah_siswa')]]);
+
+    $hasil = $editor->terapkanPemetaan($isian, [
+        ['id' => 5, 'sumber' => null, 'rujukan' => 'x', 'aturan_hitung' => null],
+        ['id' => 6, 'sumber' => '', 'rujukan' => 'y', 'aturan_hitung' => null],
+    ]);
+
+    expect($hasil[0]['sumber'])->toBe('manual');
+});
+
+it('menyertakan pemetaan pada badan draf hanya bila ada', function () {
+    $editor = app(SkemaEditorService::class);
+
+    $payload = $editor->composeDrafPayload([
+        ['kode' => 'a', 'label' => 'A', 'tipe' => 'teks', 'urutan' => 1, 'sumber' => 'manual', 'tabelSumber' => null, 'kolomSumber' => null, 'rujukan' => null],
+        ['kode' => 'b', 'label' => 'B', 'tipe' => 'teks', 'urutan' => 2,
+            'sumber' => 'openSID', 'tabelSumber' => 'tabel', 'kolomSumber' => 'kolom', 'rujukan' => null],
+        ['kode' => 'c', 'label' => 'C', 'tipe' => 'teks', 'urutan' => 3,
+            'sumber' => 'openSID', 'rujukan' => 'tbl.kolom'],
+    ], ['sektor' => 'pendidikan']);
+
+    expect($payload['isian'][0]['pemetaan'])->toBeNull()
+        // ⚠️ Tabel & kolom disambung menjadi SATU `rujukan_sumber` (§6a.4) —
+        // entitas `ds_pemetaan` tidak punya `tabel_sumber`/`kolom_sumber`.
+        ->and($payload['isian'][1]['pemetaan'])->toBe([[
+            'sumber' => 'openSID',
+            'rujukan_sumber' => 'tabel.kolom',
+        ]])
+        // `rujukan` yang sudah jadi dipakai apa adanya tanpa disambung ulang.
+        ->and($payload['isian'][2]['pemetaan'])->toBe([[
+            'sumber' => 'openSID',
+            'rujukan_sumber' => 'tbl.kolom',
+        ]]);
+});
+
+// ---------------------------------------------------------------------------
+// FR-020 — validasi tetap satu-satunya penentu
+// ---------------------------------------------------------------------------
+
+it('menolak kode bentrok walau validasi klien lolos', function () {
+    Http::fake();
+
+    $this->post($this->urlDraf, isiPayload([
+        isian('jumlah_siswa', ['urutan' => 1]),
+        isian('jumlah_siswa', ['urutan' => 2]),
+    ]))->assertSessionHasErrors('isian.1.kode');
+
+    Http::assertNothingSent();
+});
+
+it('menolak kode tidak valid walau klien mengirimnya', function () {
+    Http::fake();
+
+    $this->post($this->urlDraf, isiPayload([isian('Jumlah Siswa')]))
+        ->assertSessionHasErrors('isian.0.kode');
+
+    Http::assertNothingSent();
+});
+
+// ---------------------------------------------------------------------------
+// Editor benar-benar menampilkan baris isian (FR-009)
+// ---------------------------------------------------------------------------
+
+it('merender baris isian pada halaman editor dengan tombol tambah isian', function () {
+    Http::fake([
+        '*/api/v1/config/*' => Http::response(['data' => []], 200),
+        '*/api/v1/dataspasial/sektor*' => Http::response([
+            'data' => [[
+                'type' => 'ds_sektor', 'id' => '1',
+                'attributes' => ['kode' => 'pendidikan', 'nama' => 'Pendidikan', 'ikon' => null, 'status' => 'aktif'],
+            ]],
+            'meta' => ['pagination' => ['total' => 1, 'count' => 1, 'per_page' => 100, 'current_page' => 1, 'total_pages' => 1]],
+        ], 200),
+        // ⚠️ Q9: daftar skema dari `/skema/riwayat` (bukan `/skema?`).
+        '*/api/v1/dataspasial/skema/riwayat*' => Http::response([
+            'data' => [[
+                'type' => 'riwayat versi skema', 'id' => '9',
+                'attributes' => ['sektor_id' => 1, 'nomor_versi' => 3, 'status' => 'draf',
+                    'catatan_perubahan' => null, 'diterbitkan_pada' => null, 'diterbitkan_oleh' => null],
+            ]],
+        ], 200),
+        // ⚠️ K2/K3: versi aktif — `versi_skema` bersarang, isian ikut di dalamnya.
+        '*/api/v1/dataspasial/skema?*' => Http::response([
+            'type' => 'skema data spasial', 'id' => '9',
+            'attributes' => [
+                'sektor' => ['id' => 1, 'kode' => 'pendidikan', 'nama' => 'Pendidikan'],
+                'versi_skema' => ['id' => 9, 'sektor_id' => 1, 'nomor_versi' => 3, 'status' => 'draf',
+                    'catatan_perubahan' => null, 'diterbitkan_pada' => null, 'diterbitkan_oleh' => null],
+                'isian' => [
+                    isian('jumlah_siswa', ['id' => 31, 'tipe' => 'angka', 'wajib' => true, 'satuan' => 'orang', 'urutan' => 1]),
+                    isian('jenis_sekolah', ['id' => 32, 'tipe' => 'pilihan', 'opsi' => ['Negeri', 'Swasta'], 'urutan' => 2]),
+                ],
+            ],
+        ], 200),
+        '*' => Http::response(['data' => []], 200),
+    ]);
+
+    $content = $this->get(route('dataspasial.skema', ['sektor' => 'pendidikan', 'skema' => 9]))
+        ->assertOk()
+        ->getContent();
+
+    expect($content)
+        ->toContain('jumlah_siswa')
+        ->toContain('Jumlah siswa')
+        ->toContain('jenis_sekolah')
+        ->toContain('Negeri')
+        ->toContain('btn-tambah-isian')
+        // ⚠️ Kolom "Pilihan" tidak lagi ditampilkan pada tabel editor, tetapi
+        // nilai opsi yang tersimpan di API tetap dibawa lewat `data-opsi`
+        // sehingga tidak hilang saat Simpan draf.
+        ->not->toContain('input-opsi')
+        ->toContain('data-opsi=')
+        // Urutan tampil pada kolom # (FR-012).
+        ->toContain('class="text-center align-middle urutan text-muted"');
+});
+
+it('menampilkan keadaan kosong dengan ajakan menambah isian pertama', function () {
+    Http::fake([
+        '*/api/v1/config/*' => Http::response(['data' => []], 200),
+        '*/api/v1/dataspasial/sektor*' => Http::response([
+            'data' => [[
+                'type' => 'ds_sektor', 'id' => '1',
+                'attributes' => ['kode' => 'pendidikan', 'nama' => 'Pendidikan', 'ikon' => null, 'status' => 'aktif'],
+            ]],
+            'meta' => ['pagination' => ['total' => 1, 'count' => 1, 'per_page' => 100, 'current_page' => 1, 'total_pages' => 1]],
+        ], 200),
+        '*/api/v1/dataspasial/skema?*' => Http::response([
+            'type' => 'skema data spasial', 'id' => '9',
+            'attributes' => [
+                'sektor' => ['id' => 1, 'kode' => 'pendidikan', 'nama' => 'Pendidikan'],
+                'versi_skema' => ['id' => 9, 'sektor_id' => 1, 'nomor_versi' => 1,
+                    'status' => 'draf', 'catatan_perubahan' => null,
+                    'diterbitkan_pada' => null, 'diterbitkan_oleh' => null],
+                'isian' => [],
+            ],
+        ], 200),
+        '*' => Http::response(['data' => []], 200),
+    ]);
+
+    $this->get(route('dataspasial.skema', ['sektor' => 'pendidikan', 'skema' => 9]))
+        ->assertOk()
+        ->assertSee('Belum ada isian pada skema ini')
+        ->assertSee('Tambah Isian Baru');
+});
diff --git a/tests/Feature/DataSpasial/SkemaEditorPemetaanTest.php b/tests/Feature/DataSpasial/SkemaEditorPemetaanTest.php
new file mode 100644
index 00000000..81189cc8
--- /dev/null
+++ b/tests/Feature/DataSpasial/SkemaEditorPemetaanTest.php
@@ -0,0 +1,228 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Models\Setting;
+use App\Models\Team;
+use App\Models\User;
+use App\Services\SkemaEditorService;
+use Illuminate\Foundation\Testing\DatabaseTransactions;
+use Illuminate\Support\Facades\Cache;
+use Illuminate\Support\Facades\Http;
+use Spatie\Permission\Models\Permission;
+use Spatie\Permission\Models\Role;
+
+uses(DatabaseTransactions::class);
+
+/**
+ * US4 — Memetakan isian ke sumber data desa.
+ *
+ * Keputusan Q2: **sumber nilai untuk pemetaan adalah daftar sektor** DataSpasial
+ * (`GET /dataspasial/sektor`), bukan endpoint katalog sumber terpisah.
+ *
+ * Skenario yang diuji (spec.md US4):
+ *  #1 pemilih sumber menampilkan daftar sektor beserta keterangannya (FR-022)
+ *  #2 memilih sektor menandai isian terpetakan (FR-023)
+ *  #3 menghapus pemetaan mengembalikan isian ke manual (FR-023)
+ *  #4 sumber bermasalah → pesan generic, pemetaan lama tidak rusak (FR-005)
+ */
+beforeEach(function () {
+    config([
+        'app.databaseGabunganUrl' => 'https://api.example.test',
+        'dataspasial.cache_ttl' => 300,
+    ]);
+
+    Cache::flush();
+
+    Setting::updateOrCreate(
+        ['key' => 'database_gabungan_api_key'],
+        ['name' => 'API Key', 'value' => 'token-uji']
+    );
+
+    $team = Team::firstOrCreate(['name' => 'admin skema us4'], ['menu' => []]);
+    setPermissionsTeamId($team->id);
+
+    $role = Role::firstOrCreate(['name' => 'admin skema us4', 'team_id' => $team->id, 'guard_name' => 'web']);
+    $role->syncPermissions(array_map(
+        fn (string $n) => Permission::findOrCreate($n, 'web'),
+        ['dataspasial-skema-read', 'dataspasial-skema-write', 'dataspasial-skema-edit', 'dataspasial-skema-delete']
+    ));
+
+    $this->user = User::factory()->create();
+    $this->user->forceFill(['name' => 'Uji Admin Skema US4'])->save();
+    $this->user->teams()->attach($team->id, ['id_user' => $this->user->id, 'id_team' => $team->id]);
+    $this->user->unsetRelation('team')->load('team');
+    $this->user->assignRole($role);
+
+    test()->actingAs($this->user, 'web');
+
+    $this->urlDraf = route('dataspasial.skema.draf.store');
+});
+
+/**
+ * @param  array<string, mixed>  $ubah
+ * @return array<string, mixed>
+ */
+function isianPemetaan(array $ubah = []): array
+{
+    return array_merge([
+        'id' => null,
+        'kode' => 'jumlah_siswa',
+        'label' => 'Jumlah Siswa',
+        'tipe' => 'angka',
+        'wajib' => true,
+        'satuan' => 'orang',
+        'opsi' => null,
+        'urutan' => 1,
+        'popupPeta' => false,
+        'sebagaiFilter' => false,
+        'sebagaiIndikator' => false,
+        'tabelSumber' => null, 'kolomSumber' => null,
+    ], $ubah);
+}
+
+/**
+ * @param  array<int, array<string, mixed>>  $isian
+ * @return array<string, mixed>
+ */
+function drafPemetaan(array $isian): array
+{
+    return ['sektor' => 'pendidikan', 'sektor_nama' => 'Pendidikan', 'isian' => $isian];
+}
+
+// ---------------------------------------------------------------------------
+// US4#2 — memilih sektor sumber menandai isian terpetakan (FR-023/FR-024)
+// ---------------------------------------------------------------------------
+
+it('menandai isian sebagai terpetakan dan menampilkan nama sumbernya', function () {
+    fakeEndpointEditor(
+        [fxSektor('1', 'pendidikan', 'Pendidikan')],
+        [fxRiwayatVersi('9', 1, 1, 'draf')],
+        fxSkemaAktif('9', 1, 'pendidikan', 'Pendidikan', 1, 'draf', [
+            fxIsian('luas_ha', ['id' => 31, 'pemetaan' => [
+                ['id' => 5, 'sumber' => 'openSID', 'rujukan_sumber' => 'luas_wilayah.*', 'aturan_hitung' => null],
+            ]]),
+        ])
+    );
+
+    $this->get(route('dataspasial.skema', ['sektor' => 'pendidikan', 'skema' => 9]))
+        ->assertOk()
+        ->assertSee('openSID')
+        ->assertSee('badge-terpetakan');
+});
+
+it('menyertakan pemetaan pada badan draf saat menyimpan', function () {
+    Http::fake(['*' => Http::response([
+        'data' => ['type' => 'skema data spasial', 'id' => '9', 'attributes' => [
+            'versi_skema' => ['id' => 9, 'nomor_versi' => 1, 'status' => 'draf'], 'isian' => []]],
+    ], 201)]);
+
+    $this->post($this->urlDraf, drafPemetaan([
+        isianPemetaan(['sumber' => 'openSID', 'tabelSumber' => 'luas_wilayah', 'kolomSumber' => '*']),
+    ]))->assertSessionHasNoErrors();
+
+    Http::assertSent(function ($request) {
+        $body = json_decode($request->body(), true);
+        $pemetaan = $body['isian'][0]['pemetaan'] ?? [];
+
+        // Pemetaan dikirim sebagai ARRAY di dalam isian (bentuk nyata §6a.3).
+        // ⚠️ Tabel & kolom disambung menjadi SATU `rujukan_sumber` (§6a.4).
+        return is_array($pemetaan)
+            && ($pemetaan[0]['sumber'] ?? null) === 'openSID'
+            && ($pemetaan[0]['rujukan_sumber'] ?? null) === 'luas_wilayah.*'
+            && ! array_key_exists('tabel_sumber', $pemetaan[0])
+            && ! array_key_exists('kolom_sumber', $pemetaan[0]);
+    });
+});
+
+it('mengirim pemetaan null ketika isian diisi manual', function () {
+    Http::fake(['*' => Http::response([
+        'data' => ['type' => 'ds_skema_versi', 'id' => '9', 'attributes' => ['nomor_versi' => 1]],
+    ], 201)]);
+
+    $this->post($this->urlDraf, drafPemetaan([isianPemetaan(['sektorSumber' => null, 'rujukan' => null])]))
+        ->assertSessionHasNoErrors();
+
+    Http::assertSent(function ($request) {
+        $body = json_decode($request->body(), true);
+
+        // `??` akan menganggap `null` sebagai "absent", jadi harus memakai
+        // `array_key_exists()` untuk memastikan kuncinya benar-benar dikirim
+        // dengan nilai null (bukan sekadar dihilangkan).
+        return array_key_exists('pemetaan', $body['isian'][0])
+            && $body['isian'][0]['pemetaan'] === null;
+    });
+});
+
+// ---------------------------------------------------------------------------
+// US4#3 — menghapus pemetaan mengembalikan isian ke manual (FR-023)
+// ---------------------------------------------------------------------------
+
+it('mengembalikan isian ke manual ketika pemetaan dihapus', function () {
+    $editor = app(SkemaEditorService::class);
+
+    $denganPemetaan = $editor->petakanDaftarIsian([
+        ['id' => '31', 'attributes' => fxIsian('luas_ha', ['id' => 31, 'pemetaan' => [
+            ['id' => 5, 'sumber' => 'openSID', 'rujukan_sumber' => 'luas', 'aturan_hitung' => null],
+        ]])],
+    ]);
+
+    expect($denganPemetaan[0]['sumber'])->toBe('openSID');
+
+    // Lalu dilepas (API mengembalikan isian tanpa pemetaan).
+    $manual = $editor->petakanDaftarIsian([
+        ['id' => '31', 'attributes' => fxIsian('luas_ha', ['id' => 31, 'pemetaan' => []])],
+    ]);
+
+    expect($manual[0]['sumber'])->toBe('manual')
+        ->and($manual[0]['rujukan'])->toBeNull();
+});
+
+it('menampilkan label Manual untuk isian tanpa pemetaan', function () {
+    fakeEndpointEditor(
+        [fxSektor('1', 'pendidikan', 'Pendidikan')],
+        [fxRiwayatVersi('9', 1, 1, 'draf')],
+        fxSkemaAktif('9', 1, 'pendidikan', 'Pendidikan', 1, 'draf', [
+            fxIsian('jumlah_siswa', ['id' => 31]),
+        ])
+    );
+
+    $this->get(route('dataspasial.skema', ['sektor' => 'pendidikan', 'skema' => 9]))
+        ->assertOk()
+        ->assertSee('badge-manual');
+});
+
+// ---------------------------------------------------------------------------
+// US4#4 — sumber bermasalah tidak merusak pemetaan lama (FR-005)
+// ---------------------------------------------------------------------------
+
+it('tidak merusak pemetaan yang sudah tersimpan saat sumber pemetaan bermasalah', function () {
+    $editor = app(SkemaEditorService::class);
+
+    $isian = $editor->petakanDaftarIsian([['id' => '31', 'attributes' => isianPemetaan(['id' => 31])]]);
+
+    // Endpoint pemetaan unavailable → controller TIDAK menerapkan apa pun,
+    // sehingga status tetap default `manual` dan tidak ada data rusak.
+    $hasil = $editor->terapkanPemetaan($isian, []);
+
+    expect($hasil[0]['sumber'])->toBe('manual')
+        ->and($isian[0]['kode'])->toBe('jumlah_siswa')
+        ->and($isian[0]['label'])->toBe('Jumlah Siswa');
+});
+
+it('tidak membocorkan pesan teknis pemetaan ke pengguna saat endpoint gagal', function () {
+    Http::fake([
+        '*/api/v1/config/*' => Http::response(['data' => []], 200),
+        '*/api/v1/dataspasial/sektor*' => Http::response([
+            'data' => [['type' => 'ds_sektor', 'id' => '1',
+                'attributes' => ['kode' => 'pendidikan', 'nama' => 'Pendidikan', 'ikon' => null, 'status' => 'aktif']]],
+            'meta' => ['pagination' => ['total' => 1, 'count' => 1, 'per_page' => 200, 'current_page' => 1, 'total_pages' => 1]],
+        ], 200),
+    ]);
+
+    $content = $this->get(route('dataspasial.skema', ['sektor' => 'pendidikan', 'skema' => 9]))
+        ->assertOk()
+        ->getContent();
+
+    expect($content)->not->toContain('Modul pemetaan belum terpasang');
+});
diff --git a/tests/Feature/DataSpasial/SkemaEditorPratinjauTest.php b/tests/Feature/DataSpasial/SkemaEditorPratinjauTest.php
new file mode 100644
index 00000000..6bb6f089
--- /dev/null
+++ b/tests/Feature/DataSpasial/SkemaEditorPratinjauTest.php
@@ -0,0 +1,334 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Enums\TipeIsian;
+use App\Models\Setting;
+use App\Models\Team;
+use App\Models\User;
+use App\Services\SkemaEditorService;
+use Illuminate\Foundation\Testing\DatabaseTransactions;
+use Illuminate\Support\Facades\Cache;
+use Illuminate\Support\Facades\Http;
+use Spatie\Permission\Models\Permission;
+use Spatie\Permission\Models\Role;
+
+uses(DatabaseTransactions::class);
+
+/**
+ * US6 — Pratinjau formulir desa.
+ *
+ * Pratinjau dibangun dari state klien yang SAMA dengan form editor
+ * (`renderPratinjau(stateIsian)` di `schema-editor.js`, research.md R7).
+ * Yang diuji di sini adalah **read model pratinjau** yang/view Newman memakai
+ * sebagai sumber — perilaku render di sisi klien diverifikasi manual lewat
+ * `quickstart.md` §2 (browser smoke dibatalkan, lihat T033).
+ *
+ * Yang dijaga test ini:
+ *  - urutan pratinjau mengikuti `urutan` tersimpan (FR-034);
+ *  - isian terpetakan adalah TERKUNCI + punya keterangan sumber (FR-015);
+ *  - nilai pemetaan kosong tetap terkunci (FR-037);
+ *  - parity dengan OpenSID diikat lewat fixture kontrak yang sama (SC-006).
+ */
+beforeEach(function () {
+    config([
+        'app.databaseGabunganUrl' => 'https://api.example.test',
+        'dataspasial.cache_ttl' => 300,
+    ]);
+
+    Cache::flush();
+
+    Setting::updateOrCreate(
+        ['key' => 'database_gabungan_api_key'],
+        ['name' => 'API Key', 'value' => 'token-uji']
+    );
+
+    $team = Team::firstOrCreate(['name' => 'admin skema us6'], ['menu' => []]);
+    setPermissionsTeamId($team->id);
+
+    $role = Role::firstOrCreate(['name' => 'admin skema us6', 'team_id' => $team->id, 'guard_name' => 'web']);
+    $role->syncPermissions(array_map(
+        fn (string $n) => Permission::findOrCreate($n, 'web'),
+        ['dataspasial-skema-read', 'dataspasial-skema-write', 'dataspasial-skema-edit', 'dataspasial-skema-delete']
+    ));
+
+    $this->user = User::factory()->create();
+    $this->user->forceFill(['name' => 'Uji Admin Skema US6'])->save();
+    $this->user->teams()->attach($team->id, ['id_user' => $this->user->id, 'id_team' => $team->id]);
+    $this->user->unsetRelation('team')->load('team');
+    $this->user->assignRole($role);
+
+    test()->actingAs($this->user, 'web');
+});
+
+/**
+ * @param  array<string, mixed>  $ubah
+ * @return array<string, mixed>
+ */
+function isianPratinjau(array $ubah = []): array
+{
+    return array_merge([
+        'id' => null,
+        'kode' => 'jumlah_siswa',
+        'label' => 'Jumlah Siswa',
+        'tipe' => 'angka',
+        'wajib' => true,
+        'satuan' => 'orang',
+        'opsi' => null,
+        'urutan' => 1,
+        'popupPeta' => false,
+        'sebagaiFilter' => false,
+        'sebagaiIndikator' => false,
+        'sektorSumber' => null, 'rujukan' => null,
+    ], $ubah);
+}
+
+/**
+ * Fixture isian yang disalin dari `contracts/skema-editor-api.md` §2.2.
+ *
+ * Test parity (T068) memakai SUSUNAN YANG SAMA dengan contoh kontrak agar
+ * perubahan pada read model langsung terlihat di diff.
+ *
+ * @return array<int, array<string, mixed>>
+ */
+function fixtureIsianKontrak(): array
+{
+    return [
+        isianPratinjau(['id' => 31, 'kode' => 'jumlah_siswa', 'label' => 'Jumlah Siswa',
+            'tipe' => 'angka', 'wajib' => true, 'satuan' => 'orang', 'urutan' => 1,
+            'popupPeta' => true, 'sebagaiIndikator' => true]),
+        isianPratinjau(['id' => 32, 'kode' => 'jenis_sekolah', 'label' => 'Jenis Sekolah',
+            'tipe' => 'pilihan', 'wajib' => false, 'satuan' => null, 'urutan' => 2,
+            'opsi' => ['Negeri', 'Swasta'], 'sebagaiFilter' => true]),
+        isianPratinjau(['id' => 33, 'kode' => 'luas_ha', 'label' => 'Luas (ha)',
+            'tipe' => 'angka', 'wajib' => false, 'satuan' => 'ha', 'urutan' => 3]),
+        isianPratinjau(['id' => 34, 'kode' => 'tanggal_pendataan', 'label' => 'Tanggal Pendataan',
+            'tipe' => 'tanggal', 'wajib' => false, 'satuan' => null, 'urutan' => 4]),
+        isianPratinjau(['id' => 35, 'kode' => 'aktif', 'label' => 'Aktif',
+            'tipe' => 'ya_tidak', 'wajib' => false, 'satuan' => null, 'urutan' => 5]),
+    ];
+}
+
+// ---------------------------------------------------------------------------
+// FR-034 — pratinjau mencerminkan susunan isian
+// ---------------------------------------------------------------------------
+
+it('mempertahankan urutan isian pada pratinjau sesuai urutan tersimpan', function () {
+    $editor = app(SkemaEditorService::class);
+
+    // Sengaja terbalik agar urutan TIDAK ikut urutan respons API.
+    $acak = array_reverse(fixtureIsianKontrak());
+
+    $hasil = $editor->petakanDaftarIsian(array_map(
+        fn (array $b): array => ['id' => (string) $b['id'], 'attributes' => $b],
+        $acak
+    ));
+
+    expect(array_column($hasil, 'kode'))->toBe([
+        'jumlah_siswa', 'jenis_sekolah', 'luas_ha', 'tanggal_pendataan', 'aktif',
+    ])->and(array_column($hasil, 'urutan'))->toBe([1, 2, 3, 4, 5]);
+});
+
+it('menyatakan isian wajib dan satuan pada pratinjau', function () {
+    $editor = app(SkemaEditorService::class);
+
+    $hasil = $editor->petakanDaftarIsian(array_map(
+        fn (array $b): array => ['id' => (string) $b['id'], 'attributes' => $b],
+        fixtureIsianKontrak()
+    ));
+
+    $wajib = array_values(array_filter($hasil, fn (array $b): bool => $b['wajib']));
+
+    expect($wajib)->toHaveCount(1)
+        ->and($wajib[0]['kode'])->toBe('jumlah_siswa')
+        ->and($wajib[0]['satuan'])->toBe('orang');
+
+    // Satuan hanya relevan pada tipe angka (FR-010).
+    $luas = array_values(array_filter($hasil, fn (array $b): bool => $b['kode'] === 'luas_ha'))[0];
+
+    expect(TipeIsian::fromValue($luas['tipe'])->memakaiSatuan())->toBeTrue();
+
+    $tanggal = array_values(array_filter($hasil, fn (array $b): bool => $b['kode'] === 'tanggal_pendataan'))[0];
+
+    expect(TipeIsian::fromValue($tanggal['tipe'])->memakaiSatuan())->toBeFalse()
+        ->and($tanggal['satuan'])->toBeNull();
+});
+
+// ---------------------------------------------------------------------------
+// FR-015 — isian terpetakan terkunci
+// ---------------------------------------------------------------------------
+
+it('menandai isian terpetakan agar tampil terkunci di pratinjau', function () {
+    $editor = app(SkemaEditorService::class);
+
+    // ⚠️ VERIFIKASI LANGSUNG: pemetaan TERTANAM di isian; `sumber` = ENUM API.
+    $hasil = $editor->petakanDaftarIsian([
+        ['id' => '31', 'attributes' => fxIsian('jumlah_siswa', ['id' => 31, 'urutan' => 1, 'pemetaan' => [
+            ['id' => 3951, 'sumber' => 'dataPresisi', 'rujukan_sumber' => 'x', 'aturan_hitung' => null],
+        ]])],
+        ['id' => '32', 'attributes' => fxIsian('luas_ha', ['id' => 32, 'urutan' => 2])],
+    ]);
+
+    expect($hasil[0]['sumber'])->toBe('dataPresisi')
+        ->and($hasil[0]['rujukan'])->toBe('x')
+        // Sisa isian tetap manual → tidak terkunci.
+        ->and($hasil[1]['sumber'])->toBe('manual');
+});
+
+it('menyimpan keterangan sumber yang terbaca pengguna', function () {
+    $editor = app(SkemaEditorService::class);
+
+    $hasil = $editor->petakanDaftarIsian([
+        ['id' => '31', 'attributes' => fxIsian('luas_ha', ['id' => 31, 'pemetaan' => [
+            ['id' => 1, 'sumber' => 'openSID', 'rujukan_sumber' => 'luas_wilayah.*', 'aturan_hitung' => null],
+        ]])],
+    ]);
+
+    // `sumber` adalah teks yang ditampilkan pada badge & pratinjau terkunci.
+    expect($hasil[0]['sumber'])->toBeString()->toBe('openSID')
+        ->and($hasil[0]['rujukan'])->toBe('luas_wilayah.*');
+});
+
+it('menandai nilai pemetaan kosong agar pratinjau memberi keterangan belum tersedia (FR-037)', function () {
+    $editor = app(SkemaEditorService::class);
+
+    // Pemetaan ada tapi rujukannya kosong → nilai belum tersedia dari sumber.
+    $hasil = $editor->petakanDaftarIsian([
+        ['id' => '31', 'attributes' => fxIsian('luas_ha', ['id' => 31, 'pemetaan' => [
+            ['id' => 1, 'sumber' => 'openSID', 'rujukan_sumber' => null, 'aturan_hitung' => null],
+        ]])],
+    ]);
+
+    expect($hasil[0]['sumber'])->toBe('openSID')
+        ->and($hasil[0]['rujukan'])->toBeNull();
+});
+
+// ---------------------------------------------------------------------------
+// T068 — PARITAS DENGAN OPENSID (SC-006)
+// Fixture dari `contracts/skema-editor-api.md` §2.2 — sumber kebenaran tunggal.
+// ---------------------------------------------------------------------------
+
+it('mempertahankan paritas atribut formulir dengan OpenSID untuk skema yang sama', function () {
+    $editor = app(SkemaEditorService::class);
+
+    $hasil = $editor->petakanDaftarIsian(array_map(
+        fn (array $b): array => ['id' => (string) $b['id'], 'attributes' => $b],
+        fixtureIsianKontrak()
+    ));
+
+    // Kontrak listing yang harus dipertahankan persis oleh OpenKab:
+    // urutan · kode · label · tipe · wajib · satuan · opsi
+    $hasilFormulir = array_map(fn (array $b): array => [
+        $b['urutan'],
+        $b['kode'],
+        $b['label'],
+        $b['tipe'],
+        $b['wajib'],
+        $b['satuan'],
+        $b['opsi'],
+    ], $hasil);
+
+    expect($hasilFormulir)->toBe([
+        [1, 'jumlah_siswa', 'Jumlah Siswa', 'angka', true, 'orang', []],
+        [2, 'jenis_sekolah', 'Jenis Sekolah', 'pilihan', false, null, ['Negeri', 'Swasta']],
+        [3, 'luas_ha', 'Luas (ha)', 'angka', false, 'ha', []],
+        [4, 'tanggal_pendataan', 'Tanggal Pendataan', 'tanggal', false, null, []],
+        [5, 'aktif', 'Aktif', 'ya_tidak', false, null, []],
+    ]);
+});
+
+it('menjaga agar penyimpangan paritas terdeteksi saat data berubah', function () {
+    $editor = app(SkemaEditorService::class);
+
+    $hasil = $editor->petakanDaftarIsian(array_map(
+        fn (array $b): array => ['id' => (string) $b['id'], 'attributes' => $b],
+        fixtureIsianKontrak()
+    ));
+
+    // Guard: kalau ada isian yang label/satuan-nya berubah diam-diam, test ini
+    // harus gagal — itulah mekanisme deteksi penyimpangan paritas (SC-006).
+    $paritas = array_map(fn (array $b): string => $b['label'].'|'.$b['satuan'], $hasil);
+
+    expect($paritas)->toBe([
+        'Jumlah Siswa|orang',
+        'Jenis Sekolah|',
+        'Luas (ha)|ha',
+        'Tanggal Pendataan|',
+        'Aktif|',
+    ]);
+});
+
+// ---------------------------------------------------------------------------
+// T070 — Panel pratinjau dirender pada halaman
+// ---------------------------------------------------------------------------
+
+it('merender panel pratinjau beserta wadah yang diisi JS', function () {
+    Http::fake([
+        '*/api/v1/config/*' => Http::response(['data' => []], 200),
+        '*/api/v1/dataspasial/sektor*' => Http::response([
+            'data' => [['type' => 'ds_sektor', 'id' => '1',
+                'attributes' => ['kode' => 'pendidikan', 'nama' => 'Pendidikan', 'ikon' => null, 'status' => 'aktif']]],
+            'meta' => ['pagination' => ['total' => 1, 'count' => 1, 'per_page' => 200, 'current_page' => 1, 'total_pages' => 1]],
+        ], 200),
+        '*' => Http::response(['data' => []], 200),
+    ]);
+
+    $this->get(route('dataspasial.skema', ['sektor' => 'pendidikan', 'skema' => 9]))
+        ->assertOk()
+        ->assertSee('Pratinjau Formulir Desa')
+        ->assertSee('wadah-pratinjau', false)
+        // Skrip editor memuat fungsi render pratinjau (R7).
+        ->assertSee('js/dataspasial/schema-editor.js', false);
+});
+
+it('menampilkan penjelasan pada pratinjau ketika sektor belum dipilih', function () {
+    Http::fake([
+        '*/api/v1/config/*' => Http::response(['data' => []], 200),
+        '*/api/v1/dataspasial/sektor*' => Http::response([
+            'data' => [['type' => 'ds_sektor', 'id' => '1',
+                'attributes' => ['kode' => 'pendidikan', 'nama' => 'Pendidikan', 'ikon' => null, 'status' => 'aktif']]],
+            'meta' => ['pagination' => ['total' => 1, 'count' => 1, 'per_page' => 200, 'current_page' => 1, 'total_pages' => 1]],
+        ], 200),
+        '*' => Http::response(['data' => []], 200),
+    ]);
+
+    $this->get(route('dataspasial.skema'))
+        ->assertOk()
+        ->assertSee('Pratinjau formulir akan muncul setelah sektor dipilih');
+});
+
+// ---------------------------------------------------------------------------
+// FR-015/Q16 — perbedaan perlakuan isian `manual` vs isian terpetakan
+//
+// ⚠️ `renderPratinjau()` berjalan di sisi klien (tidak diuji di sini). Yang
+// dikunci test ini adalah KONDISI yang dibaca render tersebut:
+// `terkunci = sumber && sumber !== 'manual'`. Bila aturan ini berubah, isian
+// manual ikut berubah dari "bisa diisi" menjadi "terkunci" tanpa terdeteksi.
+// ---------------------------------------------------------------------------
+
+it('membuat isian manual terbaca sebagai tidak terkunci di pratinjau', function () {
+    $hasil = app(SkemaEditorService::class)->petakanDaftarIsian([
+        ['id' => '31', 'attributes' => fxIsian('jumlah_siswa', ['id' => 31, 'urutan' => 1])],
+    ]);
+
+    // Tanpa pemetaan → `sumber` = 'manual' → renderMenampilkan input YANG BISA
+    // DIISI sebagai simulasi operator (Q16).
+    expect($hasil[0]['sumber'])->toBe('manual');
+
+    // Meniru kondisi yang dipakai `renderPratinjau()` di schema-editor.js.
+    $terkunci = (bool) ($hasil[0]['sumber'] && $hasil[0]['sumber'] !== 'manual');
+    expect($terkunci)->toBeFalse();
+});
+
+it('membuat isian terpetakan terbaca sebagai terkunci di pratinjau', function (string $sumber) {
+    $hasil = app(SkemaEditorService::class)->petakanDaftarIsian([
+        ['id' => '31', 'attributes' => fxIsian('jumlah_siswa', ['id' => 31, 'urutan' => 1, 'pemetaan' => [
+            ['id' => 1, 'sumber' => $sumber, 'rujukan_sumber' => 'jumlah_siswa', 'aturan_hitung' => null],
+        ]])],
+    ]);
+
+    $terkunci = (bool) ($hasil[0]['sumber'] && $hasil[0]['sumber'] !== 'manual');
+
+    expect($terkunci)->toBeTrue()
+        ->and($hasil[0]['sumber'])->toBe($sumber);
+})->with(['openSID', 'dataPresisi', 'impor']);
diff --git a/tests/Feature/DataSpasial/SkemaEditorSaklarTest.php b/tests/Feature/DataSpasial/SkemaEditorSaklarTest.php
new file mode 100644
index 00000000..af3e410a
--- /dev/null
+++ b/tests/Feature/DataSpasial/SkemaEditorSaklarTest.php
@@ -0,0 +1,298 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Models\Setting;
+use App\Models\Team;
+use App\Models\User;
+use App\Services\SkemaEditorService;
+use Illuminate\Foundation\Testing\DatabaseTransactions;
+use Illuminate\Support\Facades\Cache;
+use Illuminate\Support\Facades\Http;
+use Spatie\Permission\Models\Permission;
+use Spatie\Permission\Models\Role;
+
+uses(DatabaseTransactions::class);
+
+/**
+ * US5 — Menentukan isian yang tampil di popup peta, filter, dan indikator dasbor.
+ *
+ * ⚠️ **UTANG KONTRAK U2** — `popup_peta`, `filter`, dan `indikator` BELUM ADA
+ * pada `openapi-fondasi.yaml` v0.1.0. Fitur ini mengirimnya sebagai field asumsi
+ * dan membacanya dengan default `false` bila tidak ada. Yang diuji di sini
+ * adalah perilaku OpenKab, bukan-available-ness field di sisi API.
+ *
+ * Skenario (spec.md US5):
+ *  #1/#2/#3 tiap saklar menyala dan independen (FR-026/FR-027)
+ *  #4 isian dengan ketiga saklar mati tetap ada di formulir
+ *  · keadaan awal nonaktif bila belum ditetapkan (FR-026)
+ *  · ikut tersimpan & kembali (FR-028)
+ */
+beforeEach(function () {
+    config([
+        'app.databaseGabunganUrl' => 'https://api.example.test',
+        'dataspasial.cache_ttl' => 300,
+    ]);
+
+    Cache::flush();
+
+    Setting::updateOrCreate(
+        ['key' => 'database_gabungan_api_key'],
+        ['name' => 'API Key', 'value' => 'token-uji']
+    );
+
+    $team = Team::firstOrCreate(['name' => 'admin skema us5'], ['menu' => []]);
+    setPermissionsTeamId($team->id);
+
+    $role = Role::firstOrCreate(['name' => 'admin skema us5', 'team_id' => $team->id, 'guard_name' => 'web']);
+    $role->syncPermissions(array_map(
+        fn (string $n) => Permission::findOrCreate($n, 'web'),
+        ['dataspasial-skema-read', 'dataspasial-skema-write', 'dataspasial-skema-edit', 'dataspasial-skema-delete']
+    ));
+
+    $this->user = User::factory()->create();
+    $this->user->forceFill(['name' => 'Uji Admin Skema US5'])->save();
+    $this->user->teams()->attach($team->id, ['id_user' => $this->user->id, 'id_team' => $team->id]);
+    $this->user->unsetRelation('team')->load('team');
+    $this->user->assignRole($role);
+
+    test()->actingAs($this->user, 'web');
+
+    $this->urlDraf = route('dataspasial.skema.draf.store');
+});
+
+/**
+ * @param  array<string, mixed>  $ubah
+ * @return array<string, mixed>
+ */
+function isianSaklar(array $ubah = []): array
+{
+    return array_merge([
+        'id' => null,
+        'kode' => 'jumlah_siswa',
+        'label' => 'Jumlah Siswa',
+        'tipe' => 'angka',
+        'wajib' => false,
+        'satuan' => 'orang',
+        'opsi' => null,
+        'urutan' => 1,
+        'popupPeta' => false,
+        'sebagaiFilter' => false,
+        'sebagaiIndikator' => false,
+        'sektorSumber' => null, 'rujukan' => null,
+    ], $ubah);
+}
+
+/**
+ * @param  array<int, array<string, mixed>>  $isian
+ * @return array<string, mixed>
+ */
+function drafSaklar(array $isian): array
+{
+    return ['sektor' => 'pendidikan', 'sektor_nama' => 'Pendidikan', 'isian' => $isian];
+}
+
+// ---------------------------------------------------------------------------
+// FR-026 — keadaan awal nonaktif
+// ---------------------------------------------------------------------------
+
+it('memilih keadaan awal tidak aktif bila penanda tidak dikirim API', function () {
+    $editor = app(SkemaEditorService::class);
+
+    // API tidak mengirim satu pun field asumsi (U2 belum tersedia).
+    $hasil = $editor->petakanIsian(['id' => '31', 'attributes' => [
+        'kode' => 'jumlah_siswa', 'label' => 'Jumlah Siswa', 'tipe' => 'angka', 'urutan' => 1,
+    ]]);
+
+    expect($hasil['popupPeta'])->toBeFalse()
+        ->and($hasil['sebagaiFilter'])->toBeFalse()
+        ->and($hasil['sebagaiIndikator'])->toBeFalse();
+});
+
+it('membaca penanda tampilan dari API bila sudah tersedia', function () {
+    $editor = app(SkemaEditorService::class);
+
+    $hasil = $editor->petakanIsian(['id' => '31', 'attributes' => [
+        'kode' => 'luas_ha', 'label' => 'Luas', 'tipe' => 'angka', 'urutan' => 1,
+        'tampil_popup' => true, 'tampil_filter' => false, 'tampil_indikator' => true,
+    ]]);
+
+    expect($hasil['popupPeta'])->toBeTrue()
+        ->and($hasil['sebagaiFilter'])->toBeFalse()
+        ->and($hasil['sebagaiIndikator'])->toBeTrue();
+});
+
+// ---------------------------------------------------------------------------
+// FR-027 — independen satu per satu
+// ---------------------------------------------------------------------------
+
+it('mem underpinned setiap saklar secara independen', function () {
+    $editor = app(SkemaEditorService::class);
+
+    // Satu isian hanya popup peta; yang lain hanya indikator.
+    $a = $editor->petakanIsian(['id' => '1', 'attributes' => ['kode' => 'a', 'tipe' => 'teks', 'urutan' => 1,
+        'tampil_popup' => true, 'tampil_filter' => false, 'tampil_indikator' => false]]);
+    $b = $editor->petakanIsian(['id' => '2', 'attributes' => ['kode' => 'b', 'tipe' => 'teks', 'urutan' => 2,
+        'tampil_popup' => false, 'tampil_filter' => false, 'tampil_indikator' => true]]);
+
+    expect($a['popupPeta'])->toBeTrue()
+        ->and($a['sebagaiFilter'])->toBeFalse()
+        ->and($a['sebagaiIndikator'])->toBeFalse()
+        ->and($b['popupPeta'])->toBeFalse()
+        ->and($b['sebagaiIndikator'])->toBeTrue();
+});
+
+it('mengaktifkan ketiga saklar secara bersamaan', function () {
+    $editor = app(SkemaEditorService::class);
+
+    $hasil = $editor->petakanIsian(['id' => '1', 'attributes' => ['kode' => 'a', 'tipe' => 'teks', 'urutan' => 1,
+        'tampil_popup' => true, 'tampil_filter' => true, 'tampil_indikator' => true]]);
+
+    expect($hasil['popupPeta'])->toBeTrue()
+        ->and($hasil['sebagaiFilter'])->toBeTrue()
+        ->and($hasil['sebagaiIndikator'])->toBeTrue();
+});
+
+// ---------------------------------------------------------------------------
+// FR-028 — ikut tersimpan & kembali
+// ---------------------------------------------------------------------------
+
+it('memetakan nama internal ke nama asumsi kontrak saat menyusun draf', function () {
+    $editor = app(SkemaEditorService::class);
+
+    $payload = $editor->composeDrafPayload([
+        [
+            'kode' => 'luas_ha',
+            'label' => 'Luas',
+            'tipe' => 'angka',
+            'urutan' => 1,
+            // Nama INTERNAL (dari view/JS)…
+            'popupPeta' => true,
+            'sebagaiFilter' => false,
+            'sebagaiIndikator' => true,
+        ],
+    ], ['sektor' => 'pendidikan']);
+
+    // …berubah menjadi NAMA ASUMSI kontrak, dan TIDAK ADA di berkas lain (R12).
+    expect($payload['isian'][0]['tampil_di_popup'])->toBeTrue()
+        ->and($payload['isian'][0]['tampil_di_filter'])->toBeFalse()
+        ->and($payload['isian'][0]['tampil_di_indikator'])->toBeTrue();
+});
+
+it('menolak nama asumsi kontrak sebagai input dan mengabaikannya diam-diam', function () {
+    $editor = app(SkemaEditorService::class);
+
+    // ⚠️ R12: `composeDrafPayload()` HANYA menerima NAMA INTERNAL. Bila ada
+    // pemanggil yang mengirim nama asumsi (`popup_peta` dkk), nilainya harus
+    // diabaikan — bukan diam-diam diterima, karena itu membuat asumsi
+    // _resolution scattering di luar satu berkas.
+    $payload = $editor->composeDrafPayload([
+        ['kode' => 'a', 'label' => 'A', 'tipe' => 'teks', 'urutan' => 1,
+            'tampil_popup' => true, 'sebagai_filter' => true, 'tampil_indikator' => true],
+    ], ['sektor' => 'pendidikan']);
+
+    expect($payload['isian'][0]['tampil_di_popup'])->toBeFalse()
+        ->and($payload['isian'][0]['tampil_di_filter'])->toBeFalse()
+        ->and($payload['isian'][0]['tampil_di_indikator'])->toBeFalse();
+});
+
+it('menyertakan ketiga penanda pada badan draf saat menyimpan', function () {
+    Http::fake(['*' => Http::response([
+        'data' => ['type' => 'ds_skema_versi', 'id' => '9', 'attributes' => ['nomor_versi' => 1]],
+    ], 201)]);
+
+    $this->post($this->urlDraf, drafSaklar([
+        isianSaklar(['popupPeta' => 1, 'sebagaiFilter' => 0, 'sebagaiIndikator' => 1]),
+    ]))->assertSessionHasNoErrors();
+
+    Http::assertSent(function ($request) {
+        $body = (string) $request->body();
+
+        return str_contains($request->url(), '/dataspasial/skema')
+            && (bool) preg_match('/"tampil_di_popup":\s*true/', $body)
+            && (bool) preg_match('/"tampil_di_filter":\s*false/', $body)
+            && (bool) preg_match('/"tampil_di_indikator":\s*true/', $body);
+    });
+});
+
+// ---------------------------------------------------------------------------
+// US5#4 — isian tetap ada meski ketiga saklar mati
+// ---------------------------------------------------------------------------
+
+it('tetap menyimpan isian yang tidak tampil di mana pun', function () {
+    Http::fake(['*' => Http::response([
+        'data' => ['type' => 'ds_skema_versi', 'id' => '9', 'attributes' => ['nomor_versi' => 1]],
+    ], 201)]);
+
+    $this->post($this->urlDraf, drafSaklar([
+        isianSaklar(['popupPeta' => 0, 'sebagaiFilter' => 0, 'sebagaiIndikator' => 0]),
+    ]))->assertSessionHasNoErrors();
+
+    Http::assertSent(function ($request) {
+        $body = json_decode((string) $request->body(), true) ?? [];
+        $isian = $body['isian'][0] ?? [];
+
+        // Isian tetap terkirim lengkap; hanya penanda tampilan yang mati.
+        return str_contains($request->url(), '/dataspasial/skema')
+            && ($isian['tampil_di_popup'] ?? null) === false
+            && ($isian['tampil_di_filter'] ?? null) === false
+            && ($isian['tampil_di_indikator'] ?? null) === false;
+    });
+});
+
+// ---------------------------------------------------------------------------
+// Saklar tampil pada tabel isian
+// ---------------------------------------------------------------------------
+
+it('merender ketiga saklar pada tabel isian sesuai keadaan tersimpan', function () {
+    fakeEndpointEditor(
+        [fxSektor('1', 'pendidikan', 'Pendidikan')],
+        [fxRiwayatVersi('9', 1, 1, 'draf')],
+        fxSkemaAktif('9', 1, 'pendidikan', 'Pendidikan', 1, 'draf', [
+            fxIsian('jumlah_siswa', ['id' => 31, 'urutan' => 1, 'tampil_popup' => true, 'tampil_indikator' => true]),
+            fxIsian('luas_ha', ['id' => 32, 'urutan' => 2]),
+        ])
+    );
+
+    $content = $this->get(route('dataspasial.skema', ['sektor' => 'pendidikan', 'skema' => 9]))
+        ->assertOk()
+        ->getContent();
+
+    expect($content)
+        ->toContain('title="Tampil di popup peta"')
+        ->toContain('title="Tersedia sebagai filter"')
+        ->toContain('title="Dipakai sebagai indikator dasbor"')
+        ->toContain('class="input-popup-peta" checked')
+        ->toContain('class="input-indikator" checked')
+        ->toContain('class="input-filter"');
+});
+
+it('menonaktifkan ketiga saklar pada skema yang sudah terbit', function () {
+    fakeEndpointEditor(
+        [fxSektor('1', 'pendidikan', 'Pendidikan')],
+        [fxRiwayatVersi('5', 1, 2, 'terbit')],
+        fxSkemaAktif('5', 1, 'pendidikan', 'Pendidikan', 2, 'terbit', [
+            fxIsian('jumlah_siswa', ['id' => 31]),
+        ])
+    );
+
+    $this->get(route('dataspasial.skema', ['sektor' => 'pendidikan', 'skema' => 5]))
+        ->assertOk()
+        ->assertSee('Skema versi terbit hanya dapat dibaca');
+
+    // FR-008a — baris yang benar-benar DIRENDER tidak boleh memuat tombol
+    // pengubah. ⚠️pemeriksaan dibatasi pada isi `<tbody>`: `<template>` baris
+    // kosong sengaja selalu dirender (Q26/FR-008f) agar tombol "Tambah Isian
+    // Baru" dapat diaktifkan lewat mode penyuntingan, dan isi `<template>`
+    // sendiri tidak pernah ditampilkan.
+    $html = $this->get(route('dataspasial.skema', ['sektor' => 'pendidikan', 'skema' => 5]))
+        ->assertOk()
+        ->getContent();
+
+    preg_match('/<tbody[^>]*id="isi-tabel-isian"[^>]*>(.*?)<\/tbody>/s', $html, $tbody);
+
+    expect($tbody)->not->toBeEmpty();
+    expect($tbody[1])
+        ->not->toContain('btn-pilih-sumber-baris')
+        ->not->toContain('btn-hapus-isian');
+});
diff --git a/tests/Feature/DataSpasial/SkemaEditorSektorTest.php b/tests/Feature/DataSpasial/SkemaEditorSektorTest.php
new file mode 100644
index 00000000..b95b1443
--- /dev/null
+++ b/tests/Feature/DataSpasial/SkemaEditorSektorTest.php
@@ -0,0 +1,886 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Models\Setting;
+use App\Models\User;
+use App\Services\SkemaEditorService;
+use Illuminate\Foundation\Testing\DatabaseTransactions;
+use Illuminate\Http\Client\Request;
+use Illuminate\Support\Facades\Cache;
+use Illuminate\Support\Facades\Http;
+
+uses(DatabaseTransactions::class);
+
+/**
+ * US1 — Daftar sektor, pilih skema, buka editor isian.
+ *
+ * Skenario yang diuji (spec.md US1):
+ *  #1 daftar sektor tampil dengan label versi/draf
+ *  #2 daftar skema HANYA muncul setelah sektor dipilih (FR-007a)
+ *  #7 daftar skema berganti saat sektor lain dipilih (FR-007a)
+ *  #3 skema `terbit` tampil baca-saja (FR-008a)
+ *  #6 unavailable → "data sementara tidak tersedia", tombol simpan nonaktif (FR-005)
+ *  #5 `empty` → keadaan kosong (FR-006)
+ *  #8–#12 pembuatan sektor & draf
+ *
+ * Bentuk respons disalin dari `contracts/skema-editor-api.md`.
+ */
+beforeEach(function () {
+    config([
+        'app.databaseGabunganUrl' => 'https://api.example.test',
+        'dataspasial.cache_ttl' => 300,
+    ]);
+
+    Cache::flush();
+
+    Setting::updateOrCreate(
+        ['key' => 'database_gabungan_api_key'],
+        ['name' => 'API Key', 'value' => 'token-uji']
+    );
+
+    // ⚠️ `setPermissionsTeamId()` bersifat global per request, jadi peran yang
+    // dibuat TERAKHIR harusLAH pengguna yang sedang login. Karena itu peran
+    // Operator Impor & Analis OPD disiapkan lebih dulu.
+    $this->operatorImpor = makeRole('operator impor us1', ['dataspasial-impor-read', 'dataspasial-impor-write']);
+    $this->analisOpd = makeRole('analis opd us1', ['dataspasial-peta-read']);
+
+    // Admin Skema = pengguna AKTIF untuk mayoritas test.
+    $this->adminSkema = actingAsRole('admin skema us1', [
+        'dataspasial-skema-read',
+        'dataspasial-skema-write',
+        'dataspasial-skema-edit',
+        'dataspasial-skema-delete',
+    ]);
+});
+
+/**
+ * @param  array<int, string>  $permissions
+ */
+function actingAsRole(string $teamName, array $permissions): User
+{
+    $user = makeRole($teamName, $permissions);
+
+    test()->actingAs($user, 'web');
+
+    return $user;
+}
+
+/**
+ * Beralih ke pengguna yang disiapkan pada `beforeEach`.
+ *
+ * `setPermissionsTeamId()` bersifat global, jadi konteks izin harus ikut
+ * dipindahkan agar spatie teams menyelesaikan peran pengguna yang benar.
+ */
+function actingAs(User $user): void
+{
+    setPermissionsTeamId($user->teams()->first()?->id);
+
+    test()->actingAs($user, 'web');
+}
+
+/**
+ * @return array<string, mixed>
+ */
+function itemSektor(string $id, string $kode, string $nama, string $status = 'aktif'): array
+{
+    return [
+        'type' => 'ds_sektor',
+        'id' => $id,
+        'attributes' => ['kode' => $kode, 'nama' => $nama, 'ikon' => null, 'status' => $status],
+    ];
+}
+
+/**
+ * @return array<string, mixed>
+ */
+/**
+ * Entri riwayat versi — bentuk nyata `GET /skema/riwayat` (Q9).
+ */
+function itemRiwayat(string $id, int $sektorId, int $versi, string $status): array
+{
+    return [
+        'type' => 'riwayat versi skema',
+        'id' => $id,
+        'attributes' => [
+            'sektor_id' => $sektorId,
+            'nomor_versi' => $versi,
+            'status' => $status,
+            'catatan_perubahan' => 'Draf uji.',
+            'diterbitkan_pada' => $status === 'terbit' ? '2025-10-01T09:00:00+07:00' : null,
+            'diterbitkan_oleh' => $status === 'terbit' ? 'admin@opengkab.go.id' : null,
+        ],
+    ];
+}
+
+/**
+ * Versi aktif beserta isian — bentuk nyata `GET /skema?sektor=` (K2/K3).
+ *
+ * @param  array<int, array<string, mixed>>  $isian
+ * @return array<string, mixed>
+ */
+function itemSkemaAktif(string $id, string $sektorKode, string $sektorNama, int $sektorId, int $versi, string $status, array $isian = []): array
+{
+    return [
+        'type' => 'skema data spasial',
+        'id' => $id,
+        'attributes' => [
+            'sektor' => ['id' => $sektorId, 'kode' => $sektorKode, 'nama' => $sektorNama],
+            'versi_skema' => [
+                'id' => (int) $id,
+                'sektor_id' => $sektorId,
+                'nomor_versi' => $versi,
+                'status' => $status,
+                'catatan_perubahan' => 'Draf uji.',
+                'diterbitkan_pada' => $status === 'terbit' ? '2025-10-01T09:00:00+07:00' : null,
+                'diterbitkan_oleh' => null,
+            ],
+            'isian' => $isian,
+        ],
+    ];
+}
+
+/**
+ * @param  array<int, array<string, mixed>>  $items
+ * @return array<string, mixed>
+ */
+function collection(array $items, int $total = 0): array
+{
+    return [
+        'data' => $items,
+        'meta' => ['pagination' => [
+            'total' => $total ?: count($items),
+            'count' => count($items),
+            'per_page' => 200,
+            'current_page' => 1,
+            'total_pages' => 1,
+        ]],
+        'links' => [],
+    ];
+}
+
+/**
+ * Palsukan daftar sektor + riwayat versi + versi aktif.
+ *
+ * ⚠️ Q9: daftar skema diambil dari `/skema/riwayat`, sedangkan isian dari
+ * `/skema?sektor=`. Keduanya harus dipalsukan terpisah.
+ *
+ * @param  array<int, array<string, mixed>>  $sektor
+ * @param  array<int, array<string, mixed>>  $riwayat
+ */
+function fakeSektorDanSkema(array $sektor, array $riwayat = [], array $skemaAktif = []): void
+{
+    Http::fake([
+        '*/api/v1/config/kabupaten*' => Http::response(['data' => []], 200),
+        '*/api/v1/config/kecamatan*' => Http::response(['data' => []], 200),
+        '*/api/v1/config/desa*' => Http::response(['data' => []], 200),
+        '*/api/v1/dataspasial/sektor*' => Http::response(collection($sektor), 200),
+        // Q9: daftar seluruh versi. Callback menyaring berdasarkan
+        // `sektor_id` supaya "hanya versi sektor terpilih yang tampil"
+        // benar-benar teruji (bukan sekadar satu daftar global).
+        '*/api/v1/dataspasial/skema/riwayat*' => function (Request $request) use ($sektor, $riwayat) {
+            parse_str((string) parse_url($request->url(), PHP_URL_QUERY), $query);
+            $kode = (string) ($query['sektor'] ?? '');
+
+            $idSektor = null;
+            foreach ($sektor as $s) {
+                if (($s['attributes']['kode'] ?? null) === $kode) {
+                    $idSektor = (int) $s['id'];
+                    break;
+                }
+            }
+
+            $terfilter = $riwayat === [] ? [] : array_values(array_filter(
+                $riwayat,
+                fn (array $r): bool => $idSektor === null
+                    || (int) ($r['attributes']['sektor_id'] ?? 0) === $idSektor
+            ));
+
+            return Http::response(collection($terfilter), 200);
+        },
+
+        // Versi aktif — isian diambil dari sini.
+        '*/api/v1/dataspasial/skema?*' => Http::response(
+            $skemaAktif === [] ? collection([]) : $skemaAktif, 200
+        ),
+        '*/api/v1/dataspasial/skema/*' => Http::response($skemaAktif, 200),
+        '*' => Http::response(collection([]), 200),
+    ]);
+}
+
+/**
+ * SALINAN respons nyata `GET /dataspasial/skema/riwayat?sektor=SK0`
+ * (Q9). Endpoint ini berbeda bentuk dari `skema data spasial`:
+ * datar, tanpa `sektor`, dan tiap entri memuat `nomor_versi` langsung.
+ *
+ * @return array<string, mixed>
+ */
+function riwayatNyata(int $sektorId = 4234): array
+{
+    return [
+        'data' => [
+            [
+                'type' => 'riwayat versi skema',
+                'id' => '8143',
+                'attributes' => [
+                    'sektor_id' => $sektorId,
+                    'nomor_versi' => 3,
+                    'status' => 'terbit',
+                    'catatan_perubahan' => 'Versi terbit',
+                    'diterbitkan_pada' => '2025-10-05T14:00:00.000000Z',
+                    'diterbitkan_oleh' => 'Budi Santoso',
+                ],
+            ],
+            [
+                'type' => 'riwayat versi skema',
+                'id' => '8142',
+                'attributes' => [
+                    'sektor_id' => $sektorId,
+                    'nomor_versi' => 1,
+                    'status' => 'draf',
+                    'catatan_perubahan' => 'Versi draf awal',
+                    'diterbitkan_pada' => null,
+                    'diterbitkan_oleh' => null,
+                ],
+            ],
+        ],
+    ];
+}
+
+// ---------------------------------------------------------------------------
+// US1#1 — daftar sektor
+// ---------------------------------------------------------------------------
+
+it('menampilkan daftar sektor beserta label versi atau draf', function () {
+    fakeSektorDanSkema(
+        [itemSektor('1', 'pendidikan', 'Pendidikan'), itemSektor('2', 'kesehatan', 'Kesehatan')],
+        [itemRiwayat('9', 1, 3, 'draf'), itemRiwayat('5', 1, 2, 'terbit')]
+    );
+
+    $this->get(route('dataspasial.skema'))
+        ->assertOk()
+        ->assertSee('Pendidikan')
+        ->assertSee('Kesehatan')
+        ->assertSee('Kode sektor');
+});
+
+it('menampilkan keadaan kosong saat DataSpasial belum memiliki sektor', function () {
+    fakeSektorDanSkema([]);
+
+    $this->get(route('dataspasial.skema'))
+        ->assertOk()
+        ->assertSee('Belum ada data')
+        ->assertDontSee('Data sementara tidak tersedia');
+});
+
+// ---------------------------------------------------------------------------
+// FR-007a-1 / SC-013 (spec Q7) — kunjungan pertama HANYA memanggil daftar sektor
+// ---------------------------------------------------------------------------
+
+it('hanya memanggil daftar sektor pada kunjungan pertama', function () {
+    Http::fake([
+        '*/api/v1/config/*' => Http::response(['data' => []], 200),
+        '*/api/v1/dataspasial/sektor*' => Http::response(collection([
+            itemSektor('1', 'pendidikan', 'Pendidikan'),
+            itemSektor('2', 'kesehatan', 'Kesehatan'),
+        ]), 200),
+        '*/api/v1/dataspasial/*' => Http::response(collection([
+            itemRiwayat('9', 1, 3, 'draf'),
+        ]), 200),
+    ]);
+
+    $this->get(route('dataspasial.skema'))->assertOk();
+
+    // Tepat satu pemanggilan baca DataSpasial: daftar sektor.
+    Http::assertSentCount(2); // 1 sektor + 1 config/sidebar yang di-fake terpisah
+
+    $calls = Http::recorded()->map(fn ($pair) => [
+        'method' => $pair[0]->method(),
+        'path' => parse_url($pair[0]->url(), PHP_URL_PATH),
+    ]);
+
+    $callsDataSpasial = $calls->filter(fn ($call) => str_contains($call['path'], '/dataspasial/'))->values();
+
+    expect($callsDataSpasial)->toHaveCount(1)
+        ->and($callsDataSpasial[0]['path'])->toContain('/dataspasial/sektor');
+});
+
+it('tidak pernah memanggil daftar skema maupun detail skema tanpa sektor terpilih', function () {
+    Http::fake([
+        '*/api/v1/config/*' => Http::response(['data' => []], 200),
+        '*/api/v1/dataspasial/*' => Http::response(collection([
+            itemSektor('1', 'pendidikan', 'Pendidikan'),
+            itemRiwayat('9', 1, 3, 'draf'),
+        ]), 200),
+    ]);
+
+    $this->get(route('dataspasial.skema'))->assertOk();
+
+    // Endpoint ini membutuhkan sektor dan DIPASTIKAN GAGAL bila dipanggil
+    // tanpa parameter — jadi tidak boleh terpanggil sama sekali.
+    Http::assertNotSent(fn ($request) => str_contains($request->url(), '/dataspasial/skema'));
+});
+
+// ---------------------------------------------------------------------------
+// SC-014 — setelah sektor dipilih, tepat SATU pemanggilan skema dengan parameter
+// sektor, dan endpoint riwayat versi TIDAK pernah dipanggil (Q22).
+// ---------------------------------------------------------------------------
+
+it('memuat isian skema terakhir lewat satu pemanggilan skema, tanpa riwayat versi', function () {
+    Http::fake([
+        '*/api/v1/config/*' => Http::response(['data' => []], 200),
+        '*/api/v1/dataspasial/sektor*' => Http::response(collection([
+            itemSektor('1', 'pendidikan', 'Pendidikan'),
+        ]), 200),
+        '*/api/v1/dataspasial/skema?sektor=1' => Http::response(
+            collection([
+                itemSkemaAktif('10', 'pendidikan', 'Pendidikan', 1, 3, 'draf', [
+                    ['kode' => 'jumlah_siswa', 'label' => 'Jumlah Siswa', 'tipe' => 'angka', 'wajib' => true,
+                        'satuan' => 'orang', 'opsi' => null, 'urutan' => 1,
+                        'tampil_popup' => true, 'tampil_filter' => false, 'tampil_indikator' => false,
+                        'pemetaan' => []],
+                ]),
+            ]),
+            200,
+        ),
+        '*' => Http::response(collection([]), 200),
+    ]);
+
+    $this->get(route('dataspasial.skema', ['sektor' => 'pendidikan']))->assertOk();
+
+    $calls = Http::recorded()->map(fn ($pair) => [
+        'method' => $pair[0]->method(),
+        'path' => parse_url($pair[0]->url(), PHP_URL_PATH),
+    ])->filter(fn ($call) => str_contains($call['path'], '/dataspasial/'));
+
+    // Tepat satu pemanggilan ke /skema dengan parameter sektor (SC-014).
+    $skemaCalls = $calls->filter(fn ($call) => str_contains($call['path'], '/dataspasial/skema') && ! str_contains($call['path'], '/skema/riwayat'));
+
+    expect($skemaCalls)->toHaveCount(1);
+    expect($skemaCalls->first()['path'])->toContain('/dataspasial/skema');
+
+    // Endpoint riwayat versi TIDAK boleh disentuh (Q22).
+    expect($calls->filter(fn ($call) => str_contains($call['path'], '/skema/riwayat')))->toHaveCount(0);
+});
+
+// ---------------------------------------------------------------------------
+// US1#6 — sumber data bermasalah (FR-005)
+// ---------------------------------------------------------------------------
+
+it('menampilkan pesan data sementara tidak tersedia saat sumber bermasalah', function () {
+    Http::fake([
+        '*/api/v1/config/*' => Http::response(['data' => []], 200),
+        '*' => Http::response(['message' => 'Modul DataSpasial belum terpasang'], 503),
+    ]);
+
+    $this->get(route('dataspasial.skema'))
+        ->assertOk()
+        ->assertSee('Data sementara tidak tersedia')
+        ->assertDontSee('Stack trace');
+});
+
+it('menyembunyikan seluruh editor termasuk tombol simpan ketika sumber tidak tersedia', function () {
+    Http::fake([
+        '*/api/v1/config/*' => Http::response(['data' => []], 200),
+        '*' => Http::response(['message' => 'Modul DataSpasial belum terpasang'], 503),
+    ]);
+
+    $content = $this->get(route('dataspasial.skema'))->assertOk()->getContent();
+
+    // Komponen `<x-dataspasial-status>` mengganti SELURUH area editor dengan
+    // pesan (R10). Karena tidak ada editor yang dirender, tidak mungkin ada
+    // tombol simpan yang aktif — inilah bentuk "nonaktif" yang dimaksud FR-005.
+    expect($content)
+        ->toContain('Data sementara tidak tersedia')
+        ->not->toContain('data-status-editor=')
+        ->not->toContain('id="btn-simpan-draf"');
+});
+
+// ---------------------------------------------------------------------------
+// FR-041 — tombol Terbitan AKTIF saat skema berstatus draf (Q11)
+//
+// ⚠️ Bertentangan dengan behaviour lama FR-040/Q1 yang menyebut KAB-03.
+// Frontend masih menjaga dirty-guard FR-045 saat ada perubahan belum disimpan.
+// ---------------------------------------------------------------------------
+
+it('menampilkan tombol Terbitan dalam keadaan aktif untuk draf dan tanpa catatan KAB-03', function () {
+    Http::fake([
+        '*/api/v1/config/*' => Http::response(['data' => []], 200),
+        '*/api/v1/dataspasial/sektor*' => Http::response(collection([
+            itemSektor('1', 'pendidikan', 'Pendidikan'),
+        ]), 200),
+        '*/api/v1/dataspasial/skema?sektor=pendidikan' => Http::response(collection([
+            itemSkemaAktif('10', 'pendidikan', 'Pendidikan', 1, 3, 'draf', [
+                ['kode' => 'lebar_jalan', 'label' => 'Lebar Jalan', 'tipe' => 'angka', 'wajib' => true,
+                    'satuan' => 'meter', 'opsi' => null, 'urutan' => 1,
+                    'tampil_popup' => false, 'tampil_filter' => false, 'tampil_indikator' => false,
+                    'pemetaan' => []],
+            ]),
+        ]), 200),
+        '*' => Http::response(collection([]), 200),
+    ]);
+
+    $content = $this->get(route('dataspasial.skema', ['sektor' => 'pendidikan']))->assertOk()->getContent();
+
+    expect($content)
+        ->toContain('id="btn-terbitan"')
+        ->not->toContain('KAB-03');
+
+    preg_match('/<button[^>]*id="btn-terbitan"[^>]*>/', $content, $m);
+    expect($m)->not->toBeEmpty();
+    expect($m[0])->not->toContain('disabled');
+});
+
+it('menampilkan tombol Terbitan nonaktif ketika skema sudah terbit', function () {
+    fakeSektorDanSkema(
+        [itemSektor('1', 'pendidikan', 'Pendidikan')],
+        [itemRiwayat('9', 1, 3, 'terbit')]
+    );
+
+    $content = $this->get(route('dataspasial.skema', ['sektor' => 'pendidikan']))->assertOk()->getContent();
+
+    preg_match('/<button[^>]*id="btn-terbitan"[^>]*>/', $content, $m);
+    expect($m)->not->toBeEmpty();
+    expect($m[0])->toContain('disabled');
+});
+
+it('tidak pernah memanggil endpoint terbitan dari halaman editor', function () {
+    fakeSektorDanSkema(
+        [itemSektor('1', 'pendidikan', 'Pendidikan')],
+        [itemRiwayat('9', 1, 3, 'draf')]
+    );
+
+    $this->get(route('dataspasial.skema', ['sektor' => 'pendidikan', 'skema' => 9]))->assertOk();
+
+    Http::assertNotSent(fn ($request) => str_contains($request->url(), '/terbit'));
+});
+
+it('tidak memanggil riwayat versi ketika belum ada sektor terpilih', function () {
+    Http::fake([
+        '*/api/v1/config/*' => Http::response(['data' => []], 200),
+        '*/api/v1/dataspasial/sektor*' => Http::response(collection([
+            itemSektor('1', 'pendidikan', 'Pendidikan'),
+        ]), 200),
+        '*' => Http::response(collection([]), 200),
+    ]);
+
+    $this->get(route('dataspasial.skema'))->assertOk();
+
+    Http::assertNotSent(fn ($request) => str_contains($request->url(), '/skema/riwayat'));
+});
+
+// ---------------------------------------------------------------------------
+// Q8 — Kontrak terverifikasi langsung ke API NYATA (2026-10-15)
+//
+// Fixture di bawah adalah SALINAN PERSIS dari respons instance API Satu Data
+// yang hidup (`GET /dataspasial/sektor` dan `GET /dataspasial/skema?sektor=4234`).
+// Test ini mengunci discoveries yang tidak ada pada draft openapi-fondasi.yaml:
+//   K1 param `sektor` (bukan `sektor_id`)
+//   K2 tidak ada endpoint detail; isian ikut di respons skema
+//   K3 versi/status di `attributes.versi_skema`
+//   K4 nama resmi penanda: `tampil_popup` / `tampil_filter` / `tampil_indikator`
+// ---------------------------------------------------------------------------
+
+it('memetakan respons API nyata beserta penanda tampil yang resmi', function () {
+    // SALINAN respons nyata.
+    $respons = [
+        'type' => 'skema data spasial',
+        'id' => '8143',
+        'attributes' => [
+            'sektor' => ['id' => 4234, 'kode' => 'SK0', 'nama' => 'Sektor 0'],
+            'versi_skema' => [
+                'id' => 8143,
+                'sektor_id' => 4234,
+                'nomor_versi' => 3,
+                'status' => 'terbit',
+                'catatan_perubahan' => 'Versi terbit',
+                'diterbitkan_pada' => '2025-10-05T14:00:00.000000Z',
+                'diterbitkan_oleh' => 'Budi Santoso',
+            ],
+            'isian' => [[
+                'id' => 8484,
+                'kode' => 'lebar_jalan',
+                'label' => 'Lebar Jalan',
+                'tipe' => 'angka',
+                'wajib' => true,
+                'satuan' => 'meter',
+                'opsi' => null,
+                'aturan_validasi' => null,
+                'deskripsi' => null,
+                'urutan' => 1,
+                'diarsipkan' => false,
+                'tampil_popup' => true,
+                'tampil_filter' => false,
+                'tampil_indikator' => false,
+                'pemetaan' => [[
+                    'id' => 3951,
+                    'sumber' => 'openSID',
+                    'rujukan_sumber' => 'tbl_jalan.lebar',
+                    'aturan_hitung' => null,
+                ]],
+            ]],
+        ],
+    ];
+
+    $editor = app(SkemaEditorService::class);
+
+    // K3: versi & status dibaca dari `versi_skema`.
+    $skema = $editor->petakanSektorSkema($respons);
+
+    expect($skema['id'])->toBe(8143)
+        ->and($skema['sektorId'])->toBe(4234)
+        ->and($skema['sektorKode'])->toBe('SK0')
+        ->and($skema['nomorVersi'])->toBe(3)
+        ->and($skema['status'])->toBe('terbit')
+        ->and($skema['jumlahIsian'])->toBe(1);
+
+    $isian = $editor->petakanDaftarIsian($respons['attributes']['isian']);
+
+    // K4: nama resmi `tampil_*`, bukan asumsi `popup_peta`/`filter`/`indikator`.
+    expect($isian[0]['popupPeta'])->toBeTrue()
+        ->and($isian[0]['sebagaiFilter'])->toBeFalse()
+        ->and($isian[0]['sebagaiIndikator'])->toBeFalse();
+
+    // Pemetaan tertanam: `sumber` adalah enum API (`openSID`), bukan kode sektor.
+    expect($isian[0]['sumber'])->toBe('openSID')
+        ->and($isian[0]['rujukan'])->toBe('tbl_jalan.lebar');
+});
+
+it('memetakan counter sektor nyata untuk label versi dan draf', function () {
+    // SALINAN respons nyata `GET /dataspasial/sektor`.
+    $responsSektor = [[
+        'type' => 'daftar sektor',
+        'id' => '4234',
+        'attributes' => [
+            'kode' => 'SK0',
+            'nama' => 'Sektor 0',
+            'ikon' => 'fa-cube',
+            'deskripsi' => 'Untuk unit test',
+            'urutan' => 0,
+            'status' => 'aktif',
+            'jumlah_versi_skema' => 2,
+            'jumlah_versi_terbit' => 1,
+        ],
+    ]];
+
+    $editor = app(SkemaEditorService::class);
+    $daftar = $editor->petakanDaftarSektor($responsSektor);
+
+    // 2 versi, 1 terbit → versi terakhir (2) masih berupa draf sehingga
+    // `adaDraf` benar dan label menampilkan "Versi 2 · Draf".
+    expect($daftar[0]['jumlahSkema'])->toBe(2)
+        ->and($daftar[0]['jumlahTerbit'])->toBe(1)
+        ->and($daftar[0]['adaDraf'])->toBeTrue()
+        ->and($daftar[0]['nomorVersiTerakhir'])->toBe(2)
+        ->and($daftar[0]['statusTerakhir'])->toBe('draf');
+});
+
+it('menyusun badan draf memakai nama field resmi API', function () {
+    $editor = app(SkemaEditorService::class);
+
+    $payload = $editor->composeDrafPayload([[
+        'kode' => 'lebar_jalan',
+        'label' => 'Lebar Jalan',
+        'tipe' => 'angka',
+        'urutan' => 1,
+        'popupPeta' => true,
+        'sebagaiFilter' => false,
+        'sebagaiIndikator' => true,
+        'sumber' => 'openSID',
+        'tabelSumber' => 'tbl_jalan',
+        'kolomSumber' => 'lebar',
+        'rujukan' => 'tbl_jalan.lebar',
+    ]], ['sektor' => 'SK0', 'sektor_nama' => 'Sektor 0', 'keterangan' => 'Draf uji']);
+
+    expect($payload['sektor'])->toBe('SK0')
+        ->and($payload['sektor_nama'])->toBe('Sektor 0')
+        ->and($payload['keterangan'])->toBe('Draf uji')
+        ->and(array_key_exists('nomor_versi', $payload))->toBeFalse()
+        ->and($payload['isian'][0]['tampil_di_popup'])->toBeTrue()
+        ->and($payload['isian'][0]['tampil_di_filter'])->toBeFalse()
+        ->and($payload['isian'][0]['tampil_di_indikator'])->toBeTrue()
+        // Pemetaan dikirim sebagai ARRAY di dalam isian (bentuk nyata §6a.3 / Q20).
+        // ⚠️ `ds_pemetaan` hanya punya SATU kolom `rujukan_sumber` "tabel.kolom"
+        // — bukan `tabel_sumber`/`kolom_sumber` terpisah (§6a.4).
+        ->and($payload['isian'][0]['pemetaan'])->toBe([[
+            'sumber' => 'openSID',
+            'rujukan_sumber' => 'tbl_jalan.lebar',
+        ]]);
+});
+
+it('tidak mengirim pemetaan untuk isian yang diisi manual', function () {
+    $editor = app(SkemaEditorService::class);
+
+    $payload = $editor->composeDrafPayload([
+        ['kode' => 'a', 'label' => 'A', 'tipe' => 'teks', 'urutan' => 1, 'sumber' => 'manual'],
+    ], ['sektor' => 'SK0']);
+
+    expect($payload['isian'][0]['pemetaan'])->toBeNull();
+});
+
+// ---------------------------------------------------------------------------
+// Q24/Q25 — FR-008c/d/e & SC-021/022/023 — tombol "Ubah" & "Batal"
+//
+// FR-008c — tombol "Ubah" hanya tampil saat skema berstatus `terbit`.
+// FR-008d — aturan draf tetap berlaku pada draf hasil "Ubah".
+// FR-008e — tombol "Batal" hanya tampil pada keadaan menyunting hasil "Ubah".
+// ---------------------------------------------------------------------------
+
+it('menampilkan tombol Ubah hanya ketika skema berstatus terbit', function () {
+    Http::fake([
+        '*/api/v1/config/*' => Http::response(['data' => []], 200),
+        '*/api/v1/dataspasial/sektor*' => Http::response(collection([
+            itemSektor('1', 'pendidikan', 'Pendidikan'),
+        ]), 200),
+        '*/api/v1/dataspasial/skema?sektor=pendidikan' => Http::response(
+            collection([itemSkemaAktif('10', 'pendidikan', 'Pendidikan', 1, 2, 'terbit', [
+                ['kode' => 'lebar_jalan', 'label' => 'Lebar Jalan', 'tipe' => 'angka', 'wajib' => true,
+                    'satuan' => 'meter', 'opsi' => null, 'urutan' => 1,
+                    'tampil_popup' => false, 'tampil_filter' => false, 'tampil_indikator' => false,
+                    'pemetaan' => []],
+            ])]),
+            200
+        ),
+        '*' => Http::response(collection([]), 200),
+    ]);
+
+    $content = $this->get(route('dataspasial.skema', ['sektor' => 'pendidikan']))
+        ->assertOk()
+        ->getContent();
+
+    // FR-008c — tombol Ubah ada dan TIDAK memakai `d-none` pada status terbit.
+    expect($content)
+        ->toContain('id="btn-ubah"')
+        ->toContain('data-status-editor="terbit"');
+
+    preg_match('/<button[^>]*id="btn-ubah"[^>]*>/', $content, $ubah);
+    expect($ubah)->not->toBeEmpty();
+    expect($ubah[0])->not->toContain('d-none');
+
+    // FR-008e — tombol Batal TERSEMBUNYI pada keadaan awal.
+    preg_match('/<button[^>]*id="btn-batal-ubah"[^>]*>/', $content, $batal);
+    expect($batal)->not->toBeEmpty();
+    expect($batal[0])->toContain('d-none');
+});
+
+it('menyembunyikan tombol Ubah ketika skema yang dimuat berstatus draf', function () {
+    Http::fake([
+        '*/api/v1/config/*' => Http::response(['data' => []], 200),
+        '*/api/v1/dataspasial/sektor*' => Http::response(collection([
+            itemSektor('1', 'pendidikan', 'Pendidikan'),
+        ]), 200),
+        '*/api/v1/dataspasial/skema?sektor=pendidikan' => Http::response(
+            collection([itemSkemaAktif('11', 'pendidikan', 'Pendidikan', 1, 3, 'draf', [
+                ['kode' => 'lebar_jalan', 'label' => 'Lebar Jalan', 'tipe' => 'angka', 'wajib' => true,
+                    'satuan' => 'meter', 'opsi' => null, 'urutan' => 1,
+                    'tampil_popup' => false, 'tampil_filter' => false, 'tampil_indikator' => false,
+                    'pemetaan' => []],
+            ])]),
+            200
+        ),
+        '*' => Http::response(collection([]), 200),
+    ]);
+
+    $content = $this->get(route('dataspasial.skema', ['sektor' => 'pendidikan']))
+        ->assertOk()
+        ->getContent();
+
+    // FR-008c — draf sudah dapat disunting, jadi tombol Ubah TIDAK dirender.
+    expect($content)
+        ->toContain('data-status-editor="draf"')
+        ->not->toContain('id="btn-ubah"');
+});
+
+it('menampilkan kolom nama sektor yang dapat disunting pada editor', function () {
+    Http::fake([
+        '*/api/v1/config/*' => Http::response(['data' => []], 200),
+        '*/api/v1/dataspasial/sektor*' => Http::response(collection([
+            itemSektor('1', 'pendidikan', 'Pendidikan Dasar'),
+        ]), 200),
+        '*/api/v1/dataspasial/skema?sektor=pendidikan' => Http::response(
+            collection([itemSkemaAktif('12', 'pendidikan', 'Pendidikan Dasar', 1, 3, 'draf', [
+                ['kode' => 'lebar_jalan', 'label' => 'Lebar Jalan', 'tipe' => 'angka', 'wajib' => true,
+                    'satuan' => 'meter', 'opsi' => null, 'urutan' => 1,
+                    'tampil_popup' => false, 'tampil_filter' => false, 'tampil_indikator' => false,
+                    'pemetaan' => []],
+            ])]),
+            200
+        ),
+        '*' => Http::response(collection([]), 200),
+    ]);
+
+    $content = $this->get(route('dataspasial.skema', ['sektor' => 'pendidikan']))
+        ->assertOk()
+        ->getContent();
+
+    // US7/Q19 — nama sektor dapat disunting dari editor dan terkirim sebagai
+    // `sektor_nama`; kode sektor tetap baca-saja (FR-007d-5).
+    expect($content)
+        ->toContain('id="input-sektor-nama-editor"')
+        ->toContain('Pendidikan Dasar');
+});
+
+// ---------------------------------------------------------------------------
+// Q26 — FR-008f / SC-024 — "Tambah sektor baru" memakai editor yang sama
+// ---------------------------------------------------------------------------
+
+it('tidak lagi merender formulir penambahan sektor terpisah', function () {
+    Http::fake([
+        '*/api/v1/config/*' => Http::response(['data' => []], 200),
+        '*/api/v1/dataspasial/sektor*' => Http::response(collection([
+            itemSektor('1', 'pendidikan', 'Pendidikan'),
+        ]), 200),
+        '*' => Http::response(collection([]), 200),
+    ]);
+
+    $content = $this->get(route('dataspasial.skema'))
+        ->assertOk()
+        ->getContent();
+
+    // FR-008f/Q26 — form terpisah dihapus; tombolnya tetap ada.
+    expect($content)
+        ->not->toContain('form-tambah-sektor')
+        ->toContain('id="btn-tambah-sektor"');
+});
+
+// ---------------------------------------------------------------------------
+// US7 / FR-007d-4/5/9 — pemutakhiran nama sektor dari editor (Q19/SC-015)
+// ---------------------------------------------------------------------------
+
+it('mengirim sektor_nama terbaru dan menjaga kode sektor tidak berubah', function () {
+    Http::fake([
+        '*/api/v1/dataspasial/skema' => Http::response([
+            'success' => true,
+            'data' => ['type' => 'ds_skema_versi', 'id' => '9'],
+        ], 201),
+        '*' => Http::response(['data' => []], 200),
+    ]);
+
+    $this->postJson(route('dataspasial.skema.draf.store'), [
+        'sektor' => 'pendidikan',
+        'sektor_nama' => 'Pendidikan Dasar',
+        'isian' => [[
+            'kode' => 'jumlah_siswa',
+            'label' => 'Jumlah Siswa',
+            'tipe' => 'angka',
+            'wajib' => true,
+            'urutan' => 1,
+            'popupPeta' => false,
+            'sebagaiFilter' => false,
+            'sebagaiIndikator' => false,
+        ]],
+    ])->assertOk()->assertJsonPath('success', true);
+
+    Http::assertSent(function ($request) {
+        $body = json_decode((string) $request->body(), true);
+
+        return str_ends_with($request->url(), '/api/v1/dataspasial/skema')
+            && ($body['sektor'] ?? null) === 'pendidikan'
+            && ($body['sektor_nama'] ?? null) === 'Pendidikan Dasar';
+    });
+});
+
+it('menolak nama sektor kosong sebelum permintaan dikirim', function () {
+    // FR-007f — nama kosong ditolak di layar, tanpa request.
+    Http::fake();
+
+    $this->postJson(route('dataspasial.skema.draf.store'), [
+        'sektor' => 'pendidikan',
+        'sektor_nama' => '   ',
+        'isian' => [[
+            'kode' => 'jumlah_siswa',
+            'label' => 'Jumlah Siswa',
+            'tipe' => 'angka',
+            'urutan' => 1,
+        ]],
+    ])->assertStatus(422)->assertJsonValidationErrors('sektor_nama');
+
+    Http::assertNothingSent();
+});
+
+it('menampilkan pesan generik dan menjaga isi editor saat nama sektor bentrok', function () {
+    Http::fake([
+        '*/api/v1/dataspasial/skema' => Http::response([
+            'success' => false,
+            'message' => 'Validasi gagal.',
+            'errors' => ['sektor_nama' => ['Nama sektor sudah dipakai sektor lain.']],
+        ], 422),
+        '*' => Http::response(['data' => []], 200),
+    ]);
+
+    // FR-007f/Q13 — keunikan nama adalah tanggung jawab API; pesan teknis tidak
+    // dibocorkan ke pengguna (FR-038) dan isi editor tetap utuh (FR-041b).
+    $this->postJson(route('dataspasial.skema.draf.store'), [
+        'sektor' => 'pendidikan',
+        'sektor_nama' => 'Kesehatan',
+        'isian' => [[
+            'kode' => 'jumlah_siswa',
+            'label' => 'Jumlah Siswa',
+            'tipe' => 'angka',
+            'urutan' => 1,
+        ]],
+    ])->assertStatus(503)->assertJsonPath('success', false);
+});
+
+// ---------------------------------------------------------------------------
+// Label versi terakhir + status pada daftar sektor (FR-007, Q22/SC-013)
+// ---------------------------------------------------------------------------
+
+/**
+ * Ambil teks badge status versi terakhir dari HTML panel sektor.
+ */
+function badgeStatusSektor(string $content): ?string
+{
+    return preg_match('/data-testid="label-status-versi-sektor">([^<]*)</', $content, $m) === 1
+        ? trim($m[1])
+        : null;
+}
+
+/**
+ * Ambil nomor versi terakhir dari badge `v{n}` (null bila belum ada skema).
+ */
+function badgeNomorVersiSektor(string $content): ?string
+{
+    return preg_match('/data-testid="label-nomor-versi-sektor">\s*v(\d+)/', $content, $m) === 1
+        ? $m[1]
+        : null;
+}
+
+it('menampilkan nomor versi terakhir dan status draf pada daftar sektor', function () {
+    // 3 versi, hanya 1 yang terbit → versi terakhir (3) masih berupa draf.
+    fakeEndpointEditor([fxSektor('1', 'pendidikan', 'Pendidikan', 3, 1)]);
+
+    $content = $this->get(route('dataspasial.skema'))->assertOk()->getContent();
+
+    expect(badgeStatusSektor($content))->toBe('Draf')
+        ->and(badgeNomorVersiSektor($content))->toBe('3');
+});
+
+it('menampilkan nomor versi terakhir dan status terbit pada daftar sektor', function () {
+    // 3 versi, semuanya terbit → versi terakhir (3) berstatus terbit.
+    fakeEndpointEditor([fxSektor('1', 'pendidikan', 'Pendidikan', 3, 3)]);
+
+    $content = $this->get(route('dataspasial.skema'))->assertOk()->getContent();
+
+    expect(badgeStatusSektor($content))->toBe('Terbit')
+        ->and(badgeNomorVersiSektor($content))->toBe('3');
+});
+
+it('menampilkan belum ada skema tanpa nomor versi pada daftar sektor', function () {
+    fakeEndpointEditor([fxSektor('1', 'pendidikan', 'Pendidikan', 0, 0)]);
+
+    $content = $this->get(route('dataspasial.skema'))->assertOk()->getContent();
+
+    expect(badgeStatusSektor($content))->toBe('Belum ada skema')
+        ->and(badgeNomorVersiSektor($content))->toBeNull();
+});
+
+it('tidak menampilkan jumlah versi pada daftar sektor', function () {
+    fakeEndpointEditor([fxSektor('1', 'pendidikan', 'Pendidikan', 3, 3)]);
+
+    $content = $this->get(route('dataspasial.skema'))->assertOk()->getContent();
+
+    // ⚠️ Informasi "3 versi" dihapus; yang tampil hanya nomor versi terakhir (v3).
+    expect($content)->not->toContain(' versi<')
+        ->and(badgeNomorVersiSektor($content))->toBe('3');
+});
diff --git a/tests/Feature/DataSpasial/SkemaEditorSumberNilaiTest.php b/tests/Feature/DataSpasial/SkemaEditorSumberNilaiTest.php
new file mode 100644
index 00000000..dd664a3c
--- /dev/null
+++ b/tests/Feature/DataSpasial/SkemaEditorSumberNilaiTest.php
@@ -0,0 +1,399 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Models\Setting;
+use App\Services\SkemaEditorService;
+use Illuminate\Foundation\Testing\DatabaseTransactions;
+use Illuminate\Http\Client\Request;
+use Illuminate\Support\Facades\Cache;
+use Illuminate\Support\Facades\Http;
+
+uses(DatabaseTransactions::class);
+
+/**
+ * US4 / Q20 — Pemilihan sumber nilai per isian (FR-022 … FR-025).
+ *
+ * Skenario:
+ *  #1 tombol sumber nilai membuka modal (bukan terikat pemetaan lama) — Q20
+ *  #2 mode "sektor baru" adalah keadaan MENYUNTING (FR-008f)
+ *  #3 template baris kosong selalu tersedia agar Tambah Isian Baru berfungsi
+ */
+beforeEach(function () {
+    config([
+        'app.databaseGabunganUrl' => 'https://api.example.test',
+        'dataspasial.cache_ttl' => 300,
+    ]);
+
+    Cache::flush();
+
+    Setting::updateOrCreate(
+        ['key' => 'database_gabungan_api_key'],
+        ['name' => 'API Key', 'value' => 'token-uji']
+    );
+
+    $this->adminSkema = makeRole('admin skema sumber nilai', [
+        'dataspasial-skema-read',
+        'dataspasial-skema-write',
+    ]);
+
+    test()->actingAs($this->adminSkema, 'web');
+});
+
+it('menyediakan tombol sumber nilai pada setiap baris isian', function () {
+    Http::fake([
+        '*/api/v1/config/*' => Http::response(['data' => []], 200),
+        '*/api/v1/dataspasial/sektor*' => Http::response(['data' => [[
+            'type' => 'daftar sektor',
+            'id' => '1',
+            'attributes' => ['kode' => 'pendidikan', 'nama' => 'Pendidikan', 'status' => 'aktif'],
+        ]]], 200),
+        '*/api/v1/dataspasial/skema?sektor=pendidikan' => Http::response(['data' => [[
+            'type' => 'skema data spasial',
+            'id' => '9',
+            'attributes' => [
+                'sektor' => ['id' => 1, 'kode' => 'pendidikan', 'nama' => 'Pendidikan'],
+                'versi_skema' => ['id' => 9, 'nomor_versi' => 1, 'status' => 'draf'],
+                'isian' => [[
+                    'kode' => 'jumlah_siswa',
+                    'label' => 'Jumlah Siswa',
+                    'tipe' => 'angka',
+                    'wajib' => true,
+                    'urutan' => 1,
+                    'tampil_popup' => false,
+                    'tampil_filter' => false,
+                    'tampil_indikator' => false,
+                    'pemetaan' => [],
+                ]],
+            ],
+        ]]], 200),
+        '*' => Http::response(['data' => []], 200),
+    ]);
+
+    $content = $this->get(route('dataspasial.skema', ['sektor' => 'pendidikan']))
+        ->assertOk()
+        ->getContent();
+
+    // Tombol sumber nilai + modal Choosing Manual/Otomatis (Q20, FR-022).
+    expect($content)
+        ->toContain('btn-pilih-sumber-baris')
+        ->toContain('data-sumber="manual"')
+        ->toContain('data-tabel-sumber')
+        ->toContain('data-kolom-sumber');
+});
+
+it('menyediakan template baris kosong agar tombol tambah isian berfungsi pada mode penyuntingan', function () {
+    Http::fake([
+        '*/api/v1/config/*' => Http::response(['data' => []], 200),
+        '*/api/v1/dataspasial/sektor*' => Http::response(['data' => [[
+            'type' => 'daftar sektor',
+            'id' => '1',
+            'attributes' => ['kode' => 'pendidikan', 'nama' => 'Pendidikan', 'status' => 'aktif'],
+        ]]], 200),
+        '*/api/v1/dataspasial/skema?sektor=pendidikan' => Http::response(['data' => [[
+            'type' => 'skema data spasial',
+            'id' => '9',
+            'attributes' => [
+                'sektor' => ['id' => 1, 'kode' => 'pendidikan', 'nama' => 'Pendidikan'],
+                'versi_skema' => ['id' => 9, 'nomor_versi' => 2, 'status' => 'terbit'],
+                'isian' => [[
+                    'kode' => 'jumlah_siswa',
+                    'label' => 'Jumlah Siswa',
+                    'tipe' => 'angka',
+                    'urutan' => 1,
+                    'pemetaan' => [],
+                ]],
+            ],
+        ]]], 200),
+        '*' => Http::response(['data' => []], 200),
+    ]);
+
+    $content = $this->get(route('dataspasial.skema', ['sektor' => 'pendidikan']))
+        ->assertOk()
+        ->getContent();
+
+    // ⚠️ Template WAJIB ada walau skema `terbit` — tanpa itu handler Tambah
+    // Isian bail-out dan tombol tampak tidak berfungsi (FR-008c/FR-008f).
+    expect($content)
+        ->toContain('id="template-baris-isian"')
+        ->toContain('id="btn-tambah-isian"')
+        ->toContain('id="btn-ubah"');
+});
+
+it('menyimpan sumber nilai otomatis beserta tabel dan kolomnya', function () {
+    Http::fake([
+        '*/api/v1/dataspasial/skema' => Http::response([
+            'success' => true,
+            'data' => ['type' => 'ds_skema_versi', 'id' => '9'],
+        ], 201),
+        '*' => Http::response(['data' => []], 200),
+    ]);
+
+    $this->postJson(route('dataspasial.skema.draf.store'), [
+        'sektor' => 'pendidikan',
+        'sektor_nama' => 'Pendidikan',
+        'isian' => [[
+            'kode' => 'jumlah_siswa',
+            'label' => 'Jumlah Siswa',
+            'tipe' => 'angka',
+            'urutan' => 1,
+            'sumber' => 'openSID',
+            'tabelSumber' => 'posyandu',
+            'kolomSumber' => 'jenis',
+        ]],
+    ])->assertOk()->assertJsonPath('success', true);
+
+    Http::assertSent(function ($request) {
+        $body = json_decode((string) $request->body(), true);
+        $pemetaan = $body['isian'][0]['pemetaan'] ?? [];
+
+        return str_ends_with($request->url(), '/api/v1/dataspasial/skema')
+            && ($pemetaan[0]['sumber'] ?? null) === 'openSID'
+            // ⚠️ Entitas `ds_pemetaan` hanya punya SATU kolom `rujukan_sumber`
+            // berbentuk "tabel.kolom" (§6a.4) — bukan `tabel_sumber`/
+            // `kolom_sumber` terpisah.
+            && ($pemetaan[0]['rujukan_sumber'] ?? null) === 'posyandu.jenis';
+    });
+});
+
+it('menyediakan kolom nama sektor walau belum ada sektor yang dipilih', function () {
+    // Regresi FR-008f/Q26 — saat "Tambah Sektor Baru" ditekan tanpa pernah
+    // memilih sektor, kolom nama sektor WAJIB ada di DOM (dibuka oleh JS).
+    // Bila hanya dirender bila `$sektorTerpilih`, modal/mode ini tidak punya
+    // kolom untuk diisi sehingga layar tampak tidak berubah sama sekali.
+    Http::fake([
+        '*/api/v1/config/*' => Http::response(['data' => []], 200),
+        '*/api/v1/dataspasial/sektor*' => Http::response(['data' => [[
+            'type' => 'daftar sektor',
+            'id' => '1',
+            'attributes' => ['kode' => 'pendidikan', 'nama' => 'Pendidikan', 'status' => 'aktif'],
+        ]]], 200),
+        '*' => Http::response(['data' => []], 200),
+    ]);
+
+    $content = $this->get(route('dataspasial.skema'))
+        ->assertOk()
+        ->getContent();
+
+    expect($content)
+        ->toContain('id="wadah-input-sektor-nama"')
+        ->toContain('id="input-sektor-nama-editor"')
+        ->toContain('id="btn-tambah-sektor"')
+        // Pesan keadaan kosong tetap ada sebagai konteks awal.
+        ->toContain('isian-belum-pilih-sektor');
+});
+
+it('menyembunyikan kolom nama sektor pada keadaan awal tanpa sektor terpilih', function () {
+    Http::fake([
+        '*/api/v1/config/*' => Http::response(['data' => []], 200),
+        '*/api/v1/dataspasial/sektor*' => Http::response(['data' => [[
+            'type' => 'daftar sektor',
+            'id' => '1',
+            'attributes' => ['kode' => 'pendidikan', 'nama' => 'Pendidikan', 'status' => 'aktif'],
+        ]]], 200),
+        '*' => Http::response(['data' => []], 200),
+    ]);
+
+    $content = $this->get(route('dataspasial.skema'))->assertOk()->getContent();
+
+    // Kolom TETAP ada di DOM namun tersembunyi sampai mode "sektor baru" aktif.
+    preg_match('/<div[^>]*id="wadah-input-sektor-nama"[^>]*>/', $content, $m);
+    expect($m)->not->toBeEmpty();
+    expect($m[0])->toContain('d-none');
+});
+
+// ---------------------------------------------------------------------------
+// rujukan_sumber — pemetaan baca ↔ tulis (verified §6a.4)
+// ---------------------------------------------------------------------------
+
+it('memecah rujukan_sumber menjadi tabel dan kolom untuk ditampilkan', function () {
+    $service = app(SkemaEditorService::class);
+
+    $isian = $service->petakanIsian([
+        'id' => '8484',
+        'attributes' => [
+            'kode' => 'lebar_jalan',
+            'label' => 'Lebar Jalan',
+            'tipe' => 'angka',
+            'urutan' => 1,
+            // ⚠️ Bentuk nyata API: `rujukan_sumber` berupa "tabel.kolom".
+            'pemetaan' => [[
+                'id' => '3951',
+                'sumber' => 'openSID',
+                'rujukan_sumber' => 'tbl_jalan.lebar',
+            ]],
+        ],
+    ]);
+
+    expect($isian['sumber'])->toBe('openSID')
+        ->and($isian['rujukan'])->toBe('tbl_jalan.lebar')
+        ->and($isian['tabelSumber'])->toBe('tbl_jalan')
+        ->and($isian['kolomSumber'])->toBe('lebar');
+});
+
+it('mempertahankan rujukan bertingkat tanpa merusak nilai saat disimpan kembali', function () {
+    $service = app(SkemaEditorService::class);
+
+    $isian = $service->petakanIsian([
+        'id' => '1',
+        'attributes' => [
+            'kode' => 'kota',
+            'label' => 'Kota',
+            'tipe' => 'teks',
+            'urutan' => 1,
+            'pemetaan' => [[
+                'sumber' => 'impor',
+                // Berisi lebih dari satu titik — pemecahan memakai titik terakhir
+                // supaya nilainya pulih utuh saat disambung kembali.
+                'rujukan_sumber' => 'ds_ref.kota.nama',
+            ]],
+        ],
+    ]);
+
+    $payload = $service->composeDrafPayload([$isian], [
+        'sektor' => 'pendidikan',
+        'sektor_nama' => 'Pendidikan',
+    ]);
+
+    expect($isian['tabelSumber'])->toBe('ds_ref.kota')
+        ->and($isian['kolomSumber'])->toBe('nama')
+        ->and($payload['isian'][0]['pemetaan'][0]['rujukan_sumber'])->toBe('ds_ref.kota.nama');
+});
+
+it('menyimpan pemetaan memakai satu nilai rujukan_sumber dari rujukan', function () {
+    $service = app(SkemaEditorService::class);
+
+    $payload = $service->composeDrafPayload([[
+        'kode' => 'lebar_jalan',
+        'label' => 'Lebar Jalan',
+        'tipe' => 'angka',
+        'wajib' => false,
+        'sumber' => 'openSID',
+        'rujukan' => 'tbl_jalan.lebar',
+    ]], ['sektor' => 'pendidikan', 'sektor_nama' => 'Pendidikan']);
+
+    $pemetaan = $payload['isian'][0]['pemetaan'];
+
+    expect($pemetaan)->toHaveCount(1)
+        ->and($pemetaan[0]['sumber'])->toBe('openSID')
+        ->and($pemetaan[0]['rujukan_sumber'])->toBe('tbl_jalan.lebar')
+        // ⚠️ API hanya punya `rujukan_sumber` — tidak ada `tabel_sumber`/
+        // `kolom_sumber` terpisah (§6a.4).
+        ->and($pemetaan[0])->not->toHaveKey('tabel_sumber')
+        ->and($pemetaan[0])->not->toHaveKey('kolom_sumber');
+});
+
+it('menyambung tabel dan kolom menjadi rujukan_sumber bila klien tidak mengirim rujukan', function () {
+    $service = app(SkemaEditorService::class);
+
+    $payload = $service->composeDrafPayload([[
+        'kode' => 'lebar_jalan',
+        'label' => 'Lebar Jalan',
+        'tipe' => 'angka',
+        'sumber' => 'dataPresisi',
+        'tabelSumber' => 'tbl_jalan',
+        'kolomSumber' => 'lebar',
+    ]], ['sektor' => 'pendidikan', 'sektor_nama' => 'Pendidikan']);
+
+    expect($payload['isian'][0]['pemetaan'][0]['rujukan_sumber'])->toBe('tbl_jalan.lebar');
+});
+
+it('tidak mengirim pemetaan bila sumber nilai manual', function () {
+    $service = app(SkemaEditorService::class);
+
+    $payload = $service->composeDrafPayload([[
+        'kode' => 'keterangan',
+        'label' => 'Keterangan',
+        'tipe' => 'teks',
+        'sumber' => 'manual',
+    ]], ['sektor' => 'pendidikan', 'sektor_nama' => 'Pendidikan']);
+
+    expect($payload['isian'][0]['pemetaan'])->toBeNull();
+});
+
+it('menolak sumber nilai otomatis tanpa rujukan', function () {
+    $payload = [
+        'sektor_nama' => 'Pendidikan',
+        'isian' => [[
+            'kode' => 'lebar_jalan',
+            'label' => 'Lebar Jalan',
+            'tipe' => 'angka',
+            'wajib' => false,
+            'urutan' => 1,
+            'sumber' => 'openSID',
+        ]],
+    ];
+
+    $this->postJson(route('dataspasial.skema.draf.store'), $payload)
+        ->assertStatus(422)
+        ->assertJsonValidationErrors('isian.0.rujukan');
+});
+
+it('menerima sumber nilai otomatis beserta rujukannya', function () {
+    Http::fake([
+        '*' => Http::response(['data' => ['id' => '9', 'attributes' => ['kode' => 'pendidikan']]], 201),
+    ]);
+
+    $this->postJson(route('dataspasial.skema.draf.store'), [
+        'sektor' => 'pendidikan',
+        'sektor_nama' => 'Pendidikan',
+        'isian' => [[
+            'kode' => 'lebar_jalan',
+            'label' => 'Lebar Jalan',
+            'tipe' => 'angka',
+            'wajib' => false,
+            'urutan' => 1,
+            'sumber' => 'openSID',
+            'rujukan' => 'tbl_jalan.lebar',
+        ]],
+    ])->assertOk();
+
+    Http::assertSent(function (Request $request): bool {
+        $isi = $request->data();
+
+        return ($isi['isian'][0]['pemetaan'][0]['rujukan_sumber'] ?? null) === 'tbl_jalan.lebar';
+    });
+});
+
+it('menampilkan tabel dan kolom hasil pemecahan rujukan_sumber pada baris isian', function () {
+    fakeEndpointEditor(
+        [fxSektor('1', 'pendidikan', 'Pendidikan', 1, 1)],
+        [],
+        [
+            'data' => [[
+                'type' => 'ds_skema_versi',
+                'id' => '9',
+                'attributes' => [
+                    'sektor' => ['id' => '1', 'kode' => 'pendidikan', 'nama' => 'Pendidikan'],
+                    'versi_skema' => ['id' => '9', 'nomor_versi' => 1, 'status' => 'terbit'],
+                    'isian' => [fxIsian('lebar_jalan', [
+                        'id' => '8484',
+                        'label' => 'Lebar Jalan',
+                        'tipe' => 'angka',
+                        'satuan' => 'meter',
+                        'pemetaan' => [[
+                            'id' => '3951',
+                            'sumber' => 'openSID',
+                            // ⚠️ Bentuk nyata API — satu string "tabel.kolom" (§6a.4).
+                            'rujukan_sumber' => 'tbl_jalan.lebar',
+                        ]],
+                    ])],
+                ],
+            ]],
+        ],
+    );
+
+    $content = $this->get(route('dataspasial.skema', ['sektor' => 'pendidikan']))
+        ->assertOk()
+        ->getContent();
+
+    // ⚠️ Kedua kolom harus terisi dari `rujukan_sumber` — inilah yang membuat
+    // modal sumber nilai terbuka pada nilai lama saat diklik lagi.
+    expect($content)
+        ->toContain('data-tabel-sumber="tbl_jalan"')
+        ->toContain('data-kolom-sumber="lebar"')
+        ->toContain('data-rujukan="tbl_jalan.lebar"')
+        // Skema `terbit` bersifat baca-saja, jadi rujukan ditampilkan sebagai
+        // teks "tabel.kolom" alih-alih dua input (FR-008a).
+        ->toMatch('/text-muted small d-block">\s*tbl_jalan\.lebar\s*<\/span>/');
+});
diff --git a/tests/Feature/DataSpasial/SkemaEditorTerbitTest.php b/tests/Feature/DataSpasial/SkemaEditorTerbitTest.php
new file mode 100644
index 00000000..ad78c5f8
--- /dev/null
+++ b/tests/Feature/DataSpasial/SkemaEditorTerbitTest.php
@@ -0,0 +1,196 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Models\Setting;
+use Illuminate\Foundation\Testing\DatabaseTransactions;
+use Illuminate\Http\Client\Request;
+use Illuminate\Support\Facades\Cache;
+use Illuminate\Support\Facades\Http;
+
+uses(DatabaseTransactions::class);
+
+/**
+ * US8 — Menerbitkan draf skema (FR-041 … FR-045).
+ *
+ * Skenario yang diuji (spec.md US8):
+ *  #1 tombol Terbitan aktif saat skema berstatus draf
+ *  #2 konfirmasi menyebut nama sektor & nomor versi (FR-042)
+ *  #4 skema `terbit` → tombol nonaktif & isian baca-saja
+ *  #5 sumber data tidak tersedia → tombol nonaktif
+ *  #6 tombol nonaktif bila ada perubahan belum disimpan (FR-045)
+ *  plus penerbitan sukses → versi `terbit`
+ *
+ * ⚠️ **UTANG KONTRAK U6** — `POST /dataspasial/skema/{sektor}/terbit` belum ada
+ * di kontrak v0.1.0 maupun API hidup. `{sektor}` adalah **kode** sektor.
+ */
+beforeEach(function () {
+    config([
+        'app.databaseGabunganUrl' => 'https://api.example.test',
+        'dataspasial.cache_ttl' => 300,
+    ]);
+
+    Cache::flush();
+
+    Setting::updateOrCreate(
+        ['key' => 'database_gabungan_api_key'],
+        ['name' => 'API Key', 'value' => 'token-uji']
+    );
+
+    $this->adminSkema = makeRole('admin skema us8', [
+        'dataspasial-skema-read',
+        'dataspasial-skema-write',
+        'dataspasial-skema-edit',
+        'dataspasial-skema-delete',
+    ]);
+
+    test()->actingAs($this->adminSkema, 'web');
+});
+
+/**
+ * Pasang stub HTTP halaman editor + endpoint terbitan.
+ *
+ * ⚠️ `Http::fake()` bersifat FIFO dan awalan `POST ` diperlakukan sebagai glob
+ * (bukan filter method), sehingga pemisahan dilakukan di dalam closure.
+ *
+ * @see SkemaEditorEditSektorTest.php untuk penjelasan lengkap.
+ *
+ * @param  array<int, array<string, mixed>>  $riwayat
+ */
+function fakeTerbit(?int $statusTerbit = null, ?array $riwayat = null, string $statusAktif = 'draf'): void
+{
+    $riwayat ??= [fxRiwayatVersi('901', 101, 1, 'draf')];
+    $nomorVersi = (int) ($riwayat[0]['attributes']['nomor_versi'] ?? 1);
+
+    Http::fake([
+        '*/api/v1/dataspasial/skema/*/terbit' => function (Request $request) use ($statusTerbit) {
+            if ($request->method() !== 'POST') {
+                return Http::response(['data' => []], 200);
+            }
+
+            return $statusTerbit === null
+                ? Http::response([
+                    'data' => ['id' => '902', 'type' => 'skema', 'attributes' => [
+                        'versi_skema' => ['nomor_versi' => 1, 'status' => 'terbit'],
+                    ]],
+                ], 200)
+                : Http::response(['message' => 'Gagal'], $statusTerbit);
+        },
+        '*/api/v1/config/*' => Http::response(fakeConfigEndpoint(), 200),
+        '*/api/v1/dataspasial/sektor*' => Http::response(
+            fakeKoleksi([fxSektor('101', 'pendidikan', 'Pendidikan')]), 200
+        ),
+        '*/api/v1/dataspasial/skema/riwayat*' => Http::response(fakeKoleksi($riwayat), 200),
+        '*/api/v1/dataspasial/skema?*' => Http::response(
+            fxSkemaAktif('101', 101, 'pendidikan', 'Pendidikan', $nomorVersi, $statusAktif, [fxIsian('jumlah_siswa')]),
+            200
+        ),
+        '*' => Http::response(['data' => []], 200),
+    ]);
+}
+
+// -----------------------------------------------------------------------
+// US8 #1 — tombol aktif saat draf (FR-041)
+// -----------------------------------------------------------------------
+
+it('mengaktifkan tombol terbitkan saat skema berstatus draf', function () {
+    fakeTerbit();
+
+    $response = $this->get(route('dataspasial.skema', ['sektor' => 'pendidikan']));
+
+    $response->assertOk();
+
+    // Tombol TIDAK lagi memakai atribut `disabled` statis.
+    preg_match('/<button[^>]*id="btn-terbitan"[^>]*>/', $response->getContent(), $m);
+    expect($m)->not->toBeEmpty('Tombol Terbitan tidak dirender');
+    expect($m[0])->not->toContain('disabled');
+});
+
+it('tidak menyertakan catatan KAB-03 pada tombol terbitkan', function () {
+    fakeTerbit();
+
+    $response = $this->get(route('dataspasial.skema', ['sektor' => 'pendidikan']));
+
+    $response->assertDontSee('KAB-03');
+});
+
+// -----------------------------------------------------------------------
+// US8 #4 — skema terbit → nonaktif (FR-008a)
+// -----------------------------------------------------------------------
+
+it('menonaktifkan tombol terbitkan ketika skema sudah terbit', function () {
+    fakeTerbit(riwayat: [fxRiwayatVersi('901', 101, 3, 'terbit')], statusAktif: 'terbit');
+
+    $response = $this->get(route('dataspasial.skema', ['sektor' => 'pendidikan']));
+
+    $response->assertOk();
+    preg_match('/<button[^>]*id="btn-terbitan"[^>]*>/', $response->getContent(), $m);
+    expect($m)->not->toBeEmpty();
+    expect($m[0])->toContain('disabled');
+});
+
+// -----------------------------------------------------------------------
+// US8 #2 — penerbitan sukses
+// -----------------------------------------------------------------------
+
+it('menerbitkan draf memakai kode sektor pada path', function () {
+    fakeTerbit(riwayat: [fxRiwayatVersi('902', 101, 1, 'terbit')]);
+
+    $response = $this->from(route('dataspasial.skema', ['sektor' => 'pendidikan']))
+        ->post(route('dataspasial.skema.terbit'), [
+            'sektor' => 'pendidikan',
+            'skema' => 901,
+            'catatan_perubahan' => 'Versi 1 terbit',
+        ]);
+
+    // Setelah terbit, editor diarahkan ke versi yang baru terbit.
+    $response->assertRedirect(route('dataspasial.skema', [
+        'sektor' => 'pendidikan',
+        'skema' => 902,
+    ]));
+    $response->assertSessionHas('success');
+
+    // ⚠️ `{sektor}` pada path adalah KODE sektor, bukan id numerik.
+    Http::assertSent(function (Request $request): bool {
+        return $request->method() === 'POST'
+            && str_ends_with($request->url(), '/dataspasial/skema/pendidikan/terbit');
+    });
+});
+
+it('menampilkan data sementara tidak tersedia saat endpoint terbitan 404', function () {
+    fakeTerbit(404);
+
+    $this->from(route('dataspasial.skema', ['sektor' => 'pendidikan']))
+        ->post(route('dataspasial.skema.terbit'), [
+            'sektor' => 'pendidikan',
+            'skema' => 901,
+        ])
+        ->assertSessionHas('error', fn (string $m): bool => str_contains($m, 'tidak tersedia'));
+});
+
+it('menampilkan data sementara tidak tersedia saat endpoint terbitan 405', function () {
+    fakeTerbit(405);
+
+    $this->from(route('dataspasial.skema', ['sektor' => 'pendidikan']))
+        ->post(route('dataspasial.skema.terbit'), [
+            'sektor' => 'pendidikan',
+            'skema' => 901,
+        ])
+        ->assertSessionHas('error');
+});
+
+// -----------------------------------------------------------------------
+// Otorisasi (FR-001)
+// -----------------------------------------------------------------------
+
+it('menolak peran tanpa izin tulis saat menerbitkan', function () {
+    fakeTerbit();
+
+    $operator = makeRole('operator impor us8', ['dataspasial-skema-read']);
+    test()->actingAs($operator, 'web');
+
+    $this->post(route('dataspasial.skema.terbit'), [
+        'sektor' => 'pendidikan',
+        'skema' => 901,
+    ])->assertForbidden();
+});
diff --git a/tests/Pest.php b/tests/Pest.php
index fe001d9e..0b35ad14 100644
--- a/tests/Pest.php
+++ b/tests/Pest.php
@@ -4,6 +4,14 @@
 
 uses(TestCase::class)->in('Feature', 'Browser');
 
+// Fixture bersama editor skema (KAB-02). Berisi SALINAN PERSIS respons API
+// Satu Data yang nyata — `openapi-fondasi.yaml` v0.1.0 tidak cocok dengan
+// implementasi. Lihat specs/004-pengelola-skema-editor/contracts/skema-editor-api.md §6a.
+//
+// PSR-4 tidak meng-autoload fungsi biasa, jadi berkas ini di-require manual.
+// Bukan test (tidak berakhiran `Test.php`) sehingga runner tidak mengambilnya.
+require_once __DIR__.'/Feature/DataSpasial/Fixtures.php';
+
 pest()->browser()->timeout(30000);
 
 beforeEach(function () {
diff --git a/tests/TestCase.php b/tests/TestCase.php
index 7cbb2436..fa93f81c 100644
--- a/tests/TestCase.php
+++ b/tests/TestCase.php
@@ -2,11 +2,12 @@
 
 namespace Tests;
 
+use Illuminate\Foundation\Testing\DatabaseTransactions;
 use Illuminate\Foundation\Testing\TestCase as BaseTestCase;
 
 abstract class TestCase extends BaseTestCase
 {
-    use CreatesApplication;
+    use CreatesApplication, DatabaseTransactions;
 
     public function actingAsAdmin($admin)
     {