vue2-client 1.17.19 → 1.17.20

package/.serena/memories/project_overview.md

@@ -0,0 +1,55 @@
+# Vue2-Client 项目概述
+
+## 项目目的
+Vue2-Client是一个基于Vue Antd Admin封装的**通用基础组件库**，旨在为企业级应用提供统一的UI组件和开发框架。
+
+## 核心定位
+- **可复用组件库**：提供一套完整的企业级UI组件
+- **低代码平台基础**：支持通过JSON配置驱动的动态UI生成
+- **多业务场景支持**：适用于医院信息系统(HIS)、工单管理、系统管理等多个领域
+- **多环境部署**：支持gaslink、revenue、liuli、scada、iot、his等多个部署环境
+
+## 主要功能模块
+
+### 1. Base-Client基础组件系统
+核心组件库，包含：
+- **X系列组件**：XForm、XTable、XFormTable、XPageView等配置驱动组件
+- **全局插件**：认证、国际化、页面管理等Vue插件
+- 所有base-client组件全局注册，整个应用直接可用
+
+### 2. 低代码平台集成
+- 内置低代码编辑器和渲染器
+- 支持通过JSON配置动态生成表单、表格和页面布局
+- 逻辑运行器系统(LogicRunner)和表达式求值(ExpressionRunner)
+- 自定义组件注册系统
+
+### 3. 业务页面模块
+- **系统管理**：用户、角色、权限管理
+- **工单流程**：工单详情、流程审批
+- **资源管理**：资源分配和管理
+- **动态统计**：数据可视化和报表
+- **HIS医院系统**：医疗信息管理相关功能
+
+### 4. 配置驱动开发
+- 通过`src/config/`中的配置文件定义组件行为
+- 支持多环境配置切换
+- 统一的配置管理和替换机制
+
+## 技术特点
+1. **配置优于编码**：大部分UI通过JSON配置生成，减少重复代码
+2. **组件化架构**：高度模块化，易于维护和扩展
+3. **主题定制**：支持动态主题色替换
+4. **国际化支持**：内置i18n支持多语言
+5. **响应式设计**：基于Ant Design栅格系统的响应式布局
+
+## 目标用户
+- 企业内部开发团队
+- 需要快速构建管理系统的项目
+- 低代码平台的二次开发者
+- 需要统一UI规范的多系统项目
+
+## 项目状态
+- 当前版本：v1.17.13
+- 维护状态：活跃开发中
+- Git分支：dev分支
+- 部署环境：支持多环境部署

package/.serena/memories/project_structure.md

