feat:合同,合同标的物,收款实体

cuida

8 天以前 fd60f7ce6025c761e2836ffcbbb70894aee946fa

feat:合同,合同标的物,收款实体

 platformx-boot/src/main/resources/application-dev.yml

@@ -2,6 +2,7 @@
  data:
    redis:
      host: 127.0.0.1
      password: 123456
      database: 0
  # 数据库相关配置
  datasource:

 platformx-business-finance-api/src/main/java/com/by4cloud/platformx/business/entity/Contract.java

New file
@@ -0,0 +1,124 @@
package com.by4cloud.platformx.business.entity;

import com.baomidou.mybatisplus.annotation.TableField;
import com.by4cloud.platformx.common.data.mybatis.BaseModel;
import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.persistence.Column;
import jakarta.persistence.Entity;
import lombok.Data;
import org.hibernate.annotations.Table;

import javax.persistence.Transient;
import java.math.BigDecimal;

import org.springframework.format.annotation.DateTimeFormat;
import com.fasterxml.jackson.annotation.JsonFormat;

/**
 * @author cd
 * @description
 * @date 2026/4/29 10:51
 **/
@Data
@Entity
@Table(appliesTo = "contract", comment = "合同管理")
public class Contract extends BaseModel<Contract> {


    @Schema(description = "合同编号")
    @Column(columnDefinition = "VARCHAR(64) comment '合同编号'")
    private String contractNo;

    @Schema(description = "合同名称")
    @Column(columnDefinition = "VARCHAR(200) comment '合同名称'")
    private String contractName;

    @Schema(description = "甲方id")
    @Column(columnDefinition = "bigint comment '甲方id'")
    private Long partyAId;

    @Schema(description = "甲方名称")
    @Column(columnDefinition = "VARCHAR(100) comment '甲方名称'")
    private String partyA;

    @Schema(description = "乙方id")
    @Column(columnDefinition = "VARCHAR(100) comment '乙方id'")
    private String partyBId;

    @Schema(description = "乙方名称")
    @Column(columnDefinition = "VARCHAR(100) comment '乙方名称'")
    private String partyB;

    @Schema(description = "合同金额")
    @Column(columnDefinition = "double comment '合同金额'")
    private Double amount;

    @Schema(description = "币种（CNY/USD等）")
    @Column(columnDefinition = "VARCHAR(10) default 'CNY' comment '币种'")
    private String currency;

    @Schema(description = "合同类型（0-生成式 1-备案式）")
    @Column(columnDefinition = "tinyint(2) default 0 comment '合同类型'")
    private Integer contractType;

    @Schema(description = "合同状态（0-草稿 1-已生效 2-已终止 3-已过期）")
    @Column(columnDefinition = "tinyint(2) default 0 comment '合同状态'")
    private Integer contractStatus;

    @Schema(description = "合同服务属性（0-产品销售 1-无形服务）")
    @Column(columnDefinition = "tinyint(2) default 0 comment '合同服务属性'")
    private Integer contractAttribute;

    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm")
    @Schema(description = "签署日期")
    @Column(columnDefinition = "VARCHAR(64) comment '签署日期'")
    private String signDate;

    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm")
    @Schema(description = "生效日期")
    @Column(columnDefinition = "VARCHAR(64) comment '生效日期'")
    private String effectiveDate;

    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm")
    @Schema(description = "到期日期")
    @Column(columnDefinition = "VARCHAR(64) comment '到期日期'")
    private String expirationDate;

    @Schema(description = "合同附件URL")
    @Column(columnDefinition = "VARCHAR(500) comment '合同附件URL'")
    private String attachmentUrl;

    @Schema(description = "备注")
    @Column(columnDefinition = "TEXT comment '备注'")
    private String remark;

    @Schema(description = "关联父合同id（用于合同变更时指向原合同）")
    @Column(columnDefinition = "bigint comment '关联父合同id'")
    private Long parentId;


    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm")
    @Schema(description = "审批时间")
    @Column(columnDefinition = "datetime comment '审批时间'")
    private String approveTime;

    /**
     * 临时字段 - 用于接收审批人名称等关联查询结果
     */
    @Transient
    @TableField(exist = false)
    @Schema(description = "审批人姓名（临时字段）")
    private String approverName;

    /**
     * 临时字段 - 合同剩余天数
     */
    @Transient
    @TableField(exist = false)
    @Schema(description = "合同剩余天数（临时字段）")
    private Long remainingDays;
}

 platformx-business-finance-api/src/main/java/com/by4cloud/platformx/business/entity/ContractPaymentSchedule.java

New file
@@ -0,0 +1,165 @@
package com.by4cloud.platformx.business.entity;

