高校社团招新长期依赖线下"百团大战"、微信群接龙和问卷星等工具：社团展示分散、报名信息零散、招录进度不透明，校方也难以统一沉淀和管理招录数据。本项目以"社团介绍 + 智能招录"闭环为切入点，为多所学校提供可订阅的 SaaS 平台——学校作为租户开通与订阅服务，学生经校内身份库（学号 + 校园账号）认证后进入本校空间，完成社团浏览、AI 智能推荐、在线投递、活动报名与素拓学分记录，社团管理端与校方管理端实现招新、活动、财务、场地、学分全流程数字化管理。全国 3000 余所高校中，尚无专业的"社团介绍 + 招录"一体化平台，本项目正是面向这一空白的校园数字化基础设施。
本项目包含学生端、社团管理端、校方/社联管理端与平台运营端四大角色体系，共 16 个功能模块：
1.
账号与认证：统一入口选择学校，经校内身份库核验注册；支持学号、校园账号、邮箱、手机号四种方式登录，JWT 鉴权；个人中心支持资料、头像、密码管理。
2.
社团展示与检索：社团广场支持分类查询与关键词检索；社团详情展示富文本介绍、组织架构、部门职能、历年成果与附件下载；联系方式按角色分级脱敏。
3.
招新报名：常态化招新入口全年开放，学生按社团专属简历模板在线投递，支持草稿保存与编辑，投递进度全程可视化，并设每日投递上限等防刷规则。
4.
自定义招新表单：社团管理员通过拖拽组件（文本/单选/多选/文件上传）自定义表单、配置必填项，保存为专属简历模板。
5.
简历筛选系统：对申请简历打标签、多标签组合检索、候选人星标标记与批量导出。
6.
AI 智能推荐：学生选择兴趣标签后，基于标签匹配（余弦相似度）与大模型问答双模式推荐社团并给出推荐理由。
7.
活动管理：社团发布活动，学生一键报名、现场扫码签到，管理员查看签到统计。
8.
素拓学分系统：活动签到自动累积素拓学分，管理员批量认证并导出。
9.
财务管理：社团经费收支公示、活动场地预约申请与校方审批。
10.
多级权限管理：主管理员创建子账号并分配细粒度权限（简历查看、初筛、活动管理等），换届时一键回收。
11.
管理数据看板：全校社团、用户、申请数据 ECharts 可视化看板与全局统计导出。
12.
平台运维管理：学校开通与订阅状态管理（试用/有效/逾期/暂停/取消）、系统配置、合规性告警、用户反馈与审计日志。
我在项目中负责整体架构设计与全栈实现：主导多租户 SaaS 架构设计（共享库共享表、school\_id 租户隔离、X-School-Code 租户解析拦截器、JWT 绑定 school\_id 的三方一致性校验），独立完成后端 22 个 Controller、25 个 Service、25 张数据库表，以及前端 17 个页面、13 个 API 模块的开发与联调。技术栈：前端 Vue 3 + Vite + Element Plus + ECharts；后端 Spring Boot 3 + JPA/Hibernate + 自定义 JWT 鉴权；数据库 MySQL 8；Docker Compose + Nginx 一键部署；GitHub Actions CI 保障 128 项自动化测试全绿。
实现亮点与难点：1）草稿式修改审核机制——已发布社团的修改暂存 pending\_data（JSON），管理员审核通过后才合并上线，保证线上版本稳定；2）跨校越权防护——请求学校、JWT、数据库用户三方不一致即拒绝建立登录态，跨校资源统一按不存在处理；3）安全体系——联系方式分级脱敏（未登录不可见/学生打码/管理员全见）、DOMPurify 富文本防 XSS、UUID 文件名防路径遍历、关键操作审计日志；4）自定义表单 JSON Schema 设计器 + 学生端动态渲染器；5）AI 推荐双模式架构（规则兜底 + 大模型增强，可配置开关）。最大难点是历史单校数据向多租户模型的平滑演进，通过 v26–v28 三版迁移脚本完成身份库、租户订阅与场地数据的回填，实现零停机升级。
评论