# 工作交接文档（2026-09-02 · 阶段三 v6.1→v7.1 批1-批5）

> 会话主线：阶段三执行（E1=甲 13 域收官 / E2=乙 M3 桩协议独立阶段四 / E3=甲 C 端 uniapp 启动 / E4=默认 D9 管理面 / E5=乙 member 规划中标注 / E6=admin 切镜像先缓行）。任务分解 v7.1：T01-T14 六批（实际 5 批 + 收尾）。
> 上一份：`工作交接文档-20260901.md`（v5 步 4 批 A 至 6 域在线）。
> 仓库：`git.c.gridvo.com/xiaoge/charging-station-platform`。分支 `zouzm-design`（HEAD=`757337b54`）；`main` 已同步合并（`7c970edcb`）。

---

## 1. 当前状态一句话

- **后端 13 域全在线**（原 8 + auth/report/workbench/monitor/interconnection 新 5），cdz 库 101+ 表（本轮 +11：pay_d0_setting、monitor 7 表、interconnection 3 表）；JWT 鉴权（T06）全量生效——除白名单外接口 40100 会话门、写操作权限码 40301。
- **前端 admin dist**（13 域 real：auth+station-device/billing/order/payment/member/system/marketing/finance/report/workbench/monitor/interconnection）已构建部署 NFS（cdz-admin-dist-nfs，/new/ 前缀 alias），vue-tsc -b 0 错误。
- **验证**：14 个 verify 脚本全绿（auth A1-A8 / report 27/27 / workbench 33/33 / monitor 32/32 / interconnection I0-I10 / smoke/billing/order/payment/member/system/marketing/finance/occupancy 50000=0）。
- **C 端**：c-app-uniapp/ 骨架落地（4 页 + request 封装 + 白名单确认），HBuilderX 打开即运行。

## 2. 阶段三交付矩阵（本会话 12 提交）

| 批次 | 提交 | 交付 |
|---|---|---|
| 批1 | 4afa3cabd | T01 D0 资金 4 端点+V9 设置表+D0Funds 页 / T02 member 5 页接真 / T03 模板复制删除+渠道测试支付 |
| 批2 | dbe8d3d76 | T04 站点换绑历史+Notify HTTP 真实投递 / T05 member 6 页「规划中」标注（E5=乙） |
| 批3 | 47dd46a71 | T06 JWT 鉴权后端（login/me/40100/40101/40301/RLS）/ T07 鉴权前端 / T08 report 后端 4 聚合 |
| 批4 | 1ae8b905b + 826c5a447 修复 | T09 workbench（概览两卡/待办三源合并/设备四态）/ T10 monitor（V12 7 表+告警/规则/推送）/ T11 互联互通管理面（V13+平台/密钥/流量/目录） |
| 批4 修复 | cb8465221 | report overview 7D/30D 桶窗口单日 bug（loadOrders 上界→明日） |
| 批4 修复 | 51cbf6775 | GlobalExceptionHandler DuplicateKeyException→40903 兜底 |
| 脚本适配 | 2cf8f71e9 / df84e1168 | 9 老 verify 注入 T06 登录段 + 新脚本 string 序列化适配（grep -oE 可选引号） |
| 批5 | 757337b54 | T12 report 4 页+workbench 看板/待办接真 / T13 monitor/互联 9 页接真+2 页标注 / T14 c-app-uniapp 骨架 |

## 3. 部署操作记录（node67，发布模式沿用：NFS PVC 非 hostPath）

- **DDL**：V9（pay_d0_setting）/V12（monitor 7 表）/V13（interconnection 3 表）psql 落 cdz 库，11 表核验在册，0 ERROR。
- **jar**：node67 `/data/cdz/build2.sh`（E 路线 JDK17，`-DskipTests`，m2 缓存 /data/cdz/m2）→ `cp → /mnt/cdz-app/cdz-biz-server.jar`（NFS PVC cdz-app-nfs，挂载点 /mnt/cdz-app）→ `sync` → md5 复核（最新 9a510479…）→ `kubectl rollout restart deploy/cdz-biz-server`。
- **admin dist**：本地 `VITE_REAL_API_DOMAINS="…12 域" npm run build`（vue-tsc -b && vite build，4.7MB/184 assets）→ tar → node67 `/data/cdz/admin-dist-new` → 替换 `/mnt/cdz-adm/*`（PVC cdz-admin-dist-nfs）→ nginx 服务 `cdz-admin.c.gridvo.com`（ClusterIP 10.43.166.177）HTTP 200，新 chunk（OperationOverview/DeviceAlert/…）均 200。
- **冒烟**：脚本在 node67 `/data/cdz/verify-s3/`（14 个），kubectl 取 ClusterIP + curl；登录密码 dev 种子 `cdz-dev-123456`。

## 4. 本轮踩坑与教训（复用于后续）

1. **T06 后所有读/写接口 40100**：9 个 T06 前老 verify 脚本全灭 → 统一注入 W0 登录段 + 全部 curl `-H "$AUTH"`（python 单遍处理，AUTH 前白名单 curl 豁免）。
2. **后端 bigint→string 全局序列化**：`"total":"21"`/`"orderCount":"88"` —— verify 断言必须 `grep -oE '"total":"?[0-9]*"?'`（GNU grep BRE 中 `?` 是字面量，必须 `-oE` 才生效）。
3. **metricFor 桶窗口 bug**：`loadOrders(start, start.plusDays(1))` 把 7D/30D 桶缩成单日 → 上界改 `dayStart(0).plusDays(1)`。
4. **DuplicateKeyException 漏网 50000**：全局 @ExceptionHandler 兜底 40903。
5. **编译错误先行排查**：并行 agent 收拢前 mvn compile 会报他人 in-progress 文件错误（InterconnectionServiceImpl `p` 重名）——以最终合拢后构建为准。
6. **T12/T13 并发共享文件**（SecretManagement.vue/real-api.ts 等）已收敛，vue-tsc 全仓 0 错误为准。
7. **NFS du 顶层 191K 假象**：du -sh 对 NFS 挂载目录估算异常，以 assets 子目录 du/文件数核验（5.5M/184 个）。

