> 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/3.x/zh-tw/kai-fa-zhe-zhi-nan/developer-guide.md).

# 開發者指南

歡迎使用 Chamilo 3.0 開發者指南。本指南面向希望了解 Chamilo 架構、以外掛擴充平台、使用 API、自訂介面，或為專案貢獻程式碼的開發者。

## 架構概覽

Chamilo 3.0 建置於：

* **後端**：Symfony 7.4（PHP 8.3–8.5），搭配 Doctrine ORM 與 API Platform 4
* **前端**：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 bundle：

| Bundle           | 用途                           |
| ---------------- | ---------------------------- |
| **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 工作流程、測試