migration: close candidate maintenance audit

docs/migration/evidence/slice-11/README.md

@@ -2,6 +2,7 @@
 
 > 基线：`dec3cd12365df5e7d4c391369f14c457cf56d7d9`
 > 候选回档标签：`xiaobai-preservation-slice-11-candidate-20260731`
+> 严格审计候选标签：`xiaobai-preservation-slice-11-audit-candidate-20260731`
 > 当前结论：自动验收完成，等待用户人工验收；尚未执行正式切换、Docker或NAS部署
 
 ## 1. 本切片做了什么
@@ -30,7 +31,7 @@
 | 验证 | 结果 |
 |---|---:|
 | 原版`python -m unittest discover -s tests -q` | 231项通过 |
-| 迁移版`python -m unittest discover -s tests -q` | 298项通过 |
+| 迁移版`python -m unittest discover -s tests -q` | 302项通过 |
 | 历史切片与前端/清理专项复核 | 通过 |
 | 迁移版JavaScript语法检查 | 24个文件通过 |
 | `npx.cmd playwright test --reporter=dot` | 45项通过（1.6分钟） |
@@ -44,6 +45,12 @@
 
 完整API和数据库结果分别见`api-diff.json`与`database-diff.json`，二者`all_equal`均为`true`。
 
+严格完成审计另外验证了候选维护工具本身：API注册表和候选架构清单均可生成并执行
+`--check`；24个前端脚本全部由统一命令发现；迁移期写入工具必须显式指定输出或`--apply`。
+Windows下Playwright托管Python静态服务器会在45项执行后不退出，统一验证器现改为显式启动、
+探活和停止8876；最终同一命令正常退出并明确报告`45 passed`。四项维护工具契约测试使迁移版
+总数从298增加到302。逐项目标矩阵见`completion-audit.md`。
+
 ## 3. 真实浏览器验收
 
 - 桌面端复核情绪周期、智能选股三个工作区、问天日间/夜间和加载资源；控制台无新增
@@ -67,7 +74,7 @@
 
 ## 5. 回档与最终确认
 
-切片11提交和标签只代表“候选可验收”，不代表删除已被永久确认。人工验收前可按
+切片11提交和两个候选标签只代表“候选可验收”，不代表删除已被永久确认。人工验收前可按
 `uncertain-code-audit.md`从切片10标签单独恢复任一候选；不需要回退其他已通过迁移切片。
 
 用户人工确认后才允许：

docs/migration/evidence/slice-11/api-diff.json

@@ -18,8 +18,8 @@
       "endpoint": "/api/account/status",
       "original_status": 200,
       "migrated_status": 200,
-      "original_sha256": "094530da01cbc633de4e2a09d1b3a58689ed9743d2ab2207c495e6c44781fc1e",
-      "migrated_sha256": "094530da01cbc633de4e2a09d1b3a58689ed9743d2ab2207c495e6c44781fc1e",
+      "original_sha256": "0ac1b88affa62671f14ba9ea0bd42155952fdc2e03dba3573c232bb452733bc6",
+      "migrated_sha256": "0ac1b88affa62671f14ba9ea0bd42155952fdc2e03dba3573c232bb452733bc6",
       "equal": true,
       "first_difference": null
     },
@@ -62,8 +62,8 @@
       "endpoint": "/api/auction?trade_date=2026-07-30",
       "original_status": 200,
       "migrated_status": 200,
-      "original_sha256": "5a6b643ab1d7e2285ae5667bca12e6ed887ba4aa7512ba989e0dcfb2032e755b",
-      "migrated_sha256": "5a6b643ab1d7e2285ae5667bca12e6ed887ba4aa7512ba989e0dcfb2032e755b",
+      "original_sha256": "bd75b100485c0afa0cdddc73d1880160eea8c0b8c91f556245c665d591285ed6",
+      "migrated_sha256": "bd75b100485c0afa0cdddc73d1880160eea8c0b8c91f556245c665d591285ed6",
       "equal": true,
       "first_difference": null
     },
