feat: 添加ERP服务和系统服务,完善员工门户功能

## 新增服务模块

### 1. ERP服务 (hzhub-erp)
- 新增独立的ERP数据适配服务
- 支持SQL Server 2008 R2数据源
- 提供动态API配置管理系统
- 包含客户管理、销售数据等业务接口

### 2. 系统服务 (hzhub-system)
- 新增独立的系统管理服务
- 用户、角色、权限、部门、菜单管理
- 租户管理、操作日志、在线用户监控
- 工作流引擎(warm-flow)集成
- 企业微信审批同步功能

### 3. API网关 (hzhub-gateway)
- 新增Spring Cloud Gateway网关服务
- JWT认证、路由分发、限流熔断
- XSS防护、请求日志记录
- 统一入口端口8080

## 后台管理功能增强

### ERP动态API管理
- 新增动态API配置管理界面
- API测试、文档预览、统计监控
- 错误日志查看、缓存管理
- 从数据库表自动导入API配置

### 系统管理增强
- 企业微信配置管理
- 企业微信审批同步配置
- 部门和用户管理优化

## 员工门户功能完善

### 业务页面
- 审批中心:工作流审批、待办任务
- CRM管理:客户关系管理
- 经销商管理:经销商数据展示
- 供应链管理:采购、库存、销售
- BI报表:数据可视化分析
- ERP数据探索:SQL Server数据查询

### 个人中心
- 基本设置:个人信息管理
- 安全设置:密码修改、登录日志
- 锁屏功能:自动锁屏、手动锁屏

### 其他功能
- 标签页管理:多标签页导航
- 页面缓存:keepAlive缓存机制
- 会话超时:自动检测并提示

## 经销商门户

### 页面路由
- 新增经销商管理页面路由
- AI聊天界面完善

## 文档更新

- ERP API数据库初始化指南
- ERP API前端完整实现文档
- ERP API测试和验证指南
- Gateway路由迁移计划
- 项目配置文档更新

## 部署脚本

- 统一启动/停止/重启脚本
- Docker Compose配置优化
- Nginx配置文件更新

## 技术栈

- 后端: Spring Boot 3.5.8, Java 17
- 前端: Vue 3, TypeScript, Element Plus, Vben Admin
- 工作流: warm-flow 1.8.2
- 网关: Spring Cloud Gateway
- 数据库: MySQL 8.0, SQL Server 2008 R2
- 缓存: Redis 7
- 向量库: Weaviate 1.25.0

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
大壮
2026-05-08 08:00:19 +00:00
parent e6fc123b1f
commit c2513849b4
1564 changed files with 52903 additions and 641 deletions

View File

@@ -0,0 +1,3 @@
-- 添加executed_sql字段到erp_api_stats表
ALTER TABLE hzhub.erp_api_stats
ADD COLUMN executed_sql TEXT COMMENT '实际执行的SQL语句' AFTER call_params;

View File