@@ -0,0 +1,330 @@
+# Vue2-Client 项目结构详解
+
+## 顶层目录结构
+```
+vue2-client/
+├── src/                 # 源代码目录
+├── public/              # 静态资源（不经webpack处理）
+├── dist/                # 构建输出目录
+├── docs/                # 项目文档
+├── test/                # 测试文件（Jest）
+├── tests/unit/          # 单元测试
+├── node_modules/        # 依赖包
+├── package.json         # 项目配置和依赖
+├── vue.config.js        # Vue CLI配置
+├── jest.config.js       # Jest测试配置
+├── babel.config.js      # Babel配置
+└── README.md            # 项目说明
+```
+
+## 核心源码结构 (src/)
+
+### 1. base-client/ - 基础组件系统（核心）
+```
+base-client/
+├── components/          # 可复用UI组件（全局注册）
+│   ├── XForm/          # 表单组件
+│   ├── XTable/         # 表格组件
+│   ├── XCard/          # 卡片组件
+│   ├── XPageView/      # 页面视图组件
+│   └── ...             # 其他X系列组件
+└── plugins/            # 全局Vue插件
+    ├── auth.js         # 认证插件
+    ├── i18n-extend.js  # 国际化扩展
+    └── ...             # 其他插件
+```
+**特点**：
+- 所有组件全局注册，整个应用可直接使用
+- X前缀命名，表示核心基础组件
+- 通过JSON配置驱动组件行为
+
+### 2. components/ - 通用组件（按需引入）
+```
+components/
+├── chart/              # 图表组件
+├── Charts/             # G2图表组件
+├── table/              # 表格相关
+├── form/               # 表单相关
+├── menu/               # 菜单组件
+├── page/               # 页面组件
+└── ...                 # 其他业务组件
+```
+**特点**：
+- 按需引入，不全局注册
+- 包含业务特定的组件
+- 包含第三方组件的封装
+
+### 3. pages/ - 页面组件
+```
+pages/
+├── login/              # 登录页
+├── dashboard/          # 仪表盘
+├── system/             # 系统管理
+├── WorkflowDetail/     # 工单流程详情
+├── userInfoDetailManage/ # 用户信息管理
+├── resourceManage/     # 资源管理
+├── DynamicStatistics/  # 动态统计
+├── lowCode/            # 低代码相关页面
+└── ...                 # 其他业务页面
+```
+**特点**：
+- 每个目录是一个功能模块
+- 对应路由配置
+- 可能包含子组件
+
+### 4. layouts/ - 布局组件
+```
+layouts/
+├── AdminLayout.vue     # 管理后台布局
+├── BlankView.vue       # 空白布局
+├── PageLayout.vue      # 页面布局
+├── PageView.vue        # 页面视图
+├── header/             # 头部组件
+├── footer/             # 底部组件
+└── tabs/               # 标签页组件
+```
+**特点**：
+- 定义整体页面结构
+- 包含通用的头部、侧边栏、底部
+- 支持多种布局模式
+
+### 5. router/ - 路由配置
+```
+router/
+├── index.js            # 路由主入口
+├── guards.js           # 路由守卫
+├── i18n.js             # 国际化路由
+└── async/              # 异步路由
+    └── router.map.js   # 路由映射配置
+```
+**特点**：
+- 支持动态路由
+- 路由权限控制
+- 国际化路由
+
+### 6. services/ - 数据服务层
+```
+services/
+├── apiService.js       # API服务基类
+├── DataModel.js        # 数据模型转换
+├── dataSource.js       # 数据源配置
+├── user.js             # 用户服务
+├── v3Api.js            # V3版本API
+└── api/                # API接口定义
+    ├── account.js      # 账户相关
+    ├── system.js       # 系统相关
+    └── ...             # 其他模块API
+```
+**特点**：
+- 统一的API调用封装
+- 数据模型转换层
+- axios拦截器配置
+
+### 7. store/ - Vuex状态管理
+```
+store/
+├── index.js            # Store主入口
+├── mutation-types.js   # Mutation类型常量
+└── modules/            # 状态模块
+    ├── account.js      # 账户状态
+    ├── setting.js      # 设置状态
+    ├── lowCode.js      # 低代码状态
+    └── async-router.js # 异步路由状态
+```
+**特点**：
+- 模块化状态管理
+- 持久化存储支持
+- 全局状态共享
+
+### 8. config/ - 配置文件
+```
+config/
+├── index.js            # 配置主入口
+├── CreateQueryConfig.js # 查询配置
+├── default/            # 默认配置
+│   ├── setting.config.js
+│   └── ...
+└── replacer/           # 配置替换器
+```
+**特点**：
+- 配置驱动开发
+- 支持环境配置
+- 可动态替换
+
+### 9. utils/ - 工具函数
+```
+utils/
+├── request.js          # HTTP请求封装
+├── auth.js             # 认证工具
+├── storage.js          # 存储工具
+├── date.js             # 日期处理
+├── encrypt.js          # 加密工具
+├── format.js           # 格式化工具
+└── ...                 # 其他工具
+```
+**特点**：
+- 纯函数工具
+- 可复用逻辑
+- 无副作用
+
+### 10. theme/ - 主题样式
+```
+theme/
+├── index.less          # 主题入口
+├── theme.less          # 主题变量
+├── global.less         # 全局样式
+├── antd/               # Ant Design主题定制
+└── default/            # 默认主题
+```
+**特点**：
+- Less变量定义
+- Ant Design主题定制
+- 动态主题切换支持
+
+### 11. expression/ - 表达式系统
+```
+expression/
+├── ExpressionRunner.js # 表达式运行器
+├── core/               # 核心逻辑
+├── enums/              # 枚举定义
+├── exception/          # 异常处理
+└── ts/                 # TypeScript定义
+```
+**特点**：
+- 低代码平台表达式求值
+- 支持复杂表达式计算
+
+### 12. logic/ - 逻辑系统
+```
+logic/
+├── LogicRunner.js      # 逻辑运行器
+├── plugins/            # 逻辑插件
+└── ts/                 # TypeScript定义
+```
+**特点**：
+- 低代码平台业务逻辑执行
+- 插件化扩展
+
+### 13. assets/ - 静态资源
+```
+assets/
+├── img/                # 图片
+├── svg/                # SVG图标
+├── sound/              # 音频文件
+└── ttf/                # 字体文件
+```
+
+### 14. mixins/ - Vue混入
+```
+mixins/
+└── formValidationMixin.js  # 表单验证混入
+```
+**特点**：
+- 共享组件逻辑
+- 表单验证等通用功能
+
+### 15. plugins/ - 自定义插件
+```
+plugins/
+├── EventLogPlugin.js   # 事件日志插件
+├── FindParentsData.js  # 父级数据查找
+└── HiPrintPlugin.js    # 打印插件
+```
+
+## 关键入口文件
+
+### main.js
+- 应用入口
+- Vue实例创建
+- 全局配置初始化
+
+### bootstrap.js
+- 应用启动引导
+- 插件注册
+- 全局组件注册
+
+### index.js
+- 模块导出入口
+- 供外部项目引入使用
+
+### App.vue
+- 根组件
+- 应用容器
+
+## 配置文件说明
+
+### vue.config.js
+- Webpack配置
+- 开发服务器配置
+- 代理配置
+- 别名配置
+- 主题配置
+- 性能优化配置
+
+### package.json
+- 项目元信息
+- 依赖管理
+- 脚本命令
+- 版本：v1.17.13
+
+### jest.config.js
+- 测试框架配置
+- 模块映射
+- 转换规则
+
+### babel.config.js
+- Babel编译配置
+- JSX支持
+- Polyfill配置
+
+## 特殊目录说明
+
+### public/
+不经webpack处理的静态资源：
+- index.html（入口HTML）
+- favicon.ico
+- his/editor/（富文本编辑器）
+
+### dist/
+构建输出目录：
+- 生产环境构建结果
+- 压缩和优化后的资源
+- 按环境生成不同配置
+
+### docs/
+项目文档：
+- 低代码平台文档
+- 组件使用文档
+- 功能说明文档
+
+## 模块依赖关系
+
+```
+main.js
+  └── bootstrap.js
+        ├── base-client/ (全局注册)
+        ├── plugins/
+        ├── router/
+        ├── store/
+        └── config/
+            
+pages/
+  └── layouts/
+        └── base-client/components/ (X组件)
+              └── components/ (通用组件)
+                    └── utils/
+                          └── services/
+```
+
+## 构建输出结构 (dist/)
+```
+dist/
+├── index.html          # 入口HTML
+├── static/             # 静态资源
+│   ├── css/           # 样式文件
+│   ├── js/            # JavaScript文件
+│   ├── fonts/         # 字体文件
+│   └── img/           # 图片文件
+├── css/               # 主题CSS
+└── favicon.ico        # 图标
+```

