feat(deploy): add Docker support and deployment documentation

[chilingling]

For English template, use this link or append ?template=pull_request_en.md to the URL.

变更摘要

• 实现基于 node:22-alpine 的多阶段构建 Dockerfile，优化生产环境镜像大小。
• 在 package.json 中新增 Docker 相关脚本（docker:up, docker:down, docker:build 等）。
• 新增专门的 Docker 部署指南文档，并同步更新中英文 README。

关联 Issue

变更类型

• 缺陷修复
• 新功能
• 重构
• 文档更新
• 维护性变更

主要改动

验证方式

• pnpm lint
• pnpm format:check
• pnpm build
• 已完成手工验证（如适用）

API/行为影响

• 无破坏性变更
• 可能有破坏性变更（请在下方说明）

风险与回滚

Reviewer 关注点

Summary by CodeRabbit

• New Features

  • Added Docker and Docker Compose deployment support with multi-stage builds and integrated health checks.

• Documentation

  • Updated deployment guides with Docker Compose instructions, configuration examples, and troubleshooting steps. Added comprehensive deployment documentation.

• Chores

  • Added Docker configuration files and npm scripts for container management.

[coderabbitai]

Walkthrough

The pull request introduces comprehensive Docker and Docker Compose support to the project, including a multi-stage Dockerfile with health checks, a docker-compose configuration file, updated documentation in multiple languages, new npm scripts for Docker management, and a .dockerignore file.

Changes

Cohort / File(s)	Summary
Docker Infrastructure Dockerfile, docker-compose.yml, .dockerignore	New multi-stage Dockerfile with builder and production stages, pnpm dependency management, TypeScript compilation, and health check endpoint. Docker Compose service configuration with environment variable loading, restart policy, and health check configuration.
Documentation Updates README.md, README.zh-CN.md, docs/docker-deploy.md	Revised "Using Docker" sections to emphasize Docker Compose workflow over direct Dockerfile commands. Added comprehensive deployment guide covering prerequisites, environment setup, startup/shutdown procedures, health verification, and troubleshooting commands.
Build Automation package.json	Four new npm scripts: docker:up (build and start), docker:down (stop and remove), docker:logs (follow logs), docker:build (build images only).

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Poem

🐰 A Docker dream takes shape today,
Multi-stage builds lead the way,
Compose orchestrates with grace and care,
Health checks verify all is fair,
From node_modules cleared, we build with flair! 🚀

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Description check	⚠️ Warning	The PR description covers the main changes (Dockerfile, Docker scripts, documentation) with clear intent, but is incomplete against the template requirements.	Fill in the '主要改动' (Main Changes) section with specific details, add content to '风险与回滚' and '关注点' sections, and provide manual verification results in the validation section.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly and specifically summarizes the main change: adding Docker support and deployment documentation to the project.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🧹 Nitpick comments (1)

Dockerfile (1)

7-7: Consider pinning pnpm version for reproducible builds.

Using pnpm@latest means builds may behave differently over time as pnpm releases new versions. For production deployments, pinning to a specific version improves reproducibility.

♻️ Proposed fix

-RUN corepack enable && corepack prepare pnpm@latest --activate
+RUN corepack enable && corepack prepare pnpm@10 --activate

This aligns with the "pnpm": ">=10" constraint in package.json.

Also apply the same change to line 28 in the production stage.

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In `@Dockerfile` at line 7, Replace the unpinned installer invocation "corepack
prepare pnpm@latest --activate" with a pinned pnpm release (e.g., "corepack
prepare pnpm@10.22.0 --activate") to ensure reproducible builds; update both
occurrences of the RUN command (the development stage RUN corepack enable &&
corepack prepare pnpm@latest --activate and the identical line in the production
stage) so they reference the chosen fixed pnpm version that satisfies your
"pnpm": ">=10" constraint in package.json.

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/docker-deploy.md`:
- Around line 103-114: The fenced code block containing the ASCII architecture
diagram that starts with "Stage 1 (builder)           Stage 2 (production)" is
missing a language specifier and triggers MD040; update the opening fence from
``` to ```text so the block becomes ```text ... ``` to satisfy the linter and
preserve the diagram formatting.

---

Nitpick comments:
In `@Dockerfile`:
- Line 7: Replace the unpinned installer invocation "corepack prepare
pnpm@latest --activate" with a pinned pnpm release (e.g., "corepack prepare
pnpm@10.22.0 --activate") to ensure reproducible builds; update both occurrences
of the RUN command (the development stage RUN corepack enable && corepack
prepare pnpm@latest --activate and the identical line in the production stage)
so they reference the chosen fixed pnpm version that satisfies your "pnpm":
">=10" constraint in package.json.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 14468375-e794-4f07-a1ec-8f46a0c37b31

📥 Commits

Reviewing files that changed from the base of the PR and between 0775649 and 393aab3.

📒 Files selected for processing (7)

• .dockerignore
• Dockerfile
• README.md
• README.zh-CN.md
• docker-compose.yml
• docs/docker-deploy.md
• package.json