@@ -95,8 +95,8 @@
       "endpoint": "/api/dragon-tiger?trade_date=2026-07-30",
       "original_status": 200,
       "migrated_status": 200,
-      "original_sha256": "9d19029f655813ed40a25deb0b3250423a40ae0ee779638ec90f85333f859c6f",
-      "migrated_sha256": "9d19029f655813ed40a25deb0b3250423a40ae0ee779638ec90f85333f859c6f",
+      "original_sha256": "1d6936e33aea2bb4258d1d4d007385626d0c638fc290b66271f00649dba59358",
+      "migrated_sha256": "1d6936e33aea2bb4258d1d4d007385626d0c638fc290b66271f00649dba59358",
       "equal": true,
       "first_difference": null
     },
@@ -216,8 +216,8 @@
       "endpoint": "/api/alerts?status=all&as_of=2026-07-30",
       "original_status": 200,
       "migrated_status": 200,
-      "original_sha256": "01e8f169fbc8700313dbdf8379e682b78d7b372cfbee556e1d68f46cd6cbeecf",
-      "migrated_sha256": "01e8f169fbc8700313dbdf8379e682b78d7b372cfbee556e1d68f46cd6cbeecf",
+      "original_sha256": "b611e936ada5d547c728e33e811630282d1eecd7c1ab1517e22b34902eda032a",
+      "migrated_sha256": "b611e936ada5d547c728e33e811630282d1eecd7c1ab1517e22b34902eda032a",
       "equal": true,
       "first_difference": null
     },

docs/migration/evidence/slice-11/completion-audit.md

