halaman dimigrasikan ke Incremental Static Regeneration
±5 → 1–2 dtk
waktu muat beranda setelah optimasi
2 bahasa
Indonesia dan Inggris, dengan URL masing-masing
Pengantar
Wajah resmi lembaga negara di hadapan publik.
Kami bersyukur mendapat kepercayaan untuk ikut membangun website Kementerian Desa. Proyek ini tidak mudah: banyak unit kerja dengan kebutuhan berbeda, konten yang bertambah setiap hari, dan tanggung jawab besar karena website ini menjadi wajah resmi lembaga negara.
Tulisan ini bukan cerita tentang betapa hebatnya kami. Kami ingin berbagi keputusan yang kami ambil, alasannya, masalah yang muncul di tengah jalan, dan cara kami menghadapinya. Ada keputusan yang sejak awal tepat, ada juga yang harus kami perbaiki setelah melihat kenyataan di lapangan.
Memahami masalah
Banyak rumah dalam satu atap.
Saat mempelajari Kerangka Acuan Kerja dan berdiskusi dengan tim kementerian, kami menemukan empat tantangan utama.
Banyak unit, satu identitas. Sekretariat Jenderal, Inspektorat Jenderal, BPSDM, BPI, direktorat jenderal, serta Balai Besar/Balai di Jakarta, Makassar, Bengkulu, Ambon, dan Jayapura butuh website sendiri, tetapi identitas kementerian harus tetap terasa satu.
Banyak pengelola konten. Setiap unit punya admin sendiri. Admin unit A tidak boleh mengubah konten unit B.
Audiens yang sangat beragam. Dari perangkat desa yang membuka lewat ponsel dengan sinyal terbatas, peneliti, media, sampai publik internasional.
Tuntutan keterbukaan informasi. Pengumuman, regulasi, laporan kinerja, rencana strategis, dan layanan informasi publik harus mudah ditemukan dan diunduh.
PelajaranUntuk website pemerintahan, struktur organisasi adalah bagian dari kebutuhan desain. Kami memetakan hierarki lembaga lebih dulu (siapa memiliki konten apa, siapa boleh mengubah apa) sebelum menggambar satu layar pun.
Perancangan UI/UX
Satu sistem desain, banyak situs.
Kami tidak mendesain belasan website secara terpisah, melainkan satu sistem template: kumpulan komponen dan tata letak yang dipakai bersama oleh portal utama, subsitus Eselon I, dan subsitus Balai. Yang berbeda hanya konfigurasinya, seperti nama unit, logo, menu, warna aksen, dan konten.
Identitas visual kementerian konsisten di semua subsitus
Perbaikan satu komponen langsung berlaku di semua situs
Subsitus baru cukup ditambah lewat konfigurasi
Tampilan ponsel diperlakukan sebagai prioritas, bukan versi kecil desktop
Statistik pembangunan desa sebagai kartu dan grafik interaktif, bukan tabel panjang.Berita dan pengumuman, termasuk berita terbaru dari unit kerja.
Aksesibilitas sebagai kewajiban. Website pemerintah melayani semua warga negara, sehingga pengunjung dapat mengatur sendiri mode skala abu-abu, kontras tinggi dan kontras negatif, ukuran teks, serta zoom hingga 5x di ponsel. Seluruh halaman utama juga tersedia dalam dua bahasa dengan URL yang mudah dibaca, misalnya /berita dan /news.
Interaksi publik. Kalender agenda dengan tampilan harian, mingguan, dan bulanan; reaksi pembaca dan widget umpan balik; serta widget Government Public Relations untuk informasi nasional.
PelajaranUI/UX untuk lembaga pemerintah adalah soal kejelasan, konsistensi, dan inklusivitas. Sesi UAT bersama pengguna dari kementerian sangat berharga, karena merekalah yang paling memahami cara publik mencari informasi.
Arsitektur & teknologi
Konten dikelola terpisah dari halaman publik.
Kami memilih teknologi berdasarkan kebutuhan proyek, bukan tren. Pemisahan CMS (tempat admin bekerja) dari website publik (tempat masyarakat berkunjung) memberi keamanan, performa, dan satu sumber konten untuk banyak subsitus.
Ditulis admin unitStrapi 5 · CMS
Admin hanya bisa mengelola konten milik unit kerjanya, dengan 2FA dan audit log.
DisimpanGarage S3
Gambar dan dokumen tersimpan di infrastruktur yang dikendalikan sendiri.
Dibangun & di-cacheNext.js 15 · ISR
Halaman disajikan secepat halaman statis dan diperbarui otomatis saat konten berubah.
Disajikan per domainPortal & subsitus
Satu aplikasi membaca domain lalu menampilkan template, menu, SEO, dan analitik unit tersebut.
Garage (S3, self-hosted)Gambar, dokumen, dan laporan; mendukung replikasi
Pengiriman
GitLab CI/CDSecret detection, build Docker, health check
Jaringan terenkripsiDeployment ke kontainer lewat terowongan WireGuard
Kebutuhan
Pilihan
Alasan
Frontend cepat & ramah SEO
Next.js 15 (React, TypeScript)
ISR: halaman disajikan secepat halaman statis, tetapi tetap diperbarui otomatis ketika konten berubah
Konten oleh banyak admin non-teknis
Strapi 5 (headless CMS)
Antarmuka admin yang ramah, model konten fleksibel, hak akses berbasis peran, multibahasa, dapat di-host sendiri
Penyimpanan file
Garage (S3-compatible, self-hosted)
Data tetap di infrastruktur sendiri, standar S3 sehingga tidak terkunci pada satu vendor, ringan
Antarmuka & visualisasi
Tailwind CSS, MUI Charts, FullCalendar
Komponen konsisten, grafik, dan kalender interaktif
Deployment
Docker, GitLab CI/CD, kontainer via WireGuard
Build terstandar, deployment yang dapat diulang, jalur akses server yang terenkripsi
PelajaranTidak ada stack yang sempurna. Next.js dan Strapi memberi fleksibilitas besar, tetapi juga menuntut disiplin dalam mengelola cache, memori, dan alur data.
Penyimpanan data
Kendali data di infrastruktur sendiri.
Bagi instansi pemerintah, kendali atas lokasi dan pengelolaan data adalah pertimbangan penting. Garage, object storage sumber terbuka yang kompatibel dengan API S3, membuat file kementerian tetap di server yang dikelola sendiri tanpa terkunci pada satu vendor.
Integrasinya dengan Strapi tidak semulus layanan S3 komersial. Beberapa hal yang kami pelajari:
Gaya alamat path-style. Garage membutuhkan pengaturan path-style addressing dan region khusus; hal kecil yang bisa menghabiskan waktu bila tidak dipahami sejak awal.
Pratinjau file di panel admin. Sempat bermasalah setelah file tersimpan di Garage; alur URL publiknya kami telusuri dan perbaiki.
Tipe file (MIME). Sinkronisasi sempat menyimpan file dengan tipe generik sehingga browser tidak selalu menampilkannya. Metadata file sama pentingnya dengan file itu sendiri.
Lingkungan pengembangan. Mode penyimpanan lokal agar tim bisa bekerja tanpa mengganggu penyimpanan produksi.
Optimasi gambar. Konversi otomatis ke AVIF/WebP, cache gambar jangka panjang, dan penyajian SVG dengan kebijakan yang membatasi eksekusi skrip.
PelajaranSelf-hosted storage memberi kendali penuh, dengan tanggung jawab teknis yang juga penuh. Kami mendokumentasikan setiap konfigurasi dan menguji alur unggah, simpan, dan tampilkan secara menyeluruh.
Keamanan
Lapisan-lapisan, bukan satu fitur tunggal.
Akses panel admin. Autentikasi dua faktor (TOTP), Cloudflare Turnstile pada halaman login, dan audit log aktivitas admin.
Hak akses per unit kerja. Peran khusus "Unit Kerja" membatasi admin pada konten unitnya sendiri, ditegakkan di sisi server, bukan sekadar disembunyikan di tampilan.
Unggahan file. Daftar tipe file yang diizinkan dan pemblokiran ekstensi berbahaya seperti file eksekusi dan skrip.
Konfigurasi aplikasi. Content Security Policy di CMS, informasi teknologi server disembunyikan dari header, dan log debug dihapus dari build produksi.
Pipeline dan infrastruktur. Pemindaian kredensial otomatis di setiap pipeline, deployment lewat jaringan terenkripsi, dan dokumentasi API publik hanya untuk endpoint baca.
PelajaranKeamanan adalah proses yang tidak pernah selesai, dan perlu diseimbangkan dengan kenyamanan. Misalnya, admin yang sudah lolos captcha tidak perlu mengulanginya saat salah memasukkan kode 2FA dalam rentang waktu singkat.
Problematika di lapangan
Masalah yang muncul dan cara kami menghadapinya.
A
Kehabisan memori saat build dan runtime
Masalah
Seiring bertambahnya halaman dan subsitus, proses build mulai gagal karena kehabisan memori, dan server terbebani karena banyak halaman di-render ulang pada setiap kunjungan.
Yang kami lakukan
Lebih dari 100 halaman dimigrasikan ke ISR: disajikan dari cache dan diperbarui di latar belakang.
Puluhan panggilan data di beranda dijalankan paralel, bukan berurutan.
Cache in-memory berbatas ukuran agar data yang sama tidak diambil berulang.
Build yang aman: tidak gagal total hanya karena CMS sedang tidak terjangkau.
Hasil: waktu muat beranda turun dari sekitar 5 detik menjadi 1–2 detik, dan beban server berkurang signifikan.
PelajaranOptimasi sebaiknya dipikirkan sejak awal. Strategi rendering dan cache kini kami tetapkan sebagai keputusan arsitektur di awal proyek.
B
Banyak subsitus, satu basis kode
Masalah
Mengelola belasan subsitus dengan basis kode terpisah akan mahal dan rawan inkonsistensi.
Yang kami lakukan
Satu aplikasi frontend membaca nama domain yang diakses pengunjung, lalu menampilkan template, menu, metadata SEO, dan analitik yang sesuai untuk unit tersebut.
PelajaranArsitektur multi-site menghemat biaya pemeliharaan, tetapi konfigurasinya harus dikelola dengan disiplin. Kami sempat mengalami konflik konfigurasi saat beberapa pengembang mengubahnya bersamaan, lalu memperbaiki alur kerja tim.
Template yang sama di layar ponsel
C
Konten kaya dari banyak penulis
Masalah
Admin dari berbagai unit menulis dengan gaya dan format berbeda; sebagian menyalin dari dokumen Word yang membawa format tersembunyi.
Yang kami lakukan
Editor teks kaya di CMS dan template halaman yang tetap rapi untuk berbagai variasi konten. Satu pendekatan pemrosesan konten ternyata menimbulkan masalah baru, sehingga kami mengembalikannya (rollback) dan mencari cara yang lebih stabil.
PelajaranBerani mundur selangkah itu penting. Mengembalikan perubahan yang bermasalah dengan cepat lebih baik daripada memaksakan solusi yang belum matang di produksi.
D
Deployment ke infrastruktur pemerintah
Masalah
Server berada di jaringan dengan akses terbatas, sehingga deployment otomatis tidak bisa langsung berjalan.
Yang kami lakukan
Pipeline CI/CD dengan tahapan pemindaian kredensial, build image Docker, pengujian kesehatan aplikasi, lalu deployment lewat terowongan terenkripsi ke kontainer.
PelajaranSetiap instansi punya aturan infrastruktur sendiri. Pipeline yang baik menyesuaikan diri dengan aturan tersebut, bukan sebaliknya.
Formulir UAT serta laporan awal dan akhir pekerjaan
Ringkasan pembelajaran
Delapan hal yang kami bawa ke proyek berikutnya.
Pahami struktur organisasi sebelum merancang. Hierarki lembaga menentukan desain, model data, dan hak akses.
Bangun sistem, bukan sekadar halaman. Sistem template dan multi-site membuat skala besar tetap terkelola.
Inklusivitas adalah kewajiban. Mobile-first, aksesibilitas, dan dwibahasa adalah standar minimum layanan publik.
Pilih teknologi berdasarkan kebutuhan. Headless CMS dan self-hosted storage dipilih karena keamanan, kendali data, dan fleksibilitas.
Kedaulatan data membutuhkan disiplin teknis. Kendali penuh datang bersama tanggung jawab konfigurasi dan pengujian.
Keamanan berlapis dan berkelanjutan. 2FA, captcha, pembatasan per unit, filter unggahan, CSP, dan pemindaian kredensial saling melengkapi.
Performa harus dirancang sejak awal. Strategi cache dan rendering sejak hari pertama.
Dokumentasikan semuanya. Keberlanjutan setelah serah terima sama pentingnya dengan peluncuran.
Penutup
Kami tidak mengklaim telah melakukan semuanya dengan sempurna.
Proyek ini mengajarkan kami banyak hal tentang bekerja dengan banyak pemangku kepentingan, standar keamanan yang tinggi, dan tanggung jawab melayani publik. Bila organisasi Anda menghadapi tantangan serupa, seperti banyak unit kerja, kebutuhan keamanan data, atau website yang harus cepat dan inklusif, kami senang berdiskusi.