Files
PROJECT-CONTORL/backend
beabigegg 4b5a9c1d0a feat: complete LOW priority code quality improvements
Backend:
- LOW-002: Add Query validation with max page size limits (100)
- LOW-003: Replace magic strings with TaskStatus.is_done flag
- LOW-004: Add 'creation' trigger type validation
- Add action_executor.py with UpdateFieldAction and AutoAssignAction

Frontend:
- LOW-005: Replace TypeScript 'any' with 'unknown' + type guards
- LOW-006: Add ConfirmModal component with A11Y support
- LOW-007: Add ToastContext for user feedback notifications
- LOW-009: Add Skeleton components (17 loading states replaced)
- LOW-010: Setup Vitest with 21 tests for ConfirmModal and Skeleton

Components updated:
- App.tsx, ProtectedRoute.tsx, Spaces.tsx, Projects.tsx, Tasks.tsx
- ProjectSettings.tsx, AuditPage.tsx, WorkloadPage.tsx, ProjectHealthPage.tsx
- Comments.tsx, AttachmentList.tsx, TriggerList.tsx, TaskDetailModal.tsx
- NotificationBell.tsx, BlockerDialog.tsx, CalendarView.tsx, WorkloadUserDetail.tsx

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 21:24:36 +08:00
..
2025-12-29 00:31:34 +08:00

PROJECT CONTROL Backend

FastAPI 後端服務

系統需求

必要服務

服務 版本 說明
Python 3.11+ 執行環境
MySQL 8.0+ 主要資料庫
Redis 6.0+ Session 存儲

Redis Server 安裝

Redis Python 套件 (redis==5.0.1) 僅為客戶端,需另外安裝 Redis Server

macOS (Homebrew):

brew install redis
brew services start redis

Ubuntu/Debian:

sudo apt update
sudo apt install redis-server
sudo systemctl start redis-server
sudo systemctl enable redis-server

Docker:

docker run -d --name redis -p 6379:6379 redis:alpine

驗證安裝:

redis-cli ping
# 應回傳 PONG

環境建置

# 使用 Conda
conda env create -f environment.yml
conda activate pjctrl

# 或使用 pip
pip install -r requirements.txt

設定

複製並編輯環境變數:

cp .env.example .env

主要設定項目:

  • MYSQL_* - 資料庫連線
  • REDIS_* - Redis 連線
  • JWT_SECRET_KEY - JWT 簽名密鑰 (生產環境必須更換)
  • AUTH_API_URL - 外部認證 API

執行

# 開發模式
uvicorn app.main:app --reload --port 8000

# 生產模式
uvicorn app.main:app --host 0.0.0.0 --port 8000

資料庫遷移

# 升級至最新版本
alembic upgrade head

# 回滾一個版本
alembic downgrade -1

測試

pytest -v