↑ 需求首頁 ⌂ 需求中心

FR-074 檢測工具整合教學影片系列（Act 04）— 全案收口 SUMMARY

2026-09-04 收口｜母卡 CM-1535、子卡 CM-1536～1542｜user 逐章驗片通過（04-04 最終版 2026-09-04 確認 OK） 成品六章 75:42、28 段分段 mp4，交付於 test repo reports/training-videos/GuidantAI-檢測工具整合教學-v1.19/（不入版控） 本檔由 Notion 七張子卡回寫＋fr074-04-04-{STATE,LOG}.md＋兩 repo git log 濃縮，時長以 ffprobe 實量為準。

1. 成品座標

compliance-manager-test/reports/training-videos/GuidantAI-檢測工具整合教學-v1.19/

檔 時長 大小
GuidantAI-檢測工具整合教學-完整版.mp4（00～05 串接；章節起點 00:00／01:50／19:16／27:21／47:56／74:09，見同目錄 完整版-章節時間.txt） 75:42 365 MB
GuidantAI-檢測工具教學-00-總開場.mp4 1:51 17 MB
GuidantAI-檢測工具教學-01-檢測工具管理.mp4 17:26 107 MB
GuidantAI-檢測工具教學-02-掃描設定檔管理.mp4 8:04 42 MB
GuidantAI-檢測工具教學-03-任務設為檢測工具執行.mp4 20:36 94 MB
GuidantAI-檢測工具教學-04-執行與結果回收.mp4 26:12 89 MB
GuidantAI-檢測工具教學-05-總結.mp4 1:33 15 MB
分段/：01 a～f、02 a～c、03 a～i、04 a1／a2／b1～b5／c 共 26 支（00／05 單段即成片） — —

工作檔（分段＋各章合併版）仍在 reports/training-videos/chapters/04-detection-*.mp4；重錄單段 → training/scripts/merge-phase-videos.sh → 手動搬進歸檔目錄取代。Playwright 原始檔在 test-results/videos/training/passed/（FR-074 的 <30s dry-run 短檔 74 支已歸 superseded/）。

2. 最終章節與段數（28 段）

章 段數 @phase 角色 實錄 原估
04-00 總開場 1 intro（流程卡四步＋旅程地圖四站） admin 1:51 ~2
04-01 檢測工具管理 6 a-catalog（八支工具逐一導覽）b-openvas（＋SonarQube）c-openscap（私鑰遮罩、部署前提、逐網段測試）d-govern e-zap-nmap f-dual-cred（GCB＋CINC 雙憑證組含 WinRM） admin 17:26 ~8
04-02 掃描設定檔管理 3 a-concept b-upload c-controls admin 8:04 ~6
04-03 任務設為檢測工具執行 9 a-openscap-task b-gcb-task c-cinc-task d-nmap-task e-openvas-task f-zap-task g-sonarqube-task h-multi-agent（多組分派＋排程）i-review PM Bob 20:36 ~7
04-04 執行與結果回收 8 a1-start-ssh（PM 發動）a2-start-api（執行者確認＋SonarQube 上傳發動）【切點】b1-result-os b2-result-cinc-nmap b3-result-web（ZAP）b5-result-vuln（OpenVAS）b4-result-sonar c-rerun（PM 規劃頁） Bob→Alex→Bob 26:12 ~7
04-05 總結 1 summary — 1:33 ~1.5
合計 28 75:42 ~30

段數沿革：開案 13 段 → SonarQube 入戲 14 → 七支工具全示範 22（04-03 8、04-04 7）→ 04-01 加 E／F 成 6、04-03 加 Seg-H 成 9、04-04 拆 B5 成 8 → 28。

3. commits

test repo compliance-manager-test（branch feature/FR-069.5，未 push）

