清华大学电子工程系学生科协(EESAST)平台的微信小程序客户端,将 eesast.com 的主要功能以原生小程序的方式呈现。
项目架构、ADR、版本和验收文档见 docs/README.md。本仓库为独立新增仓库,不修改同目录下
web/api/hasura三个原有仓库的任何内容,作为现有后端(api.eesast.com+ Hasura GraphQL + 腾讯云 COS)的新客户端运行。
| 模块 | 功能 |
|---|---|
| 首页 | 轮播新闻、科协部门、赛事展示墙、快捷入口 |
| 赛事互动 | 赛事列表(状态筛选、卡片右下角状态角标)、赛事详情(简介/时间线/统计)、公告列表与 Markdown 详情(附件下载)、组队(创建/邀请码加入/队伍管理/退出解散)、代码提交(THUAI 上传+编译状态轮询+选码;SOFT/RL 链接提交)、天梯/RL 积分榜、对战记录(轮询刷新/回放下载) |
| 信息化平台 | 门户公告(5 分类)、新生导师制(导师列表/申请/谈话记录上传下载)、导师-学生私信、荣誉(奖学金)申请(附件 COS 直传) |
| 资源共享 | 课程评测(搜索/六维评分/评论/点赞收藏)、SAST Weekly |
| 我的 | 账号密码登录、分步注册(邮箱验证码)、找回密码、个人资料编辑、头像上传、清华邮箱认证(升级学生身份)、注销账号、退出登录 |
暂不包含(详见 架构说明):Unity WebGL 试玩/直播/在线回放(平台不支持,引导网页端)、赛事管理端、微信一键登录(需后端改造)。
- 安装 微信开发者工具
- 导入本仓库目录(
appid已设为测试号touristappid,也可换成自己的 AppID) - 项目零 npm 依赖,导入即可预览
- 开发者工具中请保持「不校验合法域名」仅用于本地调试(已放在
project.private.config.json,该文件不入库)
Weekly 公众号文章会尝试在小程序内打开;Docs、赛事网页介绍和 Minecraft 等普通网页仍需配置业务域名后才能使用 web-view,当前默认复制链接到微信/浏览器打开。
在 WSL 中开发时,用 scripts/devtools.sh 一键把项目镜像同步到 Windows 盘并启动微信开发者工具(工具对 \\wsl.localhost UNC 路径支持不稳,故先镜像到 D:\wechat-aaplet\eesast-applet,镜像已开热重载,重复 sync 自动重编译):
scripts/devtools.sh open # 同步镜像并启动工具打开项目(GUI 顶部点「真机调试」扫码调试)
scripts/devtools.sh preview # 同步并生成真机预览二维码(微信扫码)
scripts/devtools.sh sync # 仅同步镜像首次使用需在工具 GUI 中开启 设置 → 安全设置 → 服务端口;工具安装路径变化时修改脚本头部 IDE_BASE_W / IDE_REL 常量。
- 注册小程序取得正式 AppID(类目建议:教育 > 在线教育,或工具 > 信息查询),替换
project.config.json - 小程序后台「开发管理 → 服务器域名」配置 request 合法域名:
https://api.eesast.com(REST + GraphQL)https://eesast-1255334966.cos.ap-beijing.myqcloud.com(COS 直传/下载)https://static.eesast.com(静态图片)
- 申报《用户隐私保护指引》(收集:邮箱、姓名、学号、院系班级)
- 基础库要求 ≥ 2.10.0,推荐 ≥ 2.32.3
applet/
├── AGENTS.md # 仓库协作、验证和提交规范
├── docs/ # 架构、ADR、版本和验收文档
├── project.config.json
├── scripts/ # 图标生成与校验脚本(不打包)
└── miniprogram/
├── app.{js,json,wxss} # 5-tab 应用骨架,darkmode + theme.json
├── config/index.js # API/COS/角色常量(与 web .env 对齐)
├── utils/ # request/graphql/auth/cos/sha1/markdown/poll
├── services/ # GraphQL 查询(复刻 web/src/graphql)
├── components/ # markdown 渲染 / empty 空态
├── data/ # 首页静态数据(与 web 同源)
├── pages/ # 主包:home/contest/info/share/user/register/reset/notice-detail
└── packages/ # 分包
├── contest/ # intro/notice/notice-detail/team/code/score/arena
├── info/ # mentor/mentor-chat/honor
└── share/ # course/course-detail/weekly
- 零 npm 依赖:COS XML API 签名(SHA-1/HMAC-SHA1)、JWT 解码、Markdown 解析均为纯 JS 自实现;COS 签名已与官方
cos-js-sdk-v5算法逐字节比对一致(含中文键名场景) - 凭证安全:JWT 仅存微信沙箱存储;验证码 JWT 只存内存;COS 仅用后端发放的 STS 临时密钥(按前缀最小授权);密码永不落盘
- 权限双闸:前端按
userRoles/tsinghuaRoles/counselor分级拦截,后端 Hasura 行级权限强制兜底;管理端接口一律不接入 - 不接入的原系统危险端点:
/notification/broadcast、/files/upload(无鉴权) - 响应式:全 rpx 布局 + 宽屏
max-width阅读容器 +env(safe-area-inset-bottom)安全区 + 深浅双主题
- 全部 JS
node --check通过;全部 JSON 可解析;40 个 JS 模块在 stub 环境加载成功(node scripts/test_module_load.cjs) - 24 个 WXML 标签闭合平衡(
test_wxml_balance.cjs);全部 bind/catch 事件处理器与 JS 方法一一对应、组件引用路径有效(test_wxml_handlers.cjs) - WXML ↔ JS 绑定一致性:24 个 WXML 的
{{}}字段与<template>调用均可追溯到 JS 数据源,0 问题:node scripts/test_bindings.cjs - 接口实测(对
api.eesast.com线上):匿名角色可读的全部 GraphQL 查询逐条验证通过,含 9 个赛事的contest_time时间线与getTeams/getArenaRooms/getRLScores等;REST 端点与api/src/routes的 method/请求体/响应对应关系逐条核对 - SHA-1 / HMAC-SHA1 通过 RFC 3174/2202 测试向量;JWT 解码(含中文/过期/匿名)通过
- COS 签名与官方 SDK 三组样例(put/get/head + 中文路径)完全一致:
node scripts/test_cos_signature.cjs - 赛事与 Weekly 直连生产 Hasura GraphQL(与 web 同库实时同步,onShow 自动刷新 + 下拉刷新)
以上校验已固化为脚本,并由 .github/workflows/ci.yml 在每次 push / PR 自动执行:test_structure.cjs(页面/导航/事件/组件)、test_wxml_balance.cjs、test_bindings.cjs(WXML↔JS 绑定)、test_utils.cjs(SHA1/JWT/Markdown)、test_cos_signature.cjs(无 SDK 时校验内置基准向量,CI 中安装官方 SDK 逐字节比对)。真机验收清单见 docs/TESTING.md。
- 原系统 CORS/域名未变:小程序请求不受浏览器 CORS 限制,但真机必须在后台配置域名白名单(见上)
- 微信登录需要后端新增
code2session逻辑;受「不修改原仓库」约束,v1 使用与网页端一致的账号密码登录(utils/auth.js预留扩展点)