charging-cabinet/tools/mock_redis.py
12451 471b61d277 fix(test)+fix(deploy)+docs: 探针状态语义反转修复、退出码补齐、文档校订
1) probe_export.py:任务状态语义**搞反了**(导出成功也会被判失败)
   - download_tasks.status 的权威语义是 0 排队 / 1 处理中 / **2 完成** / 3 失败
     (db/migrate.rs:225 列注释;写入侧 charge_records.rs::mark_task_completed 写的就是 2)。
   - 该脚本此前**等 status == 1(处理中)当成功、把 status == 2(完成)判成"导出失败"**
     —— 典型假红。已按权威语义订正,并与另外两处**本来就正确**的口径对齐:
     web/src/pages/charge-records/DownloadCenter.tsx::statusText、
     test/schema_alignment_e2e.py(等 status in (2,3) 再断言 == 2)。
   - 同批修正退出码分类:账号缺 charge_record:export(403)由 exit 1 改为
     **exit 2「未验证」** —— 本项要验证的是"降权成 pms 后能否往 exports/ 落盘",
     没权限根本走不到那一步,报 1 是**把夹具缺陷说成产品缺陷**(误报与假绿同样有害)。
   - 允许用 PMS_PROBE_PHONE / PMS_PROBE_PASSWORD 换成有权限的账号。
   - **C 项结论(由落盘物证直接判定,不依赖该脚本)**:测试环境
     exports/充电记录__-.xlsx 5559 B、生产同类产物 5457 B,属主均为 pms:pms;
     两环境 exports/uploads 目录均 pms:pms,两 api-server 单元均 User=pms/Group=pms
     ⇒ 降权进程确实能落盘。已在 README 写明并给出取证依据。

2) deploy-prod.ps1 的退出码(此前失败的探针只打印 ❌ 就继续,脚本仍以 0 退出)
   - 消费链路探测失败(exit 1)现在**记入失败清单**并以 exit 1 收尾;
     "未验证"(隧道没起)默认仍不计失败(环境问题会误报),
     但新增 **-StrictVerify** 开关供 CI/无人值守使用,打开即 exit 1。
   - 好处:把这条从"打印了 ❌ 却 exit 0"(仓库第 8 条假绿)里摘出来。

3) 统一退出码 0/1/2 落地到本批脚本,并对每个失败路径实测取证:
   - test/tcp_e2e_smoke.py:13/13 通过(含未登录业务报文被静默丢弃);先复位夹具再跑。
   - test/security-hardening/ 新增 verdict.py 判据容器(未跟踪 → 本次入库);
     4 个探针全部按失败→exit 1 改造,并各实测过失败路径。
   - 实测结果(2026-09-20 发布后回归):smoke_prod 4/4 exit 0、
     probe_prod 5/5 exit 0、probe_upload 6/6 exit 0。

4) 工具与文档
   - tools/db.py 默认库由**生产 pms 改为测试 pms_dev**(可用 PMS_MYSQL_DB 覆盖,
     切生产时打印醒目警告)—— "以为在测测试库、实际打生产"的隐患。
   - tools/db_schema_diff.py:连不上必须是 exit 2,绝不伪装成"无漂移"的 0。
   - 新增 tools/dev-tunnel.ps1(入库,SSH 隧道;口令走 PMS_SSH_PASSWORD 环境变量),
     配套 tools/dev-tunnel-run.ps1 自愈启动器**保持 gitignore**(内含口令)。
   - deploy/nginx/nginx.conf 镜像随线上同步(移除 stream 转发;与线上逐字节一致)。
   - AGENTS.md / README.md:补「踩过的坑」第 7/8 条(掐断上游管道会杀被测进程、
     打印 ❌ 却 exit 0 是假绿)、退出码约定、本地开发改 SSH 隧道、
     在线判据口径订正、order_timeout 守门补齐、小程序 vue-tsc 门禁与其抓到的两个真 BUG。

发布验收(本次统一发布,按 device→api 顺序):
- 测试环境与生产环境四服务 active,端口 9000/9001/3000/3001 正确,ERROR 均为 0;
- 生产迁移按判据 grep '更新列注释' 实测对齐 cabinets.status 列注释;
- 结构漂移 python tools/db_schema_diff.py = 0 处漂移 / exit 0(--vs-ddl 两库同样 0);
- schema_alignment_e2e --env dev 全部通过 exit 0;
- 生产域名 /api/pms/cabinets -> 401、/pms/ -> 200;消费链路探测通过。
2026-09-20 04:31:42 +08:00

162 lines
4.9 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

