后续工作计划:C 端 uniapp 联调 + 阶段四(M3 桩协议 / 实时引擎 / 互联协议层)

编制:2026-09-03 · 依据:wiki/design 权威契约(detailed-design 24 篇 / c-end 6 篇)· 前置状态:阶段三 T01-T14 已验收(14 冒烟全绿 + CDP 14/14,见 plan-response-20260902.html)
本计划待您确认后启动;标注 需拍板 的决策点请先定。

〇、决策点(请先拍板)

编号决策点选项建议
E7C 端登录形态(联调口径)甲:后端新增 POST /api/auth/c-login(微信 code 占位 + 手机号验证码 mock,对齐 c-end-member 设计)
乙:暂复用 username/password(快速联调,后续再换)
甲(契约正源:c-end-design「微信授权登录(手机号)」;mock 通道不动微信资质)
E8站点详情桩/枪/电价开放方式甲:新增 C 端聚合端点 GET /api/station/c-detail/{id}(一次返回站+桩+枪+分时价),入白名单
乙:开放设备/计费域既有只读端点(多端点多面)
甲(公开面最小化:1 端点可控限流,避免白名单散开)
E9M1c + P2-3 切换执行窗口甲:本计划 P0 批内执行(dev 重启窗口 ~1-2 分钟/服务)
乙:您在场时单独执行
甲(镜像已产出 server-300/prototype-admin,前置就绪;E6/P2-3 已获授权口径)
E10阶段四范围与启动顺序甲:D1 桩协议优先(M3 主线,实时引擎依赖其数据源)
乙:D3 互联协议层优先(管理面已就绪,外部对接可先行)
甲(D2 实时引擎消费桩协议事件;互联协议层可并行一小批)

一、P0 前置清偿批(半天,3 项)

P0-1 M1c:cdz-admin 切镜像E6 已授权
输入:argocd-apps cdz-m1/deploy/cdz-admin.yaml(PVC 版已对齐);镜像 prototype-admin:server-298+(13 域含 auth,VITE_BASE=/);prototype/Dockerfile(内置 nginx /api 反代,需确认镜像 nginx.conf 与 PVC conf 等价)
动作:① 比对镜像内 nginx.conf 与 cdz-admin-conf-nfs 现网 conf(SPA fallback / /api 反代 / gzip);② 改 cdz_code/deploy/cdz-m1/cdz-admin.yaml:image → gitlab-registry.gridvo-common.svc:5000/xiaoge/charging-station-platform/prototype-admin:server-298,去 dist/conf 卷挂载(镜像自含);③ push 触发 update-gitops-cdzm1 → ArgoCD sync → 验证 cdz-admin.c.gridvo.com(CDP 登录+抽页);④ 回滚预案:argocd-apps revert(PVC conf 卷保留不删,可回切)。
依赖:E9 窗口;ns-dev-cdz-m1 regcred 已存在(yudao 拉取实证)
P0-2 P2-3:cdz-biz-server 镜像化 + GitOps已获授权口径
输入:镜像 server-cdz:server-300(pl300 success);deploy/cdz-m1/cdz-biz-server.yaml(PVC jar 版)
动作:① yaml 改 image → server-cdz 镜像 + 去 NFS jar 卷(env 保留 DB/Redis 等);② ENV 增 CDZ_REFUND_DEMO_PAY_SNAPSHOT=true(对齐现网 dev 演示,需现场核 live env 后定);③ GitOps 发布同 P0-1;④ 冒烟全量 14 脚本回归(部署方式切换后必须全绿);⑤ NFS jar 通道保留 7 天作回退。
依赖:P0-1 验证通过后串行执行;更新 CI kaniko-server-cdz 的 update-gitops 集成(biz tag 进 argocd-apps,占位 IMG_BIZ)
P0-3 m1(yudao)CI 失败修复 + KB 更新收尾
动作:① 查 build-m1-server 失败根因(server/Dockerfile 多阶段 maven 构建,7.5min exit 1——疑 maven 依赖源/内存,读 build.log debug 文件);② 修复或暂时 rules 限定(live m1-local 不受影响);③ KB 补写:1ms 源抽风根因修正(非 registry 故障)+ registry 实为老 minio registry-backend 桶 + resource_group 串行(更正 09-02 档案误判段)。

二、C 端 uniapp 联调(阶段三延伸,2 批)

批 C1 · 后端公开能力扩展(1-1.5 天)

