我的任務（My Tasks，受稽方執行）

功能群：稽核執行｜輪次狀態機與 AP→AR→POA&M 資料模型先讀 功能群總覽

事實基準：2026-07-05 從 FE / BE code 掃出（FR-038 v2 + 證據蒐集任務執行）；API schema 逐條對照 api/grc/serializers/job.py、api/grc/serializers/job_batch_complete.py 與 app/participant/service/task_assignee_service.py

1. 功能描述

我的任務是受稽方執行人員的跨專案任務收件匣：列出當前使用者被指派的證據蒐集任務（prep-job，由專案規劃頁的任務指派 + 開始執行任務產生），提供上傳證據 / 填問卷 / 留言 / 完成任務的執行面。與 AP/AR/POA&M 頁不同，本頁不綁單一輪次階段，而是以任務狀態（TODO / PROCESSING / COMPLETED）為 gate，跨所有專案彙整當前使用者的待辦。

主要使用者：任務被指派人（assignee，受稽方）；覆核人（reviewer / is_approver）另有退回權。

角色速覽（本頁角色是任務層，不是專案層的 manager/auditor/viewer）：

任務的來源與文案真相在專案規劃頁的 prep-job（BPMN userTask 衍生，見 專案規劃頁）；本頁是其執行下游。PM 在規劃頁「開始執行任務」把任務 TODO→PROCESSING 後，任務才出現在受稽方的收件匣可執行。

1.1 功能總覽（本頁全部功能）

UC（§2）展開本頁所有具實質後端寫入邏輯的功能：單任務執行完成（含上傳 FILE 證據，1/7/11）、批次完成（5）、連結證據增改刪（8）、任務留言（10）、覆核人退回（12）。純顯示 / 導覽類（1 清單、2 搜尋、3/4 篩選）見 §5 / §6.2；填問卷（9）另有所屬頁面（開 survey-v2-fill 新分頁填寫，本頁只顯示狀態並作為完成 gate，見 §11），於此只交叉連結不重複。

2. Use Case

角色速覽（本頁角色是任務層，不是專案層的 manager/auditor/viewer）：

流程圖視覺慣例：菱形 = 判斷、橘底 = 例外/擋下、紅框 = 錯誤（標 error code）、綠框 = 成功終點、虛線 = 可選路徑。

UC-MT-01 執行並完成單一任務

UC-MT-02 批次完成任務

UC-MT-03 新增 / 編輯連結證據（LINK）

UC-MT-04 任務留言增改刪

UC-MT-05 覆核人退回任務

3. 權限矩陣

本頁以「任務指派關係」為權限基礎（非專案層角色）：

本頁清單天然過濾成「當前使用者被指派」，故無專案角色守門；權限邊界在「任務是否指派給你」+「任務狀態是否 PROCESSING」。退回權（reviewer）是 FE 依專案 participant role 顯示。

4. 狀態機與前置條件

本頁 gate 是任務狀態（不是輪次階段）：

TODO ──（PM 於規劃頁「開始執行任務」）──▶ PROCESSING ──（assignee 完成 / 批次完成）──▶ COMPLETED
                                              ▲                        │
                                              └────（reviewer 退回）────┘

輪次階段與本頁的關係：prep-job 在規劃期（planning）建立、PM「開始執行任務」啟動；受稽方在此執行。任務完成度回饋規劃頁的「證據蒐集執行進度卡」（見 專案規劃頁 §10）。

5. UI 設計

版面骨架與區塊職責（左清單 + 右分割抽屜；body 加 page-fullscreen 讓抽屜獨立捲動；彩色區塊可點跳對應小節錨點，API 僅標代表性）：

實機截圖（STG，亮色模式，2026-07-05，帳號 blsadmin）：

批次完成 dialog 截圖從缺：勾選框僅在任務已上傳至少 1 份證據（attachment_count > 0）時才會啟用（見 MyTasksView.vue::canComplete），2026-07-05 盤點 STG 目前所有任務證據數皆為 0，暫無可勾選資料；上傳證據屬寫入動作，不在本次唯讀截圖範圍內。

狀態呈現：任務狀態徽章（TODO/PROCESSING/COMPLETED）；可完成任務才可勾選（否則 checkbox disabled 帶原因 tooltip）；無 socket，動作後重取清單 / 明細。URL ?job=<uid> / ?execution=<uid> 可深鏈自動開任務（進頁後清 URL）。

6. API 規格

Envelope：成功 {"code": 1, "data": …}、失敗 {"code": 0, "msg": "…"}。分頁列表回 PageDataDto（meta + data）。

6.1 總清單（本頁呼叫的全部 endpoint）

以下 §6.2~6.4 為核心 endpoint 完整規格（欄位逐條對照 serializer / service 組裝碼，出處標在各段末）。

6.2 我的任務清單

[POST] /grc/jobs/my/list