@@ -0,0 +1,147 @@
-- ERP API 管理平台数据库表创建脚本
-- 执行顺序:先创建 erp_api_config再创建 erp_api_param最后创建 erp_api_stats
USE hzhub;
-- 1. API 配置主表
CREATE TABLE IF NOT EXISTS erp_api_config (
api_id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT 'API ID',
api_name VARCHAR(100) NOT NULL COMMENT 'API名称',
api_path VARCHAR(200) NOT NULL COMMENT 'API路径如 /erp/dynamic/customer/list',
api_method VARCHAR(10) NOT NULL DEFAULT 'GET' COMMENT 'HTTP方法GET/POST',
api_desc VARCHAR(500) COMMENT 'API描述',
api_version VARCHAR(10) DEFAULT 'v1' COMMENT 'API版本号v1/v2',
-- 数据源配置
data_source VARCHAR(50) DEFAULT 'erp' COMMENT '数据源名称',
-- SQL配置
sql_template TEXT NOT NULL COMMENT 'SQL模板支持参数占位符 #{paramName}',
result_type VARCHAR(20) NOT NULL DEFAULT 'LIST' COMMENT '结果类型LIST/SINGLE/COUNT',
-- 分页配置
support_pagination TINYINT(1) DEFAULT 0 COMMENT '是否支持分页',
page_param_name VARCHAR(50) DEFAULT 'pageNum' COMMENT '页码参数名',
size_param_name VARCHAR(50) DEFAULT 'pageSize' COMMENT '页大小参数名',
-- 权限配置
require_auth TINYINT(1) DEFAULT 0 COMMENT '是否需要认证',
permission_code VARCHAR(100) COMMENT '权限标识(如 erp:customer:list',
-- 缓存配置
enable_cache TINYINT(1) DEFAULT 0 COMMENT '是否启用缓存',
cache_key_template VARCHAR(200) COMMENT '缓存键模板(支持参数占位符)',
cache_ttl INT DEFAULT 300 COMMENT '缓存过期时间(秒)',
-- 来源表信息
source_table VARCHAR(100) COMMENT '来源表名',
source_table_comment VARCHAR(500) COMMENT '来源表描述',
-- 状态
status TINYINT(1) DEFAULT 1 COMMENT '状态0禁用 1启用',
create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
create_by VARCHAR(50) COMMENT '创建者',
update_by VARCHAR(50) COMMENT '更新者',
remark VARCHAR(500) COMMENT '备注'
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='ERP动态API配置表';
-- 创建索引
CREATE INDEX idx_api_path_method ON erp_api_config(api_path, api_method, api_version);
CREATE INDEX idx_status ON erp_api_config(status);
CREATE INDEX idx_source_table ON erp_api_config(source_table);
-- 2. API 参数配置表
CREATE TABLE IF NOT EXISTS erp_api_param (
param_id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT '参数ID',
api_id BIGINT NOT NULL COMMENT '所属API ID',
-- 参数基本信息
param_name VARCHAR(100) NOT NULL COMMENT '参数名称',
param_desc VARCHAR(500) COMMENT '参数描述',
param_type VARCHAR(20) NOT NULL DEFAULT 'String' COMMENT '参数类型String/Integer/Long/Date/Boolean',
-- 参数位置
param_position VARCHAR(20) NOT NULL DEFAULT 'QUERY' COMMENT '参数位置QUERY/BODY',
-- 参数验证
is_required TINYINT(1) DEFAULT 0 COMMENT '是否必填',
default_value VARCHAR(200) COMMENT '默认值',
-- SQL映射
sql_param_name VARCHAR(100) COMMENT 'SQL参数名',
-- 排序
sort INT DEFAULT 0 COMMENT '排序',
create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间'
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='ERP动态API参数配置表';
-- 创建索引和外键
CREATE INDEX idx_api_id ON erp_api_param(api_id);
ALTER TABLE erp_api_param ADD CONSTRAINT fk_api_param_api
FOREIGN KEY (api_id) REFERENCES erp_api_config(api_id) ON DELETE CASCADE;
-- 3. API 调用统计表
CREATE TABLE IF NOT EXISTS erp_api_stats (
stats_id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT '统计ID',
api_id BIGINT NOT NULL COMMENT 'API ID',
-- 调用信息
call_time DATETIME NOT NULL COMMENT '调用时间',
call_params TEXT COMMENT '调用参数JSON',
response_time INT COMMENT '响应时间ms',
call_status VARCHAR(10) COMMENT '调用状态SUCCESS/ERROR',
-- 错误信息
error_message TEXT COMMENT '错误消息',
error_stack TEXT COMMENT '错误堆栈',
-- 客户端信息
client_ip VARCHAR(50) COMMENT '客户端IP',
user_id VARCHAR(50) COMMENT '用户ID',
create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间'
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='ERP动态API调用统计表';
-- 创建索引
CREATE INDEX idx_api_id_time ON erp_api_stats(api_id, call_time);
CREATE INDEX idx_call_status ON erp_api_stats(call_status);
CREATE INDEX idx_response_time ON erp_api_stats(response_time);
-- 插入菜单配置
-- 注意:需要在 hzhub-system 的 sys_menu 表中执行以下 SQL
-- ERP 管理一级菜单(目录)
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time, remark)
VALUES ('ERP管理', 0, 5, '/erp', 'ParentView', 1, 0, 'M', '0', '0', '', 'monitor', 'admin', NOW(), 'ERP API管理目录');
-- API 配置管理菜单(二级菜单 - 列表页面)
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time, remark)
VALUES ('API配置', (SELECT menu_id FROM (SELECT menu_id FROM sys_menu WHERE menu_name='ERP管理' LIMIT 1) t), 1, 'api', 'erp/api/index', 1, 0, 'C', '0', '0', 'erp:api:list', 'tool', 'admin', NOW(), 'API配置管理页面');
-- API 配置按钮权限(不在菜单显示,只用于按钮级权限控制)
SET @api_menu_id = (SELECT menu_id FROM (SELECT menu_id FROM sys_menu WHERE menu_name='API配置' AND component='erp/api/index' LIMIT 1) t);
-- 注意menu_type='F' 表示按钮visible='1' 表示隐藏不在菜单中显示
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time)
VALUES ('API查询', @api_menu_id, 1, '', NULL, 1, 0, 'F', '1', '0', 'erp:api:query', '#', 'admin', NOW());
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time)
VALUES ('API新增', @api_menu_id, 2, '', NULL, 1, 0, 'F', '1', '0', 'erp:api:add', '#', 'admin', NOW());
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time)
VALUES ('API修改', @api_menu_id, 3, '', NULL, 1, 0, 'F', '1', '0', 'erp:api:edit', '#', 'admin', NOW());
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time)
VALUES ('API删除', @api_menu_id, 4, '', NULL, 1, 0, 'F', '1', '0', 'erp:api:remove', '#', 'admin', NOW());
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time)
VALUES ('API测试', @api_menu_id, 5, '', NULL, 1, 0, 'F', '1', '0', 'erp:api:test', '#', 'admin', NOW());
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time)
VALUES ('清除缓存', @api_menu_id, 6, '', NULL, 1, 0, 'F', '1', '0', 'erp:api:cache', '#', 'admin', NOW());
-- API 监控统计菜单(二级菜单 - 统计页面)
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time, remark)
VALUES ('API监控', (SELECT menu_id FROM (SELECT menu_id FROM sys_menu WHERE menu_name='ERP管理' LIMIT 1) t), 2, 'stats', 'erp/stats/index', 1, 0, 'C', '0', '0', 'erp:api:stats', 'monitor', 'admin', NOW(), 'API调用统计监控页面');

