PanduanBagian 14 dari 14

Memperbarui Salinan

Menarik pembaruan DIMETIL dari repositori sumber tanpa menimpa identitas, logo, dan wilayah yang sudah Anda sesuaikan.

Isi halaman ini

Berkas milik daerah
Persiapan — sekali saja
Setiap kali ada pembaruan
1. Pastikan pekerjaan Anda sudah tersimpan
2. Ambil pembaruan dan baca catatannya
3. Gabungkan
4. Bila muncul bentrok (CONFLICT)
5. Periksa sebelum diterbitkan
6. Kerjakan tindakan yang diminta
7. Terbitkan
Bila setelah terbit ada yang tak beres

DIMETIL terus diperbaiki. Pembaruan diterbitkan ke repositori sumber yang aksesnya Anda terima saat serah terima. Halaman ini menjelaskan cara menariknya ke salinan Anda tanpa kehilangan penyesuaian yang sudah Anda buat.

Berkas milik daerah

Beberapa berkas memang Anda ubah saat memasang. Berkas-berkas ini milik daerah Anda — pada pembaruan, isian Anda yang dipertahankan.

Berkas	Isinya
`src/config/instansi.ts`	Nama instansi, alamat, kontak, jam layanan
`public/logo_kotabaru.png` · `public/favicon.png`	Lambang daerah
`public/geo/*.geojson`	Peta kecamatan
`src/lib/utils/kecamatan.ts`	Padanan nama kecamatan pada alamat lama
`src/lib/constants/uttp.ts`	Daftar kecamatan dan daftar jenis UTTP — lihat catatan di bawah

Persiapan — sekali saja

Di folder salinan Anda, daftarkan repositori sumber dengan nama upstream. Alamatnya sama dengan yang Anda pakai saat git clone pertama kali:

bash

git remote add upstream https://github.com/ORGANISASI/dimetil.git

Periksa hasilnya:

bash

git remote -v

Harus tampil dua pasang baris: origin (repositori milik Anda, yang terhubung ke Vercel) dan upstream (repositori sumber).

Setiap kali ada pembaruan

1. Pastikan pekerjaan Anda sudah tersimpan

bash

git status

Bila masih ada perubahan, simpan dulu:

bash

git add -A
git commit -m "Penyesuaian daerah"

2. Ambil pembaruan dan baca catatannya

bash

git fetch upstream
git show upstream/main:CATATAN_PERUBAHAN.md

Baca semua entri yang lebih baru dari pembaruan terakhir Anda. Perhatikan terutama bagian Tindakan yang diperlukan.

3. Gabungkan

bash

git merge upstream/main

Bila selesai tanpa pesan CONFLICT, lanjut ke langkah 5.

4. Bila muncul bentrok (CONFLICT)

Bentrok terjadi bila satu berkas diubah di dua tempat — oleh Anda dan oleh pembaruan. Git menyebutkan nama berkasnya.

Bila berkasnya src/config/instansi.ts atau berkas gambar, pertahankan milik Anda:

bash

git checkout --ours src/config/instansi.ts
git add src/config/instansi.ts

Bila berkasnya src/lib/constants/uttp.ts, buka berkasnya dan gabungkan dengan tangan. Berkas ini memuat dua hal sekaligus: daftar kecamatan (milik Anda) dan daftar jenis UTTP (bisa bertambah dari pembaruan, mis. mengikuti Permendag baru). Pertahankan kecamatan Anda, terima jenis UTTP dari pembaruan. Git menandai kedua versi dengan <<<<<<<, =======, dan >>>>>>> — hapus ketiga penanda itu setelah selesai.

Berkas lain hampir selalu berarti pembaruan yang harus diterima:

bash

git checkout --theirs NAMA/BERKAS
git add NAMA/BERKAS

Setelah semua bentrok beres:

bash

git commit -m "Menggabungkan pembaruan DIMETIL"

5. Periksa sebelum diterbitkan

bash

npm install
npx tsc --noEmit
npm run build

npm install diperlukan karena pembaruan kadang menambah pustaka. Bila tsc atau build gagal, jangan push — kirimkan pesan galatnya kepada kami.

6. Kerjakan tindakan yang diminta

Sesuai catatan perubahan: jalankan berkas SQL baru di Supabase, buat lembar Spreadsheet baru, atau tambahkan variabel lingkungan baru di Vercel.

7. Terbitkan

bash

git push

Vercel menerbitkannya sendiri dalam beberapa menit. Setelah itu buka Dashboard → Diagnostik Sistem, lalu coba satu putaran alur inti: ajukan permohonan uji sampai SKHP terbit.

Bila setelah terbit ada yang tak beres

Di dasbor Vercel, buka Deployments, pilih penerbitan sebelumnya yang masih normal, lalu Promote to Production. Situs kembali seperti sebelum pembaruan dalam hitungan detik, sementara Anda menelusuri masalahnya.