引势创新云平台知识库
面向团队的完整知识体系：业务词汇与领域模型、Java / Go 双平台架构与服务职责、典型链路、排障 FAQ、工程规范、影像数据架构与复盘机制。内容由代码与工程文档分析整理，共 68 个子页面。
站内搜索
知识库目录
业务知识
统一业务术语与领域模型，先划清事实边界，再决定服务边界。
- 业务词汇表 — 设备、物模型、轨迹、订阅权益、支付事实等核心术语的统一定义与业务规则。
- 核心领域模型与业务规则 — 设备归属、订阅-权益-Seat、支付事实分层、SIM 生命周期、告警规则模型与跨模块约束。
- 产品能力与业务中台地图 — 由需求、业务逻辑和中台功能清单归纳的设备、媒体、商业、数据、安全与生态能力边界。
- 规则引擎与告警模型 — 条件树、动作编排、目标范围、版本审计、命中快照与告警闭环的统一模型。
系统架构
Java（业务治理）+ Go（网络数据引擎）双引擎架构与跨语言协作机制。
- 总体架构 — 双引擎分工、分层架构图、数据流与演进方向。
- 架构图集与方案边界 — 汇集 doc 中的系统、微服务、App 与中台架构图，并标记各图的适用范围与不应混用的设计。
- 设备与用户可观测平台 — 统一采集设备、App、服务、网关与运维信号，完成脱敏、关联、告警、诊断与留存治理。
- Java 平台架构 — cloud-java 的单体/微服务部署形态、模块划分、包结构与请求链路。
- Go 平台架构 — cloud-go 的 go-share / go-core / go-master 分层与 go-zero 服务组织方式。
- 跨语言协作机制 — gRPC、NATS 主题、Redis 共享状态、TDengine 读写边界与鉴权上下文透传。
Java 平台（cloud-java）
十一个业务模块的职责、接口、表结构与关键实现。
- system 系统管理 — 租户、后台用户、RBAC、字典、OAuth、通知模板与操作日志。
- infra 基础设施 — 配置文件、文件存储、API 日志、代码生成与定时任务基础设施。
- member 会员 — APP 用户、登录安全、家庭管理、会员等级与积分体系。
- pay 支付 — 支付事实分层：订单、支付尝试、异步通知、对账与未知状态恢复。
- iot 设备 — 产品与物模型、设备档案、绑定流程（Saga）、分享、规则与 OTA。
- sim SIM 卡 — eSIM profile、供应商同步、绑定回调、批任务、用量与告警。
- SIM/eSIM 供应商接入契约 — 卡、套餐、IMEI 池、异步通知、CDR 与批处理任务的供应商适配边界和对账要求。
- prod-gps GPS — GPS 设备、行程、围栏、设备分组与轨迹报表，NATS 消费与 gRPC 服务。
- notify 通知 — 站内信、消息任务、移动推送 Token 与发送状态跟踪。
- alarm 告警 — 告警规则、过滤器、模板与记录，以及供外部查询规则的 gRPC 服务。
- mcp AI 接入 — MCP Streamable HTTP 接入方式、工具复用与端口边界。
- subscription 订阅 — 套餐、权益、active 订阅、Seat 占用与绑定 Saga、权益鉴权 gRPC。
Go 平台（cloud-go）
底座库、基础中台与车载安防业务服务的职责与关键实现。
- go-share 底座支撑库 — utils 工具、客户端封装、OSS 驱动与公共领域模型。
- go-core 基础中台 — apisvr / syssvr / datasvr / timed 的系统管理、物模型、数据分析与定时任务能力。
- go-master 服务矩阵与网关 — 车载安防服务层总览：apisvr 网关与各业务服务的职责矩阵。
- 设备接入：dgsvr + gpscodecsvr — MQTT 设备认证注册与 GPS 私有协议编解码到标准物模型。
- 设备管理：dmsvr — 设备/产品/物模型/协议/OTA/分组管理、设备影子与属性历史检索。
- 定位轨迹：geosvr + tripsvr — GPS 原始点消费、TDengine 存储、轨迹查询、在线状态与行程检测。
- 告警风控：risksvr + alertsvr + eventsvr — H3 风险区域匹配、行为规则评估与事件分发推送。
- 视频与推送：videosvr + wssvr — 实时监控 WebRTC、历史录像、云台控制与实时位置 WebSocket 网关。
- 辅助服务：iamsvr + otasvr + agentsvr — PII 加密与审计、OTA 升级、AI 行程文案智能服务。
业务功能与流程
核心业务功能的端到端流程、时序与状态机。
- 认证与登录流程 — APP 登录方式、JWT 与 TOTP、后台登录、Go 网关鉴权与设备认证的完整链路。
- 设备全生命周期流程 — 设备从注册、认证、绑定、分享、OTA 到解绑/注销的完整生命周期与归属状态。
- 客户端与管理后台能力地图 — App 导航、设备/地图/规则/媒体/服务闭环，以及管理后台、运营与运维门户的职责和交付边界。
- 设备本地热点配网与双网并行 — BLE 安全配网、Local-only Wi-Fi 本地链路、蜂窝云端链路的并行路由、会话与异常恢复规则。
- 设备绑定与权益分配流程 — 绑定会话、绑定任务、订阅 Seat 预占与支付激活的 Saga 完整时序。
- 支付与订阅开通流程 — Checkout 会话、支付尝试、异步通知、对账与订阅激活的完整流程。
- SIM 卡生命周期流程 — SIM 从采购入库、Profile 激活、绑定、供应商同步、用量告警到回收的全流程。
- 告警全流程 — 从规则配置、规则拉取缓存、事件评估、告警记录到通知送达的完整链路与状态机。
- OTA 升级流程 — 固件上传签名、升级任务创建、NATS 下发、设备升级与防回滚的完整流程。
- OTA 平台与远程诊断 — 固件、发布、任务、设备进度、灰度回滚、指标与按需诊断日志的实现边界。
数据流转
数据从产生、流转、存储到消费的完整地图与一致性机制。
- 数据存储地图 — MySQL 业务库、TDengine 时序表、Redis 键、OSS 桶与 Nacos 配置的数据全貌。
- 核心数据模型与数据库演进 — 业务实体分组、冷热数据边界、索引与分区、迁移版本、备份恢复及历史方案冲突处理。
- 设备数据流 — 设备上行（上报/事件）与下行（指令/配置/OTA）数据的主题、转换与消费方。
- 业务事件流 — NATS / RocketMQ 事件总表：生产者、消费者、Topic/Tag 与消费组规范。
- 数据一致性机制 — 幂等键、Outbox、Saga、对账、补偿与时间对齐的可靠性设计。
安全体系
认证授权、数据隐私、传输安全、审计合规与威胁防护。
- 安全体系总览 — 端-网-云-用四层纵深防御、零信任与隐私合规内生的安全架构。
- 认证与授权 — JWT 过滤器、RBAC、租户与数据权限、Go 代理认证、WebSocket 握手鉴权与设备认证。
- 数据安全与隐私 — PII 加密（iamsvr / GORM AES-GCM）、配置加密、日志脱敏、密钥管理与数据留存。
- 传输与接口安全 — TLS/mTLS、MQTT over SSL、WebRTC 加密、临时凭证、Webhook 验签与输入校验。
- P2P 安全、出海合规与事件响应 — P2P 信令与媒体安全、EU/US 产品合规、漏洞响应、事故处置和研发交付物。
- 审计与合规 — 审计日志、多区域隔离、GDPR/CCPA、数据导出与注销、漏洞响应与事故通报。
- 威胁分析与安全评审清单 — 设备伪造、越权、注入、日志泄露等威胁清单与需求/方案评审安全检查项。
工程规范
端口、部署、配置、消息、契约与安全约定。
- 端口、部署与配置 — 端口分配规则、单体/微服务部署形态、Nacos 配置层次与安全规则。
- 消息与定时任务 — NATS/RocketMQ/Redis Stream 消息总线、Outbox 与 XXL-JOB 处理器清单。
- gRPC 契约与接口安全 — Java/Go 双方 proto 契约、调用约定、接口分层与权限安全规则。
- 设备协议与云端接口契约 — 设备接入、MQTT Topic、载荷编码、影子合并、异步命令、激活与版本冻结的协议治理规则。
- 文档来源、版本与事实边界 — doc 文档的覆盖映射、来源优先级、设计与现状区分、冲突登记和更新流程。
影像数据
家庭影像与车载影像的数据关联架构设计。
- 影像数据关联模型 — 设备、录像、GPS 点位、事件与时间线的关联设计，为检索、联动、回溯预留空间。
- 车载独立监控与本地媒体架构 — 控制面与媒体面分离：云端只处理控制、状态与事件；实时/历史视频优先端到端直连，录像留在设备 microSD。
家庭影像
独立的家庭记忆 AI 成片产品：功能全景、Agent 媒体管线、隐私边界与工程演进。
- 家庭影像功能全景 — 从素材上传到家庭成片、审核、下载与分享的完整功能边界，以及 M1/M2/M3 的能力分层。
- 家庭影像技术架构与媒体管线 — FastAPI、Temporal、LangGraph、媒体渲染、产物存储、模型适配与隐私审计的职责及运行链路。
落地计划
多团队研发专项的边界、依赖、交付物、验收证据与治理规则。
- 多团队研发专项拆解清单 — 12 个平台/设备专项与 6 个 App 专项的责任边界、依赖、交付物、验收证据和协作契约。
- 研发交付治理与验收 — 多团队专项、开发测试环境、阶段性交付、验收证据和上线风险的统一管理方式。
跨产品参考
同一 doc 仓库中的其他产品规格，仅供复用思路，不作为车载平台实现事实。
- AquaRecover AI 参考规格 — 智能康复系统的功能、硬件、安全与合规参考；与车载平台保持独立的领域和事实边界。