# Rencana Penyelesaian UndanganKita

Status per 31 Okt 2026: produk sudah jalan di https://inv.benifin.my.id/
(MVP + fondasi database + admin + dasbor pengguna + undangan tamu/RSVP +
deploy Dockerfile di Coolify). Rencana ini adalah jalan menuju versi yang
bisa dijual dan dipakai pelanggan sungguhan — bukan daftar fitur tanpa akhir.

Prinsip: selesaikan alur uang dulu (orang bisa membuat, membagikan, dan
membayar), baru tambah pemanis. Fitur yang sengaja ditunda ke setelah rilis:
amplop digital, musik latar, galeri multi-foto, domain kustom per undangan,
dan analitik lanjutan.

## Posisi sekarang

Sudah selesai:
- Landing, katalog, editor pratinjau, contoh undangan, harga rupiah
- Database SQLite, auth scrypt + sesi, dasbor admin, dasbor pengguna
- Undangan tamu `/u/[kode]` + RSVP (anti-ganda per nama, maks 10 tamu)
- Deploy Dockerfile di Coolify dengan volume persisten + seed otomatis
  kalau database masih kosong

Masih bolong (ini yang diselesaikan rencana ini):
- Editor belum menyimpan apa pun — undangan yang tersimpan hari ini dibuat
  lewat formulir dasbor, bukan dari editor yang dilihat pengunjung
  (selesai Tahap 1)
- Belum ada pembayaran sungguhan — paket harga baru pajangan
  (selesai di kode Tahap 2; uji Sandbox Midtrans masih menunggu kunci)
- Belum ada batas paket yang ditegakkan (jumlah undangan aktif, masa aktif)
  (selesai Tahap 2)
- Database masih SQLite berkas lokal + foto sampul di dalam container
  (selesai di kode Tahap 4: backend Postgres opsional + foto ke volume
  /data; verifikasi Postgres sungguhan dan redeploy masih tertunda)
