Files
PROJECT-CONTORL/openspec/changes/archive/2026-01-05-add-gantt-view/specs/task-management/spec.md
beabigegg 2d80a8384e feat: implement custom fields, gantt view, calendar view, and file encryption
- Custom Fields (FEAT-001):
  - CustomField and TaskCustomValue models with formula support
  - CRUD API for custom field management
  - Formula engine for calculated fields
  - Frontend: CustomFieldEditor, CustomFieldInput, ProjectSettings page
  - Task list API now includes custom_values
  - KanbanBoard displays custom field values

- Gantt View (FEAT-003):
  - TaskDependency model with FS/SS/FF/SF dependency types
  - Dependency CRUD API with cycle detection
  - start_date field added to tasks
  - GanttChart component with Frappe Gantt integration
  - Dependency type selector in UI

- Calendar View (FEAT-004):
  - CalendarView component with FullCalendar integration
  - Date range filtering API for tasks
  - Drag-and-drop date updates
  - View mode switching in Tasks page

- File Encryption (FEAT-010):
  - AES-256-GCM encryption service
  - EncryptionKey model with key rotation support
  - Admin API for key management
  - Encrypted upload/download for confidential projects

- Migrations: 011 (custom fields), 012 (encryption keys), 013 (task dependencies)
- Updated issues.md with completion status

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-05 23:39:12 +08:00

2.3 KiB
Raw Blame History

MODIFIED Requirements

Requirement: Multiple Views

系統 SHALL 支援多維視角:看板 (Kanban)、甘特圖 (Gantt)、列表 (List)、行事曆 (Calendar)。

Scenario: 甘特圖視角

  • GIVEN 使用者選擇甘特圖視角
  • WHEN 系統載入專案任務
  • THEN 任務依時間軸顯示為水平條狀
  • AND 顯示任務相依關係與里程碑

Scenario: 甘特圖時間軸縮放

  • GIVEN 使用者正在查看甘特圖
  • WHEN 使用者切換縮放層級(日、週、月)
  • THEN 時間軸相應調整顯示密度
  • AND 任務條保持正確的相對位置

Scenario: 拖拉調整任務日期

  • GIVEN 使用者正在查看甘特圖
  • WHEN 使用者拖拉任務條改變位置或長度
  • THEN 系統更新任務的 start_date 和 due_date
  • AND 驗證日期合理性start_date <= due_date

Scenario: 顯示任務依賴關係

  • GIVEN 任務之間存在依賴關係
  • WHEN 使用者查看甘特圖
  • THEN 系統顯示連接任務的箭頭
  • AND 箭頭方向表示依賴方向(前置任務 → 後續任務)

Scenario: 新增任務依賴

  • GIVEN 使用者在甘特圖上選擇兩個任務
  • WHEN 使用者建立依賴關係
  • THEN 系統儲存依賴關係
  • AND 顯示連接箭頭

Scenario: 刪除任務依賴

  • GIVEN 任務之間存在依賴關係
  • WHEN 使用者刪除該依賴
  • THEN 系統移除依賴記錄
  • AND 連接箭頭消失

Scenario: 循環依賴檢測

  • GIVEN 使用者嘗試建立依賴關係
  • WHEN 該依賴會形成循環A → B → C → A
  • THEN 系統拒絕建立並顯示錯誤訊息
  • AND 現有依賴關係保持不變

Scenario: 依賴類型支援

  • GIVEN 使用者建立任務依賴
  • WHEN 使用者選擇依賴類型
  • THEN 系統支援以下類型:
    • Finish-to-Start (FS): 前置完成後開始
    • Start-to-Start (SS): 前置開始後開始
    • Finish-to-Finish (FF): 前置完成後完成
    • Start-to-Finish (SF): 前置開始後完成

ADDED Data Model

pjctrl_task_dependencies
├── id: UUID (PK)
├── predecessor_id: UUID (FK -> tasks)
├── successor_id: UUID (FK -> tasks)
├── dependency_type: ENUM('FS', 'SS', 'FF', 'SF') DEFAULT 'FS'
├── lag_days: INT DEFAULT 0
└── created_at: TIMESTAMP