# PRODUCT REQUIREMENTS DOCUMENT (PRD)
## Landing Page Seminar Nasional dan Apresiasi GTK Tingkat Provinsi NTB Tahun 2026

**Penyelenggara:** BGTK Provinsi NTB  
**Tema:** Tata Kelola dan Perlindungan Guru dan Tenaga Kependidikan  
**Versi:** 2.1  
**Status:** Final untuk acuan desain dan pengembangan  
**Platform:** Website responsif (desktop, tablet, dan mobile)

---

## 1. Ringkasan Produk

Landing page ini merupakan pusat informasi dan gerbang pendaftaran Seminar Nasional yang dirangkaikan dengan Apresiasi GTK Tingkat Provinsi NTB Tahun 2026.

Landing page menyediakan dua jalur keikutsertaan:

- **Luring:** peserta diarahkan ke kegiatan luring di Simdiklat. Kapasitas maksimal 150 peserta. Panitia hanya menyediakan kit seminar, tanpa transportasi dan uang harian.
- **Daring:** peserta diarahkan ke kegiatan daring di Simdiklat. Sertifikat diberikan sesuai persyaratan yang ditetapkan panitia.

Landing page tidak mengumpulkan identitas peserta. Pengisian identitas dan proses pendaftaran sepenuhnya dilakukan di Simdiklat. Landing page membaca jumlah pendaftar luring dari database MySQL Simdiklat melalui backend API.

## 2. Tujuan Produk

1. Menyediakan satu halaman informasi resmi kegiatan.
2. Membantu peserta memilih metode keikutsertaan yang tepat.
3. Menyampaikan ketentuan luring secara jelas sebelum peserta melanjutkan.
4. Menampilkan jumlah pendaftar dan sisa kuota luring secara dinamis.
5. Mengarahkan peserta ke halaman kegiatan Simdiklat yang sesuai.
6. Memberikan pengalaman pengguna yang modern, menarik, mudah digunakan, dan responsif.

## 3. Informasi dan Konfigurasi Kegiatan

| Elemen | Nilai |
|---|---|
| Nama kegiatan | Seminar Nasional dan Apresiasi GTK Tingkat Provinsi NTB Tahun 2026 |
| Tema | Tata Kelola dan Perlindungan Guru dan Tenaga Kependidikan |
| Penyelenggara | BGTK Provinsi NTB |
| Kuota luring | 150 peserta |
| Sistem pendaftaran | Simdiklat |
| Sistem sertifikat | Simdiklat, sesuai ketentuan masing-masing kegiatan |
| URL pendaftaran luring | https://bgtkntb.kemendikdasmen.go.id/app/berajah//home/detail/102 |
| URL pendaftaran daring | https://bgtkntb.kemendikdasmen.go.id/app/berajah//home/detail/103 |

**Catatan URL:** URL daring ditulis menggunakan skema `https://` dan URL luring dipertahankan persis sebagaimana diberikan. Pengembang perlu menguji kedua URL sebelum publikasi dan tidak mengubah path tanpa konfirmasi.

## 4. Target Pengguna

- Guru.
- Tenaga Kependidikan.
- Undangan dan pemangku kepentingan pendidikan yang menjadi sasaran kegiatan.

Kebutuhan utama pengguna adalah memperoleh informasi kegiatan, memahami perbedaan metode, mengetahui ketersediaan kuota luring, lalu melanjutkan pendaftaran di Simdiklat.

## 5. Ruang Lingkup Produk

### 5.1 Termasuk (In Scope)

- Landing page satu halaman (single-page website).
- Identitas dan informasi kegiatan.
- Pilihan metode luring dan daring.
- Modal persetujuan ketentuan luring.
- Tautan langsung ke dua kegiatan Simdiklat.
- Integrasi backend API dengan MySQL Simdiklat untuk membaca kuota luring.
- Indikator kuota, status, dan waktu pembaruan.
- FAQ, kontak panitia, dan footer.
- Desain responsif, aksesibilitas dasar, SEO, dan animasi.

### 5.2 Tidak termasuk (Out of Scope)

