homaroma/docs/tenants/kittisak.com/integrations.md

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)

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