# pneum4/molip architecture

> Architecture diagram of the GitHub repository pneum4/molip, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-04-10). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pneum4/molip
- Repository: https://github.com/pneum4/molip

## Overview

1. This is a three-tier monorepo: a Vue/TypeScript frontend, a Spring Boot backend, and a separate Python AI service. The backend is the system of record for users, workspaces, courses, sessions, quizzes, reviews, and live-chat state. The AI service is a processing tier for speech, emotion, Q&A, and quiz generation.

2. The frontend is organized by role and workflow rather than by generic UI widgets. Major view areas are Common, Admin, Learner, and Trainer, with a separate Live session experience and a Review/Statistics area. Pinia stores hold the application state for courses, sessions, live room state, quiz state, workspace state, and user state, while composables such as recording/timer and utilities such as MediaPipe/gaze tracking support the real-time classroom UX.

3. The backend is a modular Spring Boot application with clear domain boundaries: member/auth, workspace management, course management, session/live-class management, quiz generation and scoring, chatting/Q&A, and post-class review/analytics. Each domain has its own controller, service, repository, entity, DTO, and exception set, so the architecture is a classic layered application with strong domain separation.

4. Authentication and request protection are cross-cutting concerns in the backend. JWT-based auth is wired through security/filter configuration, and the shared filter/config stack also includes logging, async execution, and global exception handling. Workspace membership and role checks are important because most major features are permissioned by workspace, trainer, or learner role.

5. The live class path is the most complex subsystem. The frontend’s live views connect to the backend for session control and to Janus/WebRTC for media transport. Backend classes under session/janus and WebSocket configuration indicate that signaling, JWT handshake validation, and live collaboration are mediated centrally, while the actual audio/video stream is handled by the WebRTC infrastructure.

6. Real-time interaction is split into multiple channels: WebSocket-based messaging for chat, Q&A, alerts, and analysis updates; gRPC streaming for low-latency AI calls; and WebRTC/Janus for the video room itself. In the backend, dedicated handlers and interceptors forward emotion, concentration, and voice data, then listeners persist or redistribute those signals to interested clients.

7. The AI service is a separate FastAPI application with its own gRPC server and generated protobuf contracts. Its servicers are divided by capability: speech-to-text, emotion analysis, Q&A over RAG, quiz generation, and connection testing. Supporting modules include model loading, ChromaDB access, and service-layer logic for retrieval-augmented responses and analysis inference.

8. The shared protobuf files in backend/src/main/proto and ai/protos define the contract between Java and Python services. That boundary is important: the backend orchestrates product behavior, while the AI service performs specialized computation and streams results back. This keeps the high-throughput AI workload isolated from the main business API.

9. Persistence is polyglot and role-specific. MySQL/JPA is used for core transactional entities such as members, workspaces, courses, sessions, quizzes, and chat records. MongoDB is used for analysis-style documents and timelines where flexible time-series aggregation matters. Redis supports low-latency session/cache use cases and ordered timeline retrieval, and the README indicates Redis Sentinel is used for HA in deployment.

10. Event-driven processing is a key internal pattern in the backend. Domain events such as emotion, concentration, STT, and Q&A saves are published and handled asynchronously, then aggregated for review dashboards or pushed to Redis/Kafka as needed. The session and review services are therefore decoupled from the raw live-input flow.

11. The review subsystem turns raw session telemetry into learner-facing and trainer-facing reports. It combines STT transcripts, emotion graphs, concentration timelines, AI-generated quiz artifacts, and session statistics. This subsystem reads from both transactional storage and analytical storage, then exposes summary endpoints for charts and review pages.

12. Course, quiz, and workspace management form the B2B LMS core. Workspaces control tenant boundaries and invite/join flows, courses manage enrollment and certification rules, and quizzes handle exit quizzes plus AI-generated “surprise” or review questions. The automatic certification logic is driven by attendance, concentration, and quiz score data collected from live sessions.

13. Deployment is designed as an integrated multi-service stack. The repo includes Dockerfiles, docker-compose, Nginx, Jenkins, and EC2-oriented artifacts, which suggests a single deployed platform composed of frontend, Spring Boot backend, FastAPI AI, Redis/Sentinel, MongoDB, Kafka, and Janus/WebRTC services behind a unified domain.