- Formulir identitas peserta pada landing page.
- Pembuatan akun atau autentikasi peserta.
- Sistem pendaftaran baru.
- Pengelolaan sertifikat.
- Sistem webinar atau konferensi video.
- Pembayaran.
- Dashboard peserta.
- Perubahan struktur atau proses Simdiklat, kecuali diperlukan dan disetujui untuk pembatasan kuota.

## 6. Struktur Halaman (Information Architecture)

1. **Hero:** identitas kegiatan, tema, tagline, tanggal/lokasi jika sudah ditetapkan, dan CTA.
2. **Tentang kegiatan:** latar belakang, tujuan, dan ringkasan rangkaian seminar serta Apresiasi GTK.
3. **Informasi kegiatan:** jadwal, tempat, penyelenggara, dan sasaran.
4. **Pilihan metode:** kartu Luring dan Daring.
5. **Kuota luring:** jumlah pendaftar, sisa kuota, status, dan waktu pembaruan.
6. **Narasumber dan agenda:** ditampilkan setelah data disahkan panitia.
7. **Ketentuan dan sertifikat:** fasilitas luring dan persyaratan sertifikat daring.
8. **FAQ:** pertanyaan umum.
9. **Footer:** identitas BGTK Provinsi NTB dan kontak resmi.

## 7. Persyaratan Fungsional

### FR-01 — Hero Section

Menampilkan nama kegiatan, tema, penyelenggara, tagline, informasi jadwal/lokasi jika tersedia, serta tombol “Daftar Sekarang” dan “Pelajari Kegiatan”.

### FR-02 — Informasi Kegiatan

Menampilkan deskripsi, tujuan, sasaran, jadwal, lokasi, dan informasi penyelenggara. Informasi yang belum ditetapkan tidak boleh diisi dengan data rekaan.

### FR-03 — Pilihan Metode

Menyediakan dua kartu pilihan yang berbeda secara visual dan informatif:

**Luring**
- Mengikuti kegiatan secara tatap muka.
- Kuota maksimal 150 peserta.
- Fasilitas dari panitia hanya kit seminar.
- Tidak tersedia transportasi dan uang harian.
- Tombol: “Pilih Luring”.

**Daring**
- Mengikuti kegiatan secara online.
- Sertifikat keikutsertaan diberikan sesuai persyaratan panitia.
- Tombol: “Pilih Daring”.

### FR-04 — Konfirmasi Luring

Saat peserta memilih Luring, tampilkan modal konfirmasi sebelum membuka Simdiklat.

Teks yang disarankan:

> **Konfirmasi Ketentuan Pendaftaran Luring**  
> Kuota peserta luring maksimal 150 orang. Panitia hanya menyediakan kit seminar dan tidak menyediakan transportasi maupun uang harian. Biaya perjalanan dan kebutuhan pribadi selama mengikuti kegiatan menjadi tanggung jawab peserta.
>
> Apakah Anda telah membaca, memahami, dan menyetujui ketentuan tersebut?

Modal memuat checkbox persetujuan yang wajib dicentang. Tombol “Saya Setuju, Lanjutkan” tidak aktif sebelum checkbox dicentang. Setelah disetujui, buka URL berikut:

https://bgtkntb.kemendikdasmen.go.id/app/berajah//home/detail/102

Tombol “Batalkan” menutup modal dan mempertahankan pengguna di landing page.

### FR-05 — Pendaftaran Daring

Saat peserta memilih Daring, tampilkan informasi bahwa sertifikat mengikuti persyaratan panitia, kemudian arahkan ke:

https://bgtkntb.kemendikdasmen.go.id/app/berajah//home/detail/103

Tidak diperlukan modal persetujuan khusus seperti jalur luring, kecuali ditetapkan kemudian oleh panitia.

### FR-06 — Informasi Kuota Luring

Kapasitas maksimal adalah 150 peserta. Landing page mengambil jumlah pendaftar luring dari MySQL Simdiklat melalui backend API.

Rumus:

`Sisa kuota = max(0, 150 - jumlah pendaftar luring yang dihitung)`