package/.serena/memories/suggested_commands.md

@@ -0,0 +1,128 @@
+# Vue2-Client 项目常用命令
+
+## Windows系统命令说明
+本项目在Windows系统下开发，使用PowerShell或CMD。
+
+## 核心开发命令
+
+### 开发服务器（开发模式）
+```powershell
+# 默认开发服务器 (端口8020)
+npm run serve
+
+# MacOS/Linux开发服务器
+npm run mac-serve
+```
+
+### 多环境开发服务器
+支持以下环境模式，每个模式对应不同的代理配置：
+```powershell
+npm run serve:gaslink   # 燃气链路模式
+npm run serve:revenue   # 营收模式
+npm run serve:liuli     # 流离模式
+npm run serve:scada     # SCADA模式
+npm run serve:iot       # IoT模式
+npm run serve:his       # HIS医院信息系统模式
+npm run serve:runtime   # 运行时模式
+npm run serve:message   # 消息模式
+npm run serve:apply     # 应用模式
+```
+
+### 构建命令
+```powershell
+# 生产环境构建
+npm run build
+
+# 预览环境构建
+npm run build:preview
+```
+
+### 代码质量检查
+```powershell
+# 运行ESLint并自动修复
+npm run lint
+
+# 运行ESLint但不自动修复（仅检查）
+npm run lint:nofix
+```
+
+### 测试命令
+```powershell
+# 运行Jest单元测试
+npm test
+
+# 运行Vue CLI单元测试
+npm run test:unit
+```
+
+## 重要说明
+
+### NODE_OPTIONS配置
+Windows环境下所有开发命令需要设置`NODE_OPTIONS=--openssl-legacy-provider`来解决OpenSSL兼容性问题。这已经集成在`package.json`的scripts中。
+
+### 开发服务器配置
+- 默认端口：8020
+- 开发模式默认禁用ESLint（--no-eslint），需要单独运行`npm run lint`进行代码检查
+- 支持热重载和代理配置
+
+### Windows常用系统命令
+```powershell
+# 文件和目录操作
+dir                  # 列出目录内容（类似Linux的ls）
+cd <path>           # 切换目录
+mkdir <name>        # 创建目录
+rmdir /s <name>     # 删除目录及内容
+del <file>          # 删除文件
+
+# 文件搜索
+findstr /s "pattern" *.js    # 在js文件中搜索文本（类似Linux的grep）
+where <command>              # 查找命令位置（类似Linux的which）
+
+# 进程和端口
+netstat -ano | findstr :8020  # 查看端口占用
+taskkill /PID <pid> /F        # 终止进程
+
+# Git操作
+git status          # 查看仓库状态
+git add .           # 添加所有改动
+git commit -m ""    # 提交改动
+git pull            # 拉取最新代码
+git push            # 推送代码
+git log             # 查看提交历史
+```
+
+## 项目初始化
+```powershell
+# 克隆项目后首次运行
+npm install
+
+# 如果依赖安装失败，尝试清理缓存
+npm cache clean --force
+npm install
+```
+
+## 故障排查
+
+### 端口被占用
+```powershell
+# 查看8020端口占用
+netstat -ano | findstr :8020
+
+# 终止占用端口的进程
+taskkill /PID <进程ID> /F
+```
+
+### 依赖问题
+```powershell
+# 删除node_modules和lock文件重新安装
+rmdir /s /q node_modules
+del package-lock.json
+npm install
+```
+
+### OpenSSL错误
+如果遇到OpenSSL相关错误，确保使用了带有`NODE_OPTIONS`设置的命令，或手动设置：
+```powershell
+SET NODE_OPTIONS=--openssl-legacy-provider
+npm run serve
+```