commit 卡 內容
3ee3a45 首腦 Act README＋六章 outline（13 段）
e1dd5a8 2f87dff 0cfcee5 47c84e1 afddc18 首腦 outline 調整：50 網段目標改 190、SonarQube 入戲、Seg-C 逐網段測試、Seg-B 選 50 網段 Agent、OpenSCAP 基準改下拉
6457281 CM-1536 S0 地基：四頁 page object＋業務 step、私鑰遮罩、env 變數、smoke 全綠
1f03666 CM-1536（含 CM-1538 staged 改動） 設定檔 page object 三處修正（版更 header／送出鈕／Tab 收面板）＋ InputSwitch 改 isChecked() 兩處＋pages README 更正
335e1b4 918afe7 CM-1536 補報告預覽三支 step；補任務描述／完成留言 step、「第 N 筆任務」跨控制項連續編號
d015eb5 CM-1537 04-00／04-05 純字卡兩支
9a6d13a 7bee50e f93ef2b 439f9b9 0c641be 5290537 f3800ce CM-1538 04-01：四段→Seg-C 重錄（SCAP content）→Seg-A 補八支工具重錄（1:36→3:20）→加 Seg-E／F 七支全設定→六段合併 15:44→17:28
7276692 219bcdc fea6197 CM-1539 04-02：三段＋示範 profile zip→Seg-C 改公版→合併 8:06→清 190 五筆測試設定檔
20c5ceb 86d0a3e cd17c12 首腦 04-03／04-04 擴七支工具；Nmap 改 60.168；OpenSCAP 目標改 60.162
ea736f9 974a804 325fcf2 fe170e7 CM-1540 04-03 八段錄完→指派人員改 id 定位＋冪等→user 驗片修正（merge 去頭 8 秒、ZAP 靶站、新增 Seg-H）九段 20:37→outline 同步
83db57b c745cb3 首腦 04-04 B 段是否等排程組：先改文案帶過，再撤回改等八組全成功
a1d2ace 05f0941 0e6dab8 1346fa8 CM-1541 第 1 棒 阻塞診斷→A1／A2 改劇本→A1 錄→A2 錄＋修 S0 上傳 bug
4cb71f9 CM-1541 第 2 棒 B1～C 五段＋B5 新增，八段合併 26:23
15f7b7f CM-1541 第 3 棒 統計導覽 selector 誤圈＋OpenVAS PDF 卡死修正，B1～B5 重錄
772c9ec CM-1542 收口：README 對齊 28 段＋實錄時長、六章 03-status 填實、preview-overlays 補流程卡／旅程地圖對照、dry-run 短檔歸 superseded

BE repo compliance-manager-be（branch feature/FR-069.5，未 push）

commit 內容
9cc83b6f 開案：design.md 定案（6 章 13 段、190 亮色、7 子卡）
f997b494 359fcb7b a8dc8fcd design 同步：50 網段目標改 190、SonarQube 入戲 14 段、七支工具 22 段
230e2862 對話歸檔：CM-1540 04-03 製作
be9ee974 c19ed2b6 699118ee 5bbeb453 04-04 四棒 STATE／LOG
（本次） 本 SUMMARY＋design 變更紀錄＋README 登記表狀態

4. 對原大綱的重大偏離（皆 user 拍板）

  1. 七支可用工具全設定、全設任務、全執行（2026-09-03）。原案只示範 OpenVAS＋OpenSCAP 設定、OpenSCAP＋GCB 兩任務；user 定調「證明每支都做得到」，04-01 4→6 段（E ZAP＋Nmap、F GCB＋CINC 雙憑證組含 WinRM）、04-03 4→8、04-04 3→7；Nessus 為 coming_soon 只提一句。總時長 ~30 → 75 分鐘。
  2. 04-04 A 段改 PM 發動。原案「執行者 Alex 逐一按開始執行」在產品上不成立——任務要 PM 在規劃頁按「開始執行任務」才轉 PROCESSING，且該動作 _auto_dispatch_detection_scans 會自動派掉六支非上傳型任務的第一次掃描；執行者抽屜沒有「開始執行」鈕。A1 改 PM 視角、A2 改執行者視角，只有 SonarQube（上傳型）保留手動發動示範。選「改劇本」而非「清資料」：清執行紀錄屬 190 寫入型異動，且 CINC 真實失敗反成 C 段素材。
  3. 04-04 C 段改走規劃頁。vw_user_job_queue 硬篩 user_id = 當前使用者，PM 在「我的任務」一筆都看不到（產品設計非 bug）；改在規劃頁任務面板回顧設定＋說明重跑取消。
  4. OpenSCAP 掃描目標改 60.162（Ubuntu 24.04 原生 SSG content）。60.166～168 是 26.04，上游 ssg 0.1.79 沒出 26.04 內容檔；04-01 Seg-C 測試連線靠 cp 2404 → 2604 權宜通過（三台都做，oscap info 標題仍是 24.04，不適合真實稽核），04-03 任務則直接換目標避開。
  5. Nmap 任務執行主機改 60.168。nmap 裝在被掃目標而非 Agent（NPSL 授權不隨 Agent 發布），190 沒裝；Agent 改 60-ubuntu-2604-lab-03。
  6. ZAP 靶站改 60.165 OWASP Juice Shop（user 驗片後）。原掃主站 190 被動掃描 0 發現；換靶站順勢補「只掃有授權的練習靶站」說明卡。
  7. 04-03 新增 Seg-H 多組分派與排程（user 驗片要求）。拿 OpenSCAP 任務加第二組（guidant-server 掃 190、排程當晚 22:00），排在總覽之前成獨立段，原總覽順延 Seg-I；理由：多 Agent／排程是跨工具通用能力，塞進 A 段會被誤讀為 OpenSCAP 專屬。
  8. 其他：04-01 Seg-A 補「八支工具逐一認識」（user 審片：所有工具都要說明）；04-02 Seg-C 控制項清單改用公版 TWGCB-01-014（190 api 容器沒裝 cinc-auditor，自有設定檔抽取必失敗，STG／POC 同樣）；04-03 Seg-A 掃描基準改「從下拉選」（190 param_schema 為純 select）；04-04 OpenVAS 自 B3 拆出 B5（第一輪逾時，merge 腳本改 B5 動態選配）。

