设备故障报修是企业运维管理中的高频刚需场景。传统报修方式依赖微信群、电话或纸质单据，普遍存在几个痛点：故障描述不清、缺少现场照片佐证；派单依赖人工转达，响应不及时；维修进度不透明，报修人反复催问；处理过程无记录，质量与责任难以追溯。本项目"冲锋小猪故障反馈"正是为解决上述问题立项，面向企业与维修团队，提供从故障上报、实时派单、维修处理到服务评价的全流程数字化管理。业务上，普通员工通过手机拍照即可一键提交故障工单，维修人员实时接收推送并按步骤反馈处理进度，管理者可掌握每单的处理时长与完成质量，从而缩短设备停机时间、降低沟通成本、提升运维管理水平。
项目采用双角色设计，分为报修用户端与维修人员端，主要功能模块如下：
一、账号模块：注册登录、JWT 鉴权、登录态加密存储与自动恢复；
二、故障上报：支持相机拍照与相册选图上传，填写故障描述，支持工单编辑与撤回；
三、工单列表：按工单状态与角色维度筛选展示，下拉刷新，本地缓存支持离线查看；
四、工单详情：故障图片大图预览，维修步骤时间线可视化，处理进度实时跟踪；
五、实时通知：基于 WebSocket 的工单派发与状态变更推送，新单与进度更新即时触达维修端；
六、维修处理：维修员接单、分步骤填写维修记录、上传处理照片、完成并关闭工单；
七、服务评价：维修完成后报修人对处理结果进行评分评价，形成服务闭环；
八、设置中心：角色专属主题、应用内检查更新、退出登录等。
本人独立负责项目全栈开发，包括 Android 客户端、后端服务的设计、编码与部署。移动端采用 Kotlin + Jetpack Compose + Material 3 纯原生开发，MVVM 架构，Hilt 依赖注入，Navigation Compose 单 Activity 导航；网络层使用 Retrofit + OkHttp + kotlinx-serialization，本地采用 Room 缓存工单数据，DataStore 与 EncryptedSharedPreferences 存储配置与敏感信息；CameraX 实现拍照报修，Coil 加载图片，WebSocket 实现实时消息通道。服务端采用 Kotlin + Ktor（Netty 引擎），Koin 依赖注入，SQLite 存储，JWT 无状态鉴权，打包为 fat jar 一键部署，并配置 HTTPS 与接口安全防护。实现亮点：Compose 声明式 UI 下复杂工单状态流转的界面一致性处理；WebSocket 断线重连与消息可靠性保障；图片压缩上传的稳定性优化；Release 包 R8 混淆与加密存储的安全加固。
评论