its-tasty

Imported from wildanhatami/its-tasty (AGENTS.md). Install upstream with npx skills add wildanhatami/its-tasty. Copyright stays with the author.

This is NOT the Next.js you know

This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in node_modules/next/dist/docs/ before writing any code. Heed deprecation notices.

It's Tasty — Panduan untuk AI Agent

Landing page + toko online bakery (katalog, checkout via WhatsApp, dashboard admin) berbahasa Indonesia, dideploy di Vercel.

Tech Stack

Struktur Penting

• src/lib/auth.ts — konfigurasi NextAuth (callbacks: signIn, jwt, session)
• src/lib/notion-users.ts — getOrCreateUser / getUserByEmail (role customer | admin)
• src/lib/notion.ts, notion-schema.ts, notion-config.ts — akses & schema ke-4 database Notion
• src/lib/store-config.ts — konfigurasi toko (WA, alamat, jadwal, metode pembayaran)
• src/lib/order-pricing.ts — perhitungan harga per varian ukuran
• src/proxy.ts — middleware proteksi route admin
• src/lib/admin-guard.ts — requireAdmin() untuk layout/API admin
• src/components/admin/* — dashboard admin (Products, Orders, Users, Testimonials, DatabaseHealth)
• docs/SETUP.md — panduan setup lengkap (Notion schema, Google OAuth, dll)
• scripts/setup-notion.ts — CLI npm run notion:setup untuk cek/perbaiki schema Notion

Aturan Koding

1. Baca panduan Next.js versi ini — Next.js 16 punya breaking change; baca node_modules/next/dist/docs/ sebelum menulis kode. Perhatikan deprecation notice.
2. Auth tidak boleh menolak login karena Notion gagal — signIn callback HARUS return true untuk akun Google valid meskipun Notion timeout/error (fallback role customer di jwt callback). Jangan regresi ke perilaku lama yang return false pada error Notion.
3. Semua panggilan Notion di callback auth memakai withTimeout(...) (8s signIn/jwt, 5s refresh role) agar tidak menggantung request saat cold start Vercel.
4. Setiap perubahan di src/lib/auth.ts atau src/lib/notion-users.ts harus diperiksa dulu apakah memutus alur login Google.
5. Role di-refresh otomatis dari Notion tiap 60 detik di jwt callback (dilewati di Edge runtime agar tidak memblok middleware).
6. Route publik (katalog/beranda) memakai ISR 60 detik; route admin & API admin force-dynamic agar data Notion selalu segar.
7. Semua query list Notion memakai collectPaginatedAPI (aman untuk data > 100 baris).
8. Komentar & pesan log memakai bahasa Indonesia, konsisten dengan kode yang ada.
9. Selalu jalankan npm run lint (dan npm run build bila perlu) sebelum menyelesaikan perubahan.
10. Jangan commit kecuali diminta pengguna.
11. Hati-hati dengan pelanggan token/sekret: jangan pernah menulis nilai env var ke file apa pun selain .env.local (yang sudah di-gitignore).

Environment Variables

Didefinisikan di .env.local (lokal) dan Vercel Project Settings (production). Jangan pernah menampilkan/menulis nilainya.

Skrip npm run notion:setup membaca ID database dari .env.local dan bisa membuat database baru bila ID belum terisi.

Perintah

npm run dev            # development
npm run build          # production build
npm run lint           # eslint
npm run notion:setup   # cek & perbaiki schema Notion (--check untuk dry-run)

Referensi

• Setup lengkap: docs/SETUP.md
• Progress harian: PROGRESS.md