# ULTΛHLINK
# Product Requirements Document (PRD)

**Version:** 2.0
**Status:** Confirmed — Cloudflare-only rebuild
**Product Type:** Interactive Birthday Experience Platform

**Tagline:** A little surprise, made just for you.

---

# 1. Ringkasan

Versi 1.1 memakai Supabase untuk database, Storage, service-role key, dan Worker cron terpisah. Itu terlalu banyak bagian bergerak untuk produk yang dipakai sesekali, dan bergantung pada project gratis yang bisa tidur setelah 7 hari.

PRD v2.0 membuang Supabase. Seluruh runtime berjalan di **Cloudflare Free**: Pages, Pages Functions, dan D1. Tidak ada secret, tidak ada service eksternal, tidak ada cron.

---

# 2. Masalah & Tujuan

**Masalah:** pembuat kejutan butuh satu link yang bisa dimainkan, aktif 24 jam, lalu hilang. Dia tidak butuh database, akun, atau dashboard.

**Tujuan:**

- Satu platform, satu deploy.
- Nol environment variable berisi secret.
- Nol database eksternal, bucket, cron, dan email service.
- Expiry diputuskan server sebelum HTML dikirim.
- Foto ikut hilang bareng data, bukan cuma disembunyikan.

---

# 3. Keputusan produk (final)

| Keputusan | Requirement |
|---|---|
| Creator login | Tidak wajib |
| Jumlah template | 3 (1 aktif, 2 "segera") |
| Kustomisasi | Teks + maksimal 2 foto |
| Design editor | Tidak ada |
| Edit setelah publish | Tidak ada |
| Masa aktif | 24 jam sejak publikasi, server yang menentukan |
| Maskot | Penguin original Ultahlink |
| QR | Dibuat setelah publikasi, di browser |
| Frontend | HTML, CSS, JavaScript vanilla |
| Backend | Cloudflare Pages Functions + D1 |
| Email salinan link | Tidak ada |
| Turnstile | Tidak ada |
| Upgrade berbayar | Tidak ada |

---

# 4. User story

Sebagai pembuat, saya mau mengisi nama, pesan, dan dua foto, lalu mendapat link + QR. Saya mau link itu aktif tepat 24 jam dan setelah itu tidak bisa dibuka lagi.

Sebagai penerima, saya mau membuka link di HP, meniup lilin, memecahkan balon, dan membaca pesan tanpa login.

---

# 5. Arsitektur

```
[BROWSER create.html]
        |  multipart: nama, pesan, 2 foto (sudah dikompres)
        v
[PAGES FUNCTION /api/publish]
        |  rate limit via D1
        |  INSERT links + link_photos
        v
   [CLOUDFLARE D1]
        ^
        | SELECT ... WHERE expires_at > now
        |
[PAGES FUNCTION /p/<slug>] ----> HTML | 404 | 410
        |
        +--> expired: DELETE baris + foto, lalu 410
```

Satu binding bernama `DB`. Tidak ada Supabase, RLS, signed URL, atau service role.

---

# 6. Data model

```sql
CREATE TABLE links (
  slug TEXT PRIMARY KEY,
  template_id TEXT NOT NULL,
  recipient_name TEXT NOT NULL,
  sender_name TEXT NOT NULL DEFAULT '',
  message TEXT NOT NULL,
  created_at INTEGER NOT NULL,
  expires_at INTEGER NOT NULL
);

CREATE TABLE link_photos (
  slug TEXT NOT NULL,
  idx INTEGER NOT NULL,
  data_url TEXT NOT NULL,
  PRIMARY KEY (slug, idx)
);

CREATE TABLE publish_log (
  ip_hash TEXT NOT NULL,
  created_at INTEGER NOT NULL
);
```

`created_at` dan `expires_at` adalah unix seconds. Foto disimpan sebagai data URL, satu baris per foto, supaya tetap di bawah batas D1 2 MB per baris.

---

# 7. Endpoint

