docs: add tenant specification and domain blueprints for kittisak.com

2026-09-24 04:45:01 +07:00
1 parent 960ba2a0e8
commit 9fab97f0d8
@@ -0,0 +1,45 @@
+# Kittisak.com — Project Specification & Domain Blueprint
+
+เอกสารภาพรวมโครงการ วัตถุประสงค์ทางธุรกิจ สถาปัตยกรรมระบบ และข้อมูลทางเทคนิคของโดเมน `kittisak.com`
+
+---
+
+## 1. ข้อมูลทั่วไปและเป้าหมายโครงการ (Project Vision & Goals)
+
+- **Domain Name:** `kittisak.com`
+- **Tenant ID / Project Key:** `kittisak`
+- **ประเภทเว็บไซต์:** E-Commerce Platform & Digital Storefront (Next.js SSR + React SPA + Headless CMS Backend)
+- **วัตถุประสงค์หลัก:**
+  1. สร้างร้านค้าออนไลน์สำหรับแสดงและจำหน่ายสินค้า รองรับการทำ SEO คุณภาพสูง
+  2. มอบประสบการณ์การสั่งซื้อที่สะดวกสบายทั้งผ่าน Web Browser ทั่วไป และผ่าน **LINE Official Account (LIFF SPA)**
+  3. มีระบบจัดการหลังบ้าน (Admin CMS) สำหรับควบคุมสต็อก, ออเดอร์, คูปองส่วนลด และปรับแต่งเนื้อหาหน้าร้านได้อย่างยืดหยุ่น
+
+---
+
+## 2. โครงสร้างบริการและโดเมน (Service & URL Architecture)
+
+| Subdomain | บทบาทหน้าที่ (Service Role) | เทคโนโลยีหลัก (Tech Stack) | พอร์ตภายใน / โฟลเดอร์ |
+|---|---|---|---|
+| **`kittisak.com`** | Website หน้าบ้านหลัก สำหรับผู้เยี่ยมชมทั่วไปและ Search Engine (SEO) | Next.js SSR (Standalone) | Port `3005` (PM2: `kittisak-website`) |
+| **`spa.kittisak.com`** | Web App น้ำหนักเบา ออกแบบสำหรับเปิดใน LINE LIFF และ Mobile | React + Vite SPA | Static Nginx: `/html/kittisak/spa` |
+| **`admin.kittisak.com`** | ระบบจัดการหลังบ้านสำหรับผู้ดูแลร้าน (Admin Panel) | React + Vite SPA | Static Nginx: `/html/kittisak/admin` |
+| **`api.kittisak.com`** | REST API Backend, Authentication & Database Service | Bun + Elysia / Express + Prisma | Port `3054` (PM2: `kittisak-backend`) |
+
+---
+
+## 3. ข้อมูลสถาปัตยกรรมเซิร์ฟเวอร์ (Infrastructure & Environment)
+
+- **Host Server:** `ti@kitizone.com` (Ubuntu 24.04 LTS)
+- **Git Remote:** `ti@kitizone.com:/home/ti/git/kittisak.com.git` (Bare Repository + Auto Deploy Post-Receive Hook)
+- **ฐานข้อมูล:** PostgreSQL Database `kittisakdb` (เชื่อมต่อผ่าน Docker Container `arokro_postgres` พอร์ต `5132`)
+- **SSL Certificates:** Let's Encrypt Consolidated SAN Certificate (`/etc/letsencrypt/live/kittisak.com/fullchain.pem`)
+- **Reverse Proxy:** Dockerized Nginx (`/home/ti/projects/MyNginxMain/nginx/conf.d/*.kittisak.com.conf`)
+
+---
+
+## 4. โครงสร้างเอกสารในโฟลเดอร์นี้
+
+1. [brand-identity.md](file:///c:/Users/ti/git/homaroma/docs/tenants/kittisak.com/brand-identity.md) — รายละเอียดโทนสี (Theme Tokens), โลโก้, ฟอนต์, และการตั้งค่า SEO Metadata
+2. [user-flows.md](file:///c:/Users/ti/git/homaroma/docs/tenants/kittisak.com/user-flows.md) — แผนผังเส้นทางการใช้งานของลูกค้า (Customer Journey), สมาชิก LINE, และการจัดการของผู้ดูแลระบบ
+3. [integrations.md](file:///c:/Users/ti/git/homaroma/docs/tenants/kittisak.com/integrations.md) — การตั้งค่าระบบชำระเงิน (Omise), ระบบสมาชิก LINE OA (LIFF), และการติดตามพัสดุ
+4. [Runbook Deployment](file:///c:/Users/ti/git/homaroma/KITTISAK_DEPLOYMENT_RUNBOOK.md) — คู่มือคำสั่งการ Deploy และกู้คืนระบบ