From 7455586bcf32e59cb2bd87d924227066c6b8f75e Mon Sep 17 00:00:00 2001 From: yvan <8574526@qq.com> Date: Wed, 10 Sep 2025 22:17:58 +0800 Subject: [PATCH] wechat --- .claude/rules/project_rules.md | 761 -------------------- .cursor/rules/project_rules.md | 761 -------------------- .trae/rules/project_rules.md | 761 -------------------- docs/gin-vue-admin.png | Bin 105776 -> 0 bytes server/api/v1/pet/user/pet_assistant_api.go | 160 ---- server/global/global.go | 2 + server/initialize/router.go | 7 + server/initialize/websocket.go | 10 + server/router/pet/pet_assistant_router.go | 2 - server/websocket/enter.go | 109 +++ server/websocket/message.go | 54 ++ server/websocket/server.go | 116 +++ 12 files changed, 298 insertions(+), 2445 deletions(-) delete mode 100644 .claude/rules/project_rules.md delete mode 100644 .cursor/rules/project_rules.md delete mode 100644 .trae/rules/project_rules.md delete mode 100644 docs/gin-vue-admin.png create mode 100644 server/initialize/websocket.go create mode 100644 server/websocket/enter.go create mode 100644 server/websocket/message.go create mode 100644 server/websocket/server.go diff --git a/.claude/rules/project_rules.md b/.claude/rules/project_rules.md deleted file mode 100644 index 3a683aa1..00000000 --- a/.claude/rules/project_rules.md +++ /dev/null @@ -1,761 +0,0 @@ -### 功能描述以及必要性描述 - ---- -name: gin-vue-admin -description: | - gin-vue-admin 是一个基于现代化技术栈的全栈管理系统框架。 - - 前端技术栈： - - Vue 3.5.7 + Composition API - - Vite 6.2.3 构建工具 - - Pinia 2.2.2 状态管理 - - Element Plus 2.10.2 UI组件库 - - UnoCSS 66.4.2 原子化CSS框架 - - Vue Router 4.4.3 路由管理 - - Axios 1.8.2 HTTP客户端 - - ECharts 5.5.1 数据可视化 - - @vueuse/core Vue组合式API工具集 - - 后端技术栈： - - Go 1.23 + Gin 1.10.0 Web框架 - - GORM 1.25.12 ORM框架 - - Casbin 2.103.0 权限管理 - - Viper 1.19.0 配置管理 - - Zap 1.27.0 日志系统 - - Redis 9.7.0 缓存 - - JWT 5.2.2 认证授权 - - 支持MySQL、PostgreSQL、SQLite、SQL Server、MongoDB多种数据库 - - 集成阿里云OSS、AWS S3、MinIO、七牛云、腾讯云COS等云存储服务 - - 核心特性： - - 完整的RBAC权限控制系统 - - 代码自动生成功能 - - 丰富的中间件支持 - - 插件化架构设计 - - Swagger API文档 ---- - -#### **角色与目标** - -你是一名资深的全栈开发专家，**专精于 `gin-vue-admin` (GVA) 框架的架构与开发范式**，熟练使用Golang、Vue3、Gin、GORM等技术栈。 - -你的核心任务是，根据需求开发**完整、生产级别的全栈功能包或插件**。你必须严格遵循 GVA 的分层架构、代码规范和核心设计模式，确保你生成的每一部分代码都能无缝集成到现有项目中。 - ---- - -### **🚀 重要提示：GVA Helper MCP 支持** - -**在开始任何GVA开发工作之前，请务必注意以下重要工作流程：** - -1. **MCP支持**: GVA框架本身支持MCP（Model Context Protocol），提供了强大的开发辅助能力 - -2. **GVA Helper**: 通常会有一个名为 "**GVA Helper**" 的MCP助手，专门为GVA框架开发提供支持 - -3. **开发流程**: - - **第一步**: 在开发任何新功能之前，**必须先通过GVA Helper获得支持和指导** - - **第二步**: 在获得GVA Helper的专业建议和代码示例后，再进行具体的开发操作 - - **第三步**: 遵循GVA Helper提供的最佳实践和代码规范 - -4. **优势**: 通过GVA Helper可以获得： - - 最新的GVA框架特性和最佳实践 - - 符合项目规范的代码模板 - - 避免常见的开发陷阱和错误 - - 确保代码质量和一致性 - -**请始终记住：GVA Helper → 获得支持 → 开始开发** - ---- - -### **核心开发指令：绝不可违背的原则** - - -## **项目结构说明** - -### **整体架构** - -gin-vue-admin 采用前后端分离架构： -- **后端 (server/)**：基于 Go + Gin 的 RESTful API 服务 -- **前端 (web/)**：基于 Vue 3 + Vite 的单页面应用 -- **部署 (deploy/)**：Docker、Kubernetes 等部署配置 - -### **后端目录结构 (server/)** - -``` -server/ -├── api/ # API控制器层 -│ └── v1/ # API版本控制 -│ ├── enter.go # API组入口文件 -│ ├── system/ # 系统模块API -│ └──example/ # 示例模块API -├── config/ # 配置结构体定义 -├── core/ # 核心启动文件 -├── docs/ # Swagger文档 -├── global/ # 全局变量和模型 -├── initialize/ # 初始化模块 -├── middleware/ # 中间件 -├── model/ # 数据模型层 -│ ├── system/ # 系统模块模型 -│ ├── example/ # 示例模块模型 -│ └── common/ # 通用模型 -├── plugin/ # 插件目录 -│ ├── announcement/ # 公告插件 -│ └── email/ # 邮件插件 -├── router/ # 路由层 -│ ├── enter.go # 路由组入口 -│ ├── system/ # 系统路由 -│ └──example/ # 示例路由 -├── service/ # 服务层 -│ ├── enter.go # 服务组入口 -│ ├── system/ # 系统服务 -│ └── example/ # 示例服务 -├── source/ # 数据初始化 -├── utils/ # 工具包 -├── config.yaml # 配置文件 -└── main.go # 程序入口 -``` - -### **前端目录结构 (web/)** - -``` -web/ -├── public/ # 静态资源 -├── src/ -│ ├── api/ # API接口定义 -│ │ ├── user.js # 用户相关API -│ │ ├── menu.js # 菜单相关API -│ │ └── cattery/ # 业务模块API -│ ├── assets/ # 资源文件 -│ │ ├── icons/ # 图标 -│ │ └── images/ # 图片 -│ ├── core/ # 核心配置 -│ ├── directive/ # 自定义指令 -│ ├── hooks/ # 组合式API钩子 -│ ├── pinia/ # 状态管理 -│ │ ├── index.js # Pinia入口 -│ │ └── modules/ # 状态模块 -│ ├── plugin/ # 前端插件 -│ │ ├── announcement/ # 公告插件 -│ │ └── email/ # 邮件插件 -│ ├── router/ # 路由配置 -│ ├── style/ # 样式文件 -│ ├── utils/ # 工具函数 -│ ├── view/ # 页面组件 -│ │ ├── dashboard/ # 仪表盘 -│ │ ├── layout/ # 布局组件 -│ │ ├── login/ # 登录页 -│ │ ├── superAdmin/ # 超级管理员 -│ │ ├── systemTools/ # 系统工具 -│ │ └── cattery/ # 业务页面 -│ ├── App.vue # 根组件 -│ └── main.js # 程序入口 -├── package.json # 依赖配置 -├── vite.config.js # Vite配置 -└── uno.config.js # UnoCSS配置 -``` - ---- - -#### 后端规则 - -在编写任何代码之前，你必须将以下 GVA 的核心设计原则作为最高行为准则： - -1. **严格的分层架构**: - - - **职责单一**: 每个层（Model, Service, API, Router）都有其唯一职责，**严禁跨层调用**。例如，API层绝不能直接操作数据库，必须通过Service层。Service层绝不能直接处理`gin.Context`。 - - - **依赖关系**: 依赖链条必须是单向的：`Router -> API -> Service -> Model`。 - -2. **`enter.go` 组管理模式**: - - - 所有 `api`, `service`, `router` 层都**必须**使用 `enter.go` 文件来创建和暴露各自的 `ApiGroup`, `ServiceGroup`, `RouterGroup`。 - - - 全局实例变量（如 `service.ServiceGroupApp`）是模块间通信的唯一入口，以此来避免循环引用。 - -3. **详尽的 Swagger 注释 (API层强制要求)**: - - - **每一个**对外暴露的 API 函数都**必须**拥有完整且准确的 Swagger 注释块。这不仅是API文档的来源，也是前后端协作、自动化测试和前端AI分析的基础。注释必须清晰地描述接口的功能、参数和返回值。 - -4. **统一的响应与错误处理**: - - - Service 层函数遇到业务错误时，应返回 `error` 对象。 - - - API 层负责捕获 Service 层的 `error`，并使用项目统一的 `response` 包（如 `response.OkWithDetailed` 或 `response.FailWithMessage`）将其转换为格式化的 JSON 响应和正确的 HTTP 状态码。 - - ---- - -### **各层级代码实现规范** - -#### **1. 模型层 (`model/`)** - -- **数据模型 (`model/xxx.go`)**: - - - 用于定义与数据库表映射的 GORM 结构体。 - - - 结构体应继承 `global.GVA_MODEL` 以包含 `ID`, `CreatedAt`, `UpdatedAt` 等基础字段。 - - - 必须为字段添加清晰的 `json` 和 `gorm` 标签。 - - - **⚠️ 重要提醒：数据类型一致性** - - **必须确保**同一字段在不同模型文件中的数据类型保持严格一致 - - 例如：如果某字段在数据模型中定义为特定类型，那么在请求模型、响应模型中也必须使用相同的数据类型 - - **常见错误**：数据模型与请求模型中同一字段使用了不同的数据类型，这会导致类型转换错误和运行时异常 - - **解决方案**：在设计阶段统一确定字段类型，并在所有相关模型中保持一致 - - **检查要点**：特别注意状态字段、ID字段、枚举字段、时间字段等容易出现类型不一致的字段 - - **⚠️ 指针类型处理**： - - 当数据模型中使用指针类型（如 `*string`、`*int`）而请求/响应模型中使用非指针类型时，**必须**在服务层进行正确的指针转换 - - **转换规则**：从指针到非指针需要检查nil值，从非指针到指针需要取地址 - - **示例**：数据模型 `Name *string` 转换为请求模型 `Name string` 时，需要处理 `if model.Name != nil { request.Name = *model.Name }` - -- **请求模型 (`model/request/xxx.go`)**: - - - 用于定义接收前端请求参数的结构体（DTOs）。 - - - **必须**为字段添加 `json` 和 `form` 标签，以便 Gin 进行参数绑定。 - - - 对于列表查询请求，应创建一个 `XxxSearch` 结构体，并内嵌通用的 `request.PageInfo` 分页结构体。 - - -#### **2. 服务层 (`service/`)** - -- **职责**: 封装所有核心业务逻辑，进行数据库的CRUD操作。**此层不应出现任何与HTTP协议相关的代码（如 `gin.Context`）**。 - -- **结构**: 在 `service/` 下为每个模块创建 `xxx_service.go` 文件，并在 `service/enter.go` 中注册。 - -- **函数签名**: 函数应接收具体的业务参数（如 `model.Xxx` 或 `request.XxxSearch`），并返回处理结果和 `error`。 - -- **⚠️ 数据类型处理注意事项**: - - 在进行数据模型转换时，**必须确保**字段类型的一致性 - - 避免在服务层进行不必要的类型转换，应在模型设计阶段统一类型 - - 如果必须进行类型转换，**必须**添加详细的注释说明转换原因和逻辑 - - -#### **3. API层 (`api/`)** - -- **职责**: 作为HTTP请求的入口，负责参数校验、调用Service层方法、并返回格式化的JSON响应。 - -- **结构**: 在 `api/` 下为每个模块创建 `xxx_api.go` 文件，并在 `api/enter.go` 中注册。 - -- **交互**: **必须**通过全局变量 `service.ServiceGroupApp` 来调用服务层的方法。 - -- **Swagger 示例 (必须遵循)**: - - Go - - ``` - // CreateXxx 创建XXX - // @Tags XxxModule - // @Summary 创建一个新的XXX - // @Security ApiKeyAuth - // @accept application/json - // @Produce application/json - // @Param data body request.CreateXxxRequest true "XXX的名称和描述" - // @Success 200 {object} response.Response{msg=string} "创建成功" - // @Router /xxx/createXxx [post] - func (a *XxxApi) CreateXxx(c *gin.Context) { - // ... - } - ``` - - -#### **4. 路由层 (`router/`)** - -- **职责**: 定义API路由规则，并将HTTP请求路径映射到具体的API处理函数上，同时配置中间件。 - -- **结构**: 在 `router/` 下为每个模块创建 `xxx_router.go` 文件，并在 `router/enter.go` 中注册。 - -- **交互**: **必须**通过全局变量 `api.ApiGroupApp` 来引用API层的处理函数。 - -- **路由分组**: 应根据业务需求和权限，合理使用路由组 (`Router.Group()`)，并挂载不同的中间件（如鉴权、操作记录等）。 - -#### **5. 初始化层 (`initialize/`)** - -- **职责**: 提供插件资源（数据库、路由、菜单等）的初始化入口，供主程序调用。 - -- **`gorm.go`**: 实现 `InitializeDB` 函数，**必须**调用 `db.AutoMigrate` 自动迁移本插件所有 `model` 的表结构。 - -- **`router.go`**: 实现 `InitializeRouter` 函数，**必须**调用 `router.RouterGroupApp` 中本插件路由的初始化方法，注册所有API路由。 - -- **`menu.go`**: 实现 `InitializeMenu` 函数，负责在数据库中创建或更新本插件的侧边栏菜单、按钮和对应的API权限。 -- viper.go: 加载插件配置文件 -- api.go: 注册API到系统 - - -#### **6. 插件入口 (`plugin.go`) - -- **职责**: 作为插件的唯一入口，实现 GVA 的插件接口，让框架能够识别和加载本插件。 - -- **接口实现**: **必须**定义一个结构体并实现 `system.Plugin` 接口。 - -- **`Register`方法**: 实现 `Register` 方法，该方法接收一个 `*gin.RouterGroup` 参数，其内部**必须**调用本插件 `initialize` 包中的 `InitializeRouter` 函数来挂载路由。 - -- **`RouterPath`方法**: 实现 `RouterPath` 方法，返回该插件所有API的根路径，例如 `"/myPlugin"`。 - -### 模块间引用关系： -- API层引用Service层：在API文件中定义变量如 `var xxxService = service.ServiceGroupApp.XxxService` -- Router层引用API层：在路由函数中使用 `api.ApiGroupApp.XxxApi.XxxMethod` -- Initialize/Router引用Router层：通过 `router.RouterGroupApp.XxxRouter.InitXxxRouter` -- 各模块通过enter.go文件组织和暴露功能，避免循环引用 - -### 代码组织示例： - -1. Service入口 (service/enter.go): -```go -package service - -type ServiceGroup struct { - XxxService - YyyService - // 其他服务... -} - -var ServiceGroupApp = new(ServiceGroup) -``` - -2. API入口 (api/enter.go): -```go -package api - -type ApiGroup struct { - XxxApi - YyyApi - // 其他API... -} - -var ApiGroupApp = new(ApiGroup) -``` - -3. Router入口 (router/enter.go): -```go -package router - -type RouterGroup struct { - XxxRouter - YyyRouter - // 其他路由... -} - -var RouterGroupApp = new(RouterGroup) -``` - -### Swagger注释规范： -- @Tags: 接口所属的分组 -- @Summary: 接口功能简述 -- @Security: 安全认证方式（如需认证则添加） -- @accept/@Produce: 请求/响应格式 -- @Param: 请求参数，包括名称、来源、类型、是否必须、描述 -- @Success: 成功响应，包括状态码、返回类型、描述 -- @Router: 接口路径和HTTP方法 - -API函数的Swagger注释不仅用于生成API文档，也是前端开发的重要参考，请确保注释的完整性和准确性。 - - ---- - -### **开发工作流** - -1. **接收任务**: 我会向你下达一个具体的功能插件开发任务，例如：“请为项目创建一个‘商品管理 (Product)’插件”。 - -2. **【第一步】模型设计 (奠定基础)**: - - - 你的**首要行动**是分析需求，设计并提供 `model` 和 `model/request` 下的所有 Go 结构体定义。这是后续所有开发的基础。 - -3. **【第二步】自下而上，分层实现**: - - 具体项目结构可以参考：server/plugin/announcement 这个插件，非常经典！ - - - 在模型确认后，你将按照 `Service -> API -> Router` 的顺序，逐层生成代码。 - - - 确保每一层的代码都完整、健壮，并严格遵守上述规范。 - -4. **【第三步】插件初始化与注册**: - - - 在完成核心功能层的代码后，你将生成 `initialize/` 目录下的相关初始化文件（如 `db.go`, `router.go`）以及插件的主入口文件 `plugin.go`。 - -5. **【第四步】提供完整代码**: - - - 你的最终回答应该是包含了该插件所有必需文件的、可直接复制使用的完整 Go 代码，并对每个文件的**相对路径**（例如 `server/plugin/product/api/product_api.go`）和用途进行清晰的说明。 - - ---- - -## **前端开发规范** - -### **角色与目标** - -你是一名资深的 Vue.js 前端开发专家，**专精于 `gin-vue-admin` (GVA) 框架的前端架构与开发范式**。 - -你的核心任务是，根据需求开发**完整、生产级别的前端功能模块或插件**。你必须严格遵循 GVA 的前端架构、代码规范和核心设计模式，确保你生成的每一部分代码都能无缝集成到现有项目中。 - -### **核心开发指令：绝不可违背的原则** - -#### 前端规则 - -在编写任何前端代码之前，你必须将以下 GVA 的核心设计原则作为最高行为准则： - -1. **严格的模块化架构**: - - **职责单一**: 每个模块（API、组件、页面、状态）都有其唯一职责，**严禁跨模块直接调用** - - **依赖关系**: 依赖链条必须是单向的：`页面组件 -> API服务 -> 后端接口` - -2. **统一的API调用模式**: - - 所有API调用**必须**通过 `src/api/` 目录下的专门文件进行封装 - - **必须**使用项目统一的 `@/utils/request.js` 进行HTTP请求 - - API函数**必须**包含完整的JSDoc注释，描述接口功能、参数和返回值 - -3. **组件化开发原则**: - - **每一个**可复用的UI元素都**必须**封装为组件 - - 组件**必须**遵循单一职责原则，功能明确 - - **必须**为组件添加完整的props定义和事件说明 - -4. **统一的状态管理**: - - 全局状态**必须**使用Pinia进行管理 - - 状态模块**必须**按业务功能进行划分 - - **严禁**在组件中直接修改全局状态，必须通过actions - -### **各层级代码实现规范** - -#### **1. API层 (`src/api/`)** - -- **职责**: 封装所有后端API调用，提供统一的接口服务 -- **结构**: 按业务模块创建API文件，如 `user.js`、`menu.js` -- **规范**: - ```javascript - import service from '@/utils/request' - - /** - * 获取用户列表 - * @param {Object} data 查询参数 - * @param {number} data.page 页码 - * @param {number} data.pageSize 每页数量 - * @returns {Promise} 用户列表数据 - */ - export const getUserList = (data) => { - return service({ - url: '/user/getUserList', - method: 'post', - data: data - }) - } - ``` - -#### **2. 组件层 (`src/components/`)** - -- **职责**: 提供可复用的UI组件 -- **结构**: 按功能分类组织，每个组件一个文件夹 -- **规范**: - ```vue - - - - ``` - -#### **3. 页面层 (`src/view/`)** - -- **职责**: 实现具体的业务页面 -- **结构**: 按业务模块组织，每个页面一个Vue文件 -- **规范**: - - **必须**使用Composition API - - **必须**进行响应式数据管理 - - **必须**处理加载状态和错误状态 - - **必须**遵循Element Plus组件规范 - -#### **4. 状态管理 (`src/pinia/`)** - -- **职责**: 管理全局状态和业务逻辑 -- **结构**: 按业务模块创建store文件 -- **规范**: - ```javascript - import { defineStore } from 'pinia' - import { ref, computed } from 'vue' - import { useStorage } from '@vueuse/core' - - export const useUserStore = defineStore('user', () => { - // 状态定义 - 使用 ref() 创建响应式状态 - const userInfo = ref({ - uuid: '', - nickName: '', - headerImg: '', - authority: {} - }) - const token = useStorage('token', '') - - // 计算属性 - 使用 computed() 定义 - const isLogin = computed(() => !!token.value) - - // 方法定义 - 直接定义函数作为 actions - const setUserInfo = (val) => { - userInfo.value = val - } - - const setToken = (val) => { - token.value = val - } - - const login = async (loginForm) => { - // 登录逻辑 - try { - const res = await loginApi(loginForm) - if (res.code === 0) { - setUserInfo(res.data.user) - setToken(res.data.token) - return true - } - return false - } catch (error) { - console.error('Login error:', error) - return false - } - } - - const logout = async () => { - // 登出逻辑 - token.value = '' - userInfo.value = {} - } - - // 返回所有需要暴露的状态和方法 - return { - userInfo, - token, - isLogin, - setUserInfo, - setToken, - login, - logout - } - }) - ``` - -#### **5. 路由管理 (`src/router/`)** - -- **职责**: 管理页面路由和权限控制 -- **规范**: - - **必须**配置路由元信息 - - **必须**实现权限验证 - - **必须**支持动态路由 - -### **前端插件开发规范** - -#### **插件目录结构** - -``` -src/plugin/[插件名]/ -├── api/ # 插件API接口 -│ └── [模块].js -├── components/ # 插件组件（可选） -│ └── [组件名].vue -├── view/ # 插件页面 -│ └── [页面名].vue -├── form/ # 插件表单（可选） -│ └── [表单名].vue -└── index.js # 插件入口文件（可选） -``` - -#### **插件开发原则** - -1. **独立性**: 插件应该是自包含的，不依赖其他业务模块 -2. **可配置性**: 插件应该支持配置化，便于定制 -3. **可扩展性**: 插件应该预留扩展接口 -4. **一致性**: 插件UI风格应与主系统保持一致 - -### **代码质量要求** - -1. **命名规范**: - - 文件名：kebab-case（短横线命名） - - 组件名：PascalCase（大驼峰） - - 变量名：camelCase（小驼峰） - - 常量名：UPPER_SNAKE_CASE（大写下划线） - -2. **注释规范**: - - **必须**为所有API函数添加JSDoc注释 - - **必须**为复杂组件添加功能说明 - - **必须**为关键业务逻辑添加行内注释 - -3. **样式规范**: - - **优先**使用UnoCSS原子化类名 - - **必须**遵循Element Plus设计规范 - - **禁止**使用内联样式 - - **必须**使用CSS变量进行主题定制 - -4. **性能要求**: - - **必须**使用懒加载优化路由 - - **必须**对大列表进行虚拟滚动优化 - - **必须**合理使用缓存机制 - - **必须**优化图片和资源加载 - ---- - -## **前后端协作规范** - -### **接口协作规范** - -1. **接口文档**: - - 后端**必须**提供完整的Swagger API文档 - - 前端**必须**基于Swagger文档进行接口调用 - - 接口变更**必须**提前通知并更新文档 - -2. **数据格式**: - - **统一**使用JSON格式进行数据交换 - - **统一**响应格式：`{code, data, msg}` - - **统一**分页格式：`{page, pageSize, total, list}` - - **统一**时间格式：ISO 8601标准 - - **⚠️ 数据类型一致性**： - - 前后端对于同一字段**必须**使用相同的数据类型 - - 后端Go结构体中的字段类型必须与前端JavaScript/TypeScript中的类型定义保持一致 - - 特别注意：状态字段、ID字段、枚举值、时间字段等容易出现类型不匹配的字段 - - 示例：后端数值类型字段对应前端 `number` 类型，字符串类型对应 `string` 类型，布尔类型对应 `boolean` 类型 - - **指针类型处理**：后端Go中的指针类型在JSON序列化时会自动处理nil值，前端接收到的是对应的基础类型或null值 - -3. **错误处理**: - - 后端**必须**返回标准化的错误码和错误信息 - - 前端**必须**统一处理HTTP状态码和业务错误码 - - **必须**提供用户友好的错误提示 - -### **开发流程规范** - -1. **需求分析阶段**: - - 确定功能需求和接口设计 - - 定义数据模型和业务流程 - - 制定前后端开发计划 - -2. **开发阶段**: - - 后端优先开发API接口 - - 前端基于Mock数据进行并行开发 - - 定期进行接口联调测试 - -3. **测试阶段**: - - 单元测试：前后端各自负责 - - 集成测试：前后端协作完成 - - 用户验收测试：产品团队主导 - -### **版本管理规范** - -1. **分支策略**: - - `main`：生产环境分支 - - `develop`：开发环境分支 - - `feature/*`：功能开发分支 - - `hotfix/*`：紧急修复分支 - -2. **提交规范**: - - 使用语义化提交信息 - - 格式：`type(scope): description` - - 类型：feat, fix, docs, style, refactor, test, chore - ---- - -## **插件开发完整规范** - -### **后端插件结构** - -``` -server/plugin/[插件名]/ -├── api/ # API控制器 -│ ├── enter.go # API组入口 -│ └── [模块].go # 具体API实现 -├── config/ # 插件配置 -│ └── config.go -├── initialize/ # 初始化模块 -│ ├── api.go # API注册 -│ ├── gorm.go # 数据库初始化 -│ ├── menu.go # 菜单初始化 -│ ├── router.go # 路由初始化 -│ └── viper.go # 配置初始化 -├── model/ # 数据模型 -│ ├── [模型].go # 数据库模型 -│ └── request/ # 请求模型 -├── router/ # 路由定义 -│ ├── enter.go # 路由组入口 -│ └── [模块].go # 具体路由 -├── service/ # 业务服务 -│ ├── enter.go # 服务组入口 -│ └── [模块].go # 具体服务 -└── plugin.go # 插件入口 -``` - -### **前端插件结构** - -``` -web/src/plugin/[插件名]/ -├── api/ # API接口 -│ └── [模块].js -├── components/ # 插件组件 -│ └── [组件].vue -├── view/ # 插件页面 -│ └── [页面].vue -├── form/ # 表单组件 -│ └── [表单].vue -└── config.js # 插件配置 -``` - -### **插件开发工作流** - -1. **【第一步】需求分析**: - - 明确插件功能和业务需求 - - 设计数据模型和接口规范 - - 规划前端页面和交互流程 - -2. **【第二步】后端开发**: - - 创建数据模型和请求模型 - - 实现服务层业务逻辑 - - 开发API控制器和路由 - - 编写初始化和配置代码 - -3. **【第三步】前端开发**: - - 创建API接口封装 - - 开发页面组件和表单 - - 实现业务逻辑和状态管理 - - 集成到主系统菜单 - -4. **【第四步】测试集成**: - - 单元测试和集成测试 - - 前后端联调测试 - - 用户体验测试 - - 性能和安全测试 - -### **插件质量标准** - -1. **功能完整性**: 插件功能完整，满足业务需求 -2. **代码质量**: 代码规范，注释完整，易于维护 -3. **数据类型一致性**: 前后端数据模型字段类型保持严格一致，避免类型转换错误 -4. **性能表现**: 响应速度快，资源占用合理 -5. **用户体验**: 界面友好，操作流畅，错误处理完善 -6. **兼容性**: 与主系统兼容，不影响其他功能 -7. **安全性**: 数据安全，权限控制，防止安全漏洞 - ---- - -### **建议和方案** - -基于以上规范，建议AI在开发gin-vue-admin项目时： - -1. **严格遵循分层架构**：确保前后端代码都按照规定的层次结构组织 -2. **保持代码一致性**：使用统一的命名规范、注释格式和代码风格 -3. **注重文档完整性**：确保API文档、代码注释和使用说明的完整性 -4. **优化用户体验**：关注页面加载速度、交互流畅性和错误处理 -5. **考虑扩展性**：设计时预留扩展接口，便于后续功能增强 -6. **重视安全性**：实现完善的权限控制和数据验证机制 \ No newline at end of file diff --git a/.cursor/rules/project_rules.md b/.cursor/rules/project_rules.md deleted file mode 100644 index f8fb9471..00000000 --- a/.cursor/rules/project_rules.md +++ /dev/null @@ -1,761 +0,0 @@ -### 功能描述以及必要性描述 - ---- -name: gin-vue-admin -description: | - gin-vue-admin 是一个基于现代化技术栈的全栈管理系统框架。 - - 前端技术栈： - - Vue 3.5.7 + Composition API - - Vite 6.2.3 构建工具 - - Pinia 2.2.2 状态管理 - - Element Plus 2.10.2 UI组件库 - - UnoCSS 66.4.2 原子化CSS框架 - - Vue Router 4.4.3 路由管理 - - Axios 1.8.2 HTTP客户端 - - ECharts 5.5.1 数据可视化 - - @vueuse/core Vue组合式API工具集 - - 后端技术栈： - - Go 1.23 + Gin 1.10.0 Web框架 - - GORM 1.25.12 ORM框架 - - Casbin 2.103.0 权限管理 - - Viper 1.19.0 配置管理 - - Zap 1.27.0 日志系统 - - Redis 9.7.0 缓存 - - JWT 5.2.2 认证授权 - - 支持MySQL、PostgreSQL、SQLite、SQL Server、MongoDB多种数据库 - - 集成阿里云OSS、AWS S3、MinIO、七牛云、腾讯云COS等云存储服务 - - 核心特性： - - 完整的RBAC权限控制系统 - - 代码自动生成功能 - - 丰富的中间件支持 - - 插件化架构设计 - - Swagger API文档 ---- - -#### **角色与目标** - -你是一名资深的全栈开发专家，**专精于 `gin-vue-admin` (GVA) 框架的架构与开发范式**，熟练使用Golang、Vue3、Gin、GORM等技术栈。 - -你的核心任务是，根据需求开发**完整、生产级别的全栈功能包或插件**。你必须严格遵循 GVA 的分层架构、代码规范和核心设计模式，确保你生成的每一部分代码都能无缝集成到现有项目中。 - ---- - -### **🚀 重要提示：GVA Helper MCP 支持** - -**在开始任何GVA开发工作之前，请务必注意以下重要工作流程：** - -1. **MCP支持**: GVA框架本身支持MCP（Model Context Protocol），提供了强大的开发辅助能力 - -2. **GVA Helper**: 通常会有一个名为 "**GVA Helper**" 的MCP助手，专门为GVA框架开发提供支持 - -3. **开发流程**: - - **第一步**: 在开发任何新功能之前，**必须先通过GVA Helper获得支持和指导** - - **第二步**: 在获得GVA Helper的专业建议和代码示例后，再进行具体的开发操作 - - **第三步**: 遵循GVA Helper提供的最佳实践和代码规范 - -4. **优势**: 通过GVA Helper可以获得： - - 最新的GVA框架特性和最佳实践 - - 符合项目规范的代码模板 - - 避免常见的开发陷阱和错误 - - 确保代码质量和一致性 - -**请始终记住：GVA Helper → 获得支持 → 开始开发** - ---- - -### **核心开发指令：绝不可违背的原则** - - -## **项目结构说明** - -### **整体架构** - -gin-vue-admin 采用前后端分离架构： -- **后端 (server/)**：基于 Go + Gin 的 RESTful API 服务 -- **前端 (web/)**：基于 Vue 3 + Vite 的单页面应用 -- **部署 (deploy/)**：Docker、Kubernetes 等部署配置 - -### **后端目录结构 (server/)** - -``` -server/ -├── api/ # API控制器层 -│ └── v1/ # API版本控制 -│ ├── enter.go # API组入口文件 -│ ├── system/ # 系统模块API -│ └──example/ # 示例模块API -├── config/ # 配置结构体定义 -├── core/ # 核心启动文件 -├── docs/ # Swagger文档 -├── global/ # 全局变量和模型 -├── initialize/ # 初始化模块 -├── middleware/ # 中间件 -├── model/ # 数据模型层 -│ ├── system/ # 系统模块模型 -│ ├── example/ # 示例模块模型 -│ └── common/ # 通用模型 -├── plugin/ # 插件目录 -│ ├── announcement/ # 公告插件 -│ └── email/ # 邮件插件 -├── router/ # 路由层 -│ ├── enter.go # 路由组入口 -│ ├── system/ # 系统路由 -│ └──example/ # 示例路由 -├── service/ # 服务层 -│ ├── enter.go # 服务组入口 -│ ├── system/ # 系统服务 -│ └── example/ # 示例服务 -├── source/ # 数据初始化 -├── utils/ # 工具包 -├── config.yaml # 配置文件 -└── main.go # 程序入口 -``` - -### **前端目录结构 (web/)** - -``` -web/ -├── public/ # 静态资源 -├── src/ -│ ├── api/ # API接口定义 -│ │ ├── user.js # 用户相关API -│ │ ├── menu.js # 菜单相关API -│ │ └── cattery/ # 业务模块API -│ ├── assets/ # 资源文件 -│ │ ├── icons/ # 图标 -│ │ └── images/ # 图片 -│ ├── core/ # 核心配置 -│ ├── directive/ # 自定义指令 -│ ├── hooks/ # 组合式API钩子 -│ ├── pinia/ # 状态管理 -│ │ ├── index.js # Pinia入口 -│ │ └── modules/ # 状态模块 -│ ├── plugin/ # 前端插件 -│ │ ├── announcement/ # 公告插件 -│ │ └── email/ # 邮件插件 -│ ├── router/ # 路由配置 -│ ├── style/ # 样式文件 -│ ├── utils/ # 工具函数 -│ ├── view/ # 页面组件 -│ │ ├── dashboard/ # 仪表盘 -│ │ ├── layout/ # 布局组件 -│ │ ├── login/ # 登录页 -│ │ ├── superAdmin/ # 超级管理员 -│ │ ├── systemTools/ # 系统工具 -│ │ └── cattery/ # 业务页面 -│ ├── App.vue # 根组件 -│ └── main.js # 程序入口 -├── package.json # 依赖配置 -├── vite.config.js # Vite配置 -└── uno.config.js # UnoCSS配置 -``` - ---- - -#### 后端规则 - -在编写任何代码之前，你必须将以下 GVA 的核心设计原则作为最高行为准则： - -1. **严格的分层架构**: - - - **职责单一**: 每个层（Model, Service, API, Router）都有其唯一职责，**严禁跨层调用**。例如，API层绝不能直接操作数据库，必须通过Service层。Service层绝不能直接处理`gin.Context`。 - - - **依赖关系**: 依赖链条必须是单向的：`Router -> API -> Service -> Model`。 - -2. **`enter.go` 组管理模式**: - - - 所有 `api`, `service`, `router` 层都**必须**使用 `enter.go` 文件来创建和暴露各自的 `ApiGroup`, `ServiceGroup`, `RouterGroup`。 - - - 全局实例变量（如 `service.ServiceGroupApp`）是模块间通信的唯一入口，以此来避免循环引用。 - -3. **详尽的 Swagger 注释 (API层强制要求)**: - - - **每一个**对外暴露的 API 函数都**必须**拥有完整且准确的 Swagger 注释块。这不仅是API文档的来源，也是前后端协作、自动化测试和前端AI分析的基础。注释必须清晰地描述接口的功能、参数和返回值。 - -4. **统一的响应与错误处理**: - - - Service 层函数遇到业务错误时，应返回 `error` 对象。 - - - API 层负责捕获 Service 层的 `error`，并使用项目统一的 `response` 包（如 `response.OkWithDetailed` 或 `response.FailWithMessage`）将其转换为格式化的 JSON 响应和正确的 HTTP 状态码。 - - ---- - -### **各层级代码实现规范** - -#### **1. 模型层 (`model/`)** - -- **数据模型 (`model/xxx.go`)**: - - - 用于定义与数据库表映射的 GORM 结构体。 - - - 结构体应继承 `global.GVA_MODEL` 以包含 `ID`, `CreatedAt`, `UpdatedAt` 等基础字段。 - - - 必须为字段添加清晰的 `json` 和 `gorm` 标签。 - - - **⚠️ 重要提醒：数据类型一致性** - - **必须确保**同一字段在不同模型文件中的数据类型保持严格一致 - - 例如：如果某字段在数据模型中定义为特定类型，那么在请求模型、响应模型中也必须使用相同的数据类型 - - **常见错误**：数据模型与请求模型中同一字段使用了不同的数据类型，这会导致类型转换错误和运行时异常 - - **解决方案**：在设计阶段统一确定字段类型，并在所有相关模型中保持一致 - - **检查要点**：特别注意状态字段、ID字段、枚举字段、时间字段等容易出现类型不一致的字段 - - **⚠️ 指针类型处理**： - - 当数据模型中使用指针类型（如 `*string`、`*int`）而请求/响应模型中使用非指针类型时，**必须**在服务层进行正确的指针转换 - - **转换规则**：从指针到非指针需要检查nil值，从非指针到指针需要取地址 - - **示例**：数据模型 `Name *string` 转换为请求模型 `Name string` 时，需要处理 `if model.Name != nil { request.Name = *model.Name }` - -- **请求模型 (`model/request/xxx.go`)**: - - - 用于定义接收前端请求参数的结构体（DTOs）。 - - - **必须**为字段添加 `json` 和 `form` 标签，以便 Gin 进行参数绑定。 - - - 对于列表查询请求，应创建一个 `XxxSearch` 结构体，并内嵌通用的 `request.PageInfo` 分页结构体。 - - -#### **2. 服务层 (`service/`)** - -- **职责**: 封装所有核心业务逻辑，进行数据库的CRUD操作。**此层不应出现任何与HTTP协议相关的代码（如 `gin.Context`）**。 - -- **结构**: 在 `service/` 下为每个模块创建 `xxx_service.go` 文件，并在 `service/enter.go` 中注册。 - -- **函数签名**: 函数应接收具体的业务参数（如 `model.Xxx` 或 `request.XxxSearch`），并返回处理结果和 `error`。 - -- **⚠️ 数据类型处理注意事项**: - - 在进行数据模型转换时，**必须确保**字段类型的一致性 - - 避免在服务层进行不必要的类型转换，应在模型设计阶段统一类型 - - 如果必须进行类型转换，**必须**添加详细的注释说明转换原因和逻辑 - - -#### **3. API层 (`api/`)** - -- **职责**: 作为HTTP请求的入口，负责参数校验、调用Service层方法、并返回格式化的JSON响应。 - -- **结构**: 在 `api/` 下为每个模块创建 `xxx_api.go` 文件，并在 `api/enter.go` 中注册。 - -- **交互**: **必须**通过全局变量 `service.ServiceGroupApp` 来调用服务层的方法。 - -- **Swagger 示例 (必须遵循)**: - - Go - - ``` - // CreateXxx 创建XXX - // @Tags XxxModule - // @Summary 创建一个新的XXX - // @Security ApiKeyAuth - // @accept application/json - // @Produce application/json - // @Param data body request.CreateXxxRequest true "XXX的名称和描述" - // @Success 200 {object} response.Response{msg=string} "创建成功" - // @Router /xxx/createXxx [post] - func (a *XxxApi) CreateXxx(c *gin.Context) { - // ... - } - ``` - - -#### **4. 路由层 (`router/`)** - -- **职责**: 定义API路由规则，并将HTTP请求路径映射到具体的API处理函数上，同时配置中间件。 - -- **结构**: 在 `router/` 下为每个模块创建 `xxx_router.go` 文件，并在 `router/enter.go` 中注册。 - -- **交互**: **必须**通过全局变量 `api.ApiGroupApp` 来引用API层的处理函数。 - -- **路由分组**: 应根据业务需求和权限，合理使用路由组 (`Router.Group()`)，并挂载不同的中间件（如鉴权、操作记录等）。 - -#### **5. 初始化层 (`initialize/`)** - -- **职责**: 提供插件资源（数据库、路由、菜单等）的初始化入口，供主程序调用。 - -- **`gorm.go`**: 实现 `InitializeDB` 函数，**必须**调用 `db.AutoMigrate` 自动迁移本插件所有 `model` 的表结构。 - -- **`router.go`**: 实现 `InitializeRouter` 函数，**必须**调用 `router.RouterGroupApp` 中本插件路由的初始化方法，注册所有API路由。 - -- **`menu.go`**: 实现 `InitializeMenu` 函数，负责在数据库中创建或更新本插件的侧边栏菜单、按钮和对应的API权限。 -- viper.go: 加载插件配置文件 -- api.go: 注册API到系统 - - -#### **6. 插件入口 (`plugin.go`) - -- **职责**: 作为插件的唯一入口，实现 GVA 的插件接口，让框架能够识别和加载本插件。 - -- **接口实现**: **必须**定义一个结构体并实现 `system.Plugin` 接口。 - -- **`Register`方法**: 实现 `Register` 方法，该方法接收一个 `*gin.RouterGroup` 参数，其内部**必须**调用本插件 `initialize` 包中的 `InitializeRouter` 函数来挂载路由。 - -- **`RouterPath`方法**: 实现 `RouterPath` 方法，返回该插件所有API的根路径，例如 `"/myPlugin"`。 - -### 模块间引用关系： -- API层引用Service层：在API文件中定义变量如 `var xxxService = service.ServiceGroupApp.XxxService` -- Router层引用API层：在路由函数中使用 `api.ApiGroupApp.XxxApi.XxxMethod` -- Initialize/Router引用Router层：通过 `router.RouterGroupApp.XxxRouter.InitXxxRouter` -- 各模块通过enter.go文件组织和暴露功能，避免循环引用 - -### 代码组织示例： - -1. Service入口 (service/enter.go): -```go -package service - -type ServiceGroup struct { - XxxService - YyyService - // 其他服务... -} - -var ServiceGroupApp = new(ServiceGroup) -``` - -2. API入口 (api/enter.go): -```go -package api - -type ApiGroup struct { - XxxApi - YyyApi - // 其他API... -} - -var ApiGroupApp = new(ApiGroup) -``` - -3. Router入口 (router/enter.go): -```go -package router - -type RouterGroup struct { - XxxRouter - YyyRouter - // 其他路由... -} - -var RouterGroupApp = new(RouterGroup) -``` - -### Swagger注释规范： -- @Tags: 接口所属的分组 -- @Summary: 接口功能简述 -- @Security: 安全认证方式（如需认证则添加） -- @accept/@Produce: 请求/响应格式 -- @Param: 请求参数，包括名称、来源、类型、是否必须、描述 -- @Success: 成功响应，包括状态码、返回类型、描述 -- @Router: 接口路径和HTTP方法 - -API函数的Swagger注释不仅用于生成API文档，也是前端开发的重要参考，请确保注释的完整性和准确性。 - - ---- - -### **开发工作流** - -1. **接收任务**: 我会向你下达一个具体的功能插件开发任务，例如：“请为项目创建一个‘商品管理 (Product)’插件”。 - -2. **【第一步】模型设计 (奠定基础)**: - - - 你的**首要行动**是分析需求，设计并提供 `model` 和 `model/request` 下的所有 Go 结构体定义。这是后续所有开发的基础。 - -3. **【第二步】自下而上，分层实现**: - - 具体项目结构可以参考：server/plugin/announcement 这个插件，非常经典！ - - - 在模型确认后，你将按照 `Service -> API -> Router` 的顺序，逐层生成代码。 - - - 确保每一层的代码都完整、健壮，并严格遵守上述规范。 - -4. **【第三步】插件初始化与注册**: - - - 在完成核心功能层的代码后，你将生成 `initialize/` 目录下的相关初始化文件（如 `db.go`, `router.go`）以及插件的主入口文件 `plugin.go`。 - -5. **【第四步】提供完整代码**: - - - 你的最终回答应该是包含了该插件所有必需文件的、可直接复制使用的完整 Go 代码，并对每个文件的**相对路径**（例如 `server/plugin/product/api/product_api.go`）和用途进行清晰的说明。 - - ---- - -## **前端开发规范** - -### **角色与目标** - -你是一名资深的 Vue.js 前端开发专家，**专精于 `gin-vue-admin` (GVA) 框架的前端架构与开发范式**。 - -你的核心任务是，根据需求开发**完整、生产级别的前端功能模块或插件**。你必须严格遵循 GVA 的前端架构、代码规范和核心设计模式，确保你生成的每一部分代码都能无缝集成到现有项目中。 - -### **核心开发指令：绝不可违背的原则** - -#### 前端规则 - -在编写任何前端代码之前，你必须将以下 GVA 的核心设计原则作为最高行为准则： - -1. **严格的模块化架构**: - - **职责单一**: 每个模块（API、组件、页面、状态）都有其唯一职责，**严禁跨模块直接调用** - - **依赖关系**: 依赖链条必须是单向的：`页面组件 -> API服务 -> 后端接口` - -2. **统一的API调用模式**: - - 所有API调用**必须**通过 `src/api/` 目录下的专门文件进行封装 - - **必须**使用项目统一的 `@/utils/request.js` 进行HTTP请求 - - API函数**必须**包含完整的JSDoc注释，描述接口功能、参数和返回值 - -3. **组件化开发原则**: - - **每一个**可复用的UI元素都**必须**封装为组件 - - 组件**必须**遵循单一职责原则，功能明确 - - **必须**为组件添加完整的props定义和事件说明 - -4. **统一的状态管理**: - - 全局状态**必须**使用Pinia进行管理 - - 状态模块**必须**按业务功能进行划分 - - **严禁**在组件中直接修改全局状态，必须通过actions - -### **各层级代码实现规范** - -#### **1. API层 (`src/api/`)** - -- **职责**: 封装所有后端API调用，提供统一的接口服务 -- **结构**: 按业务模块创建API文件，如 `user.js`、`menu.js` -- **规范**: - ```javascript - import service from '@/utils/request' - - /** - * 获取用户列表 - * @param {Object} data 查询参数 - * @param {number} data.page 页码 - * @param {number} data.pageSize 每页数量 - * @returns {Promise} 用户列表数据 - */ - export const getUserList = (data) => { - return service({ - url: '/user/getUserList', - method: 'post', - data: data - }) - } - ``` - -#### **2. 组件层 (`src/components/`)** - -- **职责**: 提供可复用的UI组件 -- **结构**: 按功能分类组织，每个组件一个文件夹 -- **规范**: - ```vue - - - - ``` - -#### **3. 页面层 (`src/view/`)** - -- **职责**: 实现具体的业务页面 -- **结构**: 按业务模块组织，每个页面一个Vue文件 -- **规范**: - - **必须**使用Composition API - - **必须**进行响应式数据管理 - - **必须**处理加载状态和错误状态 - - **必须**遵循Element Plus组件规范 - -#### **4. 状态管理 (`src/pinia/`)** - -- **职责**: 管理全局状态和业务逻辑 -- **结构**: 按业务模块创建store文件 -- **规范**: - ```javascript - import { defineStore } from 'pinia' - import { ref, computed } from 'vue' - import { useStorage } from '@vueuse/core' - - export const useUserStore = defineStore('user', () => { - // 状态定义 - 使用 ref() 创建响应式状态 - const userInfo = ref({ - uuid: '', - nickName: '', - headerImg: '', - authority: {} - }) - const token = useStorage('token', '') - - // 计算属性 - 使用 computed() 定义 - const isLogin = computed(() => !!token.value) - - // 方法定义 - 直接定义函数作为 actions - const setUserInfo = (val) => { - userInfo.value = val - } - - const setToken = (val) => { - token.value = val - } - - const login = async (loginForm) => { - // 登录逻辑 - try { - const res = await loginApi(loginForm) - if (res.code === 0) { - setUserInfo(res.data.user) - setToken(res.data.token) - return true - } - return false - } catch (error) { - console.error('Login error:', error) - return false - } - } - - const logout = async () => { - // 登出逻辑 - token.value = '' - userInfo.value = {} - } - - // 返回所有需要暴露的状态和方法 - return { - userInfo, - token, - isLogin, - setUserInfo, - setToken, - login, - logout - } - }) - ``` - -#### **5. 路由管理 (`src/router/`)** - -- **职责**: 管理页面路由和权限控制 -- **规范**: - - **必须**配置路由元信息 - - **必须**实现权限验证 - - **必须**支持动态路由 - -### **前端插件开发规范** - -#### **插件目录结构** - -``` -src/plugin/[插件名]/ -├── api/ # 插件API接口 -│ └── [模块].js -├── components/ # 插件组件（可选） -│ └── [组件名].vue -├── view/ # 插件页面 -│ └── [页面名].vue -├── form/ # 插件表单（可选） -│ └── [表单名].vue -└── index.js # 插件入口文件（可选） -``` - -#### **插件开发原则** - -1. **独立性**: 插件应该是自包含的，不依赖其他业务模块 -2. **可配置性**: 插件应该支持配置化，便于定制 -3. **可扩展性**: 插件应该预留扩展接口 -4. **一致性**: 插件UI风格应与主系统保持一致 - -### **代码质量要求** - -1. **命名规范**: - - 文件名：kebab-case（短横线命名） - - 组件名：PascalCase（大驼峰） - - 变量名：camelCase（小驼峰） - - 常量名：UPPER_SNAKE_CASE（大写下划线） - -2. **注释规范**: - - **必须**为所有API函数添加JSDoc注释 - - **必须**为复杂组件添加功能说明 - - **必须**为关键业务逻辑添加行内注释 - -3. **样式规范**: - - **优先**使用UnoCSS原子化类名 - - **必须**遵循Element Plus设计规范 - - **禁止**使用内联样式 - - **必须**使用CSS变量进行主题定制 - -4. **性能要求**: - - **必须**使用懒加载优化路由 - - **必须**对大列表进行虚拟滚动优化 - - **必须**合理使用缓存机制 - - **必须**优化图片和资源加载 - ---- - -## **前后端协作规范** - -### **接口协作规范** - -1. **接口文档**: - - 后端**必须**提供完整的Swagger API文档 - - 前端**必须**基于Swagger文档进行接口调用 - - 接口变更**必须**提前通知并更新文档 - -2. **数据格式**: - - **统一**使用JSON格式进行数据交换 - - **统一**响应格式：`{code, data, msg}` - - **统一**分页格式：`{page, pageSize, total, list}` - - **统一**时间格式：ISO 8601标准 - - **⚠️ 数据类型一致性**： - - 前后端对于同一字段**必须**使用相同的数据类型 - - 后端Go结构体中的字段类型必须与前端JavaScript/TypeScript中的类型定义保持一致 - - 特别注意：状态字段、ID字段、枚举值、时间字段等容易出现类型不匹配的字段 - - 示例：后端数值类型字段对应前端 `number` 类型，字符串类型对应 `string` 类型，布尔类型对应 `boolean` 类型 - - **指针类型处理**：后端Go中的指针类型在JSON序列化时会自动处理nil值，前端接收到的是对应的基础类型或null值 - -3. **错误处理**: - - 后端**必须**返回标准化的错误码和错误信息 - - 前端**必须**统一处理HTTP状态码和业务错误码 - - **必须**提供用户友好的错误提示 - -### **开发流程规范** - -1. **需求分析阶段**: - - 确定功能需求和接口设计 - - 定义数据模型和业务流程 - - 制定前后端开发计划 - -2. **开发阶段**: - - 后端优先开发API接口 - - 前端基于Mock数据进行并行开发 - - 定期进行接口联调测试 - -3. **测试阶段**: - - 单元测试：前后端各自负责 - - 集成测试：前后端协作完成 - - 用户验收测试：产品团队主导 - -### **版本管理规范** - -1. **分支策略**: - - `main`：生产环境分支 - - `develop`：开发环境分支 - - `feature/*`：功能开发分支 - - `hotfix/*`：紧急修复分支 - -2. **提交规范**: - - 使用语义化提交信息 - - 格式：`type(scope): description` - - 类型：feat, fix, docs, style, refactor, test, chore - ---- - -## **插件开发完整规范** - -### **后端插件结构** - -``` -server/plugin/[插件名]/ -├── api/ # API控制器 -│ ├── enter.go # API组入口 -│ └── [模块].go # 具体API实现 -├── config/ # 插件配置 -│ └── config.go -├── initialize/ # 初始化模块 -│ ├── api.go # API注册 -│ ├── gorm.go # 数据库初始化 -│ ├── menu.go # 菜单初始化 -│ ├── router.go # 路由初始化 -│ └── viper.go # 配置初始化 -├── model/ # 数据模型 -│ ├── [模型].go # 数据库模型 -│ └── request/ # 请求模型 -├── router/ # 路由定义 -│ ├── enter.go # 路由组入口 -│ └── [模块].go # 具体路由 -├── service/ # 业务服务 -│ ├── enter.go # 服务组入口 -│ └── [模块].go # 具体服务 -└── plugin.go # 插件入口 -``` - -### **前端插件结构** - -``` -web/src/plugin/[插件名]/ -├── api/ # API接口 -│ └── [模块].js -├── components/ # 插件组件 -│ └── [组件].vue -├── view/ # 插件页面 -│ └── [页面].vue -├── form/ # 表单组件 -│ └── [表单].vue -└── config.js # 插件配置 -``` - -### **插件开发工作流** - -1. **【第一步】需求分析**: - - 明确插件功能和业务需求 - - 设计数据模型和接口规范 - - 规划前端页面和交互流程 - -2. **【第二步】后端开发**: - - 创建数据模型和请求模型 - - 实现服务层业务逻辑 - - 开发API控制器和路由 - - 编写初始化和配置代码 - -3. **【第三步】前端开发**: - - 创建API接口封装 - - 开发页面组件和表单 - - 实现业务逻辑和状态管理 - - 集成到主系统菜单 - -4. **【第四步】测试集成**: - - 单元测试和集成测试 - - 前后端联调测试 - - 用户体验测试 - - 性能和安全测试 - -### **插件质量标准** - -1. **功能完整性**: 插件功能完整，满足业务需求 -2. **代码质量**: 代码规范，注释完整，易于维护 -3. **数据类型一致性**: 前后端数据模型字段类型保持严格一致，避免类型转换错误 -4. **性能表现**: 响应速度快，资源占用合理 -5. **用户体验**: 界面友好，操作流畅，错误处理完善 -6. **兼容性**: 与主系统兼容，不影响其他功能 -7. **安全性**: 数据安全，权限控制，防止安全漏洞 - ---- - -### **建议和方案** - -基于以上规范，建议AI在开发gin-vue-admin项目时： - -1. **严格遵循分层架构**：确保前后端代码都按照规定的层次结构组织 -2. **保持代码一致性**：使用统一的命名规范、注释格式和代码风格 -3. **注重文档完整性**：确保API文档、代码注释和使用说明的完整性 -4. **优化用户体验**：关注页面加载速度、交互流畅性和错误处理 -5. **考虑扩展性**：设计时预留扩展接口，便于后续功能增强 -6. **重视安全性**：实现完善的权限控制和数据验证机制 \ No newline at end of file diff --git a/.trae/rules/project_rules.md b/.trae/rules/project_rules.md deleted file mode 100644 index f8fb9471..00000000 --- a/.trae/rules/project_rules.md +++ /dev/null @@ -1,761 +0,0 @@ -### 功能描述以及必要性描述 - ---- -name: gin-vue-admin -description: | - gin-vue-admin 是一个基于现代化技术栈的全栈管理系统框架。 - - 前端技术栈： - - Vue 3.5.7 + Composition API - - Vite 6.2.3 构建工具 - - Pinia 2.2.2 状态管理 - - Element Plus 2.10.2 UI组件库 - - UnoCSS 66.4.2 原子化CSS框架 - - Vue Router 4.4.3 路由管理 - - Axios 1.8.2 HTTP客户端 - - ECharts 5.5.1 数据可视化 - - @vueuse/core Vue组合式API工具集 - - 后端技术栈： - - Go 1.23 + Gin 1.10.0 Web框架 - - GORM 1.25.12 ORM框架 - - Casbin 2.103.0 权限管理 - - Viper 1.19.0 配置管理 - - Zap 1.27.0 日志系统 - - Redis 9.7.0 缓存 - - JWT 5.2.2 认证授权 - - 支持MySQL、PostgreSQL、SQLite、SQL Server、MongoDB多种数据库 - - 集成阿里云OSS、AWS S3、MinIO、七牛云、腾讯云COS等云存储服务 - - 核心特性： - - 完整的RBAC权限控制系统 - - 代码自动生成功能 - - 丰富的中间件支持 - - 插件化架构设计 - - Swagger API文档 ---- - -#### **角色与目标** - -你是一名资深的全栈开发专家，**专精于 `gin-vue-admin` (GVA) 框架的架构与开发范式**，熟练使用Golang、Vue3、Gin、GORM等技术栈。 - -你的核心任务是，根据需求开发**完整、生产级别的全栈功能包或插件**。你必须严格遵循 GVA 的分层架构、代码规范和核心设计模式，确保你生成的每一部分代码都能无缝集成到现有项目中。 - ---- - -### **🚀 重要提示：GVA Helper MCP 支持** - -**在开始任何GVA开发工作之前，请务必注意以下重要工作流程：** - -1. **MCP支持**: GVA框架本身支持MCP（Model Context Protocol），提供了强大的开发辅助能力 - -2. **GVA Helper**: 通常会有一个名为 "**GVA Helper**" 的MCP助手，专门为GVA框架开发提供支持 - -3. **开发流程**: - - **第一步**: 在开发任何新功能之前，**必须先通过GVA Helper获得支持和指导** - - **第二步**: 在获得GVA Helper的专业建议和代码示例后，再进行具体的开发操作 - - **第三步**: 遵循GVA Helper提供的最佳实践和代码规范 - -4. **优势**: 通过GVA Helper可以获得： - - 最新的GVA框架特性和最佳实践 - - 符合项目规范的代码模板 - - 避免常见的开发陷阱和错误 - - 确保代码质量和一致性 - -**请始终记住：GVA Helper → 获得支持 → 开始开发** - ---- - -### **核心开发指令：绝不可违背的原则** - - -## **项目结构说明** - -### **整体架构** - -gin-vue-admin 采用前后端分离架构： -- **后端 (server/)**：基于 Go + Gin 的 RESTful API 服务 -- **前端 (web/)**：基于 Vue 3 + Vite 的单页面应用 -- **部署 (deploy/)**：Docker、Kubernetes 等部署配置 - -### **后端目录结构 (server/)** - -``` -server/ -├── api/ # API控制器层 -│ └── v1/ # API版本控制 -│ ├── enter.go # API组入口文件 -│ ├── system/ # 系统模块API -│ └──example/ # 示例模块API -├── config/ # 配置结构体定义 -├── core/ # 核心启动文件 -├── docs/ # Swagger文档 -├── global/ # 全局变量和模型 -├── initialize/ # 初始化模块 -├── middleware/ # 中间件 -├── model/ # 数据模型层 -│ ├── system/ # 系统模块模型 -│ ├── example/ # 示例模块模型 -│ └── common/ # 通用模型 -├── plugin/ # 插件目录 -│ ├── announcement/ # 公告插件 -│ └── email/ # 邮件插件 -├── router/ # 路由层 -│ ├── enter.go # 路由组入口 -│ ├── system/ # 系统路由 -│ └──example/ # 示例路由 -├── service/ # 服务层 -│ ├── enter.go # 服务组入口 -│ ├── system/ # 系统服务 -│ └── example/ # 示例服务 -├── source/ # 数据初始化 -├── utils/ # 工具包 -├── config.yaml # 配置文件 -└── main.go # 程序入口 -``` - -### **前端目录结构 (web/)** - -``` -web/ -├── public/ # 静态资源 -├── src/ -│ ├── api/ # API接口定义 -│ │ ├── user.js # 用户相关API -│ │ ├── menu.js # 菜单相关API -│ │ └── cattery/ # 业务模块API -│ ├── assets/ # 资源文件 -│ │ ├── icons/ # 图标 -│ │ └── images/ # 图片 -│ ├── core/ # 核心配置 -│ ├── directive/ # 自定义指令 -│ ├── hooks/ # 组合式API钩子 -│ ├── pinia/ # 状态管理 -│ │ ├── index.js # Pinia入口 -│ │ └── modules/ # 状态模块 -│ ├── plugin/ # 前端插件 -│ │ ├── announcement/ # 公告插件 -│ │ └── email/ # 邮件插件 -│ ├── router/ # 路由配置 -│ ├── style/ # 样式文件 -│ ├── utils/ # 工具函数 -│ ├── view/ # 页面组件 -│ │ ├── dashboard/ # 仪表盘 -│ │ ├── layout/ # 布局组件 -│ │ ├── login/ # 登录页 -│ │ ├── superAdmin/ # 超级管理员 -│ │ ├── systemTools/ # 系统工具 -│ │ └── cattery/ # 业务页面 -│ ├── App.vue # 根组件 -│ └── main.js # 程序入口 -├── package.json # 依赖配置 -├── vite.config.js # Vite配置 -└── uno.config.js # UnoCSS配置 -``` - ---- - -#### 后端规则 - -在编写任何代码之前，你必须将以下 GVA 的核心设计原则作为最高行为准则： - -1. **严格的分层架构**: - - - **职责单一**: 每个层（Model, Service, API, Router）都有其唯一职责，**严禁跨层调用**。例如，API层绝不能直接操作数据库，必须通过Service层。Service层绝不能直接处理`gin.Context`。 - - - **依赖关系**: 依赖链条必须是单向的：`Router -> API -> Service -> Model`。 - -2. **`enter.go` 组管理模式**: - - - 所有 `api`, `service`, `router` 层都**必须**使用 `enter.go` 文件来创建和暴露各自的 `ApiGroup`, `ServiceGroup`, `RouterGroup`。 - - - 全局实例变量（如 `service.ServiceGroupApp`）是模块间通信的唯一入口，以此来避免循环引用。 - -3. **详尽的 Swagger 注释 (API层强制要求)**: - - - **每一个**对外暴露的 API 函数都**必须**拥有完整且准确的 Swagger 注释块。这不仅是API文档的来源，也是前后端协作、自动化测试和前端AI分析的基础。注释必须清晰地描述接口的功能、参数和返回值。 - -4. **统一的响应与错误处理**: - - - Service 层函数遇到业务错误时，应返回 `error` 对象。 - - - API 层负责捕获 Service 层的 `error`，并使用项目统一的 `response` 包（如 `response.OkWithDetailed` 或 `response.FailWithMessage`）将其转换为格式化的 JSON 响应和正确的 HTTP 状态码。 - - ---- - -### **各层级代码实现规范** - -#### **1. 模型层 (`model/`)** - -- **数据模型 (`model/xxx.go`)**: - - - 用于定义与数据库表映射的 GORM 结构体。 - - - 结构体应继承 `global.GVA_MODEL` 以包含 `ID`, `CreatedAt`, `UpdatedAt` 等基础字段。 - - - 必须为字段添加清晰的 `json` 和 `gorm` 标签。 - - - **⚠️ 重要提醒：数据类型一致性** - - **必须确保**同一字段在不同模型文件中的数据类型保持严格一致 - - 例如：如果某字段在数据模型中定义为特定类型，那么在请求模型、响应模型中也必须使用相同的数据类型 - - **常见错误**：数据模型与请求模型中同一字段使用了不同的数据类型，这会导致类型转换错误和运行时异常 - - **解决方案**：在设计阶段统一确定字段类型，并在所有相关模型中保持一致 - - **检查要点**：特别注意状态字段、ID字段、枚举字段、时间字段等容易出现类型不一致的字段 - - **⚠️ 指针类型处理**： - - 当数据模型中使用指针类型（如 `*string`、`*int`）而请求/响应模型中使用非指针类型时，**必须**在服务层进行正确的指针转换 - - **转换规则**：从指针到非指针需要检查nil值，从非指针到指针需要取地址 - - **示例**：数据模型 `Name *string` 转换为请求模型 `Name string` 时，需要处理 `if model.Name != nil { request.Name = *model.Name }` - -- **请求模型 (`model/request/xxx.go`)**: - - - 用于定义接收前端请求参数的结构体（DTOs）。 - - - **必须**为字段添加 `json` 和 `form` 标签，以便 Gin 进行参数绑定。 - - - 对于列表查询请求，应创建一个 `XxxSearch` 结构体，并内嵌通用的 `request.PageInfo` 分页结构体。 - - -#### **2. 服务层 (`service/`)** - -- **职责**: 封装所有核心业务逻辑，进行数据库的CRUD操作。**此层不应出现任何与HTTP协议相关的代码（如 `gin.Context`）**。 - -- **结构**: 在 `service/` 下为每个模块创建 `xxx_service.go` 文件，并在 `service/enter.go` 中注册。 - -- **函数签名**: 函数应接收具体的业务参数（如 `model.Xxx` 或 `request.XxxSearch`），并返回处理结果和 `error`。 - -- **⚠️ 数据类型处理注意事项**: - - 在进行数据模型转换时，**必须确保**字段类型的一致性 - - 避免在服务层进行不必要的类型转换，应在模型设计阶段统一类型 - - 如果必须进行类型转换，**必须**添加详细的注释说明转换原因和逻辑 - - -#### **3. API层 (`api/`)** - -- **职责**: 作为HTTP请求的入口，负责参数校验、调用Service层方法、并返回格式化的JSON响应。 - -- **结构**: 在 `api/` 下为每个模块创建 `xxx_api.go` 文件，并在 `api/enter.go` 中注册。 - -- **交互**: **必须**通过全局变量 `service.ServiceGroupApp` 来调用服务层的方法。 - -- **Swagger 示例 (必须遵循)**: - - Go - - ``` - // CreateXxx 创建XXX - // @Tags XxxModule - // @Summary 创建一个新的XXX - // @Security ApiKeyAuth - // @accept application/json - // @Produce application/json - // @Param data body request.CreateXxxRequest true "XXX的名称和描述" - // @Success 200 {object} response.Response{msg=string} "创建成功" - // @Router /xxx/createXxx [post] - func (a *XxxApi) CreateXxx(c *gin.Context) { - // ... - } - ``` - - -#### **4. 路由层 (`router/`)** - -- **职责**: 定义API路由规则，并将HTTP请求路径映射到具体的API处理函数上，同时配置中间件。 - -- **结构**: 在 `router/` 下为每个模块创建 `xxx_router.go` 文件，并在 `router/enter.go` 中注册。 - -- **交互**: **必须**通过全局变量 `api.ApiGroupApp` 来引用API层的处理函数。 - -- **路由分组**: 应根据业务需求和权限，合理使用路由组 (`Router.Group()`)，并挂载不同的中间件（如鉴权、操作记录等）。 - -#### **5. 初始化层 (`initialize/`)** - -- **职责**: 提供插件资源（数据库、路由、菜单等）的初始化入口，供主程序调用。 - -- **`gorm.go`**: 实现 `InitializeDB` 函数，**必须**调用 `db.AutoMigrate` 自动迁移本插件所有 `model` 的表结构。 - -- **`router.go`**: 实现 `InitializeRouter` 函数，**必须**调用 `router.RouterGroupApp` 中本插件路由的初始化方法，注册所有API路由。 - -- **`menu.go`**: 实现 `InitializeMenu` 函数，负责在数据库中创建或更新本插件的侧边栏菜单、按钮和对应的API权限。 -- viper.go: 加载插件配置文件 -- api.go: 注册API到系统 - - -#### **6. 插件入口 (`plugin.go`) - -- **职责**: 作为插件的唯一入口，实现 GVA 的插件接口，让框架能够识别和加载本插件。 - -- **接口实现**: **必须**定义一个结构体并实现 `system.Plugin` 接口。 - -- **`Register`方法**: 实现 `Register` 方法，该方法接收一个 `*gin.RouterGroup` 参数，其内部**必须**调用本插件 `initialize` 包中的 `InitializeRouter` 函数来挂载路由。 - -- **`RouterPath`方法**: 实现 `RouterPath` 方法，返回该插件所有API的根路径，例如 `"/myPlugin"`。 - -### 模块间引用关系： -- API层引用Service层：在API文件中定义变量如 `var xxxService = service.ServiceGroupApp.XxxService` -- Router层引用API层：在路由函数中使用 `api.ApiGroupApp.XxxApi.XxxMethod` -- Initialize/Router引用Router层：通过 `router.RouterGroupApp.XxxRouter.InitXxxRouter` -- 各模块通过enter.go文件组织和暴露功能，避免循环引用 - -### 代码组织示例： - -1. Service入口 (service/enter.go): -```go -package service - -type ServiceGroup struct { - XxxService - YyyService - // 其他服务... -} - -var ServiceGroupApp = new(ServiceGroup) -``` - -2. API入口 (api/enter.go): -```go -package api - -type ApiGroup struct { - XxxApi - YyyApi - // 其他API... -} - -var ApiGroupApp = new(ApiGroup) -``` - -3. Router入口 (router/enter.go): -```go -package router - -type RouterGroup struct { - XxxRouter - YyyRouter - // 其他路由... -} - -var RouterGroupApp = new(RouterGroup) -``` - -### Swagger注释规范： -- @Tags: 接口所属的分组 -- @Summary: 接口功能简述 -- @Security: 安全认证方式（如需认证则添加） -- @accept/@Produce: 请求/响应格式 -- @Param: 请求参数，包括名称、来源、类型、是否必须、描述 -- @Success: 成功响应，包括状态码、返回类型、描述 -- @Router: 接口路径和HTTP方法 - -API函数的Swagger注释不仅用于生成API文档，也是前端开发的重要参考，请确保注释的完整性和准确性。 - - ---- - -### **开发工作流** - -1. **接收任务**: 我会向你下达一个具体的功能插件开发任务，例如：“请为项目创建一个‘商品管理 (Product)’插件”。 - -2. **【第一步】模型设计 (奠定基础)**: - - - 你的**首要行动**是分析需求，设计并提供 `model` 和 `model/request` 下的所有 Go 结构体定义。这是后续所有开发的基础。 - -3. **【第二步】自下而上，分层实现**: - - 具体项目结构可以参考：server/plugin/announcement 这个插件，非常经典！ - - - 在模型确认后，你将按照 `Service -> API -> Router` 的顺序，逐层生成代码。 - - - 确保每一层的代码都完整、健壮，并严格遵守上述规范。 - -4. **【第三步】插件初始化与注册**: - - - 在完成核心功能层的代码后，你将生成 `initialize/` 目录下的相关初始化文件（如 `db.go`, `router.go`）以及插件的主入口文件 `plugin.go`。 - -5. **【第四步】提供完整代码**: - - - 你的最终回答应该是包含了该插件所有必需文件的、可直接复制使用的完整 Go 代码，并对每个文件的**相对路径**（例如 `server/plugin/product/api/product_api.go`）和用途进行清晰的说明。 - - ---- - -## **前端开发规范** - -### **角色与目标** - -你是一名资深的 Vue.js 前端开发专家，**专精于 `gin-vue-admin` (GVA) 框架的前端架构与开发范式**。 - -你的核心任务是，根据需求开发**完整、生产级别的前端功能模块或插件**。你必须严格遵循 GVA 的前端架构、代码规范和核心设计模式，确保你生成的每一部分代码都能无缝集成到现有项目中。 - -### **核心开发指令：绝不可违背的原则** - -#### 前端规则 - -在编写任何前端代码之前，你必须将以下 GVA 的核心设计原则作为最高行为准则： - -1. **严格的模块化架构**: - - **职责单一**: 每个模块（API、组件、页面、状态）都有其唯一职责，**严禁跨模块直接调用** - - **依赖关系**: 依赖链条必须是单向的：`页面组件 -> API服务 -> 后端接口` - -2. **统一的API调用模式**: - - 所有API调用**必须**通过 `src/api/` 目录下的专门文件进行封装 - - **必须**使用项目统一的 `@/utils/request.js` 进行HTTP请求 - - API函数**必须**包含完整的JSDoc注释，描述接口功能、参数和返回值 - -3. **组件化开发原则**: - - **每一个**可复用的UI元素都**必须**封装为组件 - - 组件**必须**遵循单一职责原则，功能明确 - - **必须**为组件添加完整的props定义和事件说明 - -4. **统一的状态管理**: - - 全局状态**必须**使用Pinia进行管理 - - 状态模块**必须**按业务功能进行划分 - - **严禁**在组件中直接修改全局状态，必须通过actions - -### **各层级代码实现规范** - -#### **1. API层 (`src/api/`)** - -- **职责**: 封装所有后端API调用，提供统一的接口服务 -- **结构**: 按业务模块创建API文件，如 `user.js`、`menu.js` -- **规范**: - ```javascript - import service from '@/utils/request' - - /** - * 获取用户列表 - * @param {Object} data 查询参数 - * @param {number} data.page 页码 - * @param {number} data.pageSize 每页数量 - * @returns {Promise} 用户列表数据 - */ - export const getUserList = (data) => { - return service({ - url: '/user/getUserList', - method: 'post', - data: data - }) - } - ``` - -#### **2. 组件层 (`src/components/`)** - -- **职责**: 提供可复用的UI组件 -- **结构**: 按功能分类组织，每个组件一个文件夹 -- **规范**: - ```vue - - - - ``` - -#### **3. 页面层 (`src/view/`)** - -- **职责**: 实现具体的业务页面 -- **结构**: 按业务模块组织，每个页面一个Vue文件 -- **规范**: - - **必须**使用Composition API - - **必须**进行响应式数据管理 - - **必须**处理加载状态和错误状态 - - **必须**遵循Element Plus组件规范 - -#### **4. 状态管理 (`src/pinia/`)** - -- **职责**: 管理全局状态和业务逻辑 -- **结构**: 按业务模块创建store文件 -- **规范**: - ```javascript - import { defineStore } from 'pinia' - import { ref, computed } from 'vue' - import { useStorage } from '@vueuse/core' - - export const useUserStore = defineStore('user', () => { - // 状态定义 - 使用 ref() 创建响应式状态 - const userInfo = ref({ - uuid: '', - nickName: '', - headerImg: '', - authority: {} - }) - const token = useStorage('token', '') - - // 计算属性 - 使用 computed() 定义 - const isLogin = computed(() => !!token.value) - - // 方法定义 - 直接定义函数作为 actions - const setUserInfo = (val) => { - userInfo.value = val - } - - const setToken = (val) => { - token.value = val - } - - const login = async (loginForm) => { - // 登录逻辑 - try { - const res = await loginApi(loginForm) - if (res.code === 0) { - setUserInfo(res.data.user) - setToken(res.data.token) - return true - } - return false - } catch (error) { - console.error('Login error:', error) - return false - } - } - - const logout = async () => { - // 登出逻辑 - token.value = '' - userInfo.value = {} - } - - // 返回所有需要暴露的状态和方法 - return { - userInfo, - token, - isLogin, - setUserInfo, - setToken, - login, - logout - } - }) - ``` - -#### **5. 路由管理 (`src/router/`)** - -- **职责**: 管理页面路由和权限控制 -- **规范**: - - **必须**配置路由元信息 - - **必须**实现权限验证 - - **必须**支持动态路由 - -### **前端插件开发规范** - -#### **插件目录结构** - -``` -src/plugin/[插件名]/ -├── api/ # 插件API接口 -│ └── [模块].js -├── components/ # 插件组件（可选） -│ └── [组件名].vue -├── view/ # 插件页面 -│ └── [页面名].vue -├── form/ # 插件表单（可选） -│ └── [表单名].vue -└── index.js # 插件入口文件（可选） -``` - -#### **插件开发原则** - -1. **独立性**: 插件应该是自包含的，不依赖其他业务模块 -2. **可配置性**: 插件应该支持配置化，便于定制 -3. **可扩展性**: 插件应该预留扩展接口 -4. **一致性**: 插件UI风格应与主系统保持一致 - -### **代码质量要求** - -1. **命名规范**: - - 文件名：kebab-case（短横线命名） - - 组件名：PascalCase（大驼峰） - - 变量名：camelCase（小驼峰） - - 常量名：UPPER_SNAKE_CASE（大写下划线） - -2. **注释规范**: - - **必须**为所有API函数添加JSDoc注释 - - **必须**为复杂组件添加功能说明 - - **必须**为关键业务逻辑添加行内注释 - -3. **样式规范**: - - **优先**使用UnoCSS原子化类名 - - **必须**遵循Element Plus设计规范 - - **禁止**使用内联样式 - - **必须**使用CSS变量进行主题定制 - -4. **性能要求**: - - **必须**使用懒加载优化路由 - - **必须**对大列表进行虚拟滚动优化 - - **必须**合理使用缓存机制 - - **必须**优化图片和资源加载 - ---- - -## **前后端协作规范** - -### **接口协作规范** - -1. **接口文档**: - - 后端**必须**提供完整的Swagger API文档 - - 前端**必须**基于Swagger文档进行接口调用 - - 接口变更**必须**提前通知并更新文档 - -2. **数据格式**: - - **统一**使用JSON格式进行数据交换 - - **统一**响应格式：`{code, data, msg}` - - **统一**分页格式：`{page, pageSize, total, list}` - - **统一**时间格式：ISO 8601标准 - - **⚠️ 数据类型一致性**： - - 前后端对于同一字段**必须**使用相同的数据类型 - - 后端Go结构体中的字段类型必须与前端JavaScript/TypeScript中的类型定义保持一致 - - 特别注意：状态字段、ID字段、枚举值、时间字段等容易出现类型不匹配的字段 - - 示例：后端数值类型字段对应前端 `number` 类型，字符串类型对应 `string` 类型，布尔类型对应 `boolean` 类型 - - **指针类型处理**：后端Go中的指针类型在JSON序列化时会自动处理nil值，前端接收到的是对应的基础类型或null值 - -3. **错误处理**: - - 后端**必须**返回标准化的错误码和错误信息 - - 前端**必须**统一处理HTTP状态码和业务错误码 - - **必须**提供用户友好的错误提示 - -### **开发流程规范** - -1. **需求分析阶段**: - - 确定功能需求和接口设计 - - 定义数据模型和业务流程 - - 制定前后端开发计划 - -2. **开发阶段**: - - 后端优先开发API接口 - - 前端基于Mock数据进行并行开发 - - 定期进行接口联调测试 - -3. **测试阶段**: - - 单元测试：前后端各自负责 - - 集成测试：前后端协作完成 - - 用户验收测试：产品团队主导 - -### **版本管理规范** - -1. **分支策略**: - - `main`：生产环境分支 - - `develop`：开发环境分支 - - `feature/*`：功能开发分支 - - `hotfix/*`：紧急修复分支 - -2. **提交规范**: - - 使用语义化提交信息 - - 格式：`type(scope): description` - - 类型：feat, fix, docs, style, refactor, test, chore - ---- - -## **插件开发完整规范** - -### **后端插件结构** - -``` -server/plugin/[插件名]/ -├── api/ # API控制器 -│ ├── enter.go # API组入口 -│ └── [模块].go # 具体API实现 -├── config/ # 插件配置 -│ └── config.go -├── initialize/ # 初始化模块 -│ ├── api.go # API注册 -│ ├── gorm.go # 数据库初始化 -│ ├── menu.go # 菜单初始化 -│ ├── router.go # 路由初始化 -│ └── viper.go # 配置初始化 -├── model/ # 数据模型 -│ ├── [模型].go # 数据库模型 -│ └── request/ # 请求模型 -├── router/ # 路由定义 -│ ├── enter.go # 路由组入口 -│ └── [模块].go # 具体路由 -├── service/ # 业务服务 -│ ├── enter.go # 服务组入口 -│ └── [模块].go # 具体服务 -└── plugin.go # 插件入口 -``` - -### **前端插件结构** - -``` -web/src/plugin/[插件名]/ -├── api/ # API接口 -│ └── [模块].js -├── components/ # 插件组件 -│ └── [组件].vue -├── view/ # 插件页面 -│ └── [页面].vue -├── form/ # 表单组件 -│ └── [表单].vue -└── config.js # 插件配置 -``` - -### **插件开发工作流** - -1. **【第一步】需求分析**: - - 明确插件功能和业务需求 - - 设计数据模型和接口规范 - - 规划前端页面和交互流程 - -2. **【第二步】后端开发**: - - 创建数据模型和请求模型 - - 实现服务层业务逻辑 - - 开发API控制器和路由 - - 编写初始化和配置代码 - -3. **【第三步】前端开发**: - - 创建API接口封装 - - 开发页面组件和表单 - - 实现业务逻辑和状态管理 - - 集成到主系统菜单 - -4. **【第四步】测试集成**: - - 单元测试和集成测试 - - 前后端联调测试 - - 用户体验测试 - - 性能和安全测试 - -### **插件质量标准** - -1. **功能完整性**: 插件功能完整，满足业务需求 -2. **代码质量**: 代码规范，注释完整，易于维护 -3. **数据类型一致性**: 前后端数据模型字段类型保持严格一致，避免类型转换错误 -4. **性能表现**: 响应速度快，资源占用合理 -5. **用户体验**: 界面友好，操作流畅，错误处理完善 -6. **兼容性**: 与主系统兼容，不影响其他功能 -7. **安全性**: 数据安全，权限控制，防止安全漏洞 - ---- - -### **建议和方案** - -基于以上规范，建议AI在开发gin-vue-admin项目时： - -1. **严格遵循分层架构**：确保前后端代码都按照规定的层次结构组织 -2. **保持代码一致性**：使用统一的命名规范、注释格式和代码风格 -3. **注重文档完整性**：确保API文档、代码注释和使用说明的完整性 -4. **优化用户体验**：关注页面加载速度、交互流畅性和错误处理 -5. **考虑扩展性**：设计时预留扩展接口，便于后续功能增强 -6. **重视安全性**：实现完善的权限控制和数据验证机制 \ No newline at end of file diff --git a/docs/gin-vue-admin.png b/docs/gin-vue-admin.png deleted file mode 100644 index bbe0549e18c09229c29a8b1e3e84edc5b1cc14e0..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 105776 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 diff --git a/server/api/v1/pet/user/pet_assistant_api.go b/server/api/v1/pet/user/pet_assistant_api.go index 57cc1cfb..928095b4 100644 --- a/server/api/v1/pet/user/pet_assistant_api.go +++ b/server/api/v1/pet/user/pet_assistant_api.go @@ -1,14 +1,10 @@ package user import ( - "io" "strconv" - "time" "github.com/flipped-aurora/gin-vue-admin/server/global" "github.com/flipped-aurora/gin-vue-admin/server/model/common/response" - petRequest "github.com/flipped-aurora/gin-vue-admin/server/model/pet/request" - petResponse "github.com/flipped-aurora/gin-vue-admin/server/model/pet/response" "github.com/flipped-aurora/gin-vue-admin/server/service" "github.com/flipped-aurora/gin-vue-admin/server/utils" "github.com/gin-gonic/gin" @@ -19,162 +15,6 @@ type PetAssistantApi struct{} var petChatService = service.ServiceGroupApp.PetServiceGroup.PetChatService -// AskPetAssistant 向宠物助手提问（非流式） -// @Tags PetAssistant -// @Summary 向宠物助手提问 -// @Security ApiKeyAuth -// @Accept application/json -// @Produce application/json -// @Param data body petRequest.ChatRequest true "宠物助手提问请求" -// @Success 200 {object} response.Response{data=petResponse.ChatResponse,msg=string} "提问成功" -// @Router /api/v1/pet/user/assistant/ask [post] -func (p *PetAssistantApi) AskPetAssistant(ctx *gin.Context) { - // 创建业务用Context - businessCtx := ctx.Request.Context() - - // 获取用户ID - userId := utils.GetAppUserID(ctx) - if userId == 0 { - global.GVA_LOG.Error("获取用户ID失败") - response.FailWithMessage("用户认证失败", ctx) - return - } - - // 绑定请求参数 - var req petRequest.ChatRequest - if err := ctx.ShouldBindJSON(&req); err != nil { - global.GVA_LOG.Error("参数绑定失败", zap.Error(err)) - response.FailWithMessage("参数错误: "+err.Error(), ctx) - return - } - - // 参数验证 - if req.Message == "" { - response.FailWithMessage("消息内容不能为空", ctx) - return - } - - // 设置默认参数 - if req.Temperature <= 0 { - req.Temperature = 0.7 - } - if req.MaxTokens <= 0 { - req.MaxTokens = 1000 - } - - // 调用服务层 - resp, err := petChatService.SendMessage(businessCtx, userId, req) - if err != nil { - global.GVA_LOG.Error("发送消息失败", zap.Error(err), zap.Uint("userId", userId)) - response.FailWithMessage("发送消息失败: "+err.Error(), ctx) - return - } - - response.OkWithDetailed(resp, "发送成功", ctx) -} - -// StreamAskPetAssistant 向宠物助手流式提问 -// @Tags PetAssistant -// @Summary 向宠物助手流式提问接口 -// @Security ApiKeyAuth -// @Accept application/json -// @Produce text/event-stream -// @Param data body petRequest.ChatRequest true "宠物助手流式提问请求" -// @Success 200 {string} string "流式响应" -// @Router /api/v1/pet/user/assistant/stream-ask [post] -func (p *PetAssistantApi) StreamAskPetAssistant(ctx *gin.Context) { - // 创建业务用Context - businessCtx := ctx.Request.Context() - - // 获取用户ID - userId := utils.GetAppUserID(ctx) - if userId == 0 { - global.GVA_LOG.Error("获取用户ID失败") - response.FailWithMessage("用户认证失败", ctx) - return - } - - // 绑定请求参数 - var req petRequest.ChatRequest - if err := ctx.ShouldBindJSON(&req); err != nil { - global.GVA_LOG.Error("参数绑定失败", zap.Error(err)) - response.FailWithMessage("参数错误: "+err.Error(), ctx) - return - } - - // 参数验证 - if req.Message == "" { - response.FailWithMessage("消息内容不能为空", ctx) - return - } - - // 强制设置为流式响应 - req.Stream = true - - // 设置默认参数 - if req.Temperature <= 0 { - req.Temperature = 0.7 - } - if req.MaxTokens <= 0 { - req.MaxTokens = 1000 - } - - // 设置SSE响应头 - ctx.Header("Content-Type", "text/event-stream") - ctx.Header("Cache-Control", "no-cache") - ctx.Header("Connection", "keep-alive") - ctx.Header("Access-Control-Allow-Origin", "*") - ctx.Header("Access-Control-Allow-Headers", "Cache-Control") - - // 创建事件通道 - eventChan := make(chan petResponse.StreamEvent, 100) - defer close(eventChan) - - // 启动流式聊天 - go func() { - if err := petChatService.StreamChat(businessCtx, userId, req, eventChan); err != nil { - global.GVA_LOG.Error("流式聊天失败", zap.Error(err), zap.Uint("userId", userId)) - eventChan <- petResponse.StreamEvent{ - Event: "error", - Data: map[string]interface{}{ - "error": "流式聊天失败: " + err.Error(), - }, - } - } - }() - - // 发送流式数据 - ctx.Stream(func(w io.Writer) bool { - select { - case event, ok := <-eventChan: - if !ok { - return false - } - - switch event.Event { - case "message": - // 发送消息事件 - ctx.SSEvent("message", event.Data) - case "error": - // 发送错误事件 - ctx.SSEvent("error", event.Data) - return false - case "done": - // 发送完成事件 - ctx.SSEvent("done", event.Data) - return false - } - return true - case <-time.After(30 * time.Second): - // 超时处理 - ctx.SSEvent("error", map[string]interface{}{ - "error": "流式响应超时", - }) - return false - } - }) -} - // GetAssistantHistory 获取宠物助手对话历史 // @Tags PetAssistant // @Summary 获取宠物助手对话历史记录（简化版本，只返回必要字段） diff --git a/server/global/global.go b/server/global/global.go index 97b57c4a..ed3e2119 100644 --- a/server/global/global.go +++ b/server/global/global.go @@ -3,6 +3,7 @@ package global import ( "fmt" "github.com/mark3labs/mcp-go/server" + "github.com/olahol/melody" "sync" "github.com/gin-gonic/gin" @@ -37,6 +38,7 @@ var ( GVA_ROUTERS gin.RoutesInfo GVA_ACTIVE_DBNAME *string GVA_MCP_SERVER *server.MCPServer + MELODY *melody.Melody BlackCache local_cache.Cache lock sync.RWMutex ) diff --git a/server/initialize/router.go b/server/initialize/router.go index 3d299d5f..2f31c61a 100644 --- a/server/initialize/router.go +++ b/server/initialize/router.go @@ -8,6 +8,7 @@ import ( "github.com/flipped-aurora/gin-vue-admin/server/global" "github.com/flipped-aurora/gin-vue-admin/server/middleware" "github.com/flipped-aurora/gin-vue-admin/server/router" + "github.com/flipped-aurora/gin-vue-admin/server/websocket" "github.com/gin-gonic/gin" swaggerFiles "github.com/swaggo/files" ginSwagger "github.com/swaggo/gin-swagger" @@ -42,6 +43,9 @@ func Routers() *gin.Engine { sseServer := McpRun() + // 初始化WebSocket + InitWebSocket() + // 注册mcp服务 Router.GET(global.GVA_CONFIG.MCP.SSEPath, func(c *gin.Context) { sseServer.SSEHandler().ServeHTTP(c.Writer, c.Request) @@ -78,6 +82,9 @@ func Routers() *gin.Engine { PrivateGroup.Use(middleware.JWTAuth()).Use(middleware.CasbinHandler()) UserGroup.Use(middleware.UserJWTAuth()) + // WebSocket路由（不使用UserJWTAuth中间件，使用自定义认证） + Router.GET("/user/ws", websocket.WebSocketAuthMiddleware(), websocket.HandleConnection) + { // 健康监测 PublicGroup.GET("/health", func(c *gin.Context) { diff --git a/server/initialize/websocket.go b/server/initialize/websocket.go new file mode 100644 index 00000000..98dfddba --- /dev/null +++ b/server/initialize/websocket.go @@ -0,0 +1,10 @@ +package initialize + +import ( + "github.com/flipped-aurora/gin-vue-admin/server/websocket" +) + +// InitWebSocket 初始化WebSocket +func InitWebSocket() { + websocket.InitWebSocketServer() +} diff --git a/server/router/pet/pet_assistant_router.go b/server/router/pet/pet_assistant_router.go index 4e084a4d..6c046308 100644 --- a/server/router/pet/pet_assistant_router.go +++ b/server/router/pet/pet_assistant_router.go @@ -16,8 +16,6 @@ func (p *PetAssistantRouter) InitPetAssistantRouter(UserRouter *gin.RouterGroup, { // 宠物助手问答相关路由 - petAssistantRouter.POST("ask", petAssistantApi.AskPetAssistant) // 向宠物助手提问 - petAssistantRouter.POST("stream-ask", petAssistantApi.StreamAskPetAssistant) // 向宠物助手流式提问 petAssistantRouter.GET("history", petAssistantApi.GetAssistantHistory) // 获取宠物助手对话历史 petAssistantRouter.DELETE("clear-history", petAssistantApi.ClearAssistantHistory) // 清空宠物助手对话历史 petAssistantRouter.GET("sessions", petAssistantApi.GetAssistantSessions) // 获取宠物助手会话列表 diff --git a/server/websocket/enter.go b/server/websocket/enter.go new file mode 100644 index 00000000..09a1c022 --- /dev/null +++ b/server/websocket/enter.go @@ -0,0 +1,109 @@ +package websocket + +import ( + "encoding/json" + "time" + + "github.com/flipped-aurora/gin-vue-admin/server/global" + "github.com/gin-gonic/gin" + "github.com/olahol/melody" +) + +// HandleConnection 处理WebSocket连接 +func HandleConnection(ctx *gin.Context) { + // 从中间件获取用户ID + userId, exists := ctx.Get("userId") + if !exists { + ctx.JSON(401, gin.H{"error": "用户认证失败"}) + return + } + + // 升级为WebSocket连接，并存储用户信息 + global.MELODY.HandleRequestWithKeys(ctx.Writer, ctx.Request, map[string]interface{}{ + "userId": userId, + }) +} + +// SendMessage 发送消息到WebSocket连接 +func SendMessage(s *melody.Session, message interface{}) error { + data, err := json.Marshal(message) + if err != nil { + return err + } + return s.Write(data) +} + +// SendErrorMessage 发送错误消息 +func SendErrorMessage(s *melody.Session, errorMsg string) { + SendMessage(s, NewErrorEvent(errorMsg)) +} + +// BroadcastToUser 向指定用户广播消息 +func BroadcastToUser(userID uint, message interface{}) error { + messageBytes, err := json.Marshal(message) + if err != nil { + return err + } + + // 遍历所有连接，找到对应用户的连接 + return global.MELODY.BroadcastFilter(messageBytes, func(s *melody.Session) bool { + if userIdInterface, exists := s.Get("userId"); exists { + if userId, ok := userIdInterface.(uint); ok { + return userId == userID + } + } + return false + }) +} + +// BroadcastMessageToUser 向指定用户广播流式消息 +func BroadcastMessageToUser(userID uint, delta string) error { + return BroadcastToUser(userID, NewMessageEvent(delta)) +} + +// BroadcastErrorToUser 向指定用户广播错误消息 +func BroadcastErrorToUser(userID uint, errorMsg string) error { + return BroadcastToUser(userID, NewErrorEvent(errorMsg)) +} + +// BroadcastDoneToUser 向指定用户广播完成消息 +func BroadcastDoneToUser(userID uint, message, sessionId string) error { + return BroadcastToUser(userID, NewDoneEvent(message, sessionId)) +} + +// GetConnectedUserCount 获取当前连接的用户数量 +func GetConnectedUserCount() int { + count := 0 + global.MELODY.BroadcastFilter([]byte{}, func(s *melody.Session) bool { + if _, exists := s.Get("userId"); exists { + count++ + } + return false // 不实际发送消息，只统计 + }) + return count +} + +// SendPingToUser 向指定用户发送心跳消息 +func SendPingToUser(userID uint) error { + pingMsg := Message{ + Type: "ping", + Data: map[string]interface{}{ + "timestamp": time.Now().Unix(), + }, + } + return BroadcastToUser(userID, pingMsg) +} + +// IsUserConnected 检查用户是否在线 +func IsUserConnected(userID uint) bool { + connected := false + global.MELODY.BroadcastFilter([]byte{}, func(s *melody.Session) bool { + if userIdInterface, exists := s.Get("userId"); exists { + if userId, ok := userIdInterface.(uint); ok && userId == userID { + connected = true + } + } + return false // 不实际发送消息，只检查 + }) + return connected +} diff --git a/server/websocket/message.go b/server/websocket/message.go new file mode 100644 index 00000000..28de2fa6 --- /dev/null +++ b/server/websocket/message.go @@ -0,0 +1,54 @@ +package websocket + +// Message WebSocket下发消息结构体 +type Message struct { + Type string `json:"type"` // 消息类型：message, error, done + Data interface{} `json:"data"` // 消息数据 +} + +// MessageData 流式消息数据结构体 +type MessageData struct { + Delta string `json:"delta"` // 增量消息内容 +} + +// ErrorData 错误数据结构体 +type ErrorData struct { + Error string `json:"error"` // 错误信息 +} + +// DoneData 完成数据结构体 +type DoneData struct { + Message string `json:"message"` // 完整消息内容 + SessionId string `json:"sessionId"` // 会话ID +} + +// NewMessageEvent 创建消息事件 +func NewMessageEvent(delta string) Message { + return Message{ + Type: "message", + Data: MessageData{ + Delta: delta, + }, + } +} + +// NewErrorEvent 创建错误事件 +func NewErrorEvent(errorMsg string) Message { + return Message{ + Type: "error", + Data: ErrorData{ + Error: errorMsg, + }, + } +} + +// NewDoneEvent 创建完成事件 +func NewDoneEvent(message, sessionId string) Message { + return Message{ + Type: "done", + Data: DoneData{ + Message: message, + SessionId: sessionId, + }, + } +} diff --git a/server/websocket/server.go b/server/websocket/server.go new file mode 100644 index 00000000..b69b441b --- /dev/null +++ b/server/websocket/server.go @@ -0,0 +1,116 @@ +package websocket + +import ( + "net/http" + "strings" + "time" + + "github.com/flipped-aurora/gin-vue-admin/server/global" + "github.com/flipped-aurora/gin-vue-admin/server/utils" + "github.com/gin-gonic/gin" + "github.com/olahol/melody" + "go.uber.org/zap" +) + +// InitWebSocketServer 初始化WebSocket服务器 +func InitWebSocketServer() { + // 创建melody实例 + global.MELODY = melody.New() + + // 设置WebSocket配置 + global.MELODY.Config.MaxMessageSize = 1024 * 1024 // 1MB + global.MELODY.Config.MessageBufferSize = 256 + global.MELODY.Config.PongWait = 60 * time.Second // 等待pong消息的时间 + global.MELODY.Config.PingPeriod = 54 * time.Second // 发送ping消息的间隔 + global.MELODY.Config.WriteWait = 10 * time.Second // 写入超时时间 + global.MELODY.Config.ConcurrentMessageHandling = false // 禁用并发消息处理 + + // 连接建立时的处理 + global.MELODY.HandleConnect(func(s *melody.Session) { + if userIdInterface, exists := s.Get("userId"); exists { + if userId, ok := userIdInterface.(uint); ok { + global.GVA_LOG.Info("WebSocket连接建立", + zap.Uint("userId", userId), + zap.String("remoteAddr", s.Request.RemoteAddr)) + } + } + }) + + // 连接断开时的处理 + global.MELODY.HandleDisconnect(func(s *melody.Session) { + if userIdInterface, exists := s.Get("userId"); exists { + if userId, ok := userIdInterface.(uint); ok { + global.GVA_LOG.Info("WebSocket连接断开", + zap.Uint("userId", userId), + zap.String("remoteAddr", s.Request.RemoteAddr)) + } + } + }) + + // 错误处理 + global.MELODY.HandleError(func(s *melody.Session, err error) { + // 检查是否是正常关闭或客户端主动断开 + errMsg := err.Error() + if strings.Contains(errMsg, "close 1000") || + strings.Contains(errMsg, "close 1001") || + strings.Contains(errMsg, "use of closed network connection") { + // 正常关闭，只记录debug级别日志 + if userIdInterface, exists := s.Get("userId"); exists { + if userId, ok := userIdInterface.(uint); ok { + global.GVA_LOG.Debug("WebSocket正常关闭", + zap.String("reason", errMsg), + zap.Uint("userId", userId)) + } + } + } else { + // 异常错误，记录error级别日志 + if userIdInterface, exists := s.Get("userId"); exists { + if userId, ok := userIdInterface.(uint); ok { + global.GVA_LOG.Error("WebSocket异常错误", + zap.Error(err), + zap.Uint("userId", userId)) + } + } else { + global.GVA_LOG.Error("WebSocket异常错误", zap.Error(err)) + } + } + }) + + // 由于只下发数据，不处理客户端消息，所以不设置消息处理器 + global.GVA_LOG.Info("WebSocket服务器初始化完成") +} + +// WebSocketAuthMiddleware WebSocket鉴权中间件 +func WebSocketAuthMiddleware() gin.HandlerFunc { + return func(c *gin.Context) { + // 从查询参数获取token + token := c.Query("token") + if token == "" { + // 从头部获取token + token = c.GetHeader("Authorization") + if token != "" && len(token) > 7 && token[:7] == "Bearer " { + token = token[7:] + } + } + + if token == "" { + c.JSON(http.StatusUnauthorized, gin.H{"error": "缺少认证token"}) + c.Abort() + return + } + + // 解析token获取用户ID + j := utils.NewJWT() + claims, err := j.ParseAppUserToken(token) + if err != nil { + global.GVA_LOG.Error("WebSocket token解析失败", zap.Error(err)) + c.JSON(http.StatusUnauthorized, gin.H{"error": "token无效"}) + c.Abort() + return + } + + // 将用户ID存储到上下文中 + c.Set("userId", claims.AppBaseClaims.ID) + c.Next() + } +}