Jumlah pendaftar yang dihitung adalah seluruh pendaftaran yang berhasil dikirim/disimpan di Simdiklat, tanpa menunggu verifikasi panitia. Pendaftaran daring tidak dihitung. Data gagal, draft, atau belum benar-benar tersimpan tidak dihitung. Pendaftaran yang dibatalkan/dihapus mengikuti kondisi aktual pada database dan definisi teknis yang disepakati.

Status tampilan yang disarankan:

| Kondisi sisa kuota | Status |
|---|---|
| Lebih dari 30 | Tersedia |
| 1–30 | Hampir penuh |
| 0 | Kuota penuh |

Tampilkan total kuota, jumlah pendaftar, sisa kuota, persentase terisi, dan waktu pembaruan terakhir. Angka hanya boleh ditampilkan sebagai data aktual jika API berhasil mengambil data terbaru.

Jika API gagal:
- Tampilkan pesan “Informasi kuota sementara tidak dapat dimuat”.
- Jangan menampilkan angka lama seolah-olah masih aktual.
- Nonaktifkan sementara tombol menuju pendaftaran luring sampai kuota dapat diperiksa kembali, sesuai keputusan operasional panitia.

### FR-07 — FAQ

FAQ minimal mencakup:
- Apakah kegiatan dapat diikuti secara daring?
- Berapa kuota luring?
- Apakah peserta luring mendapatkan transportasi?
- Apakah peserta luring mendapatkan uang harian?
- Apa fasilitas peserta luring?
- Bagaimana persyaratan sertifikat daring?
- Di mana peserta melakukan pendaftaran?

### FR-08 — Footer dan Kontak

Menampilkan identitas BGTK Provinsi NTB, kontak resmi panitia, alamat/tautan instansi, serta hak cipta tahun 2026. Data kontak harus disediakan dan disahkan panitia.

## 8. Alur Pengguna (User Flow)

### Jalur Luring

1. Peserta membuka landing page.
2. Peserta membaca informasi kegiatan dan melihat kuota luring.
3. Peserta memilih “Pilih Luring”.
4. Sistem memeriksa bahwa data kuota tersedia dan sisa kuota lebih dari nol.
5. Sistem menampilkan modal ketentuan luring.
6. Peserta mencentang persetujuan.
7. Peserta memilih “Saya Setuju, Lanjutkan”.
8. Browser membuka halaman kegiatan luring Simdiklat pada URL detail/102.
9. Peserta mengisi identitas dan menyelesaikan pendaftaran di Simdiklat.

### Jalur Daring

1. Peserta membuka landing page.
2. Peserta membaca informasi kegiatan dan persyaratan sertifikat.
3. Peserta memilih “Pilih Daring”.
4. Browser membuka halaman kegiatan daring Simdiklat pada URL detail/103.
5. Peserta mengisi identitas dan menyelesaikan pendaftaran di Simdiklat.

Landing page tidak menyimpan identitas peserta atau membuat catatan pendaftaran baru.

## 9. Arsitektur Integrasi

### 9.1 Komponen

- **Server A:** hosting landing page dan backend API.
- **Server B:** server database MySQL Simdiklat.
- **Frontend:** menampilkan halaman, animasi, pilihan metode, dan informasi kuota.
- **Backend API:** mengakses database, menghitung kuota, memvalidasi hasil, dan mengirim respons ke frontend.
- **MySQL Simdiklat:** sumber data utama jumlah pendaftar.

### 9.2 Diagram alur

```text
Pengunjung
    |
    v
Landing Page (Frontend)
    |
    | HTTPS request
    v
Backend API (Server A)
    |
    | koneksi MySQL aman
    v
MySQL Simdiklat (Server B)
    |
    | hasil COUNT pendaftar kegiatan luring
    v
Backend menghitung sisa kuota
    |
    | JSON response
    v
Frontend menampilkan kuota
```

Pendaftaran peserta tidak melewati backend landing page. Peserta diarahkan langsung ke halaman Simdiklat yang sudah ditetapkan.

### 9.3 Endpoint API yang disarankan

