How lawaggg/skillpath works
SkillPath is a web and Android-capable learning platform. Learners discover skills, generate a personalized roadmap, track topic progress, take phase quizzes, and request AI feedback or roadmap evaluation; admins manage platform content and users. The React app routes these workflows and calls a Laravel REST API, whose controllers coordinate domain models and AI services. README documents the broader product capabilities; several page and controller implementations were not sampled, so those branches are represented at their supported paths without asserting unverified internal calls.
Main entry points: api.php API routes · RoadmapController.php Roadmap workflow · QuizzController.php Quiz workflow · Roadmap.php Roadmap data
Components 30
React client
- App routes
sp-frontend/src/App.jsx - Learning pages
sp-frontend/src/pages - Admin pages
sp-frontend/src/pages/admin - API client
sp-frontend/src/api/api.js - Token utilities
sp-frontend/src/utils/uttils.jsx
Laravel API
- API routes
sp-backend/routes/api.php - Authentication
sp-backend/app/Http/Controllers/AuthController.php - Roadmap workflow
sp-backend/app/Http/Controllers/RoadmapController.php - Quiz workflow
sp-backend/app/Http/Controllers/QuizzController.php - AI feedback
sp-backend/app/Http/Controllers/AiFeedbackController.php - Topic progress
sp-backend/app/Http/Controllers/RoadmapTopicController.php - Skill catalog
sp-backend/app/Http/Controllers/SkillController.php - User management
sp-backend/app/Http/Controllers/UserController.php - Admin access
sp-backend/app/Http/Middleware/AdminMiddleware.php
Learning domain
- Roadmap data
sp-backend/app/Models/Roadmap.php - Phase data
sp-backend/app/Models/RoadmapPhase.php - Topic and resources
sp-backend/app/Models/RoadmapTopic.php - Skill catalog data
sp-backend/app/Models/Skill.php - Quiz data
sp-backend/app/Models/Quizz.php - Quiz questions
sp-backend/app/Models/QuizzQuestion.php - Quiz answers
sp-backend/app/Models/QuizzAnswer.php - Feedback records
sp-backend/app/Models/AiFeedback.php - Topic resources
sp-backend/app/Models/TopicResource.php
AI services
- Gemini workflows
sp-backend/app/Services/GeminiService.php - Resource enrichment
sp-backend/app/Services/TavilyService.php
Other components
- Learner
- Administrator
- Google Gemini
- Tavily search
- SQL database
Connections 40
- Learner → App routes: uses
sp-frontend/src/App.jsx - Administrator → App routes: uses
sp-frontend/src/App.jsx - App routes → Learning pages: routes to
sp-frontend/src/App.jsx - App routes → Admin pages: routes to
sp-frontend/src/App.jsx - Learning pages → API client: calls
sp-frontend/src/pages/admin/SkillManage.jsx - Admin pages → API client: calls
sp-frontend/src/pages/admin/SkillManage.jsx - API client → Token utilities: uses
sp-frontend/src/api/api.js - API client → API routes: HTTP requests
README.md - API routes → Authentication: routes to
sp-backend/routes/api.php - API routes → Roadmap workflow: routes to
sp-backend/routes/api.php - API routes → Quiz workflow: routes to
sp-backend/routes/api.php - API routes → AI feedback: routes to
sp-backend/routes/api.php - API routes → Topic progress: routes to
sp-backend/routes/api.php - API routes → Skill catalog: routes to
sp-backend/routes/api.php - API routes → User management: routes to
sp-backend/routes/api.php - API routes → Admin access: protects
sp-backend/routes/api.php - Roadmap workflow → Gemini workflows: generates and evaluates
sp-backend/app/Http/Controllers/RoadmapController.php - Roadmap workflow → Roadmap data: reads and writes
sp-backend/app/Http/Controllers/RoadmapController.php - Roadmap workflow → Phase data: loads roadmap phases
sp-backend/app/Http/Controllers/RoadmapController.php - Roadmap workflow → Topic and resources: loads topic details
sp-backend/app/Http/Controllers/RoadmapController.php - Roadmap workflow → Skill catalog data: validates skill
sp-backend/app/Http/Controllers/RoadmapController.php - Quiz workflow → Gemini workflows: generates and scores
sp-backend/app/Http/Controllers/QuizzController.php - Quiz workflow → Phase data: checks phase progress
sp-backend/app/Http/Controllers/QuizzController.php - Quiz workflow → Quiz data: reads and writes
sp-backend/app/Http/Controllers/QuizzController.php - Quiz workflow → Quiz questions: loads questions
sp-backend/app/Http/Controllers/QuizzController.php - AI feedback → Gemini workflows: requests feedback
sp-backend/app/Http/Controllers/AiFeedbackController.php - AI feedback → Roadmap data: loads roadmap
sp-backend/app/Http/Controllers/AiFeedbackController.php - AI feedback → Feedback records: saves feedback
sp-backend/app/Http/Controllers/AiFeedbackController.php - Skill catalog → Skill catalog data: manages skills
sp-backend/app/Http/Controllers/SkillController.php - User management → Roadmap data: reads roadmaps
sp-backend/app/Http/Controllers/UserController.php - Gemini workflows → Google Gemini: calls
sp-backend/app/Services/GeminiService.php - Gemini workflows → Resource enrichment: enriches resources
sp-backend/app/Services/GeminiService.php - Resource enrichment → Tavily search: searches
- Roadmap data → Phase data: has many
sp-backend/app/Models/Roadmap.php - Phase data → Topic and resources: has many
sp-backend/app/Models/RoadmapPhase.php - Topic and resources → Topic resources: has resources
sp-backend/app/Models/RoadmapTopic.php - Phase data → Quiz data: has quizzes
sp-backend/app/Models/RoadmapPhase.php - Quiz data → Quiz questions: has questions
sp-backend/app/Models/Quizz.php - Quiz data → Quiz answers: has answers
sp-backend/app/Models/Quizz.php - Roadmap data → SQL database: persists through ORM
README.md