更新

server/sql/1.9.20260824/upgrade_qywx_promotion_member_dispatch.sql

@@ -1,4 +1,4 @@
--- 企业微信获客助手：单官方直链的成员规则与回调驱动调度
+-- 企业微信获客助手：单官方直链的成员规则与企业微信原生多人路由
 
 START TRANSACTION;
 
@@ -8,8 +8,8 @@ CREATE TABLE IF NOT EXISTS `zyt_qywx_promotion_pool_member` (
   `admin_id` int unsigned NOT NULL DEFAULT 0,
   `userid` varchar(128) NOT NULL DEFAULT '' COMMENT '企业微信 userid 快照',
   `enabled` tinyint unsigned NOT NULL DEFAULT 1,
-  `weight` smallint unsigned NOT NULL DEFAULT 1,
-  `current_weight` bigint NOT NULL DEFAULT 0 COMMENT '旧版平滑轮询游标，随机调度模式保留兼容',
+  `weight` smallint unsigned NOT NULL DEFAULT 1 COMMENT '兼容字段；企业微信原生多人路由不支持逐成员权重',
+  `current_weight` bigint NOT NULL DEFAULT 0 COMMENT '旧版调度游标，原生多人路由模式固定归零',
   `daily_limit` int unsigned NOT NULL DEFAULT 0 COMMENT '0为不限；按回调确认的实际获客计数',
   `today_count` int unsigned NOT NULL DEFAULT 0,
   `today_date` date NULL DEFAULT NULL,
@@ -30,7 +30,7 @@ CREATE TABLE IF NOT EXISTS `zyt_qywx_promotion_pool_member` (
 
 CREATE TABLE IF NOT EXISTS `zyt_qywx_promotion_dispatch_event` (
   `id` bigint unsigned NOT NULL AUTO_INCREMENT,
-  `event_key` char(64) NOT NULL COMMENT '方案+成员+客户的幂等键',
+  `event_key` char(64) NOT NULL COMMENT '方案+客户的幂等键，成员变更不重复计数',
   `pool_id` int unsigned NOT NULL DEFAULT 0,
   `member_id` bigint unsigned NOT NULL DEFAULT 0,
   `userid` varchar(128) NOT NULL DEFAULT '',
@@ -51,7 +51,7 @@ CREATE TABLE IF NOT EXISTS `zyt_qywx_promotion_range_sync` (
   `desired_version` bigint unsigned NOT NULL DEFAULT 0,
   `applied_member_id` bigint unsigned NOT NULL DEFAULT 0,
   `applied_version` bigint unsigned NOT NULL DEFAULT 0,
-  `status` tinyint unsigned NOT NULL DEFAULT 0 COMMENT '0已同步 1待同步 2同步中 3失败待重试 4无可用成员',
+  `status` tinyint unsigned NOT NULL DEFAULT 0 COMMENT '0已同步 1待同步 2同步中 3失败待重试 4阻塞 5正在永久删除',
   `attempts` int unsigned NOT NULL DEFAULT 0,
   `next_retry` int unsigned NOT NULL DEFAULT 0,
   `lock_token` char(32) NOT NULL DEFAULT '',
@@ -62,7 +62,7 @@ CREATE TABLE IF NOT EXISTS `zyt_qywx_promotion_range_sync` (
   PRIMARY KEY (`pool_id`),
   KEY `idx_pending` (`status`,`next_retry`,`lock_until`),
   KEY `idx_link` (`promotion_link_id`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='获客官方链接当前成员范围同步队列';
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='获客官方链接多人路由范围同步队列';
 
 INSERT INTO `zyt_dev_crontab` (
   `name`, `type`, `system`, `remark`, `command`, `params`,
@@ -70,7 +70,7 @@ INSERT INTO `zyt_dev_crontab` (
 )
 SELECT
   '同步企微获客分流成员', 1, 0,
-  '按回调实际承接结果、成员权重与每日上限更新同一条企业微信官方获客链接',
+  '按禁用、有效期与每日上限更新同一条企业微信官方获客链接的多人范围',
   'qywx:sync-promotion-ranges', '', 1, '* * * * *', UNIX_TIMESTAMP(), UNIX_TIMESTAMP()
 FROM DUAL
 WHERE NOT EXISTS (