From dbb5e791f0c228369605d126dd590962ebe1eddc Mon Sep 17 00:00:00 2001
From: Bertrand Yuan <me@bertyuan.com>
Date: Mon, 27 Apr 2026 20:52:54 +0800
Subject: docs: add comprehensive documentation for operations

This commit introduces a complete set of documentation files
covering various aspects of the project, including environment
setup, quality checks, command references, and architecture.
The documentation is structured to assist developers and
contributors in understanding the project's configuration,
workflow, and best practices.

Additionally, translations for Simplified and Traditional
Chinese have been added to ensure accessibility for a wider
audience. This enhances the overall usability and
maintainability of the project.

Signed-off-by: Bertrand Yuan <github@bertyuan.com>
---
 Documentation/source/zh_TW/operations.rst | 65 +++++++++++++++++++++++++++++++
 1 file changed, 65 insertions(+)
 create mode 100644 Documentation/source/zh_TW/operations.rst

(limited to 'Documentation/source/zh_TW/operations.rst')

diff --git a/Documentation/source/zh_TW/operations.rst b/Documentation/source/zh_TW/operations.rst
new file mode 100644
index 0000000..a513a10
--- /dev/null
+++ b/Documentation/source/zh_TW/operations.rst
@@ -0,0 +1,65 @@
+維運
+====
+
+環境設定
+--------
+
+關鍵環境變數在 ``src/env.js`` 中驗證：
+
+.. list-table::
+   :header-rows: 1
+   :widths: 34 44
+
+   * - 變數
+     - 用途
+   * - ``DATABASE_URL``
+     - PostgreSQL 連線字串。
+   * - ``RESEND_API_KEY``
+     - Resend API key。
+   * - ``RESEND_AUDIENCE_ID``
+     - Resend audience ID。
+   * - ``EMAIL_FROM``
+     - 寄件信箱。
+   * - ``BETTER_AUTH_SECRET``
+     - better-auth secret，正式環境必填。
+   * - ``GOOGLE_CLIENT_ID`` / ``GOOGLE_CLIENT_SECRET``
+     - Google OAuth 憑證。
+   * - ``GITHUB_CLIENT_ID`` / ``GITHUB_CLIENT_SECRET``
+     - GitHub OAuth 憑證。
+
+資料庫流程
+----------
+
+Payload collection 變更：
+
+.. code-block:: bash
+
+   pnpm payload:migrate:create
+   pnpm payload:migrate
+   pnpm payload:generate
+
+應用 schema 變更：
+
+.. code-block:: bash
+
+   pnpm db:generate
+   pnpm db:migrate
+
+品質檢查
+--------
+
+.. code-block:: bash
+
+   pnpm lint
+   pnpm check
+   pnpm test
+   pnpm build
+
+文件建置
+--------
+
+.. code-block:: bash
+
+   make -C Documentation html
+
+產生的 ``Documentation/build`` 不應提交。
-- 
cgit v1.2.3