import com.baomidou.mybatisplus.annotation.TableField;
import com.by4cloud.platformx.common.data.mybatis.BaseModel;
import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.persistence.Column;
import jakarta.persistence.Entity;
import jakarta.persistence.Transient;
import lombok.Data;
import org.hibernate.annotations.Table;
import org.springframework.format.annotation.DateTimeFormat;

import java.math.BigDecimal;
import java.util.Date;

/**
 * 合同收款计划/履约节点实体类
 * 统一管理合同的收款阶段、履约节点、收款比例及履约时间节点
 *
 * @author xfei
 * @date 2024-01-15
 */
@Data
@Entity
@Table(appliesTo = "contract_payment_schedule", comment = "合同收款计划/履约节点表")
public class ContractPaymentSchedule extends BaseModel<ContractPaymentSchedule> {

    // ==================== 关联信息 ====================

    @Schema(description = "关联合同ID")
    @Column(columnDefinition = "bigint not null comment '关联合同ID'")
    private Long contractId;

    @Schema(description = "合同名称")
    @Column(columnDefinition = "VARCHAR(64) comment '合同名称'")
    private String contractName;

    @Schema(description = "关联标的物ID（可选，如果为空则适用于合同整体）")
    @Column(columnDefinition = "bigint comment '关联标的物ID'")
    private Long subjectMatterId;

    @Schema(description = "标的物名称")
    @Column(columnDefinition = "VARCHAR(64) comment '标的物名称'")
    private String subjectMatterName;

    // ==================== 收款阶段/履约节点基本信息 ====================

//    @Schema(description = "收款阶段/节点编码（如：STAGE_001）")
//    @Column(columnDefinition = "VARCHAR(64) comment '收款阶段/节点编码'")
//    private String stageCode;

    @Schema(description = "收款阶段名称（显性要素，如：合同签订预付、发货前付款、货到签收付款、调试完成付款、质保金）")
    @Column(columnDefinition = "VARCHAR(100) not null comment '收款阶段名称'")
    private String stageName;

//    @Schema(description = "节点类型（0-标准预定义节点 1-自定义节点）")
//    @Column(columnDefinition = "tinyint(1) default 0 comment '节点类型'")
//    private Integer nodeType;

//    @Schema(description = "履约节点编码（与收款阶段关联的履约节点，如：SIGN、PRE_DELIVERY、DELIVERY_RECEIPT、COMMISSIONING、WARRANTY）")
//    @Column(columnDefinition = "VARCHAR(50) comment '履约节点编码'")
//    private String fulfillmentNodeCode;

//    @Schema(description = "履约节点名称")
//    @Column(columnDefinition = "VARCHAR(100) comment '履约节点名称'")
//    private String fulfillmentNodeName;

    // ==================== 收款比例/金额 ====================

    @Schema(description = "收款比例（%，如30表示30%）（显性要素）")
    @Column(columnDefinition = "double comment '收款比例（%）'")
    private Double paymentRatio;

    @Schema(description = "计划收款金额（根据合同总金额*比例自动计算）")
    @Column(columnDefinition = "double comment '计划收款金额'")
    private Double plannedAmount;

    @Schema(description = "实际收款金额")
    @Column(columnDefinition = "double default 0.00 comment '实际收款金额'")
    private Double actualAmount;

    // ==================== 时序控制 ====================

    @Schema(description = "阶段顺序（第几期）")
    @Column(columnDefinition = "int not null comment '阶段顺序'")
    private Integer stageOrder;

    @Schema(description = "计划收款日期（基于合同签订日期+约定天数计算）")
    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm")
    @Column(columnDefinition = "VARCHAR(64) comment '计划收款日期'")
    private String plannedPaymentDate;

    @Schema(description = "收款阶段生效日期（隐性要素 - 履约时间起点，即该节点实际达成的日期）")
    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm")
    @Column(columnDefinition = "VARCHAR(64) comment '收款阶段生效日期（履约节点实际达成日期）'")
    private String effectiveDate;

    @Schema(description = "约定天数（合同签订后X天内付款/货到后X天内付款等）")
    @Column(columnDefinition = "int default 0 comment '约定天数'")
    private Integer agreedDays;

    @Schema(description = "天数计算基准（0-合同签订日 1-上一节点生效日 2-货到日 3-验收日）")
    @Column(columnDefinition = "tinyint(1) default 0 comment '天数计算基准'")
    private Integer calculationBasis;

    // ==================== 状态控制 ====================

    @Schema(description = "履约节点状态（0-未开始 1-进行中 2-已达成 3-已逾期）")
    @Column(columnDefinition = "tinyint(1) default 0 comment '履约节点状态'")
    private Integer fulfillmentStatus;

