🏛️ SiDesa - Sistem Informasi Desa (SID)

SiDesa adalah aplikasi Sistem Informasi Desa (SID) berbasis open-source yang dibangun menggunakan framework Laravel. Sistem ini dirancang sebagai platform administrasi kependudukan, pelayanan surat-menyurat mandiri, dan Content Management System (CMS) portal web desa yang mendukung multi-tema.

Sistem ini juga dilengkapi dengan API terintegrasi untuk menyinkronkan data agregat ke Sistem Informasi Kecamatan (SIK).

---

🌐 Demo Online

Anda dapat mencoba langsung aplikasi SiDesa melalui tautan demo berikut:

• URL Demo: https://sidesa.timacodecraft.com
• Kredensial Login Default:
  • Super Administrator: admin@sidesa.timacodecraft.com / password
  • Kepala Desa: kades@sidesa.timacodecraft.com / password
  • Perangkat Desa: perangkat@sidesa.timacodecraft.com / password
  • Ketua RT: rt@sidesa.timacodecraft.com / password
  • Warga / Layanan Mandiri: warga@sidesa.timacodecraft.com / password

Catatan: Basis data demo direset secara berkala setiap hari pukul 00:00 WIB ke data awal (clean seed).

---

✨ Fitur Utama

👥 1. Manajemen Kependudukan (Buku Induk)

• Pencatatan biodata penduduk berbasis NIK dan Nomor KK (16 digit).
• Manajemen mutasi penduduk (Lahir, Wafat, Pindah, Datang).
• Klasifikasi kelompok rentan, penerima bansos, dan status ekonomi.

✉️ 2. Layanan E-Surat

• Generator otomatis surat pengantar (SKCK, SKTM, Domisili, dll).
• Format surat baku yang siap cetak (PDF/Word).
• Layanan mandiri: Warga dapat login dan mengajukan surat secara online.

🎨 3. CMS & Sistem Multi-Tema (Templating)

• Website profil desa dinamis untuk publikasi berita, pengumuman, dan potensi desa.
• Dukungan Multi-Tema: Antarmuka publik dapat diganti secara modular tanpa mengubah struktur kode backend maupun dashboard admin.
• Manajemen aset (CSS/JS/Gambar) terisolasi untuk setiap tema.

📊 4. Transparansi & Pemetaan

• Modul publikasi infografis Anggaran Pendapatan dan Belanja Desa (APBDes).
• Peta wilayah administratif desa (batas Dusun/RT/RW).

🔗 5. Integrasi SIK (Sistem Informasi Kecamatan)

• Otomatisasi pengiriman laporan bulanan (agregat penduduk) ke server kecamatan.
• Endpoint API yang aman dengan otentikasi token-based.

---

🛠️ Teknologi yang Digunakan

• Backend: PHP 8.2+, Laravel 10.x / 11.x
• Database: MySQL 8.0+ / MariaDB
• Frontend (Admin): Tailwind CSS / Bootstrap 5, Alpine.js (Blade Components)
• Frontend (Tema Publik): Laravel Blade murni (dapat dikustomisasi penuh oleh pembuat tema)

---

📂 Struktur Sistem Tema

Proyek ini memisahkan secara tegas antara area Admin dan area Publik (Tema). Jika Anda seorang desainer web yang ingin membuat atau memodifikasi tema publik:

1. File Blade (Tampilan/Layout): resources/views/themes/{nama_tema}/
2. Assets (CSS/JS/Gambar): public/themes/{nama_tema}/
3. Helper Asset: Gunakan fungsi theme_asset('path/to/file') saat memuat aset statis tema.

---

🚀 Panduan Instalasi (Development)

Pastikan lingkungan lokal Anda memenuhi persyaratan:

• PHP >= 8.2 (dengan ekstensi pdo_mysql, mbstring, openssl, tokenizer, xml, curl)
• Composer >= 2.x
• Node.js & NPM
• MySQL / MariaDB

Langkah-langkah Instalasi

1. Clone Repositori

# Menggunakan SSH (Rekomendasi)
git clone git@github.com:TIMA-Codecraft/sidesa.git

# Atau menggunakan HTTPS
git clone https://github.com/TIMA-Codecraft/sidesa.git

cd sidesa

2. Pasang Dependensi

composer install
npm install

3. Konfigurasi Environment

cp .env.example .env
php artisan key:generate

Sesuaikan konfigurasi database dan variabel lainnya pada berkas .env:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=sidesa
DB_USERNAME=root
DB_PASSWORD=

4. Migrasi Database & Seeder

php artisan migrate --seed

5. Jalankan Aplikasi

# Jalankan server aplikasi Laravel
php artisan serve

# Pada terminal terpisah, jalankan build asset
npm run dev

Akses aplikasi melalui peramban di: http://localhost:8000

---

🤝 Berkontribusi

Kontribusi untuk pengembangan SiDesa sangat terbuka!

1. Fork repositori ini.
2. Buat branch fitur baru (git checkout -b feature/FiturKeren).
3. Commit perubahan Anda (git commit -m 'Menambahkan fitur keren').
4. Push ke branch (git push origin feature/FiturKeren).
5. Buat Pull Request.

---

📄 Lisensi

Proyek SiDesa didistribusikan di bawah lisensi GNU General Public License v3.0 (GPL-3.0).