Merge pull request #21 from bertyuan/Documentationv1.2

docs: add comprehensive documentation for operations

1 files changed, 50 insertions, 0 deletions

diff --git a/Documentation/source/zh_TW/architecture.rst b/Documentation/source/zh_TW/architecture.rst
new file mode 100644
index 0000000..7c8da41
--- /dev/null
+++ b/Documentation/source/zh_TW/architecture.rst
@@ -0,0 +1,50 @@
+架構
+====
+
+分層視圖
+--------
+
+.. list-table::
+   :header-rows: 1
+   :widths: 22 34 44
+
+   * - 層
+     - 主要檔案
+     - 職責
+   * - 展示層
+     - ``src/app/(main)``、``src/components``
+     - 呈現公開頁面、路由處理器、共用 UI、富文字和版面。
+   * - 內容存取層
+     - ``src/lib/payload-posts.ts``
+     - 查詢 Payload，並把 CMS 文件正規化為前端可用的資料結構。
+   * - CMS 後台
+     - ``payload.config.ts``、``src/payload``
+     - 定義內容集合並提供後台管理體驗。
+   * - 認證與留言
+     - ``src/server/auth``、``src/server/comments``
+     - 處理 OAuth、Session、留言儲存與留言權限。
+   * - 資料層
+     - ``src/server/db``、``src/migrations``
+     - 管理 Drizzle schema、資料庫連線與應用遷移。
+
+文章讀取流程
+------------
+
+1. ``/posts/[slug]`` 頁面接收文章 slug。
+2. Server Component 呼叫 ``getPostBySlug``。
+3. ``src/lib/payload-posts.ts`` 取得 Payload client 並查詢 ``published`` 狀態的文章。
+4. 原始 Payload 文件被轉換為 ``BlogPost``。
+5. 頁面呈現富文字，並掛載分享、留言等互動。
+
+資料邊界
+--------
+
+Payload 負責編輯內容與媒體中繼資料；應用層負責認證、留言、路由行為、UI 狀態與整合邏輯。新增功能前應先判斷資料歸屬：編輯內容放入 Payload collection；帳號、互動、審核與營運記錄放入 Drizzle schema。
+
+已知風險
+--------
+
+* 正式環境不應使用 Payload secret 預設值。
+* RSS 路徑應統一為 ``/rss.xml``。
+* 標籤統計與搜尋索引目前依賴批次讀取，內容規模變大後應引入快取或資料庫側聚合。
+* 留言角色策略需要更明確的服務端規則與測試覆蓋。