---

req_id: REQ-USR-003 date: 2026-05-08 round: 2

reviewer: superpower-code-reviewer

Review: REQ-USR-003 — round 2

结论

request-changes

Must-fix

• [major] docs/05-API接口契约.md:27 — 全局分页约定仍使用 pageNum，而 REQ-USR-003 具体接口入参与响应已修为 page，文档内部矛盾（建议：将第 27 行全局约定中的 pageNum 统一改为 page，与实际实现保持一致）

Nice-to-have

• docs/05-API接口契约.md:77 — staffName/department 的 equals matchType 对 NULL 员工的行为未记录在文档，建议补充说明（equals NULL 用户会被 JOIN 过滤掉）

反例 / 测试覆盖缺口

• T1: 缺少针对 notContains NULL 修复的集成测试（验证 staffName/department 为 NULL 的用户确实出现在 notContains 结果中）
• T2: 前端 queryField/matchType 未做枚举校验，非法值直接透传给后端（后端也无校验，可在后续迭代补充）