57 lines
3.5 KiB
Markdown
57 lines
3.5 KiB
Markdown
# Third-Party Integrations & Configurations — Kittisak.com
|
|
|
|
เอกสารบันทึกรายละเอียดการเชื่อมต่อระบบภายนอก (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`
|