專案流程與流程引擎整合

狀態：✅ v1.0 shipped (2026-05-15) 建立日期：2026-05-12 對應原始需求：docs/draft_requirement_spec/project-flow-engine-integrate/requirement.md

📋 最終 spec 看這份：FINAL-SPEC-v1.0.md（對外溝通 single source of truth） 🛠 部署 SQL：scripts/sql/2026-05-15-bpmn-integration-v1.0-upgrade.sql（單一入口，idempotent）

以下保留原 brainstorm 紀錄，供「為什麼這樣設計」溯源。實際 v1.0 落地內容請以上方 FINAL-SPEC 為準。

---

目前 AP（稽核計畫）執行流程寫死成 6 個固定階段（規劃 → 執行 → 稽核 → 缺失改善 → 結案 + 再開新 AP），無法跳過 / 中斷 / 自訂。

本案要把 AP lifecycle 用 BPMN 流程引擎驅動，讓使用者依稽核情境組合不同流程：

---

---

Spec 1（流程管理）
  ↓ 提供「階段物件 registry」+「範本格式」
Spec 2（階段抽象整合）
  ↓ 提供「Stage 推進機制」+「AP↔workflow_execution 關聯」
Spec 3（AP 套用流程）
  ↓ 提供「建 AP 選範本 + Overview 殼層整合」

每份 Spec 可獨立交付驗證

• Spec 1 完成：admin 可建範本，但還沒地方套用
• Spec 2 完成：手動把 AP 綁 default 範本，5 個 view 可用 Banner 推進
• Spec 3 完成：建 AP 時選範本 → 完整流程跑通

不同 session 接手可從任一 spec 起手

依賴介面已於各 spec 文件「對外介面」段明確標示。

---

以下問題不在單一 spec 內，需先有方向再下放：

• AP 建立完成預設停在哪個階段 → Spec 2 §9.5 採 planning UserTask（AP.status=preparing），workflow 同步啟動
• 缺失改善 → 稽核 loop back 設計 → Spec 2 §9.4 v1 簡化版直接結案；PM Dialog 二擇一留 Spec 3+
• launch_new_round 時範本預設值 → Spec 2 §9.6 採專案層級 default（建專案時選）；Spec 2 內 hardcode builtin-full-audit
• 第一輪 AP 範本選擇放兩處 vs 一處 — 目前方向：ProjectCreateView + ProjectApListView Dialog 兩處都加；若改成「只在 ProjectApListView 一處選」（專案建完後 user 自己建第一輪），spec 3 範圍會大幅簡化（→ Spec 3 再決）

v2 已 resolved（不再列為開放問題）：觀察者角色內頁權限（沿用既有 v-if）、執行任務推進條件（PM 手動按 + force=false 既有邏輯）、多 AP 流程獨立性（snapshot clone 自然成立）

---

---

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

設計

01-flow-template-management/（3 份）

設計

實作與測試

02-stage-integration/（6 份）

設計

實作與測試

其他文件

03-ap-binding/（7 份）

設計

實作與測試

其他文件

04-review-stage-and-flow-validation/（5 份）

設計

實作與測試

其他文件

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

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