docs: record Apple design production verification and rollback

2026-09-17 18:53:49 +08:00
parent 39d9cb5403
commit 6cc872ceb6
1 changed files with 37 additions and 0 deletions
@@ -0,0 +1,37 @@
+# Apple Design 发布验收
+
+发布版本：`apple-design-202609171849`，时间：2026-09-17 18:49–18:54（Asia/Shanghai）。
+
+## 范围
+
+现有九个业务入口、共享导航和帮助、桌面/手机查询与详情界面。采用系统字体、中性表面、清晰层级、克制蓝色动作与状态色；精简重复说明，优化密集表格和手机操作区。三个子代理分别负责数据页、治理页、地图/轨迹页，主代理统一设计和逐页验收。
+
+UI源码提交：`39d9cb54`，分支 `codex/apple-design-20260917`，已推送origin。最终发布Tag：`apple-design-20260917-1849`。
+
+## 前置回退保障
+
+改造前完整代码快照提交 `f7e7176f88b4fd49338dda8e72d701a24617fb2f` 已推送；回退Tag `pre-apple-design-20260917-1805` 已核对远端存在。线上应用与配置归档位于 `/opt/lingniu-vehicle-platform/backups/pre-apple-design-202609171805/`，发布前 SHA256SUMS 两项再次校验成功。详情见 [回退基线](rollback-baseline.md)。
+
+## 自动化与构建
+
+- 完整Web测试：79个文件542项通过。
+- 后续改动：AppShell、Alerts、Track、Operations共88项通过；最后事件表格滚动修复后Alerts49项通过。
+- 最终 `npm run build`（TypeScript、Vite、prepare-dist、verify-build）通过，84个发布资源验证通过。
+- `git diff --check`通过。
+- Web归档SHA-256：`af53ef1f1364a756c2300d1bafa3ac726aea8cd43ff1f7c1f915704532be91c9`。
+
+## 生产发布与核验
+
+- 使用现有原子发布脚本，仅传Web归档；当前目录为 `/opt/lingniu-vehicle-platform/releases/apple-design-202609171849`。脚本具备失败自动切回旧版本机制。
+- 安装门禁通过：84个当前资源、132个兼容资源；公开HTTPS入口复验通过；保留3代兼容资源，未裁剪历史release。
+- API、流式告警、规则告警三个服务均active。API、alert-stream-evaluator、alert-evaluator文件哈希与前版相同。前版没有独立alert-notification-dispatcher文件，因此发布后附加校验曾在检查此可选文件时报FileNotFoundError；安装已经成功，此错误不代表安装回滚或服务失败。
+- 正式HTTPS健康接口返回新版本；逐项检查当时51条原生告警的列表标题和详情一致，均有具体名称（48条绝缘，1条SOC跳变，1条SOC低，1条仅等级且明确标注未上报具体项）。
+- 线上浏览器逐页加载九个入口并检查实际画面：事件具体告警详情、车辆目录、账号目录、接入来源、历史查询、里程矩阵、轨迹查询、运维队列、监控地图。证据为 `outputs/apple-design-20260917/after/44-production-native-detail.png` 至 `52-production-monitor.png`。
+- 生产车辆分页从1/103切换至2/103；历史导出任务中心打开并显示已有66个任务；里程矩阵可区分无数据与数值；监控显示实际14个省级区域880辆有定位；生产浏览器本次采集的error日志为空。
+- 未改动业务数据、告警定义、来源优先级或客户权限。未触发通知、归档或生产批量处置。地图逐帧播放、查询、抽屉和手机菜单交互在本地mock另行验证，详细边界见 [UI审查](ui-review.md)。
+
+## 回滚
+
+前版 `native-alarm-details-202609171739` 及独立备份保留。将current原子指回该release并恢复对应PLATFORM_RELEASE后重启平台API即可恢复此前前端；本轮没有数据库迁移。需要源代码时从 `pre-apple-design-20260917-1805` 创建修复分支。
+
+构建、测试、部署、原生告警核验日志存于本地 `outputs/apple-design-20260917/`。包含车辆信息的截图与配置备份不推送到Git。