更新记录

1.0.0（2026-10-24）

发版

平台兼容性

uni-app

云函数类插件通用教程

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

袋走 · 上门倒垃圾小程序

垃圾放门口，我们来袋走。用户线上下单，附近经过审核的工作人员上门取件、代投放到小区指定垃圾桶。 一个 App 覆盖「下单 → 支付 → 派单 → 抢单 → 履约 → 结算 → 提现 → 审核」全链路，用户端与工作人员端共用同一套账号，可随时切换身份。

uni-app + Vue3（Composition API）· uniCloud 云对象（腾讯云）· uni-id 登录 · uni-pay 支付 · 微信小程序

🔗 界面预览（在线画廊，30 张截图）：https://codesuccess.online/daizou/

界面速览

用户端 · 首页

工作人员端 · 接单大厅

管理端 · 工作人员审核

功能一览

用户端

工作人员端

管理端（小程序内，仅 admin 可见）

平台能力

• 订单状态机：9 个状态、唯一事实来源在云端 service-common/order-status.js，非法流转直接抛 INVALID_STATUS_TRANSITION，每次变更写状态日志。
• 抢单防并发：条件更新 where({ status: WAITING_ACCEPT, worker_id: null })，只有 updated === 1 才算抢到；集成测试用两个工作人员并发抢同一单，断言成功数严格为 1。
• 金额只在服务端算：价格、工作人员收入、平台抽成均由云对象按商品表计算并固化，前端传来的 price / workerIncome / status 一律忽略。
• 结算事务 + 幂等：完成订单时在同一事务里写收入流水（unique_key 唯一索引）、原子自增钱包、累计完成数，任一步失败整体回滚。
• 双身份：微信原生 tabBar 无法按身份切换，改用自定义底部栏 + uni.reLaunch。
• 游客优先：启动直接进首页，不弹登录；只有下单、地址、优惠券、消息、提现、后台、入驻这类动作才引导登录，登录后自动回到原页面。
• 本地可跑：MOCK_ENABLED = true 时所有云对象调用走 mock/ 本地数据表，无需服务空间和 AppID 就能完整点一遍。

界面预览

全部截图来自本项目 H5 构建产物的真实运行画面（390 × 844 @2x），数据由 mock/ 提供，与云函数返回结构一致。 在线画廊：https://codesuccess.online/daizou/

用户端

01 首页 · 地址 / 服务商品 / 进行中订单	02 订单列表 · 全部 / 进行中 / 已完成	03 订单详情 · 进行中
04 订单详情 · 待评价	05 订单详情 · 待支付	06 下单页
07 评价服务	08 我的	09 消息通知
10 优惠券	11 包月套餐	12 我的套餐
13 地址列表	14 地址编辑	15 支付后转待接单

工作人员端

16 我的 · 工作人员身份	17 接单大厅	18 我的任务
19 任务详情 · 履约	20 我的收益	21 提现
22 入驻申请	23 抢单后任务详情

管理端

24 管理后台

25 工作人员审核

26 提现审核

登录与游客态

27 首页 · 游客态	28 登录页	29 订单页 · 未登录态
30 登录后回到原页面

技术架构

小程序端（uni-app / Vue3）
  pages/*            22 个页面：用户 13 · 工作人员 6 · 管理 3
  services/*         唯一接触 uniCloud 的层（cloud / order / worker / user / income / area / upload）
  stores/user.js     reactive 单例：身份、资料、计数、身份切换
  components/*       app-tab-bar（双身份底部栏）/ app-empty-state / app-status-tag
  common/*           订单状态机镜像、错误码、格式化、mock 开关
  mock/*             17 张表种子数据 + 59 个接口的本地实现（无服务空间也能跑）

云端（uniCloud · 腾讯云）
  cloudfunctions/
    order-co        下单、计价、抢单、履约、取消、支付、评价
    worker-co       入驻申请、审核、在线状态、服务区域
    user-co         资料、地址、优惠券、套餐、通知、首页聚合
    income-co       收益、钱包、提现申请与审核、冻结释放
    area-co         服务区域维护与可达校验
    notification-co 站内通知
    pay-notify      uni-pay 支付回调（URL 化云函数）
    common/service-common  鉴权 / 权限 / 状态机 / 原子抢单 / 计价 / 结算 / 事务
  database/         17 张业务表 schema + 索引 + 种子数据

数据与安全边界：所有业务数据在云数据库，客户端对敏感集合只读，所有写入只经云对象；云对象以管理员身份操作数据库并自行校验归属。userId、price、status、payStatus 等前端参数一律不信任。

快速开始

方式一：不接后端，直接看 UI（默认）

1. HBuilderX 导入本项目。
2. 直接「运行 → 运行到浏览器 / 运行到微信开发者工具」。
3. 完成。common/mock-config.js 里 MOCK_ENABLED = true，所有接口走 mock/ 本地数据表，演示账号「李袋袋」已登录（同时是 admin 与已认证工作人员，可在「我的」切换身份）。

命令行构建 H5（可选）：

npx uni build -p h5   # 产物在 dist/build/h5

方式二：接真实 uniCloud

1. HBuilderX 右键 uniCloud → 关联云服务空间（腾讯云）。
2. 插件市场导入 uni-id-pages（含 uni-id-co、uni-id-common）与 uni-pay。
3. 填 manifest.json 的 mp-weixin.appid、uni-config-center/uni-id/config.json（appid / appsecret / tokenSecret）、uni-config-center/uni-pay/config.json（商户号、notifyUrl）。
4. 右键 uniCloud/database → 上传所有 DB Schema → 初始化 db_init.json。
5. 上传公共模块 service-common、uni-config-center，再上传 6 个云对象与 pay-notify（并开启 URL 化）。
6. 把 common/mock-config.js 的 MOCK_ENABLED 改为 false。

完整步骤、参数清单、真机测试脚本、安全边界见 docs/DEVELOPMENT.md。

目录结构

├── App.vue / main.js / index.html / pages.json / manifest.json
├── common/            订单状态、常量、错误码、格式化、mock 开关
├── components/        app-tab-bar / app-empty-state / app-status-tag
├── mock/              本地数据表 + 接口实现（预览用）
├── pages/             22 个页面
│   ├── index            首页
│   ├── order            create / list / detail / review
│   ├── address          list / edit
│   ├── coupon · package 优惠券、包月套餐
│   ├── mine             mine / notifications
│   ├── worker           apply / home / tasks / task-detail / income / withdraw
│   ├── admin            index / applications / withdrawals
│   └── login            微信登录
├── services/          前端 service 层（唯一接触 uniCloud 的地方）
├── stores/            user（身份/资料/计数）
├── static/            图标与 mock 占位图
├── uniCloud-alipay/   云对象、公共模块、17 张表 schema、种子数据
└── docs/
    ├── DEVELOPMENT.md 实现细节与部署配置
    └── preview/       界面预览（index.html + shots/ 截图）

文档

项目状态

• 页面、云对象、schema、索引、种子数据、集成测试均已就绪，H5 构建产物 30 个页面状态逐一截图核对。
• 上线前仍需你完成：绑定服务空间、导入 uni-id-pages / uni-pay 插件、填写小程序 AppID 与支付商户号、把 MOCK_ENABLED 改为 false、给管理员账号加 admin 角色。