View File

@@ -0,0 +1,158 @@
-- ERP API 管理平台数据库表创建脚本 (SQL Server 版本)
-- 执行顺序:先创建 erp_api_config再创建 erp_api_param最后创建 erp_api_stats
-- 1. API 配置主表
IF NOT EXISTS (SELECT * FROM sysobjects WHERE name='erp_api_config' AND xtype='U')
BEGIN
CREATE TABLE erp_api_config (
api_id BIGINT IDENTITY(1,1) PRIMARY KEY,
api_name NVARCHAR(100) NOT NULL,
api_path NVARCHAR(200) NOT NULL,
api_method NVARCHAR(10) NOT NULL DEFAULT 'GET',
api_desc NVARCHAR(500),
api_version NVARCHAR(10) DEFAULT 'v1',
-- 数据源配置
data_source NVARCHAR(50) DEFAULT 'erp',
-- SQL配置
sql_template NVARCHAR(MAX) NOT NULL,
result_type NVARCHAR(20) NOT NULL DEFAULT 'LIST',
-- 分页配置
support_pagination TINYINT DEFAULT 0,
page_param_name NVARCHAR(50) DEFAULT 'pageNum',
size_param_name NVARCHAR(50) DEFAULT 'pageSize',
-- 权限配置
require_auth TINYINT DEFAULT 0,
permission_code NVARCHAR(100),
-- 缓存配置
enable_cache TINYINT DEFAULT 0,
cache_key_template NVARCHAR(200),
cache_ttl INT DEFAULT 300,
-- 来源表信息
source_table NVARCHAR(100),
source_table_comment NVARCHAR(500),
-- 状态
status TINYINT DEFAULT 1,
create_time DATETIME DEFAULT GETDATE(),
update_time DATETIME DEFAULT GETDATE(),
create_by NVARCHAR(50),
update_by NVARCHAR(50),
remark NVARCHAR(500)
);
PRINT 'Table erp_api_config created successfully';
END
ELSE
BEGIN
PRINT 'Table erp_api_config already exists';
END
GO
-- 创建索引
IF NOT EXISTS (SELECT * FROM sys.indexes WHERE name='idx_api_path_method' AND object_id=OBJECT_ID('erp_api_config'))
CREATE INDEX idx_api_path_method ON erp_api_config(api_path, api_method, api_version);
IF NOT EXISTS (SELECT * FROM sys.indexes WHERE name='idx_status' AND object_id=OBJECT_ID('erp_api_config'))
CREATE INDEX idx_status ON erp_api_config(status);
IF NOT EXISTS (SELECT * FROM sys.indexes WHERE name='idx_source_table' AND object_id=OBJECT_ID('erp_api_config'))
CREATE INDEX idx_source_table ON erp_api_config(source_table);
GO
-- 2. API 参数配置表
IF NOT EXISTS (SELECT * FROM sysobjects WHERE name='erp_api_param' AND xtype='U')
BEGIN
CREATE TABLE erp_api_param (
param_id BIGINT IDENTITY(1,1) PRIMARY KEY,
api_id BIGINT NOT NULL,
-- 参数基本信息
param_name NVARCHAR(100) NOT NULL,
param_desc NVARCHAR(500),
param_type NVARCHAR(20) NOT NULL DEFAULT 'String',
-- 参数位置
param_position NVARCHAR(20) NOT NULL DEFAULT 'QUERY',
-- 参数验证
is_required TINYINT DEFAULT 0,
default_value NVARCHAR(200),
-- SQL映射
sql_param_name NVARCHAR(100),
-- 排序
sort INT DEFAULT 0,
create_time DATETIME DEFAULT GETDATE(),
update_time DATETIME DEFAULT GETDATE()
);
PRINT 'Table erp_api_param created successfully';
END
ELSE
BEGIN
PRINT 'Table erp_api_param already exists';
END
GO
-- 创建索引和外键
IF NOT EXISTS (SELECT * FROM sys.indexes WHERE name='idx_api_id' AND object_id=OBJECT_ID('erp_api_param'))
CREATE INDEX idx_api_id ON erp_api_param(api_id);
IF NOT EXISTS (SELECT * FROM sys.foreign_keys WHERE name='fk_api_param_api')
BEGIN
ALTER TABLE erp_api_param ADD CONSTRAINT fk_api_param_api
FOREIGN KEY (api_id) REFERENCES erp_api_config(api_id) ON DELETE CASCADE;
END
GO
-- 3. API 调用统计表
IF NOT EXISTS (SELECT * FROM sysobjects WHERE name='erp_api_stats' AND xtype='U')
BEGIN
CREATE TABLE erp_api_stats (
stats_id BIGINT IDENTITY(1,1) PRIMARY KEY,
api_id BIGINT NOT NULL,
-- 调用信息
call_time DATETIME NOT NULL,
call_params NVARCHAR(MAX),
response_time INT,
call_status NVARCHAR(10),
-- 错误信息
error_message NVARCHAR(MAX),
error_stack NVARCHAR(MAX),
-- 客户端信息
client_ip NVARCHAR(50),
user_id NVARCHAR(50),
create_time DATETIME DEFAULT GETDATE()
);
PRINT 'Table erp_api_stats created successfully';
END
ELSE
BEGIN
PRINT 'Table erp_api_stats already exists';
END
GO
-- 创建索引
IF NOT EXISTS (SELECT * FROM sys.indexes WHERE name='idx_api_id_time' AND object_id=OBJECT_ID('erp_api_stats'))
CREATE INDEX idx_api_id_time ON erp_api_stats(api_id, call_time);
IF NOT EXISTS (SELECT * FROM sys.indexes WHERE name='idx_call_status' AND object_id=OBJECT_ID('erp_api_stats'))
CREATE INDEX idx_call_status ON erp_api_stats(call_status);
IF NOT EXISTS (SELECT * FROM sys.indexes WHERE name='idx_response_time' AND object_id=OBJECT_ID('erp_api_stats'))
CREATE INDEX idx_response_time ON erp_api_stats(response_time);
GO
PRINT 'All ERP API management tables created successfully';

View File

@@ -0,0 +1,31 @@
-- ERP API管理菜单配置SQL脚本
-- 执行时间2026-04-30
-- 说明添加ERP管理模块到hzhub-system的菜单系统中
-- ERP管理菜单一级菜单
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time, remark)
VALUES ('ERP管理', 0, 5, '/erp', NULL, 1, 0, 'M', '0', '0', '', 'monitor', 'admin', NOW(), 'ERP API管理目录');
-- API配置管理菜单二级菜单
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time, remark)
VALUES ('API配置', (SELECT menu_id FROM (SELECT menu_id FROM sys_menu WHERE menu_name='ERP管理' AND parent_id=0) AS temp), 1, 'api', 'erp/api/index', 1, 0, 'C', '0', '0', 'erp:api:list', 'tool', 'admin', NOW(), 'API配置管理菜单');
-- API配置按钮权限
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time)
VALUES ('API查询', (SELECT menu_id FROM (SELECT menu_id FROM sys_menu WHERE menu_name='API配置' AND path='api') AS temp2), 1, '', NULL, 1, 0, 'F', '0', '0', 'erp:api:query', '#', 'admin', NOW());
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time)
VALUES ('API新增', (SELECT menu_id FROM (SELECT menu_id FROM sys_menu WHERE menu_name='API配置' AND path='api') AS temp2), 2, '', NULL, 1, 0, 'F', '0', '0', 'erp:api:add', '#', 'admin', NOW());
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time)
VALUES ('API修改', (SELECT menu_id FROM (SELECT menu_id FROM sys_menu WHERE menu_name='API配置' AND path='api') AS temp2), 3, '', NULL, 1, 0, 'F', '0', '0', 'erp:api:edit', '#', 'admin', NOW());
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time)
VALUES ('API删除', (SELECT menu_id FROM (SELECT menu_id FROM sys_menu WHERE menu_name='API配置' AND path='api') AS temp2), 4, '', NULL, 1, 0, 'F', '0', '0', 'erp:api:remove', '#', 'admin', NOW());
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time)
VALUES ('API测试', (SELECT menu_id FROM (SELECT menu_id FROM sys_menu WHERE menu_name='API配置' AND path='api') AS temp2), 5, '', NULL, 1, 0, 'F', '0', '0', 'erp:api:test', '#', 'admin', NOW());
-- API监控统计菜单二级菜单
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time, remark)
VALUES ('API监控', (SELECT menu_id FROM (SELECT menu_id FROM sys_menu WHERE menu_name='ERP管理' AND parent_id=0) AS temp), 2, 'stats', 'erp/stats/index', 1, 0, 'C', '0', '0', 'erp:api:stats', 'monitor', 'admin', NOW(), 'API调用统计监控');