LikeShop 上门家政系统服务验收拍照:完工凭证上传与评价联动功能二开

简介: LikeShop家政系统二开:实现完工强制拍照上传、带水印防伪、状态机扩展(新增“待用户验收”态),并联动评价页展示凭证,提升履约可视化与纠纷处理效率,兼顾用户体验与平台风控。

LikeShop 上门家政系统服务验收拍照:完工凭证上传与评价联动功能二开

一、前言

在之前的系列文章中,我写了 LikeShop 上门家政系统的预约下单、师傅端派单流程,以及同城跑腿、连锁点餐系统的二开。这一篇聚焦家政服务履约闭环中最关键的一环——服务验收与完工凭证。

家政服务与实体电商最大的区别在于“非标履约”。买一部手机,收货时点个确认即可;但请阿姨做保洁、让师傅修空调,如果只靠用户空口一句“做完了”,一旦发生纠纷(比如“角落没打扫干净”、“零件根本没换”),平台根本无法定责。

完工拍照验收,本质上是把非标服务“标准化、可视化”。师傅完成服务后,必须上传现场凭证(清洁对比图、维修换件图),用户确认凭证后才能进行评价。这不仅降低了客诉率,也为评价体系提供了真实的参考依据。同时,优质凭证也能沉淀为师傅的个人作品集和平台的营销素材。

这篇文章就围绕凭证上传、验收状态流转、评价联动三个核心模块,把二开方案与代码实现拆解清楚。

二、业务闭环设计:从“完工”到“评价”

原生的派单履约流程是:服务中 → 师傅提交完工 → 用户确认 → 订单完成。
加入验收凭证后,流程变为:

  1. 师傅提交验收:师傅在师傅端点击“提交完工”,强制上传 2-4 张凭证图片,并填写完工备注。
  2. 状态机流转:订单进入一个新的中间态“待用户验收”(建议放在原状态 服务中 与 已完成 之间)。
  3. 用户验收:用户查看凭证,可选择“确认验收”或“拒绝验收(发起售后)”。
  4. 评价联动:用户确认验收后,跳转评价页。评价页自动加载师傅上传的完工凭证,用户结合凭证和实际感受打分。

三、数据模型设计

为了不破坏原生的订单表和师傅表,我们采用扩展表的设计。

3.1 完工凭证表

新建 ls_service_evidence:

