feat: detail statistik kesehatan

[pandigresik]

Pull Request: Feature: Detail Statistik Kesehatan - Halaman Detail Data Presisi Kesehatan

Deskripsi

PR ini menambahkan halaman detail data presisi kesehatan yang memungkinkan pengguna untuk melihat data individual kesehatan berdasarkan filter kategori statistik. Sebelumnya, halaman statistik kesehatan tidak memiliki link detail yang berfungsi (detailLink kosong), sehingga pengguna tidak bisa menelusuri data individual dari agregat statistik. PR ini mengimplementasikan fitur drill-down dari tabel statistik ke detail data per record, mengikuti pola yang sudah ada pada modul data presisi lainnya (Pendidikan, Ketenagakerjaan, dll).

Depedency

https://github.com/OpenSID/API-Database-Gabungan/pull/398

Perubahan yang dilakukan:

1. Fitur Baru - Controller: Menambahkan method detailData() pada DataPresisiKesehatanController yang menangani request halaman detail data kesehatan, termasuk sanitasi input judul dan pembentukan parameter filter colomn dari filter[tipe] dan filter[nilai]
2. Fitur Baru - Form Request: Menambahkan DetailDataKesehatanRequest untuk validasi input pada endpoint detail data (judul, filter, filter.tipe, filter.nilai, tipe)
3. Fitur Baru - View: Menambahkan view baru detail_data.blade.php yang menampilkan DataTable server-side dengan 14 kolom data kesehatan (NIK, No KK, Nama, Jenis Asuransi, Alat Kontrasepsi, Penyakit, Kunjungan Faskes, Rawat Inap, Kunjungan Dokter, Kondisi Fisik, Status Gizi, Tanggal Pengisian, Status Pengisian)
4. Perbaikan - Controller Statistik: Mengubah StatistikKesehatanController - mengisi detailLink dari url('') (kosong) menjadi url('data-presisi/kesehatan/detail_data') serta menambahkan return type hint \Illuminate\View\View
5. Perbaikan - View Statistik: Memperbarui kesehatan.blade.php - menambahkan variabel tipeValue dan judulUtama untuk tracking kategori aktif, menambahkan parameter filter[tipe] dan tahun pada URL detail link di kolom Nilai dan Jumlah, serta menghubungkan SEMUA nilai jumlah ke halaman detail (sebelumnya JUMLAH/BELUM MENGISI/TOTAL tidak memiliki link)
6. Fitur Baru - Route: Menambahkan route GET /kesehatan/detail_data pada routes/web.php dengan middleware permission:datapresisi-kesehatan-read
7. Refactor - Code Style: Perbaikan indentasi dan formatting pada view statistik kesehatan (dari 4-space indent menjadi tanpa indent untuk konsistensi)

Alasan perubahan:

• Poin 1: Halaman statistik kesehatan sebelumnya tidak memiliki link detail yang berfungsi (detailLink kosong), sehingga pengguna tidak bisa melihat data individual dari agregat statistik
• Poin 2: Modul data presisi lainnya (Pendidikan, Ketenagakerjaan, Aktivitas Keagamaan) sudah memiliki fitur detail data, sehingga modul Kesehatan perlu diselaraskan (parity)
• Poin 3: Penambahan parameter filter[tipe] pada URL detail memungkinkan filtering yang lebih akurat di halaman detail, tidak hanya berdasarkan nilai tetapi juga berdasarkan tipe/kategori statistik
• Poin 4: Validasi input melalui Form Request (DetailDataKesehatanRequest) meningkatkan keamanan endpoint baru dari input yang tidak diharapkan

Dampak perubahan:

