How mohamadzuheer6-gif/aegis-full-stack-project works
AEGIS is a campus platform for grievance resolution, academic tools, and faculty–student opportunities. Users enter through the React application, whose protected pages use a shared API service to reach the Express API; backend routes apply JWT/role checks, controllers handle domain operations, and PostgreSQL persists relational data. The graph preserves the documented grievance, calendar/resources, and opportunity/application/task/messaging capabilities. Several UI-to-API links are documented or indicated by the API service, but unsampled pages and controllers limit detail on their exact calls.
Main entry points: api.js API service · server.js Express API server · App.jsx React routes · db.js PostgreSQL access
Components 25
Client application
- React routes
aegis-frontend/src/App.jsx - API service
aegis-frontend/src/services/api.js
Identity and access
- Login and registration
aegis-frontend/src/pages/Login.jsx - Protected routes
aegis-frontend/src/components/ProtectedRoute.jsx - Authentication endpoints
aegis-backend/routes/auth.routes.js - Authentication
aegis-backend/controllers/auth.controller.js - JWT and role checks
aegis-backend/middleware/auth.middleware.js
Grievance management
- Grievance submission and tracking
aegis-frontend/src/pages/GrievanceSubmit.jsx - Authority grievance dashboard
aegis-frontend/src/pages/AuthorityGrievanceDashboard.jsx - Grievance endpoints
aegis-backend/routes/grievance.routes.js - Grievance operations
aegis-backend/controllers/grievance.controller.js - Assignment and analytics
aegis-backend/controllers/authority.controller.js
Academic tools
- Calendar, resources, courses
aegis-frontend/src/pages/ChronosCalendar.jsx - Resource search and upload
aegis-backend/routes/resources.routes.js - Academic events
aegis-backend/controllers/academic_events.controller.js
Opportunity management
- Opportunities and applications
aegis-frontend/src/pages/OpportunityDetail.jsx - Faculty portal and inbox
aegis-frontend/src/pages/FacultyPortal.jsx - Scholar task manager
aegis-frontend/src/pages/ScholarLedger.jsx - Opportunity endpoints
aegis-backend/routes/opportunities.routes.js - Applications and resumes
aegis-backend/controllers/applications.controller.js - Bookmarks, tasks, messaging
aegis-backend/controllers
API and persistence
- Express API server
aegis-backend/server.js - PostgreSQL access
aegis-backend/db.js - PostgreSQL
Other components
- Campus users
Connections 44
- Campus users → React routes: use
README.md - React routes → Login and registration: routes to
aegis-frontend/src/App.jsx - React routes → Protected routes: guards pages
aegis-frontend/src/App.jsx - React routes → Grievance submission and tracking: routes to
aegis-frontend/src/App.jsx - React routes → Authority grievance dashboard: routes to
aegis-frontend/src/App.jsx - React routes → Calendar, resources, courses: routes to
aegis-frontend/src/App.jsx - React routes → Opportunities and applications: routes to
aegis-frontend/src/App.jsx - Login and registration → API service: uses
aegis-frontend/src/pages/Login.jsx - API service → Authentication endpoints: requests
aegis-frontend/src/services/api.js - Authentication endpoints → Authentication: dispatches
aegis-backend/routes/auth.routes.js - Protected routes → API service: checks session
- React routes → API service: uses API layer
README.md - API service → Express API server: sends REST requests
README.md - Express API server → Authentication endpoints: mounts
aegis-backend/server.js - Express API server → Grievance endpoints: mounts
aegis-backend/server.js - Express API server → Resource search and upload: mounts
aegis-backend/server.js - Express API server → Opportunity endpoints: mounts
aegis-backend/server.js - Express API server → Academic events: mounts events route
- Grievance submission and tracking → API service: uses grievance API
- Authority grievance dashboard → API service: uses authority API
- API service → Grievance endpoints: requests
aegis-frontend/src/services/api.js - API service → Resource search and upload: requests
aegis-frontend/src/services/api.js - API service → Opportunity endpoints: requests
aegis-frontend/src/services/api.js - Grievance endpoints → Grievance operations: dispatches
aegis-backend/routes/grievance.routes.js - Grievance endpoints → JWT and role checks: authenticates
aegis-backend/routes/grievance.routes.js - Authority grievance dashboard → API service: uses authority endpoints
- API service → Assignment and analytics: requests
aegis-frontend/src/services/api.js - Assignment and analytics → PostgreSQL access: queries and updates
aegis-backend/controllers/authority.controller.js - Grievance operations → PostgreSQL access: queries and updates
aegis-backend/controllers/grievance.controller.js - Calendar, resources, courses → API service: uses academic APIs
- API service → Academic events: requests events
aegis-frontend/src/services/api.js - Resource search and upload → PostgreSQL access: queries and stores
aegis-backend/routes/resources.routes.js - Express API server → Resource search and upload: mounts
aegis-backend/server.js - Opportunities and applications → API service: uses opportunity APIs
- Faculty portal and inbox → API service: uses opportunity APIs
- Scholar task manager → API service: uses task API
- Opportunity endpoints → JWT and role checks: authenticates
aegis-backend/routes/opportunities.routes.js - API service → Applications and resumes: requests applications
aegis-frontend/src/services/api.js - Applications and resumes → PostgreSQL access: reads and writes
aegis-backend/controllers/applications.controller.js - API service → Bookmarks, tasks, messaging: requests features
aegis-frontend/src/services/api.js - Express API server → Bookmarks, tasks, messaging: mounts feature routes
aegis-backend/server.js - Academic events → PostgreSQL access: queries data
aegis-backend/controllers/academic_events.controller.js - JWT and role checks → Express API server: protects API routes
- PostgreSQL access → PostgreSQL: queries
README.md