    @Schema(description = "收款状态（0-未收款 1-部分收款 2-已收款 3-逾期）")
    @Column(columnDefinition = "tinyint(1) default 0 comment '收款状态'")
    private Integer paymentStatus;

//    @Schema(description = "是否自动触发（0-手动录入节点时间 1-系统自动获取节点时间）")
//    @Column(columnDefinition = "tinyint(1) default 0 comment '是否自动触发'")
//    private Integer isAutoTrigger;

    // ==================== 关联单据（用于系统自动获取节点时间） ====================

//    @Schema(description = "关联单据类型（0-无 1-调试单 2-验收单 3-发货单 4-签收单）")
//    @Column(columnDefinition = "tinyint(2) comment '关联单据类型'")
//    private Integer relatedDocType;
//
//    @Schema(description = "关联单据ID（如调试单ID、验收单ID等）")
//    @Column(columnDefinition = "bigint comment '关联单据ID'")
//    private Long relatedDocId;
//
//    @Schema(description = "关联单据编号")
//    @Column(columnDefinition = "VARCHAR(64) comment '关联单据编号'")
//    private String relatedDocNo;

    // ==================== 发票关联 ====================

//    @Schema(description = "关联发票ID")
//    @Column(columnDefinition = "bigint comment '关联发票ID'")
//    private Long invoiceId;
//
//    @Schema(description = "是否已开票（0-未开票 1-已开票）")
//    @Column(columnDefinition = "tinyint(1) default 0 comment '是否已开票'")
//    private Integer isInvoiced;

    // ==================== 业务扩展 ====================

    @Schema(description = "备注")
    @Column(columnDefinition = "VARCHAR(500) comment '备注'")
    private String remark;

//    @Schema(description = "排序号")
//    @Column(columnDefinition = "int default 0 comment '排序号'")
//    private Integer sortOrder;

    // ==================== 临时字段（用于查询展示） ====================



//    @Transient
//    @TableField(exist = false)
//    @Schema(description = "逾期天数（临时字段）")
//    private Long overdueDays;
}

 platformx-business-finance-api/src/main/java/com/by4cloud/platformx/business/entity/ContractSubjectMatter.java

New file
@@ -0,0 +1,141 @@
package com.by4cloud.platformx.business.entity;

import com.baomidou.mybatisplus.annotation.TableField;
import com.by4cloud.platformx.common.data.mybatis.BaseModel;
import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.persistence.Column;
import jakarta.persistence.Entity;
import jakarta.persistence.Transient;
import lombok.Data;
import org.hibernate.annotations.Table;
import org.springframework.format.annotation.DateTimeFormat;

import java.math.BigDecimal;
import java.util.Date;

/**
 * 合同标的物明细实体类
 * @author xfei
 * @date 2024-01-15
 */
@Data
@Entity
@Table(appliesTo = "contract_subject_matter", comment = "合同标的物明细表")
public class ContractSubjectMatter extends BaseModel<ContractSubjectMatter> {

    @Schema(description = "关联合同ID")
    @Column(columnDefinition = "bigint comment '关联合同ID'")
    private Long contractId;

    @Schema(description = "合同名称")
    @Column(columnDefinition = "VARCHAR(200) comment '合同名称'")
    private String contractName;

    @Schema(description = "标的物名称")
    @Column(columnDefinition = "VARCHAR(200) comment '标的物名称'")
    private String materialName;

    @Schema(description = "标的物编码（内部唯一编码）")
    @Column(columnDefinition = "VARCHAR(64) comment '标的物编码'")
    private String materialCode;

    @Schema(description = "标的物编码（内部唯一名称）")
    @Column(columnDefinition = "VARCHAR(64) comment '标的物名称(内部)'")
    private String materialInternalName;

    @Schema(description = "标的物规格/型号")
    @Column(columnDefinition = "VARCHAR(200) comment '标的物规格/型号'")
    private String specification;

    @Schema(description = "标的物品牌")
    @Column(columnDefinition = "VARCHAR(100) comment '标的物品牌'")
    private String brand;

    @Schema(description = "标的物分类（0-产品 1-服务）")
    @Column(columnDefinition = "tinyint(2) default 0 comment '标的物分类'")
    private Integer category;

    @Schema(description = "数量")
    @Column(columnDefinition = "double comment '数量'")
    private Double quantity;

    @Schema(description = "计量单位（个/台/吨/项/套等）")
    @Column(columnDefinition = "VARCHAR(20) comment '计量单位'")
    private String unit;

    @Schema(description = "单价")
    @Column(columnDefinition = "double comment '单价'")
    private Double unitPrice;

    @Schema(description = "税率（百分比，如13表示13%）")
    @Column(columnDefinition = "double default 0.00 comment '税率'")
    private Double taxRate;

    @Schema(description = "税额")
    @Column(columnDefinition = "double default 0.00 comment '税额'")
    private Double taxAmount;

    @Schema(description = "含税总价")
    @Column(columnDefinition = "double comment '含税总价'")
    private Double totalAmount;

