立项原因：传统课堂管理中，教师对学生表现的评价缺乏系统化记录和可视化激励手段，口头表扬和手工记分难以持续跟踪，学生积极性容易消退。积分奖励虽然普遍使用，但纸质积分卡易丢失、统计繁琐，家长也无法及时了解孩子在校表现。本项目旨在将班级积分管理数字化，让教师高效记录、审核和发放积分，通过排行榜和积分商城形成正向激励闭环，同时为家长提供透明的成长数据。
业务背景：项目面向K12教育场景下的班级日常管理，覆盖小学至高中阶段。随着教育信息化2.0推进，越来越多的学校从传统黑板粉笔转向智能教学工具，班级管理工具的数字化需求强烈。积分制作为行为管理和激励教育的核心手段，需要一个轻量、易用、可定制的SaaS工具来替代教师繁重的纸质统计工作。
系统围绕"积分激励"构建了完整的管理闭环，包含六大功能模块：
1. 学生管理：支持单个添加和名单一键导入，学生信息包含姓名、学号、性别。提供按学号/姓名/积分排序、首字母快速检索、多选模式和全员操作，方便教师高效管理班级花名册。
2. 积分操作：每个学生卡片展示总分和可用积分，支持加分、减分、兑换和操作记录查询。学生的可用积分用于商城兑换，兑换后不影响历史总分，计分逻辑清晰。
3. 积分审核：积分变动需经过审核流程，防止随意加减分，保证积分发放的公平性和规范性。
4. 排行榜系统：提供个人榜、小组榜、明星榜三种维度，支持总榜、月榜、周榜时段切换和一键导出，让竞争激励可视化、数据可追溯。
5. 积分商城：学生可用积分兑换实物或虚拟奖励，形成"表现→积分→兑换→激励"的正向循环。
6. 协作与安全：支持邀请老师协同管理、家长密码保护隐私、多主题切换适配不同场景，以及数据导出和桌面快捷方式。
我负责该项目的全栈开发，从需求分析、UI设计到前后端实现和部署上线。
技术栈方面，前端采用 React + TypeScript 构建 SPA，使用 Zustand 做状态管理，Tailwind CSS 处理响应式布局；后端基于 Node.js + Express，数据库采用 PostgreSQL，通过 RESTful API 与前端交互。排行榜实时排序通过 Redis Sorted Set 实现，避免大数据量下数据库排序的性能瓶颈。架构上采用前后端分离，JWT 鉴权，支持多班级数据隔离。
实现亮点包括：积分操作的事务性保障（加减分与审核状态联动，防止并发冲突）、排行榜的多维度实时聚合（个人/小组/明星三个维度交叉时段查询）、以及一键导入学生名单的 CSV 解析与去重逻辑。难点在于积分商城的库存与积分双扣减一致性，通过数据库行级锁 + 乐观锁方案解决超兑问题。
评论