x

PROJECT_DETAILS.md

@@ -1,6 +1,8 @@
-# รายละเอียดโปรเจกต์ HomAroma X
+# รายละเอียดโปรเจกต์ DBK Platform
 
-โปรเจกต์นี้เป็นระบบ E-commerce สำหรับผลิตภัณฑ์เครื่องหอมและน้ำมันหอมระเหย (Aroma & Essential Oils) โดยมีการออกแบบสถาปัตยกรรมแบบ Monorepo ที่แบ่งส่วนการทำงานออกเป็น 4 ส่วนหลักในโฟลเดอร์ `apps/` ดังนี้:
+DBK Platform เป็นระบบ E-commerce แบบ multi-tenant / white-label สำหรับหลายประเภทธุรกิจ โดยออกแบบเป็น Monorepo ที่มี shared commerce capabilities สำหรับแต่ละ tenant. **HomAroma** เป็น reference tenant สำหรับสินค้า Aroma & Essential Oils ไม่ใช่ข้อจำกัดของแพลตฟอร์ม
+
+> Source of truth สำหรับคำศัพท์และขอบเขต platform/tenant: [`docs/PLATFORM_OVERVIEW.md`](docs/PLATFORM_OVERVIEW.md)
 
 ---
 
@@ -28,13 +30,13 @@
 *   **เป้าหมาย:** เพื่อสร้างการรับรู้แบรนด์ (Brand Awareness) และช่วยให้ลูกค้าค้นหาพบผ่าน Search Engine ได้ง่าย
 *   **การเชื่อมโยง:** เชื่อมต่อกับ `backend` เพื่อดึงข้อมูลสินค้าและเนื้อหามาแสดงผลบนหน้าเว็บ
 
-## 4. LIFF Mobile App (`apps/spa`)
-**หน้ากากมือถือสำหรับลูกค้า (Customer Interface)**
+## 4. Mobile / Social-commerce SPA (`apps/spa`)
+**หน้าร้านมือถือสำหรับลูกค้า (Customer Interface)**
 
 *   **เทคโนโลยีที่ใช้:** React, Vite, LINE Front-end Framework (LIFF), Tailwind CSS
-*   **การทำงาน:** เป็น Single Page Application (SPA) ที่ออกแบบมาเพื่อรันภายในแอปพลิเคชัน LINE โดยเฉพาะ ลูกค้าสามารถสั่งซื้อสินค้า, ติดตามสถานะคำสั่งซื้อ, และรับสิทธิพิเศษต่างๆ ได้ทันทีผ่าน LINE OA
-*   **เป้าหมาย:** เพื่อความสะดวกสบายของลูกค้าในการเข้าถึงร้านค้าผ่านช่องทางที่คุ้นเคย (LINE) และสร้างความผูกพันกับลูกค้า (Customer Loyalty)
-*   **การเชื่อมโยง:** เชื่อมต่อกับ LINE Platform ผ่าน LIFF API และเชื่อมต่อกับ `backend` เพื่อทำรายการสั่งซื้อและจัดการข้อมูลสมาชิก
+*   **การทำงาน:** เป็น Single Page Application (SPA) สำหรับ mobile commerce. Tenant สามารถเปิดใช้ LINE LIFF เพื่อให้ลูกค้าสั่งซื้อ ติดตามสถานะ และรับสิทธิพิเศษผ่าน LINE OA ได้
+*   **เป้าหมาย:** ให้ tenant เลือกช่องทาง mobile/social commerce ที่เหมาะกับลูกค้าและกลยุทธ์ retention
+*   **การเชื่อมโยง:** เชื่อมต่อกับ `backend`; การเชื่อมต่อ LINE Platform ผ่าน LIFF API เป็น tenant-specific integration
 
 ---
 
@@ -51,24 +53,26 @@ graph TD
         B[Backend - ElysiaJS]
         A[Admin - React/Vite]
         S[Main Website - Next.js]
-        W[LIFF App - React/Vite]
+    W[SPA - React/Vite]
     end
 
     A -- API Calls --> B
     S -- API Calls --> B
     W -- API Calls --> B
-    W -- Integration --> LINE
+    W -. Tenant-specific integration .-> LINE
     B -- Query/Save --> PostgreSQL
 ```
 
 *   **Backend** คือหัวใจหลักที่ทุกส่วนต้องวิ่งมาหา
 *   **Admin** จัดการข้อมูลทั้งหมดผ่าน Backend
 *   **Main Website (SSR)** ดึงข้อมูลไปแสดงเพื่อผลทางด้าน Google Search/SEO
-*   **LIFF App** เป็นช่องทางหลักที่ลูกค้าใช้สื่อสารและสั่งซื้อสินค้าผ่านแอป LINE
+*   **SPA/LIFF** เป็นช่องทาง social commerce ที่ tenant เปิดใช้ได้ตามความเหมาะสม
 
 ---
 
-## 5. การ Deployment และ CI/CD
+## 5. Deployment และ CI/CD ของ HomAroma reference tenant
+
+> ส่วนนี้เป็น operational runbook ของ HomAroma reference tenant. ชื่อ remote, host, PM2 process และ domain ที่มี `homaroma` เป็น legacy infrastructure identifiers ไม่ใช่ชื่อของ DBK Platform
 
 โปรเจกต์นี้ใช้ระบบ **Git Hooks (post-receive)** ในการทำ Automated Deployment เมื่อมีการ Push โค้ดไปยังเซิร์ฟเวอร์