feat(GOV-006): 建立环境配置与双部署基线

docs/deployment/docker-compose-production.md

@@ -0,0 +1,18 @@
+# Docker Compose 生产部署
+
+生产 Docker Compose 使用不可变应用镜像和外部 env 文件。当前 `production.yml.example` 是部署契约骨架，应用镜像、健康检查和实际启动命令必须在 Web/Server 脚手架完成后验证，未验证前不得用于线上部署。
+
+## 配置边界
+
+- 从 `deploy/env/production/` 准备四份真实配置，存放在服务器 `/etc/a-share-analysis/` 或其他受控目录。
+- Compose 通过外部路径加载，不在 YAML、镜像和 Git 中保存秘密。
+- 镜像引用必须包含版本或内容摘要，禁止浮动 `latest`。
+- 第一阶段只依赖 Redis；MySQL 和 RabbitMQ 功能开关保持关闭。
+
+## 发布与回退
+
+部署前验证镜像对应已推送提交或标签、环境 Schema、健康检查和数据目录。升级只修改不可变镜像引用；失败时恢复上一完整镜像集合和未改变的外部配置。禁止删除 Redis、MySQL 或 RabbitMQ 数据目录作为应用回退手段。
+
+## 验证
+
+应用脚手架落地后必须补充 `docker compose config`、服务健康检查、日志读取、优雅停止和回退演练证据。本版本不声称生产 Compose 已可运行。

docs/deployment/local-development.md

@@ -0,0 +1,21 @@
+# 本地开发环境
+
+本地开发使用 Docker Compose 只启动 Redis，Web、API、Scheduler 和 Worker 从源码运行并使用开发环境模板。第一阶段不启动 MySQL 和 RabbitMQ。
+
+## 配置
+
+从 `deploy/env/development/` 中对应的 `*.env.example` 创建本机 `*.env.local`。真实文件被 Git 忽略，不得写入生产地址或真实密钥。
+
+## Redis
+
+```bash
+docker compose -f deploy/compose/development.yml up -d
+docker compose -f deploy/compose/development.yml ps
+docker compose -f deploy/compose/development.yml down
+```
+
+Redis 只绑定 `127.0.0.1:6379`，数据写入仓库忽略的 `.local/redis/`。不得把该 Compose 文件用于生产。
+
+## 应用状态
+
+Web 和 Server 尚未完成脚手架，因此本版本只交付配置契约和 Redis 开发环境。后续脚手架必须使用 Node.js 22 LTS、pnpm 10 和这些模板，不能在本文档中假装应用已经可启动。

docs/deployment/ubuntu-source-production.md

@@ -0,0 +1,35 @@
+# Ubuntu 源码生产部署
+
+正式支持 Ubuntu 22.04 LTS 与 Ubuntu 24.04 LTS 的 x86_64。服务器管理员预先提供 Node.js 22 LTS、pnpm 10、Nginx，以及 MySQL 5.7、Redis、RabbitMQ 或相应外部服务；项目不负责安装或升级这些软件，也不修改系统软件源。
+
+## 前置验证
+
+```bash
+uname -m
+node --version
+pnpm --version
+nginx -v
+```
+
+架构必须为 `x86_64`，Node.js 必须为 22 LTS，pnpm 必须为 10.x。不满足要求时终止部署。
+
+## 目录与配置
+
+- 发布目录：`/opt/a-share-analysis/releases/<版本或提交>/`。
+- 当前版本：`/opt/a-share-analysis/current` 符号链接。
+- 生产配置：`/etc/a-share-analysis/api.env`、`scheduler.env`、`worker.env`、`web.env`。
+- 运行用户：非登录系统用户 `a-share`。
+
+真实配置从仓库生产模板生成，但不得放入发布目录。API、Scheduler、Worker 的 systemd 单元分别通过 `EnvironmentFile=` 读取自己的配置；包含秘密的文件建议为 `root:a-share 0640`。
+
+## 构建与启动边界
+
+使用 `pnpm install --frozen-lockfile` 安装锁定依赖，在新发布目录构建 Web 和 Server。Web 静态文件由 Nginx 托管，API、Scheduler、Worker 运行编译后的 JavaScript。禁止 Vite 开发服务器、watch、调试端口和生产运行 TypeScript。
+
+当前应用尚未脚手架化，仓库中的 systemd 与 Nginx 文件是路径和权限契约示例，不能冒充已经验证的线上启动文件。后续应用功能必须补充实际构建、启动和健康检查验证。
+
+## 升级、检查与回退
+
+在新的不可变发布目录完成安装、构建和配置校验后，原子切换 `current`，依次重启 API、Scheduler、Worker 并检查 `systemctl status`、`journalctl` 和 HTTP 健康端点。失败时切回上一完整目录并重启服务；生产配置不随版本切换覆盖。
+
+项目部署流程禁止连接或读取生产数据库做开发验证。数据库备份属于独立运维职责，应用回退不得删除或覆盖数据。