HomeFlow 到家云服务平台

产品定位

HomeFlow 到家云是一套到家服务运营底座，面向保洁、维修、安装、家电清洗和整理收纳等本地服务团队。它把“客户预约—时段锁定—智能派单—师傅履约—客户确认—评价沉淀”串成一条可追踪链路。

双仓库协作

产品拆成两个公开仓库：homeflow-miniapp 负责客户和师傅端，homeflow-admin 负责后台管理端、Go API 与 Docker Compose 基础设施。两边共享 docs/api-contract.md，便于后续独立部署和二次开发。

联调方式

两个前端都支持通过 VITE_API_BASE_URL 或 UNI_APP_API_BASE_URL 指向 Gin API，并使用 homeflow_access_token 复用登录令牌。未配置 API、网络不可用或接口返回异常时，会自动回退到内置演示数据，保证本地预览和作品展示不中断；后台页面会明确标记当前数据来源。

后台配置 API 地址后会先进入登录页，登录成功后令牌保存在浏览器本地存储，退出时会调用登出接口并清理令牌。API 连接 MySQL 8.4 时，订单、事件、审计、评价和履约凭证会在服务启动阶段回载到读模型；开发环境数据库不可用时仍可使用离线演示。

技术实现

小程序使用 uni-app、Vue 3 与 TypeScript，可构建 H5 与微信小程序；后台使用 Vue 3、Element Plus 与 ECharts；后端使用 Go 1.25、Gin、JWT/RBAC，并以 MySQL 8.4 持久化订单事件、审计、评价和履约凭证，Redis 8 负责预约时段短锁，Docker Compose 提供本地一键启动。

关键能力

• 预约时段容量控制、Redis 短锁与幂等键，避免重复下单和超卖。
• 订单状态机覆盖待派单、已派单、前往中、服务中、待确认、已完成与已取消。
• 基于技能、区域、距离和负载的派单推荐，并限制师傅只能操作自己的订单。
• 评价、履约凭证、地址簿、服务目录、经营看板、RBAC 和操作审计。