3108fe1dff
- Backend (FastAPI): - Attachment and AttachmentVersion models with migration - FileStorageService with SHA-256 checksum validation - File type validation (whitelist/blacklist) - Full CRUD API with version control support - Audit trail integration for upload/download/delete - Configurable upload directory and file size limit - Frontend (React + Vite): - AttachmentUpload component with drag & drop - AttachmentList component with download/delete - TaskAttachments combined component - Attachments service for API calls - Testing: - 12 tests for storage service and API endpoints - OpenSpec: - add-document-management change archived 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
45 lines
1.6 KiB
Markdown
45 lines
1.6 KiB
Markdown
## MODIFIED Requirements
|
||
|
||
### Requirement: Audit Trail
|
||
系統 SHALL 記錄所有文件操作供稽核追溯，整合現有 audit-trail 模組。
|
||
|
||
#### Scenario: 操作日誌記錄
|
||
- **GIVEN** 使用者對附件執行任何操作（上傳、下載、刪除）
|
||
- **WHEN** 操作完成
|
||
- **THEN** 系統透過 AuditService 記錄操作至 `pjctrl_audit_logs`
|
||
- **AND** 使用 event_type: `attachment.upload`, `attachment.download`, `attachment.delete`
|
||
|
||
#### Scenario: 稽核查詢
|
||
- **GIVEN** 稽核人員需要查詢文件操作歷史
|
||
- **WHEN** 稽核人員透過 Audit API 執行查詢
|
||
- **THEN** 可依 resource_type=attachment 篩選
|
||
- **AND** 顯示完整操作歷史
|
||
|
||
## ADDED Requirements
|
||
|
||
### Requirement: File Size Limits
|
||
系統 SHALL 限制上傳檔案大小以確保系統穩定性。
|
||
|
||
#### Scenario: 檔案大小驗證
|
||
- **GIVEN** 使用者上傳檔案
|
||
- **WHEN** 檔案大小超過限制（預設 50MB）
|
||
- **THEN** 系統拒絕上傳並回傳錯誤訊息
|
||
|
||
#### Scenario: 大小限制配置
|
||
- **GIVEN** 管理者需要調整檔案大小限制
|
||
- **WHEN** 設定環境變數 MAX_FILE_SIZE_MB
|
||
- **THEN** 系統使用新的限制值
|
||
|
||
### Requirement: Mime Type Validation
|
||
系統 SHALL 驗證上傳檔案類型以確保安全性。
|
||
|
||
#### Scenario: 允許的檔案類型
|
||
- **GIVEN** 使用者上傳附件
|
||
- **WHEN** 檔案類型為常見文件格式（pdf, doc, xls, jpg, png, zip 等）
|
||
- **THEN** 系統接受上傳
|
||
|
||
#### Scenario: 危險檔案類型拒絕
|
||
- **GIVEN** 使用者上傳附件
|
||
- **WHEN** 檔案類型為可執行檔（exe, bat, sh, dll 等）
|
||
- **THEN** 系統拒絕上傳並回傳錯誤訊息
|