登录功能文档（LOGIN）

概述

此文件夹包含所有登录功能相关的生效文档。

文档清单

权威文档

login_design_final.md

• 版本: 2.0
• 最后更新: 2026-03-15
• 状态: ✅ 生效中
• 用途: 登录功能的完整设计文档
• 包含内容:
• 核心设计决策
• 完整的登录流程（密码登录、短信登录）
• 验证码管理详细规则
• 失败次数管理详细规则
• 登录成功后的清理
• 关键实现细节
• 测试清单

何时使用: - 需要了解登录功能的完整设计 - 需要实现新的登录相关功能 - 需要修复登录相关的 bug - 需要进行代码审查

快速参考

login_quick_reference.md

• 版本: 1.0
• 最后更新: 2026-03-15
• 状态: ✅ 生效中
• 用途: 登录功能的快速参考卡片
• 包含内容:
• 权威文档指引
• 核心设计速查表
• 代码位置
• 关键方法
• 测试清单
• 常见问题

何时使用: - 需要快速查阅某个功能 - 需要找到代码位置 - 需要查看常见问题

代码位置

后端

• Controllers/AccountController.cs - 登录逻辑
• Services/LoginAttemptService.cs - 失败次数管理

前端

• Views/Account/Login.cshtml - 登录页面

关键设计

验证码显示

• 密码登录失败 1 次后 显示验证码
• 短信登录 总是 显示验证码
• 账户锁定时 显示 验证码

失败次数计数

• 标识: Phone + IP
• 跨设备: 独立计算
• 场景: 用户在家失败 5 次被锁定，在公司仍可登录

账户锁定

• 触发: 连续失败 5 次
• 时间: 15 分钟
• 范围: 整个账户

版本历史

v2.0 (2026-03-15)

• 修改验证码显示时机：失败 1 次后显示（之前是 2 次）
• 修改失败次数计数：基于 Phone + IP（之前仅基于手机号）
• 添加短信验证码重发规则

v1.0 (2026-03-11)

• 初始版本

相关文档

• 📋 docs/01-active/README.md - 生效文档总览
• 📋 docs/02-archived/LOGIN/ARCHIVE_LOG.md - 登录功能的归档文档
• 📋 CLAUDE.md - 项目主入口文档

最后更新

📅 2026-03-15 👤 Claude