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>

1 files changed, 50 insertions, 0 deletions

diff --git a/Documentation/source/zh_CN/architecture.rst b/Documentation/source/zh_CN/architecture.rst
new file mode 100644
index 0000000..55d5b54
--- /dev/null
+++ b/Documentation/source/zh_CN/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、会话、评论存储和评论权限。
+   * - 数据层
+     - ``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``。
+* 标签统计和搜索索引当前依赖批量读取，内容规模变大后应引入缓存或数据库侧聚合。
+* 评论角色策略需要更明确的服务端规则和测试覆盖。