Files

Shen Wei ca33cc141f 文档更新

2026-05-02 11:35:20 +08:00

23 KiB

Raw Blame History

Fonrey 登录模块测试用例文档（可自动化）

文档版本：v2.0
适用范围：PRD/登录管理/用户登录管理模块PRD.md v3.0、TECH_STACK/登录管理技术方案.md v4.1、DATA_MODEL/DATA_MODEL_LOGIN.md、TECH_STACK/API_CONTRACT.md
用例编号范围：TC-FON-000001 ~ TC-FON-000048、TC-FON-000153 ~ TC-FON-000172（全局唯一，共 68 条）
编号规范：TEST_CASES/TEST_CASE_ID_SPEC.md

变更历史

日期	变更人	变更内容
2026-04-30	Atlas	补充“变更历史”章节（文档治理）
2026-05-02	Vulcan	对齐 PRD v3.0 / 登录技术方案 v4.1 / DATA_MODEL_LOGIN：新增 20 条登录模块补充用例（TC-FON-000153~000172），覆盖 API 契约统一 envelope、`/api/auth/password/change-initial/`、管理员手动解锁、短信 OTP 明文不落库、历史密码保留 3 条、验证码登录错误作废文案、微信扫码预留端点不开放、`/api/auth/wechat/*` 路由未注册、登出接口与客户端会话清理联动等关键口径；总用例数 48→68

1. 目标与原则

本文档用于让工程师直接生成自动化测试代码（API 集成测试 + Web E2E）。
每个测试用例均包含唯一ID和步骤ID，可直接用于失败定位与测试报告。
用例覆盖登录模块 MVP 正式范围：
- Story 1：Tenant 识别
- Story 2：手机号+密码登录
- Story 3：短信找回密码
- Story 5：短信验证码登录
Story 4（找回用户名）已废弃，不实现。
Story 6（微信扫码）为预留，不实现，仅验证禁用态。

2. 自动化执行与报告要求（工程实现必须遵循）

执行层：
- API 集成：pytest + pytest-django + TenantClient
- Web E2E：playwright
每步必须输出：run_id / test_case_id / step_id / status / expected_result / actual_result / error_message
失败时必须附带：
- Web：截图路径
- API：请求响应快照 + 关键日志路径

3. 全量测试用例清单（68条）

3.0 登录模块 API 端点口径（以 `TECH_STACK/登录管理技术方案.md` §五 + `TECH_STACK/API_CONTRACT.md` 为准）

POST /api/auth/tenant/verify/
GET /api/auth/captcha/
POST /api/auth/captcha/verify/
POST /api/auth/login/
POST /api/auth/login/phone/
POST /api/auth/recover/password/request/
POST /api/auth/recover/password/verify/
POST /api/auth/recover/password/reset/
POST /api/auth/password/change-initial/
POST /api/auth/logout/

注：测试代码生成与接口调用必须使用以上路径。

A. Tenant 识别（Story 1）

TC-FON-000001 Tenant Code 页面首启展示

级别：E2E
前置：本地无 Tenant Code 缓存
步骤：
- TC-FON-000001-S01 启动应用/打开登录入口页
- TC-FON-000001-S02 检查是否进入 Tenant 识别页
- TC-FON-000001-S03 校验页面元素（Logo、文案、输入框、确认按钮）
预期：显示 Tenant 识别页且元素完整

TC-FON-000002 Tenant Code 输入去空格与粘贴

级别：E2E
前置：在 Tenant 识别页
步骤：
- TC-FON-000002-S01 粘贴 202500010001
- TC-FON-000002-S02 点击确认
- TC-FON-000002-S03 观察发送请求参数
预期：请求中的 tenant_code 为 202500010001

TC-FON-000003 Tenant Code 非12位拦截

级别：E2E
前置：Tenant 识别页
步骤：
- TC-FON-000003-S01 输入 20250001
- TC-FON-000003-S02 点击确认
- TC-FON-000003-S03 检查错误提示
预期：提示“识别码须为12位数字”，不发请求

TC-FON-000004 Tenant 验证成功流程

