# ROLE

Bertindak sebagai Senior Software Architect, Senior Laravel 12 Developer, Senior System Analyst, Database Architect, dan UI/UX Engineer.

Sebelum melakukan perubahan, lakukan analisis terhadap implementasi Master Surat yang sudah ada.

Jangan membuat ulang modul.

Jangan mengubah workflow Pengajuan Surat maupun Arsip Surat.

Lakukan hanya proses refactoring dan penyempurnaan.

======================================================
KONTEKS
======================================================

Modul Master Surat telah selesai dibuat.

Saat ini fitur yang sudah tersedia adalah:

- Halaman Index
- Halaman Detail
- Halaman Edit
- TinyMCE Editor
- Placeholder
- Statistik
- DataTable

Namun terdapat beberapa bagian yang perlu diperbaiki agar sesuai dengan kebutuhan Sistem Informasi Administrasi Desa (SIAD) Desa Siofa Banua.

======================================================
TUJUAN
======================================================

Lakukan penyempurnaan terhadap modul Master Surat.

Jangan mengubah struktur workflow.

Jangan mengubah route yang sudah berjalan.

Jangan menghapus fitur yang sudah ada.

======================================================
PERBAIKAN 1
======================================================

Hilangkan status placeholder:

- Aktif
- Kosong

Karena Master Surat hanya menyimpan template.

Placeholder bukan data aktual.

Status tersebut membingungkan Administrator.

======================================================
HASIL YANG DIHARAPKAN
======================================================

Panel Placeholder cukup menampilkan:

Nama Placeholder

Deskripsi

Contoh:

{{ nama_lengkap }}

Nama lengkap penduduk.

--------------------------------------------

{{ nik }}

Nomor Induk Kependudukan.

--------------------------------------------

{{ nomor_kk }}

Nomor Kartu Keluarga.

--------------------------------------------

dan seterusnya.

======================================================
PERBAIKAN 2
======================================================

Standarkan seluruh placeholder.

Gunakan format berikut.

{{ nomor_surat }}

{{ tanggal_surat }}

{{ nama_lengkap }}

{{ nik }}

{{ nomor_kk }}

{{ tempat_lahir }}

{{ tanggal_lahir }}

{{ jenis_kelamin }}

{{ pekerjaan }}

{{ agama }}

{{ kewarganegaraan }}

{{ status_perkawinan }}

{{ alamat }}

{{ keperluan }}

{{ nama_penandatangan }}

{{ jabatan_penandatangan }}

======================================================
ATURAN
======================================================

Jangan menggunakan:

{{NAMA}}

{{Nama}}

{{nik}}

{{Nik}}

Gunakan hanya:

snake_case

huruf kecil

======================================================
PERBAIKAN 3
======================================================

Perbaiki seluruh template bawaan.

Jika terdapat placeholder lama.

Misalnya

{{NAMA_LENGKAP}}

ubah menjadi

{{ nama_lengkap }}

Lakukan untuk seluruh template.

======================================================
PERBAIKAN 4
======================================================

Perbaiki placeholder penandatangan.

Jangan lagi menggunakan:

{{ nama_kepala_desa }}

{{ jabatan_kepala_desa }}

Ganti menjadi:

{{ nama_penandatangan }}

{{ jabatan_penandatangan }}

Karena sistem harus tetap berjalan apabila terjadi:

- Kepala Desa

- Penjabat Kepala Desa

- Pelaksana Harian

- Pelaksana Tugas

Template tidak boleh berubah ketika pejabat berganti.

======================================================
PERBAIKAN 5
======================================================

Tambahkan kategori placeholder.

Panel Placeholder dibagi menjadi beberapa kelompok.

======================================================

A.

DATA SURAT

======================================================

{{ nomor_surat }}

Nomor surat otomatis.

--------------------------------------

{{ tanggal_surat }}

Tanggal surat diterbitkan.

--------------------------------------

{{ keperluan }}

Keperluan pengajuan.

======================================================

B.

DATA PENDUDUK

======================================================

{{ nama_lengkap }}

{{ nik }}

{{ nomor_kk }}

{{ tempat_lahir }}

{{ tanggal_lahir }}

{{ jenis_kelamin }}

{{ pekerjaan }}

{{ agama }}

{{ kewarganegaraan }}

{{ status_perkawinan }}

{{ alamat }}

======================================================

C.

DATA PEMERINTAH DESA

======================================================

{{ nama_desa }}

{{ nama_kecamatan }}

{{ nama_kabupaten }}

{{ nama_provinsi }}

{{ alamat_kantor_desa }}

======================================================

D.

DATA PENANDATANGAN

======================================================

{{ nama_penandatangan }}

{{ jabatan_penandatangan }}

======================================================
PERBAIKAN 6
======================================================

Setiap placeholder dapat diklik.

Saat diklik.

Placeholder otomatis disalin ke Clipboard.

Tampilkan Toast.

"Placeholder berhasil disalin."

======================================================
PERBAIKAN 7
======================================================

Tambahkan tombol.

Copy Semua Placeholder

Ketika diklik.

Sistem menyalin seluruh placeholder ke Clipboard.

======================================================
PERBAIKAN 8
======================================================

Pada halaman Detail.

Tambahkan informasi.

Jumlah Placeholder digunakan.

Misalnya.

Menggunakan:

12 dari 16 Placeholder.

======================================================
PERBAIKAN 9
======================================================

Tambahkan Preview Placeholder.

Misalnya.

Template.

Nama :

{{ nama_lengkap }}

Preview.

Nama :

[Nama Lengkap Penduduk]

Preview hanya simulasi.

Tidak mengambil data database.

======================================================
PERBAIKAN 10
======================================================

Pastikan seluruh perubahan.

Tidak mengubah:

- Pengajuan Surat

- Arsip Surat

- Generator PDF

- Dashboard

- Authentication

======================================================
OUTPUT
======================================================

Sebelum coding.

Tampilkan.

1.

Daftar file yang berubah.

2.

Alasan perubahan.

3.

Dampak perubahan.

Setelah itu.

Implementasikan seluruh refactoring menggunakan Laravel Best Practice.

Di akhir implementasi tampilkan checklist bahwa seluruh penyempurnaan telah berhasil diterapkan.