# sngdtechnologies/ai-moodle-security architecture

> Architecture diagram of the GitHub repository sngdtechnologies/ai-moodle-security, 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/sngdtechnologies/ai-moodle-security
- Repository: https://github.com/sngdtechnologies/ai-moodle-security

## Overview

AI-Moodle-Security is a self-hosted Moodle AI tutor: learners ask for help in Moodle and receive locally generated, guarded responses. Its documented deployment keeps Moodle and Ollama on isolated networks, with a TLS/WAF proxy at the boundary; an optional MQTT path mediates sensor data, and Falco monitors runtime behavior. The graph combines sampled plugin code with README-documented deployment capabilities. Several links between Moodle components are documented at subsystem level rather than verified in sampled call sites.

Main entry points: [`plugin/aiprovider_ollamasecure/classes/client.php`](https://github.com/sngdtechnologies/ai-moodle-security/blob/main/plugin/aiprovider_ollamasecure/classes/client.php) (Guarded Client), [`plugin/aiplacement_tuteur/amd/src/placement.js`](https://github.com/sngdtechnologies/ai-moodle-security/blob/main/plugin/aiplacement_tuteur/amd/src/placement.js) (Tutor Drawer), [`plugin/aiplacement_tuteur/classes/external/generate_text.php`](https://github.com/sngdtechnologies/ai-moodle-security/blob/main/plugin/aiplacement_tuteur/classes/external/generate_text.php) (Tutor Service), [`moodle/config.php`](https://github.com/sngdtechnologies/ai-moodle-security/blob/main/moodle/config.php) (Moodle)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_tutor["Moodle Tutor"]
  node_placement_ui["Tutor Drawer<br/>[placement.js]"]
  node_placement_service["Tutor Service<br/>[generate_text.php]"]
  node_moodle["Moodle<br/>[config.php]"]
  node_moodle_db[("MariaDB")]
end

subgraph group_inference["Guarded Inference"]
  node_provider_client["Guarded Client<br/>[client.php]"]
  node_ollama_gate["Auth Gate"]
  node_ollama["Ollama Model"]
end

subgraph group_iot["IoT Mediation"]
  node_mqtt_publisher["Sensor Publisher<br/>[publish.sh]"]
  node_mqtt_broker["MQTT Broker<br/>[mosquitto.conf]"]
  node_iot_mediation["Sensor Mediation<br/>[iot_mediation.php]"]
  node_task_schedule["Task Schedule<br/>[tasks.php]"]
end

subgraph group_security["Perimeter Security"]
  node_proxy["TLS WAF"]
  node_falco["Runtime Monitor"]
end

subgraph group_evaluation["Evaluation"]
  node_redteam["Red-Team Runner<br/>[redteam.php]"]
  node_analysis["Result Analysis<br/>[analyze.py]"]
end

node_learner(("Learner"))
node_internet(("Internet"))

node_learner -->|"asks tutor"| node_placement_ui
node_placement_ui -->|"requests text"| node_placement_service
node_placement_service -.->|"invokes provider"| node_provider_client
node_moodle -->|"stores data"| node_moodle_db
node_provider_client -->|"sends guarded prompt"| node_ollama_gate
node_ollama_gate -->|"forwards request"| node_ollama
node_internet -->|"HTTPS traffic"| node_proxy
node_proxy -->|"routes requests"| node_moodle
node_mqtt_publisher -->|"publishes readings"| node_mqtt_broker
node_task_schedule -->|"schedules"| node_iot_mediation
node_iot_mediation -->|"reads messages"| node_mqtt_broker
node_falco -->|"monitors runtime"| node_ollama
node_redteam -->|"tests safeguards"| node_provider_client

click node_placement_ui "https://github.com/sngdtechnologies/ai-moodle-security/blob/main/plugin/aiplacement_tuteur/amd/src/placement.js"
click node_placement_service "https://github.com/sngdtechnologies/ai-moodle-security/blob/main/plugin/aiplacement_tuteur/classes/external/generate_text.php"
click node_moodle "https://github.com/sngdtechnologies/ai-moodle-security/blob/main/moodle/config.php"
click node_provider_client "https://github.com/sngdtechnologies/ai-moodle-security/blob/main/plugin/aiprovider_ollamasecure/classes/client.php"
click node_ollama_gate "https://github.com/sngdtechnologies/ai-moodle-security/blob/main/gate/Caddyfile"
click node_ollama "https://github.com/sngdtechnologies/ai-moodle-security/blob/main/ollama/Modelfile"
click node_proxy "https://github.com/sngdtechnologies/ai-moodle-security/blob/main/proxy/Caddyfile"
click node_mqtt_publisher "https://github.com/sngdtechnologies/ai-moodle-security/blob/main/iot/publisher/publish.sh"
click node_mqtt_broker "https://github.com/sngdtechnologies/ai-moodle-security/blob/main/mosquitto/mosquitto.conf"
click node_iot_mediation "https://github.com/sngdtechnologies/ai-moodle-security/blob/main/plugin/aiprovider_ollamasecure/classes/task/iot_mediation.php"
click node_task_schedule "https://github.com/sngdtechnologies/ai-moodle-security/blob/main/plugin/aiprovider_ollamasecure/db/tasks.php"
click node_falco "https://github.com/sngdtechnologies/ai-moodle-security/blob/main/falco/falco_rules.local.yaml"
click node_redteam "https://github.com/sngdtechnologies/ai-moodle-security/blob/main/eval/redteam.php"
click node_analysis "https://github.com/sngdtechnologies/ai-moodle-security/blob/main/eval/analyze.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_placement_ui,node_placement_service,node_moodle,node_moodle_db toneBlue
class node_provider_client,node_ollama_gate,node_ollama toneAmber
class node_mqtt_publisher,node_mqtt_broker,node_iot_mediation,node_task_schedule toneMint
class node_proxy,node_falco toneRose
class node_redteam,node_analysis,node_learner,node_internet toneIndigo
```

## Components

### Moodle Tutor

- [Tutor Drawer](https://github.com/sngdtechnologies/ai-moodle-security/blob/main/plugin/aiplacement_tuteur/amd/src/placement.js): `plugin/aiplacement_tuteur/amd/src/placement.js`
- [Tutor Service](https://github.com/sngdtechnologies/ai-moodle-security/blob/main/plugin/aiplacement_tuteur/classes/external/generate_text.php): `plugin/aiplacement_tuteur/classes/external/generate_text.php`
- [Moodle](https://github.com/sngdtechnologies/ai-moodle-security/blob/main/moodle/config.php): `moodle/config.php`
- **MariaDB**

### Guarded Inference

- [Guarded Client](https://github.com/sngdtechnologies/ai-moodle-security/blob/main/plugin/aiprovider_ollamasecure/classes/client.php): `plugin/aiprovider_ollamasecure/classes/client.php`
- [Auth Gate](https://github.com/sngdtechnologies/ai-moodle-security/blob/main/gate/Caddyfile): `gate/Caddyfile`
- [Ollama Model](https://github.com/sngdtechnologies/ai-moodle-security/blob/main/ollama/Modelfile): `ollama/Modelfile`

### IoT Mediation

- [Sensor Publisher](https://github.com/sngdtechnologies/ai-moodle-security/blob/main/iot/publisher/publish.sh): `iot/publisher/publish.sh`
- [MQTT Broker](https://github.com/sngdtechnologies/ai-moodle-security/blob/main/mosquitto/mosquitto.conf): `mosquitto/mosquitto.conf`
- [Sensor Mediation](https://github.com/sngdtechnologies/ai-moodle-security/blob/main/plugin/aiprovider_ollamasecure/classes/task/iot_mediation.php): `plugin/aiprovider_ollamasecure/classes/task/iot_mediation.php`
- [Task Schedule](https://github.com/sngdtechnologies/ai-moodle-security/blob/main/plugin/aiprovider_ollamasecure/db/tasks.php): `plugin/aiprovider_ollamasecure/db/tasks.php`

### Perimeter Security

- [TLS WAF](https://github.com/sngdtechnologies/ai-moodle-security/blob/main/proxy/Caddyfile): `proxy/Caddyfile`
- [Runtime Monitor](https://github.com/sngdtechnologies/ai-moodle-security/blob/main/falco/falco_rules.local.yaml): `falco/falco_rules.local.yaml`

### Evaluation

- [Red-Team Runner](https://github.com/sngdtechnologies/ai-moodle-security/blob/main/eval/redteam.php): `eval/redteam.php`
- [Result Analysis](https://github.com/sngdtechnologies/ai-moodle-security/blob/main/eval/analyze.py): `eval/analyze.py`

### Other components

- **Learner**
- **Internet**

## Connections

- Learner → Tutor Drawer: asks tutor (evidence: `README.md`)
- Tutor Drawer → Tutor Service: requests text (evidence: `plugin/aiplacement_tuteur/amd/src/placement.js`)
- Tutor Service → Guarded Client: invokes provider
- Moodle → MariaDB: stores data (evidence: `README.md`)
- Guarded Client → Auth Gate: sends guarded prompt (evidence: `plugin/aiprovider_ollamasecure/classes/client.php`)
- Auth Gate → Ollama Model: forwards request (evidence: `README.md`)
- Internet → TLS WAF: HTTPS traffic (evidence: `README.md`)
- TLS WAF → Moodle: routes requests (evidence: `README.md`)
- Sensor Publisher → MQTT Broker: publishes readings (evidence: `README.md`)
- Task Schedule → Sensor Mediation: schedules (evidence: `plugin/aiprovider_ollamasecure/db/tasks.php`)
- Sensor Mediation → MQTT Broker: reads messages (evidence: `plugin/aiprovider_ollamasecure/classes/task/iot_mediation.php`)
- Runtime Monitor → Ollama Model: monitors runtime (evidence: `README.md`)
- Red-Team Runner → Guarded Client: tests safeguards (evidence: `eval/redteam.php`)
