package com.doumee.service.business;
|
|
import com.doumee.core.model.PageData;
|
import com.doumee.core.model.PageWrap;
|
import com.doumee.dao.dto.DriverActiveOrderDTO;
|
import com.doumee.dao.dto.DriverGrabOrderDTO;
|
import com.doumee.dao.business.model.DriverInfo;
|
import com.doumee.dao.dto.DriverLoginRequest;
|
import com.doumee.dao.dto.DriverPickupDTO;
|
import com.doumee.dao.dto.DriverRegisterRequest;
|
import com.doumee.dao.dto.DriverVerifyRequest;
|
import com.doumee.dao.vo.AccountResponse;
|
|
import java.util.List;
|
|
/**
|
* 司机注册信息Service定义
|
* @author rk
|
* @date 2026/04/08
|
*/
|
public interface DriverInfoService {
|
|
/**
|
* 创建
|
*
|
* @param driverInfo 实体对象
|
* @return Integer
|
*/
|
Integer create(DriverInfo driverInfo);
|
|
/**
|
* 主键删除
|
*
|
* @param id 主键
|
*/
|
void deleteById(Integer id);
|
|
/**
|
* 删除
|
*
|
* @param driverInfo 实体对象
|
*/
|
void delete(DriverInfo driverInfo);
|
|
/**
|
* 批量主键删除
|
*
|
* @param ids 主键集
|
*/
|
void deleteByIdInBatch(List<Integer> ids);
|
|
/**
|
* 主键更新
|
*
|
* @param driverInfo 实体对象
|
*/
|
void updateById(DriverInfo driverInfo);
|
|
/**
|
* 批量主键更新
|
*
|
* @param driverInfos 实体集
|
*/
|
void updateByIdInBatch(List<DriverInfo> driverInfos);
|
|
/**
|
* 主键查询
|
*
|
* @param id 主键
|
* @return DriverInfo
|
*/
|
DriverInfo findById(Integer id);
|
|
/**
|
* 条件查询单条记录
|
*
|
* @param driverInfo 实体对象
|
* @return DriverInfo
|
*/
|
DriverInfo findOne(DriverInfo driverInfo);
|
|
/**
|
* 条件查询
|
*
|
* @param driverInfo 实体对象
|
* @return List<DriverInfo>
|
*/
|
List<DriverInfo> findList(DriverInfo driverInfo);
|
|
/**
|
* 分页查询
|
*
|
* @param pageWrap 分页对象
|
* @return PageData<DriverInfo>
|
*/
|
PageData<DriverInfo> findPage(PageWrap<DriverInfo> pageWrap);
|
|
/**
|
* 条件统计
|
*
|
* @param driverInfo 实体对象
|
* @return long
|
*/
|
long count(DriverInfo driverInfo);
|
|
/**
|
* 司机验证码登录（手机号+短信验证码，无账号自动注册）
|
*
|
* @param request 验证码登录请求
|
* @return AccountResponse
|
*/
|
AccountResponse register(DriverRegisterRequest request);
|
|
/**
|
* 发送司机验证码登录验证码
|
*
|
* @param telephone 手机号
|
*/
|
void sendRegisterCode(String telephone);
|
|
/**
|
* 司机手机号+密码登录
|
*
|
* @param request 登录请求
|
* @return AccountResponse
|
*/
|
AccountResponse login(DriverLoginRequest request);
|
|
/**
|
* 提交实名认证（初次提交或驳回后修改）
|
*
|
* @param memberId 会员主键
|
* @param request 认证请求
|
*/
|
void submitVerify(Integer memberId, DriverVerifyRequest request);
|
|
/**
|
* 查询司机实名认证详情
|
*
|
* @param memberId 会员主键
|
* @return DriverInfo
|
*/
|
DriverInfo getVerifyDetail(Integer memberId);
|
|
/**
|
* 审批司机实名认证（管理端）
|
*
|
* @param auditDTO 审批参数
|
*/
|
void auditVerify(com.doumee.dao.dto.AuditDTO auditDTO);
|
|
/**
|
* 管理端查询司机详情（含附件图片、车辆类型名称）
|
*
|
* @param id 司机主键
|
* @return DriverInfo
|
*/
|
DriverInfo getDetail(Integer id);
|
|
/**
|
* 修改司机状态（启用/禁用）
|
*
|
* @param dto 修改状态请求
|
*/
|
void changeStatus(com.doumee.dao.dto.ChangeStatusDTO dto);
|
|
/**
|
* 切换司机接单状态
|
*
|
* @param memberId 会员主键
|
* @param status 接单状态：0=未接单；1=接单中
|
*/
|
void updateAcceptingStatus(Integer memberId, Integer status);
|
|
/**
|
* 更新司机实时定位
|
*
|
* @param memberId 会员主键
|
* @param longitude 经度
|
* @param latitude 纬度
|
*/
|
void updateLocation(Integer memberId, Double longitude, Double latitude);
|
|
/**
|
* 获取司机端首页信息
|
*
|
* @param memberId 会员主键
|
* @return DriverCenterVO
|
*/
|
com.doumee.dao.vo.DriverCenterVO getDriverCenterInfo(Integer memberId);
|
|
/**
|
* 司机抢单大厅 - 分页查询可抢订单
|
*
|
* @param memberId 当前登录会员主键
|
* @param pageWrap 分页请求
|
* @return PageData<DriverGrabOrderVO>
|
*/
|
com.doumee.core.model.PageData<com.doumee.dao.vo.DriverGrabOrderVO> grabOrderHall(Integer memberId, PageWrap<DriverGrabOrderDTO> pageWrap);
|
|
/**
|
* 司机进行中订单列表
|
*
|
* @param memberId 会员主键
|
* @param dto 查询条件（status: 3=已抢单, 4=派送中）
|
* @return 订单列表
|
*/
|
java.util.List<com.doumee.dao.vo.DriverGrabOrderVO> activeOrders(Integer memberId, DriverActiveOrderDTO dto);
|
|
/**
|
* 司机端订单详情
|
*
|
* @param driverId 司机主键
|
* @param orderId 订单主键
|
* @return DriverOrderDetailVO
|
*/
|
com.doumee.dao.vo.DriverOrderDetailVO driverOrderDetail(Integer driverId, Integer orderId);
|
|
/**
|
* 司机取消订单（已接单status=2时取消，释放回抢单大厅）
|
*
|
* @param driverId 司机主键
|
* @param orderId 订单主键
|
* @param reason 取消原因
|
*/
|
void cancelOrder(Integer driverId, Integer orderId, String reason);
|
|
/**
|
* 司机抢单，订单状态从已寄存(2)变为已接单(3)
|
*
|
* @param driverId 司机主键
|
* @param orderId 订单主键
|
*/
|
void grabOrder(Integer driverId, Integer orderId);
|
|
/**
|
* 司机完成取件，订单状态从已接单(3)变为派送中(4)
|
*
|
* @param driverId 司机主键
|
* @param dto 取件请求参数
|
*/
|
void confirmPickup(Integer driverId, DriverPickupDTO dto);
|
|
}
|