5. 踩到的坑與教訓

坑 發生在 根因／修法 教訓
CINC sudoers 04-04 A2 部署前提腳本只開 oscap NOPASSWD，CINC 死在 Sudo cannot prompt for password because there is no terminal；user 補 NOPASSWD: ALL 後重跑成功 部署前提說明與實際工具需求不對等（見 follow-up）
OpenVAS 逾時 04-04 掃 190 一輪超過 3600s 上限逾時失敗、無報告；第二輪 42 分鐘成功（86 findings）。逾時不留 task_id 無法補拉 錄影前把 timeout_sec 調大或換小目標；交接檔的「正在跑」是快照不是承諾，接手要重查
PDF 報告 headless 不能預覽 04-04 B5 OpenVAS 報告是唯一 PDF，headless Chromium 無 PDF viewer，iframe 走 download 流程永遠轉圈；改導覽「下載報告」鈕 沿用別段模板前先查該段特有資料形狀（upload_files.file_ext）
統計導覽 selector 全段誤圈 04-04 B1～B5 七處 .exec-info-grid 抓到 metadata 區塊不是「掃描結果統計」；改 text="掃描結果統計" >> xpath=.. SKIP_OVERLAYS 綠燈只證明元素存在、不證明圈對；最終驗收一定要真的看畫面
任務未發動無開始執行鈕 04-04 開錄前 見偏離 2；唯讀盤點（Playwright probe＋DB SELECT）定位到是產品前置流程，不是 selector 開錄前唯讀盤點是最值錢的動作，否則會誤診成「S0 step 寫錯」去改 S0
Escape 關 dialog 04-02 S0 AutoComplete 收面板按 Escape 會連 PrimeVue Dialog 一起關；改 Tab PrimeVue quirk
指派人員 placeholder 定位 04-03 MultiSelect display="chip" 存過人 placeholder 消失，正式錄第一輪 A～G 七段全掛；改 [id^='pp-task-assignees-'] 定位＋冪等（讀 aria-selected 不讀 class，突變測試驗證） 「先驗證再正式錄」的標準流程必然觸發「同段錄第二次」狀態差，locator 不可綁一次性狀態
InputSwitch class 判斷 04-01 Seg-C p-inputswitch-checked 是未用佈景的 class，永遠判「關」把 sudo 反手關掉且靜默綠燈；改 isChecked()＋點完再驗 佈景 class 不可當狀態來源；靜默寫反比報錯更危險
GCB／CINC 無 findings 04-04 B1／B2 summary 只有 pass/fail/error/notapplicable，應看到發現項目統計 必逾時；拿掉斷言改字卡口徑
auto 完成任務從預設清單消失 04-04 A2 GCB auto 掃完即 COMPLETED，「我的任務」預設篩進行中；每段開頭先篩「全部」
合併裸接閃爍 04-03 未照 SOP 關 4 去頭；merge 腳本加 TRIM_HEAD（預設 8，換章要實測）；04-01 逐段實測裁切（2～5s 不等）未寫死 裁切秒數是逐段實測值，各章各段不同
口頭秒數不可盲信 04-04 第 4 棒 user 說「後 8 秒」剪掉，逐幀核對發現會切到總結卡，改 5 秒 下刀前先截圖核對邊界
平行 session commit 撞車 CM-1538／1539 兩 session 同 branch，一方 staged 檔被另一方 commit 帶走（1f03666 訊息掛 CM-1536，內容含 CM-1538 改動）；未改寫歷史 同 branch 平行跑要錯開或分 branch；追溯以 Notion 卡回寫為準
unique constraint 症狀誤導 04-02 同名設定檔撞 uq_dp_tool_tenant_name，錯誤顯示在下一步「dialog mask 擋住搜尋框」 「後面那步壞掉」要往前一步看
字卡真實換行 04-04 第 2 棒 Gherkin 參數要單行用 \n 字面值，貼真實換行 parse error
S0 上傳 bug 04-04 A2 直接對隱藏 input setInputFiles 跳過 pickSourceFile(row)，檔案落 _default key、按鈕維持 disabled 但 toast 顯示成功；改走 filechooser 真實路徑 症狀「看起來成功但按不下去」極具欺騙性

