# stevesomto/ai-agent-update- architecture

> Architecture diagram of the GitHub repository stevesomto/ai-agent-update-, 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/stevesomto/ai-agent-update-
- Repository: https://github.com/stevesomto/ai-agent-update-

## Overview

This is a browser-based collaborative robotics-learning prototype with student and lecturer portals. The student workflow presents tutoring and group-support conversations, learning checks, and group evaluation; lecturers inspect problem progress, activity, insights, evaluations, and resources. The implementation uses predefined mock data and keyword/rule-based responses, not a live AI service or backend. Relationships between sampled JavaScript modules are shown where their calls or shared data use is visible; page-to-script wiring is not shown because the HTML files were not sampled and the README provides no architecture details.

Main entry points: [`js/lecturer.js`](https://github.com/stevesomto/ai-agent-update-/blob/main/js/lecturer.js) (Portal views), [`js/ai-simulation.js`](https://github.com/stevesomto/ai-agent-update-/blob/main/js/ai-simulation.js) (Simulated AI services), [`js/student.js`](https://github.com/stevesomto/ai-agent-update-/blob/main/js/student.js) (Tutoring and support), [`js/data.js`](https://github.com/stevesomto/ai-agent-update-/blob/main/js/data.js) (Learning data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_student["Student learning"]
  node_student_page["Student portal<br/>[student.html]"]
  node_student_interactions["Tutoring and support<br/>[student.js]"]
  node_student_log_rendering["Log rendering<br/>[student.js]"]
  node_student_assessment["Learning checks<br/>[student.js]"]
  node_student_group_eval["Group evaluation<br/>[student.js]"]
end

subgraph group_lecturer["Lecturer oversight"]
  node_lecturer_page["Lecturer portal<br/>[lecturer.html]"]
  node_lecturer_views["Portal views<br/>[lecturer.js]"]
  node_lecturer_group_detail["Group detail<br/>[lecturer.js]"]
  node_lecturer_insights["Insights and resources<br/>[lecturer.js]"]
  node_lecturer_evaluations["Evaluations<br/>[lecturer.js]"]
end

subgraph group_shared["Mock data and services"]
  node_mock_domain_data["Learning data<br/>[data.js]"]
  node_mock_logs["Interaction logs<br/>[log-data.js]"]
  node_simulated_services["Simulated AI services<br/>[ai-simulation.js]"]
end

node_student_actor(("Student"))
node_lecturer_actor(("Lecturer"))

node_student_actor -.->|"uses"| node_student_page
node_student_page -.->|"loads"| node_student_interactions
node_lecturer_actor -.->|"uses"| node_lecturer_page
node_lecturer_page -.->|"loads"| node_lecturer_views
node_student_interactions -->|"renders entries"| node_student_log_rendering
node_student_interactions -->|"reads and updates"| node_mock_logs
node_student_interactions -->|"uses interventions"| node_simulated_services
node_student_assessment -->|"reads questions"| node_mock_logs
node_student_group_eval -->|"reads criteria"| node_mock_domain_data
node_lecturer_views -->|"opens detail"| node_lecturer_group_detail
node_lecturer_views -->|"renders insights"| node_lecturer_insights
node_lecturer_views -->|"renders evaluations"| node_lecturer_evaluations
node_lecturer_views -->|"reads portal data"| node_mock_domain_data
node_lecturer_group_detail -->|"gets interventions"| node_simulated_services
node_lecturer_insights -->|"gets interventions"| node_simulated_services
node_simulated_services -->|"reads state and scores"| node_mock_domain_data
node_simulated_services -->|"matches reply data"| node_mock_logs

click node_student_page "https://github.com/stevesomto/ai-agent-update-/blob/main/student.html"
click node_student_interactions "https://github.com/stevesomto/ai-agent-update-/blob/main/js/student.js"
click node_student_log_rendering "https://github.com/stevesomto/ai-agent-update-/blob/main/js/student.js"
click node_student_assessment "https://github.com/stevesomto/ai-agent-update-/blob/main/js/student.js"
click node_student_group_eval "https://github.com/stevesomto/ai-agent-update-/blob/main/js/student.js"
click node_lecturer_page "https://github.com/stevesomto/ai-agent-update-/blob/main/lecturer.html"
click node_lecturer_views "https://github.com/stevesomto/ai-agent-update-/blob/main/js/lecturer.js"
click node_lecturer_group_detail "https://github.com/stevesomto/ai-agent-update-/blob/main/js/lecturer.js"
click node_lecturer_insights "https://github.com/stevesomto/ai-agent-update-/blob/main/js/lecturer.js"
click node_lecturer_evaluations "https://github.com/stevesomto/ai-agent-update-/blob/main/js/lecturer.js"
click node_mock_domain_data "https://github.com/stevesomto/ai-agent-update-/blob/main/js/data.js"
click node_mock_logs "https://github.com/stevesomto/ai-agent-update-/blob/main/js/log-data.js"
click node_simulated_services "https://github.com/stevesomto/ai-agent-update-/blob/main/js/ai-simulation.js"

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_student_page,node_student_interactions,node_student_log_rendering,node_student_assessment,node_student_group_eval toneBlue
class node_lecturer_page,node_lecturer_views,node_lecturer_group_detail,node_lecturer_insights,node_lecturer_evaluations toneAmber
class node_mock_domain_data,node_mock_logs,node_simulated_services toneMint
class node_student_actor,node_lecturer_actor toneIndigo
```

## Components

### Student learning

- [Student portal](https://github.com/stevesomto/ai-agent-update-/blob/main/student.html): `student.html`
- [Tutoring and support](https://github.com/stevesomto/ai-agent-update-/blob/main/js/student.js): `js/student.js`
- [Log rendering](https://github.com/stevesomto/ai-agent-update-/blob/main/js/student.js): `js/student.js`
- [Learning checks](https://github.com/stevesomto/ai-agent-update-/blob/main/js/student.js): `js/student.js`
- [Group evaluation](https://github.com/stevesomto/ai-agent-update-/blob/main/js/student.js): `js/student.js`

### Lecturer oversight

- [Lecturer portal](https://github.com/stevesomto/ai-agent-update-/blob/main/lecturer.html): `lecturer.html`
- [Portal views](https://github.com/stevesomto/ai-agent-update-/blob/main/js/lecturer.js): `js/lecturer.js`
- [Group detail](https://github.com/stevesomto/ai-agent-update-/blob/main/js/lecturer.js): `js/lecturer.js`
- [Insights and resources](https://github.com/stevesomto/ai-agent-update-/blob/main/js/lecturer.js): `js/lecturer.js`
- [Evaluations](https://github.com/stevesomto/ai-agent-update-/blob/main/js/lecturer.js): `js/lecturer.js`

### Mock data and services

- [Learning data](https://github.com/stevesomto/ai-agent-update-/blob/main/js/data.js): `js/data.js`
- [Interaction logs](https://github.com/stevesomto/ai-agent-update-/blob/main/js/log-data.js): `js/log-data.js`
- [Simulated AI services](https://github.com/stevesomto/ai-agent-update-/blob/main/js/ai-simulation.js): `js/ai-simulation.js`

### Other components

- **Student**
- **Lecturer**

## Connections

- Student → Student portal: uses
- Student portal → Tutoring and support: loads
- Lecturer → Lecturer portal: uses
- Lecturer portal → Portal views: loads
- Tutoring and support → Log rendering: renders entries (evidence: `js/student.js`)
- Tutoring and support → Interaction logs: reads and updates (evidence: `js/student.js`)
- Tutoring and support → Simulated AI services: uses interventions (evidence: `js/student.js`)
- Learning checks → Interaction logs: reads questions (evidence: `js/student.js`)
- Group evaluation → Learning data: reads criteria (evidence: `js/student.js`)
- Portal views → Group detail: opens detail (evidence: `js/lecturer.js`)
- Portal views → Insights and resources: renders insights (evidence: `js/lecturer.js`)
- Portal views → Evaluations: renders evaluations (evidence: `js/lecturer.js`)
- Portal views → Learning data: reads portal data (evidence: `js/lecturer.js`)
- Group detail → Simulated AI services: gets interventions (evidence: `js/lecturer.js`)
- Insights and resources → Simulated AI services: gets interventions (evidence: `js/lecturer.js`)
- Simulated AI services → Learning data: reads state and scores (evidence: `js/ai-simulation.js`)
- Simulated AI services → Interaction logs: matches reply data (evidence: `js/ai-simulation.js`)