14. For an architecture diagram, the main boundaries to draw are: client UI, backend business API, live media infrastructure, AI processing service, and data stores/streaming infrastructure. The most important flows are: user actions from frontend to backend, live session media through Janus, analysis signals from session to AI and back via gRPC/WebSocket, and persisted analytics flowing into review dashboards and certification logic.

Main entry points: [`backend/src/main/java/com/edumax/molip/domain/session/controller/SessionController.java`](https://github.com/pneum4/molip/blob/master/backend/src/main/java/com/edumax/molip/domain/session/controller/SessionController.java) (Session/live class), [`ai/app/grpc/server.py`](https://github.com/pneum4/molip/blob/master/ai/app/grpc/server.py) (gRPC server), [`frontend/src/components/Live/Console/LiveVideoConsole.vue`](https://github.com/pneum4/molip/blob/master/frontend/src/components/Live/Console/LiveVideoConsole.vue) (Live UX), [`frontend/src/views/Learner/LearnerLiveSessionView.vue`](https://github.com/pneum4/molip/blob/master/frontend/src/views/Learner/LearnerLiveSessionView.vue) (Learner area)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend"]
  node_frontend_shell["App shell<br/>Vue entry/router<br/>[main.ts]"]
  node_frontend_common["Common UI<br/>shared views<br/>[LandingPage.vue]"]
  node_frontend_admin["Admin area<br/>admin workflow"]
  node_frontend_learner["Learner area<br/>learner workflow"]
  node_frontend_trainer["Trainer area<br/>trainer workflow"]
  node_frontend_live["Live UX<br/>realtime session UI"]
  node_frontend_state["Pinia state<br/>client state<br/>[live.ts]"]
  node_frontend_rt["Realtime utils<br/>client realtime support<br/>[mediapipe.ts]"]
end

subgraph group_backend["Backend"]
  node_backend_entry["Spring app<br/>boot entry"]
  node_backend_security["Security stack<br/>cross-cutting config"]
  node_backend_workspace["Workspace domain<br/>tenant management"]
  node_backend_member["Member auth<br/>identity domain"]
  node_backend_course["Course domain<br/>lms core"]
  node_backend_session["Session/live class<br/>live-class domain"]
  node_backend_quiz["Quiz domain<br/>assessment domain"]
  node_backend_chat["Chat/Q&A<br/>collaboration domain"]
  node_backend_review["Review analytics<br/>analytics domain"]
end

subgraph group_ai["AI Service"]
  node_ai_grpc["gRPC server<br/>AI transport<br/>[server.py]"]
  node_ai_speech["Speech/STT<br/>AI capability<br/>[stt_servicer.py]"]
  node_ai_emotion["Emotion<br/>AI capability"]
  node_ai_qna["Q&A RAG<br/>AI capability<br/>[qna_servicer.py]"]
  node_ai_quiz["Quiz gen<br/>AI capability<br/>[quiz_servicer.py]"]
end

subgraph group_infra["Data & Infra"]
  node_infra_mysql[("MySQL/JPA<br/>transactional store<br/>[DDL.sql]")]
  node_infra_mongo[("MongoDB<br/>analytics store<br/>[MongoConfig.java]")]
  node_infra_redis[("Redis/Sentinel<br/>cache/timeline store<br/>[RedisConfig.java]")]
  node_infra_kafka["Kafka<br/>event bus<br/>[KafkaConfig.java]"]
  node_infra_webrtc{{"Janus/WebRTC<br/>media infra"}}
  node_shared_proto["Proto contracts<br/>service contract<br/>[stt.proto]"]
end

node_frontend_shell -->|"routes to"| node_frontend_common
node_frontend_shell -->|"routes to"| node_frontend_admin
node_frontend_shell -->|"routes to"| node_frontend_learner
node_frontend_shell -->|"routes to"| node_frontend_trainer
node_frontend_learner -->|"uses"| node_frontend_live
node_frontend_trainer -->|"uses"| node_frontend_live
node_frontend_live -->|"reads/writes"| node_frontend_state
node_frontend_learner -->|"reads/writes"| node_frontend_state
node_frontend_trainer -->|"reads/writes"| node_frontend_state
node_frontend_live -->|"supports"| node_frontend_rt
node_frontend_live -->|"calls"| node_backend_session
node_frontend_common -->|"calls"| node_backend_member
node_frontend_common -->|"calls"| node_backend_workspace
node_frontend_learner -->|"calls"| node_backend_course
node_frontend_trainer -->|"calls"| node_backend_course
node_frontend_learner -->|"calls"| node_backend_review
node_frontend_trainer -->|"calls"| node_backend_review
node_backend_entry -->|"wires"| node_backend_security
node_backend_security -->|"protects"| node_backend_member
node_backend_security -->|"protects"| node_backend_workspace
node_backend_workspace -->|"authorizes"| node_backend_course
node_backend_course -->|"coordinates"| node_backend_session
node_backend_session -->|"publishes"| node_backend_chat
node_backend_session -->|"feeds"| node_backend_quiz
node_backend_session -->|"emits"| node_backend_review
node_backend_chat -->|"events"| node_infra_kafka
node_backend_session -->|"caches"| node_infra_redis
node_backend_review -->|"reads"| node_infra_mongo
node_backend_review -->|"reads"| node_infra_mysql
node_backend_course -->|"persists"| node_infra_mysql
node_backend_session -->|"persists"| node_infra_mysql
node_backend_quiz -->|"persists"| node_infra_mysql
node_backend_session -->|"signs"| node_infra_webrtc
node_backend_session -->|"contracts"| node_shared_proto
node_ai_grpc -->|"implements"| node_shared_proto
node_ai_grpc -->|"serves"| node_ai_speech
node_ai_grpc -->|"serves"| node_ai_emotion
node_ai_grpc -->|"serves"| node_ai_qna
node_ai_grpc -->|"serves"| node_ai_quiz
node_backend_session -->|"streams to"| node_ai_grpc
node_backend_quiz -->|"streams to"| node_ai_grpc
node_frontend_live -->|"connects to"| node_infra_webrtc

click node_frontend_shell "https://github.com/pneum4/molip/blob/master/frontend/src/main.ts"
click node_frontend_common "https://github.com/pneum4/molip/blob/master/frontend/src/views/Common/LandingPage.vue"
click node_frontend_admin "https://github.com/pneum4/molip/blob/master/frontend/src/views/Admin/AdminWorkspaceView.vue"
click node_frontend_learner "https://github.com/pneum4/molip/blob/master/frontend/src/views/Learner/LearnerLiveSessionView.vue"
click node_frontend_trainer "https://github.com/pneum4/molip/blob/master/frontend/src/views/Trainer/TrainerLiveSessionView.vue"
click node_frontend_live "https://github.com/pneum4/molip/blob/master/frontend/src/components/Live/Console/LiveVideoConsole.vue"
click node_frontend_state "https://github.com/pneum4/molip/blob/master/frontend/src/stores/live.ts"
click node_frontend_rt "https://github.com/pneum4/molip/blob/master/frontend/src/utils/mediapipe.ts"
click node_backend_entry "https://github.com/pneum4/molip/blob/master/backend/src/main/java/com/edumax/molip/MolipApplication.java"
click node_backend_security "https://github.com/pneum4/molip/blob/master/backend/src/main/java/com/edumax/molip/common/config/SecurityConfig.java"
click node_backend_workspace "https://github.com/pneum4/molip/blob/master/backend/src/main/java/com/edumax/molip/domain/workspace/controller/WorkspaceController.java"
click node_backend_member "https://github.com/pneum4/molip/blob/master/backend/src/main/java/com/edumax/molip/domain/member/controller/AuthController.java"
click node_backend_course "https://github.com/pneum4/molip/blob/master/backend/src/main/java/com/edumax/molip/domain/course/controller/CourseController.java"
click node_backend_session "https://github.com/pneum4/molip/blob/master/backend/src/main/java/com/edumax/molip/domain/session/controller/SessionController.java"
click node_backend_quiz "https://github.com/pneum4/molip/blob/master/backend/src/main/java/com/edumax/molip/domain/quiz/controller/QuizController.java"
click node_backend_chat "https://github.com/pneum4/molip/blob/master/backend/src/main/java/com/edumax/molip/domain/chatting/controller/ChattingController.java"
click node_backend_review "https://github.com/pneum4/molip/blob/master/backend/src/main/java/com/edumax/molip/domain/review/controller/ReviewController.java"
click node_ai_grpc "https://github.com/pneum4/molip/blob/master/ai/app/grpc/server.py"
click node_ai_speech "https://github.com/pneum4/molip/blob/master/ai/app/grpc/servicers/stt_servicer.py"
click node_ai_emotion "https://github.com/pneum4/molip/blob/master/ai/app/grpc/servicers/emotion_servicer.py"
click node_ai_qna "https://github.com/pneum4/molip/blob/master/ai/app/grpc/servicers/qna_servicer.py"
click node_ai_quiz "https://github.com/pneum4/molip/blob/master/ai/app/grpc/servicers/quiz_servicer.py"
click node_infra_mysql "https://github.com/pneum4/molip/blob/master/backend/src/main/resources/database/DDL.sql"
click node_infra_mongo "https://github.com/pneum4/molip/blob/master/backend/src/main/java/com/edumax/molip/common/config/MongoConfig.java"
click node_infra_redis "https://github.com/pneum4/molip/blob/master/backend/src/main/java/com/edumax/molip/common/config/RedisConfig.java"
click node_infra_kafka "https://github.com/pneum4/molip/blob/master/backend/src/main/java/com/edumax/molip/common/config/KafkaConfig.java"
click node_infra_webrtc "https://github.com/pneum4/molip/blob/master/backend/src/main/java/com/edumax/molip/domain/session/janus/SessionJanusService.java"
click node_shared_proto "https://github.com/pneum4/molip/blob/master/backend/src/main/proto/stt.proto"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_frontend_shell,node_frontend_common,node_frontend_admin,node_frontend_learner,node_frontend_trainer,node_frontend_live,node_frontend_state,node_frontend_rt toneBlue
class node_backend_entry,node_backend_security,node_backend_workspace,node_backend_member,node_backend_course,node_backend_session,node_backend_quiz,node_backend_chat,node_backend_review toneAmber
class node_ai_grpc,node_ai_speech,node_ai_emotion,node_ai_qna,node_ai_quiz toneMint
class node_infra_mysql,node_infra_mongo,node_infra_redis,node_infra_kafka,node_infra_webrtc,node_shared_proto toneRose
```

## Components

### Frontend

Vue/TypeScript client organized by role and workflow

- [App shell](https://github.com/pneum4/molip/blob/master/frontend/src/main.ts): Vue entry/router · Bootstraps the SPA and route/layout composition · `frontend/src/main.ts`
- [Common UI](https://github.com/pneum4/molip/blob/master/frontend/src/views/Common/LandingPage.vue): shared views · Landing, login, workspace selection, and mypage flows · `frontend/src/views/Common/LandingPage.vue`
- [Admin area](https://github.com/pneum4/molip/blob/master/frontend/src/views/Admin/AdminWorkspaceView.vue): admin workflow · Workspace governance, join requests, and member management · `frontend/src/views/Admin/AdminWorkspaceView.vue`
- [Learner area](https://github.com/pneum4/molip/blob/master/frontend/src/views/Learner/LearnerLiveSessionView.vue): learner workflow · Learner courses, live class, review, statistics, and workspace views · `frontend/src/views/Learner/LearnerLiveSessionView.vue`
- [Trainer area](https://github.com/pneum4/molip/blob/master/frontend/src/views/Trainer/TrainerLiveSessionView.vue): trainer workflow · Trainer courses, live class, workspace, and statistics views · `frontend/src/views/Trainer/TrainerLiveSessionView.vue`
- [Live UX](https://github.com/pneum4/molip/blob/master/frontend/src/components/Live/Console/LiveVideoConsole.vue): realtime session UI · Live console, video area, chat, Q&A, quiz, and engagement controls · `frontend/src/components/Live/Console/LiveVideoConsole.vue`
- [Pinia state](https://github.com/pneum4/molip/blob/master/frontend/src/stores/live.ts): client state · Stores for member, workspace, course, session, quiz, live, and stats state · `frontend/src/stores/live.ts`
- [Realtime utils](https://github.com/pneum4/molip/blob/master/frontend/src/utils/mediapipe.ts): client realtime support · Recording, timer, MediaPipe, and gaze tracking helpers · `frontend/src/utils/mediapipe.ts`

### Backend

Spring Boot business API and real-time orchestration

- [Spring app](https://github.com/pneum4/molip/blob/master/backend/src/main/java/com/edumax/molip/MolipApplication.java): boot entry · Backend application bootstrap and module wiring · `backend/src/main/java/com/edumax/molip/MolipApplication.java`
- [Security stack](https://github.com/pneum4/molip/blob/master/backend/src/main/java/com/edumax/molip/common/config/SecurityConfig.java): cross-cutting config · JWT auth, security filters, logging, async, and exception handling · `backend/src/main/java/com/edumax/molip/common/config/SecurityConfig.java`
- [Workspace domain](https://github.com/pneum4/molip/blob/master/backend/src/main/java/com/edumax/molip/domain/workspace/controller/WorkspaceController.java): tenant management · Workspace, membership, roles, invites, and join flows · `backend/src/main/java/com/edumax/molip/domain/workspace/controller/WorkspaceController.java`
- [Member auth](https://github.com/pneum4/molip/blob/master/backend/src/main/java/com/edumax/molip/domain/member/controller/AuthController.java): identity domain · Login and member identity management · `backend/src/main/java/com/edumax/molip/domain/member/controller/AuthController.java`
- [Course domain](https://github.com/pneum4/molip/blob/master/backend/src/main/java/com/edumax/molip/domain/course/controller/CourseController.java): lms core · Course creation, enrollment, certification, and course stats · `backend/src/main/java/com/edumax/molip/domain/course/controller/CourseController.java`
- [Session/live class](https://github.com/pneum4/molip/blob/master/backend/src/main/java/com/edumax/molip/domain/session/controller/SessionController.java): live-class domain · Session control, Janus signaling, analysis events, and participant state · `backend/src/main/java/com/edumax/molip/domain/session/controller/SessionController.java`
- [Quiz domain](https://github.com/pneum4/molip/blob/master/backend/src/main/java/com/edumax/molip/domain/quiz/controller/QuizController.java): assessment domain · Exit quiz creation, scoring, and voice/STT event handling · `backend/src/main/java/com/edumax/molip/domain/quiz/controller/QuizController.java`
- [Chat/Q&A](https://github.com/pneum4/molip/blob/master/backend/src/main/java/com/edumax/molip/domain/chatting/controller/ChattingController.java): collaboration domain · Session chat, Q&A messages, and listeners for persisted message flow · `backend/src/main/java/com/edumax/molip/domain/chatting/controller/ChattingController.java`
- [Review analytics](https://github.com/pneum4/molip/blob/master/backend/src/main/java/com/edumax/molip/domain/review/controller/ReviewController.java): analytics domain · Aggregates transcripts, emotion, concentration, and quiz artifacts into reports · `backend/src/main/java/com/edumax/molip/domain/review/controller/ReviewController.java`

### AI Service

FastAPI gRPC processing tier for speech, emotion, and quiz generation

- [gRPC server](https://github.com/pneum4/molip/blob/master/ai/app/grpc/server.py): AI transport · FastAPI gRPC server exposing capability-specific servicers · `ai/app/grpc/server.py`
- [Speech/STT](https://github.com/pneum4/molip/blob/master/ai/app/grpc/servicers/stt_servicer.py): AI capability · Speech-to-text inference and voice analysis · `ai/app/grpc/servicers/stt_servicer.py`
- [Emotion](https://github.com/pneum4/molip/blob/master/ai/app/grpc/servicers/emotion_servicer.py): AI capability · Emotion and concentration inference for live signals · `ai/app/grpc/servicers/emotion_servicer.py`
- [Q&A RAG](https://github.com/pneum4/molip/blob/master/ai/app/grpc/servicers/qna_servicer.py): AI capability · Retrieval-augmented question answering for session and review contexts · `ai/app/grpc/servicers/qna_servicer.py`
- [Quiz gen](https://github.com/pneum4/molip/blob/master/ai/app/grpc/servicers/quiz_servicer.py): AI capability · Quiz generation and answer support · `ai/app/grpc/servicers/quiz_servicer.py`

### Data & Infra

Shared persistence, messaging, and live media infrastructure

- [MySQL/JPA](https://github.com/pneum4/molip/blob/master/backend/src/main/resources/database/DDL.sql): transactional store · Core records for members, workspaces, courses, sessions, quizzes, and chat · `backend/src/main/resources/database/DDL.sql`
- [MongoDB](https://github.com/pneum4/molip/blob/master/backend/src/main/java/com/edumax/molip/common/config/MongoConfig.java): analytics store · Flexible analysis documents and timelines · `backend/src/main/java/com/edumax/molip/common/config/MongoConfig.java`
- [Redis/Sentinel](https://github.com/pneum4/molip/blob/master/backend/src/main/java/com/edumax/molip/common/config/RedisConfig.java): cache/timeline store · Low-latency session cache and ordered timeline state with HA sentinel setup · `backend/src/main/java/com/edumax/molip/common/config/RedisConfig.java`
- [Kafka](https://github.com/pneum4/molip/blob/master/backend/src/main/java/com/edumax/molip/common/config/KafkaConfig.java): event bus · Asynchronous domain event distribution for live-input processing · `backend/src/main/java/com/edumax/molip/common/config/KafkaConfig.java`
- [Janus/WebRTC](https://github.com/pneum4/molip/blob/master/backend/src/main/java/com/edumax/molip/domain/session/janus/SessionJanusService.java): media infra · Video room and media transport for live sessions · `backend/src/main/java/com/edumax/molip/domain/session/janus/SessionJanusService.java`
- [Proto contracts](https://github.com/pneum4/molip/blob/master/backend/src/main/proto/stt.proto): service contract · Shared protobuf definitions between Java backend and Python AI service · `backend/src/main/proto/stt.proto`

## Connections

- App shell → Common UI: routes to · SPA routes render role/workflow views
- App shell → Admin area: routes to · Admin screens are mounted from the app shell
- App shell → Learner area: routes to · Learner workflows are routed through the shell
- App shell → Trainer area: routes to · Trainer workflows are routed through the shell
- Learner area → Live UX: uses · Learner live session experience embeds real-time UI
- Trainer area → Live UX: uses · Trainer live session experience embeds real-time UI
- Live UX → Pinia state: reads/writes · Live UI is driven by shared Pinia stores
- Learner area → Pinia state: reads/writes · Learner pages use course, session, quiz, and user state
- Trainer area → Pinia state: reads/writes · Trainer pages use course, session, and stats state
- Live UX → Realtime utils: supports · Recording, timer, and gaze utilities support live session UX
- Live UX → Session/live class: calls · Session control and live-state APIs
- Common UI → Member auth: calls · Login and member identity flows
- Common UI → Workspace domain: calls · Workspace discovery, join, and admin actions
- Learner area → Course domain: calls · Learner course and enrollment flows
- Trainer area → Course domain: calls · Trainer course management and stats
- Learner area → Review analytics: calls · Review and statistics views fetch analytics summaries
- Trainer area → Review analytics: calls · Trainer statistics and post-class review data
- Spring app → Security stack: wires · Application bootstrap enables security and cross-cutting config
- Security stack → Member auth: protects · JWT-authenticated member access
- Security stack → Workspace domain: protects · Workspace roles gate most features
- Workspace domain → Course domain: authorizes · Workspace membership and roles bound course operations
- Course domain → Session/live class: coordinates · Courses own sessions and certification inputs
- Session/live class → Chat/Q&A: publishes · Live session chat/Q&A channels are mediated centrally
- Session/live class → Quiz domain: feeds · Live signals support quiz and analysis flow
- Session/live class → Review analytics: emits · Session telemetry is aggregated into review data
- Chat/Q&A → Kafka: events · Message and analysis events are distributed asynchronously
- Session/live class → Redis/Sentinel: caches · Live state and ordered timeline data use Redis
- Review analytics → MongoDB: reads · Analytical timelines and documents are loaded for reports
- Review analytics → MySQL/JPA: reads · Persistent session, quiz, and course records are joined into summaries
- Course domain → MySQL/JPA: persists · Course, enrollment, certification, and workspace-linked transactional data
- Session/live class → MySQL/JPA: persists · Session and participant records are stored transactionally
- Quiz domain → MySQL/JPA: persists · Exit quiz definitions, answers, and results are stored transactionally
- Session/live class → Janus/WebRTC: signs · Janus handshake and live room signaling
- Session/live class → Proto contracts: contracts · Backend shares protobuf definitions with AI service
- gRPC server → Proto contracts: implements · Python servicers implement the shared protobuf contract
- gRPC server → Speech/STT: serves · Speech-to-text capability
- gRPC server → Emotion: serves · Emotion and concentration capability
- gRPC server → Q&A RAG: serves · RAG-based Q&A capability
- gRPC server → Quiz gen: serves · Quiz generation capability
- Session/live class → gRPC server: streams to · Low-latency analysis calls are sent over gRPC
- Quiz domain → gRPC server: streams to · Quiz generation requests are delegated to AI service
- Live UX → Janus/WebRTC: connects to · Client video transport uses Janus/WebRTC infrastructure
