How udarisathsarani1001/visionroot-software-engineering-assignment works
This is a web-based service-request management system: users register, authenticate, and create or manage their own requests; administrators review all requests, change statuses, and view users. The frontend’s dedicated service modules call a REST API, whose routes dispatch through middleware and controllers into business services and MongoDB models. Authentication uses access and refresh tokens, and request status transitions and role-based restrictions are core domain behavior. Some frontend page-to-service links and unsampled administrative implementation details are shown only where documented or left unasserted.
Main entry points: app.ts API application · request.routes.ts Request routes · api.ts HTTP client · User.model.ts User records
Components 26
Frontend experience
- Sign-in and registration
frontend/app/login/page.tsx - User request screens
frontend/app/requests/page.tsx - Admin screens
frontend/app/admin/requests/page.tsx - Session state
frontend/providers/AuthProvider.tsx
Frontend API client
- Auth client
frontend/services/auth.service.ts - Request client
frontend/services/request.service.ts - User client
frontend/services/user.service.ts - HTTP client
frontend/services/api.ts
Backend request handling
- API application
backend/src/app.ts - Auth routes
backend/src/routes/auth.routes.ts - Request routes
backend/src/routes/request.routes.ts - User routes
backend/src/routes/user.routes.ts - Auth controller
backend/src/controllers/auth.controller.ts - Request controller
backend/src/controllers/request.controller.ts - Authentication guard
backend/src/middleware/auth.middleware.ts - Role guard
backend/src/middleware/role.middleware.ts
Domain services and data
- Identity service
backend/src/services/auth.service.ts - Request service
backend/src/services/request.service.ts - Status transitions
backend/src/services/request-status.service.ts - User service
backend/src/services/user.service.ts - User records
backend/src/models/User.model.ts - Refresh tokens
backend/src/models/RefreshToken.model.ts - Service requests
backend/src/models/ServiceRequest.model.ts
Other components
- Registered user
- Administrator
- MongoDB
Connections 30
- Registered user → Sign-in and registration: registers or logs in
README.md - Registered user → User request screens: manages requests
README.md - Administrator → Admin screens: manages service data
README.md - Sign-in and registration → Auth client: uses auth operations
- User request screens → Request client: uses request operations
- Admin screens → Request client: uses request operations
- Session state → Auth client: restores session
- Auth client → HTTP client: sends API requests
frontend/services/auth.service.ts - Request client → HTTP client: sends API requests
frontend/services/request.service.ts - User client → HTTP client: sends API requests
frontend/services/user.service.ts - HTTP client → API application: calls REST API
README.md - API application → Auth routes: mounts routes
backend/src/app.ts - API application → Request routes: mounts routes
backend/src/app.ts - API application → User routes: mounts routes
backend/src/app.ts - Auth routes → Auth controller: dispatches handlers
backend/src/routes/auth.routes.ts - Request routes → Request controller: dispatches handlers
backend/src/routes/request.routes.ts - Auth routes → Authentication guard: guards current user
backend/src/routes/auth.routes.ts - Request routes → Authentication guard: authenticates requests
backend/src/routes/request.routes.ts - Request routes → Role guard: guards status changes
backend/src/routes/request.routes.ts - Auth controller → Identity service: invokes identity logic
backend/src/controllers/auth.controller.ts - Request controller → Request service: invokes request logic
backend/src/controllers/request.controller.ts - Authentication guard → User records: loads account
backend/src/middleware/auth.middleware.ts - Identity service → User records: reads and creates users
backend/src/services/auth.service.ts - Identity service → Refresh tokens: stores token hashes
backend/src/services/auth.service.ts - Request service → Service requests: manages requests
backend/src/services/request.service.ts - Request service → Status transitions: checks transitions
backend/src/services/request.service.ts - User service → User records: manages user records
- User records → MongoDB: persists records
README.md - Refresh tokens → MongoDB: persists tokens
README.md - Service requests → MongoDB: persists requests
README.md