入站通知新增两条相互独立的处理线:文本回复 + 动作指令。
- 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。
254 lines
8.9 KiB
PHP
254 lines
8.9 KiB
PHP
<?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'])) : '';
|
||
}
|
||
}
|