    @Schema(description = "不含税总价")
    @Column(columnDefinition = "double comment '不含税总价'")
    private Double totalAmountExcludingTax;

    @Schema(description = "交货/交付地点")
    @Column(columnDefinition = "VARCHAR(500) comment '交货/交付地点'")
    private String deliveryPlace;

    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm")
    @Schema(description = "计划交付日期")
    @Column(columnDefinition = "datetime comment '计划交付日期'")
    private Date plannedDeliveryDate;

    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm")
    @Schema(description = "实际交付日期")
    @Column(columnDefinition = "datetime comment '实际交付日期'")
    private Date actualDeliveryDate;

    @Schema(description = "交付状态（0-未交付 1-部分交付 2-已交付 3-逾期）")
    @Column(columnDefinition = "tinyint(2) default 0 comment '交付状态'")
    private Integer deliveryStatus;

    @Schema(description = "质保期（月）")
    @Column(columnDefinition = "int default 12 comment '质保期（月）'")
    private Integer warrantyPeriod;

    @Schema(description = "标的物描述/备注")
    @Column(columnDefinition = "TEXT comment '标的物描述/备注'")
    private String description;

    @Schema(description = "附件URL（产品说明书、技术文档等）")
    @Column(columnDefinition = "VARCHAR(500) comment '附件URL'")
    private String attachmentUrl;

    @Schema(description = "排序号")
    @Column(columnDefinition = "int default 0 comment '排序号'")
    private Integer sortOrder;

    @Schema(description = "是否验收通过（0-未验收 1-已验收）")
    @Column(columnDefinition = "tinyint(1) default 0 comment '是否验收通过'")
    private Integer isAccepted;

    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm")
    @Schema(description = "验收时间")
    @Column(columnDefinition = "datetime comment '验收时间'")
    private Date acceptTime;


    /**
     * 临时字段 - 已交付数量（用于交付进度统计）
     */
    @Transient
    @TableField(exist = false)
    @Schema(description = "已交付数量（临时字段）")
    private BigDecimal deliveredQuantity;
}

 platformx-business-finance-biz/src/main/java/com/by4cloud/platformx/business/controller/ContractController.java

New file
@@ -0,0 +1,24 @@
package com.by4cloud.platformx.business.controller;

import com.by4cloud.platformx.business.service.ContractService;
import io.swagger.v3.oas.annotations.security.SecurityRequirement;
import io.swagger.v3.oas.annotations.tags.Tag;
import lombok.RequiredArgsConstructor;
import org.springframework.http.HttpHeaders;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

/**
 * @author cd
 * @description
 * @date 2026/4/29 14:05
 **/
@RestController
@RequiredArgsConstructor
@RequestMapping("/contract" )
@Tag(description = "contract" , name = "合同表管理" )
@SecurityRequirement(name = HttpHeaders.AUTHORIZATION)
public class ContractController {

    private final ContractService contractService;
}

 platformx-business-finance-biz/src/main/java/com/by4cloud/platformx/business/mapper/ContractMapper.java

New file
@@ -0,0 +1,12 @@
package com.by4cloud.platformx.business.mapper;

import com.by4cloud.platformx.business.entity.Contract;
import com.by4cloud.platformx.common.data.datascope.PlatformxBaseMapper;
import org.apache.ibatis.annotations.Mapper;

/**
 * @author 28254
 */
@Mapper
public interface ContractMapper extends PlatformxBaseMapper<Contract> {
}

 platformx-business-finance-biz/src/main/java/com/by4cloud/platformx/business/service/ContractService.java

New file
@@ -0,0 +1,12 @@
package com.by4cloud.platformx.business.service;


import com.by4cloud.platformx.business.entity.Contract;
import com.by4cloud.platformx.common.data.mybatis.IIService;

/**
 * @author 28254
 */
public interface ContractService extends IIService<Contract> {

}

 platformx-business-finance-biz/src/main/java/com/by4cloud/platformx/business/service/impl/ContractServiceImpl.java

New file
@@ -0,0 +1,17 @@
package com.by4cloud.platformx.business.service.impl;

import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.by4cloud.platformx.business.entity.Contract;
import com.by4cloud.platformx.business.mapper.ContractMapper;
import com.by4cloud.platformx.business.service.ContractService;
import org.springframework.stereotype.Service;

/**
 * @author cd
 * @description
 * @date 2026/4/29 14:07
 **/
@Service
public class ContractServiceImpl extends ServiceImpl<ContractMapper, Contract> implements ContractService {

}

 platformx-business-finance-biz/src/main/resources/mapper/ContractMapper.xml

New file
@@ -0,0 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">

<mapper namespace="com.by4cloud.platformx.business.mapper.ContractMapper">

</mapper>