项目简介
CSMS（ClassScoreManageSystem） 是一套面向学校的「班级操行分 / 综合素质评价」管理系统。它帮助学校、年级、班级三级管理团队，对学生操行分进行实时、可追溯的记录、统计与展示。
CSMS v0.3.0 起进行了完全重构，由早期的 PHP + jQuery 方案迁移到现代化的 Nuxt 4 全栈架构，带来更好的开发体验、更强的扩展能力与更完整的权限模型。
核心特性
- 多级管理架构：超级管理员 → 学校管理员 → 年级管理员 → 班级管理员（班主任），四级权限层层收敛。
- 多校数据隔离：每所学校拥有独立的数据库文件，物理隔离、互不可见。
- 实时积分管理：积分增减、撤销、模板化录入，全程审计。
- 可视化座位表：拖拽编辑、一键生成班级座位布局。
- 数据统计：班级 / 年级 / 全校多维度的积分与排名统计。
- 公告系统：校级公告发布与展示。
- 安全认证：Session + BCrypt，管理员分级与二次验密。
- 邮件通知：入驻审核结果自动邮件通知，模板可在线编辑。
- 外部开放 API v1：基于 Bearer 鉴权与细粒度 scope，供第三方系统安全对接。
- PWA 渐进式应用：可安装到桌面 / 主屏幕，离线缓存静态资源。
技术栈
| 类别 | 技术 |
|---|---|
| 全栈框架 | Nuxt 4 |
| 前端 | Vue 3 + TypeScript + Composition API |
| 数据库 | SQLite + Drizzle ORM |
| 样式 | Tailwind CSS 4 |
| 认证 | Session + BCrypt |
| 图表 | Chart.js |
| PWA | @vite-pwa/nuxt（Workbox） |
| 运行要求 | Node.js ≥ 18 |
版本特色（v0.3.x）
- v0.3.2：权限与统计筛选增强，跨校封禁逻辑完善，座位布局与封禁管理体验优化。
- v0.3.1：管理员所属可按管理级别由超级管理员编辑；班级管理员仅能为本人所管班级签发 API 凭证。
- v0.3.0：完全重构，从 PHP + jQuery 迁移到 Nuxt 4 全栈；引入多租户分库、四级权限、外部开放 API、PWA、邮件通知。
文档地图
- 想马上跑起来？→
- 想了解谁能做什么？→
- 想了解每个功能怎么用？→
- 想了解数据库怎么组织？→
- 想部署到服务器？→
- 遇到问题？→
项目状态与许可
- 当前版本：v0.3.2
- 许可证：GPL-3.0
- 源码仓库：QianKunBoss/ClassScoreManageSystem
- 交流：QQ 群 1074247379