10db2c9d1f
- Task Soft Delete:
- Add is_deleted, deleted_at, deleted_by fields to Task model
- Convert DELETE to soft delete with cascade to subtasks
- Add include_deleted query param (admin only)
- Add POST /api/tasks/{id}/restore endpoint
- Exclude deleted tasks from subtask_count
- Permission Change Audit:
- Add user.role_change event (high sensitivity)
- Add user.admin_change event (critical, triggers alert)
- Add PATCH /api/users/{id}/admin endpoint
- Add role.permission_change event type
- Append-Only Enforcement:
- Add DB triggers for audit_logs immutability (manual for production)
- Migration 008 with graceful trigger failure handling
- Tests: 11 new soft delete tests (153 total passing)
- OpenSpec: fix-audit-trail archived, fix-realtime-notifications & fix-weekly-report proposals added
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
99 lines
3.2 KiB
Markdown
99 lines
3.2 KiB
Markdown
## MODIFIED Requirements
|
||
|
||
### Requirement: Delete Operations Tracking
|
||
系統 SHALL 追蹤所有刪除操作，支援軟刪除與追溯。
|
||
|
||
#### Scenario: 任務刪除記錄
|
||
- **GIVEN** 使用者刪除任務
|
||
- **WHEN** 刪除操作執行
|
||
- **THEN** 系統執行軟刪除（設定 is_deleted = true, deleted_at, deleted_by）
|
||
- **AND** 記錄刪除操作至 audit_logs
|
||
- **AND** 子任務同步軟刪除
|
||
|
||
#### Scenario: 附件刪除記錄
|
||
- **GIVEN** 使用者刪除附件
|
||
- **WHEN** 刪除操作執行
|
||
- **THEN** 系統保留檔案於存檔區
|
||
- **AND** 記錄刪除操作詳情
|
||
|
||
#### Scenario: 任務還原
|
||
- **GIVEN** 管理員需要還原已刪除任務
|
||
- **WHEN** 執行還原操作
|
||
- **THEN** 系統設定 is_deleted = false
|
||
- **AND** 記錄還原操作
|
||
|
||
### Requirement: Change Logging
|
||
系統 SHALL 記錄所有關鍵變更操作，包含誰在何時改了什麼。
|
||
|
||
#### Scenario: 任務欄位變更記錄
|
||
- **GIVEN** 使用者修改任務的任何欄位（如截止日期、狀態、指派者）
|
||
- **WHEN** 變更儲存成功
|
||
- **THEN** 系統記錄變更前後的值
|
||
- **AND** 記錄操作者、時間、IP 位址
|
||
|
||
#### Scenario: 專案設定變更記錄
|
||
- **GIVEN** 管理者修改專案設定
|
||
- **WHEN** 設定變更儲存
|
||
- **THEN** 系統記錄所有變更的設定項目
|
||
- **AND** 記錄操作者與時間
|
||
|
||
#### Scenario: 權限變更記錄
|
||
- **GIVEN** 管理者修改使用者權限或角色
|
||
- **WHEN** 權限變更生效
|
||
- **THEN** 系統記錄權限變更詳情
|
||
- **AND** 標記為高敏感度操作
|
||
|
||
#### Scenario: 角色指派變更記錄
|
||
- **GIVEN** 管理者變更使用者角色
|
||
- **WHEN** role_id 變更儲存
|
||
- **THEN** 系統記錄 user.role_change 事件
|
||
- **AND** 標記 sensitivity_level = high
|
||
|
||
#### Scenario: 系統管理員變更記錄
|
||
- **GIVEN** 管理者變更使用者 is_system_admin
|
||
- **WHEN** 變更生效
|
||
- **THEN** 系統記錄 user.admin_change 事件
|
||
- **AND** 標記 sensitivity_level = critical
|
||
- **AND** 觸發即時警示
|
||
|
||
### Requirement: Audit Log Immutability
|
||
系統 SHALL 確保稽核日誌不可竄改。
|
||
|
||
#### Scenario: 日誌寫入
|
||
- **GIVEN** 需要記錄稽核事件
|
||
- **WHEN** 日誌寫入
|
||
- **THEN** 日誌記錄不可被修改或刪除
|
||
- **AND** 包含校驗碼確保完整性
|
||
|
||
#### Scenario: 日誌完整性驗證
|
||
- **GIVEN** 稽核人員需要驗證日誌完整性
|
||
- **WHEN** 執行完整性檢查
|
||
- **THEN** 系統驗證所有日誌記錄的校驗碼
|
||
- **AND** 報告任何異常
|
||
|
||
#### Scenario: 防止日誌修改
|
||
- **GIVEN** 任何對 audit_logs 表的 UPDATE 操作
|
||
- **WHEN** 操作執行
|
||
- **THEN** 資料庫 trigger 拒絕操作並拋出錯誤
|
||
|
||
#### Scenario: 防止日誌刪除
|
||
- **GIVEN** 任何對 audit_logs 表的 DELETE 操作
|
||
- **WHEN** 操作執行
|
||
- **THEN** 資料庫 trigger 拒絕操作並拋出錯誤
|
||
|
||
## MODIFIED Data Model
|
||
|
||
```
|
||
pjctrl_tasks (新增欄位)
|
||
├── is_deleted: BOOLEAN DEFAULT false
|
||
├── deleted_at: DATETIME (nullable)
|
||
├── deleted_by: UUID (FK -> users, nullable)
|
||
└── INDEX idx_task_deleted (is_deleted)
|
||
```
|
||
|
||
## MODIFIED Technical Notes
|
||
|
||
- 任務刪除改為軟刪除，保留 is_deleted, deleted_at, deleted_by
|
||
- 資料庫使用 BEFORE UPDATE/DELETE trigger 強制 append-only
|
||
- 查詢 API 預設過濾 is_deleted = true，管理員可用 include_deleted 參數
|