Request（MyJobListRequestSchema，繼承 RequestMetaSchema）：

Response data（MyJobResponseSchema，每項）：

出處：serializer api/grc/serializers/job.py:205（Request）/ :210（Response）；service app/participant/service/task_assignee_service.py:269（list_my_grc_jobs：查使用者任務佇列 → 補 attachment_count / survey_completed）

6.3 任務明細

[GET] /grc/project/{project_uid}/job/{job_uid}

Response data（JobDetailResponseSchema）：

出處：api/grc/serializers/job.py:160

6.4 批次完成

[POST] /grc/project/{project_uid}/jobs/batch-complete

Request（BatchCompleteRequestSchema）：

Response（BatchCompleteResponseSchema）：

逐專案分送（FE 依 project 分組多次呼叫）；per-job suppress_notify，最後統一批次通知。出處：serializer api/grc/serializers/job_batch_complete.py:5（Request）/ :16（Response）；service app/grc/service/job_batch_complete_service.py:30

7. 前端檔案地圖（compliance-manager-fe/）

導覽入口：DashboardView「我的任務」區塊 / 「查看全部」→ router.push({name:'project-my-tasks', query:{job}})；問卷開新分頁到 survey-v2-fill。本頁不連 workflow-setup / workflow-view（那是 BPMN 範本編輯，屬另一群）。

8. 後端檔案地圖（本頁核心鏈路）

DDD 提醒：清單走 app service（不在 route 查 DB）；批次完成的就緒複驗在 service 層、每筆獨立成敗回報（不因一筆失敗整批 rollback）。

9. DB

9.1 資料表總清單（本頁讀寫的全部表）

清單讀取走「使用者任務佇列」查詢（task_assignees join job_executions 過濾 user_id），批次補 job_evidences 計數與 task_surveys 完成集。

9.3 核心表欄位（取自 DEV DB dump，含 DB comment）

compliance.job_evidences — 任務執行佐證資料

compliance.job_execution_comments — 任務執行留言表

job_executions / task_assignees 欄位卡見 專案規劃頁 §9.3（本頁不重複；那裡以寫入者視角、本頁以執行者視角讀寫同組表）。

10. 頁面邏輯與資料對應

載入時序：

關鍵欄位對應（畫面 ↔︎ API）：

儲存流程：證據上傳 / 留言後重取明細；完成 / 退回走 flow-engine（BPMN 前進）；批次完成逐專案分送、per-job 成敗獨立、最後統一通知。

錯誤對應：BE error envelope → toast；GRC_JOB_NOT_FOUND（404）、GRC_PROJECT_PARTICIPANT_NOT_FOUND（404）；批次錯誤碼 NO_EVIDENCE / SURVEY_INCOMPLETE（在 results[].error，非 GRC 碼，FE 對 i18n 顯示）。

11. 背景行為與外部依賴

12. 邊界情況與已知坑

1. 本頁 gate 是任務狀態不是輪次階段：TODO 未啟動不顯示；PROCESSING 才可執行；跨專案彙整，非單輪次頁
2. 就緒條件按任務類型：general 需 ≥1 證據；survey 需全 task_surveys status=9；不就緒 checkbox disabled 帶原因
3. 批次完成逐專案分送、per-job 獨立成敗：一筆失敗（NO_EVIDENCE / SURVEY_INCOMPLETE）不影響其他；結果摘要逐筆回報，非整批 rollback
4. 全選只選當前分頁的可完成任務：不跨頁全選（防誤選未見任務）
5. 退回權是 reviewer（FE 判定）：isReviewer 由專案 participant role=reviewer 決定，只在覆核模式顯示退回
6. 深鏈自動開任務：?job= / ?execution= 進頁自動選任務後清 URL（避免連鎖導航）
7. 證據自成 FILE / LINK 兩型：FILE 走 /job-evidences（multipart）、LINK 走 /job-evidence（FormData json）；端點路徑單複數不同，改動注意
8. 不連 workflow-setup / workflow-view：那是 BPMN 範本編輯頁（另一群），本頁任務執行走抽屜、非全頁導航

13. 開發與驗證

• 跑起來：BE python main_socketio.py（port 8000，log 在 log/app.log）；FE 在 compliance-manager-fe/ 起 Vite dev server。BE 改 service code 後必須重啟（無 hot reload）
• 測試帳號：dev 環境被指派任務的受稽方帳號（密碼見 .env / 部署文件）
• 導航路徑：登入 → 儀表板「我的任務」或直接 /project/task-manage
• 前置資料：需有專案在規劃頁指派任務給該帳號且 PM 已「開始執行任務」（任務 PROCESSING）
• E2E：compliance-manager-test/ repo（Cucumber + Playwright）；以 我的任務 / my-tasks 搜尋
• 相關文件：任務來源見 專案規劃頁；稽核員視角的清單見 我的稽核；DB / API 全量見 GAI-SD-02/03