# Hrevolve
**Repository Path**: ichistudio/Hrevolve
## Basic Information
- **Project Name**: Hrevolve
- **Description**: A lightweight, open-source Human Resource Management system built for growing teams.
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 2
- **Forks**: 0
- **Created**: 2026-01-01
- **Last Updated**: 2026-02-03
## Categories & Tags
**Categories**: Uncategorized
**Tags**: hrm
## README
# Hrevolve - 企业级 SaaS 人力资源管理系统
现代化 · 智能化 · 一体化
---
## 📖 项目简介
Hrevolve 是一个面向现代企业的 SaaS 人力资源管理平台，采用 **Clean Architecture + DDD（领域驱动设计）** 构建。系统深度融合 AI 能力，致力于从传统的"管理工具"转变为"员工服务平台"和"企业战略决策引擎"。
## 🏗️ 系统架构
```
┌─────────────────────────────────────────────────────────────┐
│ Frontend │
│ Vue 3 + TypeScript + Vite │
└─────────────────────────────┬───────────────────────────────┘
│ REST API
┌─────────────────────────────▼───────────────────────────────┐
│ Hrevolve.Web │
│ ASP.NET Core Web API · 控制器 · 中间件 │
├─────────────────────────────────────────────────────────────┤
│ Hrevolve.Application │
│ CQRS · MediatR · 业务逻辑编排 │
├──────────────────────┬──────────────────────────────────────┤
│ Hrevolve.Domain │ Hrevolve.Agent │
│ 实体 · 值对象 · 事件 │ Microsoft Agent Framework · AI │
├──────────────────────┴──────────────────────────────────────┤
│ Hrevolve.Infrastructure │
│ EF Core · PostgreSQL · Redis · 外部服务 │
├─────────────────────────────────────────────────────────────┤
│ Hrevolve.Shared │
│ 多租户 · 通用组件 · 异常处理 · 工具类 │
└─────────────────────────────────────────────────────────────┘
```
## 🛠️ 技术栈
| 层级 | 技术选型 |
|------|----------|
| **后端框架** | .NET 10 / ASP.NET Core Web API |
| **前端框架** | Vue 3 + TypeScript + Vite |
| **UI 组件** | Element Plus |
| **AI 框架** | Microsoft Agent Framework + Microsoft.Extensions.AI |
| **数据库** | PostgreSQL 16 |
| **ORM** | Entity Framework Core 10 |
| **缓存** | Redis 7 |
| **认证** | JWT + OAuth 2.0 (SSO) |
| **日志** | Serilog |
| **API 文档** | Swagger / OpenAPI |
## ✨ 核心功能
### 基础模块
- 🏢 **组织架构管理** - 树状结构，邻接表 + 路径枚举
- 👤 **员工全生命周期** - SCD Type 2 历史追溯，支持任意时点查询
- 🔐 **用户认证** - JWT、SSO、MFA、微信扫码登录
- 🛡️ **RBAC 权限控制** - 细粒度权限管理
### 业务模块
- ⏰ **考勤管理** - 多源打卡、智能排班、工时核算
- 📅 **假期管理** - 策略引擎、自动计算余额、审批流
- 💰 **薪酬管理** - 规则引擎、批量计算、薪资单
- 💳 **报销管理** - 全流程线上化
### 智能模块
- 🤖 **AI 助手** - 基于 RAG 的 HR Bot，7×24 小时服务
- 📊 **数据分析** - 人力资本仪表盘
- 🔮 **离职预测** - 员工高离职风险预警（规划中）
### 多租户架构
- 🔒 Query Rewriting + RLS 双重数据隔离
- 🔑 Per-Tenant Key 敏感数据加密
- 🏠 支持独立数据库部署（高安全场景）
## 📁 项目结构
```
Hrevolve/
├── Backend/ # 后端项目
│ ├── Hrevolve.Domain/ # 领域层 - 实体、值对象、领域事件
│ ├── Hrevolve.Shared/ # 共享层 - 通用组件、多租户
│ ├── Hrevolve.Infrastructure/ # 基础设施层 - 数据访问、外部服务
│ ├── Hrevolve.Application/ # 应用层 - CQRS、业务逻辑
│ ├── Hrevolve.Agent/ # AI 代理层 - Agent Framework
│ └── Hrevolve.Web/ # Web 层 - API 控制器
├── Frontend/ # 前端项目
│ └── hrevolve-web/ # Vue 3 应用
└── Design/ # 设计文档
├── RequirementsDocument.md # 需求文档
└── *.drawio # 架构图
```
## 🚀 快速开始
### 环境要求
- .NET 10 Preview SDK
- Node.js 18+
- PostgreSQL 16+
- Redis 7+
### 后端启动
```bash
cd Backend
# 还原依赖
dotnet restore
# 数据库迁移
dotnet ef migrations add InitialCreate -p Hrevolve.Infrastructure -s Hrevolve.Web
dotnet ef database update -p Hrevolve.Infrastructure -s Hrevolve.Web
# 运行
dotnet run --project Hrevolve.Web
```
### 前端启动
```bash
cd Frontend/hrevolve-web
# 安装依赖
npm install
# 开发模式
npm run dev
# 生产构建
npm run build
```
### 访问地址
- 后端 API：`https://localhost:5001`
- API 文档：`https://localhost:5001/swagger`
- 前端应用：`http://localhost:5173`
## 📚 文档
- [后端开发文档](Backend/README.md)
- [前端开发文档](Frontend/README.md)
- [需求规格说明](Design/RequirementsDocument.md)
- [AI 助手设计](Design/Agent.md)
## 📄 许可证
[MIT License](LICENSE)