FR-112 · 需求索引 · 本頁由 build 掃資料夾生成

FR-112 規劃頁新增任務與平行流程

🟢 完成並 push（2026-09-20，24 卡 Done）。跨四 repo；arc-review 找出 4 Critical／6 Important 已全數修完，八支套件已發版，三 repo 已 merge push。無 DB migration

狀態：詳見下方文件 3 份 handoff 1 份

FR-112 一頁看完

§1

🔴 先看哪一份

你想知道	看這份	這份的性質
做完了什麼、明天還要做什麼	收尾 SUMMARY	收口彙整，含行為前後對照與 follow-up
為什麼這樣決定、被排除了什麼	設計 design.html	設計決策，寫完凍結
完整的選項推演與業界對照	討論稿 discussion.html	討論過程，寫完凍結
做完之後頁面長什麼樣、欄位與 API	SPEC `docs/spec-site/current/project-management/project-task-edit.md`	living truth，持續更新
使用者怎麼操作	`docs/user-manual/lifecycle-and-use-cases.md` Phase 1	使用手冊

§2

結論

任務的新增與刪除回到專案規劃頁：按「新增任務」、填名稱、存檔就好，後端自己在流程圖上補方塊與接線。PM 不必再學拖流程圖。
新任務預設平行——誰先做都行，該查核項目要全部任務做完才算通過。已排成一條龍的圖不會被重排，新任務掛成合流前的一條新分支。
一件事只有一個地方說了算：任務資料全在資料庫，流程圖只存「誰先誰後」與「這個方塊是哪一筆任務」。圖上其餘欄位不再寫也不再讀（舊的不清、讀時忽略）。流程圖編輯器因此降為純走向工具，屬性面板只剩名稱。
刪除兩個入口語意完全一致：規劃頁按刪除、編輯器刪方塊存檔，都會真的刪掉任務與五張關聯表。但每個查核項目至少保留一筆（零任務會讓它變成「開始→結束」、無人經手即通過），且只在規劃期開放（稽核開跑後改任務清單＝改變已在跑的稽核範圍）。
順手修了一個既有引擎缺口：合流閘道不等兄弟分支就放行——完成第一條平行分支，合流後面的任務立刻跳成進行中。同一份寫法有兩個副本，兩處都修。現況每個查核項目只有一個任務所以沒人踩到，本案讓平行變成預設樣貌就會浮現。
像但不做：一律重排成標準平行（會擅自推翻使用者排的順序）、編輯器刪節點改標「已取消」（同一動作在不同頁面產生不同結果）、寫 migration 清掉圖上舊屬性（改壞沒有回頭路，而留著不造成行為差異）。

§3

📊 總進度（2026-09-19：20 卡全部 Done，進收口）

棒	Notion 卡	做什麼	狀態
D-4.1	CM-1970	開工前查證：輪次圖與查核項目圖是否共用	✅ Done（不共用，可開工）
A-1.1	CM-1954	套件：新任務掛成平行分支（三種圖形一支函式）	✅ Done
A-1.2	CM-1955	套件：刪節點擴充（收退化閘道、擋刪到零）	✅ Done
A-1.3	CM-1956	套件：拓樸判定函式（分叉／合流分辨、兄弟分支）	✅ Done
B-2.1	CM-1958	BE：新增任務端點不必帶節點編號	✅ Done
B-2.2	CM-1959	BE：刪除任務升為主路徑、至少保留一筆	✅ Done
B-2.3	CM-1960	BE：流程圖存檔三向 diff	✅ Done
B-2.4	CM-1961	BE：圖寫入收斂成只寫 name	✅ Done
B-2.5	CM-1962	BE：初始狀態與可否退回改依拓樸	✅ Done
B-2.6	CM-1963	BE：新增／刪除接規劃期守門	✅ Done
B-2.7	CM-1964	BE：🔴 合流閘道等待修正兩落點	✅ Done
B-2.8	CM-1965	BE：子需求 B 收尾＋reviewer 掃描	✅ Done
B-2.9	CM-1976	BE：建案寫範本改走雙寫（＋FE 兩項配套）	✅ Done
C-3.1	CM-1967	FE：規劃頁補新增／刪除按鈕	✅ Done
C-3.2	CM-1968	FE：編輯器屬性面板瘦身	✅ Done
C-3.3	CM-1969	FE：編輯器存檔瘦身	✅ Done
C-3.4	CM-1973	FE：統計卡可點開未設定清單	✅ Done
C-3.5	CM-1974	FE：任務區塊改 Master-Detail	✅ Done
C-3.6	CM-1975	FE：規劃頁風格統一	✅ Done
D-4.2	CM-1971	端到端手測清單實跑	✅ Done
D-4.3	CM-1972	e2e 回歸與新情境（12 條）	✅ Done
E-5.1	CM-1977	arc-review（4 Critical／6 Important）	✅ Done
E-5.2	CM-1978	修 C1／C2／C4／M1（BE 編輯器四處）	✅ Done
E-5.3	CM-1979	修 C3（套件合流判定）＋拆套件超標檔＋發版	✅ Done
E-5.4	CM-1980	卡住任務人工出口「強制開始」端點	✅ Done

