5.1团队拓扑
建议采用"平台研发组 + 算法团队 + 业务方"的三方结构。平台组是总集成方，对交付负总责；算法团队是能力供应方；业务方是验收标准与签认方。
必须新增/指定的角色：三维引擎工程师 1 人（专职）。职责：3DGS 成果渲染管线（.splat/.3dtiles 加载）、轻量 Cesium 集成、点云/模型/GIM 线框三图层叠加与拾取。算法团队不能替代——平台侧的渲染集成、坐标转换、前端性能是本平台命脉。Cesium 按"轻量"引入：1 人、2–4 人周完成集成与瓦片加载封装，不深做生态。
5.2角色与编制
| 角色 | 人数 | 核心职责 | 关键产出 | 能力要求 |
|---|---|---|---|---|
| 项目经理 / 总集成 | 1 | 范围、进度、资源、跨团队协调、验收 | 项目计划、风险登记册、周报 | 电网行业经验、跨团队推动力 |
| 产品经理 / 验收业务专家 | 1 | 流程、规则、原型、用户验收 | PRD、408 项规则口径、原型 | 懂输变电验收规范 |
| 架构师 / 后端负责人 | 1 | 架构、数据模型、集成、代码评审 | 架构文档、核心服务 | Java + 空间数据 + 集成 |
| 后端工程师 | 2 | 业务模块、任务网关、报告/归档 | API、服务、单测 | Spring Boot、PG、消息 |
| 前端工程师 | 2 | 业务页面、组件、报告、权限 | Web 应用、组件库 | Vue 3 + TS + 可视化 |
| 三维引擎工程师 | 1 | 3DGS/点云/GIM 渲染、坐标、拾取、量测 | SceneAPI、渲染内核 | Cesium/Three/WebGL/图形学 |
| 测试 / 质量工程师 | 1–2 | 测试设计、自动化、性能、验收 | 测试报告、自动化用例 | 接口/UI/性能测试 |
| 实施 / 交付工程师 | 1 | 部署、数据迁移、培训、试运行 | 部署手册、培训材料 | Linux、中间件、客户沟通 |
| 安全 / 运维（共享） | 0.5 | 等保、审计、监控、备份 | 安全方案、运维手册 | 等保三级、国密 |
| 算法接口人（外部） | 1 | 算法交付、版本、质量、联调 | 算法服务、质量元数据 | 3DGS/点云/配准 |
| GIM 工具负责人（外部） | 0.5 | 解析工具、schema、问题修复 | CLI/服务、输出样例 | GIM 格式、工程模型 |
| 业务接口人（业主/监理） | 2 | 标准解释、抽检、签认 | 验收意见、签署 | 验收规范、现场经验 |
平台组编制
9–11人
峰值 +2 外包测试
关键稀缺角色
1人
三维引擎，必须专职
外部接口人
4人
算法 / GIM / PMS / 资产
5.3RACI 矩阵
R = 执行，A = 最终负责，C = 被咨询，I = 被告知。每项工作只能有一个 A，否则一定扯皮。
| 工作项 | 项目经理 | 产品/业务 | 架构/后端 | 前端 | 三维 | 测试 | 算法 | 业主/监理 |
|---|---|---|---|---|---|---|---|---|
| 范围与里程碑 | A | C | C | I | I | I | C | C |
| 验收规则口径 | I | A | C | I | I | C | I | R |
| 架构与接口契约 | I | C | A | R | R | C | R | I |
| 数据导入与质检 | I | C | A | R | C | C | I | I |
| 算法任务网关 | I | I | A | C | C | R | R | I |
| 三维渲染与量测 | I | C | C | R | A | R | C | I |
| 指标核验引擎 | I | R | A | R | C | R | C | C |
| 缺陷闭环 | I | A | R | R | I | R | I | C |
| 报告与资产包 | I | C | A | R | C | R | I | R |
| 等保与安全 | A | I | R | C | I | C | I | C |
| 上线与试运行 | A | C | R | I | I | R | I | C |
建议把这张表打印出来贴在会议室。出现争议时，先看"A 是谁"，再看"契约怎么写"。
5.4跨团队交接物
交接物必须"可验收"：有格式、有样例、有校验脚本、有责任人。口头交接等于没交接。
| # | 交接物 | 从 → 到 | 时机 | 格式 / 内容 | 验收标准 |
|---|---|---|---|---|---|
| 01 | 工程主数据模板 | 产品 → 业主 | W1 | Excel / JSON Schema：工程、标段、单位工程、电压等级 | 字段齐全、编码规则确认 |
| 02 | 验收标准集 | 业主/监理 → 产品 | W1 | 408 项指标、限值、量测方法、取严规则 | 逐条签字确认 |
| 03 | 采集数据包 | 采集方 → 平台 | 每周 | 影像 / LAS / 控制点 / 航线 / SLAM 记录 + 清单 | 覆盖率 ≥ 98%、残差 ≤ 20 mm |
| 04 | 算法任务 Schema | 平台 → 算法 | W1 冻结 | JSON Schema + OpenAPI + 样例 + Mock | 双方联调通过 |
| 05 | 算法能力清单 | 算法 → 平台 | W1 | 能力、版本、参数、输入输出、耗时、GPU 需求 | 可被网关枚举 |
| 06 | 重建成果 | 算法 → 平台 | 任务完成 | PLY/LAS/3D Tiles + manifest + 质量元数据 | Schema 校验 + 哈希一致 |
| 07 | GIM 解析输出 | 工具 → 平台 | W2 | tree/props/geojson/glb/mapping + manifest | 构件数、编码、CRS 一致 |
| 08 | 坐标转换参数 | 采集/设计 → 三维 | W2 | EPSG、中央经线、原点、旋转、尺度 | 控制点复核 ≤ 10 mm |
| 09 | PMS/EAM 字段映射 | 业主 → 后端 | W3 | 设备编码 ↔ 资产编码 ↔ GIM 构件编码 | 抽样 100 条一致 |
| 10 | 规则库 v1 | 产品 → 测试/后端 | W4 | 408 条 DSL + 期望结果 | 金标准数据回归通过 |
| 11 | 三维瓦片包 | 算法 → 三维 | M2 | 3D Tiles / splat / potree，含 LOD 与包围盒 | 首屏 ≤ 8 s |
| 12 | UI 设计稿 / 原型 | 产品 → 前端 | 每 Sprint | Figma / HTML 原型 + 交互说明 | 走查通过 |
| 13 | 接口 Mock | 后端 → 前端 | 每 Sprint | OpenAPI Mock + 场景数据 | 前端可独立联调 |
| 14 | 测试数据集 | 业务 → 测试 | M2 | 试点工程全量数据 + 已知答案 | 可重复执行 |
| 15 | 性能基线 | 三维/测试 → PM | M4 | 1 亿点场景、帧率、首屏、内存 | 达标或给出降级方案 |
| 16 | 资产包 Manifest | 平台 → 资产中心 | M5 | 9 类成果 + 哈希 + 签名 + 校验工具 | 离线校验通过 |
| 17 | 部署包 / 镜像 | 平台 → 运维 | M4 | Compose / 镜像 / SBOM / 许可证清单 | 离线环境可部署 |
| 18 | 培训与手册 | 实施 → 用户 | M5 | 管理员/验收员/监理三套材料 | 考核通过率 ≥ 90% |
5.5契约先行工作流
跨团队协作最有效的动作：先把接口写成可执行的契约，再各自开发。以下流程建议每个接口都走一遍。
1
场景对齐
输入/输出/异常
2
写 Schema
JSON Schema
3
样例 + Mock
正例/反例
4
双方评审
签字冻结
5
并行开发
各自 Mock
6
联调
契约测试
7
版本发布
兼容期
契约测试
用同一份 JSON Schema 校验双方实现，CI 失败即阻断合并。
版本兼容
字段只增不删；删除走 deprecated → 两个大版本后移除。
变更流程
提 RFC → 影响分析 → 双方确认 → 更新 schema → 更新样例。
算法团队联调的三条"硬约定"
| 约定 | 具体做法 | 违反后果 |
|---|---|---|
| 成果先落对象存储 | 算法侧拿到预签名 URL，直接上传；回调只传 manifest，不传大文件 | 平台不代理大文件，违反则联调失败 |
| 每次任务必须带版本 | algoVersion + imageDigest + paramsHash 写入 manifest | 无法复现，成果拒收 |
| 质量元数据先于成果 | manifest 先校验，通过后才允许登记成果 | 元数据缺失 = 成果不存在 |
5.6协作节奏
固定节奏
| 会议 | 频率 | 参与者 | 产出 |
|---|---|---|---|
| 站会 | 每日 15 min | 平台组 | 阻塞项、今日目标 |
| 接口对齐会 | 每周二 | 平台 + 算法 + GIM | 契约变更、联调问题 |
| Sprint 评审 | 双周 | 全体 + 业务 | 可演示增量 |
| 业务规则评审 | 每周四 | 产品 + 监理 | 规则口径确认 |
| 风险复盘 | 每两周 | PM + 负责人 | 风险登记册更新 |
| 阶段门评审 | G0–G5 | 全体 + 业主 | 放行 / 整改 |
沟通渠道与响应 SLA
| 接口阻塞 | 专用群 + @接口人 | 2 h 响应 |
| 线上故障 | 电话 + 工单 | 15 min 响应 |
| 契约变更 | RFC 文档 | 24 h 评审 |
| 一般问题 | 工单 / 群 | 1 个工作日 |
| 数据问题 | 工单 + 样例 | 4 h 定位 |
原则：所有决策留痕。群里说"可以"不算数，必须在 RFC / 工单 / 会议纪要里落字。
周冻结机制（建议写进项目章程）
| 周次 | 冻结内容 | 责任人 | 不冻结的后果 |
|---|---|---|---|
| W1 | 算法任务 Schema + 能力清单 | 架构 + 算法接口人 | 网关无法开发，全部阻塞 |
| W1 | 工程主数据字段与编码规则 | 产品 + 业主 | 数据模型反复改 |
| W2 | GIM 解析输出 Schema | GIM 负责人 + 三维 | 构件映射无法开始 |
| W3 | 408 项指标规则 v1 | 产品 + 监理 | 引擎无法验收 |
| W3 | PMS/EAM 字段映射 | 业主信息中心 | 台账同步延期 |
| W4 | 资产包 Manifest v1 | 架构 + 资产中心 | 归档返工 |
5.7完成定义 DoR / DoD
DoR · 进入开发前必须满足
业务场景清楚
谁在什么情况下做什么，异常怎么处理。
验收标准可测
不是"体验好"，而是"P95 ≤ 300 ms"。
接口契约已冻结
Schema + 样例 + 错误码。
数据样例可用
至少一套脱敏真实数据。
依赖方已确认
算法/GIM/PMS 的时间与责任人明确。
DoD · 声称"完成"前必须满足
代码合并 + 评审通过
至少 1 名同模块 reviewer；无高危告警。
单测 / 契约测试通过
新增逻辑覆盖率 ≥ 70%。
联调通过
真实接口，不是 Mock。
可观测就绪
日志、指标、traceId、告警。
文档更新
API、部署、用户手册、变更记录。
反模式："功能做完了，就差联调"——这不是完成，是 50%。跨团队项目里，联调与异常处理往往占一半工作量，必须计入排期。
5.8分支、发布与环境
分支策略
Trunk-based：main 保护 + 短分支（≤ 2 天）+ PR。Release 分支仅用于版本冻结，不长期维护。
版本号
语义化 MAJOR.MINOR.PATCH；接口版本独立；数据库迁移与代码同版本发布。
发布窗口
每周二/四 16:00；重大变更周五冻结；回滚脚本必须同批交付。
| 环境 | 用途 | 数据 | 更新频率 | 访问 |
|---|---|---|---|---|
| DEV | 开发自测 | Mock / 小样例 | 每次提交 | 研发 |
| INT | 联调（算法/GIM/PMS） | 脱敏试点数据 | 每日 | 研发 + 外部接口人 |
| UAT | 业务验收 | 试点工程全量 | 每周 | 业务 + 监理 |
| STG | 预生产 / 性能 | 脱敏全量 | 每周 | 测试 + 运维 |
| PRD | 生产 | 真实数据 | 按发布窗口 | 全员（权限控制） |
数据红线：生产数据不得复制到 DEV/INT；UAT/STG 必须脱敏（坐标偏移、设备编码替换）。违者按安全事故处理。
5.9升级路径与七个坑
升级路径（Escalation）
L1
接口人
2 h 响应
L2
模块负责人
4 h
L3
项目经理
1 个工作日
L4
双方管理层
3 个工作日
L5
业主决策
里程碑会议
触发条件：接口阻塞 > 4 h、关键路径延期 > 2 天、数据质量争议、范围变更、安全事件。
| # | 协作中的坑 | 典型表现 | 对策 |
|---|---|---|---|
| 01 | "我们以为你们会做" | 算法以为平台做坐标转换，平台以为算法输出已转好 | 交接物写明责任；CRS 作为必填字段，缺失拒收 |
| 02 | 口头改接口 | "我加了个字段，你那边兼容一下" | RFC + schema 版本 + 契约测试 |
| 03 | 算法成果不可复现 | 没有版本、没有参数、没有镜像 digest | algoVersion + paramsHash 强制写入 |
| 04 | 业务规则迟到 | 开发完了才说"这个限值要按电压等级" | W3 冻结 408 项规则；变更走影响分析 |
| 05 | 三维性能最后才测 | 演示当天才发现 1 亿点打不开 | M4 性能专项前置；每周跑基准场景 |
| 06 | 等保材料后补 | 上线前发现没有审计日志 | 审计、鉴权、加密在设计阶段就落 |
| 07 | 外部环境不可用 | PMS 接口申请了两个月 | W2 前锁定；先做 Mock + 适配器，随时切换 |