# bigdoanh-dev/ailss-ai-powered-learning-support-system. architecture

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

- Interactive diagram: https://gitdiagram.com/bigdoanh-dev/ailss-ai-powered-learning-support-system.
- Repository: https://github.com/bigdoanh-dev/ailss-ai-powered-learning-support-system.

## Overview

AILSS is a contract-first, event-driven learning platform. The documented student journey runs from account access and course discovery through enrollment, lessons, progress, and assessment; separate lecturer and admin workflows govern course delivery. The README also describes interaction, notifications, private documents, human-reviewed AI, and media delivery. The supplied tree contains no application source, so implementation paths and most internal call relationships cannot be verified; nodes therefore have null paths, and edges are limited to relationships explicitly documented in the README.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User Interfaces"]
  node_web["Responsive Web"]
  node_mobile["Expo Mobile"]
end

subgraph group_learning["Learning Services"]
  node_identity["Identity Service"]
  node_course["Course and Offering"]
  node_classroom["Classroom Service"]
  node_progress["Learning Progress"]
  node_assessment["Assessment Service"]
end

subgraph group_governance["Teaching Governance"]
end

subgraph group_engagement["Engagement and AI"]
  node_interaction["Interaction Service"]
  node_notification["Notifications"]
  node_documents["Private Documents"]
  node_ai["AI Workflows"]
end

subgraph group_platform["Platform Infrastructure"]
  node_gateway{{"API Gateway"}}
  node_media["Media Delivery"]
  node_worker["Media Worker"]
  node_cassandra[("Cassandra")]
  node_rabbitmq["RabbitMQ"]
  node_minio[("MinIO")]
end

node_guest(("Guest or Student"))
node_lecturer(("Lecturer"))
node_admin(("Admin"))
node_payment["Payment Provider"]

node_guest -->|"uses"| node_web
node_guest -->|"uses"| node_mobile
node_web -->|"accesses"| node_gateway
node_mobile -->|"accesses"| node_gateway
node_gateway -->|"routes identity"| node_identity
node_gateway -->|"routes APIs"| node_course
node_gateway -->|"routes APIs"| node_classroom
node_gateway -->|"routes APIs"| node_assessment
node_gateway -->|"routes APIs"| node_interaction
node_gateway -->|"routes APIs"| node_ai
node_guest -->|"discovers courses"| node_course
node_guest -->|"authenticates"| node_identity
node_course -->|"initiates payment"| node_payment
node_course -->|"queues entitlement"| node_rabbitmq
node_guest -->|"joins classes"| node_classroom
node_guest -->|"tracks learning"| node_progress
node_guest -->|"takes quizzes"| node_assessment
node_lecturer -->|"authors courses"| node_course
node_admin -->|"approves courses"| node_course
node_lecturer -->|"manages classes"| node_classroom
node_guest -->|"posts feedback"| node_interaction
node_interaction -->|"supports notifications"| node_notification
node_guest -->|"uses tutor"| node_ai
node_documents -->|"stores privately"| node_minio
node_media -->|"serves media"| node_minio
node_worker -->|"processes events"| node_rabbitmq
node_identity -->|"stores domain data"| node_cassandra
node_course -->|"stores domain data"| node_cassandra
node_classroom -->|"stores domain data"| node_cassandra
node_assessment -->|"stores domain data"| node_cassandra

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_web,node_mobile toneBlue
class node_identity,node_course,node_classroom,node_progress,node_assessment toneAmber
class node_interaction,node_notification,node_documents,node_ai toneRose
class node_gateway,node_media,node_worker,node_cassandra,node_rabbitmq,node_minio,node_guest,node_lecturer,node_admin,node_payment toneIndigo
```

## Components

### User Interfaces

- **Responsive Web**
- **Expo Mobile**

### Learning Services

- **Identity Service**
- **Course and Offering**
- **Classroom Service**
- **Learning Progress**
- **Assessment Service**

### Engagement and AI

- **Interaction Service**
- **Notifications**
- **Private Documents**
- **AI Workflows**

### Platform Infrastructure

- **API Gateway**
- **Media Delivery**
- **Media Worker**
- **Cassandra**
- **RabbitMQ**
- **MinIO**

### Other components

- **Guest or Student**
- **Lecturer**
- **Admin**
- **Payment Provider**

## Connections

- Guest or Student → Responsive Web: uses (evidence: `README.md`)
- Guest or Student → Expo Mobile: uses (evidence: `README.md`)
- Responsive Web → API Gateway: accesses (evidence: `README.md`)
- Expo Mobile → API Gateway: accesses (evidence: `README.md`)
- API Gateway → Identity Service: routes identity (evidence: `README.md`)
- API Gateway → Course and Offering: routes APIs (evidence: `README.md`)
- API Gateway → Classroom Service: routes APIs (evidence: `README.md`)
- API Gateway → Assessment Service: routes APIs (evidence: `README.md`)
- API Gateway → Interaction Service: routes APIs (evidence: `README.md`)
- API Gateway → AI Workflows: routes APIs (evidence: `README.md`)
- Guest or Student → Course and Offering: discovers courses (evidence: `README.md`)
- Guest or Student → Identity Service: authenticates (evidence: `README.md`)
- Course and Offering → Payment Provider: initiates payment (evidence: `README.md`)
- Course and Offering → RabbitMQ: queues entitlement (evidence: `README.md`)
- Guest or Student → Classroom Service: joins classes (evidence: `README.md`)
- Guest or Student → Learning Progress: tracks learning (evidence: `README.md`)
- Guest or Student → Assessment Service: takes quizzes (evidence: `README.md`)
- Lecturer → Course and Offering: authors courses (evidence: `README.md`)
- Admin → Course and Offering: approves courses (evidence: `README.md`)
- Lecturer → Classroom Service: manages classes (evidence: `README.md`)
- Guest or Student → Interaction Service: posts feedback (evidence: `README.md`)
- Interaction Service → Notifications: supports notifications (evidence: `README.md`)
- Guest or Student → AI Workflows: uses tutor (evidence: `README.md`)
- Private Documents → MinIO: stores privately (evidence: `README.md`)
- Media Delivery → MinIO: serves media (evidence: `README.md`)
- Media Worker → RabbitMQ: processes events (evidence: `README.md`)
- Identity Service → Cassandra: stores domain data (evidence: `README.md`)
- Course and Offering → Cassandra: stores domain data (evidence: `README.md`)
- Classroom Service → Cassandra: stores domain data (evidence: `README.md`)
- Assessment Service → Cassandra: stores domain data (evidence: `README.md`)
