> For the complete documentation index, see [llms.txt](https://docs.chamilo.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chamilo.org/2.x-zh-cn/kai-fa-zhe-zhi-nan/developer-guide.md).

# 开发者指南

欢迎阅读 Chamilo 2.0 开发者指南。本指南面向希望了解 Chamilo 架构、通过插件扩展平台、使用 API、自定义界面或为项目做出贡献的开发者。

## 架构概览

Chamilo 2.0 基于以下技术构建：

* **后端**：Symfony 6.4 (PHP 8.2+)，使用 Doctrine ORM 和 API Platform 3.0
* **前端**：Vue 3，搭配 PrimeVue、Pinia 状态管理和 Vue Router
* **构建系统**：通过 Symfony Webpack Encore 使用 Webpack 5，结合 Tailwind CSS
* **认证**：JWT 令牌 (lexik/jwt-authentication-bundle)
* **文件存储**：Flysystem（支持本地、AWS S3、Azure Blob、Google Cloud）

代码库组织为三个 Symfony 包：

| 包名               | 用途                         |
| ---------------- | -------------------------- |
| **CoreBundle**   | 平台核心：用户、设置、资源、管理、AI 提供商、安全 |
| **CourseBundle** | 课程相关功能：文档、练习、学习路径、论坛等      |
| **LtiBundle**    | LTI 1.3 集成，用于外部学习工具        |

## 本指南的组织结构

1. **入门** — 技术栈、开发环境设置、项目结构
2. **后端** — Symfony 架构、实体、资源系统、控制器、设置
3. **API** — 通过 API Platform 实现的 REST API、JWT 认证、自定义操作
4. **前端** — Vue 组件、视图、路由、状态管理、构建系统
5. **主题定制** — 颜色主题、CSS/Tailwind、Twig 模板
6. **插件** — 插件架构与开发
7. **贡献** — 编码规范、git 工作流程、测试