🚀 Flask Project Setup Guide

📦 สร้าง Virtual Environment

py -3 -m venv .venv

(ไม่จำเป็นต้องรัน Activate.ps1 ถ้าไม่อยากเปลี่ยน Execution Policy)

---

🔧 ติดตั้ง Dependencies

อัปเดตเครื่องมือพื้นฐาน:

py -3 -m pip install --upgrade pip setuptools wheel

ติดตั้ง dependencies ที่จำเป็น:

py -3 -m pip install Flask Flask-RESTful Flask-Cors Flask-SQLAlchemy PyMySQL Flask-Migrate Flask-JWT-Extended marshmallow

📑 รายละเอียดแพ็กเกจ

• Flask — เว็บ framework หลัก
• Flask-RESTful — สำหรับสร้าง REST API (Resource-based)
• Flask-Cors — รองรับ CORS (Cross-Origin Resource Sharing)
• Flask-SQLAlchemy — ORM เชื่อมต่อ DB
• PyMySQL — MySQL driver
• Flask-Migrate — จัดการ database migrations (ใช้ Alembic)
• Flask-JWT-Extended — ทำ JWT Authentication
• marshmallow — (Optional) Schema & Data Validation

บันทึก dependencies ลงไฟล์:

py -3 -m pip freeze > requirements.txt

ติดตั้งจากไฟล์ (ถ้ามีการ clone โปรเจกต์มาใหม่):

py -3 -m pip install -r requirements.txt

---

⚙️ ตั้งค่า Environment Variable

$env:FLASK_APP="manage.py"

---

🗄️ Database Migration Commands

1. สร้างโฟลเดอร์ migrations (ครั้งแรกครั้งเดียว)

py -3 -m flask --app manage.py db init

2. สร้างไฟล์ Migration (autogenerate จาก models)

py -3 -m flask --app manage.py db migrate -m "create users table"

3. อัปเดตฐานข้อมูลตาม migration

py -3 -m flask --app manage.py db upgrade

---

✅ Workflow สรุป

1. Clone โปรเจกต์
2. สร้าง .venv ด้วย py -3 -m venv .venv
3. ติดตั้ง dependencies ผ่าน py -3 -m pip install -r requirements.txt
4. ตั้งค่า $env:FLASK_APP="manage.py"
5. ใช้ flask db migrate และ flask db upgrade เพื่อ sync database

pip freeze > requirements.txt

pip install -r requirements.txt

:: create venv py -3 -m venv .venv

:: activate (Command Prompt) venv\Scripts\activate

:: upgrade pip then install py -3 -m pip install --upgrade pip py -3 -m pip install -r requirements.txt

.venv\Scripts\activate python -m pip install -r requirements.txt python manage.py