@@ -0,0 +1,72 @@
+# 保真迁移完成度逐项审计
+
+> 审计对象：`webapp/app/`
+> 审计基线：`xiaobai-preservation-slice-11-candidate-20260731`
+> 结论口径：自动证据通过不替代用户人工验收，也不授权部署切换
+
+本审计回答的不是“测试是否为绿色”，而是迁移总纲、批准目录、产品表面和人工维护目标是否
+分别有可复验的证据。状态只使用：`自动闭环`、`人工待验`、`明确保留`和`未执行`。
+
+## 1. 目标与证据矩阵
+
+| 要求 | 当前实现 | 主要证据 | 状态 |
+|---|---|---|---|
+| 原版是唯一产品/视觉基线 | 所有切片从根目录原版复制或机械移动；规格书不覆盖真实行为 | 总纲；切片00-11源码映射 | 自动闭环 |
+| `next/`完全隔离 | `next/`未进入候选导入、资产、测试或部署路径；切片10后Git差分为0 | `next失败冻结记录.md`；Git路径审计 | 自动闭环 |
+| 批准的模块化单体目录 | `backend/{bootstrap,http,features,data,database,jobs,llm}`、`frontend/{shared,pages,styles,vendor}`、`config/data/tests/tools`均已归位 | `app/config/architecture-inventory.json`；切片01-10 | 自动闭环 |
+| 不制造第二套产品实现 | 根入口是兼容外壳；业务方法从原类机械移动，专项测试逐符号比较AST/哈希 | 切片01-10 preservation tests | 自动闭环 |
+| 16个主工作区及内部能力完整 | 页面注册表有16个主工作区；策略跟踪、搜索、详情、提醒、账户和系统管理保留 | `pages.config.json`；前端边界测试；Playwright | 自动闭环 |
+| API路径、权限、错误语义不变 | 53个精确路径和11个正则路径有唯一所有者；鉴权在后端执行 | `api.config.json`；HTTP/权限测试；21端点差分 | 自动闭环 |
+| 数据源有统一边界和质量规则 | 18个数据集登记来源、用途、单位、新鲜度、覆盖率、复权和失败关闭规则 | data registries；DataGateway/quality tests | 自动闭环 |
+| 数据库无损、用户隔离不变 | 36张表由初始schema和有序migration管理；62个schema对象、21张关键表差分相同 | 数据库差分；migration/repository/account-boundary tests | 自动闭环 |
+| 后台任务可追踪和重试 | 3个任务登记调度、锁、超时、重试和输出版本；运行状态持久化 | `jobs.config.json`；job runner tests | 自动闭环 |
+| LLM唯一治理边界 | 问师、问天、复盘助手和策略编译经统一网关执行会员、额度、模型回退、流式和审计规则 | 切片07/09；LLM gateway/stream tests | 自动闭环 |
+| 前端唯一请求出口、Shell和页面职责 | 只有`frontend/shared/api.js`调用`fetch`；Shell、状态、弹窗、页面生命周期及页面模块已归位 | frontend boundary tests；切片10源码重组哈希 | 自动闭环 |
+| CSS、主题、动画和移动行为不改写 | 原七层CSS和问天动画按字节/源码移动；令牌层与加载顺序受测试保护 | CSS governance；切片10/11浏览器证据 | 自动闭环 |
+| 不确定代码先记录再试删 | 2个文件和5个无消费者函数仅为候选试删；历史表兼容责任继续保留 | `uncertain-code-audit.md`；cleanup contract | 人工待验 |
+| 可由人工维护者复验 | 候选README/架构说明、工具分类、API/架构生成器、统一验证命令均可从`app/`独立运行 | `app/tools/README.md`；maintenance tool tests | 自动闭环 |
+| 正式数据库与部署不受影响 | 验收只使用隔离SQLite副本和非8765端口 | 各切片README；运行记录 | 自动闭环 |
+| Docker/NAS和正式入口切换 | 用户已明确本轮不做NAS Docker测试；人工验收前禁止切换 | 迁移状态和切换指南 | 未执行 |
+
+## 2. 结构减法的可量化结果
+
+- 根`server.py`从原版约5,851行降为25行稳定入口；实现归入启动、HTTP和产品领域模块。
+- 根`database.py`从原版2,839行降为746行，只保留初始schema、组合入口及有明确历史兼容责任的
+  方法；各领域查询已移入对应Repository。
+- 20个其他根Python兼容模块均为1-15行导出/模块别名，不含第二套实现。
+- 原9,283行前端运行时按原连续源码范围拆入共享层和13个页面目录；试删后仍由源码重组测试
+  保护，不能悄悄增加、丢失或重排原行为。
+- 已确认没有消费者的`demo_data.py`、旧问天加载文件和5个函数进入可单项恢复的试删候选；
+  `wencai_saved_queries`因旧数据库兼容和账号隔离继续保留。
+
+大文件不等于自动可删。筛选引擎、Tushare适配器、问天确定性计算和原CSS仍是单一有效实现；
+在没有更细的同输入差分与人工视觉确认前继续拆分，反而违反“整理原件而非重拍”的迁移约束。
+它们已登记在`config/architecture-inventory.json`的`code_hotspots`，供后续正常维护按领域处理。
+
+## 3. 本次严格审计发现并关闭的缺口
+
+候选版初次自动验收后，三个维护工具仍带有旧目录假设：基线验证器引用不存在的`static/`，
+架构清单写向不存在的候选文档目录，原样清单生成器假设`app/app`且会因试删文件直接异常。
+这些问题不改变产品页面，却会让接管者无法按指南复验，因此不能视为可维护性完成。
+
+关闭方式：
+
+1. 基线验证器改为检查候选全量测试、两个生成注册表、`frontend/`下全部JavaScript、Git差异和
+   测试数据库完整性。
+2. 候选架构清单固定生成到`config/architecture-inventory.json`，从正式候选路径统计16页、
+   64类路由匹配、36张表、供应商/LLM入口、CSS层和热点文件。
+3. 原样资产清单、方法搬运和前端拆分明确标为迁移期工具；可能写文件的操作必须显式传路径或
+   `--apply`，默认帮助路径不改文件。
+4. 新增维护工具契约测试，保证生成文件新鲜、所有工具`--help`可用，旧`static/`路径不会回归。
+
+## 4. 仍需用户完成的最终裁决
+
+自动部分完成后仍不能执行以下动作：
+
+1. 把切片11的试删候选从“待人工确认”改成“确认废弃”。
+2. 声称所有页面的视觉、交互手感和动画已经由用户确认等价。
+3. 建立最终完成标签，或把`app/`切换为本地/容器正式入口。
+4. 删除根目录原版、正式数据库备份或冻结的失败记录。
+
+本地人工验收入口及逐页清单以`人工维护与本地切换指南.md`为准。发现差异时只回退对应候选，
+不使用破坏性Git操作覆盖原版或正式数据。

