feat(docs): add production deployment guide and reorganize gettingStarted docs

Add production.md with single-machine production deployment guide, internalDeployment.md with internal network deployment guide, and env-comp.md with platform requirements. Reorganize gettingStarted docs with clearer structure and improved content.

Author: dsx137

docs/guides/gettingStarted/cluster.md

@@ -120,17 +120,17 @@ http {
     }
 
     upstream im_api {
-        # OpenIMServer API 地址，可根据部署情况指定多个
+        # OpenIMServer API addresses; add more upstreams if needed
         server IP_A:10002;
         server IP_B:10002;
     }
 
     server {
         listen       443 ssl;
-        server_name  yourhost.com;  # 替换为您的域名
+        server_name  yourhost.com;  # Replace with your domain
 
-        ssl_certificate     /usr/local/nginx/conf/ssl/your_host_bundle.pem;  # 替换为您的证书路径
-        ssl_certificate_key /usr/local/nginx/conf/ssl/your_host.key;        # 替换为您的证书密钥路径
+        ssl_certificate     /usr/local/nginx/conf/ssl/your_host_bundle.pem;  # Replace with your certificate path
+        ssl_certificate_key /usr/local/nginx/conf/ssl/your_host.key;        # Replace with your private key path
 
         location ^~ /api/ {
             proxy_http_version 1.1;
@@ -152,10 +152,10 @@ http {
         }
     }
 
-    # 可选: HTTP 重定向到 HTTPS
+    # Optional: redirect HTTP to HTTPS
     server {
         listen 80;
-        server_name yourhost.com;  # 替换为您的域名
+        server_name yourhost.com;  # Replace with your domain
 
         return 301 https://$host$request_uri;
     }

docs/guides/gettingStarted/dockerCompose.md

@@ -19,7 +19,7 @@ git checkout "$LATEST_STABLE_TAG"
 echo "using openim-docker stable release tag: $LATEST_STABLE_TAG"
 ```
 
-> 这里的 latest 指 GitHub Releases 页面绿色 Latest 的**正式发布版**，不包含 alpha/beta/rc 等预发布版本。
+> 这里的 latest 指 GitHub Releases 页面绿色 Latest 的**正式发布版**，不包含 alpha/beta/rc 等预发布版本。`main` 为开发版分支，生产环境不要直接使用 `main`。
 
 ### 2.2 配置修改 🔧
 
@@ -58,6 +58,21 @@ docker compose down
 docker logs -f openim-server
 ```
 
+### 2.4 监控告警（可选）
+
+如需同时启动 `Prometheus`、`Alertmanager`、`Grafana`、`node-exporter`，可执行：
+
+```bash
+docker compose --profile m up -d
+```
+
+默认端口以当前 `.env` 为准，常用值如下：
+
+- `19090`：Prometheus
+- `19093`：Alertmanager
+- `13000`：Grafana
+- `19100`：node-exporter
+
 ## 3. 快速体验 ⚡
 
 快速体验 OpenIMSDK 核心能力，并测试 OpenIMServer/ChatServer 部署是否正常，请参考[快速验证](./quickTestServer)。

docs/guides/gettingStarted/env-comp.md

@@ -5,11 +5,27 @@ sidebar_position: 1
 
 # 🧩 平台及组件要求
 
-适用于 OpenIMSDK 服务端生产环境源码部署（单机）。
+适用于 `docs/guides/gettingStarted` 下的 OpenIMServer、ChatServer 部署文档。
 
 ---
 
-## 一、环境要求
+## 一、名词约定
+
+- **OpenIMSDK**：项目统称，包含 OpenIMClientSDK 与 OpenIMServer。
+- **OpenIMClientSDK**：客户端 SDK。
+- **OpenIMServer**：IM 基础服务端。
+- **ChatServer**：业务扩展服务端，文档中不再使用 `Chat` 作为独立产品名称。
+- **APP 管理员**：调用管理类接口（如 `10009`）的后台管理角色。
+- **APP 业务服务器**：调用业务扩展接口（如 `10008`）的应用服务端。
+
+## 二、版本与分支策略
+
+- `main`：开发版分支，用于持续集成未发布变更，不建议直接用于生产环境。
+- `vX.Y.Z...`：稳定版发布版本命名。
+- 生产环境建议优先使用 GitHub Releases 页面绿色 **Latest** 对应的**最新正式发布版**。
+- 如需问题复现、灰度回滚或多环境统一，请固定到明确的稳定版本 tag。
+
+## 三、环境要求
 
 | 注意事项 | 详细说明 | 补充说明 |
 | --- | --- | --- |
@@ -20,14 +36,14 @@ sidebar_position: 1
 | Docker | `v24.0.5` 或更高版本 | 自带 `compose` 功能 |
 | Git | `v2.17.1` 或更高版本 | [安装参考](https://git-scm.com/downloads) |
 
-## 二、外部组件要求
+## 四、外部组件要求
 
-| 存储组件 | 建议版本 | 支持模式 | 支持云服务 |
-| --- | --- | --- | --- |
-| MongoDB | `v7.0` | 单机、分片集群 | 支持 |
-| Redis | `v7.0.0` | 单机、分片集群 | 支持 |
-| Etcd | `v3.5.13` | 单机、分片集群 | 不支持 |
-| Kafka | `v3.5.1` | 单机、分布式集群 | 支持 |
-| MinIO | `RELEASE.2024-01-11T07-46-16Z` | 单机 | S3 兼容存储系统（`cos`、`oss`、`kodo`、`aws`） |
+| 组件 | 建议版本 | OpenIMServer 支持模式 | ChatServer 接入方式 | 支持云服务 / 备注 |
+| --- | --- | --- | --- | --- |
+| MongoDB | `v7.0` | `standalone`、`replicaSet` | `address` 或 `uri` | 支持；如接副本集，建议优先使用 `uri` |
+| Redis | `v7.0.0` | `standalone`、`cluster`、`sentinel` | `standalone`、`clusterMode` | 支持；`sentinel` 仅在 OpenIMServer 配置层有显式支持 |
+| Etcd | `v3.5.13` | 单机、多节点集群 | 多地址接入 | 不支持云服务 |
+| Kafka | `v3.5.1` | 单机、分布式集群 | 不直接依赖 | 支持；需按文档预建 topic |
+| MinIO | `RELEASE.2024-01-11T07-46-16Z` | 单机 | 不直接依赖 | 可替换为 S3 兼容存储（`COS`、`OSS`、`Kodo`、`AWS S3`） |
 
 ---

docs/guides/gettingStarted/faq.md

@@ -61,7 +61,7 @@ sidebar_position: 10
     mage start
     ```
 
-5. **如果部署了 ChatServer，也建议同步升级到对应 tag 后再重启 Chat 服务。**
+5. **如果部署了 ChatServer，也建议同步升级到对应 tag 后再重启 ChatServer。**
 
 > 说明：这里的 latest 指 GitHub Releases 页面绿色 Latest 的**正式发布版**，不包含 alpha/beta/rc 等预发布版本。
 
@@ -80,23 +80,23 @@ docker compose down
 源码部署：
 
 ```sh
-mage stop  # 关闭服务
-docker compose down  # 关闭组件
+mage stop  # Stop services
+docker compose down  # Stop components
 ```
 
 然后移动整个文件夹到数据目录，修改.env文件中DATA_DIR的值为新数据目录，再启动服务和组件：
 
 `docker`部署：
 
 ```sh
-docker compose up -d  # 启动组件
+docker compose up -d  # Start components
 ```
 
 源码部署：
 
 ```sh
-docker compose up -d  # 启动组件
-mage start  # 启动服务
+docker compose up -d  # Start components
+mage start  # Start services
 ```
 
 ---
@@ -113,8 +113,8 @@ docker compose down
 源码部署：
 
 ```sh
-mage stop  # 关闭服务
-docker compose down  # 关闭组件
+mage stop  # Stop services
+docker compose down  # Stop components
 ```
 
 然后删除当前部署仓库下的 `components` 文件夹。
@@ -125,15 +125,16 @@ docker compose down  # 关闭组件
 ## 四、 发送文本消息正常，但发送图片失败
 
 一般发送图片失败是由于没有配置第三方存储的原因。默认使用的第三方存储为`minio`，需修改相关配置
-```
-源码部署：
-修改 config/minio.yml 文件，配置 MinIO 外网 IP，以支持发送图片和文件，其中 `your-server-ip` 为服务端外网 IP
+
+源码部署：修改 `config/minio.yml`，将 `externalAddress` 改为外网 IP 或域名路径。
+
+```yaml
 externalAddress: http://your-server-ip:10005
 ```
 
-```
-docker部署
-修改 .env 文件，配置 MinIO 外网 IP，以支持发送图片和文件，其中 `your-server-ip` 为服务端外网 IP
+Docker 部署：修改 `.env`，将 `MINIO_EXTERNAL_ADDRESS` 改为外网 IP 或域名路径。
+
+```dotenv
 MINIO_EXTERNAL_ADDRESS="http://your-server-ip:10005"
 ```
 ---
@@ -149,15 +150,15 @@ MINIO_EXTERNAL_ADDRESS="http://your-server-ip:10005"
 ```yml
   mongo:
     environment:
-    - wiredTigerCacheSizeGB=0.5  # 修改为适当的值，单位GB
+    - wiredTigerCacheSizeGB=0.5  # Adjust to an appropriate value, unit: GB
 ```
 
 `kafka`：
 
 ```yml
   kafka:
     environment:
-      KAFKA_HEAP_OPTS: "-Xms256m -Xmx256m"  # 添加该限制
+      KAFKA_HEAP_OPTS: "-Xms256m -Xmx256m"  # Add this memory limit
 ```
 
 ---