How sivakrishna916/pathforge works
PathForge is a career-discovery product for Indian youth. Users register by education/life-stage segment, take a behavioral quiz, receive trait-based career clusters, and explore real journeys; they can save or upvote stories and submit their own. Admins moderate submissions and view platform and segment analytics. The graph follows the documented workflow and sampled calls; some route wiring and admin analytics implementation are not shown, so those links are left unasserted.
Main entry points: App.jsx App routing · api.js API client · quizController.js Quiz handling · storyController.js Story operations
Components 29
User experience
- App routing
client/src/App.jsx - Home and stage
client/src/pages/Home.jsx - User dashboard
client/src/pages/Dashboard.jsx
Identity
- Login and register
client/src/pages/Login.jsx - Auth state
client/src/context/AuthContext.jsx - User records
server/src/models/User.js - Authentication handlers
server/src/controllers/authController.js - JWT protection
server/src/middleware/authMiddleware.js
Career assessment
- Quiz experience
client/src/pages/Quiz.jsx - Quiz handling
server/src/controllers/quizController.js - Quiz questions
server/src/models/Question.js - Trait scoring
server/src/services/scoringService.js - Career insight
server/src/services/geminiService.js - Quiz results
server/src/models/QuizResult.js
Journey stories
- Story feed
client/src/pages/Stories.jsx - Story detail
client/src/pages/StoryDetail.jsx - Story submission
client/src/pages/Submit.jsx - Story operations
server/src/controllers/storyController.js - Ranked feed pipeline
server/src/utils/aggregations.js - Stories
server/src/models/Story.js
Administration
- Admin console
client/src/pages/Admin.jsx - Moderation and analytics
server/src/controllers/adminController.js
Backend platform
- API client
client/src/services/api.js - Express API
server/server.js - Database connection
server/src/config/db.js
Other components
- Student or visitor
- Administrator
- MongoDB
- Gemini service
Connections 38
- Student or visitor → App routing: uses
README.md - Administrator → App routing: uses
README.md - App routing → Home and stage: routes to
client/src/App.jsx - App routing → Login and register: routes to
client/src/App.jsx - App routing → Quiz experience: routes to
client/src/App.jsx - App routing → Story feed: routes to
client/src/App.jsx - App routing → Story detail: routes to
client/src/App.jsx - App routing → Story submission: routes to
client/src/App.jsx - App routing → User dashboard: protects route
client/src/App.jsx - App routing → Admin console: guards route
client/src/App.jsx - Login and register → Auth state: updates session
client/src/pages/Login.jsx - Auth state → API client: restores session
client/src/context/AuthContext.jsx - Login and register → API client: calls auth API
client/src/pages/Login.jsx - API client → Express API: sends requests
README.md - Express API → Database connection: connects through
server/server.js - Database connection → MongoDB: connects to
- Express API → Authentication handlers: mounts auth routes
server/server.js - Authentication handlers → User records: reads and writes
server/src/controllers/authController.js - Express API → Quiz handling: mounts quiz routes
server/server.js - Quiz handling → Quiz questions: loads questions
server/src/controllers/quizController.js - Quiz handling → Trait scoring: computes scores
server/src/controllers/quizController.js - Quiz handling → Career insight: requests insight
server/src/controllers/quizController.js - Career insight → Gemini service: requests generation
- Quiz handling → Quiz results: stores results
server/src/controllers/quizController.js - Quiz experience → API client: submits answers
client/src/pages/Quiz.jsx - Quiz experience → Trait scoring: receives recommendations
README.md - Story feed → API client: loads feed
client/src/pages/Stories.jsx - Story detail → API client: loads story
client/src/pages/StoryDetail.jsx - Story submission → API client: submits journey
client/src/pages/Submit.jsx - Admin console → API client: requests admin data
client/src/pages/Admin.jsx - Express API → Story operations: mounts story routes
server/server.js - Story operations → Stories: reads and writes
server/src/controllers/storyController.js - Story operations → User records: updates user saves
server/src/controllers/storyController.js - Story operations → Ranked feed pipeline: builds ranked feed
server/src/controllers/storyController.js - Story operations → Moderation and analytics: handles moderation
- Moderation and analytics → Stories: reviews stories
- Moderation and analytics → User records: reports users
- User dashboard → API client: loads account data
client/src/pages/Dashboard.jsx