| Endpoint | Perilaku |
|---|---|
| `POST /api/publish` | Validasi, rate limit 5/jam/IP, simpan link + foto, balas `{ok, slug, url, expiresAt}` |
| `GET /p/<slug>` | Cek `expires_at` di SQL. Hidup → HTML. Tidak ada → 404. Kedaluwarsa → hapus data + 410 tanpa konten |

Tidak ada `/api/resend`, tidak ada `/api/cleanup`.

---

# 8. Expiry & cleanup

- `expires_at = now + 86400` dihitung di server saat publish.
- Query render memakai perbandingan `expires_at` terhadap waktu server. Konten kedaluwarsa tidak pernah masuk HTML.
- Membuka link kedaluwarsa menghapus baris dan fotonya saat itu juga.
- Setiap publish menghapus baris yang sudah kedaluwarsa, foto yatim, dan log rate limit lama.
- Tidak ada cron dan tidak ada Worker tambahan.

---

# 9. Foto

Kompresi dilakukan di browser sebelum upload:

- max edge 1200 px
- WebP quality 0.72
- hard cap 700 KB per foto
- maksimal 2 foto

Tidak ada Storage bucket, tidak ada signed URL. Foto tidak bisa dipakai setelah link mati.

---

# 10. Keamanan & privasi

- Tidak ada secret yang bisa bocor ke browser karena tidak ada secret sama sekali.
- IP disimpan sebagai SHA-256 di `publish_log`, bukan IP mentah.
- Rate limit 5 publish/jam/IP.
- Tidak ada data yang dikirim ke pihak ketiga. Turnstile dan Resend tidak dimuat.
- HTML 404 dan 410 tidak mengandung nama, pesan, atau foto.

---

# 11. Budget free tier

| Resource | Limit Free | Kebutuhan |
|---|---|---|
| Pages Functions | 100.000 request/hari | jauh di bawah |
| D1 storage | 5 GB | cukup untuk ratusan link aktif |
| D1 rows written | 100.000/hari | ~3 per publish |
| D1 rows read | 5 juta/hari | 2 per buka link |
| KV / R2 / Supabase | tidak dipakai | tidak ada |

---

# 12. Dampak ke kode

**Dihapus:** `supabase/`, `workers/cleanup/`, `functions/_lib/{supabase,cleanup,email}.js`, `functions/api/{cleanup,resend}.js`, `assets/js/config.js`, UI email/Turnstile, dan kode terkait di `create.js` / `create.css`.

**Ditulis ulang:** `functions/api/publish.js`, `functions/p/[slug].js`, `README.md`, `.env.example`.

**Ditambahkan:** `functions/_lib/db.js`, `db/schema.sql`, `wrangler.toml`.

**Tidak berubah:** landing, `pengalaman.html`, `assets/js/experience.js`, maskot, alur tiup lilin, balon, QR vendored, `_headers`, `_routes.json`.

---

# 13. Deploy

```bash
npx wrangler d1 create ultahlink
# isi database_id di wrangler.toml
npx wrangler d1 execute ultahlink --file=db/schema.sql --remote
npx wrangler pages deploy .
```

Selesai. Tidak ada env var, tidak ada migration Supabase, tidak ada Worker cron.

---

# 14. Verifikasi

- syntax check semua JS
- publish → 200 + slug + QR
- buka `/p/<slug>` → 200 + HTML lengkap
- expiry dipaksa lampau → 410 + body tanpa pesan/foto
- slug tidak ada → 404
- 6 publish dalam 1 jam → 429
- composer tidak ada field email / Turnstile
- layout 1440 + 390 → overflow 0
- reduced motion → konten tetap terlihat

---

# 15. Tradeoff yang diterima

- Cleanup bersifat lazy: baris yang tidak pernah dibuka menumpul sampai publish berikutnya. Ini dibatasi cleanup-on-publish.
- D1 punya batas 5 GB. Untuk pemakaian personal ini jauh lebih dari cukup.
- Kalau nanti foto membuat D1 penuh, jalannya bukan upgrade Supabase, tapi pindahkan foto ke R2. Belum perlu sekarang.
