Appearance
概述
覆盖 EBAOZU V4 租赁订单合同从实名认证、人脸活体核验、印章创建、合同生成、静默代签、履约守护到异步归档的完整链路,重点深度剖析“爱签”通道的技术实现细节与业务契约。
EBAOZU V4 租赁业务的电子合同由 第三方电子签名平台(爱签 / e签宝) + 自研业务编排引擎 协同驱动。系统通过灵活的配置支持不同的签署通道与签约时机节点。
核心系统配置与字段映射
1. 核心系统配置项
配置键 (sys_config) | 名称 / 默认值 | 关键取值及业务行为 |
|---|---|---|
contract_sign | 合同通道 (默认 1) | 1 = e签宝:传统流程,下单后人脸核身与签署。2 = 爱签:自研推荐通道,支持私域下单前强核身、公域下单后置核验补签、静默代签与延后签署。 |
contract_sign_node | 签署节点 (默认 1) | 仅爱签有效:1 = 审核即签署:机审/人审通过后立即触发静默代签与扣费。2 = 发货时签署:审核通过仅置状态为 0(待签约),延后至发货/核销前执行签署守护。 |
face_auth_config | 人脸验证开关 (默认 1) | 0 = 关闭:开启“免人脸核验”通道。系统遵循**“无人脸免合同签署”契约,跳过三方人脸核身与个人印章生成,审核或履约时合同状态直达 2(已完成),不调用三方代签接口,无 API 扣费。1 = 开启**:开启活体人脸识别核身与电子签约。 |
face_auth_node | 人脸识别时机节点 (默认 1) | 仅爱签有效:1 = 下单前人脸 (默认):私域提交订单前强行校验人脸,风控最前置。2 = 下单后人脸 (推荐):私域先下单免押,后续在订单详情内补人脸;避免弃单/拒审废单产生的三方人脸 API 费用。 |
2. 核心数据表与关键字段
| 数据表 | 关键字段 | 类型 | 说明 / 状态机 |
|---|---|---|---|
eb_user | card_id | varchar | 用户身份证号(作为爱签平台开户的唯一识别码 account) |
real_name | varchar | 用户真实姓名 | |
asign_seal_no | varchar | 爱签个人印章编号(非空表示爱签开户就绪) | |
eb_store_order_lease | contract_status | tinyint | -1 未生成 | 0 待签约 | 1 已签约(签署中) | 2 已完成 | 3 已取消/拒签 | 4 蚂蚁链待签代扣 |
face_auth_status | tinyint | 0 未认证 | 1 认证中 | 2 认证通过 | |
face_auth_detail | json | 人脸核验流水数据(含 serialNo、identifyUrl、核身详情及续租记录) | |
contract_detail | json | 合同元数据(含模板参数、签署时间 sign_time、signMark、oss 合同下载地址) | |
eb_system_store | asign_seal_no | varchar | 门店(出租方/甲方)企业爱签印章编号 |
eb_system_cache | contract_signers | json | 平台签约主体配置(signers_A 平台自营甲方,signers_C 平台服务丙方) |
3. API 计费与扣费类型对照(event('user.charge'))
扣费类型 (type) | 业务场景 | 扣费触发点 | 对应通道 |
|---|---|---|---|
| 25 | 二要素校验扣费 | AsignServices::verifyIdcard2 | 爱签专属 |
| 26 | 身份证 OCR 识别扣费 | EsignServices::ocr_idcard (ocrIdentify) | 爱签专属 |
| 27 | 人脸活体核身记录扣费 | Asign::handleAuthFinished | 爱签专属 |
| 28 | 三要素认证扣费 | ACsignService::authPersonMobile3 | 爱签专属 |
| 29 | 合同签署扣费 | SystemContractServices::asignFlow / asignReletFlow | 爱签专属 |
| 4 | 身份证 OCR / 人脸识别 | EsignServices::ocr_idcard | e签宝 |
| 12 | 刷脸认证扣费 | Esign::verify_callback | e签宝 |
| 13 | 合同签署扣费 | EsignServices::save_contract | e签宝 |
合同状态机与流转
爱签“实名认证 - 人脸识别 - 合同签署”全流程
阶段细节技术详解
阶段一:实名认证与二要素校验
1. 触发与入口
- 前端控制器:[
app/controller/api/v2/user/Esign.php](file:///www/wwwroot/ebaozu_v4/app/controller/api/v2/user/Esign.php) 的ocr_idcard方法。 - 业务服务类:[
app/services/user/EsignServices.php](file:///www/wwwroot/ebaozu_v4/app/services/user/EsignServices.php)。 - 支持两种实名路径:
- 手动录入:调用
save_commit_info($uid, $real_name, $card_id)。 - OCR 识别:传入身份证正反面 base64,调用
ocr_idcard()。
- 手动录入:调用
2. 爱签二要素校验(verifyIdcard2)
当 contract_sign == 2(爱签)时:
- 调用 [
AsignServices::verifyIdcard2($real_name, $card_id)](file:///www/wwwroot/ebaozu_v4/app/services/user/AsignServices.php#L46-L49)。 - 底层通过 [
ACsignService::verifyIdcard2](file:///www/wwwroot/ebaozu_v4/app/services/third/ACsignService.php#L421) 校验真实姓名与身份证号一致性。 - 核验通过后触发扣费事件:
event('user.charge', [$uid, $uid, 25, 25, ''])(扣费类型 25)。 - 成功后将
real_name、card_id、出生日期与性别更新至eb_user表,或按orderkey暂存 Redis。
3. 身份证 OCR 识别(ocrIdentify)
- 识别调用:[
AsignServices::ocrIdentify($infoImg, $emblemImg)](file:///www/wwwroot/ebaozu_v4/app/services/user/AsignServices.php#L60-L66)。 - 解析正面姓名、身份证号、出生年月、性别、住址、民族;反面有效期限与签发机关。
- 触发扣费事件:
event('user.charge', [$uid, $uid, 2, 26, ''])(扣费类型 26)。 - 结果持久化至风控表
eb_risk(type=26)。
阶段二:人脸活体识别核身
1. 下单前门禁与公私域场景分流
系统根据下单入口与业务场景,采用私域前置强校验与公域后置补核身的双轨策略:
私域常规下单(前置人脸强校验):
- 入口:小程序商品详情 -> 下单确认页(走 [
StoreOrderCreateServices::createOrder](file:///www/wwwroot/ebaozu_v4/app/services/order/StoreOrderCreateServices.php#L233-L270))。 - 门禁逻辑:租赁订单(
lease_type == 1)且开启人脸(face_auth_config == 1)时,若通道为爱签(contract_sign == 2),按以下顺序核验人脸通过凭证:- 主缓存检查:读取当前确认会话缓存
face_verify_check{$uid}{$key}{$uid}; - 降级策略 1(全局缓存):检查用户全局缓存
face_verify_check{$uid}; - 降级策略 2(持久化兜底):检查数据库用户状态(
eb_user.certify_status == 1 && !empty(eb_user.asign_seal_no)),已实名且已开立爱签印章的用户免重复刷脸。
- 主缓存检查:读取当前确认会话缓存
- 若关闭人脸(
face_auth_config == 0)则赋予默认免核身标识;若均未命中且为爱签通道,抛出ValidateException('人脸验证失败, 请联系客服!')阻断下单。 - 订单创建成功后,
eb_store_order_lease直接固化face_auth_status = 2(已完成)。
- 入口:小程序商品详情 -> 下单确认页(走 [
公域快捷下单(后置人脸与异步补签):
- 入口:支付宝公域推广、租售一体快捷下单推送等(如
StoreOrder::createQuickSaleOrder/rentOrderCreate)。 - 特征:不经过
StoreOrderCreateServices::createOrder,订单直接落库并创建租赁单,初始face_auth_status = 0(待认证),合同状态为-1。 - 机制:
- 审核不阻断:后台审核订单时(
StoreOrderServices::leaseAudit),爱签通道特意放行未认证状态(face_auth_status != 2不报错阻断),并标记待补签; - 后置核验驱动补签:用户在订单列表中发起刷脸,核验成功后由
persons_verify_check驱动异步补签任务asignSignAfterFaceVerify; - 履约强拦截底线:若直到商家发货或自提核销时用户仍未完成人脸,由
ensureContractSigned坚决阻断履约。
- 审核不阻断:后台审核订单时(
- 入口:支付宝公域推广、租售一体快捷下单推送等(如
2. 发起人脸识别(persons_verify)
- 控制器入口:
POST /api/v2/user/esign/persons_verify。 - 企业账户前置核验:调用 [
SystemContractServices::checkStoreAsignAccount($store_id)](file:///www/wwwroot/ebaozu_v4/app/services/other/SystemContractServices.php#L1137),确保当前门店(或平台)的爱签印章已开通,未开通则立即阻断并提示管理员。 - 生成核身链接:调用 [
AsignServices::newAuthPersonFace($name, $cardId, $bizId, $faceAuthMode)](file:///www/wwwroot/ebaozu_v4/app/services/user/AsignServices.php#L132)(支付宝小程序faceAuthMode = 5,微信小程序faceAuthMode = 4)。 - 获取爱签返回的核身链接
identifyUrl及流水号serialNo,写入 Redis 缓存face_verify{$uid}(24 小时)。 - 前端小程序通过
<web-view>打开identifyUrl,引导用户完成活体检测。
3. 核验结果核身闭环(双轨保障机制)
- 前端主动轮询 / PostMessage 触发核验:
- 小程序 WebView 检测完成向小程序发消息,触发
POST /api/v2/user/esign/persons_verify_check。 - 后端执行 [
EsignServices::persons_verify_check](file:///www/wwwroot/ebaozu_v4/app/services/user/EsignServices.php#L919)。 - 调用 [
AsignServices::getAuthRecordInfo($serialNo)](file:///www/wwwroot/ebaozu_v4/app/services/user/AsignServices.php#L158) 查询核身结果。 - 核身成功(
result == 1):- 更新
eb_store_order_lease.face_auth_status = 2及face_auth_detail。 - 写入 Redis 缓存
face_verify_check{$uid}及确认页缓存。 - 若用户
asign_seal_no为空,异步派发开户任务:OrderWithholdJob::dispatchSece(3, 'addAsignUser', [$uid, $serialNo])。 - 异步补签触发点:若传入了已审订单(如公域下单或审核先行通过的订单),立即派发补签任务:
OrderCreateAfterJob::dispatchSece(1, 'asignSignAfterFaceVerify', [$oid])。
- 更新
- 小程序 WebView 检测完成向小程序发消息,触发
- 爱签服务端异步回调(
notify):- 爱签向
/api/asign/notify推送action=authFinished(type=个人人脸活体认证网页版)。 - 由 [
app/controller/api/v2/user/Asign.php](file:///www/wwwroot/ebaozu_v4/app/controller/api/v2/user/Asign.php#L74) 的handleAuthFinished处理:- 若用户无印章,派发异步任务
OrderWithholdJob::dispatchDo('addAsignUser', [$uid, $serialNo])。 - 触发爱签人脸记录扣费:
event('user.charge', [$uid, $uid, 3, 27, ''])(扣费类型 27)。 - 存入风控记录
eb_risk(type=27)并更新 Redis 缓存。
- 若用户无印章,派发异步任务
- 爱签向
阶段三:爱签个人用户开户与印章生成
- 任务执行点:[
app/jobs/order/OrderWithholdJob.php::addAsignUser($uid, $serialNo)](file:///www/wwwroot/ebaozu_v4/app/jobs/order/OrderWithholdJob.php#L647)。 - 执行逻辑:
- 印章查重与复用:首先调用 [
AsignServices::getUserSeals($card_id)](file:///www/wwwroot/ebaozu_v4/app/services/user/AsignServices.php#L101) 查询用户在爱签端已有印章。若已存在默认印章,直接将sealNo写入eb_user.asign_seal_no并返回,杜绝重复创建。 - 创建个人用户(V2 接口):若未开户,调用 [
AsignServices::addPersonalUser($uid, $serialNo)](file:///www/wwwroot/ebaozu_v4/app/services/user/AsignServices.php#L76)。将身份证号作为account,传入姓名、手机号及实名流水号serialNo。 - 印章生成与样式规范化:开户成功获得
sealNo并绑定到eb_user;紧接着调用 [AsignServices::createSeal($account, $sealNo)](file:///www/wwwroot/ebaozu_v4/app/services/user/AsignServices.php#L326) 格式化默认印章样式。
- 印章查重与复用:首先调用 [
阶段四:合同生成与静默签署编排(asignFlow)
1. 核心签署编排(asignFlow)
位于 [app/services/other/SystemContractServices.php::asignFlow($order)](file:///www/wwwroot/ebaozu_v4/app/services/other/SystemContractServices.php#L1361):
- 合同模板核验与同步:
- 读取本地模板
public/uploads/contract/esign_sdk3_tempalte.pdf并计算 md5。 - 查询 Redis 缓存(缓存 30 天);未命中则调用 [
AsignServices::uploadTemplate](file:///www/wwwroot/ebaozu_v4/app/services/user/AsignServices.php#L343) 将模板推送到爱签平台。
- 读取本地模板
- 组装组件并创建待签署合同:
- 调用
getContractComponents()组装承租人姓名、身份证、手机、出租人主体、商品规格、租期、租金等填充参数。 - 调用 [
AsignServices::createContract($contractNo, $contractName, $templateNo, $params)](file:///www/wwwroot/ebaozu_v4/app/services/user/AsignServices.php#L366)。
- 调用
- 添加三方主体并静默代签(
addSigner):- 组装三方签章主体:
- 甲方(出租方):加盟店取
eb_system_store.companyid;自营店/平台取contract_signers.signers_A.companyid。 - 乙方(承租人):用户身份证号
eb_user.card_id。 - 丙方(服务平台):平台企业代码
contract_signers.signers_C.companyid。
- 甲方(出租方):加盟店取
- 签章模式为静默签署:
signType = 2(后台自动盖章,用户与商家无感)。 - 调用 [
AsignServices::addSigner($order)](file:///www/wwwroot/ebaozu_v4/app/services/user/AsignServices.php#L392) 提交签署。
- 组装三方签章主体:
- 合同扣费与状态流转:
- 签署成功立即触发扣费:
event('user.charge', [$order['uid'], $order['id'], 1, 29, ''])(扣费类型 29)。 - 固化订单状态:更新
eb_store_order_lease.contract_status = 2(已完成),contract_detail保存返回的印章与签署详情。
- 签署成功立即触发扣费:
2. 续租签署流程(asignReletFlow)
- 位于 [
SystemContractServices::asignReletFlow($order, $relet_times)](file:///www/wwwroot/ebaozu_v4/app/services/other/SystemContractServices.php#L1423)。 - 合同编号规则为
{$order_id}_relet_{$relet_times},模板为esign_sdk3_tempalte_relet.pdf。 - 复用承租人已认证的人脸与印章信息进行静默续签,扣除续租合同费(类型 29),更新租赁信息。
阶段五:签署节点分流、免核身闭环与履约签署守护
系统支持通过 contract_sign_node 与 face_auth_config 协同控制合同生命周期:
模式 0:免人脸免合同签署通道(face_auth_config == 0)
- 最高优先级判定(
isOrderNoFaceAuth):- 系统在审核流入口 [
StoreOrderServices::handleLeaseAuditContract](file:///www/wwwroot/ebaozu_v4/app/services/order/StoreOrderServices.php) 中将免人脸判定提升为第一优先级(前置于发货签署节点与具体三方通道分支); - 判定逻辑兼顾订单快照(优先读取
face_auth_detail中的face_auth_config: 0)与全局配置兜底(全局开关关闭时存量无快照单平滑放行); - 命中免人脸后,系统自动将
contract_status直达更新为2(已完成),记录日志审核-免人脸配置直达合同完成,安全返回,无人脸免合同签署,彻底跳过三方印章开立与合同接口调用; - 审核前置门禁豁免:在
leaseAudit中豁免face_auth_status != 2校验,解决管理员审核存量单时报“人脸未验证”的卡死问题; - 履约状态自动补偿:若历史订单在发货阶段仍处于待签约(
0)或未生成(-1),[ensureContractSigned](file:///www/wwwroot/ebaozu_v4/app/services/order/StoreOrderServices.php) 会在放行发货的同时主动补偿更新contract_status = 2,消除后台红字悬挂; - 端侧死循环防御:状态机中免人脸订单不赋予
_type = 99(待认证),彻底避免移动端进入详情页自动触发daikeCheck()调起人脸 API 报错;后台与门店端表格友好展示为绿色“免认证”标签。
- 系统在审核流入口 [
模式 1:审核即签署(contract_sign_node == 1)
- 审核门禁差异:
- e签宝模式(
contract_sign == 1):若人脸核身未完成(face_auth_status != 2),审核直接抛出异常拦截; - 爱签模式(
contract_sign == 2):人脸未完成不阻断审核,系统允许先通过风控审核,将签署动作交由后续异步补签或履约守卫处理。
- e签宝模式(
- 机审/人审通过后分支处理([
StoreOrderServices::handleLeaseAuditContract](file:///www/wwwroot/ebaozu_v4/app/services/order/StoreOrderServices.php#L5374)):- Fast Path(全就绪即签):
isAsignReady为 true(face_auth_status == 2且用户印章已具备)时,直接获取分布式并发锁asign_sign_running_{$oid}执行asignFlow静默签署,并派发uploadAsignContract异步归档。 - 印章未就绪:人脸已通过(
face_auth_status == 2)但印章异步生成中,审核追加后缀,爱签合同待人脸/爱签用户就绪后补签,并派发异步补签任务OrderCreateAfterJob::asignSignAfterFaceVerify。 - 人脸未就绪(如公域下单):人脸未完成(
face_auth_status != 2),审核追加后缀,爱签合同待人脸/爱签用户就绪后补签,不预先派发补签任务;后续承租人主动完成刷脸时,由persons_verify_check统一驱动补签。
- Fast Path(全就绪即签):
- 异步补签执行机制(
OrderCreateAfterJob::asignSignAfterFaceVerify):- 具备 5 项守卫检查(发货签署模式跳过、未审核跳过、合同已完成跳过、非爱签通道跳过、人脸未完成跳过);
- 若用户印章尚未生成完毕,触发
addAsignUser并通过asign_sign_retry_{$oid}标记延迟 5 秒重试一次补签;若已重试过仍未就绪则记录 error 日志安全退出,严防死循环。
模式 2:发货时签署模式(contract_sign_node == 2)
- 审核通过时:仅将
contract_status置为0(待签约),记录日志跳过提前签署与扣费。 - 补签任务自动跳过:
asignSignAfterFaceVerify遇此模式直接退出。 - 底层通用履约守护(
ensureContractSigned):- 位于 [
StoreOrderServices::ensureContractSigned($oid)](file:///www/wwwroot/ebaozu_v4/app/services/order/StoreOrderServices.php#L5239)。 - 在商家于总后台、门店端、供应商端操作订单发货或自提核销时,底层强制前置执行。
- 安全门禁:
- 校验是否为租赁单,非租赁单直接放行。
- 校验人脸核身:若
face_auth_status != 2,强行拦截并报错:"用户人脸核身尚未完成,无法签署合同,禁止履约交付"。 - 校验合同状态:若已是
2(已签署),幂等放行。 - 分布式并发锁:加锁
asign_sign_running_{$oid}(30s)。 - 调用
asignFlow($order)实施即时静默代签并派发 OSS 归档。
- 位于 [
阶段六:合同归档与下载(uploadAsignContract)
- 异步任务:[
app/jobs/order/OrderCreateAfterJob.php::uploadAsignContract($oid)](file:///www/wwwroot/ebaozu_v4/app/jobs/order/OrderCreateAfterJob.php#L395)。 - 执行流程:
- 读取订单
contract_detail,若已有oss地址则直接幂等退出。 - 调用 [
AsignServices::downloadContract($contractNo)](file:///www/wwwroot/ebaozu_v4/app/services/user/AsignServices.php#L496) 从爱签拉取签署好的 PDF 二进制数据。 - 调用
SystemContractServices::uploadEsign3Contract上传至阿里云 OSS。 - 将 OSS 访问绝对 URL 回写保存至
eb_store_order_lease.contract_detail['oss']。
- 读取订单
阶段七:爱签服务端异步回调(/api/asign/notify)
控制器入口:[app/controller/api/v2/user/Asign.php::notify](file:///www/wwwroot/ebaozu_v4/app/controller/api/v2/user/Asign.php#L39)。
回调 action / 标识 | 业务含义 | 处理方法与执行链 |
|---|---|---|
authFinished | 人脸活体 / 企业认证完成 | 1. 个人认证(handleAuthFinished):派发 addAsignUser 异步开户,记录扣费(type=27)与风控。2. 企业认证( handleCompanyAuthFinished):调用 addCompanyUser 为门店/平台生成企业印章。 |
signCompleted | 合同全员签署完成 | handleSignCompleted:1. 更新 contract_status = 2 及签署元数据。2. 派发代扣检查: OrderWithholdJob::dispatchDo('checkWithhold', [$oid, 1])。3. 派发状态流转通知: OrderStatusJob::dispatch([$oid, 'esign_complete', ...])。4. 派发 OSS 归档任务: OrderCreateAfterJob::dispatchSece(1, 'uploadAsignContract', [$oid])。 |
status == 3 | 合同拒签 / 过期失效 | handleSignRejected:将 contract_status 更新为 3(已取消),记录拒签原因与时间。 |
并发控制、幂等与故障自愈机制
- 跨入口防并发锁:
- 锁键名:
asign_sign_running_{$oid}(Redis NX,过期时间 30s)。 - 作用域:覆盖审核通过直接签署、异步补签任务(
asignSignAfterFaceVerify)、发货履约守护(ensureContractSigned),彻底杜绝并发下重复盖章与多重扣费。
- 锁键名:
- 异步补签防死循环机制:
- 锁键名:
asign_sign_retry_{$oid}(Redis 缓存 600s)。 - 当补签任务执行时若发现用户印章未就绪,派发
addAsignUser并延迟 5 秒重试一次补签;若重试后印章仍未就绪则记录 error 日志并安全退出,绝不无限入队堵塞队列。
- 锁键名:
- 爱签平台错误码幂等兼容:
- 在 [
AsignServices::handleReturn](file:///www/wwwroot/ebaozu_v4/app/services/user/AsignServices.php#L28-L30) 中,针对以下幂等错误码按成功处理:100018:重复提交。100030:重复上传模板。100055:合同编号已存在。
- 在 [
- 归档兜底:
- 签署回调到达时若发现合同已是终态 2 但
oss字段为空,自动补发uploadAsignContract异步下载上传。
- 签署回调到达时若发现合同已是终态 2 但
关键日志关键字与排障指南
1. 核心 dev_log 检索关键字
| 检索关键字 | 触发位置 | 日志级别 | 业务含义 |
|---|---|---|---|
审核-免人脸配置直达合同完成 | StoreOrderServices | info | 免人脸模式下,审核直接闭环置 contract_status=2 |
履约交付-免人脸补偿合同状态为已完成 | StoreOrderServices | info | 发货时识别免人脸订单并补偿回填合同状态为已完成 |
asignSignAfterFaceVerify-skip-no_face_auth | OrderCreateAfterJob | info | 异步补签队列识别免人脸订单,短路跳过 |
asignSignAfterFaceVerify-正在执行, 跳过重复入队 | OrderCreateAfterJob | info | 并发锁生效,跳过重复触发 |
asignSignAfterFaceVerify-enter | OrderCreateAfterJob | info | 满足 5 项守卫条件,正式进入补签 |
asignSignAfterFaceVerify-addAsignUser-trigger | OrderCreateAfterJob | info | 用户未开户,触发开户并预定 5 秒后重试 |
asignSignAfterFaceVerify-爱签合同静默签署完成 | OrderCreateAfterJob | info | 异步补签静默盖章成功 |
履约合同守护-爱签签署成功并固化状态 | StoreOrderServices | info | 发货时签署模式下,履约阶段签署成功 |
addAsignUser-{uid} | OrderWithholdJob | info | 用户成功创建爱签印章 |
addAsignUser失败-{uid} | OrderWithholdJob | error | 爱签用户创建失败,检查二要素流水号 |
爱签合同异步回调-signCompleted | Asign.php | info | 爱签签署完成通知到达 |
爱签接口调用失败 | AsignServices | error | 爱签底层 HTTP API 返回异常 |
2. 常见故障对照与排障步骤
| 异常症状 | 可能原因 | 排查步骤与解决方案 |
|---|---|---|
| 下单时提示“人脸验证失败, 请联系客服!” | 私域下单前未通过人脸核身或缓存丢失 | 1. 仅出现在私域常规下单场景; 2. 检查确认会话缓存 face_verify_check{$uid}{$key}{$uid} 及全局 face_verify_check{$uid} 是否存在;3. 检查用户是否具备已实名与爱签印章持久化降级; 4. 确认前端活体识别后是否成功调用了 persons_verify_check。 |
| 发起人脸报错“爱签合同企业账户未配置” | 门店或平台尚未创建爱签印章 | 检查加盟店对应 eb_system_store.asign_seal_no,或平台配置 contract_signers.signers_A.asign_seal_no,需先通过企业实名认证生成印章。 |
订单已审核,但 contract_status 始终为 0 | 开启了发货时签署模式(node=2) | 属于正常业务表现。核实系统配置 contract_sign_node,此模式下将在发货/自提核销时由 ensureContractSigned 触发签署。 |
| 订单审核通过后合同停留在待补签 | 公域下单后置刷脸待完成,或爱签开户中 | 1. 若为公域订单,用户尚未刷脸属于正常状态,待用户在端内完成刷脸后系统自动触发异步补签; 2. 若用户已刷脸,查 eb_store_order_lease.face_auth_status 是否为 2;3. 查 eb_user.asign_seal_no 是否为空;4. 搜日志 addAsignUser失败,确认实名流水号 serialNo 是否有效。 |
| 发货或自提核销提示“用户人脸核身尚未完成” | 承租人未完成活体核身 | 客户必须完成刷脸认证后,商家方可发货履约,系系统安全风控强管控行为。 |
| 免人脸订单审核后列表仍显示“待签约” | 存量历史单未经过状态自动补偿 | 在后台执行发货或自提核销时,ensureContractSigned 会自动检测并补偿将 contract_status 回填为 2;若需立即消除,可在后台重新点击审核或触发状态刷新。 |
| 后台修改商品规格提示“人脸未验证” | 未正确识别免人脸豁免 | 确认代码已包含 updateProductAttr 免人脸判定(!$this->isOrderNoFaceAuth($order))。 |
| 订单已完成但无下载 PDF 链接 | 异步归档 OSS 任务失败或为免人脸订单 | 1. 若为免人脸订单(face_auth_config=0),系统遵循免签契约未生成三方电子合同,无 PDF 属正常预期;2. 若为正常签约订单,检查 OSS 配置与网络连通性,或查看 uploadAsignContract 错误日志。 |