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

FR-141 稽核計畫重做

✅ 已實作、決策者驗收(2026-10-16),母卡 CM-2799 與子卡 Done;套件未發版、主專案未進版

狀態:✅ 已完成 文件 5 份 handoff 2 份

FR-141 一頁看完

§1

🔴 先看哪一份

你想知道 看這份 這份的性質
現在的頁面怎麼運作(工程師) SPEC 手冊〈稽核計畫填寫頁〉docs/spec-site/current/audit-execution/ap-authoring.md 現況規格
怎麼操作(顧問、稽核人員) 使用手冊〈稽核計畫使用指南〉docs/user-manual/audit-plan-guide.md 操作步驟
定案規格與實作後改判 設計 design.md(「實作後改判」節與內文衝突時以該節為準) 設計決策
收口還剩什麼 STATE 交接用,就地更新
畫面雛形 雛形索引(範例 Excel 在 prototype/sample/) 假資料畫面,欄位以 SPEC 為準
討論過程 討論稿 discussion.md 設計階段紀錄
§2

結論

  1. 稽核計畫頁兩個頁籤:「計畫概要」放稽核計畫書表頭(依據、目的、稽核單位、稽核日期起迄、稽核範圍、稽核方法論)與稽核人員;「查核項目規劃」左樹右表單,逐條評估目標(AO)填查核方法與指引(不限組數)、受評人員(可當場新增,存本計畫名單)、受評元件/資產、稽核人員(預帶計畫概要名單,可覆寫)。系統只存逐條評估目標,沒有控制項層。
  2. 一份 Excel 匯出即匯入範本:四頁(填寫說明、計畫概要、查核項目規劃、可選清單);一格多值——方法與指引一行一組「方法:指引」,人員與元件用換行、分號或頓號隔開,全形半形都吃;隱藏欄放 AO part_id 當比對鍵。匯回在原畫面預覽,變更處橘底並顯示原值;對不到的受評人員與稽核人員預設新增,元件/資產與查核方法要手動對應或略過。
  3. 匯出三選一:稽核計畫書(亞航格式 Word/PDF,附件表「受評對象」「稽核人員」可不印)、稽核計畫工作表(Excel)、打包 zip。
  4. 內外稽核不混:FR-140 之後每一次稽核各自一份計畫,頁首麵包屑帶「第 N 次 內部/外部」,可切同輪已結束的那次唯讀看。
  5. 第 2 次內稽與覆核輪:上一次「不合格」與「沒判定」的評估目標所屬整條控制項帶過去,只有明確「合格」才不帶;帶過去的內容一起承襲,標「承襲自第 N 次」。
  6. 像但不做:AR 畫面改逐 AO(另案 FR-142)、AP 的 OSCAL JSON 匯出、docx 匯入擴充其他格式、控制項層設定。
§3

📊 總進度

卡 做什麼 依賴 狀態
CM-2800 雛形(三輪) — ✅
— 討論稿、design.md — ✅
CM-2802 A1 計畫概要存得起來(新表+API) — ✅
CM-2803 A2 新頁殼+計畫概要頁籤+稽核次麵包屑 A1 ✅
CM-2804 A3 稽核計畫書 docx/pdf 匯出 A1 ✅
CM-2805 A4 docx 匯入改寫進計畫概要 A1 ✅
CM-2810 A5 docx 匯入不碰行程與評估目標 A4、B1 ✅
CM-2806 B1 AP 改逐條評估目標存+API+AR 讀取 — ✅
CM-2807 B2 查核項目規劃頁籤+刪舊頁 B1、A2 ✅
CM-2808 B3 Excel 匯出匯入+同畫面預覽 B1、B2 ✅
CM-2814 B5 受評人員當場新增(存本計畫名單) B1、B2、B3 ✅
CM-2809 B4 縮範圍含未判定+複製帶資料+「檢視/現場觀察」 B1 ✅
CM-2835 收尾文件(SPEC、使用手冊、README、需求站) 全部 🟡 修正待驗證
§4

收口後仍待辦

決策者 2026-10-16 裁示只 push、不發套件、不進版;以下等 FR-140 收口後一起做:

  1. 四支套件同批發版(jedi-compliance-audit、jedi-flow-engine、jedi-task-platform、jedi-oscal-v2),主專案四支一起還原 pin。是其他各項的前提。
  2. 主專案進版:release note、BE/FE 版號、SPEC 快照、重生 99-stamp——等套件發版、pin 還原後。
  3. 出貨基線重產:A1 主線 migration 2026-10-16-fr141-ap-terms-and-conditions.sql。
  4. 小收尾(不影響功能):ap_overview_app_service.py、assessment_plan_app_service.py 直接 PartyRepoImpl() 未經 DI;套件兩處提到已刪 set_tasks/_backfill_scope_from_tasks 的過期註解;list_ap_parties 不分角色,docx 匯入比對稽核單位改只比 organization。
  5. e2e 另開一棒;ddd-compliance-reviewer 掃整個 FR-141 diff;碰到的超標檔至少拆一支。
