chore(ops): reload 卡死三层预防 + F1-5a 完整走查报告

Browse Source

reload 卡死三层预防(走查中遭遇 uvicorn graceful shutdown 死等触发):
- Layer 1 (apps/backend/start_uvicorn.py 新): 把 reload-excludes
  封装在 Python 字符串内,ps1 命令行只有字面路径,根治 PowerShell
  PSNativeCommandArgumentPassing 在不同 profile 下 wildcard 展开
  行为差异(数组 splatting 和 --% 都不稳)。同时显式设
  timeout-graceful-shutdown=5,5 秒强杀防死等
- Layer 2 (scripts/ops/backend-watchdog.ps1 新): 自主 socket 探针
  (TcpClient + 手写 HTTP/1.1 GET,Connection: close)规避 .NET
  HttpClient pool 复用 + 系统代理误报;3s × 3 = 9s 触发重启;
  进程链 kill 至 pwsh 后端窗口(关闭原窗口);3 次/小时上限自停
- Layer 3 (scripts/ops/start-admin.ps1): 启动时拉起 watchdog,
  菜单 [4] 仅重启后端选项,主菜单退出时一并 kill 看门狗

CLAUDE.md: 新增"后端 reload 卡死预防(强制)"章节,
分级文件风险表 + SOP + 启动菜单速查

走查报告(应查尽查严肃版):
- 后端 6 个改造点 PASS(P1-P4 + GUC + ai_run_logs runtime 字段)
- admin-web 7 页 Playwright 实地走查 → 5 项 UI 不完整登记 F1-5b
- 小程序看板 tab 7 页 weixin-devtools-mcp 实地 + DB 数据核对 →
  board-finance 5/6 项上界裁剪吻合;board-customer 业务日生效;
  board-coach 月度聚合表设计盲区;5 项 sandbox 覆盖盲区登记 F1-5b
- 8 张走查截图归档 docs/audit/changes/screenshots/2026-05-05_f1_5a_walkthrough/

audit_dashboard 刷新到 153 条审计

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

...

This commit is contained in:

Neo

2026-05-05 11:53:08 +08:00

parent 1baa21222b

commit 95a4500c75

14 changed files with 745 additions and 5 deletions

Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL

Download Patch File Download Diff File Expand all files Collapse all files

BIN

docs/audit/changes/screenshots/2026-05-05_f1_5a_walkthrough/p10_ai_dashboard.png Normal file

Binary file not shown.

Side by Side After Width:  |  Height:  |  Size: 93 KiB

BIN

docs/audit/changes/screenshots/2026-05-05_f1_5a_walkthrough/p11_global_statusbar.png Normal file

Binary file not shown.

Side by Side After Width:  |  Height:  |  Size: 88 KiB

BIN

docs/audit/changes/screenshots/2026-05-05_f1_5a_walkthrough/p12_ai_trigger_jobs.png Normal file

Binary file not shown.

Side by Side After Width:  |  Height:  |  Size: 57 KiB

BIN

docs/audit/changes/screenshots/2026-05-05_f1_5a_walkthrough/p7_runtime_context_initial.png Normal file

Binary file not shown.

Side by Side After Width:  |  Height:  |  Size: 26 KiB

BIN

docs/audit/changes/screenshots/2026-05-05_f1_5a_walkthrough/p7_runtime_context_page.png Normal file

Binary file not shown.

Side by Side After Width:  |  Height:  |  Size: 103 KiB

BIN

docs/audit/changes/screenshots/2026-05-05_f1_5a_walkthrough/p8_ai_operations.png Normal file

Binary file not shown.

Side by Side After Width:  |  Height:  |  Size: 187 KiB

BIN

docs/audit/changes/screenshots/2026-05-05_f1_5a_walkthrough/p9_ai_run_logs.png Normal file

Binary file not shown.

Side by Side After Width:  |  Height:  |  Size: 124 KiB

BIN

docs/audit/changes/screenshots/2026-05-05_f1_5a_walkthrough/p9_log_after_click.png Normal file

Binary file not shown.

Side by Side After Width:  |  Height:  |  Size: 138 KiB