✅ Fungsionalitas: Pengguna dapat mengklik nilai pada tabel statistik kesehatan untuk melihat detail data individual
✅ Konsistensi: Modul kesehatan sekarang memiliki fitur yang sama dengan modul data presisi lainnya
✅ Keamanan: Input divalidasi melalui Form Request dan judul disanitasi dengan htmlspecialchars(strip_tags())
✅ Filtering: Parameter filter[tipe] dan filter[nilai] diteruskan ke API untuk filtering data yang akurat
⚠️ Perhatian: Semua nilai jumlah sekarang memiliki link ke detail (termasuk JUMLAH/BELUM MENGISI/TOTAL), berbeda dari perilaku sebelumnya yang tidak memberikan link pada nilai-nilai tersebut

Masalah Terkait (Related Issue)

• Solusi untuk perbaikan terkait issue Buat Halaman Detail Kesehatan di Statistik Presisi #998

https://github.com/OpenSID/API-Database-Gabungan/issues/998

Langkah untuk mereproduksi (Steps to Reproduce)

Sebelum perbaikan (masalah):

1. Login ke aplikasi dan navigasi ke menu Data Pokok → Data Presisi → Kesehatan
2. Klik salah satu kategori statistik di sidebar kiri (misal: "Jenis Asuransi")
3. Perhatikan kolom Nilai dan Jumlah pada tabel statistik
4. Klik pada nilai jumlah di tabel
5. ❌ Link tidak mengarah ke halaman detail manapun (detailLink kosong/url('')), atau link tidak membawa parameter filter yang cukup

Setelah perbaikan (fix):

1. Login ke aplikasi dan navigasi ke menu Data Pokok → Data Presisi → Kesehatan
2. Klik salah satu kategori statistik di sidebar kiri (misal: "Jenis Asuransi")
3. Perhatikan kolom Nilai dan Jumlah pada tabel statistik - keduanya sekarang memiliki link
4. Klik pada nilai jumlah di tabel
5. ✅ Halaman detail data kesehatan terbuka di tab baru, menampilkan data individual yang difilter berdasarkan kategori dan nilai yang diklik, dengan filter tahun yang diteruskan

Testing pada fitur lain yang terkait:

• Data Presisi Kesehatan - Halaman Index ✅ Tidak terpengaruh
• Data Presisi Kesehatan - Halaman Cetak ✅ Tidak terpengaruh
• Data Presisi Kesehatan - Halaman Detail (existing) ✅ Tidak terpengaruh
• Statistik Kesehatan - Grafik Bar/Pie ✅ Tidak terpengaruh
• Statistik Kesehatan - Export Excel ✅ Tidak terpengaruh

Daftar Periksa (Checklist)

• Saya telah mematuhi aturan penulisan script.
• Saya telah mengikuti proses review pull request.
• Saya telah membuat [unit test/integration test] untuk memverifikasi perbaikan
• Testing manual telah dilakukan di environment development
• Tidak ada console error atau warning
• Code sudah di-review oleh [minimal 1 orang]

Teknis Detail

Penjelasan Teknis

Alur data detail statistik kesehatan:

1. Pengguna membuka halaman Statistik Kesehatan (/statistik-kesehatan)
2. StatistikKesehatanController::index() merender view dengan detailLink = url('data-presisi/kesehatan/detail_data')
3. Saat kategori statistik diklik, JavaScript menyimpan tipeValue (ID kategori) dan judulUtama (nama kategori)
4. Kolom Nilai dan Jumlah pada DataTable menghasilkan link yang membawa parameter: filter[nilai], filter[tipe], tahun, judul, nama, chart-view
5. Link mengarah ke route data-presisi/kesehatan/detail_data yang ditangani oleh DataPresisiKesehatanController::detailData()
6. Controller memvalidasi input via DetailDataKesehatanRequest, membentuk string colomn (format: tipe:nilai), dan merender view detail
7. View detail_data.blade.php melakukan AJAX ke API /api/v1/data-presisi/kesehatan dengan parameter filter[colomn] untuk mendapatkan data yang sudah difilter

Perubahan penting pada view statistik:

