# ChronoTrack

**Repository Path**: Agions/ChronoTrack

## Basic Information

- **Project Name**: ChronoTrack
- **Description**: ChronoTrack（时间追踪者）是一套现代化的工时与薪资管理系统，帮助企业高效管理员工考勤、工时记录和薪资计算。系统提供直观的界面和强大的功能，满足企业从小型团队到大型组织的各种需求
- **Primary Language**: TypeScript
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-02-05
- **Last Updated**: 2025-03-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ChronoTrack 智能工时与薪资管理系统

ChronoTrack（时间追踪者）是一套现代化的工时与薪资管理系统，帮助企业高效管理员工考勤、工时记录和薪资计算。系统提供直观的界面和强大的功能，满足企业从小型团队到大型组织的各种需求。

## 🌟 系统特点

- **智能考勤管理**：支持地理位置验证、人脸识别和指纹打卡，确保考勤记录真实可靠
- **灵活的工时记录**：支持多种工作模式，包括固定工时、弹性工作制和远程办公
- **精准薪资计算**：自动计算基本工资、加班费、奖金和扣除项，确保薪资准确无误
- **强大的数据分析**：提供多维度的统计报表，帮助管理者做出明智决策
- **安全可靠**：采用JWT认证机制，确保数据安全性
- **易于集成**：提供标准REST API，方便与其他系统集成

## 🔧 技术栈

- **后端**：NestJS框架 + TypeScript
- **数据库**：MongoDB
- **认证**：JWT (JSON Web Token)
- **API文档**：Swagger
- **容器化**：Docker

## 💻 核心功能模块

### 用户认证模块
- 用户注册、登录、登出
- 支持手机号验证码登录
- 人脸识别/指纹登录
- 密码重置功能

### 考勤打卡模块
- 上下班打卡（支持地理位置验证）
- 打卡记录查询（日/周/月）
- 打卡统计（工时计算、迟到早退统计）
- 地理围栏设置（定义有效打卡范围）

### 个人信息管理模块
- 用户基本信息管理
- 头像上传与管理
- 个人设置保存（通知偏好、界面偏好）
- 账号安全设置

### 薪资管理模块
- 薪资记录查询
- 薪资详情（基本工资、绩效、加班费等）
- 薪资单生成与导出
- 薪资趋势分析

### 数据统计模块
- 工时统计
- 考勤异常统计
- 加班统计
- 团队工时分析

### 管理员功能模块
- 员工管理
- 部门管理
- 角色权限管理
- 系统配置

## ⚙️ 安装与运行

### 使用pnpm安装依赖
```bash
$ pnpm install
```

### 运行应用
```bash
# 开发模式
$ pnpm run start

# 监视模式
$ pnpm run start:dev

# 生产模式
$ pnpm run start:prod
```

### 使用Docker运行
```bash
# 构建和启动容器
$ docker-compose up -d
```

## 🧪 测试

```bash
# 单元测试
$ pnpm run test

# e2e测试
$ pnpm run test:e2e

# 测试覆盖率
$ pnpm run test:cov
```

## 📖 API文档

启动应用后，访问 http://localhost:5000/docs 查看Swagger API文档

## 📄 许可证

本项目基于 [MIT 许可证](LICENSE)