# duty-system

**Repository Path**: dev-project_1/duty-system

## Basic Information

- **Project Name**: duty-system
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-14
- **Last Updated**: 2026-04-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 勤务值班系统

## 技术栈

| 端     | 技术                          |
|--------|-------------------------------|
| 前端   | React 18 + Vite + Ant Design 5 |
| 后端   | Node.js + Express             |
| 数据库 | OpenGauss (PostgreSQL兼容)    |

---

## 目录结构

```
duty-system/
├── backend/          # 后端 NodeJS
│   ├── src/
│   │   ├── app.js        # 入口
│   │   ├── config/       # 数据库配置
│   │   ├── middleware/   # JWT鉴权
│   │   ├── routes/       # API路由
│   │   ├── services/     # 业务服务（等级评定/提醒）
│   │   └── scripts/      # 初始化脚本
│   └── .env              # 环境变量
├── frontend/         # 前端 React
│   └── src/
│       ├── pages/
│       │   ├── admin/    # 管理员页面
│       │   └── duty/     # 值勤人员页面
│       ├── api/          # API接口封装
│       ├── store/        # Zustand状态管理
│       └── layouts/      # 布局组件
└── docs/
    └── database.sql      # 数据库DDL
```

---

## 快速启动

### 1. 初始化数据库

确保 OpenGauss 已启动，参数：
- Host: 127.0.0.1 | Port: 5432
- User: root | Password: openGauss@123
- DB: duty-system

执行 DDL：
```bash
psql -h 127.0.0.1 -p 5432 -U root -d duty-system -f docs/database.sql
```

或通过后端脚本初始化：
```bash
cd backend && npm run init-db
```

### 2. 启动后端

```bash
cd backend
npm install
npm run dev      # 开发模式（nodemon）
# 或
npm start        # 生产模式
```

后端运行在：http://localhost:3001

### 3. 启动前端

```bash
cd frontend
npm install
npm run dev      # 开发模式
```

前端运行在：http://localhost:5173

### 4. 打包 Windows EXE（可选）

```bash
cd frontend
npm run build    # 生成 dist/
```

可使用 Electron 包装 dist 目录打包为 EXE。

---

## 默认账号

| 账号  | 密码      | 角色   |
|-------|-----------|--------|
| admin | admin123  | 管理员 |

值勤人员默认密码：`wj00kk`

---

## 主要功能

### 管理员
- 值班总览（数据看板、态势图、先进榜）
- 值勤人员管理（增删改查、重置密码）
- 值勤资格认证管理（季度认证、文件上传）
- 值班事项清单管理（自定义清单、派发）
- 事项变更管理（审批变更申请）
- 监测统计（趋势图、排名）
- 数据管理（佐证材料查询下载）
- 等级评定管理（自动评定、排名）

### 值勤人员
- 今日值班事项（语音提醒、告警、上传佐证）
- 值班历史查询
- 值勤资格认证查看

---

## API 接口说明

| 前缀                | 说明           |
|---------------------|----------------|
| /api/auth           | 认证（登录/账号列表）|
| /api/users          | 用户管理       |
| /api/departments    | 部门管理       |
| /api/seats          | 席位管理       |
| /api/task-lists     | 事项清单管理   |
| /api/duty-records   | 值班记录       |
| /api/evidence       | 佐证材料       |
| /api/qualifications | 资格认证       |
| /api/task-changes   | 变更申请       |
| /api/overview       | 总览/统计      |