feat: implement user authentication module

- 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>

openspec/changes/archive/2025-12-28-add-user-auth/tasks.md

@@ -0,0 +1,138 @@
+# 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
+```