LikeShop 上门家政系统服务验收拍照:完工凭证上传与评价联动功能二开
一、前言
在之前的系列文章中,我写了 LikeShop 上门家政系统的预约下单、师傅端派单流程,以及同城跑腿、连锁点餐系统的二开。这一篇聚焦家政服务履约闭环中最关键的一环——服务验收与完工凭证。
家政服务与实体电商最大的区别在于“非标履约”。买一部手机,收货时点个确认即可;但请阿姨做保洁、让师傅修空调,如果只靠用户空口一句“做完了”,一旦发生纠纷(比如“角落没打扫干净”、“零件根本没换”),平台根本无法定责。
完工拍照验收,本质上是把非标服务“标准化、可视化”。师傅完成服务后,必须上传现场凭证(清洁对比图、维修换件图),用户确认凭证后才能进行评价。这不仅降低了客诉率,也为评价体系提供了真实的参考依据。同时,优质凭证也能沉淀为师傅的个人作品集和平台的营销素材。
这篇文章就围绕凭证上传、验收状态流转、评价联动三个核心模块,把二开方案与代码实现拆解清楚。
二、业务闭环设计:从“完工”到“评价”
原生的派单履约流程是:服务中 → 师傅提交完工 → 用户确认 → 订单完成。
加入验收凭证后,流程变为:
- 师傅提交验收:师傅在师傅端点击“提交完工”,强制上传 2-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 的状态机,严格掌控“待用户验收”的流转,确保只有用户点头,订单才最终完成。
从“凭证”到“评价”:将凭证与评价表联动,让评价不再是空洞的文字,而是基于真实履约记录(照片)的评判。这既保护了消费者的知情权,也为优秀的家政师傅沉淀了金牌简历。