#!/usr/bin/env python3
"""
Redis 模拟数据填充工具
- 从数据库读取前10个设备
- 生成随机状态写入Redis(设备级+板级+通道级)
- 300秒后自动过期(与设备上报TTL一致)
用法:
python tools/mock_redis.py # 填充模拟数据
python tools/mock_redis.py --clear # 清除所有模拟数据
"""
import os
import sys
import json
import random
import redis
import pymysql
# 默认指向 SSH 隧道(tools/dev-tunnel.ps1),不再使用已移除的 ZeroTier/nginx 转发
# Redis 配置
REDIS_HOST = os.environ.get("PMS_REDIS_HOST", "127.0.0.1")
REDIS_PORT = int(os.environ.get("PMS_REDIS_PORT", "16379"))
REDIS_PASSWORD = "Hbhyg731024@"
REDIS_DB = 5
# MySQL 配置
MYSQL_HOST = os.environ.get("PMS_MYSQL_HOST", "127.0.0.1")
MYSQL_PORT = int(os.environ.get("PMS_MYSQL_PORT", "13306"))
MYSQL_USER = "root"
MYSQL_PASSWORD = "Hbhyg731024@"
MYSQL_DB = "pms"
# 设备数量
DEVICE_COUNT = 10
# 通道状态: 0=空闲, 1=插入, 2=充电中, 3=充满, 4=故障
STATUS_IDLE = 0
STATUS_INSERTED = 1
STATUS_CHARGING = 2
STATUS_FULL = 3
STATUS_FAULT = 4
def get_devices():
"""从数据库获取前N个设备"""
conn = pymysql.connect(
host=MYSQL_HOST, port=MYSQL_PORT, user=MYSQL_USER,
password=MYSQL_PASSWORD, database=MYSQL_DB, charset="utf8mb4"
)
try:
with conn.cursor(pymysql.cursors.DictCursor) as cur:
cur.execute("""
SELECT c.imei, c.abstract_id, c.name,
(SELECT COUNT(*) FROM cabin_boards cb WHERE cb.cabinet_id = c.id) as board_count
FROM cabinets c ORDER BY c.id LIMIT %s
""", (DEVICE_COUNT,))
return cur.fetchall()
finally:
conn.close()
def gen_channel_hex(status: int) -> str:
"""生成单通道hex(4字节=8个hex字符)"""
# 字节1: bit0=在线 bit1=充电中 bit2=充满 bit3=故障
byte1 = 0x01 # 在线
if status == STATUS_CHARGING:
byte1 |= 0x02
elif status == STATUS_FULL:
byte1 |= 0x04
elif status == STATUS_FAULT:
byte1 |= 0x08
# 字节2-4: 随机(模拟电压电流等)
byte2 = random.randint(0x10, 0x60)
byte3 = random.randint(0x00, 0xFF)
byte4 = random.randint(0x00, 0xFF)
return f"{byte1:02x}{byte2:02x}{byte3:02x}{byte4:02x}"
def gen_board_status_hex(board_idx: int) -> str:
"""生成一块板6个通道的status_hex"""
parts = []
for ch in range(6):
# 随机分配状态,充电和故障少一些
r = random.random()
if r < 0.02:
status = STATUS_FAULT
elif r < 0.25:
status = STATUS_CHARGING
elif r < 0.32:
status = STATUS_FULL
elif r < 0.42:
status = STATUS_INSERTED
else:
status = STATUS_IDLE
parts.append(gen_channel_hex(status))
return "".join(parts)
def fill_mock_data():
"""填充模拟数据"""
r = redis.Redis(host=REDIS_HOST, port=REDIS_PORT, password=REDIS_PASSWORD, db=REDIS_DB, decode_responses=True)
devices = get_devices()
print(f"获取到 {len(devices)} 个设备")
for dev in devices:
imei = dev["imei"]
board_count = dev.get("board_count") or 6
device_key = f"device:{imei}"
# 设备级
r.hset(device_key, mapping={
"online": "1",
"rssi": str(random.randint(30, 95)),
"pow_fail_dc": random.choice(["0", "0", "0", "1"]), # 25%概率停电
"pow_fail_ac": "0",
})
r.expire(device_key, 300)
# 板级 + 通道级
for board_idx in range(1, board_count + 1):
board_key = f"{device_key}:board:{board_idx}"
status_hex = gen_board_status_hex(board_idx)
r.hset(board_key, mapping={"status_hex": status_hex})
# 解析6个通道
for ch in range(6):
ch_hex = status_hex[ch * 8 : (ch + 1) * 8]
byte1 = int(ch_hex[0:2], 16)
ch_key = f"{board_key}:ch:{ch}"
r.hset(ch_key, mapping={
"on": "1" if byte1 & 0x02 else "0",
"full": "1" if byte1 & 0x04 else "0",
"fault": "1" if byte1 & 0x08 else "0",
"hex": ch_hex,
})
name = dev.get("name") or imei
print(f" ✓ {name} ({imei}) — {board_count}板")
print(f"\n完成!已填充 {len(devices)} 个设备,300秒后自动过期")
def clear_mock_data():
"""清除所有模拟数据"""
r = redis.Redis(host=REDIS_HOST, port=REDIS_PORT, password=REDIS_PASSWORD, db=REDIS_DB, decode_responses=True)
devices = get_devices()
count = 0
for dev in devices:
imei = dev["imei"]
keys = r.keys(f"device:{imei}*")
if keys:
r.delete(*keys)
count += len(keys)
print(f"已清除 {count} 个 Redis key")
if __name__ == "__main__":
if "--clear" in sys.argv:
clear_mock_data()
else:
fill_mock_data()