C1-1 C 端登录端点E7
必读:wiki/design/c-end/c-end-design.md §登录、detailed-design/c-end-member-detailed-design.md、module/auth 现实现(LoginReq username/password)
动作:① 新增 POST /api/auth/c-login(入参 wxCode 占位 + mobile + smsCode;dev 短信码固定 123456 幂等;生产留微信 code2session 适配位);② 复用 JWT 签发(C 端 member 角色,tenant 注入);③ 白名单登记 c-login;④ verify-cend.sh(登录 40101/成功 token/重复登录幂等)。
验收:c-app-uniapp 登录页真调通(token 落 storage);冒烟绿。
C1-2 站点详情聚合端点 + 白名单E8
必读:detailed-design/c-end-station-detailed-design.md、station-device/charging 域读接口、AuthInterceptor.PUBLIC_PATHS
动作:① GET /api/station/c-detail/{id}:站基础 + 桩列表(在线/枪数)+ 枪明细(状态/功率/类型)+ 当前生效计费模板分时价(跨 stationdevice/billing 聚合,只读);② 白名单登记;③ 脱敏审校(不含内部成本价/运营字段);④ 限流占位(IP 维度简单计数,生产化后置);⑤ verify 用例(数据形状/空站/下线站)。
验收:详情页真数据渲染(桩/枪/电价三块);swagger 契约同步 wiki。

批 C2 · 联调与 H5 链路(1 天)

C2-1 四页真接口切换 + 兜底
动作:① request.js baseURL 指后端(dev 走 NodePort/ingress 白名单域名);② 登录/找桩/详情三页 mock 开关关闭走真;扫码页占位说明保留;③ 401 统一跳登录、L1 信封错误 toast;④ 三态(loading/empty/error)真接口版校准。
验收:H5 运行「登录 → 找桩列表 → 站点详情」全链路真数据(node67 Chrome CDP 复用验证,PASS 准则同阶段三)。
C2-2 充电启动链路边界确认(范围闸)
说明:扫码→启动充电→结算属 M3 桩协议依赖(真桩启动需 D1 网关),本批只做到「启动确认页(展示价/桩信息)+ 模拟订单创建」;真启停随阶段四 D4 联调。
动作:启动确认页接 c-detail 价与枪状态 + 占位下单(order 域 mock 端点或 dev/seed 复用)。

三、阶段四(M3):桩协议 / 实时引擎 / 互联协议层

独立阶段,全部后端批 + 主控部署验证;契约正源 detailed-design 24 篇。建议 3 并发子任务 + 主控验收(沿用阶段三模式)。

批 D1 · 桩协议网关(M3 主线,2-3 天,最大批)

D1-1 协议编解码与 Netty 骨架
必读:detailed-design/pile-detailed-design.md(167 行:帧格式/拆包编解码/字节序/47 指令总表/心跳超时/七阶段时序/兼容红线 A6/工程缺陷修复清单 5 项)
动作:① module/pile-protocol:Netty TCP 服务(端口按设计,容器暴露)、0x68 帧编解码器(拆包/转义/校验)、指令注册表 47 条(先实现核心 12 条:登入/心跳/启停/状态/计量);② 连接在线状态机(station→pile→connector 映射,Redis 会话);③ 修复旧系统 5 工程缺陷(ChannelMap 离线抛异常/重发递归/下行序列号竞态等,见设计 §十一);④ 单元测试(帧 round-trip + 指令编解码表驱动)。
D1-2 启停充电闭环 + MQ 映射
必读:pile 设计 §七/§八(启停时序/七阶段报文)、mq-message-contracts.md(6 下行+5 上行+7 旁路)
动作:① 下行启停(订单域联动:order 创建→pile 下行启动→桩确认→订单状态机推进);② 上行计量/状态报文→ MQ 事件(订单计量累计、枪状态变更);③ 幂等/confirm/retry/DLQ 按 contracts;④ 桩模拟器(dev 工具:可配置应答的假桩,复刻七阶段时序)。
验收:模拟器全链路——启动→计量心跳→停止→结算单生成(结算引擎衔接)冒烟绿。

批 D2 · 实时引擎(monitor/charging 实时化,1.5 天)

