KATA

Family Tree

โครงสร้างระบบทั้งหมด · ดูครั้งเดียวจำได้ตลอด · สีทอง = entry point ลูกค้า · สีแดง = staff-only

baanbaan.design  ◄─── Cloudflare Pages · auto-deploy ทุก 30 นาที (Task Scheduler)
│
├── /                          หน้าหลัก (landing) · 2 routes: ลูกค้าใหม่/เจ้าของบ้าน
├── /services                  หน้าบริการ + CTA LINE
├── /workshops/                เลือก Workshop A–O
│
├── /app/auth/login            login เบอร์ + OTP (รองรับ ?phone=66XXX&autoreq=1 autofill)
├── /app/                      Customer Portal ─┐
│       ├── Pre-con view              ├ Pre-contract  │ ดูได้แค่ลูกค้า/เจ้าของบ้าน
│       ├── BB Dashboard view         ├ BB Active     │ (มี OTP + customer-stage gate)
│       └── Project Picker            └ 2+ projects  ─┘
│
├── /admin/                    Admin Panel (staff role required)
│       ├── + เพิ่มลูกค้า              ─► call /api/admin/create-customer
│       ├── + เปิดโครงการ             ─► call /api/admin/create-project
│       ├── + เพิ่มสมาชิก             ─► call /api/admin/add-member (cap 1/5)
│       ├── 📩 ส่ง SMS                ─► call /api/admin/resend-welcome
│       └── 🔗 issue magic link       ─► call /api/admin/issue-magic-link
│
├── /kata/                     เอกสารระบบนี้ (password 99 weak gate)
│
└── /api/admin/*               Cloudflare Pages Functions (server-side)
        │
        │ requires Bearer JWT + profile.role IN staff_roles
        │ uses Supabase service_role for cross-schema writes
        │
        └─ helper: sendVonageSms() = multi-provider chain ▼

Supabase  ◄─── project lufcntasklknveeofvhi (Singapore)
│
├── Auth (GoTrue)
│       ├── Phone OTP (signInWithOtp)
│       ├── Hook: Send SMS ─────────► Edge Function ▼
│       └── Membership cap trigger (Pre-con=1 / BB=5)
│
├── DB tables
│       ├── auth.users · profiles · projects · project_members
│       ├── installments · pre_con_charges · attachments
│       ├── change_orders · sign_offs · activity_logs
│       └── RLS policies + SECURITY DEFINER RPCs
│
└── Edge Function send-sms-hook (v11)
        │
        │ verifies webhook signature
        │ tries providers in SMS_PROVIDER_CHAIN order
        │ MUST return Content-Type: application/json
        │
        └─ multi-provider chain ▼

SMS Providers (env: SMS_PROVIDER_CHAIN=thaibulksms,vonage)
│
├── ThaiBulkSMS (primary)  ◄─── ที่ใช้ส่งจริงตอนนี้
│       endpoint: api-v2.thaibulksms.com
│       sender:   default (no DEMO) · "BAANBAAN" รอ KYC
│       credit:   pre-paid · เติมที่ account.thaibulksms.com
│       ราคา:    ฿0.30/SMS std · ฿0.45 corporate
│
└── Vonage (fallback)
        endpoint: rest.nexmo.com/sms/json · type=unicode
        sender:   "BAANBAAN" · AIS รีเจค error 29 (trial whitelist)
        ใช้ตอน: ThaiBulkSMS ล่ม + ปลายทาง verified ใน Vonage dashboard

Phirom  ◄─── separate project
│
├── phirom.health (Porkbun → Cloudflare Pages phirom-clinic)
│       ├── ebook · admin-web (pwd katikatakaton + inner 88)
│       └── source: Desktop\phirom-deploy\
│
└── 4-channel system  Desktop\phirom-deploy\_channels\
        ├── MAIN  · BOOKS  · MISC  · COORD
        ├── COORD loops: 30m consolidate+gdrive-backup · 60m cloudflare-deploy
        └── Launch: _channels\scripts\start-all.cmd

External
├── LINE OA  @okbaanbaan  (https://lin.ee/2dy7hPp) · BaanBaan customer channel
├── LINE OA  @405diwon    · Phirom Clinic
├── Cloudflare DNS    baanbaan.design + phirom.health zones
└── Google Drive AppSync  G:\My Drive\AppSync\  ─► secrets + backups + sync

การไหลของข้อมูล (login flow)

ลูกค้าได้ Welcome SMS  ──►  แตะลิงก์ baanbaan.design/app/auth/login?phone=66XXX&autoreq=1
                            │
                            ▼
                       phone autofill 0.7s → handleSend()
                            │
                            ▼  POST /auth/v1/otp { phone, channel:sms, create_user:false }
                       Supabase GoTrue
                            │
                            ├─ ตรวจ user exists + token cleared
                            │
                            ▼  hook payload { user, sms.otp }
                       Edge Function send-sms-hook
                            │
                            ├─ verify webhook signature
                            ▼
                       try ThaiBulkSMS → POST api-v2.thaibulksms.com/sms
                            │  ✓ status 200 + msg_id
                            ▼
                       ลูกค้าได้ SMS OTP 6 หลัก  ──► กรอกใน input field
                            │
                            ▼  verifyOtp({ phone, token, type:sms })
                       Supabase set session  ──► redirect /app/
                            │
                            ▼  query project_members + project info
                       render portal view  (Pre-con / BB / picker)