Kontribusi

Kami menyambut kontribusi dari siapa saja, baik anggota JDIHN maupun komunitas pengembang. Halaman ini menjelaskan cara berkontribusi pada pengembangan ILDIS.

Melaporkan Bug

Jika Anda menemukan bug atau masalah, silakan buat issue di GitHub: Buka Issue Baru

Sertakan informasi berikut dalam laporan Anda:

Versi ILDIS yang digunakan (lihat di halaman backend atau file VERSION)
Langkah reproduksi — langkah-langkah untuk mereproduksi masalah
Perilaku yang diharapkan vs perilaku aktual
Screenshot atau log jika tersedia
Lingkungan — OS, versi PHP, versi Docker (jika menggunakan)

Setup Development

Untuk berkontribusi pada kode, ikuti langkah-langkah berikut:

1. Fork & Clone

Fork repositori ILDIS ke akun GitHub Anda, lalu clone:

git clone https://github.com/<username>/ildis.git
cd ildis

2. Install Dependensi

composer install --ignore-platform-reqs
php init

3. Konfigurasi Environment

cp .env.example .env

Edit file .env sesuai dengan konfigurasi lokal Anda. Pastikan Anda memiliki database MySQL/MariaDB yang berjalan.

4. Buat Branch

git checkout -b fitur-baru

5. Jalankan Migrasi

php yii migrate/up --interactive=0

Alur Kerja Kontribusi

Fork repositori ke akun GitHub Anda
Buat branch dari main untuk setiap fitur atau perbaikan
Commit perubahan dengan pesan yang jelas dan deskriptif
Push branch ke fork Anda
Buat Pull Request ke repositori utama

Konvensi Branch

fitur/nama-fitur — untuk fitur baru
fix/nama-fix — untuk perbaikan bug
docs/nama-perubahan — untuk perubahan dokumentasi

Konvensi Commit

Gunakan format pesan commit yang jelas:

feat: menambahkan fitur export PDF
fix: memperbaiki error pada halaman login
docs: memperbarui panduan instalasi

Standar Kode

ILDIS mengikuti standar kode berikut:

PSR-12 — Standar gaya kode PHP
Yii2 Convention — Mengikuti konvensi penamaan dan struktur Yii2 Framework
Indonesian Language — Komentar dan pesan error dalam Bahasa Indonesia

Pastikan kode Anda:

Mengikuti PSR-12 (gunakan phpcs untuk pengecekan otomatis)
Menambahkan komentar pada method dan class yang kompleks
Menulis unit test untuk fitur baru (jika memungkinkan)

Berkontribusi pada v5

ILDIS v5 sedang dalam tahap perencanaan arsitektur. Framework dan stack teknologi belum dipilih — ini adalah momen yang tepat untuk berkontribusi pada arah pengembangan.

Cara berpartisipasi:

Diskusi arsitektur — Bagikan use case dan kebutuhan instansi Anda di GitHub Discussions
Review proposal — Saat proposal arsitektur v5 dipublikasikan, berikan masukan berdasarkan pengalaman operasional Anda
Laporkan pain point — Masalah apa yang Anda hadapi dengan v4 yang harus diselesaikan di v5? Buat issue dengan label v5 di GitHub
Hubungi tim — Untuk diskusi langsung: it.dev@bphn.go.id

Prinsip desain v5: migrasi lancar dari v4, instalasi mudah, update otomatis dengan rollback, dan keamanan berkelanjutan. Pelajari detailnya di halaman Upgrade v4 ke v5.

Bantuan

Untuk pertanyaan teknis atau diskusi pengembangan, hubungi:

Email: it.dev@bphn.go.id
GitHub Discussion: bphndigitalservice/ildis/discussions