DM-ROW 接口文档

Appearance

项目概述 ​

**本文引用的文件** - [app/devicemate-app/README.md](file://app/devicemate-app/README.md) - [dm/lemes-web/README.md](file://dm/lemes-web/README.md) - [lemes-cloud/README.md](file://lemes-cloud/README.md) - [lemes-job-devicemate/pom.xml](file://lemes-job-devicemate/pom.xml) - [docs/info/信息整理/DM信息整理.md](file://docs/info/信息整理/DM信息整理.md) - [app/devicemate-app/package.json](file://app/devicemate-app/package.json) - [dm/lemes-web/package.json](file://dm/lemes-web/package.json) - [app/devicemate-app/pages.json](file://app/devicemate-app/pages.json) - [dm/lemes-web/src/router/index.js](file://dm/lemes-web/src/router/index.js) - [lemes-cloud/lemes-business-devicemate/lemes-service-dm-device/readme.md](file://lemes-cloud/lemes-business-devicemate/lemes-service-dm-device/readme.md) - [lemes-cloud/lemes-business-devicemate/lemes-service-dm-store/readme.md](file://lemes-cloud/lemes-business-devicemate/lemes-service-dm-store/readme.md) - [lemes-cloud/lemes-business-devicemate/lemes-service-dm-workflow/readme.md](file://lemes-cloud/lemes-business-devicemate/lemes-service-dm-workflow/readme.md)

目录 ​

  1. 引言
  2. 项目结构
  3. 核心组件
  4. 架构总览
  5. 详细组件分析
  6. 依赖关系分析
  7. 性能考量
  8. 故障排查指南
  9. 结论
  10. 附录

引言 ​

DeviceMate（设备管理与维护系统）面向制造业设备全生命周期管理，围绕“设备台账、维护计划、工单流程、库存管理”等核心业务场景，提供移动端与Web端协同的数字化能力。系统采用前后端分离与微服务架构，后端基于Spring Cloud生态与Nacos服务治理，结合弹性任务调度中心，支撑设备运维、巡检、维修与备件库存的闭环管理；前端覆盖H5/小程序/APP多端，提供统一交互体验。

本项目旨在帮助初学者快速理解系统定位与边界，同时为有经验的开发者提供技术栈、模块划分与部署运维的关键信息。

项目结构 ​

项目由三大主体构成：

  • 移动端前端（uni-app）：负责设备管理、巡检、维修、工单执行与个人中心等移动端能力。
  • Web前端（Vue2 + ElementUI）：提供后台管理、报表与流程配置等管理端能力。
  • 微服务后端（Spring Cloud + Nacos + ElasticJob）：按业务域拆分为设备、库存、工作流等服务，并通过网关统一接入。

图表来源

章节来源

核心组件 ​

  • 移动端前端（uni-app）
    • 使用uView UI、mescroll-uni、uCharts等组件库，支持H5/小程序/APP多端编译与运行。
    • 页面清单包含设备管理、库存、消息、用户中心等模块，标签栏统一导航。
  • Web前端（Vue2 + ElementUI）
    • 提供后台管理、权限控制、动态路由与国际化方案，适配MES系统前后台分离场景。
  • 微服务后端（Spring Cloud + Nacos + ElasticJob）
    • 设备服务：设备台账、附件、文档、事件、计量等。
    • 库存服务：备件、领料、退料、库存查询。
    • 工作流服务：巡检、保养、维修工单的流程化执行。
    • 任务调度：基于ElasticJob的分布式任务中心，支持多数据源独立运行。

章节来源

架构总览 ​

系统采用“前端多端 + 微服务后端 + 服务治理”的整体架构。前端通过网关统一接入后端服务，服务间通过Nacos进行注册与配置管理；数据库采用PostgreSQL，缓存采用Redis；任务调度独立模块，便于扩展与隔离。

图表来源

详细组件分析 ​

移动端前端（uni-app）页面与导航 ​

  • 页面清单涵盖设备管理、巡检、保养、维修、库存、消息与个人中心等模块。
  • 标签栏统一入口，支持国际化标题与自定义导航样式。
  • 通过easycom机制引入uView UI组件，提升开发效率与一致性。

图表来源

章节来源

Web前端（Vue2 + ElementUI）路由与布局 ​

  • 路由采用常量路由与异步路由分离，支持权限控制与动态菜单。
  • 布局包含侧边栏与顶部导航，支持国际化标题与角色权限。
  • 提供示例路由与第三方组件集成，便于扩展业务模块。

图表来源

章节来源

微服务后端（Spring Cloud + Nacos + ElasticJob） ​

  • 技术栈：Spring Boot 3.x、Spring Cloud 2023.x、MyBatis-Plus、PostgreSQL、Redis、Nacos、ElasticJob。
  • 服务拆分：设备、库存、工作流、公共模块、认证与网关等。
  • 配置与部署：提供Maven聚合工程与Dockerfile，支持多环境（UAT/PRD）与Nacos命名空间/分组配置。

图表来源

章节来源

业务域说明（设备、库存、工作流） ​

  • 设备服务：设备台账、附件、文档、事件、计量、保养计划等。
  • 库存服务：备件管理、领料/退料、库存查询与预警。
  • 工作流服务：巡检、保养、维修工单的流程化执行与状态流转。

章节来源

依赖关系分析 ​

  • 前端依赖
    • uni-app 移动端：依赖uView UI、mescroll-uni、uCharts等组件库。
    • Vue2 Web端：依赖ElementUI、axios、vuex、vue-router等生态库。
  • 后端依赖
    • Spring Boot 3.x + Spring Cloud 2023.x + Spring Cloud Alibaba。
    • MyBatis-Plus、Druid、PostgreSQL、Redis、Nacos、ElasticJob。
  • 部署与运维
    • Maven聚合工程，支持多环境profile与Docker镜像构建。
    • Nacos用于服务注册与配置中心，支持不同命名空间与分组。

图表来源

章节来源

性能考量 ​

  • 前端
    • 使用按需加载与路由懒加载，减少首屏体积；合理使用缓存组件与图标字体，降低网络请求。
  • 后端
    • 使用Redis缓存热点数据，PostgreSQL优化索引与查询；ElasticJob分布式任务避免单点瓶颈。
  • 部署
    • Docker镜像分层构建与多阶段打包，结合Nacos配置中心实现灰度与快速回滚。

故障排查指南 ​

  • 环境与部署
    • 参考后端README中的初始化步骤与子模块更新命令，确保Nacos分组与命名空间正确。
    • 查看各服务日志目录，确认服务注册状态与数据库连接参数。
  • 前端联调
    • Web端与移动端均需指向正确的后端网关地址；检查跨域与鉴权头设置。
  • 常见问题
    • 数据库访问需通过VPN；生产环境DB凭据与端口需严格保密。
    • 分支与版本：PRC/ROW分别对应不同开发与生产分支，注意切换与合并策略。

章节来源

结论 ​

DeviceMate通过“移动端+Web端+微服务后端”的组合，覆盖制造业设备管理与维护的关键业务闭环。前端强调多端一致与易用性，后端强调服务化与可扩展性。建议在实际落地中结合工厂实际产线与组织架构，逐步完善流程规范与数据标准，持续迭代以提升运维效率与资产利用率。

附录 ​

  • 服务器与环境
    • PRC/ROW区域提供不同环境的APP、DB、Rancher与Nacos地址与凭据。
  • 开发分支
    • PRC与ROW分别维护开发与生产分支，确保变更可控与可追溯。
  • 初始化流程
    • 后端README提供了初始化、启动与更新的完整步骤，便于本地与CI/CD集成。

章节来源