# 设备质保期查询系统 - 功能详解

## 项目概述

设备质保期查询系统是一套极简的设备质保/保修/包换期查询系统，包含前端H5查询页面和后端PC管理后台，使用MySQL 5.7作为数据库。

## 核心功能

### 1. H5 前端查询页（用户端）

- **设备编号查询**：用户可以通过输入设备编号查询设备的质保状态

- **实时质保状态计算**：系统会根据当前时间和质保开始时间，自动计算并显示设备的质保阶段

- **详细信息展示**：查询结果包括设备名称、设备编号、质保开始时间、包换期时长、保修期时长和当前质保状态

- **质保状态判断**：

  - 在包换期内：当前时间 - 质保开始时间 ≤ 后台设置的包换期

  - 在保修期内：包换期 < 当前时间 - 质保开始时间 ≤ 后台设置的保修期

  - 已过保：当前时间 - 质保开始时间 > 后台设置的保修期

- **响应式设计**：适配各种移动设备屏幕

- **专业UI**：使用蓝色渐变主题，界面美观现代

### 2. PC 管理后台（管理员端）

- **管理员登录**：使用账号密码登录系统

- **设备管理**：

  - 添加设备：输入设备名称、设备编号（w一）和质保开始时间

  - 查看设备列表：显示所有已添加设备的详细信息

- **质保规则设置**：

  - 包换期设置：可自定义包换期时长（单位：年）

  - 保修期设置：可自定义保修期总时长（单位：年）

  - 实时生效：保存后前端立即按新规则计算质保状态

- **退出功能**：管理员可以通过头部的退出按钮退出系统

- **专业UI**：使用蓝色主题，界面简洁大方

### 3. 后端 API 接口

- **设备查询接口**：`GET /api/device/:sn` - 根据设备编号查询设备信息和质保状态

- **管理员登录接口**：`POST /api/login` - 验证管理员账号密码

- **设备管理接口**：

  - `GET /api/devices` - 获取设备列表

  - `POST /api/devices` - 添加新设备

- **配置管理接口**：

  - `GET /api/config` - 获取当前质保规则配置

  - `PUT /api/config` - 更新质保规则配置

- **错误处理**：完善的错误处理和日志记录

### 4. 数据库结构

- **admin表**：存储管理员账号密码

- **device表**：存储设备信息（设备名称、设备编号、质保开始时间）

- **config表**：存储质保规则配置（包换期、保修期）

- **示例数据**：包含测试设备和默认配置数据

### 3. 系统优势

- **极简设计**：功能专注，操作简单

- **实时数据**：所有数据都是实时的，无模拟数据

- **灵活配置**：后台可自由设置包换期和保修期

- **自动计算**：前端自动判断质保阶段，无需人工计算

- **专业UI**：现代化的界面设计，用户体验良好

## 业务流程

1. **管理员设置质保规则**：

   - 登录后台管理系统

   - 进入「质保规则设置」页面

   - 设置包换期和保修期时长

   - 保存设置

2. **管理员添加设备**：

   - 进入「设备管理」页面

   - 填写设备信息（设备名称、设备编号、质保开始时间）

   - 点击「添加」按钮

3. **用户查询质保状态**：

   - 访问H5查询页面

   - 输入设备编号

   - 点击「查询」按钮

   - 查看设备信息和当前质保状态

## 登录信息

- **管理员账号**：admin

- **密码**：123456

## 示例设备

- **SN001**：测试设备1（2024-01-01开始质保）

- **SN002**：测试设备2（2023-01-01开始质保）

- **SN003**：测试设备3（2022-01-01开始质保）

系统已经完全按照需求实现，所有功能均已测试可用。

定制看需求，一般几小时内完成，也不贵。