2026-06-11 排序数据 QA

用户目标

为 7.9.0 容器内 App 手动排序准备数据层 QA 和回归入口。要求新增可从 src 目录运行的轻量脚本，覆盖旧 JSON decode、新字段 roundtrip、containerAppOrder 指纹与导入导出相关静态断言；不改 AppGrid UI，不改 DataLayer 实现。

已完成事项

• 新增 src/Scripts/app_ordering_data_qa.sh。
• 在 docs/7.90/04-QA测试用例集.md 的自动化脚本列表中加入 bash Scripts/app_ordering_data_qa.sh。
• 脚本可从 /Users/ar/Projects/Taglauncher/src 运行，不依赖 GUI。

关键决策

• 当前数据层实现尚未包含 containerAppOrder，脚本先作为门禁脚本落地，缺失关键符号时返回 FAIL。
• QA 脚本采用 Python 解析 Swift 源码块，避免只用零散字符串搜索造成误判。
• 不修改 src/Apptag/DataLayer.swift、AppGrid UI 或其他实现文件。

文件变更

• src/Scripts/app_ordering_data_qa.sh
• 检查 TagDatabase.Store.containerAppOrder 持久化字段、CodingKeys、decodeIfPresent 默认空字典。
• 检查自定义 encode(to:) 如存在必须编码 containerAppOrder。
• 检查 CategorySchemeFingerprint 和 categorySchemeFingerprint(for:) 包含并读取 store.containerAppOrder。
• 检查 exportTo、importFrom、backup、restore 使用完整 Store 编码/解码。
• 包含旧 JSON 与新 JSON 的内联轻量 fixture 形状检查。
• docs/7.90/04-QA测试用例集.md
• 自动化入口新增 bash Scripts/app_ordering_data_qa.sh。

验证结果

• bash -n src/Scripts/app_ordering_data_qa.sh 通过。
• cd /Users/ar/Projects/Taglauncher/src && bash Scripts/app_ordering_data_qa.sh 当前按预期失败：
• FAIL: Store must persist containerAppOrder as [String: [String]] with an empty default

未决问题

• containerAppOrder 数据层实现尚未完成，脚本仍处于预期失败状态。
• 脚本当前覆盖静态数据层门禁，不覆盖 GUI 拖拽、真实 App Grid 渲染、拖拽取消、跨容器交互、SmartStart replace 的运行时语义。
• 工作区存在其他线程/用户改动：docs/index.html、src/Apptag/DataLayer.swift、Docs/KM02-技术/。本轮未回滚、未修改这些无关 dirty 内容。

后续建议

• DataLayer 实现补齐后重新运行 bash Scripts/app_ordering_data_qa.sh，确保门禁转为 PASS。
• 后续可增加针对排序 merge/清理策略的轻量 Swift 或 fixture 级测试，覆盖卸载 App、新 App 追加、tag rename/delete/relocalize、reset/SmartStart replace 的语义。