資源庫任務說明

雛形審過、D1～D5 裁完後寫 design.md，本稿不再改寫。

狀態：討論稿（方向與 D1～D4、D6 已裁，雛形審過；D5 撤銷）　｜　日期：2026-10-17　｜　雛形：prototype/index.html　｜　前作：FR-139 收口時釐清三條（只給顧問名稱／描述／指南、任務不進版本、Excel 加兩欄兩邊共用）

路徑慣例：BE 路徑相對 compliance-manager-be/；FE 路徑相對 compliance-manager-fe/；pkg/ 代表 ~/Projects/Jedicogy/module/jedi-python-package/<套件>/。

名詞：資源庫＝合規資源庫（compliance.module_frames），顧問做的範本，一本資源庫只給一個專案用（FR-139 起）；AO＝評估目標，每條控制項底下的檢查項目；流程圖＝每條 AO 配一張 BPMN 圖（workflow_templates），圖上一個方塊（userTask）就是一個任務；任務＝compliance.job_executions 一列，專案啟動時從流程圖長出來，有 name／description／guide 三欄；輪次＝專案的第 1 輪與各覆核輪，每輪自己一批任務。

整案一句話：資源庫頁每條 AO 底下列出任務，顧問替每個任務填名稱、描述、指南；啟動前每條 AO 固定一個預設任務、三欄存在範本流程圖的方塊上，顧問不改流程；啟動後直接寫專案任務、PM 改過流程就看到多個；一份 Excel 一列一任務、AO 欄合併，資源庫與專案兩邊共用。

依賴：1 審過 → design.md 開 2、3、4 的卡 → 2、3、4 三棒碰的檔不同可平行；3 的「寫圖」與 2 的「讀圖帶三欄」要用同一支方塊屬性 helper，先由 2 建好。不動 jedi 套件、不開新表、不套 migration。

%%{init: {'theme':'base','themeVariables':{'primaryColor':'#E2F0F1','primaryTextColor':'#14201F','primaryBorderColor':'#0E7C86','secondaryColor':'#EEF2F3','secondaryTextColor':'#14201F','tertiaryColor':'#FBFCFC','tertiaryTextColor':'#14201F','lineColor':'#4A5A5C','textColor':'#14201F','mainBkg':'#E2F0F1','nodeBorder':'#0E7C86','nodeTextColor':'#14201F','edgeLabelBackground':'#FBFCFC','titleColor':'#14201F','clusterBkg':'#FBFCFC','clusterBorder':'#E4EAEB','actorBkg':'#E2F0F1','actorTextColor':'#14201F','actorBorder':'#0E7C86','actorLineColor':'#C7D1D2','signalColor':'#4A5A5C','signalTextColor':'#14201F','labelBoxBkgColor':'#EEF2F3','labelBoxBorderColor':'#C7D1D2','labelTextColor':'#14201F','loopTextColor':'#14201F','noteBkgColor':'#F6EBD5','noteTextColor':'#14201F','noteBorderColor':'#9C6B12','activationBkgColor':'#EEF2F3','activationBorderColor':'#C7D1D2','sequenceNumberColor':'#FFFFFF'}}}%%
flowchart LR
    P[棒 1 雛形] --> R{決策者審＋裁 D1～D5}
    R --> D[design.md<br/>開 2、3、4 的卡]
    D --> B2[棒 2 啟動與覆核輪<br/>三欄帶進任務]
    D --> B3[棒 3 資源庫頁任務說明<br/>讀圖／讀任務、收流程入口]
    D --> B4[棒 4 Excel 兩邊共用<br/>AO 合併、加兩欄]
    B2 -.方塊屬性 helper.-> B3

決策者原話（2026-10-17）

• 要能讓顧問在合規資源庫這邊直接編輯任務的任務名稱、描述、指南。之前討論過但還沒做，卡在資源庫階段是沒有任務的。
• 任務會被 PM 異動流程。原本預設一個 AO 對一個任務；PM 啟動專案後改流程，例如變成「證據上傳 → 主管審核 → 顧問審核」，一個 AO 就三個任務。
• 情境：顧問先跟 PM 討論出基本版，公司內部定義了專案任務執行流程後，AO 逐一設定任務流程、產出不同任務；這時顧問在資源庫也要能對每個任務下名稱、描述、指南，讓使用者參考要怎麼做。
• Excel 要可以一 AO 對多行任務，參考改善計畫那邊前面合併儲存格的方式；每次匯出都要依照當時的現況。

裁示（2026-10-17，首腦複述後決策者點頭）

1. 資源庫頁啟動後看專案現況任務，不是永遠只看範本圖。
2. 顧問在資源庫頁只改三欄文字；流程本身由 PM 在專案規劃頁處理，或線下討論後由系統設定。
3. Excel 一份格式兩邊共用：專案規劃頁既有的任務配置匯出留著，資源庫頁新加同樣格式的匯出匯入，只差識別欄。
4. 顧問不改流程（審雛形後追加）：資源庫階段每條 AO 固定一個範本預設任務，顧問只填那個任務的三欄；資源庫頁的流程編輯器入口收掉。決策者原話「我現在不想讓顧問有這麼大權限」。流程一律啟動後由 PM 在專案規劃頁改。

新畫面長什麼樣（對照雛形畫面 1、2）

