PROJECT CONTROL

跨部門專案管理系統 - 支援多維度任務追蹤、資源負載管理與即時協作。

功能特色

任務管理

• 多層級架構: 空間 (Space) → 專案 (Project) → 任務 (Task) → 子任務 (SubTask)
• 多維視角: 看板 (Kanban)、甘特圖 (Gantt)、行事曆 (Calendar)、列表 (List)
• 自訂欄位: 下拉選單、公式計算、人員標籤、日期欄位
• 任務依賴: 支援 FS/SS/FF/SF 四種依賴類型，自動循環檢測

資源管理

• 工作負載熱力圖: 視覺化團隊工作分配
• 容量規劃: 個人週時數設定與超載警示
• 專案健康度: 風險評分與預警機制

協作功能

• 即時同步: WebSocket 實現多人即時協作
• 評論系統: 支援 @mention 通知
• 阻礙追蹤: 任務阻礙管理與通知

安全與合規

• 稽核日誌: 完整操作歷史追蹤
• 檔案加密: AES-256 加密機密專案附件
• CSRF 保護: 跨站請求偽造防護
• RBAC: 角色權限控制

系統架構

┌─────────────────┐     ┌─────────────────┐
│    Frontend     │────▶│     Backend     │
│   React + TS    │     │    FastAPI      │
│   Port: 5173    │     │   Port: 8000    │
└─────────────────┘     └────────┬────────┘
                                 │
                    ┌────────────┼────────────┐
                    ▼            ▼            ▼
              ┌─────────┐  ┌─────────┐  ┌─────────┐
              │  MySQL  │  │  Redis  │  │  Files  │
              │   DB    │  │  Cache  │  │ Storage │
              └─────────┘  └─────────┘  └─────────┘

快速開始

系統需求

軟體	版本
Node.js	18+
Python	3.11+
MySQL	8.0+
Redis	6.0+

安裝步驟

# 1. 複製專案
git clone <repository-url>
cd PROJECT\ CONTORL

# 2. 後端設定
cd backend
cp .env.example .env
# 編輯 .env 設定資料庫連線
pip install -r requirements.txt
alembic upgrade head
uvicorn app.main:app --reload --port 8000

# 3. 前端設定 (另開終端)
cd frontend
npm install
npm run dev

存取服務

服務	網址
前端應用	http://localhost:5173
後端 API	http://localhost:8000
API 文件	http://localhost:8000/docs

專案結構

PROJECT CONTORL/
├── backend/              # FastAPI 後端
│   ├── app/              # 應用程式碼
│   ├── migrations/       # 資料庫遷移
│   └── tests/            # 測試檔案
├── frontend/             # React 前端
│   ├── src/              # 原始碼
│   └── public/           # 靜態資源
├── openspec/             # OpenSpec 規格文件
│   ├── specs/            # 功能規格
│   └── changes/          # 變更提案
├── DEPLOYMENT.md         # 部署指南
├── USER_MANUAL.md        # 使用者手冊
└── README.md             # 本文件

文件索引

文件	說明
backend/README.md	後端開發指南
frontend/README.md	前端開發指南
DEPLOYMENT.md	生產環境部署
USER_MANUAL.md	使用者操作手冊

技術棧

前端

• React 18 + TypeScript
• Vite (建置工具)
• react-i18next (國際化)
• WebSocket (即時同步)

後端

• FastAPI (Web 框架)
• SQLAlchemy 2.0 (ORM)
• Alembic (資料庫遷移)
• Redis (快取/Session)

基礎設施

• MySQL 8.0 (主資料庫)
• Redis 6.0 (快取層)
• JWT (認證)

開發指令

後端

cd backend

# 執行測試
pytest -v

# 執行開發伺服器
uvicorn app.main:app --reload

# 資料庫遷移
alembic upgrade head

前端

cd frontend

# 開發模式
npm run dev

# 建置生產版本
npm run build

# 程式碼檢查
npm run lint

授權

此專案為私有專案，未經授權禁止使用。

聯絡資訊

如有問題，請聯繫系統管理員。