How nguyenhao1312/do_nguyen_hao-24ct1-cnpm works
UniMS is a self-hosted university and student management system with a Django backend and vanilla-JavaScript SPA. The principal workflow is role-based sign-in, then using student, teacher, or administrator features; the browser can work from encrypted local data and synchronize changes with the server. The graph covers academic records, attendance, administration, AI helpdesk, and session security. Some frontend wiring and API routes are not excerpted, so those connections are shown only where the README documents them.
Main entry points: models.py University data · app.js SPA shell · auth.py Account sessions · ai.py AI assistant API
Components 25
Browser application
- SPA shell
static/js/core/app.js - Client sign-in
static/js/core/auth.js - Offline data cache
static/js/core/database.js - Cache encryption
static/js/core/crypto.js - Sync queue
static/js/core/sync-queue.js - Role dashboards
static/js/views/common/dashboard.js - Grades and classes
static/js/views/common/grades.js - Student portal
static/js/views/student/registration.js - Tuition view
static/js/views/student/tuition.js - Attendance view
static/js/views/admin/teachers.js - Admin management
static/js/views/admin/students.js - AI helpdesk
static/js/views/common/chatbot.js - Public review
static/js/views/public/review.js
Identity and security
- Account sessions
student_management/views/user/auth.py - Single-session guard
student_management/middleware.py - API access controls
student_management/decorators.py
Academic operations
- Student records
student_management/views/student/portal.py - Academic administration
student_management/views/admin/academic.py - Teacher attendance
student_management/views/teacher/attendance.py - Role-filtered sync
student_management/views/user/sync.py - AI assistant API
student_management/views/user/ai.py
Server and data
- University data
student_management/models.py
Other components
- University user
- SQL Server
- Gemini service
Connections 30
- University user → SPA shell: uses
README.md - SPA shell → Client sign-in: hosts
- Client sign-in → Account sessions: authenticates
README.md - Account sessions → University data: reads and updates
student_management/views/user/auth.py - Account sessions → Single-session guard: issues session
- SPA shell → Role dashboards: renders by role
README.md - Role dashboards → Grades and classes: opens modules
- University user → Student portal: views portal
README.md - University user → Tuition view: checks tuition
README.md - University user → Attendance view: manages attendance
- University user → Admin management: manages users
README.md - University user → AI helpdesk: asks questions
README.md - University user → Public review: views review
- Offline data cache → Cache encryption: encrypts cache
README.md - Sync queue → Offline data cache: queues changes
README.md - Sync queue → Role-filtered sync: uploads changes
README.md - Role-filtered sync → University data: reads and writes
student_management/views/user/sync.py - Grades and classes → Academic administration: uses academic APIs
- Student portal → Student records: requests profile
- Student records → University data: reads records
student_management/views/student/portal.py - Tuition view → Academic administration: uses tuition APIs
- Attendance view → Teacher attendance: uses attendance APIs
- Academic administration → University data: reads and writes
student_management/views/admin/academic.py - Teacher attendance → University data: reads and writes
student_management/views/teacher/attendance.py - AI helpdesk → AI assistant API: sends questions
- AI assistant API → University data: reads context
student_management/views/user/ai.py - AI assistant API → Gemini service: optionally queries
- Single-session guard → University data: validates sessions
student_management/middleware.py - API access controls → University data: checks sessions and logs
student_management/decorators.py - University data → SQL Server: persists data
README.md