• 資源庫「控制項與評估目標」頁，每條 AO 展開後在既有欄位（實作狀態、缺失、建議附件、參考程序書）之後多一段「任務說明」：啟動前固定一張小卡（範本預設任務）：名稱一行、描述與指南各一格。已啟動時列專案現況任務，PM 改過流程就多張小卡，右上角多任務狀態與指派人（唯讀），上方一條小流程帶顯示先後。
• 每條 AO 右邊既有的「流程編輯器」按鈕拿掉（D6）。
• 頁首多「匯出任務說明」「匯入任務說明」兩顆鈕；匯入有預覽，只標出有變更的格。
• 左樹每條控制項右邊顯示「已填說明／任務數」。

① 任務怎麼長出來

DEV 資料：有任務的 AO 59,942 條是一個任務、80 條是多任務（最多 3 個）；65,037 筆任務只有 9 筆填了指南、11 筆填了描述。

② 三欄位在哪

③ 資源庫頁與專案的關係

④ Excel

資料落點（一句話）

啟動前每條 AO 固定一個範本預設任務，三欄住在那張流程圖的方塊上（名稱＝方塊名稱，描述與指南＝方塊的兩個 camunda 屬性）；啟動後三欄住在專案任務列上，與規劃頁同一份。沒有第三個地方。

端到端

%%{init: {'theme':'base','themeVariables':{'primaryColor':'#E2F0F1','primaryTextColor':'#14201F','primaryBorderColor':'#0E7C86','secondaryColor':'#EEF2F3','secondaryTextColor':'#14201F','tertiaryColor':'#FBFCFC','tertiaryTextColor':'#14201F','lineColor':'#4A5A5C','textColor':'#14201F','mainBkg':'#E2F0F1','nodeBorder':'#0E7C86','nodeTextColor':'#14201F','edgeLabelBackground':'#FBFCFC','titleColor':'#14201F','clusterBkg':'#FBFCFC','clusterBorder':'#E4EAEB','actorBkg':'#E2F0F1','actorTextColor':'#14201F','actorBorder':'#0E7C86','actorLineColor':'#C7D1D2','signalColor':'#4A5A5C','signalTextColor':'#14201F','labelBoxBkgColor':'#EEF2F3','labelBoxBorderColor':'#C7D1D2','labelTextColor':'#14201F','loopTextColor':'#14201F','noteBkgColor':'#F6EBD5','noteTextColor':'#14201F','noteBorderColor':'#9C6B12','activationBkgColor':'#EEF2F3','activationBorderColor':'#C7D1D2','sequenceNumberColor':'#FFFFFF'}}}%%
flowchart TB
    subgraph 啟動前
      L[資源庫頁 AO 任務說明<br/>顧問填三欄] -->|寫方塊名稱＋兩個屬性| G[AO 流程圖<br/>workflow_templates.xml]
      X1[資源庫 Excel 匯入] --> G
      G --> X2[資源庫 Excel 匯出]
    end
    G -->|專案啟動：每個方塊各建一筆<br/>三欄帶進任務列| J[專案任務<br/>job_executions]
    subgraph 啟動後
      J --> L2[資源庫頁 AO 任務說明<br/>改三欄直接寫任務]
      J --> P[專案規劃頁任務表單<br/>PM 改流程、改全部欄位]
      J --> X3[專案與資源庫 Excel<br/>同一份格式]
      J -->|覆核輪：新舊任務配對抄三欄| J2[覆核輪任務]
    end

讀寫規則

• 資源庫頁讀：資源庫沒綁過專案 → 解析每條 AO 的圖取那一個方塊，三欄從方塊取（圖上若有多個方塊只列第一個，與啟動行為一致）；綁了專案 → 讀該專案目前輪次的任務列（wecm 按 round_id，與任務配置匯出同一條查法）。回傳形狀一樣，前端不分。
• 資源庫頁寫：啟動前改圖（只改方塊名稱與兩個屬性，不動線、不增刪方塊；走倉儲雙寫主表與翻譯列，與任務產生那支同一個坑）；啟動後走一支只開三欄的更新，守「資源庫可寫」與稽核鎖，不要求專案 manager。
• 啟動：任務產生維持只認第一個方塊，但 name／description／guide 改從方塊帶（名稱沒填時退回現在的「控制碼 / AO 收證據」）。
• 覆核輪：三欄改從上一輪配對到的任務列抄，不再寫死「收證據」。
• Excel：匯出讀當下來源（圖或任務列），一列一任務、AO 前幾欄合併、順序欄、三欄黃底；匯入只寫三欄，識別欄啟動前「AO 編號｜方塊編號」、啟動後任務編號；專案規劃頁既有匯出匯入加同兩欄、改合併。

不做

• 任務不進資源庫版本（FR-139 收口已裁）。
• 顧問在資源庫頁不改流程、不增刪任務、不改指派與期限；資源庫頁流程編輯器入口收掉（D6）。
• PM 在專案規劃頁改方塊名稱與任務列名稱的關係維持現況（兩邊各自、不同步），與本案無關（原 D5，撤銷）。
• 啟動時「整張圖每個方塊都長任務」不做：D6 後資源庫圖永遠一個方塊，現況「只認第一個」就夠；資源庫編輯器既有的多方塊圖（若有）啟動行為不變。
• 既有「一資源庫多專案」舊資料：資源庫頁遇到多個專案退回只讀圖、三欄可填但只影響未來（實際上 FR-139 後不會再有新的）。
• 任務型別、週期、工具參數不進 Excel 三欄之外的範圍。

2026-10-17 決策者審雛形後全照建議裁定；D5 撤銷。

design.md 定案後一次建完。三棒可平行；棒 2 先建方塊屬性 helper 給棒 3 共用。