Files
hzhub/hzhub-portal-employee
大壮 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
..

HZHub 员工门户

企业员工门户系统

HZHub 企业员工门户提供审批流程、销售CRM、BI报表、AI应用集成等功能

后端服务 | 管理后台 | 经销商门户

功能特性

  • 🔄 审批流程: 支持多级审批、流程管理
  • 📊 BI报表: 实时数据分析、可视化报表
  • 🤝 CRM管理: 客户管理、销售跟踪
  • 🤖 AI应用: AI助手、智能问答
  • 📱 企业微信: 支持企业微信H5集成

技术栈

  • 框架: Vue 3 + TypeScript
  • UI组件: Element Plus
  • 状态管理: Pinia
  • 构建工具: Vite
  • HTTP请求: hook-fetch (支持SSE流式传输)

Docker 部署

一键启动(推荐)

cd hzhub-deploy
docker-compose up -d

# 访问员工门户
# 地址: http://localhost:5137

单独部署

# 进入项目目录
cd hzhub-portal-employee

# 构建并启动
docker-compose up -d --build

服务端口

服务 端口 说明
员工门户 5137 员工前端访问地址
经销商门户 5138 经销商前端访问地址
管理后台 5666 管理后台访问地址
后端服务 6039 后端 API 服务

本地开发

# 安装依赖
pnpm install

# 启动开发服务器
pnpm dev

# 类型检查
pnpm build

# 代码检查
pnpm lint

环境变量配置

项目根目录 .env.development 文件:

VITE_API_URL=              # 后端API地址默认通过Vite代理
VITE_CLIENT_ID=e5cd7e4891bf95d1d19206ce24a7b32e
VITE_WEB_TITLE=Employee Portal 企业员工门户

登录超时配置

员工门户默认登录超时时间为30分钟可通过修改数据库配置调整为1小时或其他时长。

详细配置说明: TIMEOUT_CONFIG.md

快速修改:

# 执行SQL更新超时时间为1小时
mysql -u root -phzhub123 hzhub < /tmp/update_timeout_1hour.sql

注意: 修改后需要重新登录才能生效。

多租户支持

系统支持多租户架构,不同公司实体(集团总部、汇亚公司、恒福公司、玛缇公司)通过登录时选择不同租户进行数据隔离。

登录方式

  1. URL参数方式: http://localhost:5137/login?tenant=000002
  2. 手动选择方式: 在登录界面选择公司

项目结构

hzhub-portal-employee/
├── src/
│   ├── api/           # API模块
│   ├── components/    # 可复用组件
│   ├── layouts/       # 布局组件
│   ├── pages/         # 页面组件
│   ├── routers/       # 路由配置
│   ├── stores/        # Pinia状态管理
│   ├── styles/        # 样式文件
│   └── utils/         # 工具函数
├── public/            # 静态资源
├── .env.development   # 开发环境配置
├── Dockerfile         # Docker构建文件
├── nginx.conf         # Nginx配置
└── package.json       # 项目配置

常见问题

Q: 如何切换不同公司登录?

A: 通过URL参数 ?tenant=租户ID 或在登录页面手动选择公司。

Q: 如何连接后端服务?

A: 开发环境通过Vite代理生产环境通过Nginx代理配置 UPSTREAM_URL

开源协议

本项目采用 MIT 开源协议


❤️ 打造,由 HZHub 团队维护