bale / sidulur
Pelayanan sosial Sidulur untuk Bale CMS (tenant)
Requires
- php: ^8.3
- bale/cms: *
- bale/core: *
- bale/vada: *
- bale/wara: *
- illuminate/contracts: ^11.0||^12.0||^13.0
Requires (Dev)
- laravel/pint: ^1.14
- pestphp/pest: ^4.0
Suggests
None
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-11-22 07:50:41 UTC
README
Modul layanan sosial untuk Bale CMS. Menangani data warga, layanan per bidang, formulir dinamis, pendaftaran di meja, pengajuan ke bidang, verifikasi lapangan, dan panel layanan di percakapan WhatsApp.
Semua tabel Sidulur berada di database tenant. Paket ini bergantung pada bale/core, bale/cms, bale/wara, dan bale/vada.
Fitur
- Data warga dan kartu keluarga. Pencarian NIK, nomor KK, dan nomor HP memakai blind index HMAC sehingga kolom pencarian tidak menyimpan nilai mentah.
- Bidang, layanan, dan petugas. Setiap layanan punya formulir sendiri.
- Form builder: field isian, persyaratan tambahan, dan isian verifikasi. Field bertipe teks, number, date, select, textarea, dan file.
- Pendaftaran tiga langkah: cari warga, pilih layanan, isi formulir.
- Pengajuan diteruskan ke bidang atau diselesaikan di meja pendaftaran. Bidang dapat meminta verifikasi lapangan.
- Dokumen warga dan berkas persyaratan disajikan lewat route bertanda tangan dengan masa berlaku.
- Notifikasi WhatsApp lewat
bale/wara, dikirim sebagai job antrean. - Panel layanan di chat Vada: petugas membuat pendaftaran dari percakapan dan memakai media chat sebagai berkas persyaratan.
- Role, permission, dan menu sidebar didaftarkan otomatis.
Kebutuhan
- PHP 8.3 dan Laravel 12
bale/core,bale/cms,bale/wara,bale/vada- Tenant aktif di
bale_lists - Queue worker untuk notifikasi WhatsApp
Instalasi
Tambahkan paket ke aplikasi lewat path repository, lalu jalankan installer:
composer require bale/sidulur php artisan sidulur:install --all --tenant=<slug-tenant>
sidulur:install menjalankan tiga langkah:
- Publikasi config ke
config/sidulur.php. - Pembuatan permission dan role.
- Publikasi migrasi ke
database/migrations/sidulur/, lalu migrasi ke database tenant.
Tanpa --tenant, perintah menanyakan tenant yang akan dimigrasi. Tanpa --all, installer menampilkan pilihan langkah.
Langkah terpisah bila dibutuhkan:
php artisan sidulur:publish-config --force php artisan sidulur:publish-migrations --force php artisan sidulur:migrate --tenant=<slug-tenant>
Setelah instalasi, isi environment:
SIDULUR_INDEX_KEY= SIDULUR_TICKET_EXPIRY_DAYS=30 SIDULUR_DOCUMENT_LINK_DAYS=30 SIDULUR_DOCUMENT_DISK=sidulur SIDULUR_WHATSAPP= SIDULUR_WA_PURPOSE=sidulur
SIDULUR_INDEX_KEY harus sama dengan kunci yang dipakai aplikasi bale-front. Bila berbeda, pencarian warga tidak menemukan data yang sudah ada.
Berkas disimpan di disk sidulur (storage/app/sidulur) dan disajikan lewat controller dengan URL bertanda tangan, jadi tidak perlu storage:link.
Berikan role yang sesuai ke pengguna:
| Role | Akses |
|---|---|
bale-sidulur-admin |
Seluruh permission Sidulur |
bale-sidulur-pendaftaran |
Warga, layanan, dan pendaftaran |
bale-sidulur-bidang |
Pengajuan masuk dan pemrosesan |
bale-sidulur-lapangan |
Verifikasi lapangan |
Perintah
| Perintah | Keterangan |
|---|---|
sidulur:install |
Config, permission, dan migrasi |
sidulur:publish-config |
Publikasi config/sidulur.php |
sidulur:publish-migrations |
Publikasi stub migrasi ke database/migrations/sidulur/ |
sidulur:migrate |
Migrasi ke database tenant |
sidulur:seed |
Data awal (bidang, layanan, formulir) |
sidulur:demo |
Data demo untuk satu tenant |
sidulur:bersihkan-syarat-master |
Bersihkan syarat master yang tidak lagi dipakai |
Tabel
| Tabel | Isi |
|---|---|
sidulur_family_cards |
Kartu keluarga |
sidulur_citizens |
Data warga |
sidulur_bidangs |
Bidang |
sidulur_officers |
Petugas |
sidulur_services |
Layanan |
sidulur_forms |
Formulir per layanan (JSON schema) |
sidulur_pendaftarans |
Pendaftaran dan tiket |
sidulur_pelayanan_bidangs |
Pengajuan ke bidang dan status pemrosesan |
sidulur_timelines |
Riwayat status |
sidulur_documents |
Berkas warga dan persyaratan |
sidulur_settings |
Pengaturan tenant |
Integrasi Vada
Bila bale/vada terpasang, paket ini mendaftarkan:
- Halaman chat di
/cms/sidulur/chat. SidulurContactContextyang memasok data warga ke panel kanan percakapan.- Form layanan di panel chat, termasuk pemilihan berkas dari media percakapan.
Item menu Chat hanya tampil bila tabel vada_conversations ada di database tenant.
Rute
Semua rute berada di prefix /cms/sidulur, memakai middleware web, auth, EnsureBaleSelected, dan SwitchBaleConnection.
Pengembangan
Tes memakai Pest dari root proyek:
php vendor/bin/pest packages/sidulur/tests vendor/bin/pint packages/sidulur