48 lines
4.5 KiB
Markdown
48 lines
4.5 KiB
Markdown
# Kittisak.com — Project Specification & Domain Blueprint
|
|
|
|
> **Tenant scope:** This specification applies to Kittisak.com only. It documents one DBK Platform tenant and must not be read as a platform default.
|
|
|
|
เอกสารภาพรวมโครงการ วัตถุประสงค์ทางธุรกิจ สถาปัตยกรรมระบบ และข้อมูลทางเทคนิคของโดเมน `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 และกู้คืนระบบ
|