[Test] Invite Code (M0 Critical Path)

[wanghuan-520]

Background

NyxID M0 goal: first external user (deadline 2026-04-18).
External users are identified via invite code registration.
Invite code is on the M0 critical path.

Test Scope

Code Generation

• Admin can generate invite codes
• Code format is correct and shareable
• Admin can set max uses for invite codes
• Admin can deactivate invite codes
• Admin can view invite code usage records in the UI

Registration Flow

• User must provide an invite code during registration
• External user can register successfully with a valid invite code
• Registration is rejected when the invite code is missing
• Registration is rejected when the invite code is invalid
• Registration is rejected when the invite code is exhausted
• Registration is rejected when the invite code is deactivated
• Invite code usage is only counted after registration succeeds

Code State

• Single-use code cannot be reused after first successful registration
• Code with max uses = 10 is rejected on the 11th successful registration attempt
• Code usage count is updated after successful registration
• [~] Code usage is traceable: API returns user_id and used_at, but the admin UI has no visible usage-record entry

Related

• M0 deadline: 2026-04-18

[loning]

感谢主动跑 M0 关键路径测试 — 邀请码是 M0 readiness 的直接信号。

测试结论是什么？如果流程 OK 请在这里更新结果，我们需要这个数据点确认 M0 ready。如果有问题也请列出具体卡点。

[wanghuan-520]

邀请码注册 QA 总结

测试环境：https://nyx.chrono-ai.fun

关联需求：#179 feat: 邀请码注册 — 需邀请码才可注册，每码限 10 人

结论

邀请码注册核心链路整体可用，#179 的主要注册门禁、次数限制、作废限制都已验证通过。

当前 #179 范围内主要剩余两个问题：

1. 管理端 UI 仍缺少邀请码使用记录入口。API 层已经返回 usages，包含 user_id 和 used_at，但页面上只能看到汇总次数，例如 10/10，管理员无法直接在 UI 上查看“谁用了、什么时候用的”。
2. 第三方注册方式暂未接入邀请码流程。目前邀请码只对 Email 注册方式生效，Google、GitHub、Apple 三种第三方注册方式暂未使用邀请码。该问题开发已知，正在修复中，暂未单独提交 bug。

已验证通过

• 管理员可以创建邀请码。
• 管理员可以查看邀请码列表。
• 管理员可以作废邀请码。
• 作废后的邀请码不可再用于注册。
• 注册页必须填写邀请码；空邀请码会被前端拦截。
• 无效邀请码会被拒绝。
• 已作废邀请码会被拒绝。
• 已用尽邀请码会被拒绝。
• 有效邀请码可以完成注册。
• 邀请码输入支持 trim 和大小写不敏感，例如带前后空格的小写邀请码可注册成功。
• max_uses=1 邀请码首次注册成功后，第二次使用会被拒绝。
• max_uses=10 边界通过：同一个邀请码前 10 次注册成功，第 11 次注册被拒绝。
• 注册失败不会错误消耗邀请码次数：
  • 弱密码 + 有效邀请码：前端拦截，未发起注册请求，邀请码次数未增加。
  • 密码不一致 + 有效邀请码：前端拦截，未发起注册请求，邀请码次数未增加。
  • 已存在邮箱场景：邀请码次数未增加。
• 管理端创建表单的 max_uses 前端边界校验通过：
  • 0 被拦截。
  • -1 被拦截。
  • 1001 被拦截。
  • 1.5 被拦截。
• 管理端创建表单的 note 长度限制通过：输入 520 字符后实际被限制为 512。
• 普通用户访问 /admin/invite-codes 不会看到邀请码管理列表，会回到普通 dashboard。

已发现并提交的问题

• [Bug][Invite Code Registration] Invite code usage records are not visible in the admin UI #245 [Bug][Invite Code Registration] Invite code usage records are not visible in the admin UI

  • feat: 邀请码注册 — 需邀请码才可注册，每码限 10 人 #179 要求记录每个邀请码的使用情况。
  • API 已返回使用记录，但管理端页面没有可见的详情 / 历史 / 使用记录入口。

• [Bug][Invite Code Registration] Invite code registration errors do not distinguish invalid, exhausted, and deactivated states #246 [Bug][Invite Code Registration] Invite code registration errors do not distinguish invalid, exhausted, and deactivated states

  • 无效、已用尽、已作废邀请码在注册页都展示相同提示：Bad request: Invalid or exhausted invite code。
  • 如果产品希望刻意隐藏具体原因，这条可以按产品策略确认；否则建议给出更明确的错误提示。

• [Bug][Registration] Existing email registration shows a success message #248 [Bug][Registration] Existing email registration shows a success message

  • 使用已存在邮箱注册时，页面 / 接口返回注册成功提示。
  • 这条不是邀请码功能本身的问题，但会让用户困惑。

• [Bug][Web] Preloaded DM Serif Text font file returns 404 #249 [Bug][Web] Preloaded DM Serif Text font file returns 404

  • 字体资源 404，和邀请码功能无直接关系，已作为普通 Web 资源问题提交。

已知但未提交的问题

• 邀请码目前只对 Email 注册方式生效；Google、GitHub、Apple 三种第三方注册方式注册暂未使用邀请码。
• 该问题开发已知，正在修复中，暂未单独提交 bug。

当前建议

如果按 #179 判断，邀请码功能可以认为 Email 注册核心链路基本可用，但还不能完全关闭需求，因为管理端 UI 缺少使用记录查看入口，且第三方注册方式暂未接入邀请码流程。建议优先处理 #245 和第三方注册接入问题；#246 可由产品确认是否需要区分错误原因。