§5

需求討論紀錄

  • 2026-10-15 決策者:稽核計畫要多報告稿 1~6 段的文字表單、時間用範圍、存後可匯出 docx/pdf;看 OSCAL 有沒有欄位放。
  • 2026-10-15 決策者:現有頁很難填、只能 by 控制項,改 by AO;要 Excel 匯出匯入;每項加查核方法與指引、受評對象、稽核人員,都可多筆;人員與元件要分開。
  • 2026-10-15 決策者:場次就是 docx 那份;詳細在 Excel 由顧問 by AO 填;AR 後續也會改;畫面不用舊的;場次與 AO 分兩個 Tab;先出雛形。
  • 2026-10-15 決策者:一份 Excel 兩個 sheet,不分兩種匯入;匯出可選文件稿或 Excel 完整資料,也可打包。
  • 2026-10-15 決策者:裁 D1~D4——稽核人員場次預設、AO 可覆寫;受評對象拆人員與元件/資產兩欄;未知方法預覽對應。
  • 2026-10-15 決策者:看第一版雛形後——AO 改成 SSP 那種左樹導航、預覽找更好方式、問內外稽核會不會混;首腦答各自一份 AP、分進入點不分內容。
  • 2026-10-16 決策者:看第二輪雛形——稽核單位改單行只填公司名稱;方法組要能一直加;「場次」看不懂改名「計畫概要」;Excel 改一格多值(換行或分號),不要往右延伸固定格數,寫清楚怎麼填。
  • 2026-10-16 決策者:裁 P1(第 2 次內稽帶入不合格+未判定的整條控制項)、P2(報告稿多印兩欄、可關)、P3(方法選單);下令寫 design 並開卡。實查 DEV 判定值有 pending,規則定為只排除明確 satisfied。
  • 2026-10-16 決策者:「現場觀察」裁甲——不新增選項,「檢視」改名「檢視/現場觀察」。
  • 2026-10-16 決策者:受評人員當場新增存這份稽核計畫自己的名單(角色 assessed),不動系統安全計畫。
  • 2026-10-16 決策者:FR-141 合回 feature/FR-139、跟 FR-140 一起測。
  • 2026-10-16 晚 決策者:第二個頁籤「評估目標」改名「查核項目規劃」,Excel 第三頁同名,舊檔頁名仍可匯入;指 AO 本身的「評估目標」字樣不改。
  • 2026-10-16 晚 決策者:稽核計畫書預覽「無法載入 PDF」要修好(前端下載少帶旗標,已修);附件表「稽核人員」欄沒覆寫時要印計畫概要名單。
  • 2026-10-16 晚 決策者:Excel 匯入對不到的稽核人員也要能當場新增;「沒有對應的都幫我標注新增預設」——受評人員與稽核人員預設新增,橫幅標「將新增 N 位人員」;匯入預覽篩選固定停在「全部」。
  • 2026-10-16 晚 決策者:曾要求 Excel、預覽、總覽、Word 都加控制項列;說明「控制項預設」不存檔、系統沒有控制項層後,裁示全部撤回並拿掉畫面上的「控制項預設」,只保留逐條評估目標。若日後要控制項層另案設計。
  • 2026-10-16 晚 決策者:「當我都驗過」,母卡與子卡收 Done;只 push、不發套件、不進版(套件 FR-140 也在用,等 FR-140 收口一起發)。

沿革見 LOG 與 git log。

§6

文件

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

需求與討論

文件 類型 標題 最後更新
discussion / md 需求討論稿 稽核計畫重做 2026-10-16

設計

文件 類型 標題 最後更新
design / md 設計 稽核計畫重做:設計定案 2026-10-16

prototype/(3 份)

其他文件

文件 類型 標題 最後更新
ap-authoring 文件(手刻 HTML) FR-141 雛形|稽核計畫 2026-10-16
import-preview 文件(手刻 HTML) FR-141 雛形|匯入預覽 2026-10-16
report-preview 文件(手刻 HTML) FR-141 雛形|報告稿預覽 2026-10-16

交接與收口時間軸(handoff/,2 份)

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

日期 文件 標題
2026-10-16 fr141-STATE / md FR-141 STATE
2026-10-16 fr141-LOG / md FR-141 LOG

資產子資料夾(無文件,不建頁):prototype/(6 個檔)

§7

Notion 卡

卡片內容(決策紀錄、驗收條件)以 Notion 為準,本頁只記座標。

關係 卡號 標題 狀態
母案 CM-2799 FR-141 稽核計畫重做 —