- Belum ada halaman syarat/ketentuan, privasi, dan bantuan
  (selesai di kode Tahap 5; uji beta + checklist peluncuran masih
  menunggu tindakan manusia, dan kriteria "satu pelanggan bukan penguji
  internal membeli + RSVP masuk" belum terjadi)

## Tahap 1 — Editor yang benar-benar menyimpan (inti produk) — SELESAI 31 Okt 2026

Selesai di kode dan terverifikasi sebatas yang bisa dites di sandbox ini
(lihat catatan pengujian di bawah). Yang belum dites: klik-tayang penuh di
peramban sungguhan — server action POST gagal di sandbox ini untuk SEMUA
aksi (termasuk RSVP lama yang dulu pernah jalan) dengan galat "Connection
closed", dan browser uji tidak bisa menjangkau server lokal VM ini
(localhost ditolak, tunnel gagal karena egress proxy). Verifikasi ulang
klik-tayang disarankan di situs Coolify setelah push, dengan akun uji yang
lalu dibersihkan.

Tujuan: pengunjung yang mencoba editor bisa berakhir dengan undangan
nyata yang bisa dibagikan, bukan cuma pratinjau yang hilang saat refresh.

- Editor tetap bisa dicoba tanpa login; state editor disimpan otomatis di
  perangkat (localStorage) supaya tidak hilang kalau pengguna diminta login
- Tombol Simpan: kalau belum login, arahkan ke daftar/masuk, lalu kembali
  ke editor dengan data yang tadi masih utuh; kalau sudah login, simpan
  sebagai undangan milik pengguna itu (status awal Draft)
- Setelah simpan, arahkan ke dasbor pengguna dengan tautan tamu yang jelas
  dan tombol bagikan
- Halaman tamu mendapat tombol bagikan WhatsApp (pesan terisi: nama acara,
  tanggal, dan tautan `/u/[kode]`) dan tombol salin tautan
- Kriteria selesai: dari HP, orang asing bisa buka editor, isi data, daftar,
  simpan, buka tautan tamu, dan RSVP-nya muncul di dasbor pemilik

## Tahap 2 — Pembayaran Midtrans (kunci monetisasi)

**Status: SELESAI DI KODE 31 Okt 2026, MENUNGGU UJI SANDBOX.** Uji
end-to-end dengan Midtrans Sandbox belum bisa jalan karena kunci Sandbox
belum ada (lihat "Keputusan yang dibutuhkan" di bawah + README bagian
"Pembayaran Midtrans"). Jangan tandai Tahap 2 tuntas sepenuhnya sebelum
uji Sandbox lolos.

Yang sudah dibangun (semua di kode, build lolos, logika dites tanpa kunci
Midtrans — lihat catatan pengujian di bawah):

- Tabel `pesanan` + `langganan`, kolom `paket_harga.maks_undangan_aktif`
  (Hemat 1, Populer 3, Keluarga Besar 10) + migrasi otomatis di `lib/db.ts`
- Checkout Snap Redirect dari `/akun/paket` (token + redirect_url dari API
  Midtrans, tanpa pustaka eksternal — `lib/midtrans.ts`), halaman satu
  pesanan `/akun/pembayaran/[id]` (tombol lanjut bayar / coba lagi token)
- Webhook `/api/midtrans/notifikasi`: verifikasi SHA512, cocokkan nominal,
  idempotent, satu-satunya jalur yang mengubah status jadi Lunas dan
  mengaktifkan langganan
- Penegakan batas di `ubahStatusUndanganPengguna` dan
  `tambahUndanganPengguna` (status Aktif); Draft selalu gratis
- Kedaluwarsa malas di dasbor + halaman tamu (langganan habis → Selesai,
  undangan Aktif ikut Selesai)
- Riwayat pembayaran di `/akun`, daftar pesanan + langganan di
  `/admin/pesanan`, tombol "Beli Paket Ini" di kartu harga landing
- Kunci hanya lewat environment variable (`.env.example` diperbarui)

Keputusan yang diambil saat eksekusi (bisa diubah, tapi dicatat supaya
tidak hilang):

- **Draft gratis, Aktif wajib paket** — sesuai opsi yang diajukan di rencana
  awal ("1 undangan Draft gratis, Aktif wajib paket"). Belum ada masa
  gratis berbatas waktu; kalau user mau trial gratis, itu fitur baru.
- **Durasi mengikuti periode bayar (bulanan 30 hari, tahunan 1 tahun)**,
  BUKAN durasi per paket 30/90/365 hari. Alasannya: teks katalog lama
  ("Masa aktif 30/90/365 hari per undangan") bertentangan dengan arti
  bulanan/tahunan (bayar tahunan Hemat 490rb tapi cuma aktif 30 hari
  tidak masuk akal). Teks katalog diubah jadi "Masa aktif selama
  langganan berjalan" (di `data/toko.json` + `data/paketHarga.ts`).
  Satu-satunya tempat yang menentukan durasi: `durasiHariPeriode()` di
  `lib/midtrans.ts` — mengubah aturan durasi = ubah fungsi itu saja.
- **Langganan baru menggantikan yang lama** (status Diganti), masa aktif
  tidak ditumpuk.
- **Harga dipakai apa adanya dari katalog** (49rb/99rb/199rb bulanan,
  490rb/990rb/1.990rb tahunan) — belum ada konfirmasi final dari user
  bahwa harga ini final; kalau berubah, ubah lewat dasbor admin / harga
  (nominal di database, bukan hardcode di kode bayar).

Catatan pengujian Tahap 2 (31 Okt 2026): build lolos; fungsi murni
(signature, badan Snap, slot, kedaluwarsa) dites via tsx; webhook dites
via curl dengan tanda tangan buatan (kunci uji lokal) termasuk idempotensi
dan penolakan tanda tangan salah; token Snap dites lewat mock server
lokal (bukan Midtrans sungguhan) karena kunci Sandbox belum ada; POST
server action tetap tidak bisa dites di sandbox ini (masalah lingkungan
yang sama seperti Tahap 1 — "Connection closed"), jadi klik-tayang
checkout harus dites di Coolify setelah kunci Sandbox dipasang.

Tujuan: paket harga yang sekarang cuma pajangan bisa dibeli dan
mengaktifkan batas yang dijanjikan.

- Akun Midtrans (mulai dari Sandbox, produksi setelah diuji) — kunci API
  hanya lewat environment variable di Coolify, tidak pernah masuk repo
- Tabel pesanan + langganan: paket yang dibeli, nominal, status bayar,
  tanggal mulai dan berakhir
- Checkout dengan Midtrans Snap dari halaman harga / dasbor pengguna,
  dan webhook notifikasi yang mengubah status pesanan menjadi lunas
- Penegakan batas: Hemat = 1 undangan aktif, Populer = 3, Keluarga Besar =
  10; masa aktif 30 / 90 / 365 hari. Undangan yang melewati masa aktif
  berubah menjadi Selesai (halaman tamu tetap bisa dilihat, RSVP ditutup —
  aturan yang sama dengan yang sudah ada)
- Riwayat pembayaran di dasbor pengguna; daftar pesanan di dasbor admin
- Kriteria selesai: pembayaran Sandbox end-to-end jalan (pilih paket →
  bayar → webhook → paket aktif → batas undangan aktif ditegakkan, dan
  percobaan membuat undangan aktif melebihi batas ditolak dengan pesan
  yang jelas, bukan error kosong)

Masih terbuka (butuh user, menghambat uji Sandbox — bukan menghambat kode):

- **Akun Midtrans Sandbox sudah ada atau belum?** Kalau belum, user harus
  daftar di Midtrans dan memasang `MIDTRANS_SERVER_KEY` +
  `MIDTRANS_CLIENT_KEY` di environment Coolify, plus mengatur Payment
  Notification URL dan Finish Redirect URL di dasbor Midtrans (detail di
  README). Tanpa ini, tombol bayar akan gagal dengan pesan jelas dan
  pesanan tetap Menunggu — itu perilaku yang disengaja, bukan bug.
- **Harga paket sudah final?** Saat ini dipakai apa adanya dari katalog
  (49rb/99rb/199rb bulanan). Kalau mau diubah, ubah lewat dasbor admin.

## Tahap 3 — RSVP yang lebih berguna untuk penyelenggara

**Status: SELESAI 31 Okt 2026 (di kode; klik-tayang di peramban tetap
perlu dicek di Coolify setelah push, karena POST server action tidak bisa
dites di sandbox ini — tapi unduh CSV dan filter adalah GET, jadi keduanya
sudah dites lewat curl di server produksi lokal, lihat catatan pengujian
di bawah).**

Yang dibangun:

- Ekspor CSV (`/api/rsvp/[id]/csv`, tombol di detail admin + pengguna):
  hanya admin dan pemilik undangan; tanpa sesi diarahkan ke `/masuk`.
  CSV selalu berisi SEMUA balasan (bukan yang terfilter) dengan urutan
  yang sama seperti dasbor, format RFC 4180 + BOM UTF-8, label kehadiran
  sama seperti dasbor (Hadir / Masih ragu / Tidak bisa hadir).
- Filter daftar RSVP (`?kehadiran=Hadir/Ragu/Tidak`) di detail admin dan
  pengguna, dengan hitungan per status di tombol filter. Ringkasan tetap
  dari daftar penuh — filter tidak mengubah angka ringkasan.
- Sorotan "Tamu yang akan datang" di atas kartu ringkasan kedua halaman
  detail: jumlah tamu dari balasan Hadir saja, dengan penjelasan bahwa
  Ragu belum dihitung dan Tidak tidak dihitung.

Catatan pengujian Tahap 3 (31 Okt 2026): build lolos; builder CSV dites
via tsx (escaping koma/petik/baris baru, BOM, header, jumlah baris);
filter + ringkasan dites via tsx di database uji (jumlah baris CSV =
totalBalasan, jumlah tamu Hadir di CSV = totalTamuHadir); route CSV dites
via curl di server produksi lokal dengan cookie sesi buatan (pemilik
dapat 200 + attachment CSV, orang lain 403, tanpa sesi diarahkan ke
/masuk, admin dapat 200); halaman detail terfilter dites via curl
(?kehadiran=Ragu hanya menampilkan nama Ragu). Yang belum dites di
peramban sungguhan: klik tombol Unduh CSV dan klik tombol filter (GET,
risiko rendah — tapi tetap cek sekali di Coolify setelah push).

Tujuan: dasbor RSVP yang sekarang sudah ada menjadi alasan orang tetap
memakai produk ini sampai hari H, bukan sekadar formulir.

- Ekspor RSVP ke CSV (admin dan pemilik undangan) dengan hitungan yang
  sama dengan yang tampil di dasbor
- Filter daftar RSVP berdasarkan kehadiran (Hadir / Ragu / Tidak) di
  detail undangan admin dan pengguna
- Ringkasan tamu yang lebih jelas di dasbor: total tamu yang akan datang
  (bukan cuma jumlah balasan)
- Kriteria selesai: pemilik undangan bisa mengunduh CSV yang isinya sama
  persis dengan angka di dasbor, dan bisa menemukan semua tamu yang
  "Masih ragu" dalam satu filter

## Tahap 4 — Fondasi produksi yang benar (sebelum scale, sesudah ada pembeli) — SELESAI DI KODE 31 Okt 2026, BELUM di-push; verifikasi Postgres sungguhan + jadwal cadangan otomatis masih tertunda (lihat bawah)

Tujuan: produk tidak rapuh saat dipakai banyak orang. Sengaja diletakkan
sesudah pembayaran supaya monetisasi tidak tertunda oleh pekerjaan
infrastruktur.

Yang dibangun (31 Okt 2026):

- **Dua backend database di `lib/db.ts` (bukan "ganti berkas saja"):**
  SQLite tetap default; Postgres aktif kalau `DATABASE_URL` diawali
  `postgres://`/`postgresql://` (driver `pg`, Pool). Skema dan kueri sama
  di kedua backend; placeholder `?` diterjemahkan ke `$1, $2, ...` dengan
  pemindai literal string yang benar. Konsekuensi yang tidak bisa
  dihindari: semua fungsi lapisan database menjadi ASINKRON (Postgres
  tidak punya API sinkron), jadi seluruh pemanggil dikonversi ke
  await — TypeScript menandai pemanggil yang lupa await sebagai galat,
  dan build lolos bersih setelah konversi. `DATABASE_URL="pg-mem://"`
  memakai emulator Postgres di memori, KHUSUS pengujian, dan ditolak
  di produksi (`NODE_ENV=production`) supaya tidak ada yang tidak
  sengaja mengetes di produksi (penolakan ini terbukti bekerja saat
  server produksi tidak sengaja dijalankan dengan `pg-mem://`).
- **Skrip migrasi `scripts/migrasi-ke-postgres.ts`:** menyalin pengguna,
  templat, paket_harga, undangan, pesanan, langganan, RSVP, dan
  percobaan_rsvp dalam urutan foreign key; menolak jalan kalau target
  sudah berisi data; tabel `sesi` sengaja dilewati (sesi lama hangus,
  pengguna login ulang sekali); hash kata sandi ikut pindah apa adanya;
  jumlah baris sumber vs tujuan diverifikasi per tabel.
- **Foto tahan redeploy (tanpa volume tambahan):** `UNGGAHAN_DIR` di
  image diatur ke `/data/unggahan` — di dalam volume persisten yang
  sudah dipasang untuk database. Jalur publik tetap `/unggahan/<nama>`
  lewat route `/api/unggahan/[nama]` + rewrite beforeFiles, dengan
  fallback ke `public/unggahan` untuk berkas lama. Storage objek tetap
  menjadi langkah final kalau nanti pindah ke serverless murni.
- **Cadangan SQLite + restore yang sudah dibuktikan:** skrip
  `scripts/cadangkan-db.mjs` (VACUUM INTO — boleh jalan saat server
  hidup, verifikasi salinan, retensi default 7) dan
  `scripts/pulihkan-db.mjs` (verifikasi cadangan, tolak kalau ada berkas
  jurnal, salinan pengaman sebelum menimpa). Restore dites: baris palsu
  yang ditambahkan setelah cadangan hilang setelah pulih.
- **Healthcheck:** `GET /api/sehat` (200 kalau aplikasi + database hidup,
  500 kalau tidak, dengan log penyebab di server) + HEALTHCHECK di
  Dockerfile. Di Coolify, pakai path `/api/sehat`.
- **Pengaman spam RSVP:** honeypot (`situs_web` tersembunyi), jeda
  minimum 3 detik dari render halaman, dan batas 20 kiriman per jam per
  IP per undangan (tabel `percobaan_rsvp`, hanya hash IP — garam dari
  `RSVP_IP_SALT`; baris >1 jam terhapus otomatis di setiap pengecekan).
- **Entrypoint:** `scripts/perlu-seed.mjs` kini bercabang SQLite dan
  Postgres (memakai `pg`); untuk `pg-mem://` selalu menjawab "ya".

Catatan pengujian Tahap 4 (31 Okt 2026): build lolos; tes paritas alur
penuh (seed, paket, langganan + kedaluwarsa, RSVP + ringkasan + CSV,
anti-spam, placeholder) LULUS IDENTIK di SQLite dan di emulator
Postgres (pg-mem); skrip migrasi SQLite→pg-mem lolos dengan verifikasi
jumlah baris per tabel; regresi HTTP di server produksi lokal (SQLite):
sehat 200, formulir tamu mengandung honeypot + waktu_muat, /akun/paket
render, webhook settlement → Lunas + langganan Populer aktif, matriks
CSV (pemilik 200, admin 200, bukan pemilik 403); server dev dengan
pg-mem: sehat 200 + beranda 200; perlu-seed tiga cabang lolos.
Yang BELUM terverifikasi (jujur dicatat, bukan diklaim):
(1) server Postgres SUNGGUHAN — di lingkungan ini tidak ada server
Postgres (Docker tidak tersedia; `apt-get update` menggantung >10 menit
lalu dimatikan; registry npm justru bisa dijangkau, jadi pengujian
memakai pg-mem). Sebelum produksi pindah ke Postgres: buat database
Postgres kosong, jalankan skrip migrasi, ganti `DATABASE_URL`, redeploy,
lalu verifikasi login pengguna lama + undangan/RSVP lama + satu
pembelian baru. Sampai itu lolos, SQLite tetap backend produksi yang
didukung. (2) Jadwal cadangan OTOMATIS — skrip + retensi + restore
sudah ada dan dites, tapi cron hariannya belum terpasang di mana pun
(pasang satu cron host/Coolify yang menjalankan skrip di dalam container).
(3) Foto setelah redeploy di Coolify — kodenya sudah siap dan route-nya
dites lokal, tapi redeploy sungguhan belum dijalankan.
Kriteria selesai asli ("deploy di Coolify dengan Postgres...") karena
itu BELUM terpenuhi penuh: Tahap 4 selesai di kode, bukan selesai
di produksi. Tahap 5 boleh jalan tanpa menunggu Postgres, karena
SQLite tetap didukung penuh.

## Tahap 5 — Rilis — SELESAI DI KODE 31 Okt 2026, BELUM di-push; uji beta + checklist peluncuran menunggu tindakan manusia (lihat DAFTAR-PELUNCURAN.md)

Tujuan: produk bisa diumumkan tanpa malu-malu dan tanpa kejutan di hari
pertama pelanggan bayar.

Yang dibangun (31 Okt 2026):

- **Halaman legal dan bantuan (statis, kecuali Bantuan):** `/syarat`
  (Syarat & Ketentuan), `/privasi` (Kebijakan Privasi), `/bantuan`
  (panduan + masalah umum + kontak). Isinya ditulis sesuai perilaku
  produk yang sebenarnya, bukan templat generik: Draft gratis, Aktif
  butuh langganan, langganan baru menggantikan yang lama, pembayaran
  lewat Midtrans tanpa nomor kartu tersimpan, pengembalian dana manual,
  pesan RSVP tampil publik bagi pemegang tautan, cookie hanya sesi
  login 8 jam, hash IP RSVP terhapus setelah 1 jam, tidak ada pelacak
  iklan/analitik. `/bantuan` sengaja `force-dynamic` karena bagian
  Kontaknya membaca environment `DUKUNGAN_EMAIL` /
  `DUKUNGAN_WHATSAPP_URL` saat request — kalau keduanya belum dipasang,
  halaman menampilkan pemberitahuan jujur bahwa kontak belum diumumkan,
  dan itu adalah item BLOKIR di checklist peluncuran.
- **SEO dasar:** metadataBase + Open Graph + Twitter card di layout
  (juga metadata Beranda); metadata per halaman untuk Katalog, Editor,
  Masuk, Daftar, Syarat, Privasi, Bantuan; `app/sitemap.ts` (hanya
  halaman publik yang layak diindeks) dan `app/robots.ts` (larang
  /admin, /akun, /api, /u — undangan tamu bersifat pribadi); Open Graph
  dinamis untuk halaman tamu lewat `generateMetadata` (judul nama +
  jenis acara, deskripsi tanggal/lokasi + ajakan RSVP hanya kalau
  status Aktif, foto undangan/sampul kalau ada — SENGAJA tanpa foto
  picsum cadangan supaya pratinjau tidak menampilkan foto stok acak).
  Alamat situs dari `SITUS_URL` (fallback domain produksi saat ini).
- **Perbaikan salinan basi (kejujuran peluncuran):** footer tidak lagi
  mengklaim "belum ada pembayaran sungguhan" (salah sejak Tahap 2) dan
  kini menautkan Syarat/Privasi/Bantuan; dua jawaban FAQ landing yang
  sudah salah diperbaiki (edit data undangan: belum bisa, hapus dan
  buat ulang; biaya tersembunyi: tidak ada, pembayaran lewat Midtrans).
- **Checklist peluncuran (`DAFTAR-PELUNCURAN.md`):** gerbang pengumuman
  dengan item BLOKIR yang jelas — Midtrans Production + satu uji beli
  sungguhan, kontak dukungan, cron cadangan + uji pulih di salinan,
  healthcheck Coolify, harga final, akun admin cadangan, uji beta 3–5
  pengguna nyata (tugas langkah demi langkah dari HP, termasuk beli
  Hemat Rp 49.000 dengan tawaran ganti rugi manual), smoke test akhir,
  dan kriteria selesai. Yang sengaja TIDAK memblokir: pindah Postgres
  dan fitur setelah rilis.

Catatan pengujian Tahap 5 (31 Okt 2026): build lolos (/bantuan
dinamis, /syarat + /privasi statis, /sitemap.xml + /robots.txt ada);
server produksi lokal: /syarat + /privasi + /bantuan 200 dengan isi
yang benar (Midtrans, scrypt, pemberitahuan kontak belum diumumkan
saat env kosong); sitemap berisi halaman legal tanpa /u dan /admin;
robots melarang /admin, /akun, /api, /u; OG tamu Aktif berjudul nama +
jenis acara dengan deskripsi ajakan RSVP dan TANPA og:image picsum
saat tidak ada foto; OG tamu Selesai memakai deskripsi "Lihat detail"
(bukan ajakan RSVP); tamu Draft 404 tanpa nama bocor di og:title;
footer menautkan Syarat/Privasi/Bantuan dan tidak ada lagi klaim basi
di beranda; judul metadata per halaman (Katalog, Editor, Masuk,
Daftar) benar; /bantuan dengan DUKUNGAN_EMAIL menampilkan mailto dan
pemberitahuan "belum diumumkan" hilang. Yang BELUM terverifikasi dan
TIDAK BOLEH diklaim selesai: uji beta (butuh manusia), checklist
peluncuran (butuh tindakan manusia di Coolify/Midtrans), dan kriteria
selesai (satu pelanggan bukan penguji internal membeli + RSVP masuk).
Tahap 5 selesai di kode, bukan selesai di pasar.

## Setelah rilis (sengaja bukan bagian dari "selesai")

Amplop digital, musik latar, galeri multi-foto, domain kustom per
undangan, analitik lanjutan, dan tema template baru. Semua itu bagus,
tapi tidak boleh menunda rilis berbayar pertama.

## Urutan yang direkomendasikan

Tahap 1 → Tahap 2 → Tahap 3 → Tahap 4 → Tahap 5.
Alasannya: Tahap 1 membuat produk utuh, Tahap 2 membuat produk
menghasilkan uang, Tahap 3 membuat produk dipertahankan sampai hari H,
Tahap 4 membuat produk tahan scale, Tahap 5 memastikan rilisnya bersih.
Membalik Tahap 4 ke depan hanya akan menunda uang masuk tanpa menambah
satu pun pelanggan.

## Dasbor admin langganan & pendapatan (31 Okt 2026, di luar Tahap 1–5)

Desain dasbor admin (mockup) digabung ke proyek sebagai `/admin` baru
dengan data asli, bukan angka contoh: `lib/dasborAdmin.ts` (MRR,
langganan aktif, pengguna, churn 30 hari, pendapatan lunas 12 bulan,
sebaran paket, aktivitas, pencarian global, CSV aktivitas),
`komponen/ShellAdmin.tsx` (sidebar + drawer ponsel + topbar cari +
lencana Menunggu/Gagal + profil), halaman baru `/admin/langganan`,
`/admin/pengguna`, `/admin/cari`, `/admin/rsvp` (isi RSVP Ringkasan
lama pindah ke sini), dan route `/api/admin/aktivitas/csv` (admin
saja). Definisi metrik ditulis di header `lib/dasborAdmin.ts` dan di
halaman Ringkasan. Tes: tsc + build lolos; asersi tsx di DB uji lolos
(MRR 313.833, churn 25%, pendapatan per bulan, sebaran paket,
aktivitas + filter + CSV + pencarian); matriks curl server produksi
lolos (semua halaman admin 200 dengan sesi admin, 307 ke
`/admin/login` tanpa sesi/bukan admin, CSV 200 admin / 403 bukan
admin). Satu temuan tes yang BUKAN bug: `formatRupiah` memakai spasi
non-breaking (bawaan Intl id-ID), jadi grep harfiah "Rp 313.833"
gagal padahal nilainya tampil benar. Belum di-push (menunggu perintah
push); belum dites klik-tayang di peramban (keterbatasan sandbox yang
sudah diketahui: server action POST gagal "Connection closed", tapi
halaman baru ini hanya memakai GET + tautan, jadi tidak kena batas
itu).

## Perbaikan mobile frontend (31 Okt 2026, BELUM di-push)

Audit menemukan frontend sebenarnya sudah responsif di sebagian besar
halaman (grid runtuh, formulir 48px, halaman tamu max-w-md), tapi ada
satu bug overflow nyata di navigasi ponsel: baris tautan mobile tanpa
flex-wrap dan pil navigasi yang terlalu lebar di layar ~320px.
Perbaikan: brand mengecil + truncate + tombol "Buat Undangan" lebih
ramping di ponsel, baris tautan mobile membungkus, salinan editor
menjadi netral posisi ("isi datanya, lihat hasilnya di pratinjau" —
dulu "di kiri/di kanan" padahal di ponsel pratinjau ada di bawah),
tombol pilih templat lebih kecil di ponsel, email panjang di /akun
memakai break-words, dan `overflow-x: clip` di body sebagai pengaman
(tidak merusak sticky, tidak seperti hidden). Yang dicek dan ternyata
BUKAN bug: meta viewport sudah benar (bawaan Next), semua blob cahaya
sudah di dalam parent overflow-hidden, dan tautan min-h yang tampak
inline ternyata flex item sehingga min-height-nya berlaku. Tes: tsc +
build lolos, semua halaman publik 200, penanda HTML baru terverifikasi
di server produksi lokal (DB uji). Klik-tayang visual di ponsel
sungguhan belum dites (keterbatasan sandbox) — cek sekali di HP
setelah redeploy.

## Navbar ponsel jadi drawer (31 Okt 2026, BELUM di-push)

Umpan balik pengguna setelah redeploy (mode incognito, HP): navbar
masih menumpuk. Penyebabnya: baris tautan kedua membungkus jadi dua
baris di layar ~360px, dan pil navigasi sesak di 320px. Perbaikan:
baris tautan kedua DIHAPUS; ponsel hanya menampilkan logo + tombol
hamburger, semua tautan (Buat Undangan, Beranda, Katalog, Editor,
Harga, Admin, Masuk) pindah ke drawer geser kanan dengan backdrop,
Escape, dan tutup otomatis setelah memilih menu — pola yang sama
dengan dasbor admin. Drawer tertutup memakai `invisible` (bukan cuma
geser keluar layar) supaya tidak bisa difokus keyboard. Desktop tidak
berubah. Tes: tsc + build lolos, HTML beranda memuat tombol hamburger
+ drawer + tautan desktop, baris tautan lama hilang, halaman publik
200. Catatan: folder /tmp dibersihkan runtime sehingga DB uji lama
hilang di tengah pengujian — DB uji kini di ~/workspace/dasbor-uji/
(supaya awet) dan pemeriksaan server-wajib-hidup dulu sebelum klaim
lulus, supaya hasil kosong tidak terbaca sebagai lulus.

## Templat halaman penuh Zamrud (31 Okt 2026, SUDAH di-push 17:15 WIB — redeploy Coolify menunggu user)

Replika pengalaman referensi wedding.benifin.my.id sebagai opsi template
baru — dibangun ulang dengan kode dan aset sendiri, bukan salinan
kode/foto/musik/data referensi. Koreksi penting dari analisa: opening
referensi ternyata bukan animasi amplop sinematik, melainkan sampul
layar penuh + reveal + musik saat tombol ditekan; Zamrud memakai pola
yang sama (sampul fade+zoom 750ms + musik mulai saat dibuka).
Isi: sampul (The Wedding Of, nama script, tanggal, Tamu Undangan),
panel hero tetap di desktop + hero ponsel, mempelai (monogram +
nama orang tua), ayat & doa (Basmalah + teks bingkai orisinal),
acara (Maps + Google Calendar), hitung mundur live per detik,
busana (4 swatch Zamrud/Sage/Champagne/Ivory), galeri geser +
lightbox (sebelum/sesudah, unduh, Escape), RSVP (aksi kirimRsvp yang
sama + anti-spam), ucapan & doa dari RSVP, penutup + bagikan
(WhatsApp + salin tautan). Aset baru: 4 gambar AI tanpa orang
(public/templat/zamrud: masjid, galeri-bunga, galeri-lentera,
galeri-arsitektur) + musik instrumental hasil Ace Music
(public/musik/zamrud.mp3, ~833 KB, loop; tombol musik hanya tampil
kalau berkasnya ada, dicek halaman tamu lewat fs).
Perubahan data: kolom templat.halaman_penuh + undangan.orang_tua_*
(migrasi + skema), seed upsert diperbarui, skrip baru
scripts/tambah-templat-baru.mjs (hanya INSERT yang belum ada, tanpa
menimpa edit admin) yang dipanggil entrypoint Docker setiap start —
inilah yang memunculkan Zamrud di produksi setelah redeploy (seed
penuh dilewati kalau DB sudah berisi). Editor: kolom orang tua hanya
muncul kalau template halaman penuh dipilih. Navigasi situs global
tetap tampil di atas undangan Zamrud (konsisten dengan halaman tamu
lama); drawer menu undangan + tombol musik mengambang di kanan bawah.
Yang SENGAJA belum ada di v1 (butuh kolom data baru, bukan teks
karangan): kisah perjalanan dan tanda kasih (rekening) — lanjutan
yang direncanakan, bukan diisi data palsu. Tes: tsc + build lolos;
server DB uji (salinan dev.db lama): semua penanda halaman Zamrud
hadir (sampul, nama, orang tua, hitung mundur, busana, galeri, RSVP,
ucapan, musik, gambar), halaman kartu lama + Draft 404 + katalog +
editor tetap jalan, musik/gambar 200. Catatan push (31 Okt 17:15 WIB,
3 commit: 25b291d2 kode, 7e9a2980 + 3392a188 aset): tool push hanya
menerima UTF-8 dan payload 5,58 MB kena HTTP 413, jadi 5 aset biner
disimpan sebagai .b64 di repo dan di-decode di tahap builder
Dockerfile (gagal decode = build gagal jelas, bukan berkas kosong).
Aturan ke depan: aset biner baru wajib .b64 + decode di Dockerfile,
dan jangan redeploy di antara commit kode dan commit aset (build
akan lolos tapi aset 404). Catatan pengujian: perintah
`cd ... && server &` membackground seluruh rantai — server tetap
jalan, tapi cek dev.db terakhir salah direktori; dev.db diverifikasi
terpisah tetap 69.632 byte, mtime 13:09.

## Koreksi opening Zamrud: splash intro (31 Okt 2026, sudah ikut di-push 17:15 WIB)

Pengecekan desktop pertama melewatkan splash intro referensi; screenshot
pengguna + pengecekan ulang membuktikan urutan sebenarnya: layar hijau
zamrud gelap kosong -> splash monogram serif besar + nama script
tengah (fade-in satu blok, tanpa foto/ornamen/tombol) -> splash memudar
sendiri sementara sampul di bawahnya mencerah (cross-dissolve, total
~2 detik) -> sampul (nama serif bertumpuk, kartu tamu gelap, tombol
pil gelap berikon amplop) -> tekan Buka Undangan: fade/reveal cepat +
musik mulai. Zamrud disesuaikan persis urutan itu (tahap
intro -> sampul -> membuka -> terbuka; sampul redup selama intro).
Verdict mobile referensi dari pengecekan ulang: kolom tunggal rapi,
tidak ada yang meluber; countdown tetap 4 kotak sebaris (sempit tapi
terbaca di 390px); teks timeline sempat tampak samar sesaat saat
fade-in (normal, bukan rusak). Catatan: browser uji tidak bisa
mengatur viewport 390px persis — cek perangkat sungguhan tetap
disarankan sebelum meniru layout mentah-mentah.

## Zamrud v2: kolom form lengkap (31 Okt 2026, sudah di-push — lihat catatan sinkronisasi)

Menutup 4 gap vs referensi yang dicatat saat evaluasi live 31 Okt 18:09 WIB
(undangan uji Seruni xhmh87d9 + katalog 4 template pasca-redeploy):
kisah perjalanan, tanda kasih, acara kedua, galeri multi-foto.
Semuanya hanya untuk templat halaman penuh (Zamrud); templat lama tidak
berubah, dan undangan lama tanpa data baru tetap tampil seperti v1
(seksi tersembunyi + menu drawer ikut menyaring tautan seksi yang tidak
dirender — perbaikan dari temuan tes: menu sempat membocorkan label
"Kisah Kami"/"Tanda Kasih" ke undangan lama).

Perubahan data: 10 kolom baru di undangan (kisah_json JSON array maks 3
babak judul+cerita, video_kisah, rekening_bank/nomor/nama, alamat_kirim,
acara_waktu, acara_kedua_judul/waktu/lokasi — semua opsional dengan
default, jadi migrasi ringan di lib/db.ts + skema.sql) + tabel baru
foto_galeri (FK CASCADE ke undangan, urutan unggah). Migrasi jalan saat
aplikasi membuka database, jadi database produksi lama ikut ter-upgrade
saat redeploy tanpa langkah manual.

Editor: seksi Waktu & acara kedua, Galeri foto tambahan (input multiple,
maks 6 foto @5 MB, aturan sama dengan foto utama), Kisah perjalanan
(3 babak + tautan video YouTube), Tanda kasih — semuanya di belakang
`templatTerpilih.halamanPenuh`, ikut draf localStorage (foto tidak ikut,
seperti foto utama), dan kode galat baru galeri-besar/galeri-tipe/
galeri-gagal di halaman editor. Aksi simpan: proses foto galeri SEBELUM
insert (seperti foto utama), insert foto_galeri per jalur dengan urutan.

Halaman tamu: kisah dirender sebagai timeline + embed YouTube
(youtube-nocookie; hanya watch/youtu.be/shorts/embed yang lolos, tautan
lain tidak di-iframe); acara dirender 1–2 kartu (kartu kedua kalau judul
atau waktunya diisi, lokasi kosong = lokasi utama; tombol Calendar hanya
di kartu utama); tanda kasih dirender kalau rekening atau alamat diisi,
dengan tombol salin masing-masing; galeri = foto utama + foto_galeri +
4 aset statis (dedup). Yang masih belum ada (bukan kolom form): ganti
tema dan like pada ucapan.

Tes: tsc + build lolos; server DB uji (salinan zamrud.db): migrasi
menambah 10 kolom + tabel foto_galeri; undangan uji v2 Aktif
(v2uji001, semua field terisi) menampilkan SEMUA penanda (2 babak kisah,
embed youtube-nocookie, rekening, alamat, 2 kartu acara, 2 foto galeri,
tombol salin); undangan lama zamr2027 tetap 200 dengan seksi baru
tersembunyi dan menu bersih; editor Zamrud menampilkan 16 input baru,
editor Seruni tidak membocorkan satu pun; beranda/katalog/sehat 200.
Belum bisa dites dari sandbox (batas lama): klik Simpan editor di
peramban sungguhan (POST server action) — verifikasi di produksi setelah
deploy: buat undangan Zamrud, isi field baru, simpan, aktifkan, buka
tautan tamu. dev.db lokal tidak tersentuh (69.632 byte, mtime 13:09).

## Revisi halaman tamu (31 Okt 2026, sudah di-push, head d7122fad)

Berangkat dari undangan Zamrud live /u/nvjvq95c. Yang diubah (hanya
jalur tamu; autentikasi, routing, dan halaman lain tidak disentuh):

- Bar konfirmasi persisten (komponen/BarKonfirmasi.tsx, baru): tombol
  emas "Konfirmasi Kehadiran" di bawah layar, hanya saat RSVP dibuka.
  Di Zamrud, sampul (z-70) menutupi bar (z-40) sampai terbuka.
- Hero memuat lokasi + tombol emas konfirmasi (hanya saat Aktif);
  drawer menu mendapat entri emas konfirmasi di urutan pertama.
- Kontrol sekunder (musik, menu) pindah ke kanan atas; jangkar
  scroll-mt-28 menjadi scroll-mt-6 (header lengket sudah tidak ada).
- Navigasi + footer situs mengembalikan null di /u/* (usePathname) —
  tamu tidak lagi melihat tautan Admin/Masuk atau footer pemasaran.
- loading.tsx (kerangka sampul + teks status), not-found.tsx
  ("Tautan ini belum bisa dibuka"), error.tsx ("Coba lagi") di
  app/u/[kode]/. Catatan: dengan loading.tsx, Next mengirim shell
  sebagai 200 sebelum notFound() terlempar (soft-404, terbukti lewat
  eksperimen) — dipertahankan karena /u/* dilarang robots dan tamu
  melihat halaman ramah yang sama.
- Hitung mundur: angka berdetak aria-hidden + ringkasan sr-only.
  Formulir: autoComplete="name", aria-describedby pada select jumlah.
  Judul RSVP menjadi "Konfirmasi Kehadiran"; salinan penutup dibuat
  netral (Selesai juga bisa berarti langganan kedaluwarsa).
- Pengujian tests/halaman-tamu.tsx (script "uji:tamu"): 32 asersi lulus
  (renderToString BarKonfirmasi + HTTP server fixture: Zamrud Aktif /
  Selesai / Draft, kartu lama Aktif, kode hilang). Skrip memakai
  detached group kill + pra-pemeriksaan port supaya tidak ada server
  yatim. Perilaku ketuk tetap diverifikasi lewat browser pasca-deploy.
- Dokumentasi: docs/halaman-tamu.md (komponen, props, status, cara uji).

Redeploy Coolify MENUNGGU user; setelah redeploy, verifikasi di HP
sungguhan: bar konfirmasi, tombol hero, drawer menu, musik, scroll,
dan halaman 404 ramah untuk tautan Draft/hilang.

## Restruktur layout + audit UX (31 Okt 2026, sudah di-push, head 418e4200)

Aturan baru, menggantikan gate pathname revisi tamu: header + footer
situs hanya dipasang di tata letak grup (situs) — app/(situs)/layout.tsx
— yang menaungi halaman website (landing, katalog, bantuan, syarat,
privasi, daftar, masuk). Tata letak akar (app/layout.tsx) kini polos.
Halaman aplikasi (admin, /akun, /editor, /u, /undangan) mewarisi tata
letak polos sehingga tampil penuh tanpa chrome situs. Grup rute tidak
mengubah URL. Gate usePathname di Navigasi/KakiHalaman DICABUT;
KakiHalaman kembali jadi komponen server. Admin tetap memakai
ShellAdmin-nya sendiri (sidebar + drawer).

Audit + perbaikan UX (tanpa ubah logika bisnis/API/skema/auth):
- Admin: label "MRR" -> "Pendapatan rutin / bulan", "Churn 30 hari" ->
  "Berhenti langganan (30 hari)" (angka sama); label grafik 11px -> 12px;
  drawer ponsel kini invisible saat tertutup (tidak bisa difokus keyboard).
- Studio (/akun): urutan dibalik — Undangan Saya + tombol buat baru di
  atas, baru langganan, angka, riwayat pembayaran. Label status polos
  ("Draft — belum dibagikan" dst., nilai server tetap); lencana berwarna
  per status; kartu Draft tidak lagi menampilkan tautan tamu (diganti
  catatan "aktifkan dulu"); tautan tamu kini URL penuh + tombol salin
  (komponen/TombolSalin.tsx); hapus undangan pakai dialog konfirmasi
  (komponen/HapusUndangan.tsx, aksi server sama).
- Editor: tautan kembali — "Kembali ke dasbor saya" kalau sudah masuk,
  "Daftar / Masuk" kalau belum (sebelumnya tidak ada jalan kembali
  setelah chrome situs hilang).
- Pratinjau template (/undangan/[slug]): CTA "Buat Versi Saya" jadi
  tombol utama solid dan pindah ke urutan pertama, di atas tombol WhatsApp.

Verifikasi: tsc + build lolos; server fixture (tamu.db) — / ber-chrome,
/u/tamuji01, /undangan/seruni-akad-nikah, /editor tanpa chrome dengan
penanda konten masing-masing tampil.

CATATAN PUSH (selesai 31 Okt 23:xx WIB): push utama fa2e7a0c (114 berkas
teks) + 7 penghapusan terpisah via delete_file (page, katalog, bantuan,
syarat, privasi, daftar, masuk) — head akhir 418e4200. Semua berkas lama
terverifikasi 404; tidak ada konflik rute tersisa. Redeploy Coolify
MENUNGGU user.

## Prioritas 1 editor ala referensi (1 Nov 2026, sudah di-push, head afd9db88)

Semua di komponen/FormulirEditor.tsx (editor /editor saja; formulir
/akun/undangan/baru memakai FormulirUndangan yang lebih sederhana dan
tidak diubah):
- Header editor nempel: nama undangan (ikut berubah saat mengetik) +
  lencana Draft + indikator tersimpan otomatis (teks awal "Draf
  disimpan otomatis di perangkat ini", berubah jadi "Tersimpan otomatis
  • HH:MM" setelah penyimpanan localStorage pertama) + tombol Pratinjau
  (jangkar #pratinjau) + Simpan (tombol submit luar formulir lewat
  atribut form="formulir-editor", aksi server sama) atau tautan Masuk
  kalau belum masuk.
- Navigasi seksi: sidebar desktop (sticky, "Bagian") + chip daftar isi
  di ponsel; jangkar scroll-mt-24 ke #bagian-templat, #bagian-detail,
  #bagian-sampul, #bagian-galeri, #bagian-kisah, #bagian-tandakasih.
  Tautan seksi khusus halaman penuh hanya tampil kalau templat
  terpilih halaman penuh (terverifikasi: Seruni menyembunyikannya).
- Pratinjau: toggle Ponsel (bingkai gelap max-w-md) / Lebar (penuh)
  + tombol Layar penuh (Fullscreen API pada pembungkus pratinjau).
- "Butuh bantuan?" di sidebar desktop + chip ponsel, tautan /bantuan.
- Sengaja belum: penanda seksi aktif saat menggulir (butuh scroll-spy;
  tautan kini polos), tanpa ubah skema/logika/API.
- Verifikasi: tsc + build lolos; server fixture (tamu.db) — semua
  penanda tampil di /editor dan /editor?templat=zamrud-pernikahan;
  /editor?templat=seruni-akad-nikah menyembunyikan 3 tautan khusus
  halaman penuh.

## RSVP + Send Gift ala referensi (1 Nov 2026, sudah di-push, head d4b6224a)

Semua di komponen/UndanganZamrud.tsx + app/globals.css (tema Zamrud
saja; formulir RSVP jalur kartu lama tidak diubah):
- RSVP: panel gelap sesuai tangkapan referensi — label emas, input
  gelap transparan (border krem), tombol kirim pil hijau + ikon pesawat.
  Kehadiran jadi dua tombol (Hadir/Berhalangan) ganti radio tiga
  pilihan; "Berhalangan" dikirim sebagai "Tidak" (enum server tetap,
  server memaksa jumlah 0 untuk Tidak). Kolom jumlah tamu hanya render
  saat Hadir, muncul dengan animasi muncul-halus (fade + geser 0,3 dtk).
  "Ragu" hilang dari formulir tamu; baris lama tetap tampil di
  ringkasan/filter dasbor. Tanpa ubah server action/skema.
- Tanda kasih: kartu rekening/alamat kini tersembunyi di balik tombol
  SEND GIFT (aria-expanded + panel panel-tanda-kasih), mengembang/
  menciut dengan transisi grid-rows 0,3 dtk + opacity. Seksi tetap
  data-gated (hanya tampil kalau rekening/alamat diisi).
- Verifikasi: tsc + build lolos; server fixture tamu.db (/u/tamuji01)
  — tombol Berhalangan, instruksi, kolom jumlah tampil, label lama
  hilang; fixture zamrud-v2.db (/u/v2uji001) — SEND GIFT + panel +
  Salin Nomor tampil.
- MENYUSUL (menunggu pemeriksaan animasi/navbar referensi): navbar
  dan efek animasi/transisi.

## Navbar + animasi ala referensi (1 Nov 2026, sudah di-push, head d4b6224a)

Pemeriksaan ulang referensi (jendela desktop lebar): referensi TIDAK
punya bilah atas — navigasinya tombol mengambang + panel atas blur;
reveal-nya fade lembut tanpa geser; hover nyaris tanpa perubahan.
Yang disamakan di komponen/UndanganZamrud.tsx + app/globals.css:
- Panel menu: drawer samping + backdrop DIGANTI panel atas blur
  (rounded 20px, bg zamrud gelap transparan + backdrop-blur, di atas
  kolom konten saja — desktop mulai 42%, ponsel selebar layar kurang
  margin; maks 70vh + gulir). Muncul fade + turun sedikit 0,5 dtk;
  ditutup lewat × atau tautan (tautan smooth-scroll, sudah ada di
  CSS). Tanpa backdrop. Tautan kini serif besar putih; seksi yang
  sedang terlihat jadi emas via scroll-spy (IntersectionObserver
  pita -30%/-60%, state bagianAktif, aria-current location) + catatan
  kaki miring "Pilih bagian yang ingin Anda lihat." Entri pil emas
  Konfirmasi Kehadiran di drawer lama DIHAPUS (referensi tidak punya;
  CTA tetap ada lewat bar persisten + tombol hero).
- Tombol mengambang: musik pindah ke kiri (bawah di desktop seperti
  referensi, atas di ponsel supaya tidak menutupi bar konfirmasi);
  menu tetap kanan atas. Tombol Ganti tema TIDAK ikut dibangun
  (fitur terpisah, masih rencana) — panel menu + musik saja yang
  disamakan.
- Reveal: .tampil kini fade opacity 0,7 dtk saja (geser 24px
  DIHAPUS) — sesuai karakter gerak referensi yang kalem. Hitung
  mundur tetap swap angka polos (sudah sesuai); hover tetap minim
  (tidak ada lift/zoom/bayangan baru).
- Panel gift direstyle: tombol SEND GIFT kini pil putih border emas
  (tertutup) / hijau gelap solid (terbuka) + tautan CLOSE kecil di
  kanan atas panel; isi jadi SATU panel gelap (label emas, teks krem,
  tombol salin outline emas, pemisah antar entri) ganti dua kartu
  putih berdampingan.
- Catatan rekonsiliasi RSVP: tangkapan referensi yang gelap = TEMA
  GELAP referensi (pemeriksaan desktop melihat tema terang: krem +
  kolom putih). Formulir gelap kita = tampilan tema gelap referensi,
  sudah sesuai permintaan. Perbedaan sadar yang dipertahankan:
  Hadir terpilih default (referensi mulai tanpa pilihan — default
  menghindari kiriman kosong) dan jumlah maks 10 (referensi 4).
- Verifikasi: tsc + build lolos; fixture tamu.db — panel menu,
  backdrop-blur, posisi musik bawah-desktop, aria-current tampil,
  drawer lama hilang total; fixture zamrud-v2.db — SEND GIFT, Close,
  panel gelap, Salin Alamat tampil.

## Editor tiga kolom gaya SAVENTIFY (1 Nov 2026, sudah di-push, head d4f05d1a)

Referensi: tangkapan editor SAVENTIFY (header + 3 kolom + langkah
Buat/Periksa/Bagikan + panel kata-kata + pratinjau bingkai ponsel).
Diterapkan ke /editor (editor pelanggan), BUKAN ke dasbor admin
operator — layar referensi adalah editor undangan, bukan dasbor metrik.
Brand tetap UndanganKita (bukan SAVENTIFY/Beta Storia).

- Shell: `komponen/FormulirEditor.tsx` + `app/editor/page.tsx`
  (halaman kini merender shell penuh tanpa pembungkus judul lama).
  Header: brand | nama undangan live + lencana DRAFT | indikator
  tersimpan otomatis + ✓ | Pratinjau (layar penuh) | Simpan (submit
  luar formulir) | Lanjut (terakota, pindah langkah). Latar
  #F9F8F6, panel tengah putih, panel pratinjau #F1ECE6, border
  stone-200. Di ponsel kolom menumpuk (sidebar jadi chip horizontal,
  pratinjau di bawah formulir).
- Sidebar: kembali ke dasbor (atau daftar/masuk), Design (Templat,
  Detail Acara, Kata-kata, Sampul, Foto & Galeri, Kisah, Tanda Kasih
  — 3 terakhir hanya templat halaman penuh), Opsi (Bagikan &
  Terbitkan), Butuh bantuan → /bantuan. Penanda aktif mengikuti seksi
  yang terlihat (scroll-spy IntersectionObserver, pita -20%/-70%).
- Langkah (penanda, bukan kunci linear): 1. Buat (gulir ke atas
  formulir), 2. Periksa (pratinjau layar penuh), 3. Bagikan (gulir ke
  panel bagikan). Tombol Lanjut di header memajukan langkah.
- Kata-kata (Prioritas 2, bentuk baru): kolom baru undangan
  `teks_pembuka` (maks 200) + `kata_pengantar` (maks 2000) —
  migrasi otomatis, skema, aksi simpan editor, draf localStorage.
  Seksi berisi: Gaya (dropdown template, state sama dengan seksi
  Templat), Sapaan pembuka (menggantikan salam template kalau diisi),
  Judul acara (tampilan nama dari Detail Acara, bukan input ganda),
  Tanggal + Lokasi (input cermin state Detail Acara, tanpa name
  ganda di formulir), Kata pengantar (paragraf tambahan). Bilah
  format B/I/Tautan membungkus seleksi textarea dengan markah.
- Render aman: `komponen/TeksBerformat.tsx` — parser **tebal**,
  *miring*, [teks](https://tautan); tanpa dangerouslySetInnerHTML
  (React meng-escape string), tautan hanya http(s). Render di
  PratinjauUndangan (sapaan + pengantar — dipakai editor, halaman
  contoh, dan jalur kartu tamu) dan UndanganZamrud (sapaan di hero,
  pengantar di antara hero dan mempelai).
- Panel Bagikan di akhir formulir: 3 langkah Simpan → Aktifkan →
  Bagikan + tautan /akun dan /akun/paket. Tautan tamu TIDAK dibuat di
  sini (baru ada setelah undangan disimpan + diaktifkan).
- Sengaja TIDAK ditiru: Envelope (amplop kertas, tidak relevan untuk
  distribusi WhatsApp), Guest List per orang (butuh skema + tautan
  personal — keputusan Prioritas 3), RSVP di sidebar editor (balasan
  RSVP dikelola dari dasbor setelah undangan aktif).
- Verifikasi: tsc bersih + build lolos (/editor 10,6 kB); server
  fixture tamu.db: semua penanda editor tampil; undangan uji Zamrud
  + kartu menampilkan sapaan/pengantar berformat, dan tag script
  dalam pengantar ter-escape (tidak dieksekusi). Klik Simpan sungguhan
  hanya bisa diverifikasi di produksi (POST server action gagal di
  sandbox — batas yang sudah diketahui).

## Perbaikan skrip migrasi Postgres (1 Nov 2026, sudah di-push, head d02d26af)

`scripts/migrasi-ke-postgres.ts` sebelumnya tidak menyalin tabel
`foto_galeri` (daftar URUTAN_TABEL hanya pengguna, templat,
paket_harga, undangan, pesanan, langganan, rsvp, percobaan_rsvp).
Akibatnya, foto galeri tambahan Zamrud v2 akan hilang kaitannya
(foto-fotonya tetap ada di /data/unggahan, tapi baris penghubungnya
tidak pindah). Perbaikan: `foto_galeri` ditambahkan tepat setelah
`undangan` (memenuhi foreign key ke undangan). Tabel `sesi` tetap
sengaja tidak disalin (pengguna login ulang sekali). Skrip ini harus
sampai ke image produksi (push + redeploy, aplikasi masih di SQLite)
SEBELUM migrasi dijalankan, supaya yang dieksekusi di terminal
container adalah versi yang sudah diperbaiki.

## Perbaikan skrip migrasi Postgres, bagian 2: halaman_penuh (1 Nov 2026, sudah di-push, head 8922e25f)

Percobaan migrasi pertama di produksi gagal dengan 42703
(`column "halaman_penuh" of relation "templat" does not exist`).
Akar penyebab: `SKEMA` di `lib/db.ts` tidak memuat kolom
`templat.halaman_penuh` — kolom itu selama ini hanya ditambahkan
oleh migrasi runtime aplikasi (`migrasiTemplat`), sementara
`db/skema.sql` (dokumentasi) sudah memuatnya. Skrip migrasi
mengimpor `SKEMA` dari `lib/db.ts`, jadi tabel target tercipta
tanpa kolom itu, lalu INSERT baris template sumber (yang punya
kolom tersebut) gagal. Tabel lain tidak terdampak: semua kolom
undangan, tabel `foto_galeri`, dan `maks_undangan_aktif` sudah ada
di `SKEMA`.

Perbaikan dua lapis:
1. `halaman_penuh` ditambahkan ke `SKEMA` di `lib/db.ts`
   (perbaikan akar — database baru apa pun kini punya kolom ini
   sejak awal; `migrasiTemplat` menjadi no-op).
2. Skrip migrasi menambahkan langkah DDL idempotent setelah
   pembuatan skema: cek `information_schema.columns`, ALTER hanya
   kalau kolom belum ada. Ini menangani target dari eksekusi yang
   sudah gagal (skema dasar sudah tercipta, nol baris) — target
   TIDAK perlu dihapus sebelum ulang, karena pengecekan target
   kosong menghitung baris, bukan keberadaan skema.

Observasi dari eksekusi gagal itu: sumber menyalin `pengguna` 0
baris. Sebelum ulang, verifikasi isi sumber dari terminal container
(perintah node:sqlite di bawah) — kalau `undangan`/`rsvp` juga 0,
sumbernya bukan database produksi (volume salah), dan migrasi
tidak boleh dilanjutkan. Kalau hanya `pengguna` yang 0, produksi
memang belum punya akun — setelah pindah, buat admin lewat
`npm run buat-admin` di terminal container.

## Eksekusi migrasi ke Postgres (1 Nov 2026, BERHASIL — pindah env masih menunggu)

Eksekusi ulang skrip (head 8922e25f) di terminal container aplikasi
berhasil dan terverifikasi oleh skrip sendiri (jumlah baris sumber =
tujuan per tabel):
- `templat.halaman_penuh: kolom ditambahkan` (langkah DDL idempotent
  bekerja pada target dari eksekusi gagal sebelumnya — target tidak
  dihapus dulu, sesuai rencana).
- templat 4, paket_harga 3, undangan 2, foto_galeri 0,
  pesanan/langganan/rsvp/percobaan_rsvp 0, pengguna 0, sesi 0 dilewati.
- `pengguna` 0 terkonfirmasi sebagai fakta produksi (bukan volume
  salah), karena `undangan` 2 baris ikut tersalin: produksi memang
  belum punya akun pengguna. Konsekuensi: setelah DATABASE_URL
  pindah ke Postgres, admin HARUS dibuat baru lewat
  `npm run buat-admin` di terminal container (sesudah redeploy
  dengan env Postgres, supaya tertulis ke Postgres bukan SQLite).

Sisa langkah: putar kata sandi Postgres (disarankan — kata sandi
sempat tertempel di chat), ganti DATABASE_URL ke URL internal
Postgres (yang baru kalau kata sandi diputar), redeploy, verifikasi
(/api/sehat, katalog, kedua undangan, login admin baru), lalu
tindak lanjut cadangan pg_dump.

## Rebrand ke BETA Storia + logo (1 Nov 2026, sudah di-push, head 0f46e409)

Keputusan user 1 Nov 2026: nama website menjadi **BETA Storia
Digital Invitation** (sebelumnya UndanganKita; penyebutan "Beta
Storia" di brief SAVENTIFY sebelumnya belum pernah dikonfirmasi
sebagai rebrand — kini dikonfirmasi eksplisit). Domain tidak
berubah (tetap inv.benifin.my.id); nama repo GitHub tidak berubah.

Logo (kirim user 1 Nov 10:57 WIB, PNG transparan):
- `public/logo/betastoria-ikon.png` (1000x1000, monogram BS) —
  favicon via metadata `icons` (icon + apple).
- `public/logo/betastoria-web.png` (1500x500, lockup horizontal) —
  header situs, sidebar admin, header editor.
- Keduanya disimpan di repo sebagai `.b64` (aturan aset biner) dan
  didekode di tahap builder Dockerfile (pola decode diperluas ke
  `public/logo/*.png.b64`). Berkas `.png` hasil decode TIDAK masuk
  manifest push (biner), hanya `.b64` yang masuk.
- Penyesuaian latar: logo cokelat transparan — di header situs
  (pil kaca terang) dan header editor (latar krem) langsung pakai
  gambar; di footer situs dan sidebar admin (latar tanah-900 gelap)
  logo ditaruh dalam pil krem muda supaya kontrasnya terjaga
  (bukan diutak-atik warnanya). Halaman tamu hanya ganti teks
  kredit ("Dibuat dengan BETA Storia"), tanpa gambar logo.

Sapuan rebrand: string `UndanganKita` -> `BETA Storia` di seluruh
kode, Dockerfile, entrypoint, dan DAFTAR-PELUNCURAN.md (judul
halaman, metadata, siteName, teks legal/FAQ/kredit, komentar).
README ditulis ulang total (bukan lagi "Prototipe MVP": fitur
aktual, stack, jalankan lokal, deploy Coolify, migrasi Postgres,
struktur proyek, aturan aset biner). `.env.example` diperbarui:
paragraf Postgres yang tadinya "nanti" kini menyatakan dukungan
nyata + migrasi. RENCANA ini dan docs/halaman-tamu.md SENGAJA tidak
disapu (dokumen riwayat — nama lama di sini adalah jejak sejarah,
bukan merek berjalan).

Beres-beres repo (audit 1 Nov 2026): TIDAK ada berkas kode mati —
semua komponen/lib/data terimpor minimal satu kali. Yang benar-benar tidak perlu: `public/unggahan/.gitkeep` (folder dibuat otomatis oleh `lib/penyimpananFoto.ts` mkdir recursive) — SUDAH DIHAPUS dari repo 1 Nov 2026 (commit ed8834b9). Skrip cadangan
SQLite (`scripts/cadangkan-db.mjs`, `pulihkan-db.mjs`) masih
berguna selama berkas SQLite jadi cadangan rollback — hapus hanya
setelah cadangan `pg_dump` untuk Postgres berjalan. Berkas lokal
yang tidak ada di repo (dev.db, .env.local, .jpg/.mp3 hasil decode,
.next, node_modules, tsconfig.tsbuildinfo) tidak perlu dihapus dari
repo karena memang tidak pernah masuk manifest push.

Verifikasi rebrand (1 Nov 2026): tsc bersih + build lolos. Server
fixture dengan database seed penuh (dasbor-uji/segar.db: 4 template,
3 paket): beranda, katalog, editor semua 200, logo tampil, favicon
`rel="icon" href="/logo/betastoria-ikon.png"`, nol string
"UndanganKita" tersisa. Catatan: fixture lama tamu.db sempat
menimbulkan 500 di beranda/katalog karena isinya minimal (2 template
dengan contoh_json hanya judulAcara, 0 paket) — BUKAN regresi
rebrand; database produksi berisi seed penuh sehingga tidak
terdampak. Fixture segar (segar.db) dipakai untuk verifikasi ini.

## Pindah ke Postgres LIVE + bersih-bersih repo untuk handoff (1 Nov 2026, sudah di-push, head 2eeafa1d)

User melaporkan 1 Nov 11:24 WIB: `DATABASE_URL` sudah pindah ke
Postgres + redeploy + verifikasi di Postgres. Produksi kini resmi
jalan di Postgres 18 bawaan Coolify; berkas SQLite lama hanya
cadangan rollback di volume server (bukan database jalan).

Bersih-bersih repo (disetujui user, dieksekusi 1 Nov 2026):
- DIHAPUS dari repo (masing-masing commit delete_file terpisah):
  `scripts/migrasi-ke-postgres.ts` (e4219d85, pekerjaan satu kali
  selesai + terverifikasi), `scripts/cadangkan-db.mjs` (80d73940)
  dan `scripts/pulihkan-db.mjs` (a41d7fb6) — keduanya khusus
  SQLite dan tidak berlaku untuk produksi Postgres. Sebelum hapus
  dicek: tidak ada referensi kode ke ketiganya (hanya .env.example
  dan README, yang ikut diperbarui).
- DIHAPUS juga dari image: variabel `ENV CADANGAN_DIR` di
  Dockerfile (hanya dipakai skrip cadangan lama; tidak dibaca kode
  aplikasi).
- DITAMBAH: `AGENTS.md` di root repo — panduan handoff untuk agen
  lain (keadaan saat ini, cara verifikasi, aturan keras, perilaku
  produk yang sering disalahpahami, struktur, operasi).
- DIPERBARUI: README (migrasi jadi lampau, cadangan jadi pg_dump
  dari terminal container Postgres dengan retensi 7, daftar scripts
  tanpa yang dihapus, volume /data tanpa /data/cadangan),
  `.env.example` (paragraf Postgres + cadangan diperbarui).
- TETAP DIPERTAHANKAN (bukan sampah): `RENCANA-PENYELESAIAN.md`
  (log riwayat — agen lanjutan butuh konteks keputusan),
  `DAFTAR-PELUNCURAN.md` (gerbang peluncuran masih berlaku),
  `docs/halaman-tamu.md`, `tests/halaman-tamu.tsx`,
  `data/toko.json` (sumber seed), `db/skema.sql`, semua `.b64`
  (dibutuhkan build), `scripts/seed.ts`, `buat-admin.ts`,
  `tambah-templat-baru.mjs`, `perlu-seed.mjs` (dipakai entrypoint).
- Belum otomatis: cron cadangan pg_dump (didokumentasikan perintah
  + retensinya, belum dijadwalkan). Berkas SQLite di server belum
  dihapus (sengaja — hapus setelah Postgres stabil + pg_dump ada).