How hcmuleva/els-ai works
ELS-AI is a multi-tenant learning platform: learners and educators use a React Native app to access learning activities, while backend services provide identity, learning data, media, and AI. The principal learning workflow spans content and classroom access, interactive quizzes, and learner reporting; teachers also review AI-assisted work. The AI service exposes generation jobs with validation, persistence, and streamed progress. The README documents Jev evaluation and conversational LLM support. Some subsystem internals are unsampled, so their links are shown only where the README or excerpts support them.
Main entry points: src/server.ts Core API · App.tsx React Native app · pipeline.ts Content generation · src/server.ts AI service
Components 20
Learning app
- React Native app
frontend/App.tsx - Interactive quiz engine
frontend/src/components/quiz - Learning screens
frontend/app/(tabs)
Learning platform
- Core API
backend/core-api/src/server.ts - Identity & tenancy
backend/core-api/src/services/auth - Learning data services
backend/core-api/src/services/content - Classrooms & assignments
backend/core-api/src/services/classroom - Questions & quizzes
backend/core-api/src/services/question-bank - Chat & review
backend/core-api/src/services/chat - Notifications
backend/core-api/src/services/notification
AI services
- AI service
backend/ai-service/src/server.ts - Content generation
backend/ai-service/src/generation/pipeline.ts - Type generators
backend/ai-service/src/generation/generators - Generation jobs
backend/ai-service/src/generation/jobStore.ts - LLM agent router
backend/ai-service/src/agents/router.ts - Jev evaluation client
backend/ai-service/src/services/jevClient.ts
Shared infrastructure
- Shared event bus
backend/shared/event-bus/src/index.ts
Media delivery
- Media service
backend/media-service/src/server.ts - AWS S3
Other components
- Learners & educators
Connections 17
- Learners & educators → React Native app: uses
README.md - React Native app → Core API: requests learning data
README.md - React Native app → AI service: requests AI services
README.md - React Native app → Interactive quiz engine: plays quizzes
README.md - Core API → Identity & tenancy: routes identity
backend/core-api/src/server.ts - Core API → Learning data services: routes content
backend/core-api/src/server.ts - Core API → Classrooms & assignments: routes classrooms
backend/core-api/src/server.ts - Core API → Questions & quizzes: routes questions
backend/core-api/src/server.ts - Core API → Chat & review: routes chat
README.md - Core API → Notifications: routes notifications
README.md - AI service → Content generation: routes generation
README.md - Content generation → Type generators: dispatches generation
backend/ai-service/src/generation/pipeline.ts - Content generation → Generation jobs: updates jobs
backend/ai-service/src/generation/pipeline.ts - Content generation → LLM agent router: uses model routing
README.md - AI service → Jev evaluation client: evaluates observations
README.md - Media service → AWS S3: stores assets
README.md - Learning data services → Shared event bus: publishes events
README.md