6. Follow-up（未結，需另開卡或決策）

  1. BE log 印 request body 含私鑰明文：app_mw.before_request 印 Request Body 全文，儲存 OpenSCAP／WinRM 設定時私鑰／密碼明文進 guidant-api log（DB 是加密的，log 不是）。user 2026-09-03 裁「記錄不修」（memory followup_be_logs_request_body_plaintext_credentials）。
  2. OpenVAS 逾時不留 task_id、無法補拉報告：逾時判失敗後 OpenVAS 端可能還在跑甚至跑完，但平台沒存 task id，事後拉不到報告；建議逾時時保留 task id 供補拉，或 timeout_sec 預設對 OpenVAS 放寬。
  3. 部署前提腳本 sudoers 只開 oscap：「部署前提說明」給的腳本只授權 oscap，CINC Auditor（以及其他需 sudo 的 SSH 型工具）掃描會失敗；腳本應依已啟用工具產生對應 sudoers 或明講需 NOPASSWD: ALL。
  4. PDF 報告 headless 預覽：教學管線無法示範 PDF 報告預覽（環境限制）；若日後要錄，需 headed 或改用 pdf.js 內嵌檢視。產品端 iframe 預覽 PDF 在一般瀏覽器可用，非產品 bug。
  5. merge 裁切秒數各章要實測：TRIM_HEAD 預設 8 是 04-03 規劃頁量的；04-01 逐段 2～5s 手裁、04-04 沿用 8 另加整片去頭 6／去尾 5。重錄任一章前先截圖量再合。
  6. 其他已記在各章 03-status.md：60.166～168 的 2604 SCAP content 是 2404 複製品，上游補齊後應換回；190 api 容器未裝 cinc-auditor（STG／POC 同）；S0 smoke 的 SonarQube「停用」斷言已改啟用（86d0a3e）；04-01 Seg-A 錄在「已設定」狀態非純淨初始。

7. 190 留下的狀態（04-04 素材，不要清）

七支工具全 enabled＋test success；專案「2027 CMMC 2.0 Level1 年度稽核」第一群組前 7 個評估項目各掛一個檢測任務（OpenSCAP 兩組），全部指派 Alex Wang，七任務全成功（含 OpenVAS 重跑）、OpenSCAP 一組已人工結案 COMPLETED、GCB 自動結案；04-02 錄影產生的 5 筆自有設定檔已清。SonarQube 171 上有 Guidant-AI-billows-portal 專案。

8. 交接檔與文件座標

  • 設計：docs/features/FR-074-2609-detection-tools-training-videos/design.md
  • 04-04 四棒交接：同目錄 handoff/fr074-04-04-STATE.md（living，已結案）／fr074-04-04-LOG.md（append-only）
  • test repo：training/chapters/04-detection-tools/README.md（Act 索引＋事前準備＋成品座標）、各章 02-outline.md（劇本 canonical）、03-status.md（實錄結果與坑）
  • Notion：母卡 CM-1535；子卡 CM-1536（S0）、1537（00／05）、1538（04-01）、1539（04-02）、1540（04-03）、1541（04-04）、1542（收口）