钉钉H5微应用

本项目是一款面向机关单位的综合报修管理平台，采用前后端分离架构，包含管理后台（admin）、移动端H5应用（entry）及后端服务（server）三部分。系统支持普通设备报修与视频监控报修两大核心模块，涵盖工单提交、受理、维修、确认、评价、归档全流程管理。内置维修人员分级管理、故障类型分类、权限控制、操作日志追溯、钉钉集成通知及自动评价扣款机制。同时提供工单统计、设备统计与运营商综合评分功能，支持多单位类型区分与数据导出，有效提升报修处理效率与信息化管理水平。

## 项目实现介绍
### 一、技术架构
本项目采用前后端分离架构，前端分为管理后台（admin）与移动端H5应用（entry），后端基于Node.js + Express构建，数据库采用MySQL。

管理后台 使用Vue3 + Vite + Element Plus技术栈，结合Pinia进行状态管理，Vue Router实现路由控制，支持响应式布局。 移动端H5应用 采用Vue3 + Vite + Vant（有赞移动端UI库），同样使用Pinia状态管理，针对移动端场景进行了大量适配优化，包括iOS兼容性处理、图片压缩上传等功能。

后端服务基于Express框架构建，采用模块化路由设计，包含认证、工单、用户、权限、文件上传等核心路由模块。

### 二、核心功能实现
用户认证与权限管理 ：系统集成钉钉免登功能，通过钉钉OAuth2.0获取用户信息并自动创建系统账户。用户密码采用bcrypt加密存储，登录认证使用JWT Token机制。权限系统采用RBAC模型，支持角色（超级管理员、维修管理员、维修人员、外包维修人员）划分，菜单权限可动态配置。

工单全流程管理 ：系统支持普通设备报修与视频监控报修两大模块。普通工单状态流转为：待受理→已受理→维修中→待评价→已完结/已取消；视频监控工单在此基础上增加了报修人确认环节，支持修复与未修复两种确认结果。工单流程通过独立的过程记录表存储，可完整展示处理时间轴。

视频监控专项考核 ：针对视频监控故障，系统设计了严格的考核机制。响应时间超过2小时自动扣除20元，维修时长超过24小时按每24小时20元累计扣款。系统通过定时任务自动执行评价与扣款计算，确保考核公平执行。

通知与协作 ：深度集成钉钉开放平台，工单创建与状态变更时自动发送钉钉卡片消息通知相关维修人员。同时提供操作日志系统，记录关键业务操作，支持追溯查询。

数据统计与分析 ：内置工单统计与设备统计模块，支持按时间、状态、单位类型等多维度筛选，并提供Excel导出功能便于后续分析。