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

254 lines
8.9 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;
/**
* registerLicensePlate — 登记车牌临时通行
*
* 与 Chat::daohuo() / Chat::tihuo() 同一套机制:
* 在 Redis db7 写 {WAREHOUSEID}_{车牌} = {roomName, UserName, type, ...},有效期 6 小时;
* 车辆到入口时 Wms::plateresult() 读到该键 → 抬杆放行 + 播报欢迎语,
* 并把「临时车辆入场」消息发到该仓库的开门群,随后删除该键(一次性,出场不再校验)。
*
* extend_props.value 支持(泛类型):
* "粤EH22E2" → 直接登记该车牌(默认 type=daohuo 到货)
* "提货 粤EH33333" / "到货+粤EH22E2" → 从文本里提取车牌,并按关键字推断缘由
* {"carnum":"粤EH22E2"} → 指定车牌
* {"carnum":"粤EH22E2","type":"tihuo","warehouseId":5400,
* "roomName":"测试群","username":"刘付明仁","storeId":123}
*
* 说明:
* - 写入用 NX 语义:车牌已在临时通行中时不覆盖、不重置 6 小时有效期(与 Chat::daohuo 一致)
* - 车牌识别:先统一大写再走正则(兼容小写、文本夹带);
* 自由文本必须能识别出标准车牌,否则报「未识别到车牌号」(避免把聊天正文当车牌登记);
* 非标准车牌(如临时牌)请用对象形式显式传 carnum。
* - type 仅支持 daohuo(到货) / tihuo(提货),默认 daohuo;Wms::plateresult 会把它翻译成放行缘由
* - 仓库 ID 由 Base::resolveWarehouseId() 解析(value → 群ID反查 → 默认 5400)
*/
class RegisterLicensePlate extends Base
{
/** Redis 库号(与 Chat::daohuo / Wms::plateresult 保持一致) */
const REDIS_DB = 7;
/** 临时通行有效期(秒):6 小时 */
const KEY_TTL = 21600;
/** 默认放行缘由 */
const DEFAULT_TYPE = 'daohuo';
/** 中文缘由 → 内部 type(与 Wms::plateresult 的 $types 映射保持一致) */
const TYPE_ALIAS = [
'到货' => 'daohuo',
'拉货' => 'daohuo',
'到访' => 'daohuo',
'提货' => 'tihuo',
];
public function name()
{
return 'registerLicensePlate';
}
public function run($value, array $data)
{
$carnum = $this->resolveCarnum();
if ($carnum === '') {
$json = json_encode($value, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
throw new \Exception('未识别到车牌号: ' . ($json === false ? var_export($value, true) : $json));
}
$warehouse = $this->resolveWarehouseId($data);
$type = $this->resolveType();
$roomName = $this->resolveRoomName($data);
$username = $this->resolveUsername($data);
$payload = [
'roomName' => $roomName,
'UserName' => $username,
'type' => $type,
'source' => 'new_wms',
'ext_id' => isset($data['ext_id']) ? strval($data['ext_id']) : '',
'registered_at' => date('Y-m-d H:i:s'),
];
$storeId = $this->param(['storeId', 'storeid', 'STOREID']);
if (is_numeric($storeId) && intval($storeId) > 0) {
$payload['STOREID'] = intval($storeId);
}
$redisKey = "{$warehouse['id']}_{$carnum}";
$redis = $this->redis(self::REDIS_DB);
// NX:已登记的车牌不覆盖、不重置有效期
$ok = $redis->set(
$redisKey,
json_encode($payload, JSON_UNESCAPED_UNICODE),
['NX', 'EX' => self::KEY_TTL]
);
if ($ok === false || $ok === null) {
// 已存在:读回原登记信息与剩余有效期,不重置
$old = json_decode(strval($redis->get($redisKey)), true);
$ttl = $redis->ttl($redisKey);
return [
'registered' => false,
'msg' => '该车牌已在临时通行中,未重置有效期',
'carnum' => $carnum,
'warehouseId'=> $warehouse['id'],
'warehouseBy'=> $warehouse['from'],
'redisKey' => $redisKey,
'redisDb' => self::REDIS_DB,
'remain' => ($ttl > 0 ? $ttl : null),
'exist' => is_array($old) ? $old : null,
];
}
return [
'registered' => true,
'msg' => '登记成功',
'carnum' => $carnum,
'warehouseId'=> $warehouse['id'],
'warehouseBy'=> $warehouse['from'],
'redisKey' => $redisKey,
'redisDb' => self::REDIS_DB,
'type' => $type,
'typeText' => self::TYPE_TEXT[$type] ?? $type,
'ttl' => self::KEY_TTL,
'expireAt' => date('Y-m-d H:i:s', time() + self::KEY_TTL),
'roomName' => $roomName,
'username' => $username,
];
}
// ==================== 参数解析 ====================
/**
* 解析车牌号
*
* value.carnum/plate → 标量 value → 结构化 value 各标量值拼接,然后统一走车牌正则;
* 自由文本必须能识别出标准车牌,只有显式传的 carnum 字段才允许非标准格式。
*
* @return string 大写车牌,取不到返回 ''
*/
private function resolveCarnum()
{
$explicit = $this->param(['carnum', 'plate', 'license', 'carNo']);
if (is_array($explicit) || is_object($explicit)) {
$explicit = null;
}
// 待解析原文:显式字段优先,其次标量 value,最后结构化 value 的标量值拼接
if ($explicit !== null && trim(strval($explicit)) !== '') {
$raw = trim(strval($explicit));
} elseif ($this->isStructuredValue()) {
$raw = trim(implode(' ', array_map('strval', $this->valueParams())));
} elseif (is_scalar($this->value)) {
$raw = trim(strval($this->value));
} else {
$raw = '';
}
if ($raw === '') {
return '';
}
// 1. 标准车牌:统一大写再提取(兼容小写写法与文本夹带)
$plates = self::extractLicensePlates(strtoupper($raw));
if ($plates) {
return $plates[0];
}
// 2. 显式字段允许非标准格式(如临时车牌),但必须是「像车牌的短 token」
if ($explicit !== null && $this->isPlateToken($raw)) {
return strtoupper($raw);
}
return '';
}
/**
* 是否为「像车牌的短 token」:无空白且长度 2-12
*
* @param string $text
* @return bool
*/
private function isPlateToken($text)
{
if ($text === '' || preg_match('/\s/u', $text)) {
return false;
}
$len = mb_strlen($text, 'UTF-8');
return $len >= 2 && $len <= 12;
}
/**
* 解析放行缘由:value.type → 文本关键字(到货/提货等)→ 默认 daohuo
*
* @return string daohuo / tihuo
* @throws \Exception 非法值时抛出
*/
private function resolveType()
{
$type = $this->param(['type', 'reason']);
if ($type === null || trim(strval($type)) === '') {
$type = $this->inferTypeFromText();
}
if ($type === null || trim(strval($type)) === '') {
return self::DEFAULT_TYPE;
}
$type = trim(strval($type));
if (isset(self::TYPE_ALIAS[$type])) {
$type = self::TYPE_ALIAS[$type];
}
if (!isset(self::TYPE_TEXT[$type])) {
throw new \Exception("放行缘由非法({$type}),仅支持: " . implode(' / ', array_keys(self::TYPE_TEXT)));
}
return $type;
}
/**
* 从标量 value 文本里推断放行缘由(如「提货 粤EH33333」→ tihuo)
*
* 结构化 value 只认显式 type,不做关键字猜词。
*
* @return string|null
*/
private function inferTypeFromText()
{
if ($this->isStructuredValue() || !is_scalar($this->value)) {
return null;
}
$text = strval($this->value);
foreach (self::TYPE_ALIAS as $keyword => $type) {
if (strpos($text, $keyword) !== false) {
return $type;
}
}
return null;
}
/**
* 解析放行群名(仅记录用):value.roomName → 通知里的 group_name → ''
*
* @param array $data
* @return string
*/
private function resolveRoomName(array $data)
{
$roomName = $this->param(['roomName', 'room', 'groupName']);
if ($roomName !== null && !is_array($roomName) && !is_object($roomName) && trim(strval($roomName)) !== '') {
return trim(strval($roomName));
}
return isset($data['group_name']) ? trim(strval($data['group_name'])) : '';
}
}