| Method | Endpoint | Fungsi |
|---|---|---|
| GET | `/api/quota/offline` | Mengambil total pendaftar, sisa kuota, status, dan waktu pembaruan |
| GET | `/api/event/info` | Mengambil konfigurasi informasi kegiatan jika diperlukan |
| GET | `/api/health` | Memeriksa kesehatan backend dan koneksi yang diperlukan |

Contoh respons endpoint kuota:

```json
{
  "event": "seminar-gtk-ntb-2026",
  "total_quota": 150,
  "registered": 63,
  "remaining": 87,
  "percentage": 42,
  "status": "available",
  "last_updated": "2026-11-17T10:15:00+08:00"
}
```

Angka pada contoh hanya ilustrasi.

### 9.4 Query MySQL

Contoh konseptual:

```sql
SELECT COUNT(*) AS total_registered
FROM registrations
WHERE activity_id = 'ID_KEGIATAN_LURING'
  AND submission_status = 'submitted';
```

Nama tabel, kolom, ID kegiatan, dan nilai status di atas adalah placeholder. Pengembang wajib memeriksa skema database Simdiklat terlebih dahulu. Query final harus menghitung pendaftaran yang benar-benar berhasil dikirim/disimpan, termasuk yang belum diverifikasi, dan mengecualikan draft atau pendaftaran gagal. Pendaftaran batal/dihapus harus mengikuti perilaku data Simdiklat.

### 9.5 Pembaruan data

- Frontend meminta data kuota setiap 30–60 detik.
- Backend dapat menggunakan cache dengan TTL 30–60 detik.
- Tampilkan waktu pembaruan terakhir.
- Hindari query database pada setiap animasi atau setiap interaksi pengguna.
- Terapkan timeout dan penanganan error.
- Jika koneksi gagal, jangan mengarang atau mengasumsikan jumlah kuota.

## 10. Aturan Bisnis

| Kode | Aturan |
|---|---|
| BR-01 | Kapasitas maksimal luring adalah 150 peserta |
| BR-02 | Semua pendaftaran luring yang berhasil disimpan dihitung, termasuk yang belum diverifikasi |
| BR-03 | Pendaftar daring tidak masuk perhitungan kuota luring |
| BR-04 | Landing page tidak mengumpulkan identitas peserta |
| BR-05 | Identitas dan pendaftaran dilakukan di Simdiklat |
| BR-06 | Persetujuan ketentuan wajib sebelum menuju pendaftaran luring |
| BR-07 | Pendaftar daring diarahkan ke URL detail/103 |
| BR-08 | Pendaftar luring diarahkan ke URL detail/102 |
| BR-09 | Jika sisa kuota nol, tombol luring dinonaktifkan |
| BR-10 | MySQL Simdiklat merupakan sumber data kuota |
| BR-11 | Pembatasan keras 150 peserta harus ditegakkan di proses penyimpanan pendaftaran Simdiklat |

**Penting:** Pembacaan kuota pada landing page tidak mengunci kursi. Jika sisa kuota dua dan banyak orang mendaftar bersamaan, bisa terjadi kelebihan pendaftar. Simdiklat harus melakukan pemeriksaan dan pembatasan kuota secara atomik/transaksional ketika pendaftaran disimpan. Jika fitur tersebut belum tersedia, perlu pengembangan terpisah pada Simdiklat.

## 11. Persyaratan Keamanan

- Gunakan akun MySQL khusus dengan hak akses minimum, idealnya `SELECT` saja.
- Batasi koneksi database berdasarkan IP server landing page atau private network/VPN.
- Gunakan TLS untuk koneksi database jika didukung.
- Simpan kredensial pada environment variables/secret manager.
- Jangan pernah menaruh kredensial database di frontend atau repository publik.
- Gunakan parameterized query.
- Terapkan timeout, rate limiting, dan validasi respons API.
- Hindari pencatatan data pribadi atau rahasia dalam log.
- Gunakan HTTPS untuk landing page dan API.

Contoh konfigurasi (nilai harus diisi di server, bukan dikomit ke repository):

