ClassStar 班级之星

面向小学老师的班级积分管理桌面应用。老师可以为学生加减分、查看排行榜、管理奖品兑换，UI 采用 Duolingo 风格的游戏化设计，让课堂积分管理更有趣。

• 学生管理 — 支持 Excel 批量导入/导出学生名单，提供搜索、排序、分页
• 加减分打分 — 按维度（课堂表现、作业、纪律、品德、自定义）配置加减分项，快速为学生打分
• 打分记录 — 所有打分流水可追溯查询，支持撤回误操作的评价记录
• 排行榜 — 按周期统计学生积分排名，带动效展示
• 宠物养成系统 — 学生积分转化为虚拟宠物养成进度，提升参与感
• 奖品兑换 — 配置奖品库，学生用积分兑换奖品，记录兑换历史
• 多班级支持 — 一台设备管理多个班级，数据互相隔离

• Electron + electron-vite
• React 19 + TypeScript + react-router-dom（HashRouter）
• better-sqlite3（本地 SQLite 数据库，无需联网）

• Node.js 18+
• Windows 用户如果 postinstall 拉取 better-sqlite3 预编译二进制失败，需要安装 Visual Studio Build Tools（勾选 "Desktop development with C++"）作为编译回退方案

npm install

npm run dev

npm run build:win    # Windows
npm run build:mac    # macOS
npm run build:linux  # Linux

src/
├── main/       # Electron 主进程：IPC handler、SQLite 数据库
├── preload/    # 预加载脚本，通过 contextBridge 暴露 window.api
└── renderer/   # React 渲染进程，业务页面与组件

更详细的架构说明见 CLAUDE.md。

欢迎提交 Issue 和 Pull Request。

1. Fork 本仓库并新建分支
2. 提交前请运行 npm run typecheck 和 npm run lint
3. 提交 PR 时请说明改动内容和测试方式

本项目基于 MIT License 开源。