docs/migration/evidence/slice-11/database-diff.json

@@ -56,8 +56,8 @@
       "table": "alerts",
       "original_count": 2,
       "migrated_count": 2,
-      "original_sha256": "a496857f915d8ba0870274455182a2d7f180a931836b7078e9676dc0e7bbe430",
-      "migrated_sha256": "a496857f915d8ba0870274455182a2d7f180a931836b7078e9676dc0e7bbe430",
+      "original_sha256": "3fd3b7ceb0950d543fba9cebdd2b4294fe187b37a6b8d4755a49428661b3ae1c",
+      "migrated_sha256": "3fd3b7ceb0950d543fba9cebdd2b4294fe187b37a6b8d4755a49428661b3ae1c",
       "equal": true,
       "excluded_columns": []
     },

docs/migration/人工维护与本地切换指南.md

@@ -77,19 +77,13 @@ python -m unittest discover -s tests -q
 
 ```powershell
 cd webapp\app
-python -m unittest discover -s tests -q
-npx.cmd playwright test --reporter=dot
+python tools\verify_baseline.py
+python tools\verify_baseline.py --e2e
 ```
 
-JavaScript和Git差异：
-
-```powershell
-cd webapp\app
-$files = Get-ChildItem frontend -Recurse -Filter *.js
-foreach ($file in $files) { node --check $file.FullName }
-cd ..
-git diff --check
-```
+第一条命令已经包含迁移版全量单元测试、API/架构注册表新鲜度、全部前端JavaScript语法、
+Git空白错误和测试数据库只读完整性检查。第二条额外运行Playwright。工具的日常/验收/迁移期
+分类见`app/tools/README.md`；迁移期工具不是正常开发命令。
 
 Playwright需要能够启动本机无头Edge。若测试停在浏览器启动前且没有`msedge`进程，先检查执行
 环境是否禁止GUI/无头浏览器进程；这不是页面失败，不要通过删除测试或延长产品超时绕过。

docs/migration/保真迁移状态.json

