HanSun 網站從零建置與部署技術手冊｜Next.js、Supabase、Vercel 與 Agent Workflow

1. 01安裝 Node.js 20 以上、Git，建立 GitHub repository。
2. 02建立 Supabase project、Vercel project，以及必要的付款、通知與 Turnstile 服務。
3. 03建立 Next.js + TypeScript 專案，加入 next-intl、Supabase、Stripe、Nodemailer、lucide-react、framer-motion 與 Tailwind CSS。
4. 04先完成資料模型與 db adapter，再做 UI；先完成課程 CRUD，再做報名表。
5. 05先完成後端價格計算，再接前台價格顯示；建立 pricing snapshot，再做匯出與對帳。
6. 06跑測試腳本與 npm run build，最後才部署 Production。

• -courses：課程、價格、早鳥、團報、容量與狀態
• -registrations：報名、付款狀態、charged_amount、折價券與 soft delete
• -registration_events：報名與通知事件
• -registration_verification_*：後台自動核對與人工標註
• -CMS、lecturers、projects、news、careers：公開內容與管理資料

Migration 應依序在 Supabase SQL Editor 或 migration workflow 套用，Production 不應直接手動修改資料表結構。

ATM／銀行轉帳先是 pending，學員填入匯款末五碼，後台核對入帳後才標記 paid 並寄送成功通知。

Stripe／LINE Pay 的 Payment Intent、request、confirm 與 webhook 都必須驗證金額、currency、courseId、email 與 webhook secret。所有 secret 只放在 server environment。

• -學員看板金額錯誤：檢查 registrationid、chargedamount、couponused 與 pricingsnapshot。
• -匯款金額不一致：以 paid 與 charged_amount 對帳。
• -重複報名：保留最新且有付款證據的資料，舊 pending 使用 soft delete。
• -新增 API route 前先定義 auth、rate limit、error handling 與 logging。
• -不得在 client component 引入 Service Role 或 server-only secret。
• -禁止把 .env.local、API key、Service Role、Webhook secret、JWT secret、學生個資、銀行帳戶與交易證明放進 Word、Git、聊天或截圖。

• -原始技術手冊：HanSun網站從零建置部署技術手冊2026-06-09_fixed.docx
• -HanSun Architects：https://www.hansunarchitects.com/
• -Next.js：https://nextjs.org/docs
• -Supabase：https://supabase.com/docs
• -Vercel：https://vercel.com/docs
• -Stripe：https://docs.stripe.com/
• -LINE Developers：https://developers.line.biz/