From cd6c8a04502baa1ca19a1b99f4a74eff1fd20517 Mon Sep 17 00:00:00 2001 From: "ken.li" Date: Mon, 23 Mar 2026 13:35:08 +0800 Subject: [PATCH] =?UTF-8?q?docs(g3fo-docs):=20=E6=B7=BB=E5=8A=A0=E4=B8=AD?= =?UTF-8?q?=E9=97=B4=E4=BB=B6=E7=89=88=E6=9C=AC=E6=B8=85=E5=8D=95=E6=96=87?= =?UTF-8?q?=E6=A1=A3=E5=B9=B6=E6=9B=B4=E6=96=B0=E6=8A=80=E8=83=BD=E6=8C=87?= =?UTF-8?q?=E5=8D=97?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 新增 `middleware-versions.md` 作为标准版本参考文档 - 在技能指南中更新资源引用，添加版本清单问答规范 - 明确 Web Server 与 AP Server 的角色划分及输出要求 --- skills/g3fo-docs/SKILL.md | 11 +++ .../middleware/middleware-versions.md | 74 +++++++++++++++++++ 2 files changed, 85 insertions(+) create mode 100644 skills/g3fo-docs/references/middleware/middleware-versions.md diff --git a/skills/g3fo-docs/SKILL.md b/skills/g3fo-docs/SKILL.md index 8e28134..e9dde08 100644 --- a/skills/g3fo-docs/SKILL.md +++ b/skills/g3fo-docs/SKILL.md @@ -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/` diff --git a/skills/g3fo-docs/references/middleware/middleware-versions.md b/skills/g3fo-docs/references/middleware/middleware-versions.md new file mode 100644 index 0000000..fe0a855 --- /dev/null +++ b/skills/g3fo-docs/references/middleware/middleware-versions.md @@ -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/` 等子目录