數字：四 repo 共 40+ commits（BE 17／FE 21／套件 5／test 2）｜新增 error code 8 支｜新增稽核事件碼 JOB_FORCE_STARTED=6150｜e2e 新情境 12 條、既有回歸由紅 23 修到 0｜ProjectPlanningView.vue 3,682 → 2,749 行｜套件 bpmn_uilts.py 1,213 → 534 行（已脫離超標）｜無 DB migration。

收尾：arc-review（CM-1977）找出 4 Critical／6 Important，共同病因是「同一件事兩個入口只改一邊」，三張修正卡全數修完並實跑驗證，八支套件已發版、三 repo（BE／FE／套件）已 merge push 回 feature/review。詳見收尾 SUMMARY §10 與 review 報告。

§4

需求討論紀錄

2026-09-19 決策者：D1–D6 依討論稿建議案拍板；D4 另行指示「回歸最簡單就好，不想讓編輯器做太複雜的編輯，目前的 UI 設計不是很好用，之後再來優化」——屬性面板鎖到只剩名稱，UI 優化列延伸項。
2026-09-19 決策者：追加 D7「刪除任務兩入口對稱」，並據此改寫 D6 ②——XML 少了任務編號視為刪除意圖而非孤兒，存檔端點改為三向 diff。
2026-09-19 決策者：D6 ① 再改為至少保留一個任務（原判可零任務）。理由：零任務會讓查核項目變成「開始→結束」、無人經手即通過，稽核上站不住腳；「這項不需要做」應由專案範圍表達。
2026-09-19 決策者：B-2.3 驗收時發現 DEV 有「一節點對兩筆任務」的舊資料，裁示擋下並提示、不自動選一筆靜默刪（哪一筆有證據要由人決定）。
2026-09-19 決策者：覆核輪 re-clone 多任務範本只建第一筆這個缺口，裁留延伸 FR、不擴本案，本案只在程式旁標註陷阱。
2026-09-19 決策者（手測後）：同一查核項目多筆任務時，每筆一個展開面板往下堆「四筆全展開要捲好幾屏」，裁示改成 Master-Detail（左清單右表單；再依手測調為上籤列下表單）。
2026-09-19 決策者：「請你用 PrimeVue TabView 套件，已經有的東西就不要再造輪子」——runner 自刻的籤列改用 PrimeVue TabView。已固化為 memory feedback_fe_use_primevue_before_handrolling。
2026-09-19 決策者（手測後）：「任務設定」統計改以任務為單位（與「證據蒐集」分母一致）；AO「未配置」標籤要帶筆數；任務清單要有固定排序。
2026-09-19 決策者：8e17b7bd 的建案雙寫修正只改寫入路徑、不補舊資料——修正前建立的專案開編輯器仍會被擋，屬已知。

§5

與其他需求的關係

FR-038：任務與 BPMN 節點對應的地基（template_job_id ↔︎ job_execution_uid）。
FR-048：專案角色守門的 canonical（本案新增的兩道守門沿用既有判定，不另立第五套）。
FR-069：四張綁定表的外鍵從 CASCADE 改為軟參照——刪除的清理責任因此落在程式裡，這是「兩個入口必須共用同一支刪除邏輯」的硬理由。
FR-110：凍結時「按鈕停用＋留住提示」的既有做法，本案沿用。

§6

文件

以下全部由 build 掃資料夾產生，新增檔案重 build 即自動出現。標題連結指向渲染後的 HTML，md 連向源檔。

需求與討論

文件	類型	標題	最後更新
discussion ／ md	需求討論稿	任務在規劃頁上開，流程圖只管先後順序	2026-09-19

設計

文件	類型	標題	最後更新
design ／ md	設計	任務在規劃頁上開，流程圖只管先後順序 — 設計定案	2026-09-20

其他文件

文件	類型	標題	最後更新
mockup-task-section	文件（手刻 HTML）	規劃頁整頁 Mockup	2026-09-19

交接與收口時間軸（handoff/，1 份）

由新到舊。每份是某一棒次交接當下的完整現況快照，看某個時間點「當時知道什麼」請從這裡進。

日期	文件	標題
2026-09-20	2026-09-19-FR-112-SUMMARY ／ md	任務在規劃頁上開、流程圖只管順序 — 實作完成

§7

關聯

相關需求：