How skillspan/back-end works
SkillSpan is a Laravel API for learner skills-readiness and organization participation. The principal learner workflow is account verification, profile and skill assessment, then career-role readiness calculation and result retrieval. Organizations register with proof for admin review. The tree also identifies project matching, assistant/conversation, intelligence, mentoring, and notification capabilities. Some service implementations and routes were not sampled, so those subsystems are shown without speculative internal call chains.
Main entry points: api.php API routes · AuthService.php Authentication service · ReadinessService.php Readiness calculation · BaselineItemsController.php Baseline item feed
Components 28
Accounts and access
- Authentication API
app/Http/Controllers/Api/AuthController.php - Authentication service
app/Services/AuthService.php - Organization review
app/Http/Controllers/Api/Admin/OrganizationController.php - Account records
app/Models - Admin review panel
app/Http/Controllers/Web/AdminAuthController.php
Skills and readiness
- Baseline assessment API
app/Http/Controllers/Api/BaselineAssessmentController.php - Baseline assessment
app/Services/Baseline/BaselineAssessmentService.php - Baseline item feed
app/Http/Controllers/Api/Internal/BaselineItemsController.php - Readiness API
app/Http/Controllers/Api/ReadinessController.php - Readiness calculation
app/Services/Readiness/ReadinessService.php - Skill match API
app/Http/Controllers/Api/SkillMatchController.php - Skill match algorithm
app/Services/Readiness/SkillMatchService.php - Learning records
app/Models
Projects and careers
- Career roles API
app/Http/Controllers/Api/CareerRoleController.php - Project matching API
app/Http/Controllers/Api/ProjectMatchingController.php - Project matching
app/Services/Projects/ProjectMatchingService.php - Career and project records
app/Models
Guidance and collaboration
- Assistant API
app/Http/Controllers/Api/AssistantController.php - Assistant service
app/Services/Assistant/AssistantService.php - Conversation API
app/Http/Controllers/Api/ConversationController.php - Mentor connections API
app/Http/Controllers/Api/MentorStudentController.php - Engagement records
app/Models
Shared platform
- API routes
routes/api.php
Other components
- Learner
- Organization
- Administrator
- Email service
- FastAPI service
Connections 33
- Learner → API routes: sends API requests
- Organization → API routes: sends API requests
- Administrator → API routes: reviews organizations
- API routes → Authentication API: routes authentication
- Authentication API → Authentication service: delegates account actions
- Authentication service → Account records: reads and writes
- Authentication service → Email service: sends verification
- API routes → Baseline assessment API: routes assessment requests
- Baseline assessment API → Baseline assessment: handles assessment
- Baseline assessment → Learning records: stores assessment data
- API routes → Readiness API: routes calculation requests
- Readiness API → Readiness calculation: requests calculation
- Readiness calculation → FastAPI service: requests readiness calculation
- Readiness calculation → Learning records: persists results
- API routes → Skill match API: routes skill-match requests
- Skill match API → Skill match algorithm: calculates match score
- API routes → Baseline item feed: routes internal item requests
- Baseline item feed → Learning records: reads assessment items
- FastAPI service → Baseline item feed: fetches assessment items
- API routes → Career roles API: routes career requests
- Career roles API → Career and project records: reads career roles
- API routes → Project matching API: routes project requests
- Project matching API → Project matching: requests matching
- Project matching → Career and project records: reads project records
- API routes → Assistant API: routes assistant requests
- Assistant API → Assistant service: requests assistance
- API routes → Conversation API: routes conversation requests
- Conversation API → Engagement records: manages conversations
- API routes → Mentor connections API: routes mentor requests
- Mentor connections API → Engagement records: manages connections
- Administrator → Admin review panel: signs into review panel
- Organization review → Account records: updates organization records
- Organization review → Email service: sends review notices