local_suap

local_suap is a local plugin for Moodle that implements the Moodle-side core of the SUAP/AVA Suite integration: it exposes a token-authenticated HTTP API that receives course structures, enrolments, cohorts, and grades from SUAP and materializes them as categories, courses (rooms), users, enrolments, groups, and cohorts in Moodle. It also maintains custom user and course profile fields, scheduled report tasks, and administration pages for monitoring synchronizations.

Contents

• Overview
  • What the plugin does
  • Requirements
  • Integration with auth_suap
  • Repository Structure
  • Organization
• Installation
  • Plugin Installation
  • Settings Screen
  • Capabilities
  • Testing the Installation
• API & Services
  • Entry Point and Authentication
  • Available Services
  • get_diarios
  • sync_down_grades
  • Sample Payload — sync_up_enrolments
• SUAP → Moodle Synchronization
  • Practical Summary
  • Vocabulary
  • Synchronization Execution
  • Synchronization Flow in Moodle
  • Step-by-Step Breakdown
  • Technical Architecture Reference
• Administration
  • Synchronization History
  • Asynchronous Synchronization Task
  • Self-Instructional Course Report
  • Health Check Mechanisms
• Frequently Asked Questions
  • 1. What is SUAP and Moodle synchronization?
  • 2. When is synchronization executed?
  • 3. What is created automatically in Moodle?
  • 4. Why do I see two synchronization runs for the same course offering?
  • 5. Who is created or updated as a user in Moodle?
  • 6. Why are some students marked as suspended in Moodle?
  • 7. What are cohorts and how are they used in rooms?
  • 8. How do groups inside rooms work?
  • 9. How do grades flow between Moodle and SUAP?
• Development
  • Versioning
  • CI/CD
  • Documentation
  • Commit Conventions
  • How to contribute: pre-commit (pre-push) with act