Industrial-image-management.../src/views/system-resource/device-management/procurement/README.md

6.2 KiB
Raw Blame History

设备采购模块

功能概述

设备采购模块是一个完整的企业设备采购管理系统,提供设备采购的全生命周期管理,包括采购申请、订单管理、供应商管理、设备入库等功能。

主要功能

1. 采购记录管理

  • 新增采购记录:支持完整的设备采购信息录入
  • 编辑采购记录:修改已存在的采购记录信息
  • 查看采购记录:查看采购记录的详细信息
  • 删除采购记录:删除不需要的采购记录

2. 搜索功能

  • 多条件搜索:支持按设备名称、型号、供应商、状态等条件搜索
  • 时间范围搜索:支持按采购时间、入库时间、启用时间范围搜索
  • 价格范围搜索:支持按价格范围搜索
  • 状态搜索:支持按设备状态、位置状态、健康状态搜索

3. 数据展示

  • 统计卡片:显示采购总数、待处理、已完成、采购总额等统计信息
  • 表格展示:分页展示采购记录列表
  • 状态标签:使用不同颜色的标签显示设备状态
  • 价格格式化:自动格式化价格显示

4. 数据导出

  • Excel导出支持将采购记录导出为Excel文件
  • 筛选导出:支持按搜索条件导出数据

技术架构

前端技术栈

  • Vue 3使用Composition API
  • TypeScript:提供类型安全
  • Arco Design VueUI组件库
  • Vite:构建工具

后端技术栈

  • Spring Boot:后端框架
  • MyBatis PlusORM框架
  • MySQL:数据库
  • SwaggerAPI文档

数据模型

  • EquipmentEntity:设备实体类
  • EquipmentReq:设备请求类
  • EquipmentResp:设备响应类
  • EquipmentListReq:设备列表查询请求类

文件结构

procurement/
├── index.vue                    # 主页面
├── components/
│   ├── ProcurementSearch.vue    # 搜索组件
│   └── ProcurementModal.vue     # 弹窗组件
├── test.vue                     # 测试页面
└── README.md                    # 说明文档

API接口

1. 分页查询

  • 接口GET /equipment/procurement/page
  • 参数EquipmentListReq
  • 返回PageResult

2. 新增采购

  • 接口POST /equipment/procurement
  • 参数EquipmentReq
  • 返回Result

3. 更新采购

  • 接口PUT /equipment/procurement/{equipmentId}
  • 参数EquipmentReq
  • 返回Result

4. 删除采购

  • 接口DELETE /equipment/procurement/{equipmentId}
  • 参数equipmentId
  • 返回Result

5. 获取详情

  • 接口GET /equipment/procurement/detail/{equipmentId}
  • 参数equipmentId
  • 返回Result

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. 安装依赖

npm install

3. 启动开发服务器

npm run dev

4. 构建生产版本

npm run build

5. 代码规范

  • 使用ESLint进行代码检查
  • 使用Prettier进行代码格式化
  • 遵循Vue 3 Composition API最佳实践

更新日志

v1.0.0 (2025-01-XX)

  • 初始版本发布
  • 实现基本的CRUD功能
  • 实现搜索和导出功能
  • 实现统计信息展示
  • 实现响应式设计

联系方式

如有问题或建议,请联系开发团队。