# 工资条管理系统

**Repository Path**: stronggg/salary

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-16
- **Last Updated**: 2025-07-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Salary 系统文档

## 项目简介

Salary 是一个基于 Django 的工资管理系统，包含用户认证、部门管理、权限控制、工资条发送、企业微信集成等功能。系统支持用户登录、密码修改、部门管理、角色权限分配、工资条上传与查看等操作。

## 功能模块

### 登录模块 (`apps/login/`)
- 用户登录
- 忘记密码
- 首次登录设置
- 用户登出
- 用户信息管理
- 部门管理
- 权限控制
- 企业微信登录集成

### 工资模块 (`apps/payroll/`)
- 工资条基础信息设置
- 工资条上传与预览
- 工资条发送
- 工资条历史记录查看
- 工资确认
- 企业微信工资条展示

### 首页模块 (`apps/index/`)
- 首页展示
- 用户总数、今日登录用户统计

### 工具模块 (`apps/utils/`)
- 权限检查工具
- 用户代理检测
- 登录混入工具
- Excel 处理
- 消息发送
- 企业微信消息推送

## 安装与部署

### 依赖安装

请确保已安装 Python 和 Django 环境，然后运行以下命令安装依赖：

```bash
pip install -r requirements.txt
```

### 数据库迁移

运行以下命令进行数据库迁移：

```bash
python manage.py migrate
```

### 启动服务

使用以下命令启动开发服务器：

```bash
python manage.py runserver
```

## 使用说明

### 登录系统

访问 `/login/` 页面进行登录，支持企业微信扫码登录。

### 管理部门

登录后，管理员可在 `/dept/` 页面添加、修改、删除部门信息。

### 工资条上传与发送

管理员可在 `/upload/` 页面上传工资条 Excel 文件，并通过 `/send/` 页面发送工资条。

### 查看工资条历史

用户可在 `/history/` 页面查看历史工资条记录。

### 企业微信集成

系统支持企业微信扫码登录和消息推送，相关配置请参考 `apps/utils/wechat.py`。

## 开发者文档

### 模型说明

#### 用户模型 (`UserProfile`)
- 用户名、邮箱、手机号
- 所属部门、直属领导
- 用户角色、权限控制

#### 部门模型 (`Department`)
- 部门名称、描述
- 上级部门、排序字段

#### 工资条模型 (`BasicInfo`, `SentContents`)
- 工资月份、标题、内容
- 发送状态、接收用户

### 视图说明

#### 登录视图 (`UserLoginView`)
处理用户登录逻辑，验证用户名和密码。

#### 工资条上传视图 (`UploadAndPreView`)
上传 Excel 文件并解析工资条数据，支持预览功能。

#### 工资条发送视图 (`SendPayrollView`)
将工资条发送给指定用户，支持邮件和企业微信通知。

#### 部门管理视图 (`DeptView`, `DeptAddView`, `DeptModifyView`)
支持部门的增删改查操作。

## 许可证

本项目使用 MIT 许可证，请参见 `LICENSE` 文件。

## 贡献指南

欢迎贡献代码，请遵循以下步骤：
1. Fork 本项目
2. 创建新分支
3. 提交 Pull Request

## 联系方式

如有问题，请联系项目维护者 stronggg@xxx.com。