How nk-empire/alumni-managemnet-system- works
APIUMS manages alumni professional-record updates through role-based admin, leader, and member workflows. The documented user journey covers authentication, record assignment, draft or submitted updates, and administrative oversight through imports, analytics, reports, and audit history. The repository contains both browser JavaScript and an Express/MSSQL backend; the README describes frontend-to-API integration as future work, so their connection is not represented as an established runtime flow. Several backend capabilities are documented or indexed but their implementations were not excerpted, so uncertain links are omitted.
Main entry points: database.js MSSQL database · alumni.routes.js Alumni routes · index.js API route registry · api.js Browser API client
Components 26
Web experience
- Role dashboards
public/js/admin.js - Leader workflow
public/js/leader.js - Member workflow
public/js/member.js - Chat interface
public/js/chatPage.js - Browser API client
public/js/services/api.js
API and access
- HTTP server
server.js - API route registry
backend/src/routes/index.js - Authentication routes
backend/src/routes/auth.routes.js - Authentication service
backend/src/services/auth.service.js - Authentication middleware
backend/src/middleware/authenticate.js
Alumni workflows
- Alumni routes
backend/src/routes/alumni.routes.js - Alumni controller
backend/src/controllers/alumni.controller.js - Search controller
backend/src/controllers/search.controller.js - Alumni service
backend/src/services/alumni.service.js - Natural-language search
backend/src/services/searchParser.service.js - Round-robin assignment
backend/src/services/roundRobin.service.js
Administration and insights
- Alumni analysis
backend/src/controllers/alumniAnalysis.controller.js - Import processing
backend/src/services/import_engine/main.py - Data cleaning
backend/src/services/import_engine/cleaning_engine.py - Attendance and progress
backend/src/services/attendance.service.js - Reports and dashboard
backend/src/services/report.service.js - Audit history
backend/src/repositories/audit.repository.js
Data and persistence
- Authentication repository
backend/src/repositories/auth.repository.js - Alumni repository
backend/src/repositories/alumni.repository.js - MSSQL database
backend/src/config/database.js
Other components
- Admin, leaders, members
Connections 24
- Admin, leaders, members → Role dashboards: use dashboards
README.md - Admin, leaders, members → Leader workflow: distribute records
README.md - Admin, leaders, members → Member workflow: update records
README.md - Role dashboards → Browser API client: planned API use
README.md - Leader workflow → Browser API client: planned API use
README.md - Member workflow → Browser API client: planned API use
README.md - HTTP server → API route registry: mounts routes
server.js - API route registry → Authentication routes: registers
backend/src/routes/index.js - API route registry → Alumni routes: registers
backend/src/routes/index.js - Alumni routes → Authentication middleware: authenticates
backend/src/routes/alumni.routes.js - Alumni routes → Alumni controller: dispatches
backend/src/routes/alumni.routes.js - Alumni routes → Search controller: dispatches search
backend/src/routes/alumni.routes.js - Alumni controller → Alumni service: delegates
backend/src/controllers/alumni.controller.js - Search controller → Natural-language search: parses query
backend/src/controllers/search.controller.js - Natural-language search → Alumni repository: queries records
backend/src/services/searchParser.service.js - Alumni repository → MSSQL database: reads and writes
backend/src/repositories/alumni.repository.js - Authentication service → Authentication repository: loads accounts
backend/src/services/auth.service.js - Authentication repository → MSSQL database: queries
backend/src/repositories/auth.repository.js - Authentication service → Attendance and progress: records activity
backend/src/services/auth.service.js - Import processing → Data cleaning: uses cleaners
backend/src/services/import_engine/main.py - Round-robin assignment → MSSQL database: persists assignments
- Alumni analysis → MSSQL database: reads analytics
- Reports and dashboard → MSSQL database: builds reports
- Audit history → MSSQL database: stores audit records