Merge pull request #21 from bertyuan/Documentationv1.2

docs: add comprehensive documentation for operations

1 files changed, 65 insertions, 0 deletions

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`` 不應提交。