立项背景和目标:修享家旨在打造一个全面、高效的综合生活O2O服务平台,无缝连接服务提供者(如维修师傅、家政人员)与普通C端/企业用户。项目的核心目标是开发一个功能强大的PC端后台管理系统,用于全面支撑和统筹该小程序端庞大且复杂的业务和数据流转。
软件功能、核心功能模块的介绍:系统划分为三大功能区,共包含23个具体管理模块。
修享家核心:涵盖多城市订单跟踪、售后退款、师傅人员注册与调度、企业及C端用户分离管理,以及树状结构的服务分类配置。
商城与生活:集成电商商品管理、外卖餐饮、酒店民宿预订、搬家出行、招聘及家政保洁等多元化生活服务。
运营与财务:包含财务集中结算、物流骑手管理、多级分销合伙人(流量合伙人)规则配置,以及多城市区域配置。
业务流程、功能路径描述:业务自用户在前端小程序下单(涵盖维修、购物、外卖等)发起,订单数据实时同步至后台统一化面板。后台运营人员可根据订单类型进行智能或人工派单调度(针对维修与物流),并跟进售后处理及财务结算。同时,系统支持多级分销机制和流量合伙人推广路径,实现业务的被动拉新与裂变。目前该平台已成功流转 1286+ 订单,产生超 386,720+ 元交易流水。
整体架构和设计思路,不同模块使用的技术栈:系统采用前后端分离的解耦架构。后端 API 业务逻辑采用基于 Java 的 Spring Boot 架构搭建,提供稳定的数据支撑;前端则深度定制了 RuoYi-Vue(Vue 2 + Element UI)企业级快速开发框架。为应对层级繁冗的页面,项目编写了定制化的 SQL 脚本,实现了23个子模块菜单树及底层数据结构的自动化生成与挂载。
“我”的负责模块和结果:我主要负责后台跨模块业务的管理系统定制化开发与前端界面深度整合。独立完成了 23 个核心管理页面的开发(含数据统计卡片、搜索过滤组件和状态标签栏)。针对物流(6种服务类型)、出行(包含机票、火车、代驾3个 Tab 聚合页)和求职招聘(职位与简历双 Tab)等复杂模块,开发了可复用的定制化 Vue 组件,并集成了 10 级树状节点结构以精细化管理服务分类,极大提升了运营后台的操作效率与视觉一致性。
“我”遇到的难点、坑,和解决方案:
坑点1:动态路由组件映射失效导致“白屏”。在开发“师傅管理”等模块时,因 RuoYi 框架采用基于数据库 SQL 驱动的动态路由机制,早期测试中频繁出现页面加载白屏现象。经过排查,发现是数据库配置的 Component 路径与实际前端文件目录大小写及层级不一致。解决方案:核对并修正 SQL 路由记录,建立统一的菜单路径命名规范,彻底解决了组件映射报错问题。
坑点2:系统环境配置热更新失效。在项目后期统一定制品牌视觉(如全局环境变量及名称从“修管家”变更为“修享家”)时,修改 .env.development 配置文件后,Webpack 的普通热重载(hot-reload)无法使新配置生效。解决方案:将环境变量级别的更新列入开发规范,遇此修改需完全中止 Node 进程并执行 npm run dev 重建前端构建流,确保了配置项的准确挂载与呈现。