4类Spec完整落地示例用户账号密码登录功能多角色AI开发适配4类Spec完整落地示例用户账号密码登录功能多角色AI开发适配在AI辅助开发、微服务架构普及的当下多角色协同的核心痛点的是“需求不统一、落地无标准”——产品说清需求研发按规编码测试精准验证都需要以「Spec」为核心载体。本文以「用户账号密码登录功能」微服务架构下用户微服务核心功能无多模块协作适配AI辅助开发为具体需求完整生成4类Spec产品详版、产品简版、研发Spec、测试Spec明确各角色输出标准同时说明AI如何基于这些Spec辅助开发让每类Spec都能直接落地复用解决多角色协同内耗问题。核心定位本文聚焦「单一功能的Spec全流程落地」不涉及复杂多模块协作重点适配产品、研发、测试三大核心角色同时兼顾AI开发Agent的使用场景所有Spec均遵循“结构化、无歧义、可落地、可AI识别”原则研发可直接对照编码测试可直接对照设计用例产品可直接用于需求确认。一、需求背景统一认知为4类Spec奠定基础基本信息功能名称用户账号密码登录功能微服务架构用户微服务专属核心场景用户通过手机号/邮箱作为账号输入密码完成登录获取登录状态后跳转对应页面包含字段校验、账号锁定、异常提示等核心逻辑。适配环境开发语言Java、微服务框架Spring Cloud、单元测试JUnit 5、Redis用于账号锁定状态存储、AI开发Agent辅助生成初始代码、测试用例。角色分工前提产品经理输出产品Spec详版简版研发人员输出研发Spec测试人员输出测试SpecAI开发Agent以4类Spec为输入辅助各角色提升效率所有Spec需经过单场评审确认确保无歧义、可落地。二、产品Spec详版- 产品经理输出需求源头AI理解需求核心输入# 文档信息 文档名称login-function-product-spec-v1.0详版.md 编写人产品经理 确认人研发负责人、测试负责人 版本v1.0 关联原型用户登录页v1.0 # 1. 功能概述 本功能为用户微服务核心基础功能支持用户通过「手机号/邮箱」作为账号输入密码完成登录验证验证通过后跳转首页验证失败则显示对应错误提示包含字段校验、账号锁定、异常处理等核心逻辑不支持第三方登录、短信登录、密码找回功能仅保留账号密码登录核心流程适配PC端、移动端统一登录场景。 # 2. 用户场景精准描述AI可识别 - 场景1未登录用户访问系统首页系统自动跳转至登录页用户输入正确的手机号/邮箱和密码完成登录后跳转至系统首页。 - 场景2用户输入账号为空、密码为空或账号格式不符合要求非手机号/非邮箱、密码格式不符合要求系统显示对应错误提示停留在登录页。 - 场景3用户连续输入错误密码3次账号自动锁定15分钟锁定期间用户尝试登录显示锁定提示停留在登录页15分钟后自动解锁无需手动操作。 - 场景4用户输入正确账号但密码错误不足3次系统显示密码错误提示停留在登录页累计错误次数。 - 场景5登录过程中出现网络异常、服务器异常系统显示对应异常提示停留在登录页不累计密码错误次数。 # 3. 核心功能规则无歧义可落地 ### 3.1 字段校验规则 #### 账号username - 非空校验用户未输入账号时提示文案“请输入用户名手机号/邮箱”字体颜色#FF4D4F提示时长3秒自动消失。 - 格式校验仅支持11位国内手机号正则^1[3-9]d{9}$或常规邮箱格式正则^w([-.]w)*w([-.]w)*.w([-.]w)*$格式错误时提示文案“请输入正确的手机号或邮箱”字体颜色#FF4D4F提示时长3秒自动消失。 #### 密码password - 非空校验用户未输入密码时提示文案“请输入密码”字体颜色#FF4D4F提示时长3秒自动消失。 - 格式校验长度6-18位必须包含至少1个大写/小写字母1个数字不允许包含特殊字符格式错误时提示文案“密码需包含字母和数字长度6-18位”字体颜色#FF4D4F提示时长3秒自动消失。 ### 3.2 安全规则 - 密码错误次数累计同一账号连续输入错误密码累计错误次数错误次数清零规则登录成功后清零、账号锁定解锁后清零。 - 账号锁定规则连续输入错误密码3次立即锁定账号锁定时长15分钟从第3次错误输入时间开始计时锁定期间不允许登录。 - 解锁规则锁定15分钟后自动解锁无需用户手动操作解锁后错误次数自动清零可正常登录。 ### 3.3 跳转与提示规则 - 登录成功无提示文案自动跳转至系统首页跳转时长≤1秒同时记录用户登录状态Redis存储有效期2小时。 - 登录失败字段校验错误、密码错误、账号锁定停留在登录页显示对应错误提示提示文案3秒自动消失不跳转页面。 - 异常场景提示 - 网络异常提示文案“网络异常请稍后重试”字体颜色#FF4D4F提示时长3秒自动消失。 - 服务器异常提示文案“系统繁忙请稍后重试”字体颜色#FF4D4F提示时长3秒自动消失。 # 4. 功能边界明确包含/不包含避免歧义 - 包含功能账号密码字段校验、密码错误次数累计、账号锁定与自动解锁、登录成功跳转、各类错误/异常提示。 - 不包含功能第三方登录微信、QQ等、短信验证码登录、密码找回、记住密码、自动登录、账号注册功能。 # 5. 原型关联与备注 - 关联原型用户登录页v1.0链接xxx原型备注与本文Spec规则完全一致无新增/遗漏需求。 - 备注1提示文案的字体、颜色、显示时长需与原型保持一致不允许擅自修改。 - 备注2账号锁定的15分钟时长、密码格式规则后续可根据业务需求迭代调整本次v1.0按上述规则落地。 - 备注3本Spec可作为AI开发Agent的核心输入用于辅助生成登录功能初始代码、测试用例。三、产品Spec简版- 产品经理输出适配研发快速查阅AI快速抓取核心规则# 文档信息 文档名称login-function-product-spec-v1.0简版.md 编写人产品经理 确认人研发负责人 版本v1.0 核心用途研发编码快速对照、AI辅助开发快速输入 # 核心规则 1. 功能用户通过手机号/邮箱密码登录无第三方登录、密码找回功能。 2. 字段校验 - 账号非空提示请输入用户名手机号/邮箱11位手机号或常规邮箱提示请输入正确的手机号或邮箱。 - 密码非空提示请输入密码6-18位字母数字提示密码需包含字母和数字长度6-18位。 3. 安全规则连续输错密码3次账号锁定15分钟自动解锁锁定提示“账号已锁定请15分钟后再试”。 4. 跳转与提示登录成功跳首页无提示失败/异常停留在登录页提示3秒消失网络/服务器异常有对应提示。 5. 关联原型用户登录页v1.0与详版Spec规则一致。四、研发Spec - 研发人员输出技术落地依据AI生成代码的核心参考# 文档信息 文档名称login-function-dev-spec-v1.0.md 编写人研发负责人 确认人产品经理、测试负责人 版本v1.0 关联产品Speclogin-function-product-spec-v1.0详版 核心用途明确研发技术实现细节、代码规范、依赖组件确保编码符合产品需求为AI开发Agent提供技术输入。 # 1. 技术实现架构适配微服务 - 所属模块用户微服务com.xxx.user.service - 核心类LoginService.java业务逻辑层、LoginResult.java返回结果封装类、LoginController.java控制层提供接口 - 依赖组件 - Spring Cloud微服务基础依赖提供接口暴露能力。 - Redis存储账号锁定时间、密码错误次数key账号value锁定结束时间戳/错误次数。 - JUnit 5单元测试框架用于编写测试用例验证代码逻辑。 - AI辅助开发说明将本Spec与产品简版Spec一同输入AI开发Agent可辅助生成LoginService.java、LoginResult.java的初始代码框架以及核心方法的实现逻辑研发人员只需优化完善即可。 # 2. 核心技术规则对应产品Spec一一落地 ### 2.1 字段校验实现 - 账号校验复用项目通用正则工具类手机号正则^1[3-9]d{9}$邮箱正则^w([-.]w)*w([-.]w)*.w([-.]w)*$校验失败返回对应提示文案与产品Spec一致。 - 密码校验正则^(?.*[A-Za-z])(?.*d).{6,18}$校验失败返回对应提示文案与产品Spec一致。 ### 2.2 安全逻辑实现 - 密码错误次数存储Redis key格式login:error:count:{username}value为Integer类型有效期与账号锁定时间一致15分钟登录成功后删除该key。 - 账号锁定存储Redis key格式login:locked:{username}value为Long类型锁定结束时间戳毫秒锁定时间到期后自动删除该keyRedis过期时间设置为15分钟。 - 锁定逻辑每次密码错误先获取当前错误次数加1后存入Redis若次数≥3计算锁定结束时间当前时间15*60*1000毫秒存入锁定key返回锁定提示。 ### 2.3 接口设计RESTful风格 - 接口地址/api/v1/user/login - 请求方式POST - 请求参数JSON格式 { username: string, // 账号手机号/邮箱 password: string // 密码加密传输前端MD5加密后端无需解密直接与数据库加密存储的密码比对 } - 返回结果JSON格式对应LoginResult.java { success: boolean, // true登录成功false失败 message: string, // 提示文案成功时为空失败/异常时为对应提示 jumpPath: string, // 跳转路径成功时为/home失败时为/login token: string // 登录成功时返回用于后续接口鉴权有效期2小时 } ### 2.4 异常处理 - 网络异常捕获IOException返回提示“网络异常请稍后重试”。 - 服务器异常捕获Exception返回提示“系统繁忙请稍后重试”同时打印异常日志便于排查。 - Redis异常捕获RedisException返回服务器异常提示不影响系统整体运行。 # 3. 代码规范与自查要求 - 代码注释每一个核心方法、关键逻辑如字段校验、锁定逻辑需标注对应产品Spec规则编号便于自查、测试核对也便于AI开发Agent理解代码逻辑。 - 编码规范遵循项目Java编码规范类名、方法名、变量名语义清晰如login()、checkUsernameFormat()避免冗余代码。 - 自查重点确保每一条产品Spec规则都有对应的代码实现无遗漏、无偏离AI生成的初始代码需对照本Spec和产品Spec优化避免AI生成逻辑与需求不符。五、测试Spec - 测试人员输出测试验证依据AI生成测试用例的核心参考# 文档信息 文档名称login-function-test-spec-v1.0.md 编写人测试负责人 确认人产品经理、研发负责人 版本v1.0 关联Spec产品Spec详版简版、研发Spec 核心用途明确测试范围、测试场景、测试用例确保测试覆盖所有产品规则和研发逻辑为AI生成测试用例提供输入。 # 1. 测试范围 - 功能测试字段校验、密码错误次数累计、账号锁定与解锁、登录成功/失败跳转、异常提示。 - 边界测试密码长度边界5位、6位、18位、19位、账号格式边界10位手机号、12位手机号、无效邮箱。 - 异常测试网络异常、服务器异常、Redis异常场景下的功能表现。 - 不测试范围第三方登录、密码找回等产品Spec明确不包含的功能代码内部实现逻辑仅验证输出结果是否符合Spec。 # 2. 测试环境 - 测试环境用户微服务测试环境Redis测试集群接口测试工具Postman单元测试环境JUnit 5。 - 前置条件测试账号已在数据库中创建手机号13800138000密码Aa123456邮箱testexample.com密码Bb654321Redis服务正常运行。 # 3. 核心测试用例对应产品Spec、研发Spec可直接复用 | 测试用例ID | 测试场景 | 输入参数username/password | 预期结果 | 关联Spec | |------------|----------|-------------------------------|----------|----------| | TC-001 | 账号为空密码为空 | username, password | 登录失败提示“请输入用户名手机号/邮箱”停留在登录页 | 产品Spec 3.1、研发Spec 2.1 | | TC-002 | 账号为空密码正确 | username, passwordAa123456 | 登录失败提示“请输入用户名手机号/邮箱”停留在登录页 | 产品Spec 3.1、研发Spec 2.1 | | TC-003 | 账号为10位手机号密码正确 | username1380013800, passwordAa123456 | 登录失败提示“请输入正确的手机号或邮箱”停留在登录页 | 产品Spec 3.1、研发Spec 2.1 | | TC-004 | 账号正确密码为空 | username13800138000, password | 登录失败提示“请输入密码”停留在登录页 | 产品Spec 3.1、研发Spec 2.1 | | TC-005 | 账号正确密码为5位不符合格式 | username13800138000, passwordAa123 | 登录失败提示“密码需包含字母和数字长度6-18位”停留在登录页 | 产品Spec 3.1、研发Spec 2.1 | | TC-006 | 账号正确密码错误第1次 | username13800138000, passwordAa12345 | 登录失败提示“用户名或密码不正确”停留在登录页Redis错误次数为1 | 产品Spec 3.2、研发Spec 2.2 | | TC-007 | 账号正确密码错误第3次 | username13800138000, passwordAa12345 | 登录失败提示“账号已锁定请15分钟后再试”账号锁定Redis错误次数为3锁定key存在 | 产品Spec 3.2、研发Spec 2.2 | | TC-008 | 账号锁定期间尝试登录 | username13800138000, passwordAa123456 | 登录失败提示“账号已锁定请15分钟后再试”停留在登录页 | 产品Spec 3.2、研发Spec 2.2 | | TC-009 | 账号锁定15分钟后尝试登录正确账号密码 | username13800138000, passwordAa123456 | 登录成功跳转至首页返回tokenRedis锁定key、错误次数key删除 | 产品Spec 3.2、3.3、研发Spec 2.2、2.3 | | TC-010 | 网络异常场景登录 | username13800138000, passwordAa123456 | 登录失败提示“网络异常请稍后重试”停留在登录页不累计错误次数 | 产品Spec 3.3、研发Spec 2.4 | # 4. 测试验收标准 - 所有测试用例执行通过无失败用例。 - 测试结果与预期结果完全一致提示文案、跳转路径、锁定时长等均符合产品Spec要求。 - 异常场景下系统表现稳定无崩溃、无异常日志泄露提示文案准确。 - AI辅助生成的单元测试用例需对照本Spec优化确保覆盖所有核心测试场景与研发代码逻辑匹配。六、总结4类Spec的协同价值与AI辅助应用本文生成的4类Spec形成了“产品需求→研发落地→测试验证”的完整闭环每类Spec各司其职、相互关联产品Spec详版简版明确“做什么”研发Spec明确“怎么做”测试Spec明确“怎么验”三者协同可彻底解决多角色协同内耗、需求偏离、测试遗漏等问题。同时4类Spec均遵循“结构化、无歧义”原则可作为AI开发Agent的核心输入AI可基于产品简版Spec理解需求基于研发Spec生成符合规范的代码基于测试Spec生成适配的测试用例大幅提升各角色的工作效率减少重复劳动。所有Spec均可直接复制复用只需根据实际项目的编码规范、原型细节微调参数、文案即可落地尤其适合微服务架构下的单一功能开发为多角色协同、AI辅助开发提供清晰的标准和依据。注文档部分内容可能由 AI 生成
Spec实战：不同角色的Spec输出
发布时间：2026/6/3 20:13:45
4类Spec完整落地示例用户账号密码登录功能多角色AI开发适配4类Spec完整落地示例用户账号密码登录功能多角色AI开发适配在AI辅助开发、微服务架构普及的当下多角色协同的核心痛点的是“需求不统一、落地无标准”——产品说清需求研发按规编码测试精准验证都需要以「Spec」为核心载体。本文以「用户账号密码登录功能」微服务架构下用户微服务核心功能无多模块协作适配AI辅助开发为具体需求完整生成4类Spec产品详版、产品简版、研发Spec、测试Spec明确各角色输出标准同时说明AI如何基于这些Spec辅助开发让每类Spec都能直接落地复用解决多角色协同内耗问题。核心定位本文聚焦「单一功能的Spec全流程落地」不涉及复杂多模块协作重点适配产品、研发、测试三大核心角色同时兼顾AI开发Agent的使用场景所有Spec均遵循“结构化、无歧义、可落地、可AI识别”原则研发可直接对照编码测试可直接对照设计用例产品可直接用于需求确认。一、需求背景统一认知为4类Spec奠定基础基本信息功能名称用户账号密码登录功能微服务架构用户微服务专属核心场景用户通过手机号/邮箱作为账号输入密码完成登录获取登录状态后跳转对应页面包含字段校验、账号锁定、异常提示等核心逻辑。适配环境开发语言Java、微服务框架Spring Cloud、单元测试JUnit 5、Redis用于账号锁定状态存储、AI开发Agent辅助生成初始代码、测试用例。角色分工前提产品经理输出产品Spec详版简版研发人员输出研发Spec测试人员输出测试SpecAI开发Agent以4类Spec为输入辅助各角色提升效率所有Spec需经过单场评审确认确保无歧义、可落地。二、产品Spec详版- 产品经理输出需求源头AI理解需求核心输入# 文档信息 文档名称login-function-product-spec-v1.0详版.md 编写人产品经理 确认人研发负责人、测试负责人 版本v1.0 关联原型用户登录页v1.0 # 1. 功能概述 本功能为用户微服务核心基础功能支持用户通过「手机号/邮箱」作为账号输入密码完成登录验证验证通过后跳转首页验证失败则显示对应错误提示包含字段校验、账号锁定、异常处理等核心逻辑不支持第三方登录、短信登录、密码找回功能仅保留账号密码登录核心流程适配PC端、移动端统一登录场景。 # 2. 用户场景精准描述AI可识别 - 场景1未登录用户访问系统首页系统自动跳转至登录页用户输入正确的手机号/邮箱和密码完成登录后跳转至系统首页。 - 场景2用户输入账号为空、密码为空或账号格式不符合要求非手机号/非邮箱、密码格式不符合要求系统显示对应错误提示停留在登录页。 - 场景3用户连续输入错误密码3次账号自动锁定15分钟锁定期间用户尝试登录显示锁定提示停留在登录页15分钟后自动解锁无需手动操作。 - 场景4用户输入正确账号但密码错误不足3次系统显示密码错误提示停留在登录页累计错误次数。 - 场景5登录过程中出现网络异常、服务器异常系统显示对应异常提示停留在登录页不累计密码错误次数。 # 3. 核心功能规则无歧义可落地 ### 3.1 字段校验规则 #### 账号username - 非空校验用户未输入账号时提示文案“请输入用户名手机号/邮箱”字体颜色#FF4D4F提示时长3秒自动消失。 - 格式校验仅支持11位国内手机号正则^1[3-9]d{9}$或常规邮箱格式正则^w([-.]w)*w([-.]w)*.w([-.]w)*$格式错误时提示文案“请输入正确的手机号或邮箱”字体颜色#FF4D4F提示时长3秒自动消失。 #### 密码password - 非空校验用户未输入密码时提示文案“请输入密码”字体颜色#FF4D4F提示时长3秒自动消失。 - 格式校验长度6-18位必须包含至少1个大写/小写字母1个数字不允许包含特殊字符格式错误时提示文案“密码需包含字母和数字长度6-18位”字体颜色#FF4D4F提示时长3秒自动消失。 ### 3.2 安全规则 - 密码错误次数累计同一账号连续输入错误密码累计错误次数错误次数清零规则登录成功后清零、账号锁定解锁后清零。 - 账号锁定规则连续输入错误密码3次立即锁定账号锁定时长15分钟从第3次错误输入时间开始计时锁定期间不允许登录。 - 解锁规则锁定15分钟后自动解锁无需用户手动操作解锁后错误次数自动清零可正常登录。 ### 3.3 跳转与提示规则 - 登录成功无提示文案自动跳转至系统首页跳转时长≤1秒同时记录用户登录状态Redis存储有效期2小时。 - 登录失败字段校验错误、密码错误、账号锁定停留在登录页显示对应错误提示提示文案3秒自动消失不跳转页面。 - 异常场景提示 - 网络异常提示文案“网络异常请稍后重试”字体颜色#FF4D4F提示时长3秒自动消失。 - 服务器异常提示文案“系统繁忙请稍后重试”字体颜色#FF4D4F提示时长3秒自动消失。 # 4. 功能边界明确包含/不包含避免歧义 - 包含功能账号密码字段校验、密码错误次数累计、账号锁定与自动解锁、登录成功跳转、各类错误/异常提示。 - 不包含功能第三方登录微信、QQ等、短信验证码登录、密码找回、记住密码、自动登录、账号注册功能。 # 5. 原型关联与备注 - 关联原型用户登录页v1.0链接xxx原型备注与本文Spec规则完全一致无新增/遗漏需求。 - 备注1提示文案的字体、颜色、显示时长需与原型保持一致不允许擅自修改。 - 备注2账号锁定的15分钟时长、密码格式规则后续可根据业务需求迭代调整本次v1.0按上述规则落地。 - 备注3本Spec可作为AI开发Agent的核心输入用于辅助生成登录功能初始代码、测试用例。三、产品Spec简版- 产品经理输出适配研发快速查阅AI快速抓取核心规则# 文档信息 文档名称login-function-product-spec-v1.0简版.md 编写人产品经理 确认人研发负责人 版本v1.0 核心用途研发编码快速对照、AI辅助开发快速输入 # 核心规则 1. 功能用户通过手机号/邮箱密码登录无第三方登录、密码找回功能。 2. 字段校验 - 账号非空提示请输入用户名手机号/邮箱11位手机号或常规邮箱提示请输入正确的手机号或邮箱。 - 密码非空提示请输入密码6-18位字母数字提示密码需包含字母和数字长度6-18位。 3. 安全规则连续输错密码3次账号锁定15分钟自动解锁锁定提示“账号已锁定请15分钟后再试”。 4. 跳转与提示登录成功跳首页无提示失败/异常停留在登录页提示3秒消失网络/服务器异常有对应提示。 5. 关联原型用户登录页v1.0与详版Spec规则一致。四、研发Spec - 研发人员输出技术落地依据AI生成代码的核心参考# 文档信息 文档名称login-function-dev-spec-v1.0.md 编写人研发负责人 确认人产品经理、测试负责人 版本v1.0 关联产品Speclogin-function-product-spec-v1.0详版 核心用途明确研发技术实现细节、代码规范、依赖组件确保编码符合产品需求为AI开发Agent提供技术输入。 # 1. 技术实现架构适配微服务 - 所属模块用户微服务com.xxx.user.service - 核心类LoginService.java业务逻辑层、LoginResult.java返回结果封装类、LoginController.java控制层提供接口 - 依赖组件 - Spring Cloud微服务基础依赖提供接口暴露能力。 - Redis存储账号锁定时间、密码错误次数key账号value锁定结束时间戳/错误次数。 - JUnit 5单元测试框架用于编写测试用例验证代码逻辑。 - AI辅助开发说明将本Spec与产品简版Spec一同输入AI开发Agent可辅助生成LoginService.java、LoginResult.java的初始代码框架以及核心方法的实现逻辑研发人员只需优化完善即可。 # 2. 核心技术规则对应产品Spec一一落地 ### 2.1 字段校验实现 - 账号校验复用项目通用正则工具类手机号正则^1[3-9]d{9}$邮箱正则^w([-.]w)*w([-.]w)*.w([-.]w)*$校验失败返回对应提示文案与产品Spec一致。 - 密码校验正则^(?.*[A-Za-z])(?.*d).{6,18}$校验失败返回对应提示文案与产品Spec一致。 ### 2.2 安全逻辑实现 - 密码错误次数存储Redis key格式login:error:count:{username}value为Integer类型有效期与账号锁定时间一致15分钟登录成功后删除该key。 - 账号锁定存储Redis key格式login:locked:{username}value为Long类型锁定结束时间戳毫秒锁定时间到期后自动删除该keyRedis过期时间设置为15分钟。 - 锁定逻辑每次密码错误先获取当前错误次数加1后存入Redis若次数≥3计算锁定结束时间当前时间15*60*1000毫秒存入锁定key返回锁定提示。 ### 2.3 接口设计RESTful风格 - 接口地址/api/v1/user/login - 请求方式POST - 请求参数JSON格式 { username: string, // 账号手机号/邮箱 password: string // 密码加密传输前端MD5加密后端无需解密直接与数据库加密存储的密码比对 } - 返回结果JSON格式对应LoginResult.java { success: boolean, // true登录成功false失败 message: string, // 提示文案成功时为空失败/异常时为对应提示 jumpPath: string, // 跳转路径成功时为/home失败时为/login token: string // 登录成功时返回用于后续接口鉴权有效期2小时 } ### 2.4 异常处理 - 网络异常捕获IOException返回提示“网络异常请稍后重试”。 - 服务器异常捕获Exception返回提示“系统繁忙请稍后重试”同时打印异常日志便于排查。 - Redis异常捕获RedisException返回服务器异常提示不影响系统整体运行。 # 3. 代码规范与自查要求 - 代码注释每一个核心方法、关键逻辑如字段校验、锁定逻辑需标注对应产品Spec规则编号便于自查、测试核对也便于AI开发Agent理解代码逻辑。 - 编码规范遵循项目Java编码规范类名、方法名、变量名语义清晰如login()、checkUsernameFormat()避免冗余代码。 - 自查重点确保每一条产品Spec规则都有对应的代码实现无遗漏、无偏离AI生成的初始代码需对照本Spec和产品Spec优化避免AI生成逻辑与需求不符。五、测试Spec - 测试人员输出测试验证依据AI生成测试用例的核心参考# 文档信息 文档名称login-function-test-spec-v1.0.md 编写人测试负责人 确认人产品经理、研发负责人 版本v1.0 关联Spec产品Spec详版简版、研发Spec 核心用途明确测试范围、测试场景、测试用例确保测试覆盖所有产品规则和研发逻辑为AI生成测试用例提供输入。 # 1. 测试范围 - 功能测试字段校验、密码错误次数累计、账号锁定与解锁、登录成功/失败跳转、异常提示。 - 边界测试密码长度边界5位、6位、18位、19位、账号格式边界10位手机号、12位手机号、无效邮箱。 - 异常测试网络异常、服务器异常、Redis异常场景下的功能表现。 - 不测试范围第三方登录、密码找回等产品Spec明确不包含的功能代码内部实现逻辑仅验证输出结果是否符合Spec。 # 2. 测试环境 - 测试环境用户微服务测试环境Redis测试集群接口测试工具Postman单元测试环境JUnit 5。 - 前置条件测试账号已在数据库中创建手机号13800138000密码Aa123456邮箱testexample.com密码Bb654321Redis服务正常运行。 # 3. 核心测试用例对应产品Spec、研发Spec可直接复用 | 测试用例ID | 测试场景 | 输入参数username/password | 预期结果 | 关联Spec | |------------|----------|-------------------------------|----------|----------| | TC-001 | 账号为空密码为空 | username, password | 登录失败提示“请输入用户名手机号/邮箱”停留在登录页 | 产品Spec 3.1、研发Spec 2.1 | | TC-002 | 账号为空密码正确 | username, passwordAa123456 | 登录失败提示“请输入用户名手机号/邮箱”停留在登录页 | 产品Spec 3.1、研发Spec 2.1 | | TC-003 | 账号为10位手机号密码正确 | username1380013800, passwordAa123456 | 登录失败提示“请输入正确的手机号或邮箱”停留在登录页 | 产品Spec 3.1、研发Spec 2.1 | | TC-004 | 账号正确密码为空 | username13800138000, password | 登录失败提示“请输入密码”停留在登录页 | 产品Spec 3.1、研发Spec 2.1 | | TC-005 | 账号正确密码为5位不符合格式 | username13800138000, passwordAa123 | 登录失败提示“密码需包含字母和数字长度6-18位”停留在登录页 | 产品Spec 3.1、研发Spec 2.1 | | TC-006 | 账号正确密码错误第1次 | username13800138000, passwordAa12345 | 登录失败提示“用户名或密码不正确”停留在登录页Redis错误次数为1 | 产品Spec 3.2、研发Spec 2.2 | | TC-007 | 账号正确密码错误第3次 | username13800138000, passwordAa12345 | 登录失败提示“账号已锁定请15分钟后再试”账号锁定Redis错误次数为3锁定key存在 | 产品Spec 3.2、研发Spec 2.2 | | TC-008 | 账号锁定期间尝试登录 | username13800138000, passwordAa123456 | 登录失败提示“账号已锁定请15分钟后再试”停留在登录页 | 产品Spec 3.2、研发Spec 2.2 | | TC-009 | 账号锁定15分钟后尝试登录正确账号密码 | username13800138000, passwordAa123456 | 登录成功跳转至首页返回tokenRedis锁定key、错误次数key删除 | 产品Spec 3.2、3.3、研发Spec 2.2、2.3 | | TC-010 | 网络异常场景登录 | username13800138000, passwordAa123456 | 登录失败提示“网络异常请稍后重试”停留在登录页不累计错误次数 | 产品Spec 3.3、研发Spec 2.4 | # 4. 测试验收标准 - 所有测试用例执行通过无失败用例。 - 测试结果与预期结果完全一致提示文案、跳转路径、锁定时长等均符合产品Spec要求。 - 异常场景下系统表现稳定无崩溃、无异常日志泄露提示文案准确。 - AI辅助生成的单元测试用例需对照本Spec优化确保覆盖所有核心测试场景与研发代码逻辑匹配。六、总结4类Spec的协同价值与AI辅助应用本文生成的4类Spec形成了“产品需求→研发落地→测试验证”的完整闭环每类Spec各司其职、相互关联产品Spec详版简版明确“做什么”研发Spec明确“怎么做”测试Spec明确“怎么验”三者协同可彻底解决多角色协同内耗、需求偏离、测试遗漏等问题。同时4类Spec均遵循“结构化、无歧义”原则可作为AI开发Agent的核心输入AI可基于产品简版Spec理解需求基于研发Spec生成符合规范的代码基于测试Spec生成适配的测试用例大幅提升各角色的工作效率减少重复劳动。所有Spec均可直接复制复用只需根据实际项目的编码规范、原型细节微调参数、文案即可落地尤其适合微服务架构下的单一功能开发为多角色协同、AI辅助开发提供清晰的标准和依据。注文档部分内容可能由 AI 生成
