hzhub/hzhub-ai/docs/文件上传接口文档.md at 226f11960726e92d17c6d12d48fa7b1365cb770e

Files

大壮 c2513849b4 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>

2026-05-08 08:00:19 +00:00

1022 B

Executable File

Raw Blame History

接口信息

接口路径: POST /resource/oss/upload 请求类型: multipart/form-data 权限要求: system:oss:upload 业务类型: [INSERT]

接口描述

上传OSS对象存储接口，用于将文件上传到对象存储服务。

请求参数

参数名	类型	必填	说明
file	MultipartFile	是	要上传的文件

请求头

Content-Type: multipart/form-data

返回值

返回 R<SysOssUploadVo> 类型，包含以下字段：

字段名	类型	说明
url	String	文件访问URL
fileName	String	原始文件名
ossId	String	文件ID

响应示例

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "url": "fileid://xxx",
    "fileName": "example.jpg",
    "ossId": "123"
  }
}

异常情况

当上传文件为空时，返回错误信息："上传文件不能为空"

1022 B Executable File Raw Blame History Unescape Escape