增加与ai大模型对话

huimv-employment/fe-api/src/main/java/com/huimv/employment/controller/mp/EmploymentOrderController.java

@@ -10,6 +10,7 @@ import com.huimv.employment.service.order.dto.OrderStartWorkRequest;
 import com.huimv.employment.service.order.dto.OrderStartWorkResponse;
 import com.huimv.employment.service.settlement.SettlementService;
 import com.huimv.employment.service.settlement.dto.OrderStartSettlementRequest;
+import com.huimv.employment.service.settlement.dto.SettlementConfirmPayRequest;
 import com.huimv.employment.service.settlement.dto.SettlementSummaryResponse;
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.Parameter;
@@ -26,13 +27,13 @@ import org.springframework.web.bind.annotation.RestController;
 /**
  * 企业端用工订单 API。
  * <p>
- * 节点推进相关：确认开工（→ work_started）、发起结算（→ settlement_pending）。
- * 均需企业 JWT；订单须归属当前登录企业。
+ * 节点推进：确认开工（→ work_started）、发起结算（→ settlement_pending）、
+ * 确认并支付（→ settlement_paid）。均需企业 JWT；订单须归属当前登录企业。
  * </p>
  */
 @RestController
 @RequestMapping("/api/v1/mp/orders")
-@Tag(name = "用工订单", description = "企业确认开工、发起结算等")
+@Tag(name = "用工订单", description = "企业确认开工、发起结算、确认支付等")
 @SecurityRequirement(name = "Authorization")
 public class EmploymentOrderController {
 
@@ -78,7 +79,7 @@ public class EmploymentOrderController {
 
     @GetMapping("/{orderId}/settlement")
     @Operation(summary = "查询订单结算单",
-            description = "返回本单当前有效结算单（非 cancelled）及明细。",
+            description = "返回本单当前有效结算单（非 cancelled）及明细、支付信息。",
             parameters = {
                     @Parameter(name = "orderId", in = ParameterIn.PATH, required = true,
                             description = "fe_employment_order.id")
@@ -106,6 +107,25 @@ public class EmploymentOrderController {
         return R.ok(settlementService.startSettlement(LoginUserHolder.require().getUserId(), orderId, request));
     }
 
+    @PostMapping("/{orderId}/confirm-pay-settlement")
+    @Operation(summary = "确认结算并支付",
+            description = "企业确认结算单并完成支付（MVP Mock 即时成功）。"
+                    + "结算单 pending→paid，写入 fe_payment_record，订单 settlement_pending→settlement_paid。"
+                    + "已支付幂等返回。body.payment_channel 可选 wechat/alipay/bank，默认 wechat。",
+            parameters = {
+                    @Parameter(name = "orderId", in = ParameterIn.PATH, required = true,
+                            description = "fe_employment_order.id")
+            })
+    public R<SettlementSummaryResponse> confirmPaySettlement(
+            @PathVariable("orderId") Long orderId,
+            @RequestBody(required = false) SettlementConfirmPayRequest request) {
+        requireEnterprise();
+        if (request == null) {
+            request = new SettlementConfirmPayRequest();
+        }
+        return R.ok(settlementService.confirmAndPay(LoginUserHolder.require().getUserId(), orderId, request));
+    }
+
     /** 本 Controller 接口仅企业用户可访问。 */
     private static LoginUser requireEnterprise() {
         LoginUser loginUser = LoginUserHolder.require();

huimv-employment/fe-dao/src/main/java/com/huimv/employment/dao/entity/FePaymentRecord.java

@@ -0,0 +1,159 @@
+package com.huimv.employment.dao.entity;
+
+import com.baomidou.mybatisplus.annotation.IdType;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+/**
+ * 支付/打款记录 {@code fe_payment_record}。
+ * <p>企业确认结算并支付时创建；MVP 为 Mock 即时成功，对接真实支付后由回调更新状态。</p>
+ */
+@TableName("fe_payment_record")
+public class FePaymentRecord {
+
+    @TableId(type = IdType.AUTO)
+    private Long id;
+
+    private String paymentNo;
+
+    private Long settlementId;
+
+    private Long enterpriseId;
+
+    /** wechat / alipay / bank */
+    private String paymentChannel;
+
+    private BigDecimal paymentAmount;
+
+    /** pending / success / failed / refunded */
+    private String paymentStatus;
+
+    private String externalTradeNo;
+
+    private Long payerUserId;
+
+    private LocalDateTime paidAt;
+
+    private String receiptUrl;
+
+    private String failReason;
+
+    private LocalDateTime createTime;
+
+    private LocalDateTime updateTime;
+
+    public Long getId() {
+        return id;
+    }
+
+    public void setId(Long id) {
+        this.id = id;
+    }
+
+    public String getPaymentNo() {
+        return paymentNo;
+    }
+
+    public void setPaymentNo(String paymentNo) {
+        this.paymentNo = paymentNo;
+    }
+
+    public Long getSettlementId() {
+        return settlementId;
+    }
+
+    public void setSettlementId(Long settlementId) {
+        this.settlementId = settlementId;
+    }
+
+    public Long getEnterpriseId() {
+        return enterpriseId;
+    }
+
+    public void setEnterpriseId(Long enterpriseId) {
+        this.enterpriseId = enterpriseId;
+    }
+
+    public String getPaymentChannel() {
+        return paymentChannel;
+    }
+
+    public void setPaymentChannel(String paymentChannel) {
+        this.paymentChannel = paymentChannel;
+    }
+
+    public BigDecimal getPaymentAmount() {
+        return paymentAmount;
+    }
+
+    public void setPaymentAmount(BigDecimal paymentAmount) {
+        this.paymentAmount = paymentAmount;
+    }
+
+    public String getPaymentStatus() {
+        return paymentStatus;
+    }
+
+    public void setPaymentStatus(String paymentStatus) {
+        this.paymentStatus = paymentStatus;
+    }
+
+    public String getExternalTradeNo() {
+        return externalTradeNo;
+    }
+
+    public void setExternalTradeNo(String externalTradeNo) {
+        this.externalTradeNo = externalTradeNo;
+    }
+
+    public Long getPayerUserId() {
+        return payerUserId;
+    }
+
+    public void setPayerUserId(Long payerUserId) {
+        this.payerUserId = payerUserId;
+    }
+
+    public LocalDateTime getPaidAt() {
+        return paidAt;
+    }
+
+    public void setPaidAt(LocalDateTime paidAt) {
+        this.paidAt = paidAt;
+    }
+
+    public String getReceiptUrl() {
+        return receiptUrl;
+    }
+
+    public void setReceiptUrl(String receiptUrl) {
+        this.receiptUrl = receiptUrl;
+    }
+
+    public String getFailReason() {
+        return failReason;
+    }
+
+    public void setFailReason(String failReason) {
+        this.failReason = failReason;
+    }
+
+    public LocalDateTime getCreateTime() {
+        return createTime;
+    }
+
+    public void setCreateTime(LocalDateTime createTime) {
+        this.createTime = createTime;
+    }
+
+    public LocalDateTime getUpdateTime() {
+        return updateTime;
+    }
+
+    public void setUpdateTime(LocalDateTime updateTime) {
+        this.updateTime = updateTime;
+    }
+}

huimv-employment/fe-dao/src/main/java/com/huimv/employment/dao/mapper/FePaymentRecordMapper.java

@@ -0,0 +1,9 @@
+package com.huimv.employment.dao.mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.huimv.employment.dao.entity.FePaymentRecord;
+import org.apache.ibatis.annotations.Mapper;
+
+@Mapper
+public interface FePaymentRecordMapper extends BaseMapper<FePaymentRecord> {
+}

huimv-employment/fe-service/src/main/java/com/huimv/employment/service/settlement/SettlementService.java

@@ -7,6 +7,7 @@ import com.huimv.employment.dao.entity.FeDraftCostSnapshot;
 import com.huimv.employment.dao.entity.FeEmploymentDraft;
 import com.huimv.employment.dao.entity.FeEmploymentOrder;
 import com.huimv.employment.dao.entity.FeEnterprise;
+import com.huimv.employment.dao.entity.FePaymentRecord;
 import com.huimv.employment.dao.entity.FeServicePlan;
 import com.huimv.employment.dao.entity.FeSettlementFee;
 import com.huimv.employment.dao.entity.FeSettlementItem;
@@ -15,6 +16,7 @@ import com.huimv.employment.dao.entity.FeWorkerRegistration;
 import com.huimv.employment.dao.mapper.FeDraftCostSnapshotMapper;
 import com.huimv.employment.dao.mapper.FeEmploymentDraftMapper;
 import com.huimv.employment.dao.mapper.FeEmploymentOrderMapper;
+import com.huimv.employment.dao.mapper.FePaymentRecordMapper;
 import com.huimv.employment.dao.mapper.FeServicePlanMapper;
 import com.huimv.employment.dao.mapper.FeSettlementFeeMapper;
 import com.huimv.employment.dao.mapper.FeSettlementItemMapper;
@@ -22,6 +24,7 @@ import com.huimv.employment.dao.mapper.FeSettlementOrderMapper;
 import com.huimv.employment.dao.mapper.FeWorkerRegistrationMapper;
 import com.huimv.employment.service.enterprise.EnterpriseService;
 import com.huimv.employment.service.settlement.dto.OrderStartSettlementRequest;
+import com.huimv.employment.service.settlement.dto.SettlementConfirmPayRequest;
 import com.huimv.employment.service.settlement.dto.SettlementFeeResponse;
 import com.huimv.employment.service.settlement.dto.SettlementItemResponse;
 import com.huimv.employment.service.settlement.dto.SettlementSummaryResponse;
@@ -44,11 +47,10 @@ import java.util.concurrent.ThreadLocalRandom;
 /**
  * 结算服务（方案 A：企业主动发起）。
  * <p>
- * 流程：订单处于 {@code work_started} → 企业调用发起结算 →
- * 生成 {@code fe_settlement_order}（含按人明细、费用分项）→
- * 订单推进至 {@code settlement_pending}（待确认结算）。
+ * 流程：{@code work_started} → 发起结算 → {@code settlement_pending} →
+ * 确认并支付（Mock）→ {@code settlement_paid}。
  * </p>
- * <p>MVP 无考勤：金额按日薪×天数或方案成本快照估算；确认支付另接口处理。</p>
+ * <p>MVP 无考勤、无真实支付通道：金额按日薪/方案快照估算，支付即时成功。</p>
  */
 @Service
 public class SettlementService {
@@ -59,19 +61,37 @@ public class SettlementService {
     private static final String STEP_WORK_STARTED = "work_started";
     /** 订单步骤：待结算（发起结算成功后的目标步骤） */
     private static final String STEP_SETTLEMENT_PENDING = "settlement_pending";
+    /** 订单步骤：已支付 */
+    private static final String STEP_SETTLEMENT_PAID = "settlement_paid";
     /** 登记状态：已签完合同，可纳入结算 */
     private static final String REG_COMPLETED = "completed";
     /** 结算单状态：待企业确认 */
     private static final String STATUS_PENDING = "pending";
+    /** 结算单状态：已确认待支付 */
+    private static final String STATUS_CONFIRMED = "confirmed";
+    /** 结算单状态：支付中 */
+    private static final String STATUS_PAYING = "paying";
+    /** 结算单状态：已支付 */
+    private static final String STATUS_PAID = "paid";
     /** 结算单状态：已取消（不视为有效结算单） */
     private static final String STATUS_CANCELLED = "cancelled";
+    /** 明细状态：已支付 */
+    private static final String ITEM_STATUS_PAID = "paid";
+    /** 支付状态：成功 */
+    private static final String PAY_STATUS_SUCCESS = "success";
     /** 订单业务状态：结算中 */
     private static final String ORDER_STATUS_SETTLING = "settling";
+    /** 订单业务状态：已支付 */
+    private static final String ORDER_STATUS_PAID = "paid";
+    private static final String CHANNEL_WECHAT = "wechat";
+    private static final String CHANNEL_ALIPAY = "alipay";
+    private static final String CHANNEL_BANK = "bank";
     private static final DateTimeFormatter SETTLEMENT_NO_DAY = DateTimeFormatter.ofPattern("yyyyMMdd");
 
     private final FeSettlementOrderMapper feSettlementOrderMapper;
     private final FeSettlementItemMapper feSettlementItemMapper;
     private final FeSettlementFeeMapper feSettlementFeeMapper;
+    private final FePaymentRecordMapper fePaymentRecordMapper;
     private final FeEmploymentOrderMapper feEmploymentOrderMapper;
     private final FeEmploymentDraftMapper feEmploymentDraftMapper;
     private final FeWorkerRegistrationMapper feWorkerRegistrationMapper;
@@ -82,6 +102,7 @@ public class SettlementService {
     public SettlementService(FeSettlementOrderMapper feSettlementOrderMapper,
                              FeSettlementItemMapper feSettlementItemMapper,
                              FeSettlementFeeMapper feSettlementFeeMapper,
+                             FePaymentRecordMapper fePaymentRecordMapper,
                              FeEmploymentOrderMapper feEmploymentOrderMapper,
                              FeEmploymentDraftMapper feEmploymentDraftMapper,
                              FeWorkerRegistrationMapper feWorkerRegistrationMapper,
@@ -91,6 +112,7 @@ public class SettlementService {
         this.feSettlementOrderMapper = feSettlementOrderMapper;
         this.feSettlementItemMapper = feSettlementItemMapper;
         this.feSettlementFeeMapper = feSettlementFeeMapper;
+        this.fePaymentRecordMapper = fePaymentRecordMapper;
         this.feEmploymentOrderMapper = feEmploymentOrderMapper;
         this.feEmploymentDraftMapper = feEmploymentDraftMapper;
         this.feWorkerRegistrationMapper = feWorkerRegistrationMapper;
@@ -227,6 +249,114 @@ public class SettlementService {
         return response;
     }
 
+    /**
+     * 企业确认结算并支付（MVP 一次完成）。
+     * <ul>
+     *   <li>结算单 {@code pending → paid}，明细同步 paid</li>
+     *   <li>写入 {@code fe_payment_record}（Mock 即时 success）</li>
+     *   <li>订单 {@code settlement_pending → settlement_paid}</li>
+     *   <li>幂等：已支付则返回现有结算/支付信息</li>
+     * </ul>
+     */
+    @Transactional(rollbackFor = Exception.class)
+    public SettlementSummaryResponse confirmAndPay(Long userId, Long orderId, SettlementConfirmPayRequest request) {
+        FeEmploymentOrder order = requireOwnedOrder(userId, orderId);
+        FeSettlementOrder settlement = findActiveByOrderId(orderId);
+        if (settlement == null) {
+            throw new BizException(ErrorCode.BAD_REQUEST, "尚未发起结算，请先调用发起结算");
+        }
+
+        // 幂等：已支付
+        if (STATUS_PAID.equals(settlement.getSettlementStatus())) {
+            ensureOrderAtSettlementPaid(order, LocalDateTime.now());
+            return toSummary(order, settlement, false, "结算已支付");
+        }
+
+        String step = order.getCurrentStepCode();
+        if (STEP_SETTLEMENT_PAID.equals(step) || isStepAfter(step, STEP_SETTLEMENT_PAID)) {
+            ensureOrderAtSettlementPaid(order, LocalDateTime.now());
+            return toSummary(order, settlement, false, "订单已进入已支付阶段");
+        }
+        if (!STEP_SETTLEMENT_PENDING.equals(step)) {
+            throw new BizException(ErrorCode.BAD_REQUEST,
+                    "仅待结算阶段可确认支付，当前步骤：" + (step == null ? "未知" : step));
+        }
+        if (!STATUS_PENDING.equals(settlement.getSettlementStatus())
+                && !STATUS_CONFIRMED.equals(settlement.getSettlementStatus())
+                && !STATUS_PAYING.equals(settlement.getSettlementStatus())) {
+            throw new BizException(ErrorCode.BAD_REQUEST,
+                    "当前结算单状态不可支付：" + settlement.getSettlementStatus());
+        }
+
+        String channel = resolvePaymentChannel(request != null ? request.getPaymentChannel() : null);
+        LocalDateTime now = LocalDateTime.now();
+        BigDecimal payAmount = settlement.getTotalOutflow() != null
+                ? settlement.getTotalOutflow()
+                : (settlement.getNetAmount() != null ? settlement.getNetAmount() : BigDecimal.ZERO);
+
+        // 1) 结算单确认并置为已支付（MVP 跳过真实渠道回调）
+        FeSettlementOrder settlementUpdate = new FeSettlementOrder();
+        settlementUpdate.setId(settlement.getId());
+        settlementUpdate.setSettlementStatus(STATUS_PAID);
+        settlementUpdate.setConfirmedAt(settlement.getConfirmedAt() != null ? settlement.getConfirmedAt() : now);
+        settlementUpdate.setConfirmedBy(userId);
+        settlementUpdate.setPaidAt(now);
+        settlementUpdate.setComplianceTags("[\"合同已签署\",\"结算已确认\",\"支付已完成\"]");
+        settlementUpdate.setComplianceRemark("MVP Mock 支付成功，后续可对接真实支付通道");
+        settlementUpdate.setUpdateTime(now);
+        feSettlementOrderMapper.updateById(settlementUpdate);
+        settlement.setSettlementStatus(STATUS_PAID);
+        settlement.setConfirmedAt(settlementUpdate.getConfirmedAt());
+        settlement.setConfirmedBy(userId);
+        settlement.setPaidAt(now);
+
+        // 2) 明细全部标记已支付
+        List<FeSettlementItem> items = feSettlementItemMapper.selectList(
+                new LambdaQueryWrapper<FeSettlementItem>()
+                        .eq(FeSettlementItem::getSettlementId, settlement.getId()));
+        if (items != null) {
+            for (FeSettlementItem item : items) {
+                FeSettlementItem itemUpdate = new FeSettlementItem();
+                itemUpdate.setId(item.getId());
+                itemUpdate.setItemStatus(ITEM_STATUS_PAID);
+                itemUpdate.setUpdateTime(now);
+                feSettlementItemMapper.updateById(itemUpdate);
+            }
+        }
+
+        // 3) 支付记录（Mock 即时成功；已有成功记录则复用）
+        FePaymentRecord payment = findSuccessPayment(settlement.getId());
+        if (payment == null) {
+            payment = new FePaymentRecord();
+            payment.setPaymentNo(nextPaymentNo());
+            payment.setSettlementId(settlement.getId());
+            payment.setEnterpriseId(order.getEnterpriseId());
+            payment.setPaymentChannel(channel);
+            payment.setPaymentAmount(payAmount);
+            payment.setPaymentStatus(PAY_STATUS_SUCCESS);
+            payment.setExternalTradeNo("MOCK-" + payment.getPaymentNo());
+            payment.setPayerUserId(userId);
+            payment.setPaidAt(now);
+            payment.setCreateTime(now);
+            payment.setUpdateTime(now);
+            fePaymentRecordMapper.insert(payment);
+        }
+
+        // 4) 订单推进至已支付
+        FeEmploymentOrder orderUpdate = new FeEmploymentOrder();
+        orderUpdate.setId(order.getId());
+        orderUpdate.setCurrentStepCode(STEP_SETTLEMENT_PAID);
+        orderUpdate.setOrderStatus(ORDER_STATUS_PAID);
+        orderUpdate.setUpdateTime(now);
+        feEmploymentOrderMapper.updateById(orderUpdate);
+        order.setCurrentStepCode(STEP_SETTLEMENT_PAID);
+        order.setOrderStatus(ORDER_STATUS_PAID);
+
+        log.info("结算确认支付成功 orderId={} settlementId={} paymentNo={} channel={} amount={}",
+                orderId, settlement.getId(), payment.getPaymentNo(), channel, payAmount);
+        return toSummary(order, settlement, false, "结算已确认并支付成功");
+    }
+
     /**
      * 幂等路径：结算单已存在但订单步骤未跟上时，校正到 settlement_pending。
      */
@@ -245,6 +375,22 @@ public class SettlementService {
         order.setOrderStatus(ORDER_STATUS_SETTLING);
     }
 
+    /** 幂等路径：已支付但订单步骤未跟上时，校正到 settlement_paid。 */
+    private void ensureOrderAtSettlementPaid(FeEmploymentOrder order, LocalDateTime now) {
+        if (STEP_SETTLEMENT_PAID.equals(order.getCurrentStepCode())
+                || isStepAfter(order.getCurrentStepCode(), STEP_SETTLEMENT_PAID)) {
+            return;
+        }
+        FeEmploymentOrder update = new FeEmploymentOrder();
+        update.setId(order.getId());
+        update.setCurrentStepCode(STEP_SETTLEMENT_PAID);
+        update.setOrderStatus(ORDER_STATUS_PAID);
+        update.setUpdateTime(now);
+        feEmploymentOrderMapper.updateById(update);
+        order.setCurrentStepCode(STEP_SETTLEMENT_PAID);
+        order.setOrderStatus(ORDER_STATUS_PAID);
+    }
+
     /** 本单最新一条非 cancelled 结算单。 */
     private FeSettlementOrder findActiveByOrderId(Long orderId) {
         return feSettlementOrderMapper.selectOne(new LambdaQueryWrapper<FeSettlementOrder>()
@@ -392,6 +538,18 @@ public class SettlementService {
         response.setCreated(created);
         response.setMessage(message);
         response.setCreateTime(settlement.getCreateTime());
+        response.setConfirmedAt(settlement.getConfirmedAt());
+        response.setPaidAt(settlement.getPaidAt());
+
+        FePaymentRecord payment = findLatestPayment(settlement.getId());
+        if (payment != null) {
+            response.setPaymentId(payment.getId());
+            response.setPaymentNo(payment.getPaymentNo());
+            response.setPaymentChannel(payment.getPaymentChannel());
+            response.setPaymentStatus(payment.getPaymentStatus());
+            response.setPaymentAmount(payment.getPaymentAmount());
+            response.setExternalTradeNo(payment.getExternalTradeNo());
+        }
 
         List<FeSettlementItem> items = feSettlementItemMapper.selectList(
                 new LambdaQueryWrapper<FeSettlementItem>()
@@ -484,6 +642,40 @@ public class SettlementService {
         return "STL" + day + rand;
     }
 
+    /** 支付单号：PAY + yyyyMMdd + 4 位随机数。 */
+    private String nextPaymentNo() {
+        String day = LocalDateTime.now().format(SETTLEMENT_NO_DAY);
+        int rand = ThreadLocalRandom.current().nextInt(1000, 10000);
+        return "PAY" + day + rand;
+    }
+
+    /** 解析并校验支付渠道，非法则默认 wechat。 */
+    private static String resolvePaymentChannel(String raw) {
+        if (!StringUtils.hasText(raw)) {
+            return CHANNEL_WECHAT;
+        }
+        String channel = raw.trim().toLowerCase();
+        if (CHANNEL_WECHAT.equals(channel) || CHANNEL_ALIPAY.equals(channel) || CHANNEL_BANK.equals(channel)) {
+            return channel;
+        }
+        throw new BizException(ErrorCode.BAD_REQUEST, "不支持的支付渠道：" + raw + "，可选 wechat/alipay/bank");
+    }
+
+    private FePaymentRecord findSuccessPayment(Long settlementId) {
+        return fePaymentRecordMapper.selectOne(new LambdaQueryWrapper<FePaymentRecord>()
+                .eq(FePaymentRecord::getSettlementId, settlementId)
+                .eq(FePaymentRecord::getPaymentStatus, PAY_STATUS_SUCCESS)
+                .orderByDesc(FePaymentRecord::getId)
+                .last("LIMIT 1"));
+    }
+
+    private FePaymentRecord findLatestPayment(Long settlementId) {
+        return fePaymentRecordMapper.selectOne(new LambdaQueryWrapper<FePaymentRecord>()
+                .eq(FePaymentRecord::getSettlementId, settlementId)
+                .orderByDesc(FePaymentRecord::getId)
+                .last("LIMIT 1"));
+    }
+
     /** 判断 current 是否在合规流程中严格位于 target 之后。 */
     private static boolean isStepAfter(String current, String target) {
         if (!StringUtils.hasText(current) || !StringUtils.hasText(target)) {

huimv-employment/fe-service/src/main/java/com/huimv/employment/service/settlement/dto/SettlementConfirmPayRequest.java

@@ -0,0 +1,27 @@
+package com.huimv.employment.service.settlement.dto;
+
+import com.fasterxml.jackson.annotation.JsonAlias;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+
+/**
+ * 企业确认结算并支付请求体。
+ * <p>MVP 一次完成：确认结算单 + Mock 支付成功 → 订单 {@code settlement_paid}。</p>
+ */
+@Schema(description = "企业确认结算并支付请求")
+public class SettlementConfirmPayRequest {
+
+    /** wechat / alipay / bank，默认 wechat */
+    @JsonProperty("payment_channel")
+    @JsonAlias({"paymentChannel", "channel"})
+    @Schema(description = "支付渠道：wechat / alipay / bank", example = "wechat")
+    private String paymentChannel;
+
+    public String getPaymentChannel() {
+        return paymentChannel;
+    }
+
+    public void setPaymentChannel(String paymentChannel) {
+        this.paymentChannel = paymentChannel;
+    }
+}

huimv-employment/fe-service/src/main/java/com/huimv/employment/service/settlement/dto/SettlementSummaryResponse.java

@@ -68,6 +68,30 @@ public class SettlementSummaryResponse {
     @JsonProperty("create_time")
     private LocalDateTime createTime;
 
+    @JsonProperty("confirmed_at")
+    private LocalDateTime confirmedAt;
+
+    @JsonProperty("paid_at")
+    private LocalDateTime paidAt;
+
+    @JsonProperty("payment_id")
+    private Long paymentId;
+
+    @JsonProperty("payment_no")
+    private String paymentNo;
+
+    @JsonProperty("payment_channel")
+    private String paymentChannel;
+
+    @JsonProperty("payment_status")
+    private String paymentStatus;
+
+    @JsonProperty("payment_amount")
+    private BigDecimal paymentAmount;
+
+    @JsonProperty("external_trade_no")
+    private String externalTradeNo;
+
     private List<SettlementItemResponse> items = new ArrayList<>();
 
     private List<SettlementFeeResponse> fees = new ArrayList<>();
@@ -224,6 +248,70 @@ public class SettlementSummaryResponse {
         this.createTime = createTime;
     }
 
+    public LocalDateTime getConfirmedAt() {
+        return confirmedAt;
+    }
+
+    public void setConfirmedAt(LocalDateTime confirmedAt) {
+        this.confirmedAt = confirmedAt;
+    }
+
+    public LocalDateTime getPaidAt() {
+        return paidAt;
+    }
+
+    public void setPaidAt(LocalDateTime paidAt) {
+        this.paidAt = paidAt;
+    }
+
+    public Long getPaymentId() {
+        return paymentId;
+    }
+
+    public void setPaymentId(Long paymentId) {
+        this.paymentId = paymentId;
+    }
+
+    public String getPaymentNo() {
+        return paymentNo;
+    }
+
+    public void setPaymentNo(String paymentNo) {
+        this.paymentNo = paymentNo;
+    }
+
+    public String getPaymentChannel() {
+        return paymentChannel;
+    }
+
+    public void setPaymentChannel(String paymentChannel) {
+        this.paymentChannel = paymentChannel;
+    }
+
+    public String getPaymentStatus() {
+        return paymentStatus;
+    }
+
+    public void setPaymentStatus(String paymentStatus) {
+        this.paymentStatus = paymentStatus;
+    }
+
+    public BigDecimal getPaymentAmount() {
+        return paymentAmount;
+    }
+
+    public void setPaymentAmount(BigDecimal paymentAmount) {
+        this.paymentAmount = paymentAmount;
+    }
+
+    public String getExternalTradeNo() {
+        return externalTradeNo;
+    }
+
+    public void setExternalTradeNo(String externalTradeNo) {
+        this.externalTradeNo = externalTradeNo;
+    }
+
     public List<SettlementItemResponse> getItems() {
         return items;
     }