# chamilo/chamilo-lms architecture

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

- Interactive diagram: https://gitdiagram.com/chamilo/chamilo-lms
- Repository: https://github.com/chamilo/chamilo-lms

## Overview

Chamilo 3 is a multi-tenant learning management system. Learners and instructors use courses and sessions to access learning content, complete quizzes and assignments, participate in groups and discussions, and receive grades or certificates; administrators configure users, courses, and platform settings. The README also documents integrations, analytics, and standards support. The sampled code confirms selected reporting, entity, settings, and LTI responsibilities, but not a complete request-to-result path, so uncertain subsystem links are dashed and uncited.

Main entry points: [`src/CoreBundle/Service/GlobalReporting/GlobalReportingSectionQueryService.php`](https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Service/GlobalReporting/GlobalReportingSectionQueryService.php) (Global reporting), [`src/CoreBundle/Entity/Course.php`](https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Entity/Course.php) (Courses), [`src/CoreBundle/Service/CourseReporting/CourseReportingSectionQueryService.php`](https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Service/CourseReporting/CourseReportingSectionQueryService.php) (Course reporting), [`public/main/admin/course_add.php`](https://github.com/chamilo/chamilo-lms/blob/master/public/main/admin/course_add.php) (Course administration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Learning delivery"]
  node_learning_paths["Learning paths<br/>[lp_controller.php]"]
  node_documents["Documents and sharing<br/>[ResourceLink.php]"]
  node_groups["Groups<br/>[Group.php]"]
  node_forum["Forums and chat<br/>[index.php]"]
  node_calendar["Calendar<br/>[agenda.php]"]
end

subgraph group_management["Course management"]
  node_course["Courses<br/>[Course.php]"]
  node_sessions["Sessions<br/>[Session.php]"]
  node_course_admin["Course administration<br/>[course_add.php]"]
  node_user_admin["User administration"]
end

subgraph group_assessment["Assessment and outcomes"]
  node_quizzes["Quizzes<br/>[exercise.php]"]
  node_assignments["Assignments<br/>[index.php]"]
  node_gradebook["Grades and certificates<br/>[gradebook.php]"]
  node_surveys["Surveys"]
end

subgraph group_platform["Platform services"]
  node_settings["Platform settings"]
  node_framework["Service framework<br/>[Container.php]"]
  node_users["User accounts<br/>[User.php]"]
  node_resource_nodes["Resource model<br/>[ResourceNode.php]"]
  node_quickform["Form controller<br/>[Controller.php]"]
  node_user_repository["User repository<br/>[UserRepository.php]"]
  node_course_entity_users["Course memberships<br/>[CourseRelUser.php]"]
  node_extra_fields["Extra fields<br/>[ExtraField.php]"]
  node_resource_link_entity["Resource links<br/>[ResourceLink.php]"]
  node_access_url["Tenant portals<br/>[AccessUrl.php]"]
  node_settings_manager["Settings manager"]
end

subgraph group_insights["Reporting and analytics"]
  node_reporting["Course reporting"]
  node_global_reporting["Global reporting"]
  node_admin_stats["Admin statistics"]
end

node_user(("Learner / instructor"))
node_admin(("Administrator"))

node_user -.->|"uses courses"| node_course
node_admin -.->|"manages courses"| node_course_admin
node_admin -.->|"manages users"| node_user_admin
node_course_admin -.->|"creates courses"| node_course
node_course -.->|"reused as sessions"| node_sessions
node_user -.->|"studies"| node_learning_paths
node_user -.->|"shares files"| node_documents
node_user -.->|"joins groups"| node_groups
node_user -.->|"participates"| node_forum
node_user -.->|"views events"| node_calendar
node_user -.->|"takes quizzes"| node_quizzes
node_user -.->|"submits work"| node_assignments
node_user -.->|"takes surveys"| node_surveys
node_quizzes -.->|"contributes results"| node_gradebook
node_assignments -.->|"contributes grades"| node_gradebook
node_admin -.->|"configures platform"| node_settings
node_reporting -.->|"separate scopes"| node_global_reporting
node_global_reporting -.->|"separate reports"| node_admin_stats
node_reporting -.->|"queries resource data"| node_resource_link_entity
node_global_reporting -.->|"queries learner data"| node_users
node_framework -.->|"resolves services"| node_settings_manager

click node_course "https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Entity/Course.php"
click node_sessions "https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Entity/Session.php"
click node_course_admin "https://github.com/chamilo/chamilo-lms/blob/master/public/main/admin/course_add.php"
click node_user_admin "https://github.com/chamilo/chamilo-lms/blob/master/public/main/admin/user_list_consent.php"
click node_learning_paths "https://github.com/chamilo/chamilo-lms/blob/master/public/main/lp/lp_controller.php"
click node_documents "https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Entity/ResourceLink.php"
click node_groups "https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Tool/Group.php"
click node_forum "https://github.com/chamilo/chamilo-lms/blob/master/public/main/forum/index.php"
click node_calendar "https://github.com/chamilo/chamilo-lms/blob/master/public/main/calendar/agenda.php"
click node_quizzes "https://github.com/chamilo/chamilo-lms/blob/master/public/main/exercise/exercise.php"
click node_assignments "https://github.com/chamilo/chamilo-lms/blob/master/public/main/dropbox/index.php"
click node_gradebook "https://github.com/chamilo/chamilo-lms/blob/master/public/main/gradebook/gradebook.php"
click node_surveys "https://github.com/chamilo/chamilo-lms/tree/master/public/main/survey"
click node_settings "https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Settings/SettingsManager.php"
click node_framework "https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Framework/Container.php"
click node_users "https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Entity/User.php"
click node_resource_nodes "https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Entity/ResourceNode.php"
click node_quickform "https://github.com/chamilo/chamilo-lms/blob/master/public/main/inc/lib/pear/HTML/QuickForm/Controller.php"
click node_user_repository "https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Repository/Node/UserRepository.php"
click node_reporting "https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Service/CourseReporting/CourseReportingSectionQueryService.php"
click node_global_reporting "https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Service/GlobalReporting/GlobalReportingSectionQueryService.php"
click node_admin_stats "https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Service/AdminStatistics/AdminStatisticsUserSystemQueryService.php"
click node_course_entity_users "https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Entity/CourseRelUser.php"
click node_extra_fields "https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Entity/ExtraField.php"
click node_resource_link_entity "https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Entity/ResourceLink.php"
click node_access_url "https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Entity/AccessUrl.php"
click node_settings_manager "https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Settings/SettingsManager.php"

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_learning_paths,node_documents,node_groups,node_forum,node_calendar toneBlue
class node_course,node_sessions,node_course_admin,node_user_admin toneAmber
class node_quizzes,node_assignments,node_gradebook,node_surveys toneMint
class node_settings,node_framework,node_users,node_resource_nodes,node_quickform,node_user_repository,node_course_entity_users,node_extra_fields,node_resource_link_entity,node_access_url,node_settings_manager toneRose
class node_reporting,node_global_reporting,node_admin_stats,node_user,node_admin toneIndigo
```

## Components

### Learning delivery

- [Learning paths](https://github.com/chamilo/chamilo-lms/blob/master/public/main/lp/lp_controller.php): `public/main/lp/lp_controller.php`
- [Documents and sharing](https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Entity/ResourceLink.php): `src/CoreBundle/Entity/ResourceLink.php`
- [Groups](https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Tool/Group.php): `src/CoreBundle/Tool/Group.php`
- [Forums and chat](https://github.com/chamilo/chamilo-lms/blob/master/public/main/forum/index.php): `public/main/forum/index.php`
- [Calendar](https://github.com/chamilo/chamilo-lms/blob/master/public/main/calendar/agenda.php): `public/main/calendar/agenda.php`

### Course management

- [Courses](https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Entity/Course.php): `src/CoreBundle/Entity/Course.php`
- [Sessions](https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Entity/Session.php): `src/CoreBundle/Entity/Session.php`
- [Course administration](https://github.com/chamilo/chamilo-lms/blob/master/public/main/admin/course_add.php): `public/main/admin/course_add.php`
- [User administration](https://github.com/chamilo/chamilo-lms/blob/master/public/main/admin/user_list_consent.php): `public/main/admin/user_list_consent.php`

### Assessment and outcomes

- [Quizzes](https://github.com/chamilo/chamilo-lms/blob/master/public/main/exercise/exercise.php): `public/main/exercise/exercise.php`
- [Assignments](https://github.com/chamilo/chamilo-lms/blob/master/public/main/dropbox/index.php): `public/main/dropbox/index.php`
- [Grades and certificates](https://github.com/chamilo/chamilo-lms/blob/master/public/main/gradebook/gradebook.php): `public/main/gradebook/gradebook.php`
- [Surveys](https://github.com/chamilo/chamilo-lms/tree/master/public/main/survey): `public/main/survey`

### Platform services

- [Platform settings](https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Settings/SettingsManager.php): `src/CoreBundle/Settings/SettingsManager.php`
- [Service framework](https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Framework/Container.php): `src/CoreBundle/Framework/Container.php`
- [User accounts](https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Entity/User.php): `src/CoreBundle/Entity/User.php`
- [Resource model](https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Entity/ResourceNode.php): `src/CoreBundle/Entity/ResourceNode.php`
- [Form controller](https://github.com/chamilo/chamilo-lms/blob/master/public/main/inc/lib/pear/HTML/QuickForm/Controller.php): `public/main/inc/lib/pear/HTML/QuickForm/Controller.php`
- [User repository](https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Repository/Node/UserRepository.php): `src/CoreBundle/Repository/Node/UserRepository.php`
- [Course memberships](https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Entity/CourseRelUser.php): `src/CoreBundle/Entity/CourseRelUser.php`
- [Extra fields](https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Entity/ExtraField.php): `src/CoreBundle/Entity/ExtraField.php`
- [Resource links](https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Entity/ResourceLink.php): `src/CoreBundle/Entity/ResourceLink.php`
- [Tenant portals](https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Entity/AccessUrl.php): `src/CoreBundle/Entity/AccessUrl.php`
- [Settings manager](https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Settings/SettingsManager.php): `src/CoreBundle/Settings/SettingsManager.php`

### Reporting and analytics

- [Course reporting](https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Service/CourseReporting/CourseReportingSectionQueryService.php): `src/CoreBundle/Service/CourseReporting/CourseReportingSectionQueryService.php`
- [Global reporting](https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Service/GlobalReporting/GlobalReportingSectionQueryService.php): `src/CoreBundle/Service/GlobalReporting/GlobalReportingSectionQueryService.php`
- [Admin statistics](https://github.com/chamilo/chamilo-lms/blob/master/src/CoreBundle/Service/AdminStatistics/AdminStatisticsUserSystemQueryService.php): `src/CoreBundle/Service/AdminStatistics/AdminStatisticsUserSystemQueryService.php`

### Other components

- **Learner / instructor**
- **Administrator**

## Connections

- Learner / instructor → Courses: uses courses
- Administrator → Course administration: manages courses
- Administrator → User administration: manages users
- Course administration → Courses: creates courses
- Courses → Sessions: reused as sessions (evidence: `src/CoreBundle/Entity/Course.php`)
- Learner / instructor → Learning paths: studies
- Learner / instructor → Documents and sharing: shares files
- Learner / instructor → Groups: joins groups
- Learner / instructor → Forums and chat: participates
- Learner / instructor → Calendar: views events
- Learner / instructor → Quizzes: takes quizzes
- Learner / instructor → Assignments: submits work
- Learner / instructor → Surveys: takes surveys
- Quizzes → Grades and certificates: contributes results
- Assignments → Grades and certificates: contributes grades
- Administrator → Platform settings: configures platform
- Course reporting → Global reporting: separate scopes
- Global reporting → Admin statistics: separate reports
- Course reporting → Resource links: queries resource data
- Global reporting → User accounts: queries learner data (evidence: `src/CoreBundle/Service/GlobalReporting/GlobalReportingSectionQueryService.php`)
- Service framework → Settings manager: resolves services
