1fda7da2c2
- Backend (FastAPI): - External API authentication (pj-auth-api.vercel.app) - JWT token validation with Redis session storage - RBAC with department isolation - User, Role, Department models with pjctrl_ prefix - Alembic migrations with project-specific version table - Complete test coverage (13 tests) - Frontend (React + Vite): - AuthContext for state management - Login page with error handling - Protected route component - Dashboard with user info display - OpenSpec: - 7 capability specs defined - add-user-auth change archived 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
139 lines
4.1 KiB
Markdown
139 lines
4.1 KiB
Markdown
# Tasks: add-user-auth
|
||
|
||
## 1. 專案初始化
|
||
|
||
- [x] 1.1 建立 Conda 環境與 requirements.txt
|
||
- [x] 1.2 初始化 FastAPI 專案結構
|
||
- [x] 1.3 設定 MySQL 連線與 SQLAlchemy
|
||
- [x] 1.4 設定 Redis 連線
|
||
- [x] 1.5 建立環境變數配置 (.env.example)
|
||
|
||
## 2. 資料庫模型
|
||
|
||
- [x] 2.1 建立 `pjctrl_roles` 資料表 migration
|
||
- [x] 2.2 建立 `pjctrl_departments` 資料表 migration
|
||
- [x] 2.3 建立 `pjctrl_users` 資料表 migration
|
||
- [x] 2.4 建立 seed data (預設管理員與角色)
|
||
- [x] 2.5 驗證 migration 可正確執行與回滾
|
||
|
||
## 3. 認證模組
|
||
|
||
- [x] 3.1 實作外部 API 認證 client (`app/services/auth_client.py`)
|
||
- [x] 3.2 實作 JWT Token 驗證邏輯
|
||
- [x] 3.3 實作登入 API endpoint (`POST /api/auth/login`)
|
||
- [x] 3.4 實作登出 API endpoint (`POST /api/auth/logout`)
|
||
- [x] 3.5 實作取得當前使用者 API (`GET /api/auth/me`)
|
||
- [x] 3.6 處理認證 API 連線失敗情境
|
||
|
||
## 4. Session 管理
|
||
|
||
- [x] 4.1 實作 Redis Session 儲存
|
||
- [x] 4.2 實作 Session 過期機制
|
||
- [x] 4.3 實作 Token 刷新機制 (如需要) - 暫不需要
|
||
|
||
## 5. 權限控制
|
||
|
||
- [x] 5.1 實作認證中間件 (`app/middleware/auth.py`)
|
||
- [x] 5.2 實作 RBAC 權限檢查裝飾器
|
||
- [x] 5.3 實作部門隔離邏輯
|
||
- [x] 5.4 實作系統管理員全域權限判斷
|
||
|
||
## 6. 使用者管理 API
|
||
|
||
- [x] 6.1 實作使用者列表 API (`GET /api/users`)
|
||
- [x] 6.2 實作使用者詳情 API (`GET /api/users/{id}`)
|
||
- [x] 6.3 實作角色指派 API (`PATCH /api/users/{id}/role`)
|
||
- [x] 6.4 實作部門管理 API (CRUD)
|
||
|
||
## 7. 測試
|
||
|
||
- [x] 7.1 撰寫認證模組單元測試
|
||
- [x] 7.2 撰寫權限檢查單元測試
|
||
- [x] 7.3 撰寫 API 整合測試
|
||
- [x] 7.4 測試系統管理員權限
|
||
- [x] 7.5 測試部門隔離情境
|
||
|
||
## 8. 前端 (基礎)
|
||
|
||
- [x] 8.1 建立 React 專案結構
|
||
- [x] 8.2 實作 AuthContext (認證狀態管理)
|
||
- [x] 8.3 實作登入頁面
|
||
- [x] 8.4 實作 Protected Route 元件
|
||
- [x] 8.5 實作登出功能
|
||
|
||
## Dependencies
|
||
|
||
```
|
||
1.x (專案初始化) → 2.x (資料庫) → 3.x (認證) → 4.x (Session)
|
||
↓
|
||
5.x (權限) → 6.x (使用者管理)
|
||
↓
|
||
7.x (測試)
|
||
|
||
8.x (前端) 可與 3.x-6.x 並行開發
|
||
```
|
||
|
||
## Notes
|
||
|
||
- 所有資料表使用 `pjctrl_` 前綴
|
||
- 認證必須透過外部 API，不可有本地繞過
|
||
- 系統管理員帳號在 seed data 中建立
|
||
|
||
## Implementation Summary
|
||
|
||
完成日期: 2024-01-XX
|
||
|
||
### 已建立的檔案結構
|
||
|
||
```
|
||
backend/
|
||
├── app/
|
||
│ ├── api/
|
||
│ │ ├── auth/router.py # 認證 API
|
||
│ │ ├── users/router.py # 使用者管理 API
|
||
│ │ └── departments/router.py # 部門管理 API
|
||
│ ├── core/
|
||
│ │ ├── config.py # 環境配置
|
||
│ │ ├── database.py # 資料庫連線
|
||
│ │ ├── redis.py # Redis 連線
|
||
│ │ └── security.py # JWT 處理
|
||
│ ├── middleware/
|
||
│ │ └── auth.py # 認證與權限中間件
|
||
│ ├── models/
|
||
│ │ ├── user.py # User model
|
||
│ │ ├── role.py # Role model
|
||
│ │ └── department.py # Department model
|
||
│ ├── schemas/ # Pydantic schemas
|
||
│ ├── services/
|
||
│ │ └── auth_client.py # 外部認證 API client
|
||
│ └── main.py # FastAPI 應用程式
|
||
├── migrations/
|
||
│ └── versions/
|
||
│ └── 001_initial_auth_tables.py
|
||
├── tests/
|
||
│ ├── conftest.py
|
||
│ ├── test_auth.py
|
||
│ └── test_users.py
|
||
├── .env
|
||
├── .env.example
|
||
├── requirements.txt
|
||
└── environment.yml
|
||
|
||
frontend/
|
||
├── src/
|
||
│ ├── components/
|
||
│ │ └── ProtectedRoute.tsx
|
||
│ ├── contexts/
|
||
│ │ └── AuthContext.tsx
|
||
│ ├── pages/
|
||
│ │ ├── Login.tsx
|
||
│ │ └── Dashboard.tsx
|
||
│ ├── services/
|
||
│ │ └── api.ts
|
||
│ ├── App.tsx
|
||
│ └── main.tsx
|
||
├── package.json
|
||
├── tsconfig.json
|
||
└── vite.config.ts
|
||
```
|