# Third-Party Integrations & Configurations — Kittisak.com

> **Tenant scope:** These integrations and credentials/configuration expectations apply to Kittisak.com only, not every DBK Platform tenant.

เอกสารบันทึกรายละเอียดการเชื่อมต่อระบบภายนอก (Third-Party Services) คีย์สภาพแวดล้อม และสถานะการเปิดใช้งานสำหรับ `kittisak.com`

---

## 1. การเชื่อมต่อระบบชำระเงิน (Omise Payment Gateway)

ระบบรองรับการรับชำระเงินผ่าน PromptPay QR และ Credit/Debit Card:

- **สถานะปัจจุบัน:** รอการตั้งค่า Production Key
- **ตัวแปรสภาพแวดล้อมที่ต้องใช้:**
  - `OMISE_SECRET_KEY`: กำหนดใน `/home/ti/projects/kittisak-api/.env`
  - `VITE_OMISE_PUBLIC_KEY`: กำหนดใน Environment ก่อน Build SPA (`apps/spa`)
- **Webhook Endpoint:**
  - URL: `https://api.kittisak.com/api/payments/webhook`
  - Events ที่ต้อง Subscribe: `charge.complete`, `charge.create`

---

## 2. การเชื่อมต่อ LINE Official Account (LIFF & Messaging API)

ระบบรองรับการล็อกอินอัตโนมัติผ่าน LINE LIFF และการส่งแจ้งเตือนสถานะออเดอร์:

- **LINE LIFF App URL:** `https://spa.kittisak.com`
- **ตัวแปรสภาพแวดล้อมที่เกี่ยวข้อง:**
  - `VITE_LIFF_ID`: ID ของ LIFF App ที่สร้างใน LINE Developers Console
  - `LINE_CHANNEL_SECRET`: ใช้สำหรับตรวจสอบความถูกต้องของ Webhook / Signature
  - `LINE_CHANNEL_ACCESS_TOKEN`: ใช้สำหรับส่ง Push Message แจ้งสถานะสินค้าหาลูกค้า

---

## 3. การเชื่อมต่อระบบจัดส่งและติดตามพัสดุ (Logistics & Tracking)

ระบบมีโมดูล Order Tracking ในตัว รองรับขนส่งหลักในประเทศไทย:

- **ผู้ให้บริการที่รองรับ:**
  - Flash Express
  - Kerry Express / KEX
  - ไปรษณีย์ไทย (Thailand Post / EMS)
  - J&T Express
- **Tracking URL สำหรับลูกค้า:**
  - `https://kittisak.com/order-tracking?orderId=...` หรือค้นหาด้วยเลขพัสดุในหน้าเว็บ

---

## 4. Checklist สำหรับการขึ้น Production แบบสมบูรณ์ (Go-Live Checklist)

- [x] ตรวจสอบ DNS ชี้มายัง IP Server ถูกต้อง (`58.136.41.148`)
- [x] ติดตั้งและออกใบรับรอง SSL ครอบคลุมทั้ง 4 โดเมน
- [x] สร้างฐานข้อมูล `kittisakdb` และรัน Migration
- [x] ทำการ Seed ข้อมูลเบื้องต้น (Admin, หมวดหมู่, แบรนด์, สินค้า)
- [ ] เปลี่ยนรหัสผ่านบัญชี Admin เริ่มต้น (`admin` / `homaroma123`)
- [ ] อัปเดต Logo, Favicon, และ SEO Metadata ให้ตรงกับแบรนด์จริง
- [ ] ใส่คีย์ Omise Payment Production Keys
- [ ] สร้าง LINE LIFF App และใส่ `VITE_LIFF_ID`