SambasKu Admin

Konsol admin Kamus Digital Sambas-Indonesia. Dipakai verifikator dan admin untuk mengelola kata, antrean kontribusi, moderasi, dan pengguna.

Dikerjakan dengan AI

Kode dan dokumentasi di repo ini ditulis bersama agen AI. Manusia tetap yang memutuskan arah produk, meninjau setiap perubahan, dan menjalankan verifikasi sebelum rilis. Tidak ada agen yang punya akses commit, merge, atau deploy otomatis. Semua keputusan akhir ada di tangan pengelola.

Stack

Layer	Pilihan
Framework	React 19 + Vite (SPA)
UI	Ant Design 6, TanStack Router / Query / Table
HTTP	Axios (/api di-proxy ke API staging saat pnpm dev)
Deploy	Cloudflare Pages

Fitur utama

Area	Rute
Dashboard	/dashboard
Kata (list, buat, edit, detail)	/words, /words/new, /words/$id
Antrean kontribusi	/contributions
Moderasi komentar + blocklist	/comments, /comment-blocklist
Search miss	/search-misses
Moderasi vote	/vote-moderation
Usulan edit kata	/word-suggestions
Laporan kata / bug	/word-reports, /bug-reports
Pengguna + pengajuan verifikator	/users, /verifier-applications
Audit log	/audit-logs

Auth: login email/password. Access token di memori; refresh token di cookie HttpOnly (SameSite=Strict) dari API.

Aset media

Jenis	Alur
Gambar kata / avatar	Multipart ke API → repo sambasku/images (jsDelivr + wsrv)
Audio pelafalan	Multipart ke API → repo sambasku/audios
Bukti verifikator / lampiran bug	Token ImageKit (privat), bukan GitHub

Struktur singkat

src/
├── app/                 # router, providers
├── features/<fitur>/    # domain → application → infrastructure → presentation
├── shared/              # api client, layouts, hooks, utils
└── styles/

Scripts

Perintah	Fungsi
pnpm install	Pasang dependensi
pnpm dev	Vite (proxy /api → API staging)
pnpm build:staging	Build mode staging
pnpm build	Build mode production
pnpm lint / pnpm test / pnpm typecheck	Quality gate

Deploy Staging

Hosting: Cloudflare Pages - project sambasku-admin-staging, custom domain https://console-sambasku-staging.iamutaki.com.

Deploy murni lewat CI/CD (.github/workflows/deploy-staging.yml): push ke branch staging (atau jalankan manual dari tab Actions) → lint + test + build → wrangler pages deploy dist.

Setup sekali

1. Tambah secret repo (Settings → Secrets and variables → Actions):
   • CLOUDFLARE_API_TOKEN - izin Cloudflare Pages: Edit
   • CLOUDFLARE_ACCOUNT_ID
2. Push ke staging - job membuat project Pages otomatis, lalu deploy.
3. Attach custom domain di dashboard Cloudflare: Workers & Pages → sambasku-admin-staging → Custom domains → tambah console-sambasku-staging.iamutaki.com (DNS + sertifikat otomatis, satu akun/zone).
4. Pastikan CORS_ALLOWED_ORIGINS API staging (api/wrangler.toml → env.staging.vars) memuat origin di atas.

Kenapa custom domain wajib

Cookie refresh_token API ber-SameSite=Strict. Admin dan API harus satu registrable domain (iamutaki.com di staging / sambasku.com di production) supaya cookie terkirim saat auto-refresh sesi. Domain *.pages.dev adalah situs berbeda → sesi "amnesia" ke halaman login.

Deploy Production

Hosting: Cloudflare Pages - project sambasku-admin, custom domain https://console.sambasku.com. API: https://api.sambasku.com/api/v1.

Deploy: .github/workflows/deploy-production.yml - push ke branch main (atau Run workflow manual) → lint + test + build → Pages deploy.

Setup sekali: attach console.sambasku.com ke project sambasku-admin, pastikan CORS API production memuat https://console.sambasku.com dan https://sambasku.com.

Routing SPA

public/_redirects berisi /* /index.html 200 - deep-link / refresh pada rute history-mode TanStack Router tetap dilayani index.html, bukan 404.