VWCG-1380 实施与变更记录

日期：2026-09-17；仓库：store；分支：codex/VWCG-1380-resolve-paycode-user。

实施内容

  1. 新增 POST /api/consume/paycodeUserInfo；按调整后的契约移除该接口的 checkApiAuth，orderPay 鉴权保持不变。
  2. PaycodeUserResolver 接收 paycode 和 equipment_code，先校验未删除设备，再规范化并校验个人付款码，读取用户及组织人员。
  3. 响应只包含 staff_uuid 和 staff_name。
  4. 新增设备缺参、无效设备专项单元测试并更新 OpenAPI 契约与鉴权矩阵。
  5. 将本查询接口的付款码状态错误文案统一调整为“该码不存在”“该码已使用”“该码已过期”；不修改 orderPay 文案。
  6. 根据线上 SQL 异常修复组织人员查询：ydy_staff 使用实际有效状态字段 is_show=1，并新增真实表结构回归测试，避免模型桩掩盖字段错误。

边界与副作用

验证结果

检查项结果
PaycodeUserInfoTest9 tests，16 assertions，通过
OpenApiControllerContractValidationTest20 tests，60 assertions，通过
OpenApiGuardMatrixTest6 tests，17 assertions，通过
PaymentCodeClassifierTest12 tests，12 assertions，通过
PaycodeUserResolverDatabaseTest1 test，2 assertions，通过；覆盖 ydy_staff.is_show 真实模型查询
PHP 7.3 语法检查通过
全量 PHPUnit既有 ProfilePreservationTest.php 与 tests/bootstrap.php 重复声明 config()，测试发现阶段终止；本次未触碰该文件

回滚：撤销本任务对应提交；本次无数据变更。

交付信息