```env
DB_HOST=alamat-server-mysql
DB_PORT=3306
DB_DATABASE=nama_database
DB_USERNAME=landingpage_readonly
DB_PASSWORD=isi_password_aman
DB_SSL=true
```

## 12. Teknologi yang Direkomendasikan

| Komponen | Rekomendasi |
|---|---|
| Framework | Next.js |
| Bahasa | TypeScript |
| Styling | Tailwind CSS |
| Animasi | Motion |
| Ikon | Lucide |
| Validasi | Zod |
| Driver MySQL | mysql2 atau driver terpelihara yang sesuai |
| Hosting | VPS atau platform yang mendukung koneksi jaringan aman ke MySQL |
| Domain | Subdomain resmi BGTK Provinsi NTB jika tersedia |

VPS direkomendasikan apabila database hanya menerima koneksi dari IP tertentu atau berada pada jaringan internal. Pilihan hosting final harus mempertimbangkan jalur jaringan, firewall, dan kebijakan pengelola Simdiklat.

## 13. Struktur Proyek yang Disarankan

```text
seminar-gtk-ntb-2026/
├── app/
│   ├── page.tsx
│   ├── layout.tsx
│   ├── globals.css
│   └── api/
│       ├── quota/offline/route.ts
│       ├── event/info/route.ts
│       └── health/route.ts
├── components/
│   ├── Hero.tsx
│   ├── About.tsx
│   ├── EventInfo.tsx
│   ├── RegistrationOptions.tsx
│   ├── OfflineConfirmation.tsx
│   ├── QuotaIndicator.tsx
│   ├── FAQ.tsx
│   └── Footer.tsx
├── lib/
│   ├── database.ts
│   ├── quota.ts
│   ├── config.ts
│   └── validation.ts
├── public/
│   ├── images/
│   └── logos/
├── .env.example
├── package.json
└── README.md
```

## 14. Arahan UI/UX

**Konsep:** Modern Institutional Digital Experience.

**Palet warna:**
- Navy: `#101A36`
- Electric blue: `#245BDB`
- Violet: `#7545C8`
- Cyan: `#22B8C7`

**Karakter desain:**
- Premium, modern, profesional, dan tetap mencerminkan kredibilitas lembaga pemerintah.
- Hero dengan gradient dan partikel yang halus.
- Tipografi tegas dan mudah dibaca.
- Kartu metode menggunakan glassmorphism secukupnya.
- Indikator kuota dinamis dan mudah dipahami.
- Modal konfirmasi dengan transisi yang halus.
- Navigasi sederhana dan responsif.

**Animasi yang direkomendasikan:**
- Text reveal pada hero.
- Floating particles atau animated gradient yang ringan.
- Scroll reveal.
- Hover lift pada kartu.
- Transisi modal scale/fade.
- Progress bar kuota.
- Smooth scrolling.

Animasi harus dioptimalkan agar tidak mengganggu keterbacaan, performa, aksesibilitas, dan pengguna dengan pengaturan `prefers-reduced-motion`.

## 15. Persyaratan Non-Fungsional

| Aspek | Persyaratan |
|---|---|
| Responsif | Optimal di ponsel, tablet, dan desktop |
| Performa | Target loading awal maksimal 3 detik pada koneksi memadai |
| Browser | Chrome, Safari, Firefox, Edge versi modern |
| Keamanan | HTTPS dan secret server-side |
| Privasi | Tidak mengumpulkan identitas peserta |
| Aksesibilitas | Kontras memadai, keyboard access, reduced motion |
| SEO | Metadata judul, deskripsi, dan gambar berbagi |
| Stabilitas | Ada fallback saat API kuota gagal |

## 16. Acceptance Criteria