• Variabel tipeValue dan judulUtama ditambahkan untuk menyimpan state kategori aktif secara global di scope JavaScript
• Kolom Jumlah sekarang mengirim filter[tipe] (sebelumnya tidak ada) dan tahun (sebelumnya tidak ada) ke halaman detail
• Kolom Nilai sudah mengirim filter[tipe], tahun, nama, dan chart-view sebelumnya, kini menggunakan variabel judulUtama dan tipeValue yang di-cache alih-alih query DOM berulang

Konfigurasi yang berubah

Tidak ada perubahan konfigurasi

Dependencies yang ditambahkan

Tidak ada dependencies baru

Testing

Manual Testing

• Navigasi ke Statistik Kesehatan, pilih kategori, klik link Jumlah - halaman detail terbuka dengan data yang sesuai
• Navigasi ke Statistik Kesehatan, pilih kategori, klik link Nilai - halaman detail terbuka dengan data yang sesuai
• Di halaman detail, ubah filter tahun - data ter-refresh sesuai tahun yang dipilih
• Di halaman detail, verifikasi kolom DataTable: NO, NIK, NOMOR KK, NAMA, JNS ASURANSI, JNS PENGGUNAAN ALAT KONTRASEPSI, JNS PENYAKIT YANG DIDERITA, KUNJUNGAN KE FASKES DALAM 1 TAHUN, RAWAT INAP DALAM 1 TAHUN, KUNJUNGAN KE DOKTER DALAM 1 TAHUN, KONDISI FISIK SEJAK LAHIR, STATUS GIZI BALITA, TANGGAL PENGISIAN, STATUS PENGISIAN
• Verifikasi pagination dan sorting berfungsi di halaman detail
• Verifikasi search berfungsi di halaman detail
• Akses halaman detail secara langsung tanpa parameter - tidak error
• Akses halaman detail dengan parameter filter yang tidak valid - divalidasi oleh Form Request
• Verifikasi bahwa halaman statistik kesehatan (grafik, pie chart, export excel) masih berfungsi normal
• Verifikasi bahwa halaman index dan cetak data presisi kesehatan masih berfungsi normal
• Testing dengan user yang tidak memiliki permission datapresisi-kesehatan-read - harus di-block

Automated Testing

• Unit Test - DetailDataKesehatanRequest validation rules
• Feature Test - DataPresisiKesehatanController::detailData() response
• Feature Test - Route data-presisi/kesehatan/detail_data accessible with correct permission
• Feature Test - Route data-presisi/kesehatan/detail_data blocked without permission

Screenshots / Video

simplescreenrecorder-2026-05-06_16.35.23.mp4

Sebelum:

• Kolom Jumlah pada tabel statistik kesehatan tidak memiliki link yang berfungsi (detailLink kosong)
• Tidak ada halaman detail data individual kesehatan

Sesudah:

• Kolom Nilai dan Jumlah memiliki link yang membuka halaman detail data kesehatan di tab baru
• Halaman detail menampilkan DataTable server-side dengan data individual yang difilter berdasarkan kategori dan nilai

Breaking Changes

Tidak ada

Migration Guide

Tidak diperlukan

References

• Issue: Buat Halaman Detail Kesehatan di Statistik Presisi #998
• Pola implementasi serupa: DataPresisiKetenagakerjaanController::detailData(), DataPresisiPendidikanController::detailData()

---

Catatan tambahan: Implementasi ini mengikuti pola yang sudah ada pada modul Data Presisi lainnya (Ketenagakerjaan, Pendidikan, Aktivitas Keagamaan). Perhatikan bahwa kolom Jumlah sekarang memberikan link untuk SEMUA nilai termasuk JUMLAH/BELUM MENGISI/TOTAL, berbeda dari perilaku sebelumnya. Jika ini tidak diinginkan, perlu ditambahkan kondisi pengecekan kembali.

[github-actions]

🔄 AI PR Review sedang antri di server...

Proses review akan segera dimulai di background — hasil akan muncul sebagai komentar setelah selesai.
Powered by CrewAI · PR #1034

[habibie11]

OK