How isaacmugwimi/futuristic-coders works
This repository provides a public education-program website, an admin dashboard, and a backend API. A user can browse programs and submit a staged child registration; administrators manage students, enrollments, payments, programs, and other records. Backend routes dispatch to controllers, which invoke services; sampled service references also show persistence models. The registration UI’s staged flow is visible, but the excerpts do not establish its complete request path to the backend, so that connection is left out.
Main entry points: dashboard Admin pages · routes API routes · student.controller.js Student controller · useProgramQueries.js Program queries
Components 26
Public Website
- Public pages
frontend/src/app - Program browsing
frontend/src/components/ProgramsPage - Program queries
frontend/src/hooks/programs/useProgramQueries.js - Program API client
frontend/src/services/programs/program.service.js - Registration wizard
frontend/src/app/register/RegisterClient.jsx
Admin Dashboard
- Admin pages
admin/src/app/dashboard - Program management
admin/src/components/programs/ProgramsPage/ProgramsPage.jsx - Student records
admin/src/components/StudentsPage/StudentsPage.jsx - Enrollment management
admin/src/components/Enrollment/EnrollmentsPage.jsx - Payment management
admin/src/components/Payments/PaymentsPage.jsx
Backend API
- API routes
backend/src/routes - Program controller
backend/src/controller/programs/program.controller.js - Program service
backend/src/services/programs/programs.service.js - Student controller
backend/src/controller/students/student.controller.js - Student services
backend/src/services/students/students.service.js - Blog controller
backend/src/controller/blogs/blog.controller.js - Blog service
backend/src/services/blogs/blogs.service.js - Authentication service
backend/src/services/auth/auth.service.js - Testimonials
backend/src/services/testimonials/testimonial.service.js - Certificate verification
backend/src/routes/students/students.routes.js
Persistence
- Program models
backend/src/database/models/programs/program.model.js - Student models
backend/src/database/models/students/student.model.js - Blog model
backend/src/database/models/blogs/blogs.model.js - User and token models
backend/src/database/models/users/user.model.js
Other components
- Website visitor
- Administrator
Connections 21
- Website visitor → Public pages: browses
- Public pages → Program browsing: renders
- Program browsing → Program queries: queries
- Program queries → Program API client: uses
frontend/src/hooks/programs/useProgramQueries.js - Registration wizard → Program queries: loads programs
frontend/src/app/register/RegisterClient.jsx - Administrator → Admin pages: manages records
- Admin pages → Program management: renders
- Admin pages → Student records: renders
- Admin pages → Enrollment management: renders
- Admin pages → Payment management: renders
- API routes → Program controller: dispatches
backend/src/routes/programs/program.routes.js - Program controller → Program service: calls
backend/src/controller/programs/program.controller.js - Program service → Program models: uses
backend/src/services/programs/programs.service.js - API routes → Student controller: dispatches
backend/src/routes/students/students.routes.js - Student controller → Student services: calls
backend/src/controller/students/student.controller.js - Student services → Student models: uses
backend/src/services/students/students.service.js - API routes → Blog controller: dispatches
backend/src/routes/blogs/blogs.routes.js - Blog controller → Blog service: calls
backend/src/controller/blogs/blog.controller.js - Blog service → Blog model: uses
backend/src/services/blogs/blogs.service.js - Authentication service → User and token models: reads and writes
backend/src/services/auth/auth.service.js - Student controller → Certificate verification: serves verification routes
backend/src/routes/students/students.routes.js