docs(g3fo-docs): 添加中间件版本清单文档并更新技能指南
- 新增 `middleware-versions.md` 作为标准版本参考文档 - 在技能指南中更新资源引用，添加版本清单问答规范 - 明确 Web Server 与 AP Server 的角色划分及输出要求
This commit is contained in:
@@ -14,6 +14,7 @@ description: g3fo 系统相关文档。管理业务流程说明、服务职责
|
||||
- **分析测试流程**：参考 `references/business_flows/_TEST_FLOW_TEMPLATE.md`。
|
||||
- **查标准运维流程**：去 `references/middleware/` 或 `references/system-init/`。
|
||||
- **查中间件总览/高可用架构**：查阅 `references/middleware/middleware-comprehensive-guide.md`。
|
||||
- **查中间件与标准组件版本**：查阅 `references/middleware/middleware-versions.md`（含 `g3fo-*-service` 应用版本、中间件与 JDK；**Web Server** 仅 Nginx / Vue / Flutter，其余为 **AP Server**；用户要「所有版本」时须分两类列出，见 §2.D）。
|
||||
- **查具体环境/客户资产**：
|
||||
- 内部环境（Dev/UAT）：查阅 `references/inventory/internal.md`。
|
||||
- 外部客户（客户A、B等）：查阅 `references/inventory/clients/[客户名].md`。
|
||||
@@ -61,6 +62,13 @@ description: g3fo 系统相关文档。管理业务流程说明、服务职责
|
||||
4. **表格生成**：汇总信息，输出包含“步骤”、“涉及服务”、“关键接口/代码逻辑”、“测试内容/预期结果”的表格。
|
||||
- **格式参考**：`references/business_flows/_TEST_FLOW_TEMPLATE.md`。
|
||||
|
||||
### D. 版本清单问答
|
||||
1. **文档来源**：以 `references/middleware/middleware-versions.md` 为唯一标准版本表（除非用户指定环境资产清单覆盖）。
|
||||
2. **角色区分**：
|
||||
- **Web Server**：仅 **Nginx、Vue、Flutter**。
|
||||
- **AP Server**：全部 **`g3fo-*-service`**、**全部中间件**（MySQL、Redis、RocketMQ、Nacos、PowerJob、Beszel、Dozzle、dufs 等）、**OpenJDK**。
|
||||
3. **用户问「所有版本 / 完整版本 / 各组件版本号」等**：必须分两块输出，且标题或小节名明确为 **Web Server** 与 **AP Server**（可先 Web 后 AP，或先 AP 后 Web，但两类不可混为一张无标签表）。
|
||||
|
||||
## 3. 示例 Prompt (用户可参考)
|
||||
- **业务咨询**：
|
||||
- “我想测试下单业务流程，请分析代码并列出详细的测试步骤表格。”
|
||||
@@ -71,6 +79,8 @@ description: g3fo 系统相关文档。管理业务流程说明、服务职责
|
||||
- “请根据 `references/middleware/middleware-comprehensive-guide.md` 和 `references/middleware/nacos/deploy.md`，结合客户资产清单生成 Nacos 部署配置。”
|
||||
- **故障排查**：
|
||||
- “我的 MySQL 出现了复制冲突，报错 `Duplicate entry`，请根据 `references/middleware/mysql/fault-analysis.md` 提供排查脚本 and 修复建议。”
|
||||
- **版本清单**：
|
||||
- “请根据 `middleware-versions.md` 列出当前约定的全部组件版本，并按 Web Server / AP Server 分开。”
|
||||
|
||||
## 4. 资源地图
|
||||
- **业务与服务**:
|
||||
@@ -79,6 +89,7 @@ description: g3fo 系统相关文档。管理业务流程说明、服务职责
|
||||
- **架构概览**: `architecture/domain_overview.md`
|
||||
- **中间件标准**（部署/故障分析等详见各子目录）:
|
||||
- **总览**：`middleware/middleware-comprehensive-guide.md`
|
||||
- **版本清单**：`middleware/middleware-versions.md`（Web：Nginx/Vue/Flutter；AP：`g3fo-*-service` + 中间件 + JDK）
|
||||
- **Keepalived**: `middleware/keepalived/`
|
||||
- **MySQL**: `middleware/mysql/`
|
||||
- **Nacos**: `middleware/nacos/`
|
||||
|
||||
@@ -0,0 +1,74 @@
|
||||
# 中间件、应用服务与标准组件版本清单
|
||||
|
||||
本文档列出 g3fo 相关环境中**约定使用的镜像、发行或应用版本**，便于部署对齐、升级评估与问题排查。若与某客户现场或分支实际镜像不一致，以该环境资产清单或运行中的 `docker images` / 构建配置为准。
|
||||
|
||||
## 角色划分：AP Server 与 Web Server
|
||||
|
||||
| 角色 | 范围 | 说明 |
|
||||
| ---- | ---- | ---- |
|
||||
| **AP Server** | 全部 `g3fo-*-service` 业务应用、**全部中间件**（MySQL、Redis、RocketMQ、Nacos、PowerJob、观测与辅助组件等）、Java 运行时（OpenJDK） | 后端与基础设施侧；**不**含 Nginx / Vue / Flutter。 |
|
||||
| **Web Server** | 仅 **Nginx**、**Vue**、**Flutter** | 反向代理 / 静态与前端构建链；与 AP 侧分开罗列。 |
|
||||
|
||||
**AI / 读者输出约定**：当用户询问「所有版本」「完整版本清单」「环境上各组件版本」等时，须**分两节**回答：**先列 Web Server**，**再列 AP Server**（或按用户要求的顺序，但必须明确标注两类，不可混成一张不分角色的总表）。
|
||||
|
||||
---
|
||||
|
||||
## Web Server（仅下列三项）
|
||||
|
||||
| 组件 | 版本 / 标识 | 说明 |
|
||||
| ---- | ------------- | ---- |
|
||||
| Nginx | `1.27.3` | 反向代理 / 网关前置 |
|
||||
| Vue | `3.5.17` | 前端框架（与构建依赖对齐） |
|
||||
| Flutter | `3.38.4` | 移动端 / 跨端构建工具链 |
|
||||
|
||||
---
|
||||
|
||||
## AP Server
|
||||
|
||||
### 业务应用（`g3fo-*-service`）
|
||||
|
||||
以下应用版本统一为 **`1.5.1.22`**。
|
||||
|
||||
| 服务 | 版本 |
|
||||
| ---- | ---- |
|
||||
| g3fo-trade-service | `1.5.1.22` |
|
||||
| g3fo-product-service | `1.5.1.22` |
|
||||
| g3fo-base-service | `1.5.1.22` |
|
||||
| g3fo-admin-service | `1.5.1.22` |
|
||||
| g3fo-monitor-service | `1.5.1.22` |
|
||||
| g3fo-dx-service | `1.5.1.22` |
|
||||
| g3fo-user-service | `1.5.1.22` |
|
||||
| g3fo-margin-service | `1.5.1.22` |
|
||||
| g3fo-notification-service | `1.5.1.22` |
|
||||
| g3fo-exchange-fix-engine-service | `1.5.1.22` |
|
||||
| g3fo-gateway-service | `1.5.1.22` |
|
||||
| g3fo-push-service | `1.5.1.22` |
|
||||
| g3fo-utility-service | `1.5.1.22` |
|
||||
|
||||
### 中间件与运行时（同属 AP Server 侧）
|
||||
|
||||
| 组件 | 版本 / 镜像标识 | 说明 |
|
||||
| ---- | ---------------- | ---- |
|
||||
| MySQL | `8.4.7` | 关系型数据库 |
|
||||
| Redis | `8.4.0` | 缓存与会话等 |
|
||||
| RocketMQ | `5.3.2` | 消息队列 |
|
||||
| RocketMQ Dashboard | `2.1` | RocketMQ 管理控制台 |
|
||||
| Nacos Server | `v3.1.1` | 注册与配置中心 |
|
||||
| PowerJob Server | `v5.1.2` | 分布式任务调度 |
|
||||
| Beszel | `v0.18.4` | 轻量监控相关（容器化部署时按此标签） |
|
||||
| Dozzle | `v9.0.3` | 容器日志查看 |
|
||||
| dufs | `v0.43.0` | 文件服务（静态/上传等场景） |
|
||||
| OpenJDK | `amazoncorretto:17-al2023` | Java 运行时（Amazon Corretto 17，AL2023 基础镜像） |
|
||||
|
||||
---
|
||||
|
||||
## 使用说明
|
||||
|
||||
- **中间件**：部署、Compose 或 K8s 清单中的镜像 tag 建议与本表一致，避免隐式 `latest`。
|
||||
- **OpenJDK**：表内为 Docker 镜像习惯写法；本地非容器环境需安装同主版本 JDK 17 并与团队规范一致。
|
||||
- **Vue / Flutter**：仅归入 **Web Server**；升级时需同步 CI、锁文件与团队文档。
|
||||
|
||||
## 相关文档
|
||||
|
||||
- 中间件高可用与部署总览：`middleware-comprehensive-guide.md`
|
||||
- 各组件细则：同目录下 `mysql/`、`redis/`、`rocketmq/`、`nacos/`、`powerjob/` 等子目录
|
||||
Reference in New Issue
Block a user