FR-145 · 需求索引 · 本頁由 build 掃資料夾生成
開發告一段落(2026-10-17):八張卡 Done、SPEC/手冊已更新、BE/FE 已 push、未進版;交棒總驗收首腦,總測試要驗的四條情境與發版前欠的事在 STATE §3
| 文件 | 性質 | 什麼時候看 |
|---|---|---|
| 雛形 | 畫面 | 想知道做出來長什麼樣,五個畫面點一遍 |
| 討論稿 | 設計決策 D1~D16(定案) | 想知道為什麼這樣定、不做什麼 |
| design.md | 設計決策(定案) | 拆卡、驗收十條、接入點、坑 |
| SPEC:結案報告 | 現況規格 | 結案報告清單現在怎麼運作(卡 1、2、6、7 已上線部分) |
| handoff/FR-145-STATE.md | 交接現況(living) | 接手先讀這份:WHY、讀序、自檢、現況、下一步 |
| handoff/FR-145-LOG.md | 歷史(append-only) | 哪一棒做了什麼、決策、教訓 |
一輪稽核跑完要能把成果整包交給客戶,現在做不到。本案兩件事:稽核報告(Word/PDF/Excel)掛在每個稽核次後面,結案就能下載;「專案調查結果」改造成結案報告,輪次結案仍有不符合時自動建該輪的階段結案報告、專案完成時自動建專案總報告,六章只有「總結與建議」由人寫,其餘從稽核計畫、稽核結果、改善計畫即時算。報告包含 Word、PDF、證據對照表、各稽核次報告與工作表、依控制族群/控制項/評估目標分資料夾的凍結證據,問卷填答轉 PDF。定稿鎖總結記版號;Word 給顧問自行修改交付,系統只記下載日誌不介入。不做差距分析報告、總報告至今版、改善計畫 Word。
| 棒 | Notion 卡 | 做什麼 | 狀態 |
|---|---|---|---|
| 0 | — | 雛形五畫面,三輪審查 | ✅ 2026-10-17 |
| 討論稿 | — | D1~D16 定案 | ✅ 2026-10-17 |
| design.md | — | 拆卡、驗收條件 | ✅ 2026-10-17 |
| 母卡 | CM-2854 | 母案 | 🟡 已開卡 |
| 1 | CM-2855 | 稽核作業清單下載報告+Word 加改善計畫節 | ✅ 2026-10-17 復核通過(BE b95c6eb6a/FE 0378b001) |
| 2 | CM-2856 | 報告自動建立+結案報告清單(含 migration) | ✅ 2026-10-17 復核通過+三項修正(BE 1f84d3bc6→6ea7e136a/FE fee81522→a4fe5065);出貨基線待重產 |
| 3 | CM-2857 | 階段結案報告頁+Word/PDF | ✅ 2026-10-17 復核通過(BE 824bffc80/FE 6ea3ecc1);「有改善計畫」路徑待全流程測試 |
| 4 | CM-2858 | 報告包(證據對照表、證據資料夾、問卷轉 PDF) | ✅ 2026-10-17 復核通過(BE 8fe83c3df/FE 17c51806);凍結雜湊取舊版待全流程測試 |
| 5 | CM-2859 | 專案總報告 | ✅ 2026-10-17 復核通過(BE 2da62a70a/FE 8c1c30e7);「覆核全過」路徑待全流程測試 |
| 8 | CM-2873 | Word/PDF 排版修正(追加) | ✅ 2026-10-17 復核通過(BE 0e95b7166);範本東亞字型未指定繁中屬既有狀況另議 |
| SPEC | — | 清單 hub+子頁「結案報告內容頁」;稽核作業、改善計畫兩頁隨 FR-142/143 收口重寫並帶上本案內容 | ✅ 2026-10-17(ea82f2ab9) |
| 手冊 | — | docs/user-manual/closing-report-guide.md |
✅ 2026-10-17(同 commit) |
| 7 | CM-2863 | 分組清單分頁器對齊待辦任務頁 | ✅ 2026-10-17 第二次復核通過(FE 67e9e11c;五頁統一內建分頁、共用元件已刪) |
| 6 | CM-2860 | FR-143 Excel「列全部」開關(追加) | ✅ 2026-10-17 復核通過(BE 30650bdd0/FE 249ea078);畫面路徑等 CM-2857 端到端驗 |
2026-10-17 卡 8 回來,首腦重啟 BE 下載三份報告 PDF 轉圖逐頁看:封面獨立頁、欄寬按內容、族群矩陣三子欄、短日期、缺失表兩行,FR-142 稽核報告沒被帶動。通過。本機轉出字型不一致查到是三份範本(含 FR-142)東亞字型都沒指定繁中、LibreOffice 替代不穩,伺服器端用 Noto CJK 無此問題,另議。八張卡全 Done,進母卡收口。
2026-10-17 卡 5 回來,首腦重啟 BE 實打兩份測試總報告(1548 三次稽核、1321 兩輪):跨多次未改善算法對 DB 原始判定、第 5 章帶入定稿總結、總報告 zip 內 第1輪/ 子包與定稿包逐檔 md5 相同、合併對照表輪次欄。通過。六張實作卡全 Done,剩卡 8 Word 排版與母卡收口。
2026-10-17 決策者看結案報告頁三點:中間留白太多、下載紀錄不必佔右欄、風格像另一個產品且字太小;首腦直接修(FE 04f58f2f/7a836ec4):文件撐滿套 dark-card、字級回全站基準、下載紀錄改對話框。規則固化進 memory 與 guidant-design-system skill:頁面不自訂字級/紙面版面,雛形只取結構。再看 PDF 裁「跟畫面差很多」→ 開卡 8 CM-2873 修 Word 排版,等卡 5 回來派。
2026-10-17 卡 4 回來,首腦重啟 BE 實打報告包:manifest、draft zip 解壓 19 檔結構照契約、對照表 21 列路徑全在包內、定稿存包 v6 歷史重下載、修訂再定稿後 v6 位元組不變、權限、下載紀錄。核心的「依凍結雜湊取舊版」在 DEV 打不到(全庫沒有帶 content-hash 的凍結紀錄,1199 在凍結機制上線前結案),只有單測與 runner 暫插資料驗過,列全流程測試必驗項。
2026-10-17 卡 3 回來,首腦第 2 棒重啟 BE 實打五支端點、走完定稿 v1→修訂→v2→還原、開 Word/PDF、查稽核事件表復核通過。runner 兩個改判記下:統計單位是評估目標不是控制項(與稽核報告附件一致,稽核結果頁頂部六格以控制項計,數字本來就不同);封面沒有「受稽單位」,系統沒這欄位,用稽核計畫概要的稽核單位頂替,要加另議。DEV 仍無已送出改善計畫,第 4 章只驗到「尚未送出」。
2026-10-17 決策者問規格文件有沒有更新。結案報告頁 SPEC 整頁重寫到現況(原頁停在 7 月描述舊的專案調查結果);稽核作業、改善計畫兩頁 SPEC 整頁還是 FR-142/143 改版前的舊畫面,在舊頁補一欄會更混亂,改在兩條線的 STATE 留言重寫時帶上;design.md 定稿凍結不回頭改。
2026-10-17 卡 7 第二次回來通過:五張清單分頁統一為 DataTable 內建(lazy+totalRecords=專案數),共用元件已刪。
2026-10-17 卡 6、7 回來。卡 6 通過(DEV 無已送出改善計畫,畫面路徑等卡 3 一起驗)。卡 7 退回一半:runner 照卡做了外掛共用分頁元件,但平行的 FR-142.9/143.8 兩棒已證明 DataTable 內建分頁加 lazy+totalRecords=專案數就能帶子列,四頁變兩種機制;改成四頁同用內建、刪共用元件。教訓:開卡時我沿用了「內建分頁會截子列」的舊註解當前提,沒驗——比照先例要先驗前提等價。
2026-10-17 卡 1、2 回來,首腦實打端點與查 DEV 復核通過。決策者看清單畫面裁三點:拿掉全部收合鈕;「尚未結案」是專案狀態不是報告狀態、分段鈕只剩待撰寫/已完成、沒報告的專案不列、專案狀態要篩另開;欄頭要能排序。首腦直接修並 commit。另提分頁要與待辦任務頁同模式,開 CM-2863(三張分組清單共用分頁元件)。
2026-10-17 卡 1(CM-2855)與卡 2(CM-2856)同時派出兩個 session。查 FR-143 六張子卡已全 Done,卡 3~6 的 FR-143 依賴解除,只剩卡間序列。
2026-10-17 design.md 定稿、七張卡建完(CM-2854 母卡、CM-2855~2860)。開卡踩坑:design.md 先寫了預估卡號 CM-2853 起,建卡時發現 CM-2853 已被 FR-144.4 平行用掉,實際從 CM-2854 起;卡號一律建完再回填,不預估。
2026-10-17 決策者提兩需求:結案報告一大包(調查結果 PDF、控制項對照表、證據包、稽核結果、稽核計畫)、稽核報告內外都要(逐控制項結果+改善計畫)。問放哪個 FR 下。首腦建議新開 FR,理由是粒度在整輪不在單一稽核次。
2026-10-17 決策者裁:Excel 只給最後一份(有改善計畫給改善計畫版)但要列全部;Word 只給稽核結果報告、掛在稽核次後面已結案可下載;問卷填答轉 PDF 進證據包;調查結果改六段固定章節只有總結手寫、第 3 段不給勾選。
2026-10-17 決策者問結案報告能不能分第一輪與覆核輪、最後有總報告。首腦建議兩層(一輪一份階段報告、專案完成一份總報告),差距分析不納,總報告只有完成才出。決策者同意。
2026-10-17 雛形第一輪:下載鈕看不出下載什麼→改「下載報告」文字鈕;清單四個狀態看不懂→收成待定稿/已定稿;階段與總報告在畫面分不出來→一專案一列展開子列;全無缺失直接寫總報告;報告由系統自動建立不設建立鈕。
2026-10-17 雛形第二輪:命名太白話→檔名識別子文案全改專業;專案概況與總報告「像硬塞的」→改文件版面;控制族群要看全部→橫列每次稽核;「我的稽核」隨 FR-142.8 改名「稽核作業」。
2026-10-17 雛形第三輪:「發出」看不懂→「定版」→最後定「定稿」,存檔與定稿分開;分段鈕「有待定稿」難理解→待撰寫/已完成/尚未結案;拿掉「顧問撰寫」標籤(撰寫者不固定);逐評估目標客戶愛收→附件一;存檔/定稿/下載三分開、下載做下拉照稽核計畫頁;Word 與 PDF 都給、顧問自行修改、系統只記日誌不介入;定稿照舊提供。
2026-10-17 決策者問 TipTap 要不要換:首腦查明現用 TipTap 3.7(MIT)非 PrimeVue Quill(當初掃出 XSS 已換掉),不換;工具列與內容排版重整(FE 760d6648)。
2026-10-17 四個待決策照首腦建議定案:矯正中可下載、定論取最後一次稽核、總報告不擋各輪未定稿、覆核又沒過再建階段報告;權限沿用 summary-report 能力點、PDF 套同一份 docx 範本。
以下全部由 build 掃資料夾產生,新增檔案重 build 即自動出現。標題連結指向渲染後的 HTML,md 連向源檔。
| 文件 | 類型 | 標題 | 最後更新 |
|---|---|---|---|
| discussion / md | 需求討論稿 | 結案報告與一包下載 | 2026-10-17 |
證據與盤點
| 文件 | 類型 | 標題 | 最後更新 |
|---|---|---|---|
| project-final-report | 盤點證據(手刻 HTML) | 專案總報告 雛形 | 2026-10-17 |
| round-closing-report | 盤點證據(手刻 HTML) | 第 1 輪結案報告 雛形 | 2026-10-17 |
其他文件
| 文件 | 類型 | 標題 | 最後更新 |
|---|---|---|---|
| audit-pass-exports | 文件(手刻 HTML) | 稽核作業 · 下載 雛形 | 2026-10-17 |
| closing-report-list | 文件(手刻 HTML) | 結案報告 清單 雛形 | 2026-10-17 |
由新到舊。每份是某一棒次交接當下的完整現況快照,看某個時間點「當時知道什麼」請從這裡進。
| 日期 | 文件 | 標題 |
|---|---|---|
| 2026-10-17 | FR-145-STATE / md | FR-145 交接現況(STATE) |
| 2026-10-17 | FR-145-LOG / md | FR-145 交接日誌(LOG) |
資產子資料夾(無文件,不建頁):prototype/(7 個檔)、screenshots/(2 個檔)