🚀 测试平台开发实录：账号体系模块设计与实现

本系列将记录我在独立开发测试平台过程中的一些关键模块实现过程，涵盖功能拆解、接口设计、逻辑校验、异常处理及安全策略等。平台正处于早期开发阶段，我计划将典型实现经验沉淀为系列文章，便于后续复用与优化，也欢迎同行交流与建议。

🧭 模块背景

一个测试平台的用户体系是平台功能的基础，良好的账号体系不仅影响使用体验，还直接关系到平台的安全性和可扩展性。

因此，我在初期优先开发并打磨注册、登录、忘记密码这三个核心模块，为后续的用户权限、操作审计、数据隔离等功能做好基础支撑。

🛠️ 模块拆解与设计思路

账号体系主要包含以下三个基础能力：

✅ 1. 注册模块

目的：完成新用户创建，并保证数据唯一性和注册安全性。

实现要点：

用户名/手机号唯一校验
图形或短信验证码验证
注册密码强度要求（例如 ≥8 位、需包含数字+字母）
统一使用 POST 请求传参，避免信息暴露在 URL 中
注册成功后不自动登录，需显式登录获取 token

示例请求参数（POST /register）：

{
  "username": "tester01",
  "phone": "13800000000",
  "password": "Test1234",
  "code": "583274"
}

响应结果示例：

{
  "code": 200,
  "message": "注册成功"
}

流程图

graph TD
    A[用户填写注册表单] --> B[前端表单验证]
    B -->|验证通过| C[调用注册接口]
    C --> D[后端验证JSON数据]
    D -->|数据有效| E[后端验证验证码]
    E -->|验证码正确| F[检查用户名和手机号是否存在]
    F -->|不存在| G[创建新用户]
    G --> H[返回成功响应]
    B -->|验证失败| I[提示用户错误信息]
    D -->|数据无效| I
    E -->|验证码错误| I
    F -->|存在| I
    G -->|创建失败| I

扩展建议：

注册行为加入审计日志，记录注册时间/IP
支持第三方登录（如微信/QQ）
可以考虑引入邮箱验证机制，进一步增强安全性

🔐 2. 登录模块

目的：验证用户身份，并返回 JWT token 作为会话凭证。

实现要点：

支持用户名或手机号登录
密码使用加盐 hash 存储（如 bcrypt）
登录失败次数过多后暂时锁定账号（防止暴力破解）
返回标准化 token（建议使用 JWT，便于后续权限控制）
token 有效期建议控制在 24 小时，可设计刷新机制

示例请求参数（POST /login）：

{
  "username": "tester01",
  "password": "Test1234"
}

响应结果示例：

{
  "code": 200,
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

流程图

graph TD
    A[用户填写登录表单] --> B[前端表单验证]
    B -->|验证通过| C[调用登录接口]
    C --> D[后端验证JSON数据]
    D -->|数据有效| E[判断输入是用户名还是手机号]
    E --> F[查询用户信息]
    F --> G[验证密码]
    G -->|密码正确| H[生成token]
    H --> I[返回token和成功响应]
    I --> J[前端保存token并跳转主页]
    B -->|验证失败| K[提示用户错误信息]
    D -->|数据无效| K
    F -->|用户不存在| K
    G -->|密码错误| K

扩展建议：

登录行为纳入日志审计
添加设备识别和异地登录提醒功能

🔄 3. 忘记密码模块

目的：允许用户在忘记密码时，通过手机号验证码重设密码。

实现要点：

验证手机号存在并合法
验证短信验证码有效
密码重置后自动使旧 token 失效（防止被盗用）
密码强度与注册一致

示例请求参数（POST /forgot_password）：

{
  "phone": "13800000000",
  "code": "839201",
  "new_password": "NewTest123"
}

响应结果示例：

{
  "code": 200,
  "message": "密码重置成功"
}

流程图

graph TD
    A[用户填写忘记密码表单] --> B[前端表单验证]
    B -->|验证通过| C[调用忘记密码接口]
    C --> D[后端验证JSON数据]
    D -->|数据有效| E[后端验证验证码]
    E -->|验证码正确| F[更新用户密码]
    F --> G[返回成功响应]
    B -->|验证失败| H[提示用户错误信息]
    D -->|数据无效| H
    E -->|验证码错误| H
    F -->|更新失败| H

扩展建议：