# 企业微信获客配置验证记录

日期：2026-08-31。

## 已完成的验证

- 单选与自定义标签：`QywxPromotionCreateTagTest.php`、`WecomPromotionCreateTagControllerTest.php` 及配置/前端 helper 回归通过。覆盖同组复用、新建分组/已有分组参数、并发冲突和网络不确定时只读回确认、非法名称、页面权限、POST 限制及拒绝多选。隔离浏览器验证单选替换、自定义空值提示、创建期间禁止保存、失败保留原标签、创建成功选中真实响应 ID、最终仅提交一个 ID，以及旧多选配置要求重新选择。未创建真实企微标签。
- 迁移修复复验：已修正 `welcome_cipher` 列注释中非法的 `COMMENT=`。在独立临时 MySQL 5.7.26 实例先创建前两张表并写入一条标记记录，再完整执行迁移两次；四张表均存在，字段注释正确，标记记录保持原值。未连接或修改业务数据库。
- `QywxPromotionAutomationConfigTest.php`：接待时段起止边界、跨午夜和跨周、主接待优先、日上限和跨日重置、备用禁用、无可用成员、非法配置、分时欢迎语重叠、昵称/日期模板、备注长度、欢迎语 UTF-8 字节限制。
- `QywxPromotionContactApiServiceTest.php`、`QywxPromotionMediaServiceTest.php`、`QywxPromotionAutomationServiceTest.php`：官方接口参数、Secret 选择、令牌失效重试、HTTP 不确定结果、素材权限/真实 MIME/私有路径/缓存刷新、欢迎码加密、重复事件、半客户、20 秒时效、分动作补偿和数据库异常触发回调重试。测试使用 HTTP mock 与内存存储，不连接业务数据库。
- `QywxPromotionCodeCipherTest.php`：6 个隔离 PHP 进程首次启动共用完整密钥、随机密文、篡改/错误密钥拒绝、损坏密钥不自动覆盖；仅使用临时目录。
- 原有成员范围、获客链接 URL、获客 API HTTP mock、获客事件重试、推广浮窗、删除契约及操作人权限契约测试通过。
- 浏览器使用独立 Vite 测试入口和虚构数据，替换 API 模块，未请求真实业务接口：验证排班缺项阻止保存、备用候选排除主接待、企业标签选择、渠道欢迎语变量与手机预览、网页附件编辑、客户备注预览和描述，最终保存参数与服务端配置契约一致。浏览器控制台无运行错误。
- 三个新增/修改 Vue 单文件组件编译通过，前端配置 helper 12 项边界断言通过。
- 完整 Vite 生产构建成功（4057 个模块），产物输出到隔离临时目录，没有执行 `release.mjs`，没有覆盖 `server/public/admin`。现有大型 bundle 和第三方播放器 `eval` 警告仍存在。
- 全项目 `vue-tsc --noEmit` 仍有 61 条其他文件的既存错误，本次推广页面、两个新组件、helper 和 API 文件未报错。未扩大范围修复其他模块。

## 验证边界

未向真实企业微信客户发送欢迎语、打标签、修改备注或上传测试素材；未执行生产数据库迁移。正式部署后仍须验证当前企业可调用应用的权限、成员可见范围、接收回调配置、后台欢迎语互斥、常驻进程和真实素材下发结果。

分钟调度存在传播时延；官方直链已打开或在途的好友请求无法由本地上限保证即时撤回。所有成员不可用时保留明确阻塞状态，不声称远端链接已停用。