From cda77555b7ae48f5a74c3dcce3f92785d5ae9dba Mon Sep 17 00:00:00 2001 From: lingniu Date: Thu, 16 Jul 2026 15:20:14 +0800 Subject: [PATCH] docs: add vehicle platform meeting goal backlog --- .../vehicle-data-platform-meeting-todo.md | 125 ++++++++++++++++++ 1 file changed, 125 insertions(+) create mode 100644 vehicle-data-platform/docs/vehicle-data-platform-meeting-todo.md diff --git a/vehicle-data-platform/docs/vehicle-data-platform-meeting-todo.md b/vehicle-data-platform/docs/vehicle-data-platform-meeting-todo.md new file mode 100644 index 00000000..1ef6727a --- /dev/null +++ b/vehicle-data-platform/docs/vehicle-data-platform-meeting-todo.md @@ -0,0 +1,125 @@ +# 车辆数据中台会议待办与 Goal 清单 + +更新时间：2026-07-16 + +## 1. 来源与范围 + +本清单综合以下会议纪要和一期建设目标整理： + +- `时生亮发起的视频会议.txt` +- `张兰发起的视频会议_0715.txt` +- 车辆数据中台一期建设目标 + +明确不纳入本 Goal： + +- 车辆锁车、控车和其他远程控制； +- 修改 `ln-asset-management` 现有业务逻辑； +- 伪造或反推无法取得的历史轨迹； +- 本期直接建设原生 App、小程序、维修站预约等尚未定稿的外部端能力。 + +状态定义： + +- `已完成`：代码、部署和基础验证已完成，不再重复开发； +- `待验收`：主要能力已完成，需要业务场景或指定客户验证； +- `进行中`：已有部分能力，但尚未形成完整闭环； +- `待开发`：尚未实现或尚未接入生产； +- `后续规划`：会议提出的演进方向，不作为当前首批交付阻塞项。 + +## 2. 已完成基线 + +以下能力已经完成，后续只做缺陷修复和验收，不重新立项： + +| 编号 | 能力 | 当前结果 | +| --- | --- | --- | +| BASE-01 | 管理员/客户账号登录 | 已支持本地账号、管理员与客户角色、密码策略、失败锁定、会话撤销和审计 | +| BASE-02 | 客户菜单权限 | 客户只能被分配全局监控、车辆查询、轨迹回放、里程查询 | +| BASE-03 | 客户车辆权限 | 管理员可按车牌/VIN 搜索并分配车辆，服务端对车辆查询统一执行 VIN Scope | +| BASE-04 | 全局监控地图/列表双模式 | Web 和移动端均支持地图与列表，车辆点聚合、平滑移动、筛选及详情已上线 | +| BASE-05 | 手机访问入口 | 全局监控支持二维码和访问地址复制，二维码不携带 Token | +| BASE-06 | 里程查询 | 支持多车、日期区间、每日里程矩阵、区间总里程、今天/昨天/近 7 天、分页和 Excel 导出 | +| BASE-07 | 里程数据源策略 | 支持 GB32960、JT808、YUTONG_MQTT 启停和优先级配置；来源含义已说明 | +| BASE-08 | 接入差异列表 | 已按主车辆展示应接协议、实际协议、缺失协议、在线状态和接入证据 | +| BASE-09 | OneOS 只读车辆范围投影 | 已使用专用只读账号和事务事实同步，不修改 OneOS 业务逻辑 | +| BASE-10 | 基础 UI 与移动端适配 | 主要页面已统一视觉体系，并完成常见桌面与移动端尺寸适配 | + +## 3. 当前执行待办 + +### P0：客户可安全交付 + +| 编号 | 状态 | 待办 | 依赖/风险 | 完成验收标准 | +| --- | --- | --- | --- | --- | +| P0-01 | 待验收 | 完成首个真实客户账号的端到端验收 | 需要业务方提供验收客户、车辆清单和菜单清单 | 客户登录后只看到授权菜单；列表、地图、轨迹、里程中的车辆集合一致；客户 A 无法通过 VIN、车牌、URL 或分页访问客户 B 车辆 | +| P0-02 | 待开发 | 补齐客户历史数据的授权时间边界 | 当前车辆授权主要按 VIN 限制；需要明确交付前、还车后历史是否可见 | 轨迹和里程查询同时满足 VIN 与授权有效期；交付前数据不可见；还车后的访问策略有明确产品口径和自动化越权测试 | +| P0-03 | 待开发 | 建立约 20 天缺失里程的可审计补录流程 | 需要 GPS 厂家/原平台导出文件及字段说明；历史轨迹无法补录 | 定义导入模板；按 VIN+自然日+来源+批次幂等；输出成功、重复、冲突、缺 VIN、异常跳变报告；补录前后总量可对账 | +| P0-04 | 进行中 | 固化客户车辆范围与 OneOS 业务范围的映射方式 | 目前支持管理员手工分车，OneOS 范围快照已存在，但账号与业务客户的自动绑定尚未形成完整流程 | 明确 `customerRef/tenantRef` 映射；可选择手工授权或跟随 OneOS 快照；范围变化有审计；失败时不退化为全量车辆 | +| P0-05 | 待开发 | 完成外部身份接入方案并实现一个正式适配器 | 已预留 `IdentityAdapter`，但尚未取得 Yudao Cloud/RuoYi-Sys 的 issuer、JWKS 或 token introspection 契约 | 接入方 Token 必须签名验证或服务端内省；映射到本地用户后仍执行菜单和车辆权限；本地管理员与运维 Token 保留回滚通道 | +| P0-06 | 待验收 | 与秦总/业务负责人完成客户门户验收并冻结首期范围 | 会议要求先出一版再确认；需避免持续扩散范围 | 对登录、授权车辆、实时位置、轨迹、里程、移动端逐项签字；形成问题清单和首期冻结结论 | + +### P1：数据可信与运营闭环 + +| 编号 | 状态 | 待办 | 依赖/风险 | 完成验收标准 | +| --- | --- | --- | --- | --- | +| P1-01 | 进行中 | 为“应接但未接”车辆增加人工处置闭环 | 当前能发现差异，但缺少“无需接入/待接入/异常/已确认”等业务结论 | 每辆差异车可设置处置状态、原因、负责人、备注和更新时间；支持筛选、导出和审计；无需接入车辆不再长期混入异常待办 | +| P1-02 | 进行中 | 统一位置与里程的数据融合策略 | 里程已有可配置优先级；实时位置当前采用服务端固定优先级并有漂移保护 | 形成统一策略模型；管理员可查看全部来源及差异；客户只看到融合结果；来源切换、坐标冲突和里程跳变均保留证据 | +| P1-03 | 进行中 | 完善全局监控列表的管理员溯源视图 | 客户只需关键融合结果；管理员需要查看各来源的客观状态 | 客户列表保持简洁；管理员可展开查看各协议最新时间、位置/里程来源、在线状态和差异原因；不在主列表堆叠无关字段 | +| P1-04 | 进行中 | 完善接入管理的业务筛选维度 | 当前已有协议、厂家、车型、接入/上报时间和状态能力，客户/运营状态仍需统一验证 | 支持按客户、运营状态、厂家、车型、应接协议、实际协议、未接原因组合筛选；统计口径与列表总数一致 | +| P1-05 | 待开发 | 建立正式外部访问域名和内部统一入口 | 需要 DNS、HTTPS 证书和 OneOS 菜单配置权限；不得修改 OneOS 业务逻辑 | 外部客户使用独立 HTTPS 子域名；内部从统一入口新标签页进入；无需记忆 ECS IP；登录回跳和退出行为一致 | +| P1-06 | 待验收 | 完成真实客户移动端可用性验收 | 会议明确客户主要使用手机；需要真实设备和弱网场景 | 在主流手机上完成登录、地图/列表切换、车辆搜索、详情、轨迹、里程查询；关键操作不依赖横屏；无明显卡顿和误触 | + +### P2：统一车辆数字档案 + +| 编号 | 状态 | 待办 | 完成验收标准 | +| --- | --- | --- | --- | +| P2-01 | 后续规划 | 建立“一车穿透到底”的统一车辆详情入口 | 从车辆搜索进入后，可按权限查看基础档案、实时数据、协议来源、告警、轨迹、里程及后续附件/维保/违章等模块 | +| P2-02 | 后续规划 | 扩展角色与字段级展示能力 | 在管理员、内部业务、车队长、客户、司机等角色间控制模块、字段和账单可见性，不仅依赖菜单隐藏 | +| P2-03 | 后续规划 | 对接 App/小程序统一能力 | Web、App、小程序复用同一身份、菜单和车辆 Scope；首期 Web 能力不被重复实现 | + +## 4. 建议执行批次 + +### 批次 A：交付安全闭环 + +1. P0-01 真实客户越权和功能验收； +2. P0-02 历史授权时间边界； +3. P0-04 OneOS 客户范围与平台账号映射； +4. P0-06 业务验收与首期冻结。 + +### 批次 B：历史里程补录 + +1. 获取并固化厂家导出样例； +2. 定义导入模板、校验规则和幂等键； +3. dry-run 生成差异报告； +4. 经业务确认后正式导入； +5. 页面和导出结果对账。 + +### 批次 C：外部正式入口 + +1. P0-05 外部身份适配器； +2. P1-05 HTTPS 子域名和内部入口； +3. P1-06 移动端真实客户验收。 + +### 批次 D：数据治理 + +1. P1-01 接入差异处置； +2. P1-02 统一融合策略； +3. P1-03 管理员溯源列表； +4. P1-04 业务筛选维度。 + +## 5. Goal 完成条件 + +本 Goal 只有在以下条件全部满足后才可标记完成： + +1. 所有 P0 项均为“已完成”，并有测试或业务验收证据； +2. 所有 P1 项均为“已完成”，或由业务负责人明确书面降级到后续范围； +3. 历史里程补录具备来源文件、批次记录、差异报告和回滚/重跑能力； +4. 至少完成两个互斥客户账号的自动化越权测试； +5. 外部客户不通过 ECS IP 或运维 Token 使用平台； +6. 生产部署、配置、数据口径和运维说明同步更新； +7. 不修改 `ln-asset-management` 现有业务逻辑； +8. 无车辆锁车、控车能力进入本次交付。 + +## 6. 已知产品边界 + +- 会议已确认：缺失历史里程可以从厂家平台补录，但历史轨迹拿不到就不补造； +- 客户门户默认展示融合后的统一位置和里程，管理员保留查看多来源证据的能力； +- 移动端首期继续使用响应式 Web 和二维码入口，App/小程序统一方案后续再定； +- 外部身份系统只负责证明用户身份，最终菜单和车辆数据权限仍由车辆数据中台强制执行。