@@ -1,6 +1,6 @@
 {
   "schema_version": 1,
-  "updated_at": "2026-07-31T16:10:00+08:00",
+  "updated_at": "2026-07-31T20:57:42+08:00",
   "status": "awaiting_manual_acceptance",
   "migration_mode": "behavior_preserving_source_migration",
   "source_of_truth": "current_original_webapp_runtime_and_source",
@@ -9,10 +9,10 @@
   "failed_roots": [
     "next"
   ],
-  "current_slice": "slice-11-uncertain-code-audit-final-acceptance-handoff",
+  "current_slice": "slice-11-strict-completion-audit-maintenance-handoff",
   "last_completed_slice": "slice-10-frontend-shell-pages-components-css-mobile",
-  "last_automated_slice": "slice-11-uncertain-code-audit-final-acceptance-handoff",
-  "last_checkpoint": "xiaobai-preservation-slice-11-candidate-20260731",
+  "last_automated_slice": "slice-11-strict-completion-audit-maintenance-handoff",
+  "last_checkpoint": "xiaobai-preservation-slice-11-audit-candidate-20260731",
   "next_action": "user_acceptance_on_local_port_8797_then_confirm_or_restore_each_trial_retirement; do_not_switch_docker_or_nas_before_approval",
   "authoritative_documents": [
     "AGENTS.md",

docs/migration/保真迁移账本.md

@@ -1,6 +1,6 @@
 # 小白复盘保真迁移账本
 
-> 当前状态：切片11自动验收完成，等待用户人工验收；正式切换尚未执行
+> 当前状态：切片11严格完成审计通过，等待用户人工验收；正式切换尚未执行
 
 本账本是上下文恢复和人工审计的连续记录。任何迁移提交必须在同一提交中更新本文件及
 `保真迁移状态.json`。
@@ -31,6 +31,7 @@
 | 2026-07-31 | `xiaobai-preservation-slice-09-20260731` | 复盘、自选、交易日志、提醒与复盘助手原实现归位 | 自动、API、数据库、账户隔离与浏览器差分通过，进入切片10 |
 | 2026-07-31 | `xiaobai-preservation-slice-10-20260731` | 前端Shell、页面、CSS、动画与移动端职责归位 | 源码重组、自动、API、数据库、桌面、夜间、移动端与动画差分通过，进入切片11 |
 | 2026-07-31 | `xiaobai-preservation-slice-11-candidate-20260731` | 不确定代码审计、全量验收与人工交接准备 | 自动、API、数据库和浏览器验收通过；等待人工确认，未切换部署 |
+| 2026-07-31 | `xiaobai-preservation-slice-11-audit-candidate-20260731` | 逐项目标审计并修复候选维护工具旧路径 | 302项测试、24个脚本、45项Playwright、21项API与62项schema差分通过；仍等待人工确认 |
 
 ## 资产处置登记
 
@@ -197,12 +198,25 @@
 - 处置：前3类进入可单项回档的候选试删；`wencai_saved_queries`表和方法因旧库兼容与用户隔离继续保留。
 - 保护方式：全部历史前端源码测试统一使用审计白名单比较，只允许登记的原`app.js`行号缺失，其他差异仍会失败。
 - API与数据库：21个全站只读API全部一致；62个schema对象和21张关键表逐行一致。
-- 验收：原版231项、迁移版298项Python测试、24个JavaScript语法检查和45项Playwright（1.6分钟）通过；桌面日间/夜间、390×844五个移动入口和问天三页真实检查通过。
+- 验收：原版231项、迁移版302项Python测试、24个JavaScript语法检查和45项Playwright通过；桌面日间/夜间、390×844五个移动入口和问天三页真实检查通过。
 - 部署边界：未改正式数据库、`.env`、`8765`、Docker或NAS；原版仍是正式运行基线。
 - 候选回档：标签`xiaobai-preservation-slice-11-candidate-20260731`；试删最终结论仍等待用户人工确认。
 - 完整证据：`docs/migration/evidence/slice-11/README.md`。
 - 维护交接：`docs/migration/人工维护与本地切换指南.md`。
 
+严格完成审计补充：
+
+- 发现候选`verify_baseline.py`、架构清单和原样资产清单仍带有旧`static/`、候选`docs/`及
+  `app/app`路径假设；产品运行不受影响，但人工接管命令不可用，因此属于迁移目标缺口。
+- 修复后统一验证命令检查302项Python测试、两个生成注册表、24个前端脚本、Git空白、SQLite
+  完整性和45项Playwright，并在Windows上显式管理8876测试服务器生命周期。
+- 21个固定API使用同一数据库时点重新比较全部一致；数据库62个schema对象和21张关键表一致，
+  仅按既有规则排除内置策略启动校准的`updated_at`。
+- 候选自身的16页、64类路由匹配、36张表、数据/LLM/CSS入口和热点文件登记在
+  `app/config/architecture-inventory.json`；逐项结论见`completion-audit.md`。
+- 严格审计回档标签为`xiaobai-preservation-slice-11-audit-candidate-20260731`。该标签仍不是最终
+  完成标签，未改变试删候选、人工验收和部署切换边界。
+
 ## 决策记录
 
 | 日期 | 决策 | 原因 |