应收账单功能实现

bms-back/ruoyi-system/src/main/java/com/ruoyi/price/domain/PrcOrderBill.java

@@ -71,6 +71,8 @@ public class PrcOrderBill extends BaseEntity
     /** payable total */
     private BigDecimal payTotal;
     private String currency;
+    /** 应收账单占用状态：UNBILLED/BILLED。 */
+    private String arBillStatus;
     private String roundMode;
 
     private List<PrcIncomeBillFee> incomeFees;

bms-back/ruoyi-system/src/main/java/com/ruoyi/price/mapper/PrcIncomeBillFeeMapper.java

@@ -9,6 +9,8 @@ public interface PrcIncomeBillFeeMapper
 {
     public List<PrcIncomeBillFee> selectByBillId(String billId);
 
+    public List<PrcIncomeBillFee> selectByBillIds(@Param("billIds") List<String> billIds);
+
     public int insertPrcIncomeBillFee(PrcIncomeBillFee fee);
 
     public int insertBatch(@Param("list") List<PrcIncomeBillFee> fees);

bms-back/ruoyi-system/src/main/java/com/ruoyi/price/mapper/PrcOrderBillMapper.java

@@ -1,6 +1,7 @@
 package com.ruoyi.price.mapper;
 
 import java.math.BigDecimal;
+import java.util.Date;
 import java.util.List;
 import org.apache.ibatis.annotations.Param;
 import com.ruoyi.price.domain.PrcOrderBill;
@@ -14,6 +15,25 @@ public interface PrcOrderBillMapper
 
     public List<PrcOrderBill> selectPrcOrderBillList(PrcOrderBill bill);
 
+    /** 应收账单生成读取指定客户截止日期前的未出账订单计费快照。 */
+    public List<PrcOrderBill> selectPrcOrderBillByCustomerPeriod(@Param("customerId") Long customerId,
+        @Param("customerCode") String customerCode, @Param("cutoffDate") Date cutoffDate,
+        @Param("currency") String currency, @Param("arBillStatus") String arBillStatus);
+
+    /** 按生成账单时用户勾选的订单读取，并再次校验账单筛选条件。 */
+    public List<PrcOrderBill> selectPrcOrderBillByCustomerCutoffAndIds(@Param("customerId") Long customerId,
+        @Param("customerCode") String customerCode, @Param("cutoffDate") Date cutoffDate,
+        @Param("currency") String currency, @Param("billIds") List<String> billIds,
+        @Param("arBillStatus") String arBillStatus);
+
+    /** 原子占用订单，防止同一订单被并发生成到多张应收账单。 */
+    public int claimArBillOrders(@Param("billIds") List<String> billIds, @Param("operator") String operator,
+        @Param("fromStatus") String fromStatus, @Param("toStatus") String toStatus);
+
+    /** 作废账单后释放订单，允许后续重新生成新版本账单。 */
+    public int releaseArBillOrders(@Param("billIds") List<String> billIds, @Param("operator") String operator,
+        @Param("fromStatus") String fromStatus, @Param("toStatus") String toStatus);
+
     public int insertPrcOrderBill(PrcOrderBill bill);
 
     public int updatePrcOrderBill(PrcOrderBill bill);