A comprehensive gamified learning platform that rewards student progress with HP (Holistic Points) across courses, activities, and external integrations.
HP System is a modular, scalable platform designed to gamify education through a points-based reward system. Teachers create cohorts and activities, students earn/spend HP based on performance, and the system handles automated rewards, penalties, and comprehensive analytics.
Key Entities (Phase 0 ✅):
| Entity | Description | Status |
|---|---|---|
Teacher |
Course/Cohort owner | ✅ |
Course |
Academic container | ✅ |
Cohort |
Student group | ✅ |
Student |
Email-based identity | ✅ |
Activity |
Tasks with HP rules | ✅ |
Submission |
Proof of completion | ✅ |
HP Ledger |
All credit/debit events | ✅ |
HP Rule |
Reward/Penalty config | ✅ |
- Cohort Setup + Student Import (email-based)
- Base HP Assignment (default: 100, configurable)
- Activity Creation (title, deadline, HP rules, mandatory toggle)
- Submission Review + Revert
- In-Platform Submission (file/image/link/text)
- Auto HP Awards (absolute/% compounding)
- Real-time Dashboard + Ledger
- Penalty Engine (scheduled for mandatory deadlines)
- Full Ledger Audit Trail
- Email Canonical Identity
| Phase | Milestone | Status |
|---|---|---|
| 1 | Core HP System | ✅ LIVE |
| 2 | VIBE Integration | 🔄 Next |
| 3 | Google Forms/CSV | 🔄 Planned |
| 4 | Peer Endorsements | 🔄 Planned |
| 5 | AI Feedback Coach | 🔄 Planned |
git clone https://github.com/Mahabub-3301/hp-system.git
cd hp-system
npm install
npm run dev
# → http://localhost:3000MERN