126 lines
9.0 KiB
Markdown
126 lines
9.0 KiB
Markdown
# 车辆数据中台会议待办与 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/小程序统一方案后续再定；
|
||
- 外部身份系统只负责证明用户身份，最终菜单和车辆数据权限仍由车辆数据中台强制执行。
|