首页 / 落地计划 / 多团队研发专项拆解清单

使用边界与状态规则

本页将 专项/独立设备安防平台-多团队研发专项拆解清单.md 细化为跨团队协作索引:每项专项都明确目标、责任边界、依赖、可交付物与验收证据。它是研发拆解和评审依据,不等同于当前代码、服务或设备已具备的能力。

原文的引言写“十个核心专项”、App 段落写“五大专项”,但实际标题列出 12 个平台/设备专项与 6 个 App 专项;本页以实际标题为准。涉及容量、延迟、供应商、法规或产品模式的目标,进入排期前须由架构、法务、产品和运行证据复核。

状态含义更新前提
[ ] 未开始范围与负责人已确认,尚未进入实施必须已有输入、输出和依赖说明
[~] 进行中设计或实现正在推进附任务链接、当前风险与下一项验收动作
[!] 阻塞被契约、环境、供应商、合规或资源卡住写明阻塞方、解除条件与临时降级方案
[x] 已验证在目标环境完成联合验收附版本、构建/测试、运行截图或审计记录;不能只勾选 Markdown

平台与设备 12 项专项

建议一个专项建立一个 Epic;下面的“责任团队”是主责域,不排除测试、产品、安全、运维共同签收。专项之间的接口以版本化 Proto/OpenAPI/Schema/Topic 与样例报文冻结,禁止仅用口头约定联调。

专项 / 主责目标与范围输入依赖可交付物最低验收证据
01 设备连接与接入引擎
Go、嵌入式通信
多协议接入、会话状态、指令分发、设备影子、弱网重连与设备身份安全。设备协议 Profile、证书/密钥策略、Redis 与消息基础设施。编解码器、会话/影子状态机、QoS 与离线补偿、限流与 mTLS 策略。真实设备及模拟压测;断网/重连/重复包/乱序包;鉴权、Topic、指令回执和容量指标。
02 时空计算与轨迹处理
Go、地理数据
GPS 清洗、抽稀、围栏、行程/停留聚合,并分离业务元数据与时序数据。定位协议、坐标/时间语义、数据保留与删除策略、时序库选型。清洗/抽稀管道、地理索引、围栏事件、Trip 聚合和数据写入适配器。基准轨迹回放;漂移/跨时区/乱序验证;围栏误报漏报率、查询性能、幂等与回放结果。
03 低延迟媒体与边缘 AI
媒体、C++/Go、算法
WebRTC 信令/路由、弱网自适应、事件录像、对象存储与图像隐私处理。设备媒体能力、区域网络、鉴权会话、对象存储、隐私与存储模式决策。信令/API、ICE/STUN/TURN 策略、码率/降级策略、录像切片和脱敏流水线。真机首帧/卡顿/降级测试;授权/撤权;本地 microSD 与云存储模式隔离;脱敏、留存与审计。
04 计费、订单与商城
Java、财务对账
支付、订阅、权益、税费、商品适配、库存与渠道订单协同。支付商合同/回调、商品与税务规则、身份/权益模型、渠道 OAuth。订单/订阅状态机、Webhook 幂等、对账任务、SKU/适配模型、渠道同步。沙箱支付和重复回调;退款/续费/扣款失败;权益一致性、账务差异处理和权限回收。
05 隐私合规与零信任审计
安全、DPO、Java、法务
区域数据主权、PII 保护、访问控制、删除链路、审计与明文访问审批。数据地图、数据分类、区域部署边界、KMS/Vault、法规确认。区域路由、加密/脱敏组件、删除编排、RBAC/审批、不可抵赖审计。EU/US 隔离演练;密钥轮换和脱敏测试;从业务库/时序库/对象存储的删除闭环;审计抽查。
06 规则、告警与推送
Java、Go
WHEN-THEN 编排、事件抑制合并、风险升级及 WebSocket/Push/SMS 通道。统一事件模型、用户权限、时区、地理围栏、通知供应商与模板。规则 DSL/配置、执行器、幂等键、告警状态机、通道适配器与回执归档。同事件重复/乱序;规则命中解释;Push→SMS→电话升级;失败重试、取消与送达回执。
07 OTA、运维与设备诊断
Go、SRE、固件
固件生命周期、灰度/回滚、时区静默窗口、断点下载与远程日志。设备型号/固件兼容矩阵、签名密钥、CDN/对象存储、诊断协议。包签名和元数据、灰度编排、设备回执、失败熔断、预签名日志上传。签名校验/防降级;白名单到全量演练;失败阈值自动暂停;断点续传和真实设备回滚。
08 数据智能、BI 与增长
数据、Java、运营
驾驶评分、设备健康画像、归因漏斗和营销自动化。事件口径、隐私同意、订单/订阅数据、广告/MMP 授权、数据保留规则。指标字典、特征/批处理、BI 语义层、归因回传与实验分流。可复算样本;指标血缘与权限;撤回同意后的处理;回传幂等、实验分桶和运营报表对账。
09 App 与 Web 前端体验
Vue、iOS、Android/RN
设备列表、地图、媒体、配网、推送与跨端体验性能。产品流程、API/权限、设计系统、地图/媒体 SDK、埋点定义。页面/组件、客户端状态机、虚拟列表、地图渲染、BLE/局域网模块、可观测埋点。真机和主流浏览器;弱网/前后台/权限拒绝;大列表/地图性能;接口错误与降级体验。
10 多活基础设施与 SRE
SRE、架构
数据库连接收敛、观测、迁移流水线、IaC 和区域级灾备。服务拓扑、容量模型、RTO/RPO、网络与账号边界、迁移基线。资源模板、监控/追踪、变更管道、备份恢复、故障切换 Runbook。从网关到库的 TraceID;迁移/回滚演练;容量/故障注入;按约定 RTO/RPO 的恢复记录。
11 嵌入式与边缘感知
固件、硬件
定位/传感器融合、功耗、离线缓存、边缘预警与硬件密钥安全。硬件 BOM/芯片能力、功耗预算、云端协议、生产烧录与证书流程。固件状态机、环形队列、功耗策略、诊断点、唯一凭证烧录和验签。温度/震动/断网/低电实测;缓存补传不重不漏;产线证书抽验;云端挑战验签。
12 AI Agent 与 LLM 中台
算法、Go/Python、安全
知识检索、诊断助手、自然语言规则与风险报告;不直接绕过业务授权执行动作。已批准知识源、权限上下文、脱敏策略、评测集、人工复核与模型供应商合约。RAG 索引、工具调用白名单、NL2Rule 审核链、评测与审计、人工接管界面。离线正确性/越权/提示注入评测;引用可追溯;高风险动作人工确认;输入输出脱敏和全程审计。

