210 lines
6.2 KiB
Markdown
210 lines
6.2 KiB
Markdown
# 设备采购模块
|
||
|
||
## 功能概述
|
||
|
||
设备采购模块是一个完整的企业设备采购管理系统，提供设备采购的全生命周期管理，包括采购申请、订单管理、供应商管理、设备入库等功能。
|
||
|
||
## 主要功能
|
||
|
||
### 1. 采购记录管理
|
||
- **新增采购记录**：支持完整的设备采购信息录入
|
||
- **编辑采购记录**：修改已存在的采购记录信息
|
||
- **查看采购记录**：查看采购记录的详细信息
|
||
- **删除采购记录**：删除不需要的采购记录
|
||
|
||
### 2. 搜索功能
|
||
- **多条件搜索**：支持按设备名称、型号、供应商、状态等条件搜索
|
||
- **时间范围搜索**：支持按采购时间、入库时间、启用时间范围搜索
|
||
- **价格范围搜索**：支持按价格范围搜索
|
||
- **状态搜索**：支持按设备状态、位置状态、健康状态搜索
|
||
|
||
### 3. 数据展示
|
||
- **统计卡片**：显示采购总数、待处理、已完成、采购总额等统计信息
|
||
- **表格展示**：分页展示采购记录列表
|
||
- **状态标签**：使用不同颜色的标签显示设备状态
|
||
- **价格格式化**：自动格式化价格显示
|
||
|
||
### 4. 数据导出
|
||
- **Excel导出**：支持将采购记录导出为Excel文件
|
||
- **筛选导出**：支持按搜索条件导出数据
|
||
|
||
## 技术架构
|
||
|
||
### 前端技术栈
|
||
- **Vue 3**：使用Composition API
|
||
- **TypeScript**：提供类型安全
|
||
- **Arco Design Vue**：UI组件库
|
||
- **Vite**：构建工具
|
||
|
||
### 后端技术栈
|
||
- **Spring Boot**：后端框架
|
||
- **MyBatis Plus**：ORM框架
|
||
- **MySQL**：数据库
|
||
- **Swagger**：API文档
|
||
|
||
### 数据模型
|
||
- **EquipmentEntity**：设备实体类
|
||
- **EquipmentReq**：设备请求类
|
||
- **EquipmentResp**：设备响应类
|
||
- **EquipmentListReq**：设备列表查询请求类
|
||
|
||
## 文件结构
|
||
|
||
```
|
||
procurement/
|
||
├── index.vue # 主页面
|
||
├── components/
|
||
│ ├── ProcurementSearch.vue # 搜索组件
|
||
│ └── ProcurementModal.vue # 弹窗组件
|
||
├── test.vue # 测试页面
|
||
└── README.md # 说明文档
|
||
```
|
||
|
||
## API接口
|
||
|
||
### 1. 分页查询
|
||
- **接口**：`GET /equipment/procurement/page`
|
||
- **参数**：EquipmentListReq
|
||
- **返回**：PageResult<EquipmentResp>
|
||
|
||
### 2. 新增采购
|
||
- **接口**：`POST /equipment/procurement`
|
||
- **参数**：EquipmentReq
|
||
- **返回**：Result<null>
|
||
|
||
### 3. 更新采购
|
||
- **接口**：`PUT /equipment/procurement/{equipmentId}`
|
||
- **参数**：EquipmentReq
|
||
- **返回**：Result<null>
|
||
|
||
### 4. 删除采购
|
||
- **接口**：`DELETE /equipment/procurement/{equipmentId}`
|
||
- **参数**：equipmentId
|
||
- **返回**：Result<null>
|
||
|
||
### 5. 获取详情
|
||
- **接口**：`GET /equipment/procurement/detail/{equipmentId}`
|
||
- **参数**：equipmentId
|
||
- **返回**：Result<EquipmentResp>
|
||
|
||
### 6. 导出数据
|
||
- **接口**：`GET /equipment/procurement/export`
|
||
- **参数**：EquipmentListReq
|
||
- **返回**：Blob
|
||
|
||
## 使用说明
|
||
|
||
### 1. 访问页面
|
||
在浏览器中访问设备采购模块页面。
|
||
|
||
### 2. 查看数据
|
||
页面会自动加载采购记录列表，显示统计信息和数据表格。
|
||
|
||
### 3. 搜索数据
|
||
点击"搜索采购"按钮，在弹出的搜索弹窗中输入搜索条件，点击"搜索"按钮。
|
||
|
||
### 4. 新增记录
|
||
点击"新增采购"按钮，在弹出的表单中填写设备采购信息，点击"确定"按钮。
|
||
|
||
### 5. 编辑记录
|
||
在表格中点击"编辑"按钮，在弹出的表单中修改信息，点击"确定"按钮。
|
||
|
||
### 6. 删除记录
|
||
在表格中点击"删除"按钮，确认删除操作。
|
||
|
||
### 7. 导出数据
|
||
点击"导出"按钮，选择保存位置下载Excel文件。
|
||
|
||
## 字段说明
|
||
|
||
### 基本信息
|
||
- **设备名称**：设备的名称
|
||
- **设备类型**：设备的分类（检测设备、安防设备、办公设备、车辆等）
|
||
- **设备型号**：设备的具体型号
|
||
- **序列号**：设备的唯一序列号
|
||
- **品牌**：设备的品牌
|
||
- **资产编号**：设备的资产编号
|
||
- **配置规格**：设备的配置规格和参数
|
||
|
||
### 采购信息
|
||
- **采购订单**：采购订单号
|
||
- **供应商**：供应商名称
|
||
- **数量**：采购数量
|
||
- **单价**：设备单价
|
||
- **总价**：设备总价
|
||
- **采购价格**：采购价格
|
||
- **当前净值**：设备的当前净值
|
||
- **采购时间**：采购时间
|
||
- **入库时间**：入库时间
|
||
- **启用时间**：启用时间
|
||
- **预计报废时间**：预计报废时间
|
||
- **折旧方法**：折旧方法（直线折旧、余额递减、年数总和）
|
||
- **折旧年限**：折旧年限
|
||
- **残值**：设备残值
|
||
- **保修截止日期**：保修截止日期
|
||
|
||
### 状态信息
|
||
- **设备状态**：设备状态（正常、维修中、已报废、闲置、丢失）
|
||
- **使用状态**：使用状态（空闲中、使用中）
|
||
- **位置状态**：位置状态（库存中、使用中、维修中、已报废、外借中、丢失、闲置）
|
||
- **健康状态**：健康状态（优秀、良好、一般、较差、危险）
|
||
- **负责人**：设备负责人
|
||
- **维护人员**：维护人员
|
||
- **物理位置**：设备的物理位置
|
||
- **库存条码**：库存条码
|
||
- **上次维护日期**：上次维护日期
|
||
- **下次维护日期**：下次维护日期
|
||
|
||
### 其他信息
|
||
- **次户号**：次户号
|
||
- **盘点依据**：盘点依据
|
||
- **动态记录**：动态记录信息
|
||
- **资产备注**：资产备注信息
|
||
|
||
## 注意事项
|
||
|
||
1. **数据验证**：所有必填字段都需要填写，系统会进行数据验证
|
||
2. **权限控制**：不同用户可能有不同的操作权限
|
||
3. **数据安全**：敏感数据会进行加密处理
|
||
4. **性能优化**：大量数据时会进行分页处理
|
||
5. **错误处理**：系统会显示友好的错误提示
|
||
|
||
## 开发说明
|
||
|
||
### 1. 开发环境
|
||
- Node.js 16+
|
||
- Vue 3.3+
|
||
- TypeScript 5.0+
|
||
|
||
### 2. 安装依赖
|
||
```bash
|
||
npm install
|
||
```
|
||
|
||
### 3. 启动开发服务器
|
||
```bash
|
||
npm run dev
|
||
```
|
||
|
||
### 4. 构建生产版本
|
||
```bash
|
||
npm run build
|
||
```
|
||
|
||
### 5. 代码规范
|
||
- 使用ESLint进行代码检查
|
||
- 使用Prettier进行代码格式化
|
||
- 遵循Vue 3 Composition API最佳实践
|
||
|
||
## 更新日志
|
||
|
||
### v1.0.0 (2025-01-XX)
|
||
- 初始版本发布
|
||
- 实现基本的CRUD功能
|
||
- 实现搜索和导出功能
|
||
- 实现统计信息展示
|
||
- 实现响应式设计
|
||
|
||
## 联系方式
|
||
|
||
如有问题或建议，请联系开发团队。 |