# ROLE

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

Lakukan penyempurnaan pada Modul Master Surat.

Jangan mengubah workflow Pengajuan Surat.

Jangan mengubah workflow Arsip Surat.

Jangan mengubah Generator Surat.

Perbaikan hanya berfokus pada pengelolaan Placeholder.

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

Project adalah Sistem Informasi Administrasi Desa (SIAD) Desa Siofa Banua berbasis Laravel 12.

Master Surat telah selesai dibuat.

Saat ini halaman Detail Master Surat telah menampilkan daftar placeholder, tetapi masih perlu disempurnakan agar lebih mudah dipahami administrator desa dan siap digunakan Generator Surat.

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

Menyempurnakan tampilan dan struktur Placeholder pada halaman Detail Master Surat.

Perubahan tidak boleh mempengaruhi workflow modul lain.

======================================================
PERBAIKAN YANG WAJIB DILAKUKAN
======================================================

1. Kelompokkan placeholder berdasarkan sumber data.

Jangan tampilkan seluruh placeholder dalam satu daftar panjang.

Gunakan lima kelompok berikut:

A. Data Surat

B. Data Pemohon

C. Data Desa

D. Penandatangan Surat

E. Data Sistem

======================================================
KELOMPOK DATA SURAT
======================================================

Tampilkan placeholder:

{{ nomor_surat }}

{{ tanggal_surat }}

{{ jenis_surat }}

{{ nomor_pengajuan }}

{{ tanggal_pengajuan }}

{{ keperluan }}

======================================================
KELOMPOK DATA PEMOHON
======================================================

Tampilkan placeholder:

{{ nama_lengkap }}

{{ nik }}

{{ nomor_kk }}

{{ tempat_lahir }}

{{ tanggal_lahir }}

{{ jenis_kelamin }}

{{ alamat }}

{{ pekerjaan }}

{{ agama }}

{{ status_perkawinan }}

{{ kewarganegaraan }}

======================================================
KELOMPOK DATA DESA
======================================================

Tampilkan placeholder:

{{ nama_desa }}

{{ alamat_kantor }}

{{ kecamatan }}

{{ kabupaten }}

{{ provinsi }}

{{ kode_pos }}

{{ telepon_desa }}

{{ email_desa }}

{{ website_desa }}

{{ logo_desa }}

======================================================
KELOMPOK PENANDATANGAN
======================================================

Tampilkan placeholder:

{{ nama_penandatangan }}

{{ jabatan_penandatangan }}

{{ nip_penandatangan }}

======================================================
KELOMPOK DATA SISTEM
======================================================

Tampilkan placeholder:

{{ tanggal_cetak }}

{{ nama_admin }}

======================================================
TAMPILAN
======================================================

Gunakan Card Bootstrap.

Setiap kelompok placeholder berada pada Card terpisah.

Contoh:

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

Data Surat

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

{{ nomor_surat }}

Nomor surat resmi.

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

{{ tanggal_surat }}

Tanggal diterbitkan.

dst.

======================================================
SETIAP PLACEHOLDER WAJIB MEMILIKI
======================================================

- Nama Placeholder
- Keterangan fungsi placeholder
- Asal data placeholder
- Tombol Copy Placeholder

======================================================
ASAL DATA
======================================================

Data Surat

→ Pengajuan Surat + Generator Surat

Data Pemohon

→ Data Penduduk

Data Desa

→ Profil Desa

Penandatangan

→ Profil Desa

Data Sistem

→ Sistem

======================================================
COPY PLACEHOLDER
======================================================

Setiap placeholder memiliki tombol Copy.

Ketika tombol ditekan:

- Placeholder otomatis disalin ke clipboard.
- Tampilkan Toast Notification:
  "Placeholder berhasil disalin."

======================================================
VALIDASI TEMPLATE
======================================================

Tambahkan validasi.

Apabila administrator menggunakan placeholder yang tidak dikenal.

Tampilkan pesan:

"Placeholder tidak dikenali oleh Generator Surat."

======================================================
JANGAN DIGUNAKAN
======================================================

Jangan tampilkan placeholder berikut:

{{ no_kk }}

{{ village_name }}

{{ signer_name }}

{{ signer_position }}

{{ district_name }}

{{ regency_name }}

{{ province_name }}

{{ address }}

{{ phone }}

{{ email }}

{{ website }}

Karena nama tersebut merupakan nama field database.

Gunakan placeholder bisnis yang mudah dipahami administrator.

======================================================
UI/UX
======================================================

Gunakan:

Bootstrap 5

Card

Accordion atau Card Section

Badge kategori

Icon Clipboard

SweetAlert2

Toast Notification

Responsive

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

Sebelum implementasi tampilkan:

- File yang diubah.
- Struktur folder.
- Dampak terhadap Generator Surat.

Setelah implementasi selesai tampilkan:

- Ringkasan perubahan.
- Daftar placeholder final.
- Checklist bahwa seluruh placeholder telah sesuai dengan arsitektur SIAD.

Pastikan perubahan tidak mengubah workflow Master Surat, Pengajuan Surat, Arsip Surat, maupun Generator Surat.