3.6 KiB
3.6 KiB
PREPROD_VERIFICATION_RECORD.md
状态：已建立
最近一次更新：2026-05-04
目标：沉淀 Gate B 预生产验证的可复跑证据，而不是口头结论
1. 验证范围
本记录对应 Task 5 的 Gate B 验证脚本：
脚本覆盖的检查项：
- 环境变量完整性与 production 约束
- PostgreSQL 连通性
- migration 账本与基线版本检查
- 当前源码构建与服务启动
/actuator/health/live/actuator/health/ready- 带签名 webhook 请求
- dedup 入库与重复消息抑制
- ticket 创建 / 分配 / 解决 / 关闭
- audit 入库验证
2. 最近一次实测记录
- 时间：2026-05-04 18:50 CST
- 环境：本机容器化/本地 PostgreSQL 联调环境
- 基线提交：
65e48bc - 说明：本次验证基于当前工作区源码重新编译执行，不依赖仓库内旧二进制
- 运行 ID：
gateb-20260504185024 - 产物目录：
/tmp/ai-customer-service-preprod-gate-b/gateb-20260504185024
执行命令：
AI_CS_RUNTIME_ENV=production \
AI_CS_ADDR=127.0.0.1:18080 \
AI_CS_POSTGRES_ENABLED=true \
AI_CS_POSTGRES_DSN='host=localhost port=5434 user=ai_cs password=ai_cs_secret dbname=ai_customer_service sslmode=disable' \
AI_CS_POSTGRES_MIGRATION_DIR='/home/long/project/ai-customer-service/db/migration' \
AI_CS_WEBHOOK_SECRET='gate-b-secret-20260504' \
AI_CS_WEBHOOK_TIMESTAMP_HEADER='X-CS-Timestamp' \
AI_CS_WEBHOOK_SIGNATURE_HEADER='X-CS-Signature' \
AI_CS_WEBHOOK_MAX_SKEW_SECONDS=300 \
scripts/verify_preprod_gate_b.sh
结果摘要：
- PASS 总数：
30 - FAIL 总数：
0 - 生成 ticket：
0806e91f-f50a-4942-b263-f14a4ed5285e - 生成 session：
9a468320-81c3-44fb-9707-9819dba16e94 - 验证 message_id：
gateb-20260504185024-message - 服务日志：
/tmp/ai-customer-service-preprod-gate-b/gateb-20260504185024/service.log
关键通过项：
- 当前源码可成功构建并启动为 production + postgres 模式
live/ready探针均返回成功- 带 HMAC 签名的 webhook 请求返回
200 - 首次 webhook 成功创建
ticket与message_processed audit - 相同
message_id的重复 webhook 被 dedup，且 dedup 表中仅保留一条记录 assign -> resolve -> close工单闭环在 PostgreSQL 中成功落库assign / resolve / close两层 audit 都成功入库
3. 本次验证中暴露并修复的问题
在脚本首次联调过程中，暴露并修复了两个真实问题：
-
Gate B 脚本最初使用仓库内旧二进制，无法代表当前源码行为
已修复为：脚本默认先构建当前源码，再启动服务。 -
handler 层 audit 事件 ID 不是合法 UUID，导致 PostgreSQL audit 写入静默失败
已修复文件：
这两项修复后，Gate B 本地/容器化预演已全部通过。
4. 当前结论
已确认
- 本地/容器化 Gate B 预演：通过
- 脚本化验证入口：已建立
- ticket / audit / dedup / health / migration：已有可复跑证据
仍未确认
- 真实共享预生产环境 Gate B：尚未执行同脚本复跑
- Gate C 灰度监控 / 回滚演练：未完成
因此当前正确结论是：
Gate B 脚本与本地/容器化联调证据已经建立并通过，但还不能把这直接等同于“真实预生产环境已经放行”。