How ashamethedestroyer/engineers-mathematical-guide works
Mathware is a web-based mathematics learning guide for engineering learners, with a React frontend and NestJS API. The user-facing path is discovering courses, modules, lessons, learning tracks, and math equations; related backend resources expose CRUD endpoints for course content, ratings, and tags. Registration and profiles, plus an admin dashboard, are distinct product areas. The README describes the learning goal, while the sampled files chiefly establish routing and selected API calls; unsampled integrations and persistence details are therefore not asserted.
Main entry points: discover.routes.tsx Discovery routes · routes.tsx App routes · CoursePage.tsx Course page · useExtendedQuery.ts Query hook
Components 24
Learning frontend
- App routes
frontend/src/routes.tsx - Discovery routes
frontend/src/routes/discover.routes.tsx - Course page
frontend/src/pages/DiscoverPage/pages/CoursePage.tsx - Learning track page
frontend/src/pages/DiscoverPage/pages/LearningTrackPage.tsx - Lesson page
frontend/src/pages/DiscoverPage/pages/LessonPage.tsx - Equation pages
frontend/src/pages/DiscoverPage/pages/MathEquationsPage.tsx - Modules page
frontend/src/pages/DiscoverPage/pages/ModulesPage.tsx - Query hook
frontend/src/hooks/useExtendedQuery.ts - HTTP query layer
frontend/src/managers/HTTPManager.ts - Track listing
frontend/src/pages/DiscoverPage/pages/LearningTracksPage.tsx - Equation detail
frontend/src/pages/DiscoverPage/pages/MathEquationPage.tsx
Accounts and profiles
- Auth endpoints
backend/src/auth/auth.controller.ts - Authentication
backend/src/auth/auth.service.ts - Login and signup DTOs
backend/src/auth/dto/signup.dto.ts - Mail service
backend/src/mailer/mailer.service.ts
Learning content API
- Course endpoints
backend/src/course/course.controller.ts - Course operations
backend/src/course/course.service.ts - Chapter endpoints
backend/src/chapter/chapter.controller.ts - Equation endpoints
backend/src/math-equation/math-equation.controller.ts - Question endpoints
backend/src/question/question.controller.ts
Learning interactions
- Rating endpoints
backend/src/course-rating/course-rating.controller.ts - Course-tag endpoints
backend/src/courses-tags/courses-tags.controller.ts - Enrollment endpoints
backend/src/user-enrolled-courses/user-enrolled-courses.controller.ts
Other components
- Learner
Connections 22
- Learner → App routes: opens app
frontend/src/routes.tsx - App routes → Discovery routes: composes routes
frontend/src/routes.tsx - Discovery routes → Course page: routes to
frontend/src/routes/discover.routes.tsx - Discovery routes → Learning track page: routes to
frontend/src/routes/discover.routes.tsx - Discovery routes → Lesson page: routes to
frontend/src/routes/discover.routes.tsx - Discovery routes → Equation pages: routes to
frontend/src/routes/discover.routes.tsx - Discovery routes → Modules page: routes to
frontend/src/routes/discover.routes.tsx - Discovery routes → Discovery routes: routes to
frontend/src/routes/discover.routes.tsx - Learner → Auth endpoints: registers or logs in
backend/src/auth/auth.controller.ts - Auth endpoints → Authentication: delegates to
backend/src/auth/auth.controller.ts - Authentication → Mail service: sends mail
backend/src/auth/auth.service.ts - Learner → Course endpoints: requests courses
backend/src/course/course.controller.ts - Course endpoints → Course operations: delegates to
backend/src/course/course.controller.ts - Learner → Chapter endpoints: requests chapters
backend/src/chapter/chapter.controller.ts - Learner → Equation endpoints: requests equations
backend/src/math-equation/math-equation.controller.ts - Learner → Question endpoints: requests questions
backend/src/question/question.controller.ts - Learner → Rating endpoints: rates courses
backend/src/course-rating/course-rating.controller.ts - Rating endpoints → Course operations: updates course rating
backend/src/course-rating/course-rating.controller.ts - Learner → Course-tag endpoints: manages course tags
backend/src/courses-tags/courses-tags.controller.ts - Learner → Enrollment endpoints: manages enrollment
backend/src/user-enrolled-courses/user-enrolled-courses.controller.ts - Course page → Query hook: loads data
- Query hook → HTTP query layer: requests data