┌─────────────────┐     ┌─────────────────┐
│    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

授權

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

聯絡資訊

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