71 lines
2.9 KiB
Markdown
71 lines
2.9 KiB
Markdown
# 🏗️ Monorepo Web App Starter Template Version 1.0
|
||
**Version 1.0.0 — Internal Use Only**
|
||
|
||
Template นี้ถูกออกแบบมาเพื่อเป็นพื้นฐาน (Boilerplate) สำหรับทุกโปรเจกต์ในองค์กร
|
||
ช่วยลดเวลา Setup, เพิ่มมาตรฐาน และรองรับการขยายระบบในระยะยาว
|
||
|
||
---
|
||
|
||
## 🎯 เป้าหมายของ Template นี้
|
||
|
||
โปรเจกต์นี้เป็น **Monorepo Web App Starter Template** ที่มีฟีเจอร์พื้นฐานครบพร้อมใช้งาน ได้แก่:
|
||
|
||
✔ Authentication + JWT + Refresh Token
|
||
✔ Remember-Me Token Logic
|
||
✔ Celery Task Queue + Redis Broker
|
||
✔ API Gateway (Django DRF)
|
||
✔ React (Vite) + TanStack Query + Redux Toolkit
|
||
✔ Docker Compose (Minio + Celery + Flower + Redis + CockroachDB)
|
||
|
||
สามารถ Clone เพื่อสร้างโปรเจกต์ใหม่ได้ทันทีผ่าน Gitea *Make this Template*
|
||
|
||
---
|
||
|
||
## 🚀 เหตุผลที่องค์กรควรใช้ Template นี้
|
||
|
||
### 1️⃣ ลดเวลาในการ Setup (Time to Market)
|
||
ไม่ต้องติดตั้งซ้ำทุกครั้ง เช่น:
|
||
|
||
- Django + JWT + Djoser
|
||
- Token Refresh + Remember-Me Logic
|
||
- Celery Worker + Redis Queue
|
||
- Vite + React + TanStack Query
|
||
- Docker Compose รองรับ Backend/Frontend/Database
|
||
|
||
โคลนแล้วเริ่มพัฒนาได้ทันที!
|
||
|
||
---
|
||
|
||
### 2️⃣ มาตรฐานเดียวกันทั้งองค์กร (Standardization)
|
||
Template นี้รวม Best Practices เช่น:
|
||
|
||
- DRF Custom Permission, Auth Middleware
|
||
- React Service Layer + Axios Interceptors
|
||
- Redux Slice สำหรับ Auth
|
||
- Database Structure มาตรฐาน
|
||
- Docker Directory Structure
|
||
|
||
ทำให้ทุกทีมโค้ดไปในทิศทางเดียวกัน
|
||
|
||
---
|
||
|
||
### 3️⃣ ผ่านการทดสอบมาแล้ว (Quality & Stability)
|
||
Template นี้ถูกสร้างจากโปรเจกต์จริง
|
||
แก้ปัญหาเช่น:
|
||
|
||
- Connection Refused (Celery)
|
||
- Token Refresh ไม่ทำงาน
|
||
- CORS/CSRF ปัญหาใน Dev
|
||
- Docker Volume Lost
|
||
|
||
จึงมั่นใจได้ว่าใช้แล้วเสถียร
|
||
|
||
---
|
||
|
||
### 4️⃣ ง่ายในการบำรุงรักษา (Maintenance Friendly)
|
||
เมื่อมีการอัปเดต security หรือ dependency เวอร์ชันใหม่:
|
||
|
||
- ทีมสามารถ Pull จาก Template
|
||
- หรือ Sync ผ่าน Git Subtree/Gitea Mirror
|
||
|
||
ช่วยลด Tech Debt ระยะยาว |