# 宠物服务 **Repository Path**: zmd1992/pet-services ## Basic Information - **Project Name**: 宠物服务 - **Description**: 宠物服务平台小程序及APP - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-16 - **Last Updated**: 2026-11-16 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 宠物服务平台(后端 + 运营后台 + 宠主端/宠托师端) 猫狗上门喂养、遛狗与组合服务的全栈项目,包含: - 宠主端:uni-app(H5 / 微信小程序 / App) - 宠托师工作台:与宠主端同一套账号,申请审核通过后自动获得服务者身份 - 运营后台:Vue3 + Element Plus - 后端:Java 17 + Spring Boot 3 + MyBatis-Plus > 本 README 位于 `pet-services` 仓库,按整个项目维护,覆盖后端、后台、宠主端、宠托师端、小程序和 App。 > 更细的接口、联调记录和业务口径见 `../docs/开发进度与联调说明.md`、`../docs/全流程联调记录-20261115.md`。 ## 项目截图

--- ## 1. 项目概览 | 模块 | 目录 | 技术栈 | 默认地址 | | --- | --- | --- | --- | | 后端 API | `pet-services-api` | Java 17、Spring Boot 3.1.5、MyBatis-Plus、MySQL 8、Redis、MinIO | `http://localhost:8081/api` | | 运营后台 | `pet-services-ui` | Vue 3、TypeScript、Vite、Element Plus、Pinia、ECharts | `http://localhost:3000` | | 宠主端 / 宠托师端 | `pet-services-uniapp` | uni-app、Vue 3、Vite、TypeScript | H5 `http://localhost:3100` | | 业务文档 | `docs` | Markdown | - | 整体链路: ```text 宠主端(H5 / 小程序 / App) │ pet_app_token ▼ 后端 /api/app/** ──► 宠主业务:服务、宠物、地址、订单、支付、评价、优惠券 │ │ 登录时按手机号绑定 sitterId ▼ 后端 /api/app/sitter/** ──► 宠托师履约:接单、签到、日报、异常、钱包 ▲ │ 运营后台 /api/pet/** ──► 订单监控、服务者审核、售后、结算、提现、营销 ``` --- ## 2. 当前已实现能力 ### 2.1 宠主端 - 手机号验证码登录;微信小程序支持 `getPhoneNumber` 授权登录 - 首页服务分类、服务项目、服务详情 - 宠物档案:新增、编辑、照片上传 - 服务地址:新增、编辑、省市区选择、进门方式/说明、紧急联系人 - 下单:宠物、地址、日期、时段、次数、指定宠托师、试算、优惠券抵扣 - 订单:列表、详情、模拟/真实支付、取消、确认完成、售后 - 履约记录:签到、服务日报、照片、宠物状态摘要 - 服务评价:星级、标签、文字、图片,提交后计入宠托师评分 - 优惠券:领券、我的券、下单抵扣 - 宠托师:列表、筛选、详情、关注/取消关注、分享名片 - 历史服务记录、意见反馈、服务协议/隐私政策、城市切换 - 个人资料、头像上传、退出登录 ### 2.2 宠托师工作台(同一账号) 宠托师不是独立账号体系,**不提供独立登录**: - 宠主登录后提交入驻申请 - 后台审核通过 `status=1` 后,宠主 token 自动带 `sitterId` - 前端请求服务者接口时自动派生/刷新工作台身份,用户无感 - `pages-sitter/login/login` 仅保留兼容路由,进入即回宠主登录页或工作台 - tabBar 共 5 项:首页 / 订单 / 宠托师 / 接单 / 我的;「接单」仅审核通过的宠托师显示。H5 动态隐藏/恢复该项,小程序使用 `components/AppTabBar.vue` 自定义底栏 - 能力包括: - 工作台资料、评分、信用分、接单开关 - 接单池、抢单、我的任务 - 到岗签到、服务日报(至少 4 张照片)、完成服务 - 异常上报与客服介入 - 钱包、结算单、提现申请、微信收款账户绑定 - 公开资料编辑 ### 2.3 运营后台 - 运营工作台、履约监控 - 订单管理:查询、详情、客服介入、状态流转 - 服务者管理:入驻审核、资料、证件、服务区域、评分 - 宠主用户列表 - 服务项目与价格配置(城市/区县/S/M/L/夜间/节假日) - 地区与开通城市管理 - 优惠券模板、领取与核销 - 评价管理:查看、回复、隐藏/显示并重算评分 - 服务者异常工单处理 - 售后工单、退款审核 - 结算单生成、提现审核 - 服务协议/隐私政策配置 - 意见反馈处理 ### 2.4 自动化任务 后端 `OrderAutomationJob` 默认每 60 秒扫描,已接入: - 待支付订单 15 分钟自动关闭 - 支付后 15 分钟无人接单提醒 - 支付后 15 分钟接单池半径从 3km 扩到 5km - 支付后 30 分钟仍无人接单,标记客服待介入 - 服务开始 15 分钟未签到提醒 - 订单完成 24 小时未确认自动确认 - 完成 24 小时至 7 天评价提醒 - 每日 01:10 生成前一日结算单 - 每日 01:20 自动解冻 T+7 到期结算单(只入余额,不自动提现) --- ## 3. 关键业务规则 ### 3.1 登录与身份 | 项目 | 说明 | | --- | --- | | 宠主登录 | `POST /api/app/auth/send-code`、`POST /api/app/auth/login`,首次登录自动注册 | | 微信小程序登录 | `POST /api/app/auth/wechat-login`,`loginCode` 换 openid,`phoneCode` 换手机号 | | H5 | 只支持手机号登录,不接微信授权 | | App | 当前只保留手机号登录;App 微信 OAuth 尚未接入 | | 宠主 token | 前端存 `pet_app_token`,Redis key `login:app:token:` | | 工作台身份 | 宠主登录时按手机号绑定已审核通过的 `sitterId`;服务者接口直接接受宠主 token | | 兼容 token | 原 `login:sitter:token:` 仍保留,用于历史工作台 token 兼容 | | 有效期 | JWT 有效期由 `jwt.expiration` 控制,默认 24 小时;Redis 在线态同时保存 | 服务者接口无需单独登录: ```text 宠主登录(手机号 / 微信) → pet_app_token + sitterId → /api/app/sitter/** ``` 宠主账号未入驻或审核未通过时,调用服务者接口返回: ```json { "code": 403, "msg": "当前账号还不是宠托师,请先提交入驻申请" } ``` ### 3.2 订单状态 | 状态值 | 含义 | 说明 | | --- | --- | --- | | `10` | 待支付 | 创建订单后的初始状态 | | `20` | 待接单 | 支付成功,进入公共接单池 | | `30` | 待服务 | 已接单,或下单时已指定宠托师 | | `40` | 服务中 | 宠托师已签到 | | `45` | 待确认 | 最后一次履约完成,等待宠主确认 | | `50` | 已完成 | 宠主确认或 T+24h 自动确认 | | `60` | 已取消 | 用户/后台取消 | | `70` | 售后中 | 售后工单处理中 | | `80` | 已关闭 | 超时未支付自动关闭 | 指定宠托师下单:创建订单即写入 `sitterId`,支付成功后直接进入 `30 待服务`,不再进入公共接单池。 ### 3.3 计价规则 - 金额单位统一为「分」,数据库 `bigint` - 体型:猫固定 `S`;犬按体重 `≤10kg → S`、`≤25kg → M`、`>25kg → L`,体重为空默认 `M` - 价格命中顺序:`itemId + cityCode + districtCode + petSize` → 城市级(`district_code IS NULL`)→ `item.base_price` - 夜间加价:时段起始小时 `>=21` 或 `<7`,叠加 `night_rate` - 节假日加价:服务日期命中 `pet_holiday` 启用日期,取区间最大 `rate` 叠加一次 - `amount = unitPrice × totalTimes` - 默认抽佣 `0.1500`,佣金四舍五入到分 - 下单按 `totalTimes` 逐日生成 `pet_order_visit`,状态 `0 待服务` ### 3.4 支付、退款、结算 - 默认 `wxpay.mock=true`:`POST /api/app/order/{id}/pay` 直接完成支付,返回 `mode=MOCK` - 真实模式: - 小程序传 `scene=miniapp`,返回 JSAPI 唤起参数 - H5 传 `scene=h5`,返回 `h5Url` - 回调地址 `{notifyBaseUrl}/api/pet/wxpay/pay-notify` - 真实 JSAPI 支付要求宠主已有 `pet_user.openid` - 退款当前为模拟审核通道,真实微信退款未接入 - 结算:完成日 T+1 生成结算单;T+7 自动解冻计入钱包余额 - 提现:最低 100 元、手续费 1 元/笔;微信零钱通道代码已接,默认模拟 ### 3.5 评价 - 仅订单完成后可评价,每单一条 - 评分口径:该宠托师所有 `status=1` 且未删除评价的全量平均,保留两位 - 后台隐藏/显示评价会同步重算 `pet_sitter.score` - 支持星级、标签、文字、图片;订单详情展示评价卡片 ### 3.6 优惠券 - 满减券、折扣券、新人券 - 按订单实付金额抵扣,佣金按 `pay_amount` 计算 - 订单取消或超时关闭会释放优惠券 - 折扣券 `discount` 存 1-99 百分比(80 = 8 折),`max_discount` 为封顶金额 ### 3.7 消息 - 微信小程序订阅消息:支付成功、接单、完成、取消/关闭、待接单、签到、评价 - H5 / App 跳过 `uni.requestSubscribeMessage` - 模板 ID 留空时对应场景跳过,不影响主流程 --- ## 4. 技术栈 ### 后端 - Java 17、Spring Boot 3.1.5 - Spring Security + JWT,多通道鉴权 - MyBatis-Plus、MySQL 8 - Redis(database `1`)登录态、验证码、去重 - Quartz / `@Scheduled` 定时任务 - Knife4j / Swagger - MinIO / 本地文件上传 ### 运营后台 - Vue 3 + TypeScript + Vite - Element Plus + Pinia + Vue Router - ECharts 数据看板 - Axios 请求封装 ### 宠主端 / 宠托师端 - uni-app `3.0.0-5030420261029002` - Vue 3 + Vite + TypeScript - `