CREATE TABLE `ls_service_evidence` (
  `id` bigint(20) UNSIGNED NOT NULL AUTO_INCREMENT,
  `order_id` int(11) NOT NULL COMMENT '订单ID',
  `technician_id` int(11) NOT NULL COMMENT '师傅ID',
  `images` text NOT NULL COMMENT '凭证图片(JSON数组)',
  `remark` varchar(255) DEFAULT '' COMMENT '师傅完工备注',
  `status` tinyint(1) DEFAULT '0' COMMENT '状态:0-待验收;1-验收通过;2-验收驳回',
  `reject_reason` varchar(255) DEFAULT '' COMMENT '用户驳回原因',
  `create_time` int(11) DEFAULT '0',
  `update_time` int(11) DEFAULT '0',
  PRIMARY KEY (`id`),
  KEY `idx_order` (`order_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='家政完工凭证表';

3.2 评价表扩展

为原有商品评价表 ls_goods_comment(或家政系统的独立评价表)增加一个字段,关联本次凭证:

ALTER TABLE `ls_goods_comment` 
ADD COLUMN `evidence_id` bigint(20) DEFAULT '0' COMMENT '关联的完工凭证ID';

四、后端核心逻辑实现

4.1 师傅提交完工(状态机流转)

遵循 LikeShop 二开“不修改核心链路”的原则,通过扩展 Logic 来调用原生的状态机方法。

// server/app/api/logic/TechnicianOrderLogic.php
class TechnicianOrderLogic
{
   
    /**
     * 师傅提交完工凭证
     */
    public static function submitEvidence(int $orderId, int $techId, array $images, string $remark): bool
    {
   
        $order = OrderModel::find($orderId);

        // 1. 校验订单归属和当前状态
        if (!$order || $order['technician_id'] != $techId) {
   
            throw new Exception('无权操作此订单');
        }
        if ($order['order_status'] != 2) {
    // 假设 2 为服务中
            throw new Exception('当前订单状态不可提交凭证');
        }
        if (count($images) < 2) {
   
            throw new Exception('请至少上传2张完工凭证照片');
        }

        Db::startTrans();
        try {
   
            // 2. 写入凭证记录
            $evidenceId = ServiceEvidenceModel::create([
                'order_id'      => $orderId,
                'technician_id' => $techId,
                'images'        => json_encode($images),
                'remark'        => $remark,
                'status'        => 0,
                'create_time'   => time()
            ])->id;

            // 3. 驱动订单状态机流转 (扩展:新增状态 6-待用户验收)
            // 注意:原有的状态流转方法需要放开 2 -> 6 的限制
            OrderStatusLogic::transit($orderId, 6, '师傅已提交完工凭证,等待用户验收');

            Db::commit();
            return true;
        } catch (Exception $e) {
   
            Db::rollback();
            throw $e;
        }
    }
}

4.2 用户验收与评价联动

用户端拉取待评价订单时,必须把凭证数据一并带出。

// server/app/api/logic/CommentLogic.php
class CommentLogic
{
   
    /**
     * 获取待评价订单的详细信息(含完工凭证)
     */
    public static function getEvaluateInfo(int $orderId, int $userId): array
    {
   
        $order = OrderModel::where('id', $orderId)->where('user_id', $userId)->find();
        if (!$order) {
   
            throw new Exception('订单不存在');
        }

        // 查询关联的凭证
        $evidence = ServiceEvidenceModel::where('order_id', $orderId)
            ->where('status', 1) // 必须是通过验收的
            ->find();

        return [
            'order_sn' => $order['order_sn'],
            'goods_name' => $order['goods_name'],
            'evidence' => [
                'images' => json_decode($evidence['images'], true),
                'remark' => $evidence['remark']
            ]
        ];
    }

    /**
     * 提交评价(带凭证ID)
     */
    public static function submitComment(int $userId, array $params): bool
    {
   
        // ... 原有校验逻辑

        // 写入评价时,带上 evidence_id
        CommentModel::create([
            'order_id'      => $params['order_id'],
            'user_id'       => $userId,
            'goods_comment' => $params['score'],
            'comment'       => $params['content'],
            'evidence_id'   => $params['evidence_id'] ?? 0, // 联动凭证
            'create_time'   => time(),
        ]);

        return true;
    }
}

五、前端交互(uniapp 师傅端与用户端)

5.1 师傅端:强制拍照与压缩上传

师傅端必须调用 uni.chooseImage,并要求接入腾讯地图水印(防造假)。

<!-- 师傅端 提交完工页面 -->
<template>
  <view class="upload-box">
    <view class="title">请上传现场完工照片(至少2张)</view>
    <view class="image-list">
      <block v-for="(item, index) in imageList" :key="index">
        <image :src="item" mode="aspectFill" @click="previewImage(index)"></image>
        <text class="delete" @click="deleteImage(index)">×</text>
      </block>
      <view class="upload-btn" @click="chooseImage" v-if="imageList.length < 4">
        <text>+</text>
      </view>
    </view>
    <textarea v-model="remark" placeholder="填写完工备注(如:已更换滤芯)"></textarea>
    <button type="primary" @click="submit">提交验收</button>
  </view>
</template>

<script>
export default {
  data() {
    return {
      imageList: [],
      remark: '',
      orderId: null
    }
  },
  methods: {
    chooseImage() {
      uni.chooseImage({
        count: 4 - this.imageList.length,
        sizeType: ['compressed'], // 强制压缩
        success: (res) => {
          // 这里真实项目中应调用 uni.uploadFile 将图片传给 OSS
          // 上传成功后把返回的 URL 塞入 imageList
          this.imageList = this.imageList.concat(res.tempFilePaths);
        }
      })
    },
    submit() {
      if (this.imageList.length < 2) return uni.showToast({ title: '至少2张', icon: 'none' });
      // 调用接口提交...
    }
  }
}
</script>

5.2 用户端:验收组件与凭证展示

在用户确认验收页面,明确展示师傅上传的对比图。在进入评价页时,凭证图以“官方履历”的形式展示在顶部,增强用户评价时的客观感。

六、状态机扩展与二开避坑清单

坑一:直接使用 update 修改订单状态,跳过状态机。
家政系统的订单状态流转严密,二开引入“待验收”状态时,必须在 OrderStatusLogic 的 TRANSITIONS 数组中配置好 服务中(2) -> 待验收(6),以及 待验收(6) -> 已完成(3) 的合法路径。所有更新必须走 transit() 方法,否则资金结算和日志将脱节。

坑二:凭证图片未做防伪/水印处理。
家政行业的黑产非常多,师傅可能用网图糊弄。前端应调用 uni.getLocation 获取经纬度,并利用 canvas 将“时间+经纬度+订单号”作为水印画在照片上(或者在后端接 OSS 的图片水印处理)。没有水印的图片,在发生纠纷时无法作为有效凭证。

坑三:师傅上传了凭证,用户死活不验收怎么办?
需要兜底机制。可以参考原生系统的“自动确认收货”定时任务(Crontab)。如果在师傅提交凭证后的第 3 天,用户仍未操作,系统自动将状态流转为 已完成,并触发评价邀请。

坑四:评价与凭证的数据强耦合导致查询变慢。
由于评价表增加了 evidence_id,在评价列表页查询时,如果每条评价都去 JOIN 凭证表会导致严重的性能问题。应当使用延迟加载或在业务层缓存。如果是列表页展示,只需返回凭证的第一张缩略图即可,不需要把全套 JSON 吐出来。

坑五:验收驳回没有限制次数。
如果用户恶意无限次驳回,师傅会被折腾死。必须设置驳回次数上限(如2次),超过上限则自动转为平台客服介入流程(走原生售后体系)。

七、总结

LikeShop 上门家政系统验收拍照功能的二开,核心在于闭环:

从“完工”到“凭证”:强制要求师傅上传带水印的图片和备注,将非标的服务成果转化为可视化的履约资产。

从“凭证”到“状态”:通过扩展 OrderStatusLogic 的状态机,严格掌控“待用户验收”的流转,确保只有用户点头,订单才最终完成。

从“凭证”到“评价”:将凭证与评价表联动,让评价不再是空洞的文字,而是基于真实履约记录(照片)的评判。这既保护了消费者的知情权,也为优秀的家政师傅沉淀了金牌简历。

目录
相关文章
|
4天前
|
Linux Go 开发工具
手机上跑 DeepSeek 智能体:开源安卓客户端 DSH Go 安装与使用指南
DSH Go 是一款开源安卓客户端,将 DeepSeek Harness 智能体引擎装进手机:免 Root、免 Termux,一键安装即用;支持本机运行(内置 Ubuntu+Node.js)或远程接管电脑会话;具备插话打断、过程折叠、屏幕操控、端到端加密分享等特色功能,真正实现智能体“口袋化”。
4124 3
|
4天前
|
弹性计算 人工智能 API
Codex超详细入门指南(下载·安装·登录·上手,全版本覆盖,2026最新版)
建议收藏本教程,2026 全年各版本更新随时回来查阅。如果你在搭建过程中遇到任何问题,欢迎结合 阿里云工单系统 提交技术支持请求,或在 阿里云开发者社区 搜索 Codex 相关话题交流。 祝你编码愉快,效率翻倍!
1872 4
|
6天前
|
JSON 前端开发 API
阿里云最新Qwen4-Max大模型介绍:模型定位、特征、能力、适用场景解析
2026 年 11 月 11 日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问 AI 平台 Token Plan,并同步接入千问办公、Qoder 等入口。该版本聚焦知识理解、世界感知、编程与 Agentic 四项升级,主打复杂编程、专业办公、前端设计与专业软件操作。预览期至 11 月 25 日 24:00,到期后模型标识下线;限时 2 折、新用户再享 5 折,最低 1 折可体验。
|
7天前
|
人工智能 前端开发 API
阿里云Qwen4-Max 大模型详解:定位、特征、能力、适用场景与相对Qwen3-Max差异解析
2026年11月11日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问AI平台Token Plan并接入千问办公、Qoder等入口。该版本聚焦知识理解、世界感知、编程与Agentic四项升级,主打复杂编程、专业办公、前端设计与专业软件操作等真实任务。预览期为11月11日10:00至11月25日24:00,仅支持Token Plan调用,到期后模型标识下线;限时2折、新用户再享5折,最低1折可体验。
|
19天前
|
Linux 开发工具 iOS开发
Codex保姆级教程(下载+安装+登录+使用,含所有版本,2026最新)
Codex是OpenAI推出的开源AI编程智能体,本地运行,可理解整个代码库,支持自然语言指令改代码、执行命令、跑测试、修Bug,兼容Win/macOS/Linux。(239字)
9106 58
|
2天前
|
传感器 安全 区块链
Windows 电脑运行安卓应用教程:开源工具 ApkStart 双击 APK 即装、独立窗口运行
ApkStart 是一款开源Windows工具,让安卓APP像原生软件一样运行:双击APK即安装、生成真实图标、独立窗口启动、开始菜单可搜索。无需传统模拟器,内置QEMU运行时,支持数据互通、ARM兼容与命令行操作。(239字)
|
14天前
|
Linux 开发工具 iOS开发
2026最新codex下载安装保姆级使用教程(下载+安装+登录+使用,含所有历史版本)
本文详解OpenAI Codex国内快速上手指南:提供Win/macOS/Linux全平台免安装包、npm/Homebrew等多方式安装、账号/API Key双登录、简体中文切换,覆盖下载、安装、汉化、使用及高频避坑(如微软商店失败、npm超时等),10分钟即可跑通。
3166 9
|
20天前
|
JavaScript API iOS开发
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(DSH)是DeepSeek于2026年开源的MIT协议AI Agent框架,支持插件化组装模型、工具、沙箱与UI,兼容主流大模型。本文提供免Node.js的桌面端安装包(Win/macOS),含详细图文教程及热门插件推荐。
5898 69
|
2天前
|
人工智能 弹性计算 开发工具
零成本玩各大模型!DeepSeek Harness dsh-our-free-model 插件,13 个厂商模型直接用
总结一下:装这个插件,你不用注册、不用绑卡、不用填一个 Key,就能在 DeepSeek Harness 里用上 DeepSeek V4.1 Flash、Kimi K3 这一批前沿模型,而且是白嫖的、还不限量。三步搞定:下载插件,复制包含 `package.json` 的插件目录路径,在「添加插件」里粘贴路径安装并重启。无论是在阿里云 ECS 上通过命令行部署的 Web 版,还是本地的 Electron 桌面端,都能顺利跑通,快速搭建一套零成本的免费模型使用环境。
845 0