级别：API+E2E
前置：合法 tenant_code 存在
步骤：
- TC-FON-000004-S01 调用 POST /api/auth/tenant/verify/
- TC-FON-000004-S02 校验 valid=true 且返回租户品牌信息
- TC-FON-000004-S03 前端跳转登录页并展示“正在登录：XX房产”
预期：成功跳转并写入本地缓存

TC-FON-000005 Tenant 验证失败（无效识别码）

级别：API+E2E
前置：tenant_code 不存在
步骤：
- TC-FON-000005-S01 调用 POST /api/auth/tenant/verify/
- TC-FON-000005-S02 校验 valid=false 与错误码
- TC-FON-000005-S03 校验前端错误提示与不落缓存
预期：提示“识别码无效...”，允许重试

TC-FON-000006 Tenant 验证网络异常重试

级别：E2E
前置：模拟网络失败
步骤：
- TC-FON-000006-S01 点击确认触发请求失败
- TC-FON-000006-S02 检查“网络连接失败”提示
- TC-FON-000006-S03 点击重试并恢复
预期：重试可再次发起请求

TC-FON-000007 非首启跳过识别页

级别：E2E
前置：本地已有合法 Tenant Code
步骤：
- TC-FON-000007-S01 打开应用
- TC-FON-000007-S02 检查是否直接进入登录页
- TC-FON-000007-S03 检查租户品牌信息回填
预期：跳过识别页

TC-FON-000008 切换公司入口流程

级别：E2E
前置：已在登录页
步骤：
- TC-FON-000008-S01 点击“切换公司”
- TC-FON-000008-S02 校验二次确认文案
- TC-FON-000008-S03 确认后检查缓存清除并回到识别页
预期：缓存清除成功并跳回识别页

TC-FON-000009 Tenant 验证接口无需鉴权

级别：API
前置：未登录
步骤：
- TC-FON-000009-S01 不带 token 调用验证接口
- TC-FON-000009-S02 校验响应状态
- TC-FON-000009-S03 校验业务结构
预期：接口可访问（非401/403）

TC-FON-000010 Tenant 验证接口IP限流

级别：API
前置：同IP连续请求
步骤：
- TC-FON-000010-S01 1分钟内发起11次请求
- TC-FON-000010-S02 校验前10次正常
- TC-FON-000010-S03 校验第11次被限流
预期：触发每分钟≤10次限制

B. 密码登录（Story 2）

TC-FON-000011 密码登录页元素完整

级别：E2E
步骤：S01 打开密码登录页；S02 检查手机号/密码/滑块/登录按钮；S03 检查忘记密码入口
预期：元素齐全

TC-FON-000012 手机号输入仅数字11位

级别：E2E
步骤：S01 输入含字母字符；S02 观察自动过滤；S03 检查长度限制
预期：仅数字，最长11位

TC-FON-000013 密码明文/密文切换

级别：E2E
步骤：S01 输入密码；S02 点击眼睛图标显示明文；S03 再次点击恢复密文
预期：切换正常

TC-FON-000014 三项未完成时登录按钮置灰

级别：E2E
步骤：S01 只填手机号；S02 再填密码；S03 未完成滑块时检查按钮状态
预期：按钮不可点击

TC-FON-000015 滑块验证失败不计入密码错误次数

级别：API+E2E
步骤：
- TC-FON-000015-S01 调用 GET /api/auth/captcha/ 获取 challenge
- TC-FON-000015-S02 调用 POST /api/auth/captcha/verify/ 提交错误轨迹
- TC-FON-000015-S03 检查滑块失败提示与刷新，且登录失败计数未增加
预期：不计入账号锁定计数

TC-FON-000016 滑块验证成功状态保持至提交

级别：E2E
步骤：S01 完成滑块；S02 检查“验证通过”状态；S03 立即点登录
预期：状态有效并允许提交

TC-FON-000017 登录前端校验-手机号为空

级别：E2E
步骤：S01 留空手机号；S02 点登录；S03 检查提示
预期：提示“请输入手机号”

TC-FON-000018 登录前端校验-手机号不足11位

级别：E2E
步骤：S01 输入10位；S02 点登录；S03 检查提示
预期：提示“请输入完整的11位手机号”

TC-FON-000019 登录前端校验-密码为空

级别：E2E
步骤：S01 填手机号与滑块通过；S02 密码留空；S03 点登录
预期：提示“请输入密码”

