From 3b34bb6d4231a1a811ec52f5dcfdf9898564b364 Mon Sep 17 00:00:00 2001 From: Your Name Date: Thu, 11 Jun 2026 23:04:20 +0800 Subject: [PATCH] =?UTF-8?q?docs(logbook):=20=E8=A8=98=E9=8C=84=20backup=20?= =?UTF-8?q?restore=20=E6=B8=85=E5=86=8A=E6=AD=A3=E5=BC=8F=E9=A9=97?= =?UTF-8?q?=E8=AD=89=20[skip=20ci]?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/LOGBOOK.md | 56 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 56 insertions(+) diff --git a/docs/LOGBOOK.md b/docs/LOGBOOK.md index 178e2dfe2..95b17e5ef 100644 --- a/docs/LOGBOOK.md +++ b/docs/LOGBOOK.md @@ -1,3 +1,59 @@ +## 2026-06-11｜IwoooS P1-3 Backup / restore / escrow / retention repo-only 清冊 + +**背景**：統帥要求所有重要配置都要被資安控管；Backup / restore / offsite / escrow / retention 屬於 C0 高價值配置，若誤執行 `backup-all`、`rclone sync`、remote delete、`restic prune`、escrow marker write 或 Velero restore，會直接影響可恢復性與 credential recovery。本段延續「先建立框架、只讀證據、低摩擦流程，再階段性收攏」原則，只做 repo-only 清冊，不碰 live host、不執行任何 backup / restore / offsite sync。 + +**完成**： + +- 新增 `backup_restore_escrow_inventory_v1` 產生器、schema、snapshot 與人讀文件，納入 `38` 個 repo-only surface。 +- 清冊覆蓋 backup orchestration、`15` 個 backup script surface、`8` 個 offsite / escrow surface、`5` 個 Velero surface、`3` 個 retention surface、`5` 個 credential surface、backup / restore alert rules 與 cold-start / DR runbook。 +- 標記 `27` 個 write-capable surface；所有 surface 均固定 owner response required 與 live evidence required。 +- owner response received / accepted、live evidence、restore drill acceptance、offsite sync acceptance、credential escrow acceptance、retention change acceptance、maintenance window、rollback owner、runtime gate 與 action button 全部仍為 `0`。 +- 高價值配置覆蓋矩陣的 `backup_restore_credential` 從 `52%` 推進到 `58%`；高價值配置平均只讀成熟度維持 `65%`。這只代表 repo-only 清冊完成，不代表 live backup、restore drill、offsite sync 或 credential escrow 已驗證或可執行。 +- IwoooS posture projection snapshot / schema、`security-mirror-progress-guard.py`、高價值配置文件、配置控管總清冊與前端高價值配置卡已同步新口徑。 +- `/zh-TW/iwooos` 的 P1-3 卡由 `52%` 更新為 `58%`，並新增 `backup_restore_escrow_inventory_surface_count=38`、`backup_restore_escrow_inventory_write_capable_surface_count=27`、`backup_restore_escrow_inventory_runtime_gate_count=0`、`backup_run_authorized=false`、`restore_run_authorized=false`、`restore_drill_authorized=false`、`offsite_sync_authorized=false`、`offsite_remote_delete_authorized=false`、`credential_escrow_marker_write_authorized=false`、`retention_change_authorized=false`、`restic_prune_authorized=false`、`rclone_config_authorized=false`、`velero_restore_authorized=false` 等前台邊界標記；仍無任何操作按鈕。 + +**本地驗證**： + +- `python3 scripts/security/backup-restore-escrow-inventory.py --root . --output /tmp/backup-restore-escrow-inventory-check.json`：`BACKUP_RESTORE_ESCROW_INVENTORY_OK surfaces=38 backup_scripts=15 offsite_escrow=8 runtime_gate=0`。 +- `python3 scripts/security/high-value-config-control-coverage.py --root . --output /tmp/high-value-config-control-coverage-check.json`：`HIGH_VALUE_CONFIG_CONTROL_COVERAGE_OK categories=14 c0=8 avg=65 runtime_gate=0`。 +- `python3 scripts/security/security-mirror-progress-guard.py --root .`：`SECURITY_MIRROR_PROGRESS_GUARD_OK`。 +- `python3 scripts/security/source-control-owner-response-guard.py --root .`：`SOURCE_CONTROL_OWNER_RESPONSE_GUARD_OK`。 +- `python3 -m py_compile scripts/security/backup-restore-escrow-inventory.py scripts/security/high-value-config-control-coverage.py scripts/security/security-mirror-progress-guard.py`：通過。 +- JSON parse：backup / restore snapshot / schema、高價值覆蓋 snapshot / schema、IwoooS posture projection snapshot / schema、`zh-TW.json`、`en.json` 通過。 +- `cmp -s apps/web/messages/zh-TW.json apps/web/messages/en.json`：通過。 +- 本次變更檔案針對指定內部視窗與請求片語掃描：命中 `0`。 +- `python3 scripts/ops/doc-secrets-sanity-check.py docs .gitea`：`DOC_SECRET_SANITY_OK scanned_files=691`。 +- `pnpm --filter @awoooi/web typecheck`：通過；驗證產生的 `apps/web/tsconfig.tsbuildinfo` 暫態變更已排除。 +- `git diff --check`：通過。 + +**Gitea / deploy**： + +- 先同步另一個 Session 推進的 `803d7c4a feat(governance): 新增 owner approved learning dry run` 與後續 `e605076d fix(i18n): 補 owner dry run 狀態文案`，再接續 P1-3，避免覆蓋 P2-403F。 +- Code commit：`93a1993d feat(security): 新增 backup restore escrow 只讀清冊`。 +- Code-review run：`2727` 成功。 +- CD run：`2726` 成功；deploy marker：`96d1f2c5 chore(cd): deploy 93a1993 [skip ci]`。 + +**正式站驗證**： + +- Desktop `1280x720`：`https://awoooi.wooo.work/zh-TW/iwooos?_v=96d1f2c5-backup-restore-prod-desktop`，`IwoooS` 高價值配置覆蓋矩陣存在，P1-3 備份 / 還原 / 金庫卡顯示 `58%`；`clientWidth=1274`、`scrollWidth=1274`、`horizontalOverflow=false`。 +- Desktop DOM：`data-testid="iwooos-high-value-config-control-coverage-board"` 與 `data-testid="iwooos-high-value-config-control-coverage-boundaries"` 存在；卡內可操作元素 `0`；boundary DOM 含 `backup_restore_escrow_inventory_surface_count=38`、`backup_restore_escrow_inventory_write_capable_surface_count=27`、`backup_restore_escrow_inventory_runtime_gate_count=0`、`backup_run_authorized=false`、`restore_run_authorized=false`、`restore_drill_authorized=false`、`offsite_sync_authorized=false`、`credential_escrow_marker_write_authorized=false`、`retention_change_authorized=false`、`restic_prune_authorized=false`、`velero_restore_authorized=false`。 +- Mobile `390x844`：`https://awoooi.wooo.work/zh-TW/iwooos?_v=96d1f2c5-backup-restore-prod-mobile`，`clientWidth=384`、`scrollWidth=384`、`horizontalOverflow=false`；同樣可見 `58%`、`38`、`27` 與所有 backup / restore boundary，卡內可操作元素 `0`。 +- 目標敏感片語正式站 DOM 掃描：命中 `0`。 +- 截圖：`/tmp/awoooi-iwooos-backup-restore-prod-desktop-96d1f2c5.png`、`/tmp/awoooi-iwooos-backup-restore-prod-mobile-96d1f2c5.png`。 +- 驗證後已還原 in-app browser viewport 至預設。 + +**完成度同步**： + +- P1-3 repo-only surface 註冊：`100%`。 +- source existence / SHA256 hash：`100%`。 +- Backup / restore / credential 高價值配置成熟度：`52% -> 58%`。 +- owner response 收件 / 接受：`0%`。 +- live evidence collection：`0%`。 +- restore drill / offsite sync / credential escrow / retention change gate：`0%`。 +- IwoooS 整體仍維持 `64%`；active runtime gate 仍 `0`。 + +**邊界**：本段未執行 `backup-all.sh`、未執行任何 service backup、未執行 `restic check`、未執行 `restic forget --prune`、未執行 `rclone sync`、未讀遠端 offsite、未寫 escrow marker、未修改 rclone / B2 設定、未 apply Velero manifest、未跑 restore dry-run、未寫 Prometheus textfile、未 reload alert rules、未 SSH、未收 secret value、未 active scan、未新增任何前端執行按鈕。 + ## 2026-06-11｜P2-403F Owner-approved Learning Dry-run Preview **背景**：統帥指出「批准後仍沒有自動化，也沒有人工處理選項或明確說明」。P2-403D / P2-403E 已把 learning writeback 與 Telegram receipt 拆成批准包，但批准後的下一步仍不能直接寫 KM 或發 Telegram。本段先把 owner approval 後應產生的 dry-run preview、人工操作選項、補證路徑、驗證與 rollback 契約做成只讀 API 與治理頁區塊。