日期：2026-06-17 branch：
feature/oscal-refactor範圍：FR-038 規劃頁 v2 遷移衍生的一連串缺口修復。下階段 = ap_authoring（稽核計畫填寫）。
規劃頁整合證據蒐集後，「待辦任務 / 任務佇列」恆空。追下去發現一連串 FR-038 Wave 2A「2B 重建」沒做的 stub —— 證據蒐集任務執行整條斷、總覽多個面板/進度 dark。本弧逐一補齊 BE+FE。
| commit | 內容 |
|---|---|
b99e8067 |
證據蒐集任務執行 BE — start_task_execution（PM 批次轉 PROCESSING + 通知）+ get_prep_job_progress（軟 gate 進度）+ route/DI/測試（5 綠）。設計記錄 evidence-task-execution-design.md。 |
| 主題 | 檔案 | 改動 / 根因 |
|---|---|---|
| 完成/退回死表 fix | app/flow_engine/service/workflow_execution_service.py |
complete_job / revert_job / notify_user_todo_job 開頭無條件查已 DROP 的 v1 表 oscal.assessment_plan_task_workflow_execution_mapping → 任務一完成就 500（PG transaction 毒化）。讓該 v1 路徑退場（ap_mapping=None + guard 下游 reviewer 通知 / 專案狀態更新）。 |
| 退回 flag | infra/grc/repository/grc_job_repo_impl.py |
get_job 寫死 can_revert_job=False → 退回鈕永不出現。改實際算 _compute_can_revert_job。 |
| 問卷型任務還原 | infra/grc/repository/grc_job_repo_impl.py |
6 個 survey 方法（get_job_survey_evidences/add_survey_evidence/get_job_ids/…）2A 被過度 stub（只查 job_evidences+survey 表、不碰死 OSCAL 表）→ 從 git 撈回原始實作；get_job 補載入 surveys + 真實 job_type。設問卷任務 → 抽屜顯示填寫卡片。 |
| Dashboard 重建 | infra/grc/repository/grc_project_repo_impl.py + domain/grc/service/grc_project_domain_service.py + app/grc/service/project_service.py + api/grc/routes/assessment_plan_route.py |
get_ap_dashboard 原 return {} → 用 per-AO prep-job 經 catalog 鏈統計（任務數/完成率/狀態分布/控制項數）。串 project_uid 進 route→app→domain→repo。 |
| 受評範圍 + resolver fix | app/grc/service/project_service.py + di_containers/grc/grc_containers.py |
components=[] 寫死 → 改查專案 living SSP 的 ssp_inventory_items（props ref-type：device→設備、information_system→稽核系統）。根因：SspProjectResolver.resolve_current_ssp 內部呼叫 SspService 不存在的 get_ssp_by_id → 自 2A 起永遠回 None；繞過它直接取 project_extension.living_ssp_id。注入 ssp_service。 |
| 受評標的 DTO | app/grc/dto/project_dto.py + api/grc/serializers/project.py + app/grc/service/project_service.py |
新 AssessmentTargetDto（範圍名稱/識別碼/安全分類/類型/負責人，從 SSP system characteristic + owner-uid 解析 nickname）。 |
| 主題 | 檔案 | 改動 |
|---|---|---|
| 開始執行任務按鈕 | ProjectPlanningView.vue + ProjectAuditorOverview.vue + api.js + project-planning.json(zh/en) |
規劃頁(header+進度條) + 總覽(自動分類證據旁) 各加 PM「開始執行任務」鈕（規劃階段才出現）+ confirm 對話框（確認發批次通知 + 進執行階段）。 |
| 批次完成原因回顯 | MyTasksView.vue |
批次完成結果畫面補顯示輸入的原因（原本沒顯示）。 |
| 受評標的 + 資產面板 | ProjectAuditorOverview.vue + auditor-overview.json(zh/en) |
「稽核系統」面板 → 受評標的（SSP system characteristic）；「設備」面板 → 資產（設備+系統整併、帶類型標籤）。icon pi-bullseye(不存在)→pi-compass。 |
| 控制項進度 | ProjectAuditorOverview.vue |
左側群組/控制項 % 原讀 BE 沒算的 completion_rate(恆 0) → 加 ctrlProgress/groupProgress 從 AO jobs 算。 |
| 規劃 banner 文案 | auditor-overview.json(zh/en) |
拿掉「啟動專案」重寫。 |
AO/控制項審閱在 v2 全壞（review resolver 2A stub + control-tree is_reviewed 寫死 False）（Not started）。_resolve_control_ids/_resolve_ao_id 回 None + control-tree is_reviewed 寫死 False。待決：審閱屬規劃還是稽核(AR)階段。workflow_execution_service.py 等也含 WIP），需人工分離後顯式 git add。start_task_execution 5 單元測試綠；其餘修復以 DB 實證 + py_compile 驗證，未補自動化測試。