TC-FON-000020 登录前端校验-未完成滑块

级别：E2E
步骤：S01 填手机号密码；S02 不做滑块；S03 点登录
预期：提示“请完成滑块验证”

TC-FON-000021 密码登录成功（is_initial_password=False）

级别：API+E2E
步骤：
- TC-FON-000021-S01 调用 POST /api/auth/login/ 提交正确手机号/密码与 captcha_pass_token
- TC-FON-000021-S02 校验返回 token 与 is_initial_password=false
- TC-FON-000021-S03 校验跳首页欢迎语
预期：登录成功进入首页

TC-FON-000022 密码登录成功（is_initial_password=True）

级别：API+E2E
步骤：S01 使用初始密码登录；S02 校验返回标志true；S03 校验跳转强制改密页
预期：不可访问其他页面

TC-FON-000023 密码错误提示统一

级别：API+E2E
步骤：S01 提交错误密码；S02 校验错误文案；S03 校验密码框清空+手机号保留+滑块刷新
预期：提示“手机号或密码错误，请重新输入”

TC-FON-000024 连续错误5次触发账号锁定

级别：API
步骤：S01 连续5次密码错误；S02 校验第5次后状态locked；S03 校验locked_until=now+30min
预期：账号锁定成功

TC-FON-000025 锁定期间登录被拒绝

级别：API+E2E
步骤：S01 对locked账号发起登录；S02 校验提示文案；S03 校验登录按钮置灰
预期：拒绝登录

TC-FON-000026 30分钟后自动解锁

级别：API
步骤：S01 构造锁定到期账号；S02 时间推进30分钟后重试；S03 校验恢复登录能力
预期：自动解锁

TC-FON-000027 账号停用登录拦截

级别：API+E2E
步骤：S01 停用账号发起登录；S02 校验错误码；S03 校验前端提示
预期：提示“账号已停用，请联系您的管理员”

TC-FON-000028 Session过期跳转登录

级别：E2E
步骤：S01 进入受保护页面；S02 使session过期；S03 执行动作触发跳转
预期：跳回登录并提示“登录已过期，请重新登录”

C. 首次登录强制改密（Story 2/3 公共密码组件）

TC-FON-000029 首次登录强制改密页不可跳过

级别：E2E
步骤：S01 初始密码登录；S02 尝试访问其他功能路由；S03 检查仍停留改密流程
预期：不可绕过

TC-FON-000030 新密码强度校验

级别：API+E2E
步骤：S01 输入弱密码；S02 提交；S03 检查强度错误提示
预期：拒绝弱密码

TC-FON-000031 新密码不得与最近3次重复

级别：API
步骤：S01 构造历史密码3条；S02 提交重复密码；S03 校验错误码
预期：拒绝历史重复

TC-FON-000032 首次改密成功后状态更新

级别：API
步骤：S01 提交合法新密码；S02 校验is_initial_password=false；S03 校验password_histories新增
预期：状态正确更新

TC-FON-000033 首次改密成功后直接进入系统

级别：E2E
步骤：S01 完成改密提交；S02 检查成功反馈；S03 校验跳首页
预期：进入首页

D. 找回密码（Story 3）

TC-FON-000034 忘记密码入口可达

级别：E2E
步骤：S01 登录页点击忘记密码；S02 校验进入Stepper；S03 校验步骤一元素
预期：进入找回密码流程

TC-FON-000035 步骤一手机号格式校验

级别：E2E
步骤：S01 输入不足11位手机号；S02 点获取验证码；S03 检查提示
预期：提示“请输入完整的11位手机号”

TC-FON-000036 步骤一发送验证码成功（active账号）

级别：API+E2E
步骤：
- TC-FON-000036-S01 调用 POST /api/auth/recover/password/request/ 提交 active 手机号
- TC-FON-000036-S02 校验进入 60 秒倒计时
- TC-FON-000036-S03 校验 sms_otp_records 写入 scene=password_reset 且有效期 10 分钟
预期：发送成功并记录正确

TC-FON-000037 步骤一防枚举响应（不存在/停用账号）

级别：API
步骤：S01 分别提交不存在和停用手机号；S02 校验响应文案一致；S03 校验不泄露账号状态
预期：统一提示“如该手机号已注册...”

