feat: 添加员工门户项目及相关后端改造

- 新增 hzhub-portal-employee 员工门户前端项目(基于 Vue3 + Element Plus)
- 后端登录接口增加返回 nickName 字段
- 移除 KnowledgeInfoController 的 @SaCheckPermission 注解
- 删除 hzhub-portal-company 旧门户项目
- 更新项目文档和架构说明
- 添加后台运行管理脚本(start-all.sh / status-all.sh / stop-all.sh)
- 更新 docker-compose 配置

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
大壮
2026-04-13 03:47:33 +00:00
parent 4e82f8e1e2
commit 278e507e8a
1310 changed files with 7243 additions and 1248 deletions

View File

@@ -0,0 +1,149 @@
# HZHub 员工门户
<div align="center">
### 企业员工门户系统
*HZHub 企业员工门户提供审批流程、销售CRM、BI报表、AI应用集成等功能*
**[后端服务](https://github.com/hzhub/hzhub-ai)** | **[管理后台](https://github.com/hzhub/hzhub-admin)** | **[经销商门户](https://github.com/hzhub/hzhub-portal-dealer)**
</div>
## 功能特性
- 🔄 **审批流程**: 支持多级审批、流程管理
- 📊 **BI报表**: 实时数据分析、可视化报表
- 🤝 **CRM管理**: 客户管理、销售跟踪
- 🤖 **AI应用**: AI助手、智能问答
- 📱 **企业微信**: 支持企业微信H5集成
## 技术栈
- **框架**: Vue 3 + TypeScript
- **UI组件**: Element Plus
- **状态管理**: Pinia
- **构建工具**: Vite
- **HTTP请求**: hook-fetch (支持SSE流式传输)
## Docker 部署
### 一键启动(推荐)
```bash
cd hzhub-deploy
docker-compose up -d
# 访问员工门户
# 地址: http://localhost:5137
```
### 单独部署
```bash
# 进入项目目录
cd hzhub-portal-employee
# 构建并启动
docker-compose up -d --build
```
### 服务端口
| 服务 | 端口 | 说明 |
|------|------|------|
| 员工门户 | 5137 | 员工前端访问地址 |
| 经销商门户 | 5138 | 经销商前端访问地址 |
| 管理后台 | 5666 | 管理后台访问地址 |
| 后端服务 | 6039 | 后端 API 服务 |
## 本地开发
```bash
# 安装依赖
pnpm install
# 启动开发服务器
pnpm dev
# 类型检查
pnpm build
# 代码检查
pnpm lint
```
## 环境变量配置
项目根目录 `.env.development` 文件:
```bash
VITE_API_URL= # 后端API地址默认通过Vite代理
VITE_CLIENT_ID=e5cd7e4891bf95d1d19206ce24a7b32e
VITE_WEB_TITLE=Employee Portal 企业员工门户
```
## 登录超时配置
员工门户默认登录超时时间为30分钟可通过修改数据库配置调整为1小时或其他时长。
**详细配置说明**: [TIMEOUT_CONFIG.md](./TIMEOUT_CONFIG.md)
**快速修改**:
```bash
# 执行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 开源协议**
---
<div align="center">
*用 ❤️ 打造,由 HZHub 团队维护*
</div>