FR-112 · 收尾 SUMMARY · 2026-09-19
24 張 Notion 卡全部 Done，跨四個 repo。本文彙整做了什麼、使用者看得到的前後差異，以及 arc-review 後的修正與發版收尾（§10）。
狀態：實作完成，arc-review 已修正、已 push｜日期：2026-09-19（arc-review 收尾 2026-09-20） 母卡 CM-1952｜子需求 CM-1953（套件）／CM-1957（BE）／CM-1966（FE）｜子任務 CM-1954～1976、CM-1977～1980
PM 要替一個查核項目多開一件事，動線回到專案規劃頁——按「新增任務」、填名稱、存檔就好；新任務預設平行（誰先做都行，全部做完該查核項目才算過）。流程圖編輯器降為純粹的走向設計工具，屬性面板只剩名稱。連帶修掉一個既有引擎缺口：合流閘道不等兄弟分支就放行。
feature/planning-task-parallel-flow）| hash | 做了什麼 |
|---|---|
e931f5a1 |
討論稿與 design 定案（D1–D7 拍板，拆 4 子需求 16 子任務） |
d88c1b4a |
D6 改為「至少保留一個任務」——刪到零在兩個入口都擋下 |
5937f03b |
D-4.1 開工前查證落地：輪次圖與查核項目圖不共用（DEV 全庫 44 vs 1525 零交集），可開工；覆核輪 re-clone 陷阱列為延伸項 |
efe31bf6 |
🔴 合流閘道等待修正兩落點（complete_job / complete_main_workflow_job），共用私有判定方法、不複製第三份 |
4fbc68c3 |
新增任務不帶節點編號時後端自己在圖上掛平行分支＋主表／翻譯表雙寫 |
0b558ed9 |
圖寫入收斂成只寫 name；描述／指南／類型的讀取路徑改讀 DB 欄位 |
78f15021 |
刪除任務升為主路徑：至少保留一筆、移節點改走雙寫 |
36cf6161 |
初始狀態與可否退回改依拓樸判定（不再看數量、不再只看下一批第 0 筆） |
7a4dd71e |
流程圖存檔改由後端三向 diff 決定新增／刪除；新增 workflow_xml_sync_service.py |
868c7ec9 |
§5.8 加第五列：一節點對多筆任務擋下、不靜默刪 |
6b39e730 |
新增／刪除任務接規劃期守門（GRC_412054）；存檔端點只在真的要增減任務時才問 |
da9e8a32 |
子需求 B 收尾：實作一節點多任務擋下（GRC_400127）、修假倉儲缺方法、reviewer 掃描 |
081b39be |
任務清單改依建立時間排序（ORDER BY je.created_at ASC, je.id ASC） |
9e7e4957 |
任務區塊 Master-Detail 重排 mockup（決策者手測後裁示，C-3.5 依據） |
8e17b7bd |
建案寫範本 XML 改走倉儲雙寫——新專案開編輯器不再一存就被擋 |
| hash | 做了什麼 |
|---|---|
bdeacba |
規劃頁任務區塊補新增／刪除任務按鈕（C-3.1） |
737b846 |
流程圖編輯器屬性面板瘦身到只剩名稱（C-3.2） |
7ab8d14 |
編輯器存檔瘦身到只存一次 XML，增刪交給後端三向 diff（C-3.3） |
6b07993 |
存檔被擋下時顯示是哪個節點有問題（三支碼併陳 BE 明細） |
ba4346d |
補 GRC_412054 兩語系翻譯 |
03df3b4 |
補 GRC_400127 翻譯＋併陳 BE 明細 |
84cece0 |
AO「已配置」改為全部任務都有指派人才算（some → every） |
aba80cb |
「任務設定」統計改以任務為單位（與「證據蒐集」分母一致） |
0f6b36e |
AO 卡「未配置」標籤帶筆數（1/2 未配置） |
01a78a1 |
任務區塊改 Master-Detail 並抽成子元件（C-3.5，主檔淨減 880 行） |
ff8d9ef |
統計卡可點開未設定清單，與範本頁共用同一組元件（C-3.4） |
177ae97 |
任務區塊改上下排版——清單改橫向籤列、表單吃滿寬 |
2cfd545 |
任務籤列改用 PrimeVue TabView，移除自刻的 AoTaskList |
1c2e58a |
任務區塊外層改 dark-card 與現況說明卡一致 |
8cbca4c |
規劃頁四處風格統一（麵包屑改 Breadcrumb、SSP 分頁包卡片、主籤列接合內容） |
fb50c0f |
規劃頁與範本編輯頁版型統一，版型樣式抽共用檔 _planning-layout.scss |
f25b452 |
專案總覽頁與任務抽屜對齊規劃頁版型；AO 任務區抽成清單元件 |
c787e7b |
待辦任務抽屜改覆蓋滑入＋表格內建捲動；抽屜頁首重排、底色統一 |
eaf2bbe |
抽屜頁首與租戶分組抽子元件——超標檔行數回到改前 |
a57351a |
補 FLOW_ENGINE_412003 翻譯＋刪除鈕停用原因改成畫面常駐 |
| hash | 做了什麼 |
|---|---|
b5d36c0 |
新增 bpmn_topology.py 三支純查詢函式：分叉／合流分辨、上游型別、兄弟分支末端任務（A-1.3） |
27984b1 |
append_parallel_user_task_to_xml()：三種圖形收斂成同一支函式，既有節點 id 與 uid 全程不動（A-1.1） |
e34372a |
remove_user_task_from_xml() 擴充：收退化閘道、擋下刪到零任務（新碼 FLOW_ENGINE_412003）（A-1.2） |
| hash | 做了什麼 |
|---|---|
9653718 |
FR-112 平行任務 e2e 回歸與新情境：既有回歸對齊 DOM 改版（紅 23 → 0）＋新增 12 條情境（D-4.3） |
d068536 |
拿掉 @known-bug 標記——四條全轉綠 |
| 層 | 主要落點 |
|---|---|
| 套件 | jedi_flow_engine/common/utils/bpmn_topology.py（新）、bpmn_uilts.py（插節點／移節點）、common/enum/error_code.py（＋1 碼） |
| BE app | app/flow_control/service/workflow_xml_sync_service.py（新，223 行）、job_service.py（守門＋delete_job_from_diagram）、app/flow_engine/service/workflow_execution_service.py（合流等待兩落點） |
| BE infra | infra/flow_control/repository/flow_control_job_repo_impl.py（插節點／雙寫／初始狀態／可否退回／create_job_for_node 等）、infra/readmodel/oscal/ssp_control_implementation_query.py（排序＋三欄） |
| BE 其他 | app/flow_control/service/prep_job_generation_service.py（建案寫範本改雙寫）、common/code/flow_control_error_code.py（＋5 碼）、api/module_frame（存檔端點接 sync service） |
| FE | ProjectPlanningView.vue（3,682 → 2,776 行）、新元件 AoTaskSection / AoTaskForm / PlanningStatsBar / StatCard / UnfilledListOverlay、composable usePlanningStats / usePlanningJump、WorkflowSetupEditor.vue（瘦身到 588 行）、三語系 error-code.json |
| test | site-regression/ 新增 planning-task-parallel.feature（12 條）＋兩支 page object ＋ factory；既有回歸對齊 DOM |
| DB | 無 migration（本案不動 schema） |
| 場景 | 之前 | 現在 |
|---|---|---|
| 替一個查核項目多開一件事 | 只能開流程圖編輯器、拖方塊、手動接線、填一堆屬性 | 規劃頁按「新增任務」、填名稱、存檔；後端自己畫圖 |
| 一個查核項目的任務數 | 實質只有一筆 | 可多筆，預設平行（誰先做都行） |
| 該查核項目何時算通過 | 那一筆完成即通過 | 全部任務完成才通過 |
| 多筆任務的畫面 | 每筆一個可展開面板往下堆，四筆全展開要捲好幾屏 | 上方籤列選一筆、下方顯示那一筆的表單；只有一筆時籤列不顯示 |
| 刪除任務 | 只能在流程圖編輯器刪方塊，任務可能還在 | 規劃頁與編輯器兩個入口效果完全一樣，都會真的刪掉任務與關聯資料 |
| 刪到最後一筆 | 可以刪光（該項目變成「開始→結束」、無人經手即通過） | 擋下，按鈕旁常駐顯示「查核項目至少要有一個任務」 |
| 稽核開跑後改任務清單 | 沒有限制 | 新增／刪除鈕停用並顯示原因、後端同步擋下；純調整走向仍然存得下去 |
| 流程圖編輯器屬性面板 | 名稱／工作描述／指南／任務類型／設備／部門 | 只剩名稱；其餘回規劃頁填 |
| 編輯器存檔 | 逐節點打 API 更新任務，會蓋掉規劃頁設好的問卷與審查旗標 | 只存一次 XML，增刪由後端比對決定；不再覆蓋任何任務資料 |
| 存檔被擋下時的訊息 | 一句籠統的話，圖上十幾個方塊不知道要改哪個 | 指出是哪個方塊（四支碼都併陳後端明細） |
| 平行分支上的任務狀態 | 第二筆以後全部排隊 TODO（畫面像「有三個任務但只能做一個」） |
平行分支上的任務全部是進行中 |
| 「兩條平行 → 合流 → 主管覆核」 | 完成第一條，覆核任務就提早跳成進行中 | 兩條都結束才啟動覆核任務 |
| 退回任務 | 下一批第 1 筆已完成也照樣放行（使用者做過的事無聲消失） | 下一批沒有任何一筆已完成才可退 |
| 「任務設定」進度卡 | 以 AO 為單位，新增空任務分母不動 | 以任務為單位；三張卡皆可點開未設定清單並跳到該項 |
| AO「已配置」綠勾 | 任一筆有指派人就算（空任務被掩蓋） | 每一筆都有指派人才算；未配置標籤帶筆數 |
| 規劃頁任務排序 | 看 DB 回傳，平行新增多筆後順序會跳 | 依建立時間固定 |
| 文件 | 更新內容 |
|---|---|
docs/spec-site/current/project-management/project-planning.md |
hub 頁：功能總覽補新增／刪除任務、§4 加兩道 gate、§5 補 Master-Detail 版面與麵包屑、§6.2 補 endpoint 與「名稱取圖上其餘取 DB」、§7 檔案地圖、§10 進度卡改任務單位＋未設定清單、§12 加三條坑 |
docs/spec-site/current/project-management/project-task-edit.md |
子頁（本案主要落點）：§1 真相分工、§3 兩道新守門、§4 兩道 gate、§5 新增三節（Master-Detail 版面／新增與刪除任務／三向 diff／編輯器能力範圍）、§6.2 補三支 endpoint、§7/§8 檔案地圖、§11 合流等待與雙寫、§12 加六條坑 |
docs/spec-site/current/compliance-framework/flow-template-manage.md |
§12 坑 1：補記 workflow-setup 編輯器已降為純走向工具（該頁無獨立 spec，順帶記在這裡） |
docs/user-manual/lifecycle-and-use-cases.md（＋ spec-site 同名副本） |
§3.5 補「一個 AO 可多任務、全部做完才算過」；Phase 1 新增兩節操作段：新增與刪除工作任務、流程圖編輯器只用來調整先後順序 |
docs/features/README.md |
FR-112 那列狀態更新 |
docs/features/FR-112-.../README.md |
新建（結論／總進度表／需求討論紀錄三段） |
docs/claude/memory/ |
同步兩支新 memory（Bifrost 磁碟滿、FE 先查 PrimeVue） |
驗證：mkdocs build --strict 通過、fix_anchor_ids.py 無新增錨點、禁用句型 grep（原本｜改判｜第 N 棒｜整理後｜這次整理｜當初｜收斂前）在本次新增內容中 0 命中。
| # | 事 | 狀態 |
|---|---|---|
| 1 | jedi-flow-engine 發版 1.1.2 → 1.2.0（後續 arc-review 又再發到 1.3.0） | ✅ 已發版 |
| 2 | BE 還原 pin 並一起 commit | ✅ 已完成 |
| 3 | 主 checkout 的 .venv 還原 |
✅ 已完成 |
| 4 | arc-review ＋ merge 回 feature/review |
✅ 已完成，見 §10 |
| 項目 | 為什麼會長出來 |
|---|---|
| 編輯器 UI 優化／屬性面板擴充 | 決策者原話「目前的 UI 設計不是很好用，之後再來優化」——本案先收到只剩名稱以止住第二份真相 |
| 稽核中補任務 | D1 把新增限制在規劃期，但「稽核到一半發現漏了一項」確實會發生；牽涉補件流程與報表口徑 |
| 多任務流程範本 | _first_user_task_id() 只抓第一個 userTask，範本做成多任務會靜默漏建 |
| 覆核輪對多任務查核項目的任務生成 | 覆核輪 re-clone 第一輪範本後重跑生成，只認第一個方塊——AO 可多任務後會出現「圖上三個方塊、資料庫一筆任務」且無錯誤訊息（arc-review I5「合流等待在分支任務沒被建出來時永久卡住」與此同源，優先度建議拉高，仍留延伸、未開案） |
另 design §8 列有「圖上舊 camunda 屬性清理」，狀態為不排程（風險大於收益）。
| 測試 | 狀況 |
|---|---|
BE test/test_error_code_mirror_parity.py |
✅ 已修：jedi-compliance-audit 補齊碼表 12 個成員並發版 1.1.3，兩邊 242 對 242 零漂移 |
套件 test_verify_workflow_executions_exist_by_uid_not_exists |
✅ 已修：斷言改成正確的 ConflictError |
8e17b7bd 只修寫入路徑，決策者裁示不補舊資料。這些專案開編輯器仍會被三向 diff 擋下。we 12443 的 job 12705/12754、we 12445 的 12707/12752）——舊版編輯器留下的，存檔會被 GRC_400127 擋下，要由人決定留哪一筆。刻意不自動選。| 項目 | 狀況 |
|---|---|
| DB migration | 無。本案不動 schema，也沒有 seed |
| 套件 | 🔴 要發版：jedi-flow-engine 1.1.2 → 1.2.0（見 §6.1）。BE 沒有這支新版就跑不起來——三支拓樸函式與 FLOW_ENGINE_412003 都在套件裡 |
| 環境 | 全程只動 DEV；STG / POC 一律未動（開發期鐵律）。上版順序照常：DEV 驗收 → 決策者放行 → STG → POC |
| 出貨基線 | 不受影響（無 migration） |
| FE | 純前端改動，隨常規 build 走；新增 i18n key 在 zh-tw / en 兩語系（zh-cn 該檔只維護 6 個檔，照既有慣例不另建） |
| 設定 / 環境變數 | 無新增 |
e2e 已覆蓋上述多數情境（planning-task-parallel.feature，12 條）。
| 你想知道 | 看哪份 |
|---|---|
| 為什麼這樣決定、被排除了什麼 | design.md（D1–D7 全文） |
| 完整的選項推演與業界對照 | discussion.md |
| 做完之後頁面長什麼樣、欄位與 API | SPEC docs/spec-site/current/project-management/project-task-edit.md |
| 使用者怎麼操作 | docs/user-manual/lifecycle-and-use-cases.md Phase 1 |
| 每一棒做了什麼、踩了什麼坑 | 各 Notion 子卡（CM-1954～1976、CM-1977～1980）與四 repo 的 commit message |
母卡 CM-1952 收尾隔天，依 §6.1 排程跑了 arc-review（CM-1977），找出問題後開三張修正卡（CM-1978／1979／1980）全部修完、Done，再發套件版、merge push 三 repo。
4 個 Critical、6 個 Important，共同病因是「同一件事有兩個入口，只改了一邊」：
| # | 問題 | 根因 |
|---|---|---|
| C1 | 編輯器拖新方塊建的任務會排隊，規劃頁做就不會 | 規劃頁那條已改用拓樸判定，編輯器那條還在用舊判準——兩支平行改動互不知情，一支比另一支早 6 分鐘 commit，「屆時一起改」的註解永遠等不到 |
| C2 | 編輯器刪方塊不會歸檔 Google Drive 資料夾 | design §5.4 要求接上，編輯器那條路徑整支沒接 Drive 呼叫 |
| C3 | 「二選一→兩邊各接一件事→合流」流程會永久卡死，後台查不到 | 套件 bpmn_topology.py 合流判定漏掉二選一分支下再接任務的情境 |
| C4 | 一次刪兩個方塊加一個新的，被系統自己擋下 | 上層總帳算對（2-2+1=1），但執行順序是先刪後建，刪到一半總筆數歸零，底層防呆誤判整批擋下 |
Important 六項含權限判準不一致（I1）、輪次凍結反查查不到時 fail-open（I2）、任務名稱讀取方向與 §5.1 相反（I4）等，詳見 CM-1977 全文。決策者當場裁示四項待決：①編輯器刪任務不必是專案 manager身分（接受）②輪次凍結反查不到維持放行（接受）③任務名稱真相方向另開卡（不在本輪）④這輪要再發一次 jedi-flow-engine 版本（是，用來拆超標的套件檔）。
| 卡 | 修了什麼 | commit |
|---|---|---|
| CM-1978 | C1／C2／C4／M1（重複雙寫邏輯收成一份）。C1 改吃拓樸判定並確認餵的是新圖非舊圖；C2 補上 Drive 歸檔呼叫；C4 改成「先建、再寫圖、最後刪」並修掉過程中發現的 ORM 快取讀舊圖問題；同時把用假物件繞過真正檢查的既有測試改成打真實路徑。194 條測試全綠，四項修法各自做過突變驗證（拿掉修法確認測試真的變紅）。design.md §5.4／§5.8 補上決策者裁示 | 6769cfdf |
| CM-1979 | C3（套件 bpmn_topology.py 合流判定）＋ arc-review 建議的拆檔：把套件 bpmn_uilts.py 從 1,213 行拆成 bpmn_uilts.py（534，讀圖）／bpmn_mutation.py（496，改圖，新增）／bpmn_di.py（148，畫座標，新增）／bpmn_nodes.py（89，最底層節點操作，新增），比原訂多切一支是為了避免改圖與畫座標互相 import 造成循環相依。順手補齊碼表鏡像 12 個成員（test_error_code_mirror_parity 轉綠）、修掉一支既有紅測試斷言。發版 jedi-flow-engine 1.2.0→1.3.0、jedi-compliance-audit 1.1.2→1.1.3，BE pin 已更新（poetry update 指名兩支套件） |
pkg c86952b／dfe260a，BE 67951f70 |
| CM-1980 | 卡住任務的人工出口——新增 GET .../job/<job_uid>/blocked-status 與 POST .../force-start 兩支端點（manager-only），判定共用套件拓樸函式與畫面診斷同一支邏輯，守門用 project_uid 直接走 assert_project_manager（反查鏈只覆蓋約 11% 流程，不可用）。新增稽核事件碼 JOB_FORCE_STARTED=6150。FE 兩處（規劃頁任務表單、抽屜）都加警示與按鈕，兩檔皆淨減行數。23 條新測試 + 既有 109 條全過，三道突變驗證全變紅 |
BE 525989b7，FE d2d2599 |
八支套件（含本輪與此前 arc 累積的 pin bump）已發版、BE/FE pin 已對齊，三 repo（BE／FE／jedi-python-package）已 merge 回 feature/review 並 push。bpmn_uilts.py 已從 docs/claude/oversized-files.md 超標清單劃掉（1,213→534）。
ssp_control_implementation_service.py:512 圖優先、DB fallback，與 §5.1「DB 是真相」方向相反）——決策者裁另開卡，本輪未動。