TC-FON-000038 找回密码短信发送频控（5次/小时）

级别：API
步骤：S01 同手机号发送6次；S02 校验前5次可用；S03 校验第6次超限
预期：提示“发送次数过多，请1小时后再试”

TC-FON-000039 步骤二验证码正确进入步骤三

级别：API+E2E
步骤：
- TC-FON-000039-S01 调用 POST /api/auth/recover/password/verify/ 提交正确 6 位验证码
- TC-FON-000039-S02 校验颁发 sms_reset_token（15 分钟）
- TC-FON-000039-S03 页面进入步骤三
预期：通过校验并进入重置页

TC-FON-000040 步骤二验证码错误与5次作废

级别：API
步骤：S01 连续输入错误验证码5次；S02 检查前4次提示错误；S03 第5次后验证码作废
预期：提示“验证码已失效，请重新获取”

TC-FON-000041 步骤二验证码过期

级别：API
步骤：S01 使用超时验证码提交；S02 校验错误码；S03 校验提示文案
预期：提示“验证码已过期，请重新获取”

TC-FON-000042 步骤三token无效或过期

级别：API+E2E
步骤：S01 使用无效sms_reset_token访问步骤三；S02 校验错误提示；S03 跳回步骤一
预期：提示“操作已超时，请重新发起找回密码”

TC-FON-000043 步骤三重置成功后会话失效

级别：API
步骤：
- TC-FON-000043-S01 调用 POST /api/auth/recover/password/reset/（携带有效 sms_reset_token）重置密码
- TC-FON-000043-S02 校验 is_initial_password=false
- TC-FON-000043-S03 校验该用户历史 session 失效
预期：需重新登录

TC-FON-000044 重置成功后用新密码登录

级别：E2E
步骤：S01 完成找回密码全流程；S02 跳回登录页；S03 用新密码登录成功
预期：登录成功，提示“密码已重置，请使用新密码登录”

E. 验证码登录（Story 5）

TC-FON-000045 登录方式Tab切换与状态重置

级别：E2E
步骤：S01 从密码登录切换到验证码登录；S02 检查表单区切换；S03 校验原输入与滑块状态清空
预期：状态重置正确

TC-FON-000046 未完成滑块禁止获取登录验证码

级别：E2E
步骤：S01 进入验证码登录Tab；S02 直接点获取验证码；S03 检查提示
预期：提示“请先完成滑块验证”

TC-FON-000047 登录验证码发送与频控（10次/小时，独立于找回密码）

级别：API
步骤：S01 发送登录验证码11次（scene=login）；S02 校验第11次超限；S03 校验找回密码scene不受影响
预期：login场景10次/小时，scene隔离计数

TC-FON-000048 验证码登录成功/失败/锁定限制

级别：API+E2E
步骤：
- TC-FON-000048-S01 调用 POST /api/auth/login/phone/，正确 OTP 登录成功，返回 token 与 is_initial_password
- TC-FON-000048-S02 调用 POST /api/auth/login/phone/，错误 OTP 提示“验证码有误”，5 次后作废
- TC-FON-000048-S03 账号 locked 时调用 POST /api/auth/login/phone/ 同样被拒绝
预期：三类行为均符合 PRD

F. 补充用例（PRD v3.0 / 技术方案 v4.1 / DATA_MODEL / API_CONTRACT 对齐）

TC-FON-000153 首次登录改密提交接口成功

级别：API
前置：账号 is_initial_password=true，已完成登录并具备改密会话
步骤：
- TC-FON-000153-S01 调用 POST /api/auth/password/change-initial/ 提交合法新密码
- TC-FON-000153-S02 校验返回成功，is_initial_password=false
- TC-FON-000153-S03 校验 password_histories 新增记录
预期：首次改密成功落库，账号脱离初始密码状态

TC-FON-000154 首次登录改密弱密码拦截

级别：API+E2E
前置：账号处于首次改密页
步骤：S01 输入不满足复杂度的新密码；S02 提交改密；S03 校验错误码/错误提示
预期：返回 AUTH_PASSWORD_WEAK，拒绝提交

TC-FON-000155 首次登录改密禁止复用最近3次历史密码

