How chavesgabriel012-svg/edukemonos works
Eduka is an open, AI-assisted learning platform for Costa Rican public-school students. Its main learner journey is choosing a grade, subject, and unit, then learning, practicing, and optionally asking Kemo; diagnostics and saved progress support that journey. Separate educator workflows manage sections and inspect learning analytics, while reviewers approve generated content. The README also documents curriculum ingestion and AI content generation. Several routes and data-access details are unsampled, so undocumented links are omitted; README-backed links describe capabilities rather than implying inspected implementation.
Main entry points: route.ts Tutor endpoint · practice.tsx Practice · index.ts Tutor logic · client.ts AI client
Components 26
Student learning
- Study catalog
apps/web/src/app/(app)/estudiar/page.tsx - Unit workspace
apps/web/src/app/(app)/unidad/[id]/page.tsx - Practice
apps/web/src/app/(app)/unidad/[id]/practice.tsx - Diagnostic
apps/web/src/app/(app)/estudiar/[grado]/[materia]/diagnostico/page.tsx - Learning progress
apps/web/src/lib/learn.ts - Section joining
apps/web/src/app/(app)/unirme/page.tsx - Tutor endpoint
apps/web/src/app/api/tutor/route.ts
Educator workflows
- Teacher workspace
apps/web/src/app/(app)/docente/page.tsx - Section analytics
packages/curriculum/src/teacher.ts - Content review
apps/web/src/app/(app)/revisar/[id]/contenido/page.tsx - Review rules
apps/web/src/lib/content-review.ts
Curriculum and content
- Source ingestion
scripts/ingest/src/structure.ts - Content generation
scripts/ingest/src/content.ts - Learning items
packages/curriculum/src/items.ts - Learning model
packages/curriculum/src/learning.ts
AI services
- Tutor logic
packages/ai/src/tutor/index.ts - Tutor prompts
packages/ai/src/prompts/tutor.ts - Safety and output
packages/ai/src/tutor/safety.ts - AI client
packages/ai/src/client.ts - Anthropic adapter
packages/ai/src/providers/anthropic.ts - OpenAI adapter
packages/ai/src/providers/openai.ts
Other components
- Student
- Teacher or reviewer
- MEP sources
- Supabase
- AI providers
Connections 26
- Student → Study catalog: chooses study
README.md - Study catalog → Unit workspace: opens unit
README.md - Unit workspace → Practice: starts practice
README.md - Student → Diagnostic: takes diagnostic
README.md - Student → Section joining: joins section
README.md - Student → Tutor endpoint: asks tutor
README.md - Tutor endpoint → Supabase: reads and writes session
apps/web/src/app/api/tutor/route.ts - Tutor endpoint → Tutor logic: uses tutor functions
apps/web/src/app/api/tutor/route.ts - Tutor logic → Tutor prompts: builds prompts
packages/ai/src/tutor/index.ts - Tutor logic → Safety and output: uses safety note
packages/ai/src/tutor/index.ts - Tutor endpoint → AI client: streams AI response
apps/web/src/app/api/tutor/route.ts - AI client → Anthropic adapter: dispatches provider calls
packages/ai/src/client.ts - AI client → OpenAI adapter: dispatches provider calls
packages/ai/src/client.ts - Anthropic adapter → AI providers: sends model requests
- OpenAI adapter → AI providers: sends model requests
packages/ai/src/providers/openai.ts - Teacher or reviewer → Teacher workspace: manages classes
README.md - Teacher workspace → Section analytics: views analytics
README.md - Teacher or reviewer → Content review: reviews content
README.md - Content review → Review rules: applies review
- MEP sources → Source ingestion: provides programs
README.md - Source ingestion → Content generation: prepares curriculum
- Content generation → Learning items: creates study items
README.md - Practice → Supabase: submits attempts
README.md - Practice → Learning progress: updates learning progress
- Diagnostic → Learning items: uses verified items
README.md - Section analytics → Learning model: uses mastery thresholds
packages/curriculum/src/teacher.ts