Risalah Madina Tour

Website publik dan CMS untuk Risalah Madina Tour, biro perjalanan haji dan umroh. Pengunjung dapat membandingkan paket, membaca detail perjalanan, mengirim pertanyaan, lalu melanjutkan konsultasi melalui WhatsApp. Tim internal mengelola konten, paket, media, dan inquiry dari dashboard admin.

Fitur utama

• Homepage editorial dengan informasi layanan, destinasi, paket pilihan, dan CTA konsultasi.
• Katalog paket Umroh dan Haji dengan pencarian, filter, pengurutan, dan halaman detail.
• Halaman informasi tentang perusahaan, legalitas, dokumentasi, FAQ, dan pembiayaan.
• Form inquiry sebelum pengunjung diarahkan ke WhatsApp.
• CMS untuk mengelola profil perusahaan, paket, konten, media, dan inquiry.
• Autentikasi Supabase untuk area admin dengan role admin dan editor.
• Cache dan invalidasi route setelah perubahan data CMS.
• Metadata SEO, sitemap, robots, canonical URL, Open Graph, dan structured data untuk halaman paket.
• Fail-closed di production jika Supabase belum dikonfigurasi atau tidak tersedia.

Kepemilikan dan lisensi

Kode, struktur, desain, copy, dan aset orisinal proyek ini dimaksudkan sebagai material proprietary dan tidak dirilis sebagai open-source. Penggunaan komersial, redistribusi, modifikasi publik, pembuatan produk turunan, atau pemanfaatan untuk pihak lain memerlukan izin tertulis. Lihat LICENSE.md dan COPYRIGHT.

Pemegang utama/pengelola kode adalah NODE (Neural Operations & Digital Engineering). Risalah Madina Tour (RMT) menggunakan situs untuk penjualan jasa umroh dan travel, sedangkan Yayasan Pondok Digitalpreneur Abdurrahman Bin Auf Cirebon (ABA) menjalankan subunit/cabang bisnis RMT. Ketiga pihak memiliki hak sesuai kontribusi dan materi masing-masing, dengan NODE sebagai pihak utama dan Pemberi Lisensi. Lisensi ini tetap harus ditinjau oleh profesional hukum sebelum digunakan untuk penegakan. Dependensi, font, foto, video, logo, aset template, dan materi referensi pihak ketiga tidak termasuk klaim proprietary proyek. Lihat THIRD_PARTY_NOTICES.md dan docs/INTELLECTUAL-PROPERTY.md.

Teknologi

• Next.js 16 dengan App Router dan TypeScript
• React 19
• Tailwind CSS 4
• Supabase Auth, Postgres, Storage, dan Row Level Security
• ESLint 9

Memulai secara lokal

Persyaratan: Node.js dan npm.

npm install
cp .env.example .env.local
npm run dev

Buka http://localhost:3000.

Perintah yang tersedia:

npm run dev      # development server
npm run lint     # pemeriksaan ESLint
npm run build    # production build dan type-check
npm run start    # menjalankan hasil production build

Konfigurasi environment

Variabel	Keterangan
NEXT_PUBLIC_SITE_URL	URL publik situs untuk metadata dan sitemap.
NEXT_PUBLIC_SUPABASE_URL	URL project Supabase.
NEXT_PUBLIC_SUPABASE_ANON_KEY	Anon key dari Supabase Project Settings → API.
NEXT_PUBLIC_HERO_VIDEO_URL	URL video hero self-hosted. Opsional; fallback ke URL media dari CMS.

Jangan commit .env.local atau kredensial apa pun. Gunakan .env.example sebagai acuan.

Menyiapkan Supabase CMS

1. Buat project Supabase.

2. Jalankan migration di Supabase SQL Editor secara berurutan:

   supabase/migrations/001_cms.sql
   supabase/migrations/002_cms_media.sql
   supabase/migrations/003_enterprise_security_and_inquiries.sql
   supabase/migrations/004_security_hardening.sql
   supabase/migrations/005_repair_inquiries_schema.sql
   supabase/migrations/006_security_and_retention.sql
   

3. Isi NEXT_PUBLIC_SUPABASE_URL dan NEXT_PUBLIC_SUPABASE_ANON_KEY di .env.local.

4. Buat user admin atau editor melalui Supabase Authentication → Users.

5. Masukkan UUID user tersebut ke tabel cms_members:

   insert into public.cms_members (user_id, role)
   values ('UUID_USER_DARI_SUPABASE_AUTH', 'admin');

6. Jalankan aplikasi dan buka /admin/login.

Jika CMS menampilkan Could not find the table 'public.cms_inquiries' in the schema cache, jalankan migration 005_repair_inquiries_schema.sql di Supabase SQL Editor. Migration ini aman dijalankan ulang, membuat tabel inquiry bila belum ada, memperbaiki policy, dan meminta PostgREST memuat ulang schema cache.

Role admin dapat mengelola seluruh data dan melakukan reset. Role editor dapat mengubah konten serta mengunggah media. Data inquiry dibaca dari dashboard setelah pengunjung mengirim form konsultasi.

Untuk production, Supabase adalah sumber data tunggal. Jika Supabase belum dikonfigurasi atau query gagal, aplikasi mengembalikan error dan tidak menampilkan seed lama maupun menulis file saat request GET. Pada development, aplikasi dapat memakai seed in-memory dari src/lib/cms/default-data.ts.

Inquiry berisi data kontak calon jemaah dan ditahan maksimal 24 bulan. Jalankan public.purge_old_cms_inquiries(730) melalui scheduler tepercaya (misalnya Supabase Cron) untuk menjalankan pembersihan berkala.

Route penting

Area	Route
Situs publik	/
Katalog Umroh	/umroh
Detail Umroh	/umroh/[slug]
Katalog Haji	/haji
Detail Haji	/haji/[slug]
Katalog gabungan	/paket
Detail paket	/paket/[slug]
Informasi	/tentang, /legalitas, /dokumentasi, /faq, /pembiayaan
Legal	/terms, /privacy-policy
Login CMS	/admin/login
Dashboard CMS	/admin
API CMS	/api/cms
API inquiry	/api/inquiries

Struktur proyek

src/app/                 route publik, admin, dan API
src/components/          komponen UI dan CMS
src/lib/                 akses data, Supabase, kontak, dan structured data
supabase/migrations/     schema, policy, media, inquiry, dan hardening
docs/                    arsitektur dan catatan QA
DESIGN.md                arah visual dan prinsip desain

Dokumentasi terkait

• DESIGN.md: arah visual, tone, tipografi, dan guardrail desain.
• docs/ARCHITECTURE.md: alur CMS, autentikasi, cache, storage, dan batas keamanan.
• docs/qa/performance-verification-2026-10-12.md: catatan build, smoke test, dan batasan pengukuran Lighthouse.

Deploy

Deploy ke platform yang mendukung Next.js dengan menjalankan production build terlebih dahulu:

npm run build
npm run start

Pastikan seluruh variabel environment production sudah diisi di platform deploy dan migration Supabase sudah dijalankan sesuai urutan.