How dexode-03/capstone-faculty-eval-system works
FEFAS is a faculty evaluation and feedback system. Students sign in, find instructors, submit rated and written evaluations, and later review their submissions; faculty and administrators view reports and dashboard summaries, while administrators manage accounts and system-wide evaluation data. The backend routes role-protected requests to controllers, which apply domain logic and use MySQL-backed models; evaluation analysis also uses privacy and sentiment utilities. The README is empty, so capability coverage is based on the source index and excerpts; several page and route implementations were not sampled.
Main entry points: evaluationController.js Evaluation workflows · App.jsx Route and page shell · db.js MySQL database · authController.js Account workflows
Components 29
Web application
- Route and page shell
frontend/src/App.jsx - Auth context
frontend/src/context/AuthContext.jsx - Auth hook
frontend/src/hooks/useAuth.js - Evaluation form
frontend/src/pages/EvaluationForm.jsx - Dashboard views
frontend/src/pages/Dashboard.jsx - Reports
frontend/src/pages/Reports.jsx - Account management
frontend/src/pages/AdminAccounts.jsx - HTTP API client
frontend/src/services/api.js
Identity and accounts
- Auth service
frontend/src/services/authService.js - Auth routes
backend/routes/authRoutes.js - JWT and role checks
backend/middleware/auth.js - Account workflows
backend/controllers/authController.js - Email delivery
backend/config/email.js
Evaluation and insights
- Evaluation service
frontend/src/services/evaluationService.js - Dashboard service
frontend/src/services/dashboardService.js - Evaluation routes
backend/routes/evaluationRoutes.js - Evaluation workflows
backend/controllers/evaluationController.js - Dashboard aggregation
backend/controllers/dashboardController.js - Sentiment analysis
backend/utils/sentimentAnalyzer.js - Feedback privacy
backend/utils/privacy.js
Backend data
- MySQL database
backend/config/db.js - Evaluation records
backend/models/Evaluation.js - Question responses
backend/models/EvaluationResponse.js - Evaluation questions
backend/models/EvaluationQuestion.js - Faculty records
backend/models/Faculty.js - Student records
backend/models/Student.js - User records
backend/models/User.js - Subjects
backend/models/Subject.js
Other components
- Students, faculty, admins
Connections 41
- Students, faculty, admins → Route and page shell: use
frontend/src/App.jsx - Route and page shell → Auth context: provides auth
frontend/src/App.jsx - Route and page shell → Evaluation form: routes to
frontend/src/App.jsx - Route and page shell → Dashboard views: routes to
frontend/src/App.jsx - Route and page shell → Reports: routes to
frontend/src/App.jsx - Route and page shell → Account management: routes to
frontend/src/App.jsx - Auth context → Auth service: calls
frontend/src/context/AuthContext.jsx - Auth hook → Auth context: reads
frontend/src/hooks/useAuth.js - Evaluation form → Auth hook: reads user
frontend/src/pages/EvaluationForm.jsx - Evaluation form → Evaluation service: requests evaluation
frontend/src/pages/EvaluationForm.jsx - Dashboard views → Auth hook: reads user
frontend/src/pages/Dashboard.jsx - Dashboard views → Dashboard service: requests stats
frontend/src/pages/Dashboard.jsx - Dashboard views → Evaluation service: requests evaluations
frontend/src/pages/Dashboard.jsx - Reports → Evaluation service: requests reports
frontend/src/pages/Reports.jsx - Auth service → HTTP API client: uses
frontend/src/services/authService.js - Evaluation service → HTTP API client: uses
frontend/src/services/evaluationService.js - Auth routes → JWT and role checks: applies
backend/routes/authRoutes.js - Auth routes → Account workflows: dispatches
backend/routes/authRoutes.js - Account workflows → User records: reads and updates
backend/controllers/authController.js - Account workflows → Faculty records: assigns subjects
backend/controllers/authController.js - Account workflows → Student records: assigns subjects
backend/controllers/authController.js - Account workflows → Email delivery: sends messages
backend/controllers/authController.js - Evaluation routes → JWT and role checks: applies
backend/routes/evaluationRoutes.js - Evaluation routes → Evaluation workflows: dispatches
backend/routes/evaluationRoutes.js - Evaluation workflows → Evaluation records: creates and reads
backend/controllers/evaluationController.js - Evaluation workflows → Question responses: stores responses
backend/controllers/evaluationController.js - Evaluation workflows → Evaluation questions: loads questions
backend/controllers/evaluationController.js - Evaluation workflows → Faculty records: looks up faculty
backend/controllers/evaluationController.js - Evaluation workflows → Student records: loads student
backend/controllers/evaluationController.js - Evaluation workflows → Sentiment analysis: analyzes feedback
backend/controllers/evaluationController.js - Evaluation workflows → Feedback privacy: protects identity
backend/controllers/evaluationController.js - Dashboard aggregation → Evaluation records: aggregates evaluations
backend/controllers/dashboardController.js - Dashboard aggregation → Faculty records: counts faculty
backend/controllers/dashboardController.js - Dashboard aggregation → Student records: counts students
backend/controllers/dashboardController.js - Evaluation records → MySQL database: queries
backend/models/Evaluation.js - Question responses → MySQL database: queries
backend/models/EvaluationResponse.js - Evaluation questions → MySQL database: queries
backend/models/EvaluationQuestion.js - Faculty records → MySQL database: queries
backend/models/Faculty.js - Student records → MySQL database: queries
backend/models/Student.js - User records → MySQL database: queries
backend/models/User.js - Subjects → MySQL database: queries
backend/models/Subject.js