🏘️ SiLaras Desa

Sistem Layanan Administrasi & Surat Desa berbasis Web

Urus surat desa tanpa antre — ajukan online, lacak status, unduh surat resmi.

---

✨ Tentang Proyek

SiLaras Desa adalah aplikasi web siap-pakai untuk pelayanan surat-menyurat di tingkat desa/kelurahan. Warga dapat mengajukan berbagai surat keterangan secara online dari rumah, mendapatkan kode pelacakan, memantau prosesnya secara transparan, lalu mengunduh surat resmi dalam format PDF ber-kop dan bernomor.

Dibangun dengan Node.js + Express murni, tanpa dependency native sehingga sangat mudah dideploy — bahkan di infrastruktur sederhana kantor desa.

💡 Cukup ubah satu file konfigurasi (.env) untuk memakai aplikasi ini di desa mana pun.

---

🚀 Fitur Utama

	Fitur	Keterangan
📝	Pengajuan Online	8 jenis surat dengan formulir dinamis sesuai kebutuhan masing-masing surat
🔍	Lacak Status Real-time	Warga memantau permohonan lewat kode pelacakan (SD-2026-XXXXXX)
📄	Surat PDF Resmi	Generate otomatis surat ber-kop desa, bernomor, lengkap dengan kode verifikasi
🛠️	Panel Petugas	Dashboard perangkat desa untuk verifikasi, ubah status, & terbitkan surat
📱	Responsif	Tampilan mobile-first yang nyaman di HP maupun desktop
🔎	SEO Friendly	Meta tags, Open Graph, sitemap.xml, robots.txt, & data terstruktur (Schema.org)
🔐	Aman	Helmet, session login petugas, validasi input, penyimpanan atomik
⚡	Ringan & Cepat	Tanpa framework frontend berat, CSS kustom, kompresi gzip

📋 Jenis Surat yang Didukung

Keterangan Domisili · Keterangan Usaha (SKU) · Keterangan Tidak Mampu (SKTM) · Pengantar SKCK · Keterangan Kelahiran · Keterangan Kematian · Pengantar Nikah · Keterangan Belum Menikah

---

🖥️ Tangkapan Layar

Beranda	Lacak Status	Panel Petugas
Hero modern + daftar layanan	Timeline status + unduh PDF	Dashboard + kelola permohonan

Jalankan aplikasi (lihat di bawah) untuk melihat tampilan lengkapnya.

---

⚙️ Instalasi & Menjalankan

Prasyarat

• Node.js versi 18 atau lebih baru

Langkah

# 1. Klon repositori
git clone https://github.com/<username>/silaras-desa.git
cd silaras-desa

# 2. Pasang dependency
npm install

# 3. (Opsional) salin & sesuaikan konfigurasi desa
cp .env.example .env

# 4. (Opsional) isi data contoh untuk demo
npm run seed

# 5. Jalankan
npm start

Buka http://localhost:3000 di browser. 🎉

Halaman	URL
🌐 Situs publik	http://localhost:3000
🔐 Login petugas	http://localhost:3000/admin

Akun petugas default: admin / admin123  →  ganti via .env saat produksi!

---

🛠️ Konfigurasi Desa

Semua identitas desa diatur lewat environment variable (lihat .env.example). Contoh:

VILLAGE_NAME=Desa Sukamaju
VILLAGE_KECAMATAN=Kecamatan Cibadak
VILLAGE_KABUPATEN=Kabupaten Sukabumi
VILLAGE_KEPALA=H. Ahmad Suryana, S.Sos
ADMIN_PASSWORD=kata-sandi-yang-kuat

Nilai ini otomatis dipakai pada kop surat, footer, kontak, dan data terstruktur SEO.

---

🧱 Arsitektur & Teknologi

silaras-desa/
├── server.js              # Entry point Express (keamanan, SEO, routing)
├── config/config.js       # Konfigurasi terpusat (env-driven)
├── src/
│   ├── db.js              # Penyimpanan JSON atomik (tanpa DB server)
│   ├── data/
│   │   ├── letterTypes.js # Katalog jenis surat & field dinamis
│   │   └── seed.js        # Data contoh
│   ├── routes/            # Rute publik & admin
│   ├── services/          # Pembuatan dokumen & PDF (PDFKit)
│   └── middleware/        # Proteksi area petugas
├── views/                 # Template EJS (publik & admin)
└── public/                # CSS, JS, ikon, OG image

Stack: Node.js · Express · EJS · PDFKit · Helmet · Compression — tanpa modul native, tanpa build step.

---

🔎 SEO & Performa

• ✅ <title>, meta description, & canonical unik per halaman
• ✅ Open Graph & Twitter Card untuk pratinjau saat dibagikan
• ✅ Schema.org JSON-LD: GovernmentOffice, GovernmentService, FAQPage, WebSite
• ✅ sitemap.xml & robots.txt dinamis
• ✅ manifest.webmanifest (installable / PWA-ready)
• ✅ HTML semantik, mobile-first, kompresi gzip, dan aset di-cache

---

🗺️ Alur Penggunaan

Warga                          Perangkat Desa
  │                                  │
  ├─ Pilih jenis surat               │
  ├─ Isi formulir  ───────────────►  │  (status: Menunggu)
  │                                  ├─ Verifikasi berkas (status: Diproses)
  │                                  ├─ Terbitkan surat   (status: Selesai)
  ├─ Lacak via kode  ◄───────────────┤
  └─ Unduh PDF resmi                 │

---

🤝 Kontribusi

Kontribusi sangat diterima! Silakan fork, buat branch fitur, lalu ajukan Pull Request. Untuk perubahan besar, buka issue terlebih dahulu untuk diskusi.

📄 Lisensi

Dirilis di bawah lisensi MIT — bebas digunakan, dimodifikasi, dan disebarluaskan, termasuk untuk pemerintah desa.

---

Dibuat untuk mendukung digitalisasi desa Indonesia 🇮🇩

⭐ Jika proyek ini bermanfaat, beri bintang untuk mendukung pengembangan!