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

小白复盘保真迁移账本

当前状态：正式迁移，切片00“原样可运行副本”已完成

本账本是上下文恢复和人工审计的连续记录。任何迁移提交必须在同一提交中更新本文件及 保真迁移状态.json。

固定事实

• 原版根目录是唯一产品和视觉基线。
• next/已被用户否决并冻结，不进入后续迁移。
• 新目标目录由用户批准为app/，最终作为正式程序目录。
• 后续采用原代码保真式迁移，不重新实现，不更换技术栈。
• 2026-07-30用户授权在既定约束内自主完成全部迁移，阶段性差异仍必须阻断后续切片。

当前检查点

日期	提交或标签	事件	结论
2026-07-30	xiaobai-next-rejected-20260730	冻结失败的next/实现	禁止部署或继续开发
2026-07-30	xiaobai-preservation-migration-charter-20260730	建立保真迁移总纲、状态和恢复协议	尚未开始新迁移
2026-07-30	41329943c4878fc09ed82ec376eb93ab151e4092	完成只读资产清查并由用户批准app/结构	开始切片00

资产处置登记

开始清查后，每个资产必须登记，禁止只记录已迁移项而遗漏未处理项。

原位置/符号	类型	消费者	处置	新位置	等价证据	状态
原版运行源文件（排除next/、日志、缓存、构建产物和正式数据库）	运行资产	全站	原样保留后逐项移动	app/	388项受控资产哈希一致；231项Python与45项Playwright测试通过	已复制
next/	失败实现	无正式消费者	原样保留但禁止迁移	-	用户冻结决定	已冻结
demo_data.py	疑似旧兼容代码	未发现运行导入	待定	待删隔离账本	静态扫描不足以授权删除	保留
static/heaven-loading.js	疑似旧动画	当前页面加载heaven-loading-v2.js	待定	待删隔离账本	仍需动画运行覆盖	保留
commonReviewColumns等5个前端函数	疑似无引用符号	未发现静态调用	待定	待删隔离账本	仍需动态注册与浏览器覆盖	保留
wencai_saved_queries及其方法	历史兼容数据	当前无前端入口	待定	数据库兼容区	不允许在迁移期破坏旧库	保留
现有7层CSS	视觉运行资产	全部页面和主题	原样保留后逐页归档	app/frontend/	必须通过截图与计算样式差分	保留

处置只允许：原样保留、移动、合并重复、待定、确认废弃。

切片记录

每个切片记录以下内容：原版基线、复制范围、必要路径调整、差异测试、人工验收、未关闭问题和回档提交。 已完成切片：slice-00-exact-runtime-copy。

• 原版基线：提交41329943c4878fc09ed82ec376eb93ab151e4092。
• 复制范围：确认参与运行、测试、部署和维护的原版文件；排除next/和运行产物。
• 允许改动：新目录中的路径配置、测试根目录和端口；不得改业务实现。
• 验收：新目录独立启动，231项Python测试、45项Playwright测试、数据库副本和静态资产哈希验证。
• 回档：本切片建立独立Git提交并推送Gitea。
• 完整证据：docs/migration/evidence/slice-00/README.md。
• 资产清单：docs/migration/原版资产清单.json，388项，0项哈希差异。

决策记录

日期	决策	原因
2026-07-30	原版运行行为优先，规格书只用于盘点	防止再次依据文字重新开发
2026-07-30	不使用next/作为后续迁移起点	用户确认其视觉、布局和基础功能不可用
2026-07-30	目标结构确认前不创建业务目录	防止目录先行后再次补写功能
2026-07-30	目标目录确定为app/	使用长期正式名称，不再建立新的版本式重写目录
2026-07-30	先建立原样可运行副本，再迁移目录职责	保证整理的是原件，而不是依据规格书重新实现
2026-07-30	不确定代码进入待删账本并延迟试删	删除必须能够单独回档并经自动与人工验收

恢复工作检查

• 已阅读AGENTS.md与保真迁移总纲。
• 已读取状态JSON和本账本最后一项。
• 已确认Git工作区和基线提交。
• 已确认没有修改next/或正式数据。
• 已说明当前切片及新旧等价证据。
• 已在编辑前确认没有未关闭差异。