## 5. 未决项 / 下一步

- **CDP 全站 15+ 页抽查**：本会话无 chrome MCP 工具未执行（后端 API 冒烟与前端静态构建已覆盖，浏览器级待 GUI/CDP 环境执行）。验收口径：批5 后终验 CDP 全站 + 401/403 鉴权冒烟。
- **P2-3 GitOps**：另行授权后推进（本会话未授权）。
- **M1c cdz-admin 切镜像 + GitLab pipeline 验证**：E6 授权 admin 先切，但缺凭据直接验证，待用户在场确认执行。
- **BusinessIntelligence/StationCompare**：后端 T09 切片仅 overview/todos/device-status，两页 real 域标注演示数据；待 report_station_daily 预聚合切片落地后解除（T12 notes）。
- **C 端 uniapp**：c-app-uniapp/ 仅骨架，登录真实后端 /api/auth/login 联调、站点详情桩/枪/分时电价（设备/计费域白名单外）待后续。
- **main 同步**：本轮已合并推送（7c970edcb）；后续新提交需再同步。
- **阶段四（M3 桩协议/实时引擎/互联协议层）**：独立阶段四，未开始。

## 6. 关键命令速查（同 0901 版 + 本阶段）

```bash
# 源码同步（node67 无 rsync → tar 管道；勿用 scp 目录）
cd server-cdz && tar czf - --exclude=target . | ssh k3snode67 'rm -rf /data/cdz/server-cdz/* /data/cdz/server-cdz/.[!.]*; tar xzf - -C /data/cdz/server-cdz'

# 构建 + jar 同步 + rollout（NFS PVC 挂载点 /mnt/cdz-app）
ssh k3snode67 'bash /data/cdz/build2.sh && SRC=/data/cdz/server-cdz/target/cdz-biz-server-1.0.0.jar && cp -f $SRC /mnt/cdz-app/cdz-biz-server.jar && sync && md5sum $SRC /mnt/cdz-app/cdz-biz-server.jar && kubectl -n ns-dev-cdz-m1 rollout restart deploy/cdz-biz-server && kubectl -n ns-dev-cdz-m1 rollout status deploy/cdz-biz-server --timeout=240s'

# DDL（幂等，IF NOT EXISTS）
for f in V9__d0_setting.sql V12__monitor_domain.sql V13__interconnection_domain.sql; do kubectl -n ns-dev-cdz-m1 exec -i cdz-m1-postgres-0 -- psql -U postgres -d cdz -v ON_ERROR_STOP=0 -q < $f; done

# 冒烟（node67 /data/cdz/verify-s3/，14 个；登录 cdz-dev-123456）
ssh k3snode67 'cd /data/cdz/verify-s3 && for s in verify-*.sh; do echo "## $s"; out=$(bash $s 2>&1); echo "$out" | grep -cE "\"code\":50000"; echo "$out" | grep -E "^(PASS|FAIL|.*_DONE)" | tail -3; done'

# admin dist 构建部署（2026-09-02 CDP 实测修正版）
# 关键三坑：① vite base 默认 /new/（vite.config.ts L8）→ dist 须放 PVC 的 new/ 子目录；
# ② REAL 名单必须含 auth（否则 dev 演示登录过不了 T06 会话门 → 全站 40100）；
# ③ PVC 根 index.html 也须同步为新版（nginx SPA fallback /index.html，根残留旧版引用已删 chunk → 白屏 text/html MIME 错误）。
cd prototype && VITE_REAL_API_DOMAINS="auth,station-device,billing,order,payment,member,system,marketing,finance,report,workbench,monitor,interconnection" npm run build
cd prototype/dist && tar czf - . | ssh k3snode67 'rm -rf /data/cdz/admin-dist-new && mkdir -p /data/cdz/admin-dist-new && tar xzf - -C /data/cdz/admin-dist-new && rm -rf /mnt/cdz-adm/new.bak && mv /mnt/cdz-adm/new /mnt/cdz-adm/new.bak 2>/dev/null; mkdir -p /mnt/cdz-adm/new && cp -r /data/cdz/admin-dist-new/* /mnt/cdz-adm/new/ && cp -f /mnt/cdz-adm/new/index.html /mnt/cdz-adm/index.html && rm -rf /mnt/cdz-adm/assets && sync && du -sh /mnt/cdz-adm/new'
# CDP 浏览器级验证：node67 Chrome-for-Testing（/tmp/chrome-linux64/chrome）+ --remote-debugging-port=9223 --remote-allow-origins=*，
# python websocket-client 驱动脚本 /tmp/cdz-cdp-9223.py（BASE=http://127.0.0.1:9223）；2026-09-02 实测 登录+14 页 PASS 14/14。

# 新增后端模块 checklist：CdzbizApplication @MapperScan 登记 + DDL 幂等落库 + verify-xx.sh + 脚本 string 字段用 grep -oE '"x":"?[0-9]*"?'
```

- 提交纪律：绝不自动 commit/push（阶段三按用户"自动执行"授权批次提交）；不 force push；改动前 git status 复核并行冲突。
- 文档纪律：过程草稿/审计落 `.trae/documents/`；契约修订落 `wiki/design/`。