# 人资管理系统

**Repository Path**: xidear/hr

## Basic Information

- **Project Name**: 人资管理系统
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-24
- **Last Updated**: 2025-09-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# HR管理系统

基于Laravel 12 + Vue 3 + Ant Design Vue Pro的现代化人力资源管理系统。

## 技术栈

### 后端
- **框架**: Laravel 12.x
- **PHP版本**: 8.2+
- **数据库**: MySQL 8.0+
- **缓存**: Redis 6.0+
- **认证**: Laravel Sanctum

### 前端
- **框架**: Vue 3.5+
- **UI库**: Ant Design Vue 4.x
- **语言**: TypeScript 5.x
- **状态管理**: Pinia
- **构建工具**: Vite

## 项目结构

```
├── backend/                 # Laravel后端
│   ├── app/                # 应用核心代码
│   ├── config/             # 配置文件
│   ├── database/           # 数据库相关
│   ├── routes/             # 路由定义
│   └── tests/              # 测试文件
├── frontend/               # Vue前端
│   ├── src/                # 源代码
│   ├── public/             # 静态资源
│   └── package.json        # 依赖配置
└── docs/                   # 项目文档
```

## 开发环境搭建

### 后端环境要求
- PHP 8.2+
- Composer 2.0+
- MySQL 8.0+
- Redis 6.0+

### 前端环境要求
- Node.js 20.19+ 或 22.12+
- npm 或 yarn

## 快速开始

### 1. 克隆项目
```bash
git clone <repository-url>
cd hr-1
```

### 2. 后端设置
```bash
cd backend
composer install
cp .env.example .env
php artisan key:generate
php artisan migrate
php artisan serve
```

### 3. 前端设置
```bash
cd frontend
npm install
npm run dev
```

## 开发规范

### 代码风格
- 后端遵循PSR-12标准
- 前端使用ESLint + Prettier
- 统一使用EditorConfig配置

### 提交规范
使用Conventional Commits规范：
- `feat`: 新功能
- `fix`: 修复bug
- `docs`: 文档更新
- `style`: 代码格式调整
- `refactor`: 代码重构
- `test`: 测试相关
- `chore`: 构建过程或辅助工具的变动

### 分支策略
- `main`: 主分支，用于生产环境
- `develop`: 开发分支
- `feature/*`: 功能分支
- `hotfix/*`: 热修复分支

## 测试

### 后端测试
```bash
cd backend
php artisan test
```

### 前端测试
```bash
cd frontend
npm run test
```

## 部署

### 生产环境部署
1. 配置环境变量
2. 运行数据库迁移
3. 优化Laravel配置
4. 构建前端资源
5. 配置Web服务器

## 贡献指南

1. Fork项目
2. 创建功能分支
3. 提交更改
4. 推送到分支
5. 创建Pull Request

## 许可证

MIT License

## 联系方式

如有问题，请联系开发团队。