Skip to content

Latest commit

 

History

History
216 lines (166 loc) · 12.2 KB

TESTING.md

File metadata and controls

216 lines (166 loc) · 12.2 KB

真机 / 开发者工具验收清单

适用版本:EESAST 小程序 1.2.0-dev + 真机联调修复 PR(#1 / #2 / #5) 更新日期:2026-10-21 目标:在开发者工具与真机上把登录态相关流程走通,补充自动化脚本覆盖不到的部分。

自动化脚本能覆盖语法、结构、绑定、签名与纯函数,但覆盖不到真实账号、真实数据、真实网络与渲染。本清单就是那部分。


0. 环境准备

0.1 版本要求

项 要求
微信开发者工具 Stable 最新版
基础库 ≥ 2.10.0;推荐 ≥ 2.32.3
真机系统 iOS 与 Android 各至少 1 台(字体/安全区/键盘差异)
Node ≥ 18(仅用于跑校验脚本)

0.2 导入与配置

  1. 用开发者工具导入仓库根目录(含 project.config.json,miniprogramRoot = miniprogram/)。
  2. AppID:仓库里默认 touristappid;真机预览/上传前换成正式 AppID。
  3. 本地调试期勾选「不校验合法域名」;发布前必须关闭并验证白名单生效。
  4. project.private.config.json 已被 .gitignore 忽略,不要提交。
  5. WSL 环境:无需手动导入,执行 scripts/devtools.sh open(同步镜像到 D:\wechat-aaplet\eesast-applet 并调 CLI 启动工具打开项目),随后在工具栏点「真机调试」扫码;scripts/devtools.sh preview 可直接生成真机预览二维码。前置:工具 GUI 设置 → 安全设置 → 服务端口 已开启。

0.3 服务器域名白名单(小程序后台 → 开发管理 → 服务器域名)

request 合法域名

  • https://api.eesast.com(REST + GraphQL)
  • https://eesast-1255334966.cos.ap-beijing.myqcloud.com(COS 直传/签名)
  • https://static.eesast.com(静态图片)

downloadFile 合法域名

  • https://eesast-1255334966.cos.ap-beijing.myqcloud.com
  • https://static.eesast.com

0.4 测试账号与数据

角色 用途 需要的数据
未登录 公开浏览、登录/注册/找回 —
user(普通注册用户) 个人中心、清华认证入口、组队/评论权限边界 可登录账号
student(清华学生) 信息化平台、课程、导师、荣誉 有/无队伍各一个;有导师匹配;有荣誉申请
teacher 导师私信、角色闸门 有已通过的导师申请
counselor 角色闸门(应被信息化学生页拒绝) 可登录账号

赛事数据建议覆盖:THUAI(有 contest_time 的,如 THUAI7)、SOFT(第 9 届软件设计大赛)、RL 赛道、HARD(代码页应提示无代码提交流程)。


1. 通用检查(每个页面至少过一次)

  • 首屏 loading 结束后有内容,不出现永久空白
  • 配置了下拉的页面可下拉刷新,刷新后数据正确
  • 375 / 390 / 768 / 1440 宽度下无横向滚动、无内容被裁切
  • 深色模式:文字对比度、卡片描边、导航栏、TabBar 正常
  • iPhone X 类机型底部按钮不被 Home Indicator 遮挡(safe-area-inset-bottom)
  • 断网 → 有失败提示;恢复网络后可重试成功
  • 401 后自动回到未登录态,页面不白屏
  • 页面栈正常:返回不重复入栈、不卡死
  • 控制台无红色报错,WXML 不出现 undefined / [object Object]

2. 功能用例

A. 未登录

编号 入口 步骤 预期
A1 首页 打开小程序 轮播、部门横滑、赛事墙、快捷入口正常;图片来自 static.eesast.com
A2 赛事 切换状态筛选 筛选结果与「未开始/进行中/已结束」一致
A3 赛事详情 打开一个有节点的赛事 统计数字、简介、关键节点时间线正常显示
A4 赛事公告 列表 → 详情 Markdown 正文正常;附件可获取下载链接
A5 资源 点「课程评测」 提示先登录,不发生跳转崩溃
A6 我的 打开 显示登录表单、注册/找回密码入口

B. 账号

编号 入口 步骤 预期
B1 我的 错误密码登录 提示「账号或密码错误」,不泄露账号是否存在
B2 注册 学生身份 → 邮箱验证 → 信息 → 密码 非 @mails.tsinghua.edu.cn 被拦;6 位验证码;学号 10 位;班级如「无76」
B3 找回密码 邮箱 → 验证码 → 新密码 密码强度校验生效;成功后可用新密码登录
B4 我的 退出登录 回到登录页;未登录仍可浏览公开内容
B5 任意登录页 手动使 token 过期(换设备登录/清缓存后重进) 请求 401 → 自动降级匿名,页面提示重新登录
B6 我的 清华邮箱认证(@tsinghua.edu.cn) 认证成功后角色升级,信息化 tab 可进入
B7 我的 注销账号 二次确认 + 验证码;成功后本地数据清空、回登录页
B8 我的 修改密码 旧密码错误被拒;成功后需重新登录

C. 赛事

编号 入口 步骤 预期
C1 赛事列表 三个状态筛选 + 下拉刷新 列表与状态文案一致
C2 赛事详情 打开 THUAI7 / 第9届软件设计大赛 关键节点显示 开始 ~ 结束 区间(THUAI7 应有 3 个节点)
C3 赛事公告 列表 → 详情 → 附件 按更新时间倒序;Markdown 渲染;附件可打开或复制链接
C4 组队 创建队伍 生成 8 位邀请码;创建后进入管理态;队名/简介可改
C5 组队 用邀请码加入 无效码提示;满员提示「队伍成员已满」(HTTP 551);重复加入有合理提示
C6 组队 队长移除成员 / 成员退出 / 队长解散 仅队长可移除/解散;二次确认;操作后列表刷新
C7 代码(THUAI) 上传 .cpp 代码列表出现新记录,编译状态 等待→编译中→成功(每 5s 轮询)
C8 代码(THUAI) 上传 .py / 删除代码 / 选择角色 .py 为「无需编译」;删除需确认;角色选择保存成功
C9 代码(SOFT) 未提交时提交链接;再次进入后更新 首次走「提交」,页面显示当前链接;再次提交走「更新」,不报错
C10 代码(SOFT) 终审代码 / DDL 终审链接独立保存;截止时间显示正确
C11 代码(RL) 提交历史链接 列表按时间显示,可复制
C12 对战记录 筛选/搜索/仅我的 → 下载回放 回放链接形如 .../{赛事名}/arena/{room_id}/playback.thuaipb
C13 对战记录 进行中/已结束对局 「下载回放」只在已结束对局出现

D. 信息化(需 student)

编号 入口 步骤 预期
D1 信息化 用 user / teacher / counselor 打开 显示「需要清华学生身份」,不出现「信息加载失败」
D2 门户公告 切换 5 个分类 → 详情 → 附件 分类切换正确;附件可获取链接
D3 导师 导师列表 可申请/已满状态;积极分子导师有标记
D4 导师 提交申请 → 修改陈述 → 撤销 陈述必填;修改成功;撤销后列表更新
D5 导师 谈话记录上传 仅新生(in_freshman)显示导师谈话卡片;上传后列表刷新
D6 导师 旧系统记录(显示「旧系统」)下载 能下载(回退 chat_record/{申请id}/)
D7 导师 积极分子谈话记录 仅 is_member 显示该卡片
D8 导师交流 联系人 → 进入聊天 → 发送 8s 轮询更新;自己/对方消息左右区分;返回列表正常
D9 荣誉 切换荣誉类型 成绩单/申请表/材料链接按类型显示;阶段与时间表正确
D10 荣誉 提交/编辑/删除 附件 ≤ 20MB;提交后状态「审核中」;重复申请有提示

E. 课程与资源(需 student)

编号 入口 步骤 预期
E1 课程列表 搜索/类型筛选 结果正确,无卡顿
E2 课程详情 查看评分 六维均分与我的评分正确
E3 课程详情 新增/更新/删除评分 有 0 分项时不允许提交;删除需确认
E4 课程详情 发布一条评论 立即出现在列表并标「待审核」(刷新后仍在)
E5 课程详情 点「回复」→ 输入 → 发布 输入区标题变为「回复 xxx」;回复缩进显示在父评论下
E6 课程详情 对回复点赞/收藏 操作有效,数字变化(回复上的操作不能失效)
E7 课程详情 编辑/删除自己的评论(含回复) 只有自己的评论显示编辑/删除;他人评论无入口
E8 SAST Weekly 打开列表 → 点击文章 mp.weixin.qq.com 公众号文章尝试在小程序内打开;加载失败可复制链接

F. 我的

编号 入口 步骤 预期
F1 我的 查看资料 用户名/姓名/学号/院系/班级/清华邮箱正确
F2 我的 → 编辑 修改班级/院系/姓名 保存成功;重进后回显(接口字段为 className)
F3 我的 更换头像 上传成功;列表/重进后仍显示(COS avatar/{uuid}/)
F4 我的 清华认证 仅 user 显示入口;成功后角色升级
F5 我的 修改密码 校验旧密码;成功后旧密码失效
F6 我的 退出 / 注销 本地 token、资料缓存清理

G. 发布前

  • 关闭「不校验合法域名」后,真机全流程可用
  • 体验版扫码:iOS + Android 各走一遍 A–F 主路径
  • 包体积:主包 < 2 MB,总包 < 20 MB(微信后台「代码质量」可看)
  • 隐私保护指引:邮箱、姓名、学号、院系班级;首次启动 wx.requirePrivacyAuthorize 流程
  • 类目/资质、审核截图与说明
  • release 构建不输出 token / 密码等敏感日志

3. 本轮修复回归点(必测)

修复 对应用例 判定标准
赛事时间线字段修正 C2 赛事详情能打开,时间线显示起止区间(不再「赛事加载失败」)
SOFT/RL 代码数组取值 C9 / C11 未提交时能提交;已提交时显示当前链接并可更新
导师页角色闸门 D1 teacher/counselor 看到「需要清华学生身份」,无报错弹窗
导师谈话记录条件展示 D5 / D7 非新生不显示导师谈话卡片;非积极分子不显示积极分子卡片
旧系统谈话记录下载 D6 显示「旧系统」的记录可下载
对战回放 COS 路径 C12 / C13 链接含 /arena/{room_id}/playback.thuaipb;仅已结束对局显示入口
课程评论可见性与楼中楼 E4–E7 待审核评论可见;回复缩进;回复上的点赞/编辑/删除可用

4. 常见错误码速查

状态码 含义 常见位置
401 token 失效 / 验证码错误 任意接口;登录、改密、注销
403 角色无权限 / 不在队伍中 信息化、组队、代码
404 资源不存在 公告/附件/回放
409 重复(荣誉申请、编译中) 荣誉、代码编译
429 频率限制 导师申请
450 / 451 参数缺失 / 角色不符 荣誉接口
551 队伍成员已满 组队加入
-1 网络失败(wx.request fail) 断网、域名未配置

真机上如果所有请求都失败,优先检查:服务器域名白名单、HTTPS 证书、以及手机网络是否被校园网客户端隔离。


5. 记录模板

用例 结果 设备 / 基础库 截图 备注
C2 ✅ / ❌ iPhone 14 / 3.4.10 链接

提 Bug 时请附:页面路径、账号角色、复现步骤、预期/实际、网络类型、截图或录屏、控制台错误。


6. 提交前自动化校验

node scripts/test_structure.cjs      # 页面/导航/事件处理器/组件路径
node scripts/test_wxml_balance.cjs   # WXML 标签闭合
node scripts/test_bindings.cjs       # WXML ↔ JS 绑定一致性
node scripts/test_utils.cjs          # SHA1/JWT/Markdown
node scripts/test_cos_signature.cjs  # COS 签名(有 SDK 时与官方实现逐字节比对)

CI(.github/workflows/ci.yml)会在每次 push / PR 自动执行以上检查。