# 检定证书管理系统

**Repository Path**: ydbso/calibration_system

## Basic Information

- **Project Name**: 检定证书管理系统
- **Description**: 检定证书管理系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-24
- **Last Updated**: 2026-03-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 鼎钧毫计量检测 - 检定证书管理系统

一套完整的计量器具检定工作流程管理系统，支持电子汽车衡等设备的检定、证书生成管理。

**系统名称**: 鼎钧毫计量检测
**适用范围**: 计量检测机构、质检部门

## 系统概述

本系统面向计量检测机构，提供从客户管理、设备台账、标准器管理到检定任务执行的完整业务流程，最终生成符合国家规范的检定证书。

## 核心功能

### 客户管理
维护送检客户的基本信息，包括单位名称、地址、联系人、联系电话等。支持客户信息的新增、编辑、删除和查询。

### 设备台账
管理计量器具的基础信息，包括器具名称、型号规格、出厂编号、制造厂商、最大秤量、分度值、准确度等级等。系统自动计算检定到期日，并提供到期提醒功能。

### 标准器管理
维护用于检定的标准器信息，记录标准器名称、测量范围、准确度等级、证书编号、有效期等，支持标准器使用状态的管理。

### 模板管理
上传和管理检定证书模板（Word格式）和原始记录模板（Excel格式）。模板支持分类管理，可按不同设备类型配置对应模板。

### 检定任务
完整的检定工作流程管理：

- **任务创建**: 选择客户和设备，自动生成证书编号
- **数据录入**: 录入各项检定数据
  - 置零准确度测试
  - 称量测试（加载和卸载）
  - 除皮准确度测试
  - 除皮后的称量测试
  - 重复性测试
  - 偏载测试
  - 鉴别阈测试
- **工作流**: 草稿 → 待审核 → 已通过
- **证书生成**: 根据模板自动生成检定证书和原始记录
- **文件下载**: 下载生成的证书和原始记录文件

### 仪表板
展示系统关键数据统计，包括客户数量、设备数量、检定任务数量，以及即将到期和已过期设备提醒。

## 开发环境配置

### 环境要求
- Node.js >= 18.x
- MySQL 5.7

### 安装步骤

**1. 安装 Node.js**
- 下载地址：https://nodejs.org/
- 安装 LTS 版本，按向导完成安装

**2. 安装 MySQL 5.7**
- 下载地址：https://dev.mysql.com/downloads/installer/
- 安装时设置 root 密码
- 创建数据库：
```sql
CREATE DATABASE calibration_system CHARACTER SET utf8mb4;
```

**3. 配置数据库连接**
编辑 `server/config/database.js`，填写数据库密码：
```javascript
const dbConfig = {
  host: '127.0.0.1',
  port: 3306,
  user: 'root',
  password: '你的密码',
  database: 'calibration_system'
};
```

**4. 启动后端服务**
```bash
cd server
npm install
npm run dev
```
后端运行在 http://localhost:3001

**5. 启动前端服务**
新开一个终端：
```bash
cd client
npm install
npm run dev
```
前端运行在 http://localhost:5173

**6. 访问系统**
浏览器打开 http://localhost:5173
默认账号：admin / 123456

## 业务规范

### 检定依据
- 电子汽车衡检定依据 JJG 539-2016《数字指示秤》

### 证书编号规则
- 格式：`{前缀}{年份}{序号}`，如 JL2025001
- 按类别独立计数：A-衡器类、B-砝码类、Y-压力表类
- 每年序号自动重置

### 检定项目
1. 置零准确度
2. 称量测试（含加载和卸载）
3. 除皮准确度
4. 除皮后的称量测试
5. 重复性测试
6. 偏载测试
7. 鉴别阈测试

## 开发说明

### 前端开发
- 所有 API 请求封装在 `client/src/api/index.js`
- 页面组件位于 `client/src/pages/` 目录
- 路由配置在 `client/src/router/index.jsx`
- 使用 Ant Design 组件库，中文 locale 已配置

### 后端开发
- 控制器处理 HTTP 请求，位于 `server/controllers/`
- 模型层使用 BaseModel 基类，支持基础 CRUD
- 业务逻辑封装在 Service 层
- JWT 认证中间件保护需要登录的接口

### 代码规范
- 统一使用 async/await 处理异步
- API 响应格式：`{ code, success, message, data }`
- 数据库操作使用参数化查询防注入

## 安全特性

- JWT 身份认证
- 密码 bcrypt 加密存储
- SQL 注入防护（参数化查询）
- CORS 跨域配置

## 浏览器兼容性

- Chrome/Edge 最新版
- Firefox 最新版
- Safari 最新版