Introduction
CSMS (ClassScoreManageSystem) is a "class conduct score / comprehensive quality evaluation" management system for schools. It helps school, grade and class management teams record, analyze and display student conduct scores in real time and with full traceability.
Starting from v0.3.0, CSMS was completely rebuilt — migrating from the legacy PHP + jQuery stack to a modern Nuxt 4 full-stack architecture, bringing a better developer experience, stronger extensibility and a more complete permission model.
Core Features
- Multi-level management: super admin → school admin → grade admin → class admin (homeroom teacher), with permissions converging level by level.
- Multi-school isolation: each school has its own database file, physically isolated and invisible to others.
- Real-time score management: score add / deduct / revoke with templated entry and full auditing.
- Visual seating chart: drag-and-drop layout editing, one-click class seating generation.
- Statistics: class / grade / school-wide multi-dimensional score and ranking statistics.
- Announcement system: school-wide announcements.
- Secure auth: Session + BCrypt, role grading and re-authentication for sensitive actions.
- Email notifications: automatic onboarding result emails with editable templates.
- External Open API v1: Bearer auth + fine-grained scopes for safe third-party integration.
- PWA: installable on desktop / home screen, offline static caching.
Tech Stack
| Category | Technology |
|---|---|
| Full-stack framework | Nuxt 4 |
| Frontend | Vue 3 + TypeScript + Composition API |
| Database | SQLite + Drizzle ORM |
| Styling | Tailwind CSS 4 |
| Auth | Session + BCrypt |
| Charts | Chart.js |
| PWA | @vite-pwa/nuxt (Workbox) |
| Runtime | Node.js ≥ 18 |
Version Highlights (v0.3.x)
- v0.3.2: permission & statistics filtering enhancements, cross-school ban logic, seating layout and ban management UX improvements.
- v0.3.1: admin affiliation editable by super admin per management level; class admins can only issue API tokens for their own class.
- v0.3.0: full rebuild from PHP + jQuery to Nuxt 4 full-stack; introduces multi-tenant per-school DBs, four-level roles, external Open API, PWA and email notifications.
Documentation Map
- Want to run it now? →
- Want to know who can do what? →
- Want to learn each feature? →
- Want to understand the database? →
- Want to deploy to a server? →
- Stuck? →
Status & License
- Current version: v0.3.2
- License: GPL-3.0
- Repository: QianKunBoss/ClassScoreManageSystem
- Community: QQ Group 1074247379