mi-assessment/.kiro/specs/admin-integration/tasks.md
2026-02-03 19:17:48 +08:00

7.6 KiB
Raw Blame History

Implementation Plan: Admin Integration Testing

Overview

本任务清单定义了后台管理系统前后端联调测试的具体步骤。联调按模块分阶段进行,确保每个模块在进入下一阶段前都能正常工作。

联调前提条件

  • 后端 API 服务运行在 http://localhost:61551
  • 前端开发服务运行在 http://localhost:5173
  • 数据库已初始化并有测试数据
  • 已创建测试管理员账号

Tasks

  • 1. 联调环境准备

    • 1.1 启动后端 API 服务

      • 进入 server/MiAssessment 目录
      • 运行 dotnet run --project src/MiAssessment.Admin
      • 确认服务启动在 61551 端口
      • Requirements: 1.1
    • 1.2 启动前端开发服务

      • 进入 server/MiAssessment/src/MiAssessment.Admin/admin-web 目录
      • 运行 npm run dev
      • 确认服务启动在 5173 端口
      • Requirements: 1.2
    • 1.3 验证跨域配置

      • 打开浏览器访问 http://localhost:5173
      • 检查控制台无 CORS 错误
      • Requirements: 1.3, 1.4
  • 2. 认证流程联调

    • 2.1 登录功能测试

      • 访问登录页面
      • 输入测试账号密码登录
      • 验证登录成功跳转到首页
      • 检查 localStorage 中存储了 token
      • Requirements: 2.1, 2.2
    • 2.2 Token 刷新测试

      • 修改 access token 过期时间为 1 分钟(测试用)
      • 等待 token 过期后操作页面
      • 验证自动刷新 token 成功
      • Requirements: 2.3
    • 2.3 登出功能测试

      • 点击退出登录
      • 验证跳转到登录页
      • 验证 token 已清除
      • Requirements: 2.4
  • 3. Dashboard 仪表盘联调

    • 3.1 概览数据测试

      • 访问首页仪表盘
      • 验证今日统计数据显示正确
      • 验证累计统计数据显示正确
      • Backend: Task 20, Frontend: Task 2
    • 3.2 趋势图表测试

      • 选择不同日期范围
      • 验证图表数据更新
      • Backend: Task 20, Frontend: Task 2
    • 3.3 待办事项测试

      • 验证待审核提现数量
      • 验证待确认预约数量
      • Backend: Task 20, Frontend: Task 2
  • 4. 系统配置模块联调

    • 4.1 配置列表测试

      • 访问系统配置页面
      • 验证配置按类型分组显示
      • Backend: Task 2, Frontend: Task 3
    • 4.2 配置更新测试

      • 编辑一个配置项
      • 保存并验证更新成功
      • 刷新页面验证数据持久化
      • Backend: Task 2, Frontend: Task 3
  • 5. Checkpoint 1 - 基础模块联调完成

    • 确认 Dashboard 和 Config 模块联调通过
    • 记录发现的问题并修复
  • 6. 内容管理模块联调

    • 6.1 轮播图 CRUD 测试

      • 新增轮播图(上传图片、填写信息)
      • 验证列表显示新增数据
      • 编辑轮播图信息
      • 切换状态
      • 删除轮播图
      • Backend: Task 3, Frontend: Task 4
    • 6.2 轮播图排序测试

      • 拖拽调整排序
      • 验证排序保存成功
      • Backend: Task 3, Frontend: Task 4
    • 6.3 宣传图 CRUD 测试

      • 新增宣传图
      • 按位置筛选
      • 编辑和删除
      • Backend: Task 4, Frontend: Task 4
  • 7. 测评管理模块联调

    • 7.1 测评类型 CRUD 测试

      • 新增测评类型
      • 编辑价格和介绍内容
      • 切换状态(下线/上线/即将上线)
      • 删除测评类型
      • Backend: Task 6, Frontend: Task 6
    • 7.2 题库管理测试

      • 新增题目
      • 按测评类型筛选
      • 批量导入题目Excel
      • 验证导入结果
      • Backend: Task 7, Frontend: Task 6
    • 7.3 题目分类映射测试

      • 选择题目
      • 打开分类映射对话框
      • 选择多个分类
      • 保存并验证映射关系
      • Backend: Task 9, Frontend: Task 6
    • 7.4 报告分类测试

      • 选择测评类型
      • 查看分类树
      • 新增子分类
      • 验证删除约束(有子分类时禁止删除)
      • Backend: Task 8, Frontend: Task 6
    • 7.5 报告结论测试

      • 选择分类
      • 新增结论(最强/较强/较弱/最弱)
      • 编辑富文本内容
      • 删除结论
      • Backend: Task 10, Frontend: Task 6
  • 8. Checkpoint 2 - 内容和测评模块联调完成

    • 确认 Content 和 Assessment 模块联调通过
    • 记录发现的问题并修复
  • 9. 用户管理模块联调

    • 9.1 用户列表测试

      • 访问用户管理页面
      • 使用多条件筛选UID、手机号、等级、状态、日期
      • 验证分页功能
      • Backend: Task 12, Frontend: Task 7
    • 9.2 用户详情测试

      • 点击查看用户详情
      • 验证显示完整信息(上级用户、余额、收入、订单数等)
      • Backend: Task 12, Frontend: Task 7
    • 9.3 用户操作测试

      • 切换用户状态
      • 修改用户等级
      • 导出用户列表
      • Backend: Task 12, Frontend: Task 7
  • 10. 订单管理模块联调

    • 10.1 订单列表测试

      • 访问订单管理页面
      • 使用多条件筛选
      • 验证状态颜色显示
      • Backend: Task 13, Frontend: Task 8
    • 10.2 订单详情测试

      • 点击查看订单详情
      • 验证显示完整信息(用户、商品、支付、关联记录)
      • Backend: Task 13, Frontend: Task 8
    • 10.3 退款功能测试

      • 选择已支付订单
      • 发起退款
      • 验证退款金额校验
      • 验证退款状态更新
      • Backend: Task 13, Frontend: Task 8
  • 11. Checkpoint 3 - 用户和订单模块联调完成

    • 确认 User 和 Order 模块联调通过
    • 记录发现的问题并修复
  • 12. 规划师管理模块联调

    • 12.1 规划师 CRUD 测试

      • 新增规划师(上传头像、填写信息)
      • 编辑规划师信息
      • 切换状态
      • 拖拽排序
      • 删除规划师
      • Backend: Task 15, Frontend: Task 10
    • 12.2 预约记录测试

      • 访问预约记录页面
      • 按规划师、日期、状态筛选
      • 查看预约详情
      • 修改预约状态
      • 导出预约记录
      • Backend: Task 15, Frontend: Task 10
  • 13. 分销管理模块联调

    • 13.1 邀请码管理测试

      • 批量生成邀请码
      • 验证生成的批次号
      • 分配邀请码给用户
      • 导出邀请码
      • Backend: Task 16, Frontend: Task 11
    • 13.2 佣金记录测试

      • 查看佣金统计卡片
      • 使用多条件筛选
      • 查看佣金详情
      • 导出佣金记录
      • Backend: Task 17, Frontend: Task 11
    • 13.3 提现审核测试

      • 查看提现列表
      • 审核通过提现申请
      • 审核拒绝提现申请(填写原因)
      • 完成打款(填写交易号)
      • 导出提现记录
      • Backend: Task 18, Frontend: Task 11
  • 14. 权限控制联调

    • 14.1 API 权限测试

      • 使用无权限账号调用受保护 API
      • 验证返回 403 错误
      • Backend: Task 21, Frontend: Task 12
    • 14.2 页面权限测试

      • 使用无权限账号访问页面
      • 验证按钮被隐藏
      • 验证菜单被隐藏
      • Backend: Task 21, Frontend: Task 12
  • 15. Final Checkpoint - 全部模块联调完成

    • 确认所有模块联调通过
    • 整理联调问题清单
    • 确认所有问题已修复

联调问题记录模板

模块 问题描述 前端/后端 负责人 状态
示例 登录接口返回格式不一致 后端 - 待修复

Notes

  • 联调任务编号与前后端任务编号对应,便于追踪
  • 每个 Checkpoint 是前后端同步点,需要双方确认
  • 发现问题及时记录,避免遗漏
  • 建议使用 Postman 或类似工具辅助 API 测试