package/.serena/memories/task_completion_checklist.md

@@ -0,0 +1,184 @@
+# 任务完成检查清单
+
+当完成一个开发任务时，请按以下清单逐项检查：
+
+## 1. 代码质量检查
+
+### 运行ESLint检查
+```powershell
+npm run lint
+```
+- ✅ 确保没有ESLint错误
+- ✅ 修复所有警告（如果可能）
+- ✅ 确保代码符合项目风格规范
+
+### 代码审查要点
+- ✅ 变量命名使用描述性名称（isLoading, hasError等）
+- ✅ 组件使用Vue 2.7组合API + setup语法糖
+- ✅ 方法和计算属性使用箭头函数
+- ✅ 避免代码重复，提取可复用逻辑
+- ✅ 注释使用中文编写
+- ✅ 复杂逻辑有适当的注释说明
+
+## 2. 功能测试
+
+### 本地测试
+- ✅ 在开发服务器验证功能正常：`npm run serve`
+- ✅ 测试所有用户交互流程
+- ✅ 验证表单验证规则
+- ✅ 测试错误处理和边界情况
+- ✅ 检查响应式布局（不同屏幕尺寸）
+
+### 单元测试（如果涉及）
+```powershell
+npm test
+```
+- ✅ 为新功能编写单元测试
+- ✅ 确保现有测试通过
+- ✅ 测试覆盖核心业务逻辑
+
+## 3. 性能检查
+
+- ✅ 检查是否有不必要的重新渲染
+- ✅ 大列表使用虚拟滚动或分页
+- ✅ 图片和资源已优化
+- ✅ 避免在computed中进行复杂计算
+- ✅ 合理使用防抖和节流
+
+## 4. 样式检查
+
+- ✅ 样式符合设计规范
+- ✅ 使用项目主题变量（theme.less）
+- ✅ 检查不同主题下的显示效果
+- ✅ 移动端响应式适配
+- ✅ 浏览器兼容性（Chrome、Edge、Firefox）
+
+## 5. 文档更新
+
+- ✅ 如果是新组件，在Components.md中添加说明
+- ✅ 更新相关的项目文档
+- ✅ 添加代码注释和使用示例
+- ✅ 更新CHANGELOG.md（重要功能）
+
+## 6. Git提交
+
+### 提交前检查
+```powershell
+# 查看修改的文件
+git status
+
+# 查看具体修改内容
+git diff
+```
+
+### 提交规范
+- ✅ 只提交与任务相关的文件
+- ✅ 避免提交调试代码和console.log
+- ✅ 提交信息清晰描述改动内容
+- ✅ 使用约定式提交格式（推荐）：
+  - `feat:` 新功能
+  - `fix:` 修复bug
+  - `docs:` 文档更新
+  - `style:` 代码格式
+  - `refactor:` 重构
+  - `test:` 测试
+  - `chore:` 构建或工具
+
+### 提交命令
+```powershell
+git add .
+git commit -m "feat: 添加用户管理功能"
+```
+
+## 7. 构建验证
+
+### 生产环境构建测试
+```powershell
+npm run build
+```
+- ✅ 构建成功无错误
+- ✅ 检查构建产物大小是否合理
+- ✅ 验证dist目录结构正确
+
+### 预览环境测试（可选）
+```powershell
+npm run build:preview
+```
+
+## 8. 配置检查（多环境项目）
+
+如果涉及多环境配置：
+- ✅ 验证gaslink环境：`npm run serve:gaslink`
+- ✅ 验证revenue环境：`npm run serve:revenue`
+- ✅ 验证his环境：`npm run serve:his`
+- ✅ 确保API代理配置正确
+- ✅ 环境变量设置正确
+
+## 9. 低代码平台检查（如果相关）
+
+如果涉及低代码组件：
+- ✅ 组件已在低代码环境正确注册
+- ✅ JSON配置格式正确且文档完善
+- ✅ 在低代码编辑器中测试组件
+- ✅ 验证表达式和逻辑运行器功能
+
+## 10. 团队协作
+
+- ✅ 通知相关团队成员关于重要改动
+- ✅ 如有API变更，通知后端团队
+- ✅ 如有组件变更，通知使用该组件的开发者
+- ✅ 更新团队共享文档
+
+## 11. 安全检查
+
+- ✅ 敏感信息不直接写在代码中
+- ✅ 用户输入已正确验证和过滤
+- ✅ XSS和CSRF防护已考虑
+- ✅ API调用使用正确的认证
+
+## 12. 清理工作
+
+- ✅ 删除临时文件和调试代码
+- ✅ 清理未使用的导入和变量
+- ✅ 删除注释掉的废弃代码
+- ✅ 确保node_modules不在提交中
+
+## 快速检查命令
+
+```powershell
+# 完整检查流程
+npm run lint              # 代码检查
+npm test                  # 运行测试
+npm run build             # 构建验证
+git status                # 查看修改
+```
+
+## 常见问题排查
+
+### 如果ESLint失败
+1. 仔细阅读错误信息
+2. 运行`npm run lint`自动修复
+3. 手动修复无法自动修复的错误
+
+### 如果构建失败
+1. 检查是否有语法错误
+2. 确认所有导入路径正确
+3. 检查是否缺少依赖包
+4. 查看控制台错误详细信息
+
+### 如果测试失败
+1. 查看具体失败的测试用例
+2. 检查是否破坏了现有功能
+3. 更新或修复测试用例
+4. 确保测试环境配置正确
+
+## 最终确认
+
+在推送代码前，问自己：
+- ✅ 我的代码是否可读且易于维护？
+- ✅ 我的改动是否会影响其他模块？
+- ✅ 我是否遵循了项目的代码规范？
+- ✅ 我是否进行了充分的测试？
+- ✅ 我的提交信息是否清晰？
+
+**只有所有检查项都通过后，才能推送代码！**