feat: add service config templates and extraction script

Former-commit-id: 1de24b7eb79676d1aba9d799a58c5a753290cf52
2026-06-09 08:20:31 +08:00 · 2026-05-01 19:38:01 +08:00
parent 3175b7074b
commit 8b15445328
2433 changed files with 8322164 additions and 1604 deletions
@@ -0,0 +1,113 @@
+# org_id 策略修复 — 人工验证操作手册
+
+## 前置条件
+
+- V2 JAR 已构建：`cw-elevator-application-2.0.9.jar`
+- 配置文件：`/tmp/v2-redis-fix.properties`
+- Redis Docker：`v2-test-redis`（端口 6380，密码 `1qaz!QAZ`）
+- 桩服务脚本：`stub_org_service.py`
+
+---
+
+## 步骤 1：启动 V2 电梯应用
+
+打开**终端 1**，执行：
+
+```bash
+/usr/lib/jvm/java-8-openjdk-amd64/bin/java \
+  -jar /media/zebra/9e8fa357-7db6-4d70-88ed-d5de5a059a663/星河湾星中星/源码/maven-cw-elevator-application/cw-elevator-application-starter/target/cw-elevator-application-2.0.9.jar \
+  --spring.config.location=file:/tmp/v2-redis-fix.properties
+```
+
+等待约 **35 秒**，看到 `Started ElevatorApplication` 后验证：
+
+```bash
+curl http://127.0.0.1:18081/health
+```
+
+期望输出：`{"status":"UP"}`
+
+---
+
+## 步骤 2：启动组织服务桩
+
+打开**终端 2**，执行：
+
+```bash
+python3 /media/zebra/9e8fa357-7db6-4d70-88ed-d5de5a059a663/星河湾星中星/源码/maven-cw-elevator-application/tools/stub_org_service.py
+```
+
+验证：
+
+```bash
+curl http://127.0.0.1:18082/health
+```
+
+期望输出：`{"status":"UP"}`
+
+---
+
+## 步骤 3：运行验证脚本
+
+打开**终端 3**，执行：
+
+```bash
+cd /media/zebra/9e8fa357-7db6-4d70-88ed-d5de5a059a663/星河湾星中星/源码/maven-cw-elevator-application/tools/visitor_floor_verification
+python3 scripts/verify_org_policy_fix.py --elevator-base-url http://127.0.0.1:18081
+```
+
+期望输出：
+
+```
+=== Phase 2: run 7 cases ===
+[T1] 有策略→allow替换floorList        → ✅
+[T2] 无策略→floorList                  → ✅
+[T3] allow含无效zone→拒绝 (76260533)   → ✅
+[T4] 多组织命中第一个策略               → ✅
+[T5] enabled=0等同无策略               → ✅
+[T6] UC-02策略优先                     → ✅
+[T7] 广发基金迁移验证                   → ✅
+
+Passed: 7/7
+```
+
+报告文件：`report/org-policy-fix-verify-YYYYMMDD-HHMMSS.json`
+
+---
+
+## 步骤 4：停止服务
+
+```bash
+# 终端1 按 Ctrl+C
+# 终端2 按 Ctrl+C
+```
+
+---
+
+## 故障排查
+
+| 症状 | 原因 | 解决 |
+|------|------|------|
+| V2 启动报 `RedisConnectionException` | Redis 密码未配置或端口错误 | 确认 `v2-test-redis` 运行中：`docker ps \| grep v2-test-redis` |
+| V2 报 `UnknownHostException: mysql_01` | ShardingSphere 数据源未覆盖 | 确认使用了 `--spring.config.location=file:/tmp/v2-redis-fix.properties` |
+| 桩服务端口被占用 | 上次未正常退出 | `pkill -f stub_org_service` |
+| 验证脚本 `Connection refused` | V2 或桩未启动 | 检查终端 1/2 的服务日志 |
+| DB 连接失败 | MySQL 密码错误 | 确认 `192.168.3.12:3307 root/123456` 可达 |
+
+---
+
+## 本地 Docker 基础设施
+
+| 服务 | 容器名 | 端口 | 说明 |
+|------|--------|------|------|
+| Redis | `v2-test-redis` | 6380 | 密码 `1qaz!QAZ` |
+| Kafka | `ybs-kafka` | 9092 | 无认证 |
+| Consul | — | 192.168.3.12:8500 | 远程 |
+| MySQL | — | 192.168.3.12:3307 | root/123456 |
+
+如需重建 Redis：
+
+```bash
+docker rm -f v2-test-redis
+docker run -d --name v2-test-redis -p 6380:6379 redis:7-alpine --requirepass "1qaz!QAZ"
+```