级别：API
前置：password_histories 已有最近 3 条
步骤：S01 提交与最近历史重复的新密码；S02 校验错误响应；S03 校验密码未更新
预期：拒绝历史重复密码，历史记录不新增

TC-FON-000156 首次改密成功后会话保持并直达首页

级别：E2E
前置：初始密码登录进入强制改密页
步骤：S01 完成改密提交；S02 校验未二次登录；S03 校验直接进入首页
预期：沿用当前会话进入系统（不强制重新登录）

TC-FON-000157 找回密码成功后不再触发首次改密

级别：API+E2E
前置：账号原为初始密码状态，执行找回密码三步成功
步骤：
- TC-FON-000157-S01 调用 POST /api/auth/recover/password/reset/ 成功后校验 is_initial_password=false
- TC-FON-000157-S02 返回登录页使用新密码登录
- TC-FON-000157-S03 校验直接进入首页而非首次改密页
预期：找回密码后视为已完成身份核验，不再触发强制改密

TC-FON-000158 主动登出销毁会话与登录凭证

级别：API+E2E
前置：已登录
步骤：
- TC-FON-000158-S01 调用 POST /api/auth/logout/
- TC-FON-000158-S02 校验服务端会话失效（后续受保护请求无效）
- TC-FON-000158-S03 Electron 客户端侧校验登录凭证清理与跳转登录页
预期：登出后不可复用原凭证继续访问系统

TC-FON-000159 管理员手动解锁账号

级别：API
前置：账号因连续密码错误达到阈值已处于 locked
步骤：S01 Tenant Admin 在后台执行手动解锁；S02 校验 user_accounts.status=active 且 locked_until 清空；S03 立即发起登录请求并成功
预期：管理员可提前解锁，无需等待 30 分钟自动解锁

TC-FON-000160 找回密码步骤一防枚举且无效账号不落短信记录

级别：API
前置：准备“未注册手机号”“停用账号手机号”
步骤：S01 分别调用 POST /api/auth/recover/password/request/；S02 校验外显响应一致；S03 校验 sms_otp_records 未新增对应记录
预期：外显统一且不泄露账号状态，不产生无效 OTP 记录

TC-FON-000161 短信验证码仅哈希存储（禁止明文入库）

级别：API
前置：触发找回密码或验证码登录发码
步骤：S01 查询 sms_otp_records 最新记录；S02 校验存在 otp_hash；S03 校验无 OTP 明文字段/日志明文
预期：满足 DATA_MODEL 安全要求（OTP 明文不落库）

TC-FON-000162 找回密码验证码错误5次后作废并持久化状态

级别：API
前置：已生成有效 scene=password_reset OTP
步骤：S01 连续提交错误验证码 5 次；S02 校验第 5 次后提示“验证码已失效，请重新获取”；S03 校验记录 verify_attempts=5 且 is_used=true
预期：OTP 作废口径与数据状态一致

TC-FON-000163 OTP 两场景有效期差异校验（10 分钟 / 5 分钟）

级别：API
步骤：
- TC-FON-000163-S01 发起 scene=password_reset，校验 expires_at=created_at+10分钟
- TC-FON-000163-S02 发起 scene=login，校验 expires_at=created_at+5分钟
- TC-FON-000163-S03 校验两场景限流计数独立
预期：有效期与频控均符合技术方案与数据模型

TC-FON-000164 验证码登录错误5次后作废并提示重新获取

级别：API+E2E
前置：已发送 scene=login 验证码
步骤：S01 连续输入错误 OTP 5 次；S02 校验第 5 次提示“验证码已失效，请重新获取”；S03 再次提交原 OTP 必须失败
预期：验证码登录错误上限与作废文案符合 PRD

TC-FON-000165 登录审计 `login_attempts.failure_reason` 写入准确

级别：API
步骤：
- TC-FON-000165-S01 触发一次密码错误，校验记录 wrong_password
- TC-FON-000165-S02 触发一次滑块失败，校验记录 wrong_captcha
- TC-FON-000165-S03 触发一次 OTP 错误，校验记录 wrong_otp
预期：失败原因枚举写入正确，便于审计与风控

TC-FON-000166 锁定账号验证码登录返回标准错误码