D2-1 设备状态实时 + 告警触发
必读:detailed-design/monitor-detailed-design.md、charging-detailed-design.md(实时订单/充电实况);阶段三后置标注(monitor 聚合视图/规则测试/M3 联调后置项)
动作:① 消费 pile MQ 事件:枪状态实时表(Redis + 落库)、离线判定(心跳超时→状态机);② 告警规则引擎执行(阶段三 alert_rule 落地触发:离线/故障/阈值→alert_record 生成+推送 alert_notify);③ workbench device-status/monitor 聚合视图切实时源;④ WebSocket/SSE 推送占位(B 端实时刷新,协议选型 SSE 优先)。
验收:模拟器拔网线(停心跳)→ 90s 内告警落库+推送记录可查;verify-monitor 增实时段用例。

批 D3 · 互联协议层(1.5 天,可与 D2 并行)

D3-1 签名/验签 + 推送回调
必读:detailed-design/interconnection-detailed-design.md、interconnection-api.md 阶段四标注项(T11/T13 notes)
动作:① 请求验签中间件(平台密钥 AES-GCM 解密→HMAC 签名校验→时间窗/nonce 防重放);② 回调推送(互联订单/状态变更 POST 平台 callbackUrl,退避重试复用 Notify 框架);③ 密钥 ROTATE/REVEAL 端点(审计联动);④ api_log/trade_record 落库(对接现有表)。
验收:verify-interconnection 增协议层段(签名通过/篡改拒绝/重放拒绝/回调投递轨迹)。

批 D4 · 全链路联调验收(1 天,主控)

D4 端到端:模拟桩 → 平台 → B 端/C 端
动作:① 桩模拟器启动充电 → C 端实时充电页(uniapp 第 3 页激活)真数据 → B 端充电实况/监控告警实时刷新;② 结算/账单/发票链路回归;③ 全量冒烟(14+3 新脚本)+ CDP 抽查;④ 性能占位(100 模拟桩并发心跳压测 10min);⑤ 交接文档 + KB 阶段四档案。

四、批次编排与依赖

顺序批次工期前置依赖并发
1P0 前置清偿(M1c → P2-3 → m1/KB)0.5 天E9 拍板主控串行
2C1 后端公开能力(c-login + c-detail)1-1.5 天E7/E8 拍板2 agent 并行
3C2 C 端联调 + H5 验证1 天C11 agent + 主控 CDP
4D1 桩协议网关(骨架 → 闭环)2-3 天E10=甲;与 C 线可并行2-3 agent
5D2 实时引擎 ∥ D3 互联协议层1.5 天D1 MQ 事件2 agent 并行
6D4 全链路联调验收1 天D1-D3主控
总工期约 7-9 个工作日(含并行);每批沿用阶段三节奏:静态验收(编译/测试/bash -n)→ 提交 → 构建/镜像 → 部署 → 全量冒烟 → CDP 抽查。

五、风险与预案

风险预案
镜像源抽风复发(1ms/daocloud,KB 已证常态)Dockerfile 一律 FROM docker.io(走 kaniko mirror);节点预拉 ctr 兜底;resource_group 串行保留
P0 切换后冒烟不过argocd-apps revert 单提交回滚(PVC conf/jar 卷保留 7 天可回切 NFS 模式)
桩协议兼容红线(A6:桩号 40055825050010/11 固件 hack)D1 编解码内置兼容层 + 模拟器含该桩号用例(设计 §十红线全条目验收)
C 端微信资质未定(支付分/手机号)E7=甲 mock 通道不受资质阻塞;微信正式对接单列后续
本机/集群网络动态(mihomo REJECT 间歇)通道三备:kubeconfig VIP / ssh 节点 / 7897 代理(gitlab);KB 维护纪律为准
yudao m1 CI 未知失败拖累 update-gitops 链P0-3 先修;若延期则 m1 job rules 暂限 main+changes,不阻塞 cdz 线

六、验收标准汇总

批次硬性验收
P0cdz-admin/biz 镜像化运行 + 14 冒烟全绿 + CDP 抽查通过;argocd-apps 单提交可回滚
C1/C2verify-cend 绿;H5 登录→找桩→详情真数据链路 CDP PASS;白名单仅新增 2 端点
D147 指令编解码单测全绿;模拟器启停→结算闭环;A6 兼容红线用例过
D2离线告警 90s 落库可查;B 端实时视图数据与模拟器一致
D3验签/防重放/回调投递轨迹冒烟绿;密钥 ROTATE 审计完整
D4端到端全链路(桩模拟器→C 端实时→B 端告警)演示 + 全量冒烟 + 100 桩压测 10min 无丢心跳
确认本计划(或调整 E7-E10/批次范围)后按 P0 → C → D 顺序启动;沿用户既有执行模式:自动执行、每批验收合并、集群配置变更点(P0 切换)在 E9 授权窗口内执行。