Deep (codename: SafePay)
แพลตฟอร์มสร้างความน่าเชื่อถือสำหรับการซื้อขายออนไลน์ C2C — แก้ปัญหา "โอนแล้วไม่ได้ของ / มิจฉาชีพ" ด้วยการทำให้ ความน่าเชื่อถือมองเห็นและตรวจสอบได้ก่อนโอนเงิน ผ่าน Verify ตัวตน, Trust Score, Badge และ Order History
- ชื่อทางการค้า: Deep (UI copy, prod
deepthailand.app)
- Codename: SafePay (repo, identifiers, DB ยังใช้ชื่อนี้)
- เอกสารหลัก: ภาพรวม →
docs/PRD.md · สเปก dev → docs/SRS.md · กฎ/workflow → CLAUDE.md
Tech Stack
| ส่วน | เทคโนโลยี |
|---|
| Framework | Next.js 16 (App Router, Turbopack) · TypeScript strict |
| UI (dual theme) | Buyer/landing = Vuexy (MUI v9 + Emotion + Tailwind 4) · Seller/admin = Paces (Preline 4 + Tailwind 4, no MUI) |
| Database | PostgreSQL 16 (Supabase) · Prisma ORM |
| Auth | NextAuth v4 (Facebook OAuth + Phone OTP) |
| SMS/OTP | apitel (phone OTP + paid SMS order link) |
| Validation | Valibot (API) · Yup (form) |
| Font | Anuphan (ทุก surface) |
| Test | Vitest |
ดูรายละเอียดเต็ม: docs/SRS.md §5 Tech Stack
สถาปัตยกรรม (ย่อ)
-
Profile-Centric — ทุก account มี trust profile เดียวกัน, เปิดร้านเพิ่มได้ (isShop flag) — ไม่แบ่ง role buyer/seller แต่กำเนิด
-
Subdomain routing (src/proxy.ts) — แยก 3 surface + session แยกตาม subdomain (host-scoped cookie):
| Subdomain (dev) | สำหรับ |
|---|
deepth.local:4000 | Public + Buyer (Vuexy) |
seller.deepth.local:4000 | Seller (Paces) |
admin.deepth.local:4000 | Admin (Paces) |
-
Service layer (src/services/) แยกจาก API layer (src/app/api/)
-
โครงไดเรกทอรี + core systems: ดู CLAUDE.md · data model + API: ดู docs/SRS.md §6–§7
เริ่มต้น (Local Dev)
Prerequisites
Setup
npm install # + prisma generate (postinstall)
cp .env.example .env.local # แล้วเติมค่า (DB, NEXTAUTH_SECRET, FB/apitel creds)
npm run migrate # prisma migrate dev
npm run seed:supabase # seed dev DB (Supabase, ใช้ .env.local)
⚠️ dev DB = Supabase ผ่าน .env.local (ไม่ใช่ Docker .env) — Next.js โหลด .env.local ก่อน. migrate/test/seed:local ผูก .env; seed:supabase ผูก .env.local. ดู docs/conventions/seed-and-env.md
รัน dev server
npm run dev -- -p 4000 # ⚠️ port 4000 (3000-3002 = โปรเจกต์อื่น)
เปิด: http://deepth.local:4000 (buyer) · http://seller.deepth.local:4000 (seller) · http://admin.deepth.local:4000 (admin)
คำสั่งอื่น
npm test # Vitest (critical services)
npm run lint # next lint
npm run format # prettier
npm run migrate # prisma migrate dev
npm run clean # rm -rf .next (แก้ phantom crash)
Env vars หลัก (ดู .env.example เต็ม)
DATABASE_URL · NEXTAUTH_SECRET NEXTAUTH_URL · FACEBOOK_ID/SECRET · APITEL_API_KEY/SECRET/BASE_URL/SENDER_NAME (SMS) · NEXT_PUBLIC_BUYER_URL NEXT_PUBLIC_SELLER_URL · STORAGE_DRIVER
QA (E2E)
- User รัน dev server เอง (Claude/agent ไม่ start ให้) — QA ผ่าน Chrome DevTools MCP ที่ subdomain จริง
*.deepth.local:4000
- seed ผ่าน Prisma client เท่านั้น (ห้าม
prisma db pull — ทับ schema)
เอกสาร (Documentation)
| เอกสาร | เนื้อหา |
|---|
docs/PRD.md | Product — vision, personas, user stories, feature overview, scope, business model, roadmap |
docs/SRS.md | Software spec — FR detail (สูตร/acceptance), state machine, routing, NFR, data model, API reference, enums, authorization matrix, validation |
CLAUDE.md | กฎโปรเจกต์ (Hard Rules), architecture, conventions, current state |
docs/10 - Business Rules/ | Tier Lists (SSOT ของ trust tier) |
docs/conventions/ | engineering conventions (agent workflow, font, RSC nav, security, seed/env ...) |
docs/system/ui-guideline/ | UI guideline + page-sourcing (must-read ก่อนงาน frontend) |
docs/retro/ | post-mortems รายเฟส (อ่านอันล่าสุดก่อนเริ่มเฟสใหม่) |
License
Private / proprietary — Deep Thailand
