ระบบเบิกจ่ายพาเลท — Pallet Management System

ระบบจัดการการเบิก-คืน-ซ่อม-ตัดจำหน่ายพาเลทหมุนเวียนในโรงงาน

Stack: Next.js 16 (App Router, TypeScript) · Prisma 6 · Supabase (Postgres) · Tailwind CSS 4 · Resend (Email) · Noto Sans Thai

---

โครงสร้าง URL

URL	ผู้ใช้
/	หน้าแรก (เลือกพอร์ทัล)
/app	พนักงาน — สร้างคำขอ, ดูสถานะ, อนุมัติ
/manage	Admin / Pallet Manager — Dashboard, จัดการข้อมูล, รายงาน
/auth/login	เข้าสู่ระบบ (ใช้ได้ทั้ง 2 ฝั่ง)
/auth/register	สมัครใช้งาน (public)
/auth/forgot-password	ลืมรหัสผ่าน
/auth/reset-password	รีเซ็ตรหัสผ่าน

---

รันบนเครื่อง (Local)

1) สร้าง Supabase project

1. ไปที่ supabase.com → New project
2. เลือก Region: Southeast Asia (Singapore)
3. หลัง project สร้างเสร็จ ไปที่ Settings → Database และ Settings → API เก็บค่าไว้

2) ติดตั้ง dependencies

npm install

3) สร้างไฟล์ .env.local

cp .env.example .env.local

เปิด .env.local แล้วกรอกค่าจริง:

# Supabase → Settings → Database → Connection string
# ใช้ Transaction pooler (port 6543) สำหรับ runtime
DATABASE_URL=postgresql://postgres.<ref>:<pass>@aws-0-ap-southeast-1.pooler.supabase.com:6543/postgres?pgbouncer=true&connection_limit=1
# ใช้ Direct connection (port 5432) สำหรับ prisma migrate เท่านั้น
DIRECT_URL=postgresql://postgres.<ref>:<pass>@aws-0-ap-southeast-1.pooler.supabase.com:5432/postgres

# Supabase → Settings → API
SUPABASE_URL=https://<ref>.supabase.co
SUPABASE_ANON_KEY=<anon-key>
SUPABASE_SERVICE_ROLE_KEY=<service-role-key>

# App
APP_URL=http://localhost:3000

# สร้าง SESSION_SECRET ด้วย PowerShell:
# [Convert]::ToBase64String((1..32 | % { Get-Random -Max 256 }))
SESSION_SECRET=<random-32-char-secret>

# Email — ถ้ายังไม่พร้อมใส่ dummy ไปก่อน ระบบยังทำงานได้
RESEND_API_KEY=re_dummy
[email protected]

# Cron — ใช้ random string ใดก็ได้ (ใน local ไม่ถูกเรียก)
CRON_SECRET=any-local-secret

หมายเหตุ: Prisma CLI อ่าน .env ไม่ใช่ .env.local — ต้องรันผ่าน npm run db:* เสมอ อย่ารัน npx prisma ตรงๆ

4) สร้างตาราง + ข้อมูลตัวอย่าง

# สร้าง Prisma Client
npm run db:generate

# Apply migration สร้างตาราง
npm run db:migrate:deploy

# ใส่ข้อมูลตัวอย่าง (แผนก, ประเภทพาเลท, user ทดสอบ, ยอดสต็อกเริ่มต้น)
npm run db:seed

ข้อมูล seed ที่ได้:

email	ชื่อ	Role	สถานะ
[email protected]	Admin	ADMIN	ACTIVE
[email protected]	หัวหน้าคลังพาเลท ทดสอบ	PALLET_MANAGER	ACTIVE
[email protected]	พนักงานพัสดุ ทดสอบ	REQUESTER	ACTIVE
[email protected]	พนักงานผลิต ทดสอบ	REQUESTER	ACTIVE
[email protected]	พนักงานจ่ายสินค้า ทดสอบ	REQUESTER	ACTIVE

Seed users ยังไม่มีรหัสผ่าน ใช้ dev-login (dev เท่านั้น) หรือรันคำสั่งด้านล่างเพื่อตั้งรหัสผ่าน

5) สร้าง Admin user สำหรับ Login

# รูปแบบ: npm run create-admin -- <email> <password> [ชื่อเต็ม]
npm run create-admin -- [email protected] MyPassword123 "ผู้ดูแลระบบ"

6) รัน dev server

npm run dev

เปิด browser:

• http://localhost:3000 — หน้าแรก
• http://localhost:3000/auth/login → เข้าสู่ระบบด้วย admin / MyPassword123
• http://localhost:3000/auth/register → สมัครใช้งาน (public)
• http://localhost:3000/app → พอร์ทัลพนักงาน

---

Deploy บน Vercel

1) Push code ขึ้น GitHub

git init
git add .
git commit -m "feat: initial pallet system"
git remote add origin https://github.com/<username>/<repo>.git
git push -u origin main

ตรวจสอบว่า .gitignore มี .env.local (มีอยู่แล้วใน default Next.js gitignore)

2) Import project ใน Vercel

1. ไปที่ vercel.com → Add New Project → Import GitHub repo
2. Framework: Next.js (detect อัตโนมัติ)
3. Root Directory: pallet-system (ถ้า repo มี folder นี้)
4. Build Command: ปล่อย default (prisma generate && next build)

3) ตั้ง Environment Variables ใน Vercel

Settings → Environment Variables → ใส่ค่าทั้งหมด (เปลี่ยนจาก local เฉพาะที่ระบุ):

Key	ค่าสำหรับ Production
DATABASE_URL	pooled connection (port 6543) ของ Supabase project
DIRECT_URL	direct connection (port 5432)
SUPABASE_URL	เหมือน local
SUPABASE_ANON_KEY	เหมือน local
SUPABASE_SERVICE_ROLE_KEY	เหมือน local
APP_URL	https://your-app.vercel.app
SESSION_SECRET	random ใหม่ (ไม่ซ้ำกับ local)
RESEND_API_KEY	API key จาก resend.com
RESEND_FROM	อีเมลที่ verify domain แล้ว เช่น [email protected]
CRON_SECRET	random ใหม่ สำหรับ cron job

4) Deploy

กด Deploy รอ build เสร็จ (~3 นาที)

5) Apply migration + Seed บน Production DB

รันจากเครื่อง local โดยชี้ไปที่ Production DB:

This is the beginning of the README. Read the rest at the original. Read the full README ↗