更新记录

0.0.1（2026-08-16）

全新发布：宠物寄养托管平台多商户版

• 用户端：LBS 附近商家、城市切换与多维筛选、商家详情（房型/服务/资质/评价）、日期计价下单、多宠物下单、优惠券/余额抵扣、模拟支付/余额支付（预留支付宝）、订单状态追踪、寄养日记、续住/退款/投诉、在线 IM、评价追评、宠物档案、领券中心、钱包储值
• 商家端：入驻申请、店铺与营业状态管理、服务/房型管理（支持房间实拍图上传）、日历逐日调价与满房禁售、订单全流程（接单/拒单/办理入住/离店结算/续住审核/退款处理）、寄养日记发布、评价回复、财务结算与提现、经营看板
• 平台管理端：商家入驻审核/封禁/推荐位、全平台订单监管、用户封禁、评价与投诉审核、Banner 与优惠券运营、平台公告、提现审核、佣金比例与协议配置、数据看板
• 技术底座：uniCloud 云对象架构（13 个云对象 + 公共模块 pet-utils）、21 张业务数据表（含 schema 权限）、uni-id 多角色登录、金额分单位计价、房型库存并发校验
• 内置 2 家演示商家、服务、房型、优惠券等初始数据，导入即可体验完整寄养闭环
• 支持 H5 与 App（含小程序适配预留）；兼容阿里云、腾讯云、支付宝云三端云端

平台兼容性

云端兼容性

uni-app(4.24)

云函数类插件通用教程

使用云函数类插件的前提是：使用HBuilderX 2.9+

宠物寄养平台多商户版 · 使用说明

基于 uniCloud（云对象）+ uni-app Vue3 的宠物寄养托管平台模板，一套代码覆盖 用户端（C端）/ 商家端（B端）/ 平台管理端 三端，支持 H5 与 App。

一、功能概览

用户端

• 首页：LBS 附近商家、城市切换、关键词搜索、多维筛选（宠物类型/服务类型/标签/距离/评分）、Banner、服务分类、领券中心、热门推荐
• 商家详情：环境实拍、服务项目、房型/笼位（含实拍图与今日库存）、商家资质、评价（含商家回复/追评/点赞）、收藏、导航、电话、在线咨询
• 下单履约：起止日期自动计价、多宠物下单、特殊需求（喂食/用药/遛弯/忌口）、接送地址、优惠券与余额抵扣、寄养协议、支付（模拟/余额/支付宝）、续住补差价、退款申请、投诉
• 寄养全程：订单状态追踪、每日寄养日记（图文）、在线 IM、离店取宠确认
• 个人中心：订单/收藏/优惠券/地址/钱包余额与积分/宠物档案/消息通知/商家入驻入口

商家端

• 入驻申请（营业执照/防疫合格证上传）、店铺信息与营业状态、服务/房型管理（房型实拍图上传）、日历逐日调价与满房禁售
• 订单全流程：接单/拒单、办理入住、离店结算、续住审核、退款处理、寄养日记发布、评价回复
• 财务：结算流水、可提现金额、提现申请与记录、经营看板（今日/本周/本月订单与营收、寄养中、待处理）

平台管理端

• 数据看板（用户/商家/订单/GMV/投诉/提现待办）、商家入驻审核/封禁/推荐位、订单监管、用户封禁、评价与投诉审核、Banner/优惠券/公告、提现审核、佣金比例与协议配置

二、技术栈

• 前端：uni-app + Vue3（Composition API 兼容），共享组件：云存储图片组件、省市区三级联动、商家卡片、订单卡片等
• 后端：uniCloud 云对象（13 个，入口为 index.obj.js）+ 公共模块 pet-utils（计价/库存/结算/通知/鉴权）
• 数据库：21 张业务表（全部含 DB Schema 权限）+ uni-id-users 等系统表；金额以「分」存储
• 登录：uni-id-pages（用户名密码/短信验证码等），多角色（用户/商家/管理员）

三、快速开始

1. 用 HBuilderX 打开本项目（uni-app 最低兼容版本见插件信息，建议使用最新版 HBuilderX）。
2. 右键 uniCloud-alipay（或 -aliyun / -tcb，按所选服务空间）→ 关联/新建服务空间。
3. 右键 database 目录 → 上传所有 DB Schema（含扩展校验函数）。
4. 导入初始数据：database 下所有 pet-*.init_data.json（重点：pet-shops、pet-services、pet-rooms、pet-categories、pet-banners、pet-coupons、pet-configs）。
5. 配置 uni-id：uni_modules/uni-config-center/uniCloud/cloudfunctions/common/uni-config-center/uni-id/config.json 中填写 tokenSecret 并上传该公共模块。
6. 右键 cloudfunctions → 上传所有云函数、公共模块（先传 common/pet-utils）。
7. 运行到浏览器（H5）或自定义基座（App），登录后即可体验。

四、联调与测试

• 模拟支付：pet-configs 中 pay.mock_enabled=true 时，下单可选「模拟支付/余额支付」完整体验闭环；余额可在「我的-钱包」模拟充值。上线前请关闭 mock 并接入 uni-pay（代码已预留支付宝渠道）。
• 演示商家：内置 2 家北京商家（含服务/房型/优惠券）。将 pet-shops 中演示商家的 owner_uid 改为某真实用户的 _id，该用户登录后即可进入「商家中心」体验 B 端。
• 管理员：H5 访问 /uni_modules/uni-id-pages/pages/register/register-admin 注册管理员（首次注册者即为管理员），或给 uni-id-users 中用户 role 字段加入 "admin"；登录后「我的-平台管理」入口出现。
• 图片：全部走 uniCloud 云存储，前端 cloud-image 组件自动转换 fileID，H5/App 均可显示。

五、目录结构

├── pages/                用户端页面（首页/商家/下单/订单/宠物/个人中心等）
├── pages-merchant/       商家端子包（工作台/订单/日记/房型/服务/财务）
├── pages-admin/          平台管理端子包（看板/审核/运营/配置）
├── components/           共享组件（shop-card/order-card/cloud-image/region-picker 等）
├── common/               前端公共层（api 封装/常量/状态/工具）
├── static/region.json    全国省市区数据（H5/App 地区选择器）
├── uniCloud-alipay(-aliyun/-tcb)/
│   ├── database/         21 张业务表 Schema 与初始数据
│   └── cloudfunctions/   13 个云对象 + 公共模块 pet-utils
└── docs/数据库设计.md     表结构、状态机与计价规则文档

六、常见问题

1. 上传云函数提示「未找到云函数入口」：支付宝云等要求入口文件命名为 index.js（云函数）/ index.obj.js（云对象），本项目已按规范命名。
2. 上传公共模块提示「参数不正确」：公共模块目录必须含 package.json（本项目 pet-utils 已包含），重启 HBuilderX 后重试。
3. 接口报「用户函数代码语法或逻辑异常」：多为云端缺少对应数据表，请核对 database 下 21 张 pet-* 表是否全部上传；代码已做缺表容错。
4. 登录后仍提示未登录：确认已上传 uni-id 公共模块并正确配置 tokenSecret。
5. H5 端图片不显示：云存储 fileID 需经 getTempFileURL 换链，本项目 cloud-image 组件与预览函数已自动处理。
6. 提现提示可提现金额不足：新商家需先产生已支付订单，支付成功后才生成结算流水与可提现金额（默认平台佣金 10%，可在平台配置中修改）。