工程机械全场景一体化管理产品（打卡、积分、工时、保养、安全、薪资、年假与请假一体化）

前后端分离 + uni-app 跨端 + Spring Boot RESTful API；移动端支持 iOS / Android / 小程序 / H5 等多端发布

引言

智机通——工程机械全场景一体化管理解决方案，聚焦破解工时统计、设备保养、安全合规、薪资发放等管理痛点。

本产品是一款面向工程机械施工、工人打卡、积分激励、工时核算、设备保养、安全任务、工资条与年假请假等环节的垂直管理 App（含配套管理后台与 API）：把现场作业与管理动作收拢到同一套系统，减少分散表格与口头交接，提升数据可追溯性。

近期能力更新：已支持夜班、通宵等工时场景，并上线请假与年假的申请、审核与余额管理流程；同时新增队长审核机手打卡防自审机制（审核列表自动排除当前队长本人），与考勤、薪资等业务链更好衔接。

一、项目背景与痛点

在中国基建高速发展的今天，工程机械与建筑施工现场正从「纸笔+经验」向「数据+系统」深度变革。智机通工程机械租赁管理平台围绕这一趋势，打造一体化数字化管理方案：以移动端为入口，结合管理后台与后端服务，为租赁企业、施工企业提供机手管理、设备管理、考勤打卡、任务协同、技能提升、工时与假勤、薪资透明化等核心能力。

工程机械与施工现场在「人、机、时、钱」上长期存在协作断层，本仓库实现的智机通平台针对常见痛点：

• 考勤与工时：替代纸质签到，降低代打、漏打；支持常规 / 夜班 / 通宵（通霄）等班次维度与薪资口径（见sql中夜班、通霄、加班类型等增量脚本）

• 加班与中直：OT、中直等记录与汇总、工资条联动（WorkOvertime、Summary、Payslips等模块）

• 假勤：请假、年假在线申请；队长移动端审核本队待审单，管理员后台终审；年假余额人工配置与系统计算规则并存（AnnualLeave）

• 设备与保养：设备模板/列表、保养计划与执行记录、上报追溯（Maintenance*、Device*）

• 任务与激励：特殊任务、技能任务、安全任务；积分、兑换、抽奖、规则与说明文案维护

• 组织协同：队长—队员绑定（DuiUsers），队长端独立菜单与权限；考勤异常、签字、打卡地点与须知

• 审核风控优化：队长移动端审核机手打卡时，列表默认过滤当前登录队长本人，规避自审场景、降低流程风险

• 运营与合规：用户反馈、协议、消息通知、版本控制；文件上传；Excel导出；可选阿里云 OSS、微信公众号（weixin-java-mp）等扩展能力

统一数据入口后，可实现过程可追溯、统计可复用，减轻对 Excel 与群消息的依赖。

二、技术架构概览

重要：application.properties中配置 **server.servlet.context-path=/seaHouseApi**，故服务端根路径为http://主机:端口/seaHouseApi/；管理端VUE_APP_BASE_URL、移动端请求基地址须与此一致（末尾常带seaHouseApi/）。

三、核心代码示例

3.1 后端：Controller + Service + 统一返回

多数接口为POST + JSON，入参JSONObject，出参Return，典型示例（考勤打卡模块）：