级别：API
前置：账号已 locked
步骤：S01 调用 POST /api/auth/login/phone/；S02 校验 HTTP 423；S03 校验错误码 AUTH_ACCOUNT_LOCKED
预期：账号维度锁定策略对验证码登录同样生效

TC-FON-000167 Tenant 校验限流错误契约

级别：API
前置：同 IP 1 分钟内第 11 次请求
步骤：S01 触发 POST /api/auth/tenant/verify/ 限流；S02 校验 HTTP 429；S03 校验 code=AUTH_TENANT_RATE_LIMITED 且错误体字段完整
预期：限流错误符合 API_CONTRACT 与技术方案

TC-FON-000168 API 失败响应统一 envelope 契约

级别：API
前置：构造任一登录失败场景（如密码错误）
步骤：S01 调用失败接口；S02 校验响应包含 ok=false、error、code、meta.request_id、meta.timestamp；S03 校验字段类型正确
预期：失败响应结构符合 TECH_STACK/API_CONTRACT.md

TC-FON-000169 密码登录失败错误码与状态码契约

级别：API
前置：账号存在，密码错误
步骤：S01 调用 POST /api/auth/login/；S02 校验 HTTP 401；S03 校验 code=AUTH_INVALID_CREDENTIAL 与统一错误结构
预期：失败状态码与错误码稳定、可机器判定

TC-FON-000170 找回密码重置凭证无效错误契约

级别：API
前置：sms_reset_token 无效或过期
步骤：S01 调用 POST /api/auth/recover/password/reset/；S02 校验 HTTP 400；S03 校验 code=AUTH_SMS_RESET_TOKEN_INVALID
预期：错误码与文案符合技术方案

TC-FON-000171 登录页微信扫码入口禁用态验证

级别：E2E
步骤：S01 打开登录页；S02 校验“微信扫码登录 - 即将开放”为灰态不可点击；S03 校验无跳转行为
预期：MVP 仅展示禁用入口，不提供可用登录能力

TC-FON-000172 微信预留端点未开放（qrcode/callback）

级别：API
步骤：S01 调用 GET /api/auth/wechat/qrcode/，校验 HTTP 404 或路由未注册；S02 调用 POST /api/auth/wechat/callback/，校验 HTTP 404 或路由未注册；S03 校验未返回可用二维码数据且未签发任何登录态
预期：MVP 阶段微信相关预留端点均不开放

4. 工程实现指引（给测试开发工程师）

目录建议
- tests/integration/login/test_tc_fon_000001_000048_and_000153_000172.py
- tests/e2e/login/test_tc_fon_000001_000048_and_000153_000172.spec.ts
命名规范
- 函数名必须带用例ID，例如：def test_tc_fon_000024_account_lock_after_5_failures():
步骤日志
- 每步执行前后打印 step_id；断言失败时把 step_id 写入异常消息
报告聚合
- 生成 reports/login_run_<run_id>.json + reports/login_run_<run_id>.html
CI 门禁
- TC-FON-000001 ~ TC-FON-000048 与 TC-FON-000153 ~ TC-FON-000172 全量通过才允许合并

5. 变更规则

新增登录用例：从 TC-FON-000173 开始递增
后续房源/客源模块：继续用同一全局序列，不得重号
禁止删除历史用例ID；可标记 deprecated 但保留编号与历史报告可追溯性

23 KiB Raw Blame History Unescape Escape

Fonrey 登录模块测试用例文档（可自动化）

变更历史

1. 目标与原则

2. 自动化执行与报告要求（工程实现必须遵循）

3. 全量测试用例清单（68条）

3.0 登录模块 API 端点口径（以 TECH_STACK/登录管理技术方案.md §五 + TECH_STACK/API_CONTRACT.md 为准）

A. Tenant 识别（Story 1）

TC-FON-000001 Tenant Code 页面首启展示

TC-FON-000002 Tenant Code 输入去空格与粘贴

TC-FON-000003 Tenant Code 非12位拦截

TC-FON-000004 Tenant 验证成功流程

TC-FON-000005 Tenant 验证失败（无效识别码）

TC-FON-000006 Tenant 验证网络异常重试

TC-FON-000007 非首启跳过识别页

TC-FON-000008 切换公司入口流程

