How arafaykhalid/eutcm-api works
HITMS is a full-stack admissions and campus-information portal: candidates use the web app to manage application materials and entry-test steps, while administrators manage candidates, reviews, and public content. The API provides authentication, candidate and admin operations, and public content endpoints over a Mongo-backed Express service. The tree establishes the broader feature areas, but most route wiring and frontend-to-API calls were not sampled; those connections are therefore omitted rather than inferred.
Main entry points: server.ts Express server · user.model.ts User records · auth Authentication API · app Web application
Components 25
Web experience
- Web application
apps/web/src/app - Auth state
apps/web/src/stores/useAuth.ts - Candidate portal
apps/web/src/app/dashboard - Admin portal
apps/web/src/app/admin
Identity and sessions
- Authentication API
apps/api/src/controllers/auth - Session management
apps/api/src/controllers/user - Session limits
apps/api/src/utils/sessionManager.util.ts - User records
apps/api/src/models/user.model.ts
Admissions workflow
- Candidate application
apps/api/src/controllers/candidates/application - Education details
apps/api/src/controllers/candidates/education - Personal details
apps/api/src/controllers/candidates/personalInfo - Entry-test challan
apps/api/src/controllers/candidates/challan - Admin reviews
apps/api/src/controllers/candidates/managementByAdmins - Entry-test access
apps/api/src/controllers/candidates/managementByAdmins/entryTest
Campus content
- Public content
apps/api/src/controllers/content/public.controller.ts - Content records
apps/api/src/models - Content administration
apps/api/src/controllers/admin/content
API runtime
- Express server
apps/api/src/server.ts - API routes
apps/api/src/routes/index.ts - Runtime config
apps/api/src/config/index.ts - Request limiting
apps/api/src/lib/expressRateLimiter.ts - CORS policy
apps/api/src/lib/corsOptions.ts - Database connection
apps/api/src/lib/mongoose.ts - Logging
apps/api/src/lib/winston.ts
Other components
- Candidate or admin
Connections 15
- Candidate or admin → Web application: uses
- Web application → Candidate portal: offers
- Web application → Admin portal: offers
- Authentication API → User records: looks up
apps/api/src/controllers/auth/login.controller.ts - Authentication API → Session limits: prunes sessions
apps/api/src/controllers/auth/login.controller.ts - Authentication API → User records: saves session
apps/api/src/controllers/auth/login.controller.ts - Session management → User records: reads sessions
apps/api/src/controllers/user/getSessions.controller.ts - Admin reviews → User records: reviews application
apps/api/src/controllers/candidates/managementByAdmins/application/reviewApplication.controller.ts - Public content → Content records: reads published items
apps/api/src/controllers/content/public.controller.ts - Express server → API routes: mounts routes
apps/api/src/server.ts - Express server → Runtime config: reads config
apps/api/src/server.ts - Express server → Request limiting: applies limiter
apps/api/src/server.ts - Express server → CORS policy: applies policy
apps/api/src/server.ts - Express server → Database connection: connects database
apps/api/src/server.ts - Express server → Logging: logs events
apps/api/src/server.ts