@RequestMapping("/AttendanceCheckinRecords") @RestController @Transactional @CrossOrigin publicclass AttendanceCheckinRecordsController { @Autowired private AttendanceCheckinRecordsService attendanceCheckinRecordsService; @PostMapping("/save") public Return save(@RequestBody JSONObject json) { Return re = new Return(); if (MyUtil.isEmpty(json)) { re.setMsg("传参数有误"); re.setCode(400); return re; } try { attendanceCheckinRecordsService.save(json); re.setCode(200); re.setMsg("成功"); } catch (Exception e) { e.printStackTrace(); re.setCode(400); re.setMsg("操作失败"); } return re; } // 分页列表等：@PostMapping("/List") ... }

假勤、汇总、工资条等模块（如AnnualLeaveController、SummaryController、PayslipsController）遵循同一模式；部分统计与 DDL 兼容逻辑使用BaseDaoMapper执行 SQL。

3.2 管理后台：Axios 封装（Token + 401）

与仓库一致：move-adminPub/src/utils/request.js——优先localStorage.token，回退到user对象内 token；Authorization: Bearer ...；code === 401跳转登录。

const instance = axios.create({ baseURL: process.env.VUE_APP_BASE_URL ?? 'https://your-domain.com/seaHouseApi/', timeout: 5000, }); // interceptors: Content-Type、token、401 → ElMessage + router.push

3.3 调用示例（POST 路径不含 context-path 前缀时的写法）

前端baseURL已指向.../seaHouseApi/，业务路径写模块名即可，例如：

import request from '@/utils/request'; const res = await request.post('Summary/某方法', { startDate: '2025-03-01', endDate: '2025-03-18' });

移动端则通过封装的postHeaderRequest('AnnualLeave/summary', JSON.stringify({...}))等形式调用。

四、部署步骤（生产环境）

4.1 环境要求

4.2 数据库初始化

CREATE DATABASE sea_house DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- 导入基础结构后，按需执行 move-apiPub/src/main/resources/sql/ 下增量脚本 -- 例如：年假表、夜班/通霄/加班类型、离职备注、抽奖等

4.3 后端配置与启动

编辑 **move-apiPub/src/main/resources/application.properties**（生产库地址、账号密码、token-secret等）；注意保留：

server.port=11068 server.servlet.context-path=/seaHouseApi spring.datasource.url=jdbc:mysql://YOUR_DB_HOST:3306/sea_house?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai spring.datasource.username=YOUR_USER spring.datasource.password=YOUR_PASSWORD token-secret=YOUR_JWT_SECRET

打包与运行（artifactId 为api，版本见pom.xml）：

cd move-apiPub mvn clean package -DskipTests java -jar target/api-0.0.1-SNAPSHOT.jar

服务对外 API 前缀示例：http://YOUR_HOST:11068/seaHouseApi/。

4.4 管理后台构建

cd move-adminPub npm install # 配置 .env.production：VUE_APP_BASE_URL 指向线上 API，例如 https://your-domain.com/seaHouseApi/ npm run build # 将 dist 部署到 Nginx 静态目录或使用对象存储 + CDN

4.5 移动端构建

cd moveAppPub # 推荐使用 HBuilderX：发行 → 原生 App-云打包 / 微信小程序 / H5 # 将接口基地址配置为与后端 seaHouseApi 一致的公网可达地址

4.6 Nginx 与上下文路径

因 Spring Boot 使用 **context-path=/seaHouseApi**，反向代理需把带/seaHouseApi/的请求转到应用（路径保持）例如：

upstream seaHouse_backend { server 127.0.0.1:11068; keepalive 32; } location /seaHouseApi/ { proxy_pass http://seaHouse_backend/seaHouseApi/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; }

具体以实际proxy_pass规则（是否保留路径）为准，务必与前端baseURL一致。

五、核心功能模块（与当前路由/控制器对应）

以下按管理后台主导航与后端 Controller归纳，便于对照源码。

移动端另含：考勤/工资条/年假与请假申请与列表、队长审核年假入口、任务与积分、评价等页面（moveAppPub/pages）。

六、平台优势

1. 端侧齐备：uni-app 现场作业 + Vue3 管理后台 + Spring Boot API，角色与菜单按机手 / 队长 / 管理员分流（侧栏可按roleId过滤队长专属路由）。

2. 业务链打通：从打卡、夜班/通宵与中直、异常、假勤到工资条，数据在同一套用户与考勤模型上闭环，减少重复录入。

3. 可扩展清单清晰：resources/sql提供增量 DDL，便于按环境迭代年假、班次、抽奖等能力而不必整库替换。

4. 对接能力强：OSS、公众号、地图（管理端）、大文件上传（500MB 级别 multipart 配置）等已在技术栈中预留。

5. 接口风格统一：Return约定 + JWT 拦截，利于多端与一个后端长期共存。

七、适用场景

• 工程机械租赁 / 施工企业：多机手、多设备、多现场的考勤、工时与保养管理

• 需队长一线审批的组织：队员请假/年假由队长移动端预审，后台可终审与留痕

• 培训与激励并重：安全/技能任务与积分、兑换、抽奖组合使用，提升参与率

• 逐步数字化：已有 Excel 或纸质流程的团队，可按模块上线（先打卡与汇总，再工资条与假勤）

八、仓库目录结构（节选）

xlhApp/ ├── move-apiPub/ # Spring Boot 后端 │ ├── src/main/java/com/yunchen/api/ │ │ ├── controller/ # REST 控制器（考勤、假勤、设备、任务、积分等） │ │ ├── service/ # 业务逻辑 │ │ ├── mapper/ # MyBatis Mapper │ │ ├── pojo/ # 实体与 Example │ │ ├── interceptor/ # Token 等拦截器 │ │ └── config/ # 跨域等配置 │ └── src/main/resources/ │ ├── application.properties # 端口、context-path、数据源、token-secret │ └── sql/ # 增量 SQL（年假、夜班/通霄、抽奖等） ├── move-adminPub/ # Vue 3 管理后台 │ └── src/ │ ├── router/modules/ # 路由与侧栏菜单（constantRoutes） │ ├── views/ # 业务页面（attendance、equipment、score…） │ ├── components/ # 通用表格、搜索、编辑器等 │ └── utils/request.js # Axios 与鉴权 ├── moveAppPub/ # uni-app 移动端（TuniaoUI） │ ├── pages/ # 工作台、考勤、年假、任务等 │ └── tuniao-ui/ # UI 组件库 ├── README.md └── 平台简介.md

总结：智机通既是工程机械全场景一体化管理产品（打卡、积分、工时、保养、安全、薪资、年假与请假一体化），采用主流前后端分离架构，又提供完整代码示例与部署指引，适合作为工程机械/建筑施工领域数字化转型的参考实践，也可用于技术分享与二次开发学习。