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>
153 lines
5.1 KiB
Markdown
153 lines
5.1 KiB
Markdown
# Automation
|
|
|
|
自動化系統，提供觸發器與自動報告生成功能。
|
|
|
|
## Requirements
|
|
|
|
### Requirement: Trigger-Based Automation
|
|
系統 SHALL 支援觸發器 (Triggers)，當特定條件滿足時自動執行動作。
|
|
|
|
#### Scenario: 狀態變更觸發通知
|
|
- **GIVEN** 專案設定了「當任務狀態變更為待測試時，通知設備工程師」的觸發器
|
|
- **WHEN** 任務狀態變更為「待測試」
|
|
- **THEN** 系統自動發送通知給指定的設備工程師群組
|
|
|
|
#### Scenario: 截止日期觸發提醒
|
|
- **GIVEN** 專案設定了「截止日前 3 天自動提醒」的觸發器
|
|
- **WHEN** 任務距離截止日還有 3 天
|
|
- **THEN** 系統自動發送提醒給任務指派者
|
|
|
|
#### Scenario: 建立觸發器
|
|
- **GIVEN** 專案管理者需要建立自動化規則
|
|
- **WHEN** 管理者設定觸發條件與動作
|
|
- **THEN** 系統儲存觸發器規則
|
|
- **AND** 規則立即生效
|
|
|
|
### Requirement: Trigger Conditions
|
|
系統 SHALL 支援多種觸發條件類型。
|
|
|
|
#### Scenario: 欄位變更條件
|
|
- **GIVEN** 觸發器設定為「當 Status 欄位變更為特定值」
|
|
- **WHEN** 任務的 Status 欄位變更為該值
|
|
- **THEN** 觸發器被觸發
|
|
|
|
#### Scenario: 時間條件
|
|
- **GIVEN** 觸發器設定為「每週五下午 4:00」
|
|
- **WHEN** 系統時間達到設定時間
|
|
- **THEN** 觸發器被觸發
|
|
|
|
#### Scenario: 複合條件
|
|
- **GIVEN** 觸發器設定為「當 Status = 完成 且 Priority = 高」
|
|
- **WHEN** 任務同時滿足兩個條件
|
|
- **THEN** 觸發器被觸發
|
|
|
|
### Requirement: Trigger Actions
|
|
系統 SHALL 支援多種觸發動作類型。
|
|
|
|
#### Scenario: 發送通知動作
|
|
- **GIVEN** 觸發器動作設定為發送通知
|
|
- **WHEN** 觸發器被觸發
|
|
- **THEN** 系統發送通知給指定對象
|
|
- **AND** 通知內容可使用變數（如任務名稱、指派者）
|
|
|
|
#### Scenario: 更新欄位動作
|
|
- **GIVEN** 觸發器動作設定為更新欄位
|
|
- **WHEN** 觸發器被觸發
|
|
- **THEN** 系統自動更新指定欄位的值
|
|
|
|
#### Scenario: 指派任務動作
|
|
- **GIVEN** 觸發器動作設定為自動指派
|
|
- **WHEN** 觸發器被觸發
|
|
- **THEN** 系統自動將任務指派給指定人員
|
|
|
|
### Requirement: Automated Weekly Report
|
|
系統 SHALL 每週五下午 4:00 自動彙整本週「已完成」與「進行中」的任務發送給主管。
|
|
|
|
#### Scenario: 週報自動生成
|
|
- **GIVEN** 系統排程設定為每週五 16:00
|
|
- **WHEN** 到達排程時間
|
|
- **THEN** 系統彙整每位主管所屬專案的任務狀態
|
|
- **AND** 生成週報並發送給該主管
|
|
|
|
#### Scenario: 週報內容
|
|
- **GIVEN** 週報生成中
|
|
- **WHEN** 系統彙整資料
|
|
- **THEN** 週報包含：
|
|
- 本週已完成任務清單
|
|
- 進行中任務清單
|
|
- 逾期任務警示
|
|
- 阻礙中任務清單
|
|
- 下週預計完成任務
|
|
|
|
#### Scenario: 週報發送方式
|
|
- **GIVEN** 週報已生成
|
|
- **WHEN** 系統發送週報
|
|
- **THEN** 透過系統內通知發送給收件者
|
|
- **AND** 週報可在系統內查閱歷史紀錄
|
|
|
|
#### Scenario: Email 發送（可選）
|
|
- **GIVEN** 週報已生成且系統已啟用 Email 功能
|
|
- **WHEN** 系統發送週報
|
|
- **THEN** 同時透過 Email 發送給收件者
|
|
- **AND** 記錄 Email 發送狀態
|
|
|
|
#### Scenario: Email 未啟用
|
|
- **GIVEN** 週報已生成但系統未啟用 Email 功能
|
|
- **WHEN** 系統發送週報
|
|
- **THEN** 僅透過系統內通知發送
|
|
- **AND** 記錄「Email 未啟用，僅發送系統通知」
|
|
|
|
## Data Model
|
|
|
|
```
|
|
pjctrl_triggers
|
|
├── id: UUID (PK)
|
|
├── project_id: UUID (FK -> projects)
|
|
├── name: VARCHAR(200)
|
|
├── description: TEXT
|
|
├── trigger_type: ENUM('field_change', 'schedule', 'creation')
|
|
├── conditions: JSON
|
|
│ └── { "field": "status", "operator": "equals", "value": "testing" }
|
|
├── actions: JSON
|
|
│ └── [{ "type": "notify", "target": "group:equipment_engineers" }]
|
|
├── is_active: BOOLEAN DEFAULT true
|
|
├── created_by: UUID (FK -> users)
|
|
├── created_at: TIMESTAMP
|
|
└── updated_at: TIMESTAMP
|
|
|
|
pjctrl_trigger_logs
|
|
├── id: UUID (PK)
|
|
├── trigger_id: UUID (FK -> triggers)
|
|
├── task_id: UUID (FK -> tasks, nullable)
|
|
├── executed_at: TIMESTAMP
|
|
├── status: ENUM('success', 'failed')
|
|
└── error_message: TEXT
|
|
|
|
pjctrl_scheduled_reports
|
|
├── id: UUID (PK)
|
|
├── report_type: ENUM('weekly', 'monthly', 'custom')
|
|
├── recipient_id: UUID (FK -> users)
|
|
├── schedule_cron: VARCHAR(50)
|
|
├── last_sent_at: TIMESTAMP
|
|
├── next_run_at: TIMESTAMP
|
|
├── is_active: BOOLEAN DEFAULT true
|
|
├── email_enabled: BOOLEAN DEFAULT false (Email 發送開關)
|
|
└── created_at: TIMESTAMP
|
|
|
|
pjctrl_report_history
|
|
├── id: UUID (PK)
|
|
├── scheduled_report_id: UUID (FK -> scheduled_reports)
|
|
├── generated_at: TIMESTAMP
|
|
├── content: JSON
|
|
├── sent_to: JSON (array of user IDs)
|
|
├── channels_used: JSON (e.g., ["in_app"] or ["in_app", "email"])
|
|
├── email_status: ENUM('sent', 'skipped', 'failed', null)
|
|
└── status: ENUM('sent', 'failed')
|
|
```
|
|
|
|
## Technical Notes
|
|
|
|
- 使用 Celery + Redis 處理排程任務
|
|
- 觸發器執行採用非同步處理，避免阻塞主流程
|
|
- 所有觸發器執行都記錄日誌供追蹤
|