How kobevlm/pamana works
PAMANA is a gamified Filipino-learning web app: learners follow the Pamana Trail through syllable, vocabulary, and sentence activities, while parents review progress and reports. The graph combines README-described product capabilities with backend relationships visible in the supplied source index and excerpts. Frontend-to-backend request wiring and several controllers were not sampled, so those connections are shown only where the README supports the capability, not as detailed call chains.
Main entry points: ModuleLockService.java Module progression · ModuleProgress.java Module progress · TrailMapPage.tsx Pamana Trail · modules Module activities
Components 18
Learner experience
- Pamana Trail
frontend/src/pages/trail/TrailMapPage.tsx - Module activities
frontend/src/pages/modules - Practice games
frontend/src/pages/mastery - Game audio
frontend/src/contexts/AudioContext.tsx
Identity and access
- Sign-in screens
frontend/src/pages/auth - Account service
backend/src/main/java/com/pamana/auth/AuthService.java - JWT security
backend/src/main/java/com/pamana/security
Learning services
- Syllable learning
backend/src/main/java/com/pamana/syllable/SyllableService.java - Vocabulary learning
backend/src/main/java/com/pamana/vocabulary/VocabularyService.java - Sentence learning
backend/src/main/java/com/pamana/sentence/SentenceService.java - Module progression
backend/src/main/java/com/pamana/progress/ModuleLockService.java - Module progress
backend/src/main/java/com/pamana/progress/ModuleProgress.java
Parent insights
- Progress analytics
backend/src/main/java/com/pamana/progress/ProgressService.java - PDF reports
backend/src/main/java/com/pamana/parent/ReportService.java - Session tracking
backend/src/main/java/com/pamana/parent/SessionLogService.java
Other components
- Learner
- Parent
- PostgreSQL
Connections 21
- Learner → Sign-in screens: signs in
- Sign-in screens → Account service: uses account API
- Account service → JWT security: issues tokens
backend/src/main/java/com/pamana/auth/AuthService.java - Learner → Pamana Trail: explores trail
- Pamana Trail → Module activities: opens modules
- Module activities → Practice games: starts practice
- Practice games → Game audio: plays audio
- Learner → Syllable learning: learns syllables
- Learner → Vocabulary learning: learns vocabulary
- Learner → Sentence learning: builds sentences
- Syllable learning → Module progression: checks access
backend/src/main/java/com/pamana/syllable/SyllableService.java - Vocabulary learning → Module progression: unlocks next
backend/src/main/java/com/pamana/vocabulary/VocabularyService.java - Sentence learning → Module progression: checks access
backend/src/main/java/com/pamana/sentence/SentenceService.java - Module progression → Module progress: updates progress
backend/src/main/java/com/pamana/progress/ModuleLockService.java - Parent → Progress analytics: views analytics
- Parent → PDF reports: requests report
- Parent → Session tracking: reviews sessions
- Progress analytics → Module progress: reads progress
backend/src/main/java/com/pamana/progress/ProgressService.java - PDF reports → Module progress: validates completion
backend/src/main/java/com/pamana/parent/ReportService.java - Session tracking → PostgreSQL: stores sessions
backend/src/main/java/com/pamana/parent/SessionLogService.java - Module progress → PostgreSQL: persists state