# Symfony 架構

## Bundles

Chamilo 2.0 結構化為三個 Symfony bundles：

### CoreBundle (`src/CoreBundle/`)

最大的 bundle，處理所有平台範圍的關注點：

* **用戶與認證** — User entity、角色、JWT tokens、OAuth2 providers
* **資源系統** — ResourceNode 和 ResourceFile（統一的內容抽象）
* **平台設定** — `src/CoreBundle/Settings/` 中的設定架構，涵蓋每個可配置面向
* **管理** — 用戶、課程、工作坊和插件管理的管理控制器
* **AI 提供者** — OpenAI、Gemini、Mistral、DeepSeek、Grok 的工廠模式
* **檔案儲存** — 基於 Flysystem 的儲存適配器（local、S3、Azure、GCS）
* **安全性** — Voters、存取控制、角色階層
* **工具** — 透過工具系統註冊的課程工具定義

### CourseBundle (`src/CourseBundle/`)

所有特定於課程內容的功能：

* **內容實體** — 101 個實體，用於文件、測驗、學習路徑、論壇、詞彙表、調查、出席、部落格、作業等
* **課程複製** — 支援 Common Cartridge 1.3 和 Moodle 格式的匯入/匯出
* **課程設定** — 課程層級的設定架構

### LtiBundle (`src/LtiBundle/`)

LTI 1.3 標準實作：

* **平台與工具註冊** — 管理外部工具連線
* **啟動處理** — LTI 啟動流程控制器
* **成績回傳** — 從外部工具將成績回傳至 Chamilo

## Service Container

Chamilo 使用 Symfony 的依賴注入容器。服務配置於：

* `config/services.yaml` — 全球服務定義
* 每個 bundle 的 `DependencyInjection/` 目錄 — Bundle 特定服務

## Security Architecture

安全性系統配置於 `config/packages/security.yaml`：

* **密碼雜湊** — 支援 bcrypt（預設），並從舊版 SHA1 和 MD5 遷移
* **角色階層** — 18 個角色階層式組織（ROLE\_GLOBAL\_ADMIN > ROLE\_ADMIN > ROLE\_TEACHER > ROLE\_STUDENT > ROLE\_USER；額外角色包括 ROLE\_HR、ROLE\_INVITEE、ROLE\_STUDENT\_BOSS、ROLE\_SESSION\_MANAGER、ROLE\_QUESTION\_MANAGER）
* **情境敏感角色** — 課程層級角色（ROLE\_CURRENT\_COURSE\_TEACHER、ROLE\_CURRENT\_COURSE\_STUDENT）根據註冊每請求計算
* **防火牆** — API 使用 JWT 認證，網頁介面使用基於工作階段的認證
* **Voters** — 透過 Symfony voters 實現資源層級存取控制

## Legacy Code

某些功能仍使用 `public/main/` 中的舊版 PHP 程式碼：

* 測驗渲染與互動
* 學習路徑播放器
* 某些管理工具

這些功能正逐步遷移至 Symfony+Vue 架構。舊版頁面透過啟動 Symfony kernel 的相容層提供服務。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.chamilo.org/2.x-zh-tw/kai-fa-zhe-zhi-nan/developer-guide/backend/symfony-architecture.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.