移动端 App 6 项专项

App 专项是“平台专项 02/03/04/06/07/09/11”的产品化消费面。客户端不得自行定义设备状态、时间、权限或媒体存储规则;这些内容须由版本化服务契约提供。

App 专项用户能力与边界协作依赖验收关注点
A1 设备大盘与生命周期设备台账、激活/配网、家庭共享、OTA 进度与设备配置。设备身份/影子、权限、OTA、BLE/局域网协议。扫码/手输/BLE 配对;成员权限变更立即生效;设备状态与服务端一致;升级失败可解释。
A2 地图与 GPS 行程实时定位、历史回放、行程/停留、地理编码与多图层展示。轨迹服务、围栏/行程语义、地图供应商、时区与隐私设置。弱网插值不伪造位置;历史时间轴与时区一致;大量设备聚合性能;定位授权降级。
A3 规则与安全告警模板、围栏编辑、WHEN-THEN 配置和分级通知设置。规则 DSL、地理能力、通知通道、角色权限。配置可读可解释;无权限不可编辑;触发、抑制、升级与撤销同服务端结果一致。
A4 实时媒体与录像多路预览、事件回放、对讲、受控分享和内容脱敏呈现。媒体会话、设备能力、存储模式、审计和分享权限。会话令牌失效即停播;首帧/切流/网络降级;本地录像与云录像入口清晰隔离;分享可撤销。
A5 数据洞察与增值计费行程洞察、驾驶评分、订阅付费墙、配件/服务转化。BI 指标、权益、Apple/Google 支付、订单与税务。评分/图表可追溯;权益与商店回调一致;退款后降级;价格、币种和地区规则正确。
A6 硬件生态与 SDKGPS、摄像头、康复设备等多品类接入;统一诊断、OTA 与本地传输能力。设备 Profile、BLE/Wi-Fi Direct、媒体/诊断协议、系统权限。SDK 按型号能力降级;协议版本兼容;无网本地链路不误走云端;崩溃/权限/后台恢复测试。

依赖与接口冻结顺序

  1. 先定边界:产品模式(云媒体或本地 microSD)、区域/数据主权、设备型号 Profile、租户与权限模型、时间/坐标/事件语义。
  2. 再建底座:专项 05(安全)、10(基础设施)、01(接入)、11(设备)先给出身份、网络、部署、追踪和协议最小闭环;专项 02 同步冻结时空数据模型。
  3. 冻结共享契约:设备 Topic/报文、身份与权限、事件/告警、轨迹/行程、媒体会话、OTA 回执、订单权益各自版本化,并提供 mock、契约测试和弃用策略。
  4. 并行构建业务面:专项 03/04/06/07/08/09/12 以冻结契约推进;任何新增字段、留存期或供应商能力都要走变更评审,不能通过客户端兜底猜测。
  5. 联合验收:以“一台真实设备 + 一个真实账号/角色 + 一个区域 + 故障注入”穿透设备、Go、Java、存储、客户端、审计与告警链路。
共享契约必须冻结的内容主要消费者
设备与身份设备 ID、型号/能力、证书轮换、Topic、QoS、时钟、重放/幂等键01、07、09、11、A1、A6
时空与事件坐标系、UTC 毫秒/IANA 时区、乱序窗口、事件 ID、围栏/行程语义与保留期02、06、08、09、A2、A3、A5
媒体与内容设备能力、会话/授权范围、码流/降级、存储模式、内容密钥、水印与审计03、05、09、A4、A6
订单与权益商品、区域/币种/税、订单状态、支付回调幂等键、订阅权益和撤销时点04、05、08、09、A5
运维与审计TraceID、Region、版本、告警级别、值班路由、日志脱敏、审计事件和删除任务05、06、07、10、12、所有专项

交付与验收证据

阶段各专项提交物验收人 / 证据
立项与设计范围、非目标、主责/协作方、依赖、威胁建模、数据分类、接口和失败补偿。产品、架构、安全共同评审;ADR/评审记录、版本化契约。
开发与测试代码、迁移、配置模板、模拟器/测试数据、单元/集成/契约测试、监控指标。研发与测试;构建号、测试报告、兼容矩阵、性能/安全扫描结果。
联合联调真实设备/客户端/供应商联通,异常、弱网、重复、乱序、拒绝授权和回滚场景。跨团队验收;端到端用例、抓包/追踪、回执、数据落库/删除/审计记录。
灰度与上线发布批次、告警阈值、值班、降级/回滚、成本与区域策略。SRE、安全、业务负责人;变更单、仪表盘、演练记录、上线复盘。

交付治理的通用门槛、环境配置规则与复盘入口见研发交付治理与验收;协议冲突与资料来源优先级见文档来源与版本治理,设备/云端接口详细内容见设备协议与云端接口契约