- [ ] Identitas BGTK Provinsi NTB dan tema kegiatan tampil benar.
- [ ] Tersedia pilihan Luring dan Daring.
- [ ] Tidak ada formulir identitas peserta di landing page.
- [ ] Tombol luring membuka modal ketentuan.
- [ ] Tombol melanjutkan luring tidak aktif sebelum persetujuan.
- [ ] Setelah setuju, peserta diarahkan ke URL luring detail/102.
- [ ] Peserta daring diarahkan ke URL daring detail/103.
- [ ] Kedua URL telah diuji sebelum publikasi.
- [ ] Backend berhasil membaca MySQL Simdiklat.
- [ ] Perhitungan mencakup semua pendaftaran luring yang berhasil disimpan tanpa menunggu verifikasi.
- [ ] Pendaftaran daring tidak masuk hitungan.
- [ ] Sisa kuota dihitung dengan batas bawah nol.
- [ ] Data diperbarui setiap 30–60 detik.
- [ ] Waktu pembaruan terakhir ditampilkan.
- [ ] Kegagalan API ditangani tanpa menampilkan data lama sebagai data aktual.
- [ ] Tombol luring nonaktif ketika kuota penuh atau kuota tidak dapat dipastikan.
- [ ] Kredensial database tidak terekspos.
- [ ] Batas maksimal 150 ditegakkan di Simdiklat.
- [ ] Tampilan responsif dan animasi berjalan baik.

## 17. Risiko dan Mitigasi

| Risiko | Mitigasi |
|---|---|
| Database tidak dapat diakses dari server landing page | Koordinasi firewall, IP allowlist, VPN, dan TLS |
| Struktur tabel tidak diketahui | Audit skema dan uji query sebelum integrasi |
| Draft ikut dihitung | Identifikasi status pendaftaran yang benar |
| Data kuota terlambat diperbarui | Cache singkat dan refresh berkala |
| Kuota terlampaui akibat pendaftaran bersamaan | Pembatasan atomik di Simdiklat |
| API gagal | Tampilkan status tidak dapat diperiksa dan nonaktifkan jalur luring sementara |
| URL kegiatan berubah | Simpan URL dalam konfigurasi server |

## 18. Tahapan Implementasi

1. **Audit Simdiklat:** periksa skema MySQL, tabel pendaftaran, ID kegiatan luring, dan status submit.
2. **Validasi akses jaringan:** uji koneksi aman dari server landing page ke MySQL.
3. **UI/UX design:** buat mockup desktop dan mobile.
4. **Backend:** buat endpoint kuota, query, cache, validasi, dan error handling.
5. **Frontend:** implementasikan seluruh section, animasi, modal, dan tautan.
6. **Integration testing:** cocokkan angka API dengan data Simdiklat.
7. **Acceptance testing:** jalankan seluruh skenario pada checklist.
8. **Deployment:** publikasi setelah persetujuan panitia dan pengelola Simdiklat.

## 19. Data yang Masih Diperlukan Sebelum Coding

- Host dan port MySQL.
- Nama database.
- Nama tabel pendaftaran.
- Kolom ID kegiatan.
- Nilai ID kegiatan luring (kegiatan detail/102 perlu dipetakan ke ID database yang sebenarnya).
- Kolom status dan nilai yang menandakan formulir berhasil disimpan.
- Perilaku data ketika pendaftaran dibatalkan atau dihapus.
- Konfirmasi pembatasan kuota 150 di Simdiklat.
- Tanggal, jam, lokasi, narasumber, agenda, dan kontak resmi panitia.
- Persyaratan sertifikat daring yang sudah ditetapkan.

Kredensial database tidak perlu dimasukkan ke dokumen PRD atau dikirim melalui chat. Masukkan langsung ke konfigurasi rahasia server saat implementasi.

---

## 20. Keputusan Akhir Produk

Landing page menjadi pusat informasi, pemilihan metode, konfirmasi ketentuan luring, dan visualisasi kuota. Simdiklat tetap menjadi sistem utama untuk pengisian identitas, pendaftaran, dan sertifikat.

**URL resmi pendaftaran:**

- **Luring:** https://bgtkntb.kemendikdasmen.go.id/app/berajah//home/detail/102
- **Daring:** https://bgtkntb.kemendikdasmen.go.id/app/berajah//home/detail/103

PRD ini menjadi acuan desain UI/UX, implementasi backend dan frontend, integrasi database, pengujian, serta deployment landing page Seminar Nasional dan Apresiasi GTK Tingkat Provinsi NTB Tahun 2026.
