# qingtian1927/edutrack architecture

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

- Interactive diagram: https://gitdiagram.com/qingtian1927/edutrack
- Repository: https://github.com/qingtian1927/edutrack

## Overview

EduTrack is a 1-on-1 mentoring platform: mentees discover courses and mentors, enroll, and manage sessions; mentors manage offerings and schedule requests, while managers administer users and courses. The README describes a controller-service-repository architecture, but Java implementation excerpts were not provided, so those links are documented rather than source-verified. The repository also includes Runeterra, a Python chat assistant that uses an LLM and MySQL-backed recommendation tools; its request, agent, model, and tool flow is visible in the sampled files.

Main entry points: [`src/main/resources/templates`](https://github.com/qingtian1927/edutrack/tree/main/src/main/resources/templates) (Learning interface), [`python-src/runeterra/api.py`](https://github.com/qingtian1927/edutrack/blob/main/python-src/runeterra/api.py) (Chat API), [`python-src/runeterra/tools.py`](https://github.com/qingtian1927/edutrack/blob/main/python-src/runeterra/tools.py) (Recommendation tools), [`src/main/java/com/example/edutrack/curriculum`](https://github.com/qingtian1927/edutrack/tree/main/src/main/java/com/example/edutrack/curriculum) (Course discovery)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Platform workflows"]
  node_learner_ui["Learning interface"]
  node_mentor_ui["Mentor interface"]
  node_admin_ui["Admin interface"]
end

subgraph group_domain["Mentoring services"]
  node_curriculum["Course discovery"]
  node_applications["Applications"]
  node_scheduling["Session scheduling"]
  node_accounts["Accounts and roles"]
  node_authentication["Authentication"]
  node_feedback["Feedback"]
  node_transactions["Wallet and payments"]
end

subgraph group_persistence["Platform data"]
  node_mysql[("MySQL")]
end

subgraph group_assistant["Runeterra assistant"]
  node_chat_api["Chat API<br/>[api.py]"]
end

subgraph group_assistant_core["Assistant internals"]
  node_agent["Recommendation agent<br/>[agent.py]"]
  node_llm_factory["Model selection<br/>[models.py]"]
  node_config["Assistant config<br/>[config.py]"]
  node_toolset["Recommendation tools<br/>[tools.py]"]
  node_logging["Assistant logging<br/>[logging.py]"]
end

node_mentee(("Mentee"))
node_mentor(("Mentor"))
node_manager(("Manager"))
node_chat_user(("Chat client"))
node_llm_provider["LLM provider"]

node_mentee -->|"uses"| node_learner_ui
node_learner_ui -->|"discovers courses"| node_curriculum
node_learner_ui -->|"applies"| node_applications
node_learner_ui -->|"manages sessions"| node_scheduling
node_mentor -->|"uses"| node_mentor_ui
node_mentor_ui -->|"manages courses"| node_curriculum
node_mentor_ui -->|"reviews requests"| node_scheduling
node_manager -->|"uses"| node_admin_ui
node_admin_ui -->|"manages users"| node_accounts
node_admin_ui -->|"oversees courses"| node_curriculum
node_learner_ui -->|"registers and signs in"| node_authentication
node_curriculum -->|"persists course data"| node_mysql
node_applications -->|"persists applications"| node_mysql
node_scheduling -->|"persists schedules"| node_mysql
node_accounts -->|"persists accounts"| node_mysql
node_authentication -->|"reads account data"| node_mysql
node_feedback -->|"persists feedback"| node_mysql
node_transactions -.->|"persists transactions"| node_mysql
node_chat_user -->|"sends chat"| node_chat_api
node_chat_api -->|"calls ask"| node_agent
node_chat_api -->|"creates model"| node_llm_factory
node_chat_api -->|"binds tools"| node_toolset
node_llm_factory -->|"reads settings"| node_config
node_llm_factory -->|"constructs chat model"| node_llm_provider
node_agent -->|"dispatches calls"| node_toolset
node_toolset -->|"queries recommendations"| node_mysql
node_agent -->|"logs requests"| node_logging
node_toolset -->|"logs queries"| node_logging
node_chat_api -->|"logs API activity"| node_logging

click node_learner_ui "https://github.com/qingtian1927/edutrack/tree/main/src/main/resources/templates"
click node_mentor_ui "https://github.com/qingtian1927/edutrack/tree/main/src/main/resources/templates"
click node_admin_ui "https://github.com/qingtian1927/edutrack/tree/main/src/main/resources/templates"
click node_curriculum "https://github.com/qingtian1927/edutrack/tree/main/src/main/java/com/example/edutrack/curriculum"
click node_applications "https://github.com/qingtian1927/edutrack/tree/main/src/main/java/com/example/edutrack/profiles"
click node_scheduling "https://github.com/qingtian1927/edutrack/tree/main/src/main/java/com/example/edutrack/timetables"
click node_accounts "https://github.com/qingtian1927/edutrack/tree/main/src/main/java/com/example/edutrack/accounts"
click node_authentication "https://github.com/qingtian1927/edutrack/tree/main/src/main/java/com/example/edutrack/auth"
click node_feedback "https://github.com/qingtian1927/edutrack/tree/main/src/main/java/com/example/edutrack/curriculum"
click node_transactions "https://github.com/qingtian1927/edutrack/tree/main/src/main/java/com/example/edutrack/transactions"
click node_chat_api "https://github.com/qingtian1927/edutrack/blob/main/python-src/runeterra/api.py"
click node_agent "https://github.com/qingtian1927/edutrack/blob/main/python-src/runeterra/agent.py"
click node_llm_factory "https://github.com/qingtian1927/edutrack/blob/main/python-src/runeterra/models.py"
click node_config "https://github.com/qingtian1927/edutrack/blob/main/python-src/runeterra/config.py"
click node_toolset "https://github.com/qingtian1927/edutrack/blob/main/python-src/runeterra/tools.py"
click node_logging "https://github.com/qingtian1927/edutrack/blob/main/python-src/runeterra/logging.py"

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_learner_ui,node_mentor_ui,node_admin_ui,node_chat_user toneBlue
class node_curriculum,node_applications,node_scheduling,node_accounts,node_authentication,node_feedback,node_transactions toneAmber
class node_mysql toneMint
class node_chat_api toneRose
class node_agent,node_llm_factory,node_config,node_toolset,node_logging,node_mentee,node_mentor,node_manager,node_llm_provider toneIndigo
```

## Components

### Platform workflows

- [Learning interface](https://github.com/qingtian1927/edutrack/tree/main/src/main/resources/templates): `src/main/resources/templates`
- [Mentor interface](https://github.com/qingtian1927/edutrack/tree/main/src/main/resources/templates): `src/main/resources/templates`
- [Admin interface](https://github.com/qingtian1927/edutrack/tree/main/src/main/resources/templates): `src/main/resources/templates`

### Mentoring services

- [Course discovery](https://github.com/qingtian1927/edutrack/tree/main/src/main/java/com/example/edutrack/curriculum): `src/main/java/com/example/edutrack/curriculum`
- [Applications](https://github.com/qingtian1927/edutrack/tree/main/src/main/java/com/example/edutrack/profiles): `src/main/java/com/example/edutrack/profiles`
- [Session scheduling](https://github.com/qingtian1927/edutrack/tree/main/src/main/java/com/example/edutrack/timetables): `src/main/java/com/example/edutrack/timetables`
- [Accounts and roles](https://github.com/qingtian1927/edutrack/tree/main/src/main/java/com/example/edutrack/accounts): `src/main/java/com/example/edutrack/accounts`
- [Authentication](https://github.com/qingtian1927/edutrack/tree/main/src/main/java/com/example/edutrack/auth): `src/main/java/com/example/edutrack/auth`
- [Feedback](https://github.com/qingtian1927/edutrack/tree/main/src/main/java/com/example/edutrack/curriculum): `src/main/java/com/example/edutrack/curriculum`
- [Wallet and payments](https://github.com/qingtian1927/edutrack/tree/main/src/main/java/com/example/edutrack/transactions): `src/main/java/com/example/edutrack/transactions`

### Platform data

- **MySQL**

### Runeterra assistant

- [Chat API](https://github.com/qingtian1927/edutrack/blob/main/python-src/runeterra/api.py): `python-src/runeterra/api.py`

### Assistant internals

- [Recommendation agent](https://github.com/qingtian1927/edutrack/blob/main/python-src/runeterra/agent.py): `python-src/runeterra/agent.py`
- [Model selection](https://github.com/qingtian1927/edutrack/blob/main/python-src/runeterra/models.py): `python-src/runeterra/models.py`
- [Assistant config](https://github.com/qingtian1927/edutrack/blob/main/python-src/runeterra/config.py): `python-src/runeterra/config.py`
- [Recommendation tools](https://github.com/qingtian1927/edutrack/blob/main/python-src/runeterra/tools.py): `python-src/runeterra/tools.py`
- [Assistant logging](https://github.com/qingtian1927/edutrack/blob/main/python-src/runeterra/logging.py): `python-src/runeterra/logging.py`

### Other components

- **Mentee**
- **Mentor**
- **Manager**
- **Chat client**
- **LLM provider**

## Connections

- Mentee → Learning interface: uses (evidence: `README.md`)
- Learning interface → Course discovery: discovers courses (evidence: `README.md`)
- Learning interface → Applications: applies (evidence: `README.md`)
- Learning interface → Session scheduling: manages sessions (evidence: `README.md`)
- Mentor → Mentor interface: uses (evidence: `README.md`)
- Mentor interface → Course discovery: manages courses (evidence: `README.md`)
- Mentor interface → Session scheduling: reviews requests (evidence: `README.md`)
- Manager → Admin interface: uses (evidence: `README.md`)
- Admin interface → Accounts and roles: manages users (evidence: `README.md`)
- Admin interface → Course discovery: oversees courses (evidence: `README.md`)
- Learning interface → Authentication: registers and signs in (evidence: `README.md`)
- Course discovery → MySQL: persists course data (evidence: `README.md`)
- Applications → MySQL: persists applications (evidence: `README.md`)
- Session scheduling → MySQL: persists schedules (evidence: `README.md`)
- Accounts and roles → MySQL: persists accounts (evidence: `README.md`)
- Authentication → MySQL: reads account data (evidence: `README.md`)
- Feedback → MySQL: persists feedback (evidence: `README.md`)
- Wallet and payments → MySQL: persists transactions
- Chat client → Chat API: sends chat (evidence: `python-src/runeterra/api.py`)
- Chat API → Recommendation agent: calls ask (evidence: `python-src/runeterra/api.py`)
- Chat API → Model selection: creates model (evidence: `python-src/runeterra/api.py`)
- Chat API → Recommendation tools: binds tools (evidence: `python-src/runeterra/api.py`)
- Model selection → Assistant config: reads settings (evidence: `python-src/runeterra/models.py`)
- Model selection → LLM provider: constructs chat model (evidence: `python-src/runeterra/models.py`)
- Recommendation agent → Recommendation tools: dispatches calls (evidence: `python-src/runeterra/agent.py`)
- Recommendation tools → MySQL: queries recommendations (evidence: `python-src/runeterra/tools.py`)
- Recommendation agent → Assistant logging: logs requests (evidence: `python-src/runeterra/agent.py`)
- Recommendation tools → Assistant logging: logs queries (evidence: `python-src/runeterra/tools.py`)
- Chat API → Assistant logging: logs API activity (evidence: `python-src/runeterra/api.py`)
