TR069 2026-03-24 执行清单

目标

今天的核心目标不是继续扩新功能，而是把平台从“本地可用”推进到“部署态可验证”。

完成标准：

  1. 前端成功构建并可上传。
  2. 后端成功编译 Linux 可运行二进制。
  3. 上传部署后服务可启动。
  4. TR069 核心页面可访问。
  5. 至少完成一轮 TR069 冒烟验证。
  6. 若出现问题，按优先级分类修复并记录结果。

一、今天执行清单

1. 打包前本地检查

前端

  • 进入前端目录。
  • 运行依赖检查。
  • 运行类型检查。
  • 运行生产构建。
  • 确认 dist 构建产物生成。
  • 记录构建 warning，重点关注静态资源路径、自动导入、路由异常。

建议命令：

cd /Applications/chuanghui/billing/vue-admin
npm install
npm run type-check
npm run build

后端

  • 进入后端目录。
  • 运行 TR069 核心详情回归测试。
  • 编译 Linux 目标二进制。
  • 确认生成 billingChuanghui 文件。
  • 检查配置、resource、日志目录是否齐全。

建议命令：

cd /Applications/chuanghui/billing/gf-server
go test ./internal/app/system/service -run 'TestTr069DeviceInfoIncludes(CompatibilityMappingsForACSKeys|DriftedCompatibilityMappingsForACSKeys|VerifiedCompatibilityMappingsForWifiAndPPPoE|DriftedCompatibilityMappingsForWifiAndPPPoE|MissingProbeCompatibilityMappings|SkippedByDesignCompatibilityMappings)$' -count=1
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o billingChuanghui main.go

上传物准备

  • 前端上传物：dist
  • 后端上传物：billingChuanghui
  • 配置文件准备齐全
  • resource 目录是否需要同步
  • 数据库连接、域名、Nginx、日志目录已确认

2. 上传部署检查

前端上传

  • 上传 dist 到目标静态目录。
  • 确认 Nginx 指向新的前端静态资源目录。
  • 刷新页面确认无空白页、404、静态资源加载失败。

后端上传

  • 上传 billingChuanghui 二进制。
  • 上传配置文件。
  • 上传必要的 resource 目录。
  • 重启服务。
  • 查看启动日志。

启动后立即验证

  • 后端进程存在。
  • API 可访问。
  • 前端首页可访问。
  • 登录正常。
  • TR069 设备页可打开。
  • TR069 任务页可打开。

3. TR069 冒烟验证

设备列表

  • 设备列表加载正常。
  • compatibility 状态显示正常。
  • fingerprint、rootModel、verifyResult 展示正常。

设备详情

  • compatibility 区块正常加载。
  • probeResults 正常展示。
  • mappings 正常展示。
  • verifyStatus 正常。
  • verifyMessage 正常。
  • 主建议动作区域正常。

核心动作

  • 生成映射草稿可正常执行。
  • 补回读动作可正常执行。
  • 重新下发动作可正常执行。
  • 至少实际执行一个动作并观察结果。

ACS / 设备联调

  • cwmp 接口可达。
  • 后端日志能看到 TR069 请求。
  • 若现场设备条件具备，完成一轮真实上报或回读验证。

4. 问题处理顺序

遇到问题时，不要乱修，按下面顺序推进：

第一优先级：构建问题

  • 前端 type-check 报错
  • 前端 build 失败
  • 后端 build 失败

第二优先级：启动问题

  • 服务起不来
  • 配置文件缺失
  • 数据库连接失败
  • 端口占用
  • Nginx 反代错误

第三优先级：页面问题

  • 空白页
  • 静态资源 404
  • 接口 404/500
  • 权限或菜单异常

第四优先级：TR069 业务问题

  • 设备详情 compatibility 不显示
  • mappings 或 probeResults 缺失
  • verifyStatus 异常
  • 推荐动作点击报错
  • 任务创建或状态流转异常

第五优先级：实机联调问题

  • ACS 请求未进入
  • 设备不回读
  • 漂移判定异常
  • 路径映射不收敛

5. 今天收工前必须产出

  • 一次成功的前端构建
  • 一次成功的后端 Linux 编译
  • 一次上传部署记录
  • 一轮 TR069 冒烟结果
  • 一份问题清单

问题清单建议按三类整理：

  1. 已修复
  2. 不阻塞上线
  3. 阻塞上线

二、后续执行清单

1. 兼容运营视角

这是当前平台最值得继续补的一层，不是单设备诊断，而是平台级运营视角。

  • 增加 compatibility 总览接口
  • 增加问题类型聚合
  • 增加 fingerprint 维度聚合
  • 增加 drifted / missing_probe / skipped_by_design 设备统计
  • 增加待处理设备数

兼容矩阵沉淀

  • 每个 fingerprint 的覆盖设备数
  • 每个 fingerprint 的验证状态分布
  • 每个 fingerprint 的主问题键分布
  • verified / limited / draft 状态管理
  • 新型号准入标准固化

2. 型号准入流程

当前平台已有能力基础，但还没有完全平台化。

  • 设备首次上报识别
  • 未识别设备标记
  • 触发探测模板
  • 自动生成映射草稿
  • 执行验证模板
  • 归档到 fingerprint
  • 标记支持等级

准入标准建议

  • 探测模板齐全
  • 参数映射可生成
  • 写后校验能闭环
  • 详情诊断可解释
  • 至少一轮实机验证通过

3. 批量闭环能力

平台要从“人工点设备处理”走向“批量收敛”。

  • 按 fingerprint 批量补回读
  • 按问题类型批量补回读
  • 按 drifted 批量重新下发
  • 按未建映射批量生成草稿
  • 批量动作结果反馈

批量结果追踪

  • 动作前后问题数量变化
  • 漂移收敛率
  • 未回读收敛率
  • 未建映射减少数

4. 跨页面一致性

这一层决定平台是否“成熟”。

  • 设备列表 compatibility 状态和详情一致
  • 任务页验证结果和详情一致
  • 自动回读状态与设备最近自愈展示一致
  • 相同问题在不同页面不换一种说法

一致性测试补齐

  • 列表页状态展示测试
  • 详情页诊断展示测试
  • 任务页状态展示测试
  • 共享 helper 统一测试

5. 实机联调与验收

这是最终上线前必须补齐的一层。

  • 至少覆盖几类主流设备
  • TR098 / TR181 各有样本
  • common / vendor 差异有样本
  • ACS URL / WiFi / PPPoE / VLAN 均验证过

验收标准

  • 能识别设备
  • 能探测能力
  • 能生成映射
  • 能写入业务
  • 能回读验证
  • 能在页面解释问题

三、今日执行口径

建议今天按这条主线推进：

  1. 上午完成前后端构建和上传部署。
  2. 中午前确认后台与 TR069 页面可访问。
  3. 下午完成一轮设备与任务冒烟。
  4. 剩余时间按阻塞级问题优先修复。

如果时间不够，优先顺序固定为：

  1. 打包成功
  2. 上传成功
  3. 后台可访问
  4. TR069 页面可用
  5. 一轮冒烟
  6. 修最阻塞的问题
作者：wuge  创建时间：2026-03-24 15:12
最后编辑：wuge  更新时间：2026-03-24 15:12