How clyd-dev/bigkas-ai works
BIGKAS is a Laravel reading-assessment and intervention platform with a Python ML classifier. A teacher records a learner reading assigned material; the backend transcribes speech, compares it with the passage, classifies reading weaknesses, stores results, and supports targeted follow-up and progress tracking. Student practice and gamification, parent-teacher coordination, administration, and REST APIs are additional product branches. The workflow and ML calls are documented or visible in excerpts; several peripheral controllers and route-to-view connections are unsampled, so those links are not inferred.
Main entry points: AssessmentController.php Assessment Management · MLClassificationService.php ML Classification · Learner.php Learner · InterventionRecommenderService.php Intervention Recommendations
Components 24
Assessment Workflow
- Learner
app/Models/Learner.php - Reading Material
app/Models/ReadingMaterial.php - Assessment Management
app/Http/Controllers/AssessmentController.php - Assessment Records
app/Models/Assessment.php - Speech Transcription
app/Services/SpeechToTextService.php - Reading Analysis
app/Services/ReadingAnalyzerService.php - ML Classification
app/Services/MLClassificationService.php - Python ML API
ml-service/app.py - Reading Results
app/Models/AssessmentResult.php
Learning Support
- Intervention Recommendations
app/Services/InterventionRecommenderService.php - Intervention Library
app/Models/Intervention.php - Intervention Tracking
app/Models/InterventionLog.php - Student Practice
app/Http/Controllers/Student/StudentActivityController.php - Practice Sessions
app/Models/PracticeSession.php - Badges and XP
app/Services/BadgeService.php
Role Portals
- Teacher Portal
app/Http/Controllers/DashboardController.php - Parent Portal
app/Http/Controllers/Parent/ParentDashboardController.php - Family Messaging
app/Http/Controllers/Parent/ParentMessageController.php
Platform Services
- Users and Roles
app/Models/User.php - Administration
app/Http/Controllers/AdminController.php - Activity Logging
app/Models/ActivityLog.php - REST API
routes/api.php
Other components
- Teacher
- Web Browser
Connections 23
- Teacher → Assessment Management: records reading
- Assessment Management → Speech Transcription: transcribes audio
app/Http/Controllers/AssessmentController.php - Assessment Management → Reading Analysis: analyzes reading
app/Http/Controllers/AssessmentController.php - Reading Analysis → ML Classification: classifies weakness
app/Services/ReadingAnalyzerService.php - Assessment Management → ML Classification: classifies result
app/Http/Controllers/AssessmentController.php - ML Classification → Python ML API: requests prediction
- Assessment Management → Reading Material: uses passage
app/Http/Controllers/AssessmentController.php - Assessment Management → Learner: assesses learner
app/Http/Controllers/AssessmentController.php - Assessment Management → Assessment Records: creates assessment
app/Http/Controllers/AssessmentController.php - Assessment Management → Reading Results: stores analysis
- Intervention Recommendations → Intervention Library: selects activities
app/Services/InterventionRecommenderService.php - Intervention Recommendations → Intervention Tracking: checks outcomes
app/Services/InterventionRecommenderService.php - Student Practice → Practice Sessions: records practice
app/Http/Controllers/Student/StudentActivityController.php - Student Practice → Badges and XP: awards progress
app/Http/Controllers/Student/StudentActivityController.php - Teacher Portal → Learner: tracks learners
- Parent Portal → Learner: views progress
app/Http/Controllers/Parent/ParentDashboardController.php - Parent Portal → Assessment Records: reviews assessments
app/Http/Controllers/Parent/ParentDashboardController.php - Family Messaging → Users and Roles: notifies users
app/Http/Controllers/Parent/ParentMessageController.php - Family Messaging → Activity Logging: logs messages
app/Http/Controllers/Parent/ParentMessageController.php - Administration → Users and Roles: manages users
app/Http/Controllers/AdminController.php - Administration → Activity Logging: logs actions
app/Http/Controllers/AdminController.php - Web Browser → REST API: sends requests
- REST API → Assessment Management: routes assessment