TC-FON-000009 Tenant 验证接口无需鉴权

TC-FON-000010 Tenant 验证接口IP限流

B. 密码登录（Story 2）

TC-FON-000011 密码登录页元素完整

TC-FON-000012 手机号输入仅数字11位

TC-FON-000013 密码明文/密文切换

TC-FON-000014 三项未完成时登录按钮置灰

TC-FON-000015 滑块验证失败不计入密码错误次数

TC-FON-000016 滑块验证成功状态保持至提交

TC-FON-000017 登录前端校验-手机号为空

TC-FON-000018 登录前端校验-手机号不足11位

TC-FON-000019 登录前端校验-密码为空

TC-FON-000020 登录前端校验-未完成滑块

TC-FON-000021 密码登录成功（is_initial_password=False）

TC-FON-000022 密码登录成功（is_initial_password=True）

TC-FON-000023 密码错误提示统一

TC-FON-000024 连续错误5次触发账号锁定

TC-FON-000025 锁定期间登录被拒绝

TC-FON-000026 30分钟后自动解锁

TC-FON-000027 账号停用登录拦截

TC-FON-000028 Session过期跳转登录

C. 首次登录强制改密（Story 2/3 公共密码组件）

TC-FON-000029 首次登录强制改密页不可跳过

TC-FON-000030 新密码强度校验

TC-FON-000031 新密码不得与最近3次重复

TC-FON-000032 首次改密成功后状态更新

TC-FON-000033 首次改密成功后直接进入系统

D. 找回密码（Story 3）

TC-FON-000034 忘记密码入口可达

TC-FON-000035 步骤一手机号格式校验

TC-FON-000036 步骤一发送验证码成功（active账号）

TC-FON-000037 步骤一防枚举响应（不存在/停用账号）

TC-FON-000038 找回密码短信发送频控（5次/小时）

TC-FON-000039 步骤二验证码正确进入步骤三

TC-FON-000040 步骤二验证码错误与5次作废

TC-FON-000041 步骤二验证码过期

TC-FON-000042 步骤三token无效或过期

TC-FON-000043 步骤三重置成功后会话失效

TC-FON-000044 重置成功后用新密码登录

E. 验证码登录（Story 5）

TC-FON-000045 登录方式Tab切换与状态重置

TC-FON-000046 未完成滑块禁止获取登录验证码

TC-FON-000047 登录验证码发送与频控（10次/小时，独立于找回密码）

TC-FON-000048 验证码登录成功/失败/锁定限制

F. 补充用例（PRD v3.0 / 技术方案 v4.1 / DATA_MODEL / API_CONTRACT 对齐）

TC-FON-000153 首次登录改密提交接口成功

TC-FON-000154 首次登录改密弱密码拦截

TC-FON-000155 首次登录改密禁止复用最近3次历史密码

TC-FON-000156 首次改密成功后会话保持并直达首页

TC-FON-000157 找回密码成功后不再触发首次改密

TC-FON-000158 主动登出销毁会话与登录凭证

TC-FON-000159 管理员手动解锁账号

TC-FON-000160 找回密码步骤一防枚举且无效账号不落短信记录

TC-FON-000161 短信验证码仅哈希存储（禁止明文入库）

TC-FON-000162 找回密码验证码错误5次后作废并持久化状态

TC-FON-000163 OTP 两场景有效期差异校验（10 分钟 / 5 分钟）

TC-FON-000164 验证码登录错误5次后作废并提示重新获取

TC-FON-000165 登录审计 login_attempts.failure_reason 写入准确

TC-FON-000166 锁定账号验证码登录返回标准错误码

TC-FON-000167 Tenant 校验限流错误契约

TC-FON-000168 API 失败响应统一 envelope 契约

TC-FON-000169 密码登录失败错误码与状态码契约

TC-FON-000170 找回密码重置凭证无效错误契约

TC-FON-000171 登录页微信扫码入口禁用态验证

23 KiB

Raw Blame History

3.0 登录模块 API 端点口径（以 `TECH_STACK/登录管理技术方案.md` §五 + `TECH_STACK/API_CONTRACT.md` 为准）

TC-FON-000165 登录审计 `login_attempts.failure_reason` 写入准确