How sngdtechnologies/ai-moodle-security works
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: client.php Guarded Client · placement.js Tutor Drawer · generate_text.php Tutor Service · config.php Moodle
Components 17
Moodle Tutor
- Tutor Drawer
plugin/aiplacement_tuteur/amd/src/placement.js - Tutor Service
plugin/aiplacement_tuteur/classes/external/generate_text.php - Moodle
moodle/config.php - MariaDB
Guarded Inference
- Guarded Client
plugin/aiprovider_ollamasecure/classes/client.php - Auth Gate
gate/Caddyfile - Ollama Model
ollama/Modelfile
IoT Mediation
- Sensor Publisher
iot/publisher/publish.sh - MQTT Broker
mosquitto/mosquitto.conf - Sensor Mediation
plugin/aiprovider_ollamasecure/classes/task/iot_mediation.php - Task Schedule
plugin/aiprovider_ollamasecure/db/tasks.php
Perimeter Security
- TLS WAF
proxy/Caddyfile - Runtime Monitor
falco/falco_rules.local.yaml
Evaluation
- Red-Team Runner
eval/redteam.php - Result Analysis
eval/analyze.py
Other components
- Learner
- Internet
Connections 13
- Learner → Tutor Drawer: asks tutor
README.md - Tutor Drawer → Tutor Service: requests text
plugin/aiplacement_tuteur/amd/src/placement.js - Tutor Service → Guarded Client: invokes provider
- Moodle → MariaDB: stores data
README.md - Guarded Client → Auth Gate: sends guarded prompt
plugin/aiprovider_ollamasecure/classes/client.php - Auth Gate → Ollama Model: forwards request
README.md - Internet → TLS WAF: HTTPS traffic
README.md - TLS WAF → Moodle: routes requests
README.md - Sensor Publisher → MQTT Broker: publishes readings
README.md - Task Schedule → Sensor Mediation: schedules
plugin/aiprovider_ollamasecure/db/tasks.php - Sensor Mediation → MQTT Broker: reads messages
plugin/aiprovider_ollamasecure/classes/task/iot_mediation.php - Runtime Monitor → Ollama Model: monitors runtime
README.md - Red-Team Runner → Guarded Client: tests safeguards
eval/redteam.php