# pkalathas/csuaiei architecture

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

- Interactive diagram: https://gitdiagram.com/pkalathas/csuaiei
- Repository: https://github.com/pkalathas/csuaiei

## Overview

This repository is a suite of AIEIC educational tools rather than one integrated application: an instructor dashboard, student lab-support system, assessment service, curriculum designer, and participant agent. The principal workflows are instructors reviewing course activity and materials, students interacting with a lab harness, submissions being assessed and queued for review, and instructors generating and approving lab materials. Edges are limited to relationships shown in excerpts or the source index; unsampled product features are represented where supported, without assuming cross-service wiring.

Main entry points: [`Instructor-Dashboard-for-AIEIC-main/src/App.tsx`](https://github.com/pkalathas/csuaiei/blob/main/Instructor-Dashboard-for-AIEIC-main/src/App.tsx) (Dashboard app), [`assessment-agent/assessment_agent/api/routes.py`](https://github.com/pkalathas/csuaiei/blob/main/assessment-agent/assessment_agent/api/routes.py) (Assessment API), [`Student-UI_agentic_system-main/server/main.py`](https://github.com/pkalathas/csuaiei/blob/main/Student-UI_agentic_system-main/server/main.py) (ADFEL server), [`Student-UI_agentic_system-main/agentic_system/orchestrator.py`](https://github.com/pkalathas/csuaiei/blob/main/Student-UI_agentic_system-main/agentic_system/orchestrator.py) (Lab orchestrator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dashboard["Instructor dashboard"]
  node_dashboard_app["Dashboard app<br/>[App.tsx]"]
  node_login["Login view<br/>[LoginPage.tsx]"]
  node_course_materials["Material preview"]
  node_quiz_preview["Quiz preview<br/>[LabQuizPreview.tsx]"]
  node_student_activity["Student activity"]
  node_graded_submissions["Graded submissions"]
  node_statistics["Statistics<br/>[Statistics.tsx]"]
  node_agent_collaboration["Agent collaboration"]
  node_student_detail["Student details"]
  node_upload_material["Upload material"]
  node_upload_agent["Upload agent"]
end

subgraph group_student["Student lab system"]
  node_student_server["ADFEL server<br/>[main.py]"]
  node_auth_routes["CAS auth routes<br/>[auth.py]"]
  node_auth_logic["Authentication<br/>[auth.py]"]
  node_harness_registry["Harness registry"]
  node_student_routes["Student routes<br/>[student.py]"]
  node_lab_orchestrator["Lab orchestrator<br/>[orchestrator.py]"]
  node_policy_engine["Policy engine<br/>[engine.py]"]
  node_knowledge_base["Knowledge retrieval<br/>[azure_search.py]"]
  node_agent_roles["Lab agent roles"]
  node_student_store[("SQLite stores<br/>[sqlite.py]")]
end

subgraph group_assessment["Assessment service"]
  node_assessment_routes["Assessment API<br/>[routes.py]"]
  node_assessment_flow["Assessment orchestrator<br/>[orchestrator.py]"]
  node_code_grader["Code grading<br/>[code_grader.py]"]
  node_assessment_models["Assessment results<br/>[models.py]"]
  node_review_interfaces["Review and integrity"]
  node_assessment_store[("Assessment persistence<br/>[persistence.py]")]
end

subgraph group_curriculum["Curriculum design"]
  node_curriculum_app["Curriculum API<br/>[main.py]"]
  node_curriculum_routes["Curriculum workflows<br/>[curriculum.py]"]
  node_generation_graph["Material generation<br/>[generation.py]"]
end

subgraph group_participant["Participant agent"]
end

node_instructor(("Instructor"))
node_student_user(("Student"))
node_assessment_user(("Student or client"))
node_curriculum_user(("Instructor"))

node_instructor -->|"uses"| node_dashboard_app
node_dashboard_app -->|"renders"| node_login
node_dashboard_app -->|"renders"| node_course_materials
node_dashboard_app -->|"renders"| node_quiz_preview
node_dashboard_app -->|"renders"| node_student_activity
node_dashboard_app -->|"renders"| node_graded_submissions
node_dashboard_app -->|"renders"| node_statistics
node_dashboard_app -->|"renders"| node_agent_collaboration
node_dashboard_app -->|"renders"| node_student_detail
node_dashboard_app -->|"renders"| node_upload_material
node_dashboard_app -->|"renders"| node_upload_agent
node_student_user -.->|"uses"| node_student_server
node_student_server -->|"registers"| node_auth_routes
node_auth_routes -->|"calls"| node_auth_logic
node_student_server -->|"creates"| node_harness_registry
node_student_server -->|"registers"| node_student_routes
node_student_routes -.->|"dispatches"| node_lab_orchestrator
node_lab_orchestrator -->|"uses"| node_policy_engine
node_lab_orchestrator -->|"retrieves"| node_knowledge_base
node_lab_orchestrator -->|"uses"| node_agent_roles
node_assessment_user -.->|"submits"| node_assessment_routes
node_assessment_routes -->|"assesses"| node_assessment_flow
node_assessment_routes -->|"lists tests"| node_code_grader
node_assessment_routes -->|"queries"| node_review_interfaces
node_assessment_flow -->|"grades code"| node_code_grader
node_assessment_flow -->|"queues review"| node_review_interfaces
node_assessment_flow -->|"builds results"| node_assessment_models
node_assessment_routes -->|"saves results"| node_assessment_store
node_curriculum_user -.->|"requests materials"| node_curriculum_app
node_curriculum_app -->|"registers"| node_curriculum_routes
node_curriculum_app -->|"builds"| node_generation_graph
node_curriculum_routes -.->|"invokes"| node_generation_graph

click node_dashboard_app "https://github.com/pkalathas/csuaiei/blob/main/Instructor-Dashboard-for-AIEIC-main/src/App.tsx"
click node_login "https://github.com/pkalathas/csuaiei/blob/main/Instructor-Dashboard-for-AIEIC-main/src/components/LoginPage.tsx"
click node_course_materials "https://github.com/pkalathas/csuaiei/blob/main/Instructor-Dashboard-for-AIEIC-main/src/tabs/MaterialPreview.tsx"
click node_quiz_preview "https://github.com/pkalathas/csuaiei/blob/main/Instructor-Dashboard-for-AIEIC-main/src/tabs/LabQuizPreview.tsx"
click node_student_activity "https://github.com/pkalathas/csuaiei/blob/main/Instructor-Dashboard-for-AIEIC-main/src/tabs/StudentActivity.tsx"
click node_graded_submissions "https://github.com/pkalathas/csuaiei/blob/main/Instructor-Dashboard-for-AIEIC-main/src/tabs/GradedSubmissions.tsx"
click node_statistics "https://github.com/pkalathas/csuaiei/blob/main/Instructor-Dashboard-for-AIEIC-main/src/tabs/Statistics.tsx"
click node_agent_collaboration "https://github.com/pkalathas/csuaiei/blob/main/Instructor-Dashboard-for-AIEIC-main/src/tabs/AgentCollaboration.tsx"
click node_student_detail "https://github.com/pkalathas/csuaiei/blob/main/Instructor-Dashboard-for-AIEIC-main/src/components/StudentDetailModal.tsx"
click node_upload_material "https://github.com/pkalathas/csuaiei/blob/main/Instructor-Dashboard-for-AIEIC-main/src/components/UploadMaterialModal.tsx"
click node_upload_agent "https://github.com/pkalathas/csuaiei/blob/main/Instructor-Dashboard-for-AIEIC-main/src/components/UploadAgentModal.tsx"
click node_student_server "https://github.com/pkalathas/csuaiei/blob/main/Student-UI_agentic_system-main/server/main.py"
click node_auth_routes "https://github.com/pkalathas/csuaiei/blob/main/Student-UI_agentic_system-main/server/routes/auth.py"
click node_auth_logic "https://github.com/pkalathas/csuaiei/blob/main/Student-UI_agentic_system-main/server/auth.py"
click node_harness_registry "https://github.com/pkalathas/csuaiei/blob/main/Student-UI_agentic_system-main/server/harness_registry.py"
click node_student_routes "https://github.com/pkalathas/csuaiei/blob/main/Student-UI_agentic_system-main/server/routes/student.py"
click node_lab_orchestrator "https://github.com/pkalathas/csuaiei/blob/main/Student-UI_agentic_system-main/agentic_system/orchestrator.py"
click node_policy_engine "https://github.com/pkalathas/csuaiei/blob/main/Student-UI_agentic_system-main/agentic_system/policy/engine.py"
click node_knowledge_base "https://github.com/pkalathas/csuaiei/blob/main/Student-UI_agentic_system-main/agentic_system/kb/azure_search.py"
click node_agent_roles "https://github.com/pkalathas/csuaiei/tree/main/Student-UI_agentic_system-main/agentic_system/agents"
click node_student_store "https://github.com/pkalathas/csuaiei/blob/main/Student-UI_agentic_system-main/agentic_system/store/sqlite.py"
click node_assessment_routes "https://github.com/pkalathas/csuaiei/blob/main/assessment-agent/assessment_agent/api/routes.py"
click node_assessment_flow "https://github.com/pkalathas/csuaiei/blob/main/assessment-agent/assessment_agent/agents/orchestrator.py"
click node_code_grader "https://github.com/pkalathas/csuaiei/blob/main/assessment-agent/assessment_agent/agents/code_grader.py"
click node_assessment_models "https://github.com/pkalathas/csuaiei/blob/main/assessment-agent/assessment_agent/models.py"
click node_review_interfaces "https://github.com/pkalathas/csuaiei/tree/main/assessment-agent/assessment_agent/interfaces"
click node_assessment_store "https://github.com/pkalathas/csuaiei/blob/main/assessment-agent/assessment_agent/persistence.py"
click node_curriculum_app "https://github.com/pkalathas/csuaiei/blob/main/curriculum-designer-AIEIC-main/main.py"
click node_curriculum_routes "https://github.com/pkalathas/csuaiei/blob/main/curriculum-designer-AIEIC-main/routers/curriculum.py"
click node_generation_graph "https://github.com/pkalathas/csuaiei/blob/main/curriculum-designer-AIEIC-main/graphs/generation.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_dashboard_app,node_login,node_course_materials,node_quiz_preview,node_student_activity,node_graded_submissions,node_statistics,node_agent_collaboration,node_student_detail,node_upload_material,node_upload_agent,node_assessment_user toneBlue
class node_student_server,node_auth_routes,node_auth_logic,node_harness_registry,node_student_routes,node_lab_orchestrator,node_policy_engine,node_knowledge_base,node_agent_roles,node_student_store toneAmber
class node_assessment_routes,node_assessment_flow,node_code_grader,node_assessment_models,node_review_interfaces,node_assessment_store toneMint
class node_curriculum_app,node_curriculum_routes,node_generation_graph toneRose
class node_instructor,node_student_user,node_curriculum_user toneIndigo
```

## Components

### Instructor dashboard

- [Dashboard app](https://github.com/pkalathas/csuaiei/blob/main/Instructor-Dashboard-for-AIEIC-main/src/App.tsx): `Instructor-Dashboard-for-AIEIC-main/src/App.tsx`
- [Login view](https://github.com/pkalathas/csuaiei/blob/main/Instructor-Dashboard-for-AIEIC-main/src/components/LoginPage.tsx): `Instructor-Dashboard-for-AIEIC-main/src/components/LoginPage.tsx`
- [Material preview](https://github.com/pkalathas/csuaiei/blob/main/Instructor-Dashboard-for-AIEIC-main/src/tabs/MaterialPreview.tsx): `Instructor-Dashboard-for-AIEIC-main/src/tabs/MaterialPreview.tsx`
- [Quiz preview](https://github.com/pkalathas/csuaiei/blob/main/Instructor-Dashboard-for-AIEIC-main/src/tabs/LabQuizPreview.tsx): `Instructor-Dashboard-for-AIEIC-main/src/tabs/LabQuizPreview.tsx`
- [Student activity](https://github.com/pkalathas/csuaiei/blob/main/Instructor-Dashboard-for-AIEIC-main/src/tabs/StudentActivity.tsx): `Instructor-Dashboard-for-AIEIC-main/src/tabs/StudentActivity.tsx`
- [Graded submissions](https://github.com/pkalathas/csuaiei/blob/main/Instructor-Dashboard-for-AIEIC-main/src/tabs/GradedSubmissions.tsx): `Instructor-Dashboard-for-AIEIC-main/src/tabs/GradedSubmissions.tsx`
- [Statistics](https://github.com/pkalathas/csuaiei/blob/main/Instructor-Dashboard-for-AIEIC-main/src/tabs/Statistics.tsx): `Instructor-Dashboard-for-AIEIC-main/src/tabs/Statistics.tsx`
- [Agent collaboration](https://github.com/pkalathas/csuaiei/blob/main/Instructor-Dashboard-for-AIEIC-main/src/tabs/AgentCollaboration.tsx): `Instructor-Dashboard-for-AIEIC-main/src/tabs/AgentCollaboration.tsx`
- [Student details](https://github.com/pkalathas/csuaiei/blob/main/Instructor-Dashboard-for-AIEIC-main/src/components/StudentDetailModal.tsx): `Instructor-Dashboard-for-AIEIC-main/src/components/StudentDetailModal.tsx`
- [Upload material](https://github.com/pkalathas/csuaiei/blob/main/Instructor-Dashboard-for-AIEIC-main/src/components/UploadMaterialModal.tsx): `Instructor-Dashboard-for-AIEIC-main/src/components/UploadMaterialModal.tsx`
- [Upload agent](https://github.com/pkalathas/csuaiei/blob/main/Instructor-Dashboard-for-AIEIC-main/src/components/UploadAgentModal.tsx): `Instructor-Dashboard-for-AIEIC-main/src/components/UploadAgentModal.tsx`

### Student lab system

- [ADFEL server](https://github.com/pkalathas/csuaiei/blob/main/Student-UI_agentic_system-main/server/main.py): `Student-UI_agentic_system-main/server/main.py`
- [CAS auth routes](https://github.com/pkalathas/csuaiei/blob/main/Student-UI_agentic_system-main/server/routes/auth.py): `Student-UI_agentic_system-main/server/routes/auth.py`
- [Authentication](https://github.com/pkalathas/csuaiei/blob/main/Student-UI_agentic_system-main/server/auth.py): `Student-UI_agentic_system-main/server/auth.py`
- [Harness registry](https://github.com/pkalathas/csuaiei/blob/main/Student-UI_agentic_system-main/server/harness_registry.py): `Student-UI_agentic_system-main/server/harness_registry.py`
- [Student routes](https://github.com/pkalathas/csuaiei/blob/main/Student-UI_agentic_system-main/server/routes/student.py): `Student-UI_agentic_system-main/server/routes/student.py`
- [Lab orchestrator](https://github.com/pkalathas/csuaiei/blob/main/Student-UI_agentic_system-main/agentic_system/orchestrator.py): `Student-UI_agentic_system-main/agentic_system/orchestrator.py`
- [Policy engine](https://github.com/pkalathas/csuaiei/blob/main/Student-UI_agentic_system-main/agentic_system/policy/engine.py): `Student-UI_agentic_system-main/agentic_system/policy/engine.py`
- [Knowledge retrieval](https://github.com/pkalathas/csuaiei/blob/main/Student-UI_agentic_system-main/agentic_system/kb/azure_search.py): `Student-UI_agentic_system-main/agentic_system/kb/azure_search.py`
- [Lab agent roles](https://github.com/pkalathas/csuaiei/tree/main/Student-UI_agentic_system-main/agentic_system/agents): `Student-UI_agentic_system-main/agentic_system/agents`
- [SQLite stores](https://github.com/pkalathas/csuaiei/blob/main/Student-UI_agentic_system-main/agentic_system/store/sqlite.py): `Student-UI_agentic_system-main/agentic_system/store/sqlite.py`

### Assessment service

- [Assessment API](https://github.com/pkalathas/csuaiei/blob/main/assessment-agent/assessment_agent/api/routes.py): `assessment-agent/assessment_agent/api/routes.py`
- [Assessment orchestrator](https://github.com/pkalathas/csuaiei/blob/main/assessment-agent/assessment_agent/agents/orchestrator.py): `assessment-agent/assessment_agent/agents/orchestrator.py`
- [Code grading](https://github.com/pkalathas/csuaiei/blob/main/assessment-agent/assessment_agent/agents/code_grader.py): `assessment-agent/assessment_agent/agents/code_grader.py`
- [Assessment results](https://github.com/pkalathas/csuaiei/blob/main/assessment-agent/assessment_agent/models.py): `assessment-agent/assessment_agent/models.py`
- [Review and integrity](https://github.com/pkalathas/csuaiei/tree/main/assessment-agent/assessment_agent/interfaces): `assessment-agent/assessment_agent/interfaces`
- [Assessment persistence](https://github.com/pkalathas/csuaiei/blob/main/assessment-agent/assessment_agent/persistence.py): `assessment-agent/assessment_agent/persistence.py`

### Curriculum design

- [Curriculum API](https://github.com/pkalathas/csuaiei/blob/main/curriculum-designer-AIEIC-main/main.py): `curriculum-designer-AIEIC-main/main.py`
- [Curriculum workflows](https://github.com/pkalathas/csuaiei/blob/main/curriculum-designer-AIEIC-main/routers/curriculum.py): `curriculum-designer-AIEIC-main/routers/curriculum.py`
- [Material generation](https://github.com/pkalathas/csuaiei/blob/main/curriculum-designer-AIEIC-main/graphs/generation.py): `curriculum-designer-AIEIC-main/graphs/generation.py`

### Other components

- **Instructor**
- **Student**
- **Student or client**
- **Instructor**

## Connections

- Instructor → Dashboard app: uses (evidence: `Instructor-Dashboard-for-AIEIC-main/src/App.tsx`)
- Dashboard app → Login view: renders (evidence: `Instructor-Dashboard-for-AIEIC-main/src/App.tsx`)
- Dashboard app → Material preview: renders (evidence: `Instructor-Dashboard-for-AIEIC-main/src/App.tsx`)
- Dashboard app → Quiz preview: renders (evidence: `Instructor-Dashboard-for-AIEIC-main/src/App.tsx`)
- Dashboard app → Student activity: renders (evidence: `Instructor-Dashboard-for-AIEIC-main/src/App.tsx`)
- Dashboard app → Graded submissions: renders (evidence: `Instructor-Dashboard-for-AIEIC-main/src/App.tsx`)
- Dashboard app → Statistics: renders (evidence: `Instructor-Dashboard-for-AIEIC-main/src/App.tsx`)
- Dashboard app → Agent collaboration: renders (evidence: `Instructor-Dashboard-for-AIEIC-main/src/App.tsx`)
- Dashboard app → Student details: renders (evidence: `Instructor-Dashboard-for-AIEIC-main/src/App.tsx`)
- Dashboard app → Upload material: renders (evidence: `Instructor-Dashboard-for-AIEIC-main/src/App.tsx`)
- Dashboard app → Upload agent: renders (evidence: `Instructor-Dashboard-for-AIEIC-main/src/App.tsx`)
- Student → ADFEL server: uses
- ADFEL server → CAS auth routes: registers (evidence: `Student-UI_agentic_system-main/server/main.py`)
- CAS auth routes → Authentication: calls (evidence: `Student-UI_agentic_system-main/server/routes/auth.py`)
- ADFEL server → Harness registry: creates (evidence: `Student-UI_agentic_system-main/server/main.py`)
- ADFEL server → Student routes: registers (evidence: `Student-UI_agentic_system-main/server/main.py`)
- Student routes → Lab orchestrator: dispatches
- Lab orchestrator → Policy engine: uses (evidence: `Student-UI_agentic_system-main/agentic_system/orchestrator.py`)
- Lab orchestrator → Knowledge retrieval: retrieves (evidence: `Student-UI_agentic_system-main/agentic_system/orchestrator.py`)
- Lab orchestrator → Lab agent roles: uses (evidence: `Student-UI_agentic_system-main/agentic_system/orchestrator.py`)
- Student or client → Assessment API: submits
- Assessment API → Assessment orchestrator: assesses (evidence: `assessment-agent/assessment_agent/api/routes.py`)
- Assessment API → Code grading: lists tests (evidence: `assessment-agent/assessment_agent/api/routes.py`)
- Assessment API → Review and integrity: queries (evidence: `assessment-agent/assessment_agent/api/routes.py`)
- Assessment orchestrator → Code grading: grades code (evidence: `assessment-agent/assessment_agent/agents/orchestrator.py`)
- Assessment orchestrator → Review and integrity: queues review (evidence: `assessment-agent/assessment_agent/agents/orchestrator.py`)
- Assessment orchestrator → Assessment results: builds results (evidence: `assessment-agent/assessment_agent/agents/orchestrator.py`)
- Assessment API → Assessment persistence: saves results (evidence: `assessment-agent/assessment_agent/api/routes.py`)
- Instructor → Curriculum API: requests materials
- Curriculum API → Curriculum workflows: registers (evidence: `curriculum-designer-AIEIC-main/main.py`)
- Curriculum API → Material generation: builds (evidence: `curriculum-designer-AIEIC-main/main.py`)
- Curriculum workflows → Material generation: invokes
