liufumingren 9b1f656790 feat: notify.reply 支持 extend_props.do 动作(openDoor / registerLicensePlate)
入站通知新增两条相互独立的处理线:文本回复 + 动作指令。

- content trim 后为空(含纯空白)→ 不对外发送,并跳过 IM 通道在线检测,
  避免纯动作请求被 503 拒绝、WMS 反复重试;ext_id 幂等去重仍生效。
- extend_props.do 映射到 notify/action/ 下的动作类(大小写不敏感),
  extend_props.value 为泛类型入参(字符串/数字/布尔/对象/数组/JSON/null)。
- 新增 openDoor:Redis db2 写 {WAREHOUSEID}_channelNum{N}(TTL 300s)+ 写 door_log。
- 新增 registerLicensePlate:Redis db7 写 {WAREHOUSEID}_{车牌} NX EX 21600(6 小时临时通行),
  与 Chat::daohuo()/tihuo() 同一套机制,入口设备读到即放行并删键。
- 公共能力(Redis 连接、仓库解析、操作人解析、车牌提取)上移到 action/Base,
  两个动作共用;仓库解析顺序:value.warehouseId → group_id 反查群 → 默认 5400。
2026-09-16 21:10:15 +08:00

284 lines
9.4 KiB
PHP
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.

<?php
namespace app\index\library\new_wms\notify\action;
/**
* extend_props.do 动作基类
*
* 入站通知的 data.extend_props 携带动作指令:
* {
* "do": "openDoor", // 动作名 → ActionDispatcher 映射到具体类
* "value": <任意类型> // 隐藏入参,泛类型:字符串/数字/布尔/对象/数组/null
* }
*
* value 的语义由各子类自行解释(见各子类注释),基类只做归一化,方便子类按键取值。
*
* 约定:
* - 子类实现 run(),返回数组:会写进接口响应与日志,便于排查
* - 执行失败直接 throw \Exception,由 ActionDispatcher 统一捕获记录,不影响文本回复
*/
abstract class Base
{
/**
* extend_props.value 原始值(泛类型,未做任何转换)
* @var mixed
*/
protected $value;
/**
* 通知 data 原文(group_id / user_id / user_name / group_name / ext_id ...)
* @var array
*/
protected $data = [];
/**
* 动作名(与 extend_props.do 对应)
* @return string
*/
abstract public function name();
/**
* 执行动作
*
* @param mixed $value extend_props.value,泛类型
* @param array $data 通知 data 节点
* @return array 执行结果(写入接口响应与日志)
* @throws \Exception 执行失败时抛出
*/
abstract public function run($value, array $data);
/**
* 统一入口:先固化上下文,再执行
*
* @param mixed $value
* @param array $data
* @return array
*/
public function execute($value, array $data)
{
$this->value = $value;
$this->data = $data;
return $this->run($value, $data);
}
// ==================== 公共能力:Redis / 仓库 / 操作人 / 车牌 ====================
/** Redis 连接信息(与项目其它地方的硬编码保持一致) */
const REDIS_HOST = '127.0.0.1';
const REDIS_PORT = 6379;
const REDIS_AUTH = 'qwe2019@';
/** 查不到群对应仓库时的兜底仓库(与 Chat::openD 的硬编码保持一致,子类可覆盖) */
const DEFAULT_WAREHOUSE_ID = 5400;
/** 放行缘由中文名(与 Wms::plateresult 的映射保持一致) */
const TYPE_TEXT = ['daohuo' => '到货', 'tihuo' => '提货'];
/**
* 连接 Redis 并选择库
*
* @param int $db 库号
* @return \Redis
*/
protected function redis($db)
{
$redis = new \Redis();
$redis->connect(static::REDIS_HOST, static::REDIS_PORT);
$redis->auth(static::REDIS_AUTH);
$redis->select($db);
return $redis;
}
/**
* 解析仓库 ID
*
* 顺序:value.warehouseId →(按通知里的 group_id 反查 qiwe_rooms/rooms)→ 兜底仓库
*
* @param array $data 通知 data 节点
* @return array ['id' => int, 'from' => string]
* @throws \Exception 三者都取不到时抛出
*/
protected function resolveWarehouseId(array $data)
{
// 1. value 里显式指定
$fromValue = $this->param(['warehouseId', 'warehouse', 'wmsWarehouseId']);
if (is_numeric($fromValue) && intval($fromValue) > 0) {
return ['id' => intval($fromValue), 'from' => 'value'];
}
// 2. 按群 ID 反查(企微群优先,再查微信群)
$groupId = isset($data['group_id']) ? trim(strval($data['group_id'])) : '';
if ($groupId !== '') {
try {
$room = (new \app\common\model\qiwe\Rooms())->where(['room_id' => $groupId])->find();
if (!$room) {
$room = (new \app\common\model\Rooms())->where(['room_id' => $groupId])->find();
}
if ($room && intval($room['WAREHOUSEID']) > 0) {
return ['id' => intval($room['WAREHOUSEID']), 'from' => "group:{$groupId}"];
}
} catch (\Exception $e) {
\think\Log::error('[' . $this->name() . "] 反查群仓库失败: " . $e->getMessage());
}
}
// 3. 兜底默认仓库
if (static::DEFAULT_WAREHOUSE_ID > 0) {
return ['id' => static::DEFAULT_WAREHOUSE_ID, 'from' => 'default'];
}
throw new \Exception('无法确定仓库,请在 extend_props.value 里指定 warehouseId');
}
/**
* 解析操作人(写日志用):value.username → 通知里的 user_name → '-'
*
* @param array $data
* @return string
*/
protected function resolveUsername(array $data)
{
$username = $this->param(['username', 'userName', 'operator']);
if ($username !== null && !is_array($username) && !is_object($username) && trim(strval($username)) !== '') {
return trim(strval($username));
}
$userName = isset($data['user_name']) ? trim(strval($data['user_name'])) : '';
return $userName !== '' ? $userName : '-';
}
/**
* 从文本中提取车牌号(正则与 Chat::extractLicensePlates 保持一致,如需调整请两处同步)
*
* @param string $string
* @return array 提取到的车牌列表
*/
protected static function extractLicensePlates($string)
{
if (!is_string($string) || $string === '') {
return [];
}
$pattern = '/
(?:[京津沪渝冀豫云辽黑湘晩鲁新苏浙赣鄂桂甘晋蒙陕吉闽贵粤青藏川宁琼使领][A-Z]| # 普通省份简称+字母
京[A-Z]| # 北京特殊格式
沪[A-Z]| # 上海特殊格式
浙[A-Z]| # 浙江特殊格式
苏[A-Z]| # 江苏特殊格式
粤Z) # 港澳车牌
[A-Z0-9]{4,6} # 4-5位字母数字组合
|WJ\d{4}[A-Z0-9] # 武警车牌
|[军海空北沈兰济南广成]\w{5} # 军车车牌
|\d{6}使 # 使馆车牌另一种格式
/xu';
preg_match_all($pattern, $string, $matches);
return isset($matches[0]) ? $matches[0] : [];
}
// ==================== 泛类型 value 处理工具 ====================
/**
* 把泛类型 value 归一化成关联数组,便于统一按键取值
*
* null / '' / [] → []
* 对象 → (array) 转换
* 数组 → 原样返回
* JSON 字符串 → 解码为数组('{...}' / '[...]')
* 其他字符串 / 数字 / 布尔 → ['value' => 原值]
*
* @return array
*/
protected function valueParams()
{
$value = $this->value;
if ($value === null || $value === '' || $value === []) {
return [];
}
if (is_object($value)) {
return (array) $value;
}
if (is_array($value)) {
return $value;
}
if (is_string($value)) {
$trim = trim($value);
if ($trim !== '' && ($trim[0] === '{' || $trim[0] === '[')) {
$json = json_decode($trim, true);
if (is_array($json)) {
return $json;
}
}
return ['value' => $trim];
}
return ['value' => $value];
}
/**
* 按候选键名取值(忽略大小写、下划线、中划线差异)
*
* $this->param(['warehouseId', 'WAREHOUSEID']) 等价于取 warehouse_id / warehouseid / warehouse-id ...
*
* @param array $keys 候选键名列表
* @param mixed $default 取不到时的默认值
* @return mixed
*/
protected function param(array $keys, $default = null)
{
$params = $this->valueParams();
if (!$params) {
return $default;
}
// 归一化参数键:小写 + 去掉 _ -
$normalized = [];
foreach ($params as $k => $v) {
$normalized[self::normalizeKey($k)] = $v;
}
foreach ($keys as $key) {
$nk = self::normalizeKey($key);
if (array_key_exists($nk, $normalized)) {
return $normalized[$nk];
}
}
return $default;
}
/**
* 判断 value 是否为「对象/数组」形态(而非标量)
* @return bool
*/
protected function isStructuredValue()
{
$value = $this->value;
if (is_array($value) || is_object($value)) {
return true;
}
if (is_string($value)) {
$trim = trim($value);
return $trim !== '' && ($trim[0] === '{' || $trim[0] === '[');
}
return false;
}
/**
* 键名归一化:小写并去掉 _ - 空格
* @param mixed $key
* @return string
*/
protected static function normalizeKey($key)
{
return str_replace(['_', '-', ' '], '', strtolower((string) $key));
}
}