1. 项目背景及简介智机通是一个面向工程机械场景的全场景一体化管理平台。后端采用 Spring Boot 提供 RESTful API前端分为 uni-app 移动端和 Vue 3 管理后台覆盖考勤打卡、设备保养、任务激励、薪资核算、假勤审批等完整业务链路。项目采用三端分离架构移动端moveAppPub、管理后台move-adminPub、后端 APImove-apiPub通过统一接口规范实现多端协同。2. 目标客户全栈/后端开发者学习 Spring Boot MyBatis 工程实践前端开发者参考 uni-app 跨端 Vue 3 管理后台架构技术负责人了解垂直行业 SaaS 的技术选型思路二次开发者基于开源代码快速搭建行业解决方案3. 平台定位开源的工程机械行业数字化参考实现。提供从数据库设计、API 接口、前端页面到部署文档的完整技术栈可作为二次开发的基础框架。4. 平台技术层级技术栈版本移动端uni-app Vue 2 TuniaoUI vue-i18nVue 2管理后台Vue 3.2 Vue Router 4 Element Plus Pinia 3 EChartsVue CLI 5后端Spring Boot MyBatis MySQL DruidBoot 2.6.2鉴权JWTjava-jwt / jjwt TokenHandlerInterceptor-文档Springfox 3 Knife4j 3.0.3-架构设计亮点统一响应协议Return(code/msg/data/maxPage)约定多端对接零歧义灵活入参RequestBody JSONObject减少 DTO 膨胀上下文路径规范server.servlet.context-path/seaHouseApi前后端路径约定清晰角色权限分流侧栏按roleId过滤路由队长端有独立菜单和审核能力增量脚本管理resources/sql按功能拆分 DDL支持灰度上线5. 平台核心功能考勤闭环打卡 → 异常处理 → OT/中直 → 汇总 → 工资条全链路数据贯通假勤体系请假/年假在线申请队长移动端预审 管理员后台终审年假余额可配置设备保养设备模板 → 保养计划 → 执行记录 → 上报追溯积分激励积分规则 → 积分记录 → 兑换 → 抽奖提升机手参与度审核风控队长审核打卡自动排除本人从机制上杜绝自审6. 平台独特优势三端分离清晰移动端、管理端、后端独立工程团队协作无冲突跨端发布能力uni-app 一套代码覆盖 iOS/Android/小程序/H5权限粒度到菜单队长角色独立路由DuiUsers绑定队长—队员关系大文件支持500MB 级别 multipart 配置现场照片/文档上传无忧扩展能力预留阿里云 OSS、微信公众号 SDK、高德地图加载器即插即用7. 平台安装使用# 1. 数据库初始化 mysql -u root -p init.sql # 按需执行增量脚本 mysql -u root -p sql/annual_leave.sql # 2. 后端启动 cd move-apiPub mvn clean package java -jar target/move-apiPub.jar # 接口地址http://localhost:端口/seaHouseApi/ # 3. 管理后台 cd move-adminPub npm install npm run dev # 4. 移动端 cd moveAppPub # HBuilderX 运行或 uni-app CLI 构建接口调用示例// 管理后台请求封装utils/request.js import axios fromaxios import { ElMessage } fromelement-plus const service axios.create({ baseURL: import.meta.env.VITE_APP_BASE_URL, timeout: 10000 }) service.interceptors.request.use(config { config.headers[Authorization] Bearer ${getToken()} return config }) service.interceptors.response.use( response { const res response.data if (res.code ! 200) { ElMessage.error(res.msg || 请求失败) returnPromise.reject(newError(res.msg)) } return res.data }, error { if (error.response?.status 401) { // 未授权跳转登录 window.location.href /login } returnPromise.reject(error) } )8. 应用场景及案例说明场景1技术团队选型参考——Spring Boot MyBatis 的标准工程实践场景2uni-app 跨端开发学习——一套代码覆盖 App/小程序/H5场景3二次开发基座——在现有功能上扩展行业定制需求场景4前后端分离教学——统一响应协议 JWT 鉴权的完整实现总结智机通的技术架构不追求炫技而是用成熟稳定的技术栈解决真实的行业问题。Spring Boot 做后端、uni-app 做移动端、Vue 3 做管理后台加上清晰的增量脚本管理和统一接口规范构成了一套可落地的工程实践。对于想学习全栈开发或做行业 SaaS 的开发者这是一个很好的参考项目。建议从后端 API 开始阅读源码理解Return统一响应格式和 JWT 拦截器设计再对比管理端和移动端的请求封装体会多端协同的设计思路。
