-- 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调用统计监控页面');