help-desk/README.md
2025-11-18 21:53:33 +00:00

2.9 KiB
Raw Blame History

🏗️ 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 ระยะยาว