package com.xiaopeng.operation.service;

import com.xiaopeng.operation.dto.PriorityMatchResult;

/**
 * UID-VIN 优先匹配执行器接口
 * <p>
 * 在 processPushOrder 流程中，对绑定了 VIN 的 UID 执行优先匹配逻辑：
 * 查配置 → 校验车辆状态 → 返回匹配结果。
 * </p>
 */
public interface UidVinPriorityMatcher {

    /**
     * 尝试优先匹配绑定车辆
     *
     * @param uid              订单用户ID
     * @param orderNo          订单编号（用于日志记录）
     * @param electronicAreaId 订单所属电子围栏ID
     * @return 匹配结果：成功时 matched=true 并携带 VIN，失败时 matched=false 并携带 failReason
     */
    PriorityMatchResult tryPriorityMatch(String uid, String orderNo, String electronicAreaId);
}