From a4b6f79f968ee4740064252246d40ce8e85b2d08 Mon Sep 17 00:00:00 2001 From: luotaiqian <1147642922@qq.com> Date: Wed, 1 Jul 2026 11:53:31 +0800 Subject: [PATCH] @ApiModelProperty --- .../safetyeval/client/co/QualFilingCO.java | 66 ++++++++++--------- .../client/co/QualFilingCommitmentCO.java | 18 ++--- .../co/QualFilingComplianceCheckResultCO.java | 7 +- .../client/co/QualFilingDetailCO.java | 5 ++ .../client/co/QualFilingEquipmentCO.java | 42 ++++++------ .../client/co/QualFilingMaterialCO.java | 27 ++++---- .../client/co/QualFilingPersonnelCO.java | 56 ++++++++-------- .../safetyeval/client/dto/PageResponse.java | 3 +- .../safetyeval/client/dto/SingleResponse.java | 8 +++ 9 files changed, 128 insertions(+), 104 deletions(-) diff --git a/safety-eval-client/src/main/java/org/qinan/safetyeval/client/co/QualFilingCO.java b/safety-eval-client/src/main/java/org/qinan/safetyeval/client/co/QualFilingCO.java index cff2907..df87cd7 100644 --- a/safety-eval-client/src/main/java/org/qinan/safetyeval/client/co/QualFilingCO.java +++ b/safety-eval-client/src/main/java/org/qinan/safetyeval/client/co/QualFilingCO.java @@ -1,6 +1,8 @@ package org.qinan.safetyeval.client.co; import java.math.BigDecimal; + +import io.swagger.annotations.ApiModelProperty; import lombok.Data; /** @@ -11,99 +13,99 @@ import lombok.Data; @Data public class QualFilingCO { - /** 主键ID */ + @ApiModelProperty(value = "主键ID") private Long id; - /** filingTerritoryCode */ + @ApiModelProperty(value = "备案地区编码") private String filingTerritoryCode; - /** filingTerritoryName */ + @ApiModelProperty(value = "备案地区名称") private String filingTerritoryName; - /** filingUnitName */ + @ApiModelProperty(value = "备案单位名称") private String filingUnitName; - /** filingUnitTypeCode */ + @ApiModelProperty(value = "备案单位类型编码") private String filingUnitTypeCode; - /** filingUnitTypeName */ + @ApiModelProperty(value = "备案单位类型名称") private String filingUnitTypeName; - /** filingNo */ + @ApiModelProperty(value = "备案编号") private String filingNo; - /** businessScope */ + @ApiModelProperty(value = "经营范围") private String businessScope; - /** registerAddress */ + @ApiModelProperty(value = "注册地址") private String registerAddress; - /** officeAddress */ + @ApiModelProperty(value = "办公地址") private String officeAddress; - /** creditCode */ + @ApiModelProperty(value = "统一社会信用代码") private String creditCode; - /** qualCertNo */ + @ApiModelProperty(value = "资质证书编号") private String qualCertNo; - /** legalPersonPhone */ + @ApiModelProperty(value = "法定代表人电话") private String legalPersonPhone; - /** contactPhone */ + @ApiModelProperty(value = "联系电话") private String contactPhone; - /** infoDisclosureUrl */ + @ApiModelProperty(value = "信息公开网址") private String infoDisclosureUrl; - /** fixedAssetAmount */ + @ApiModelProperty(value = "固定资产总额") private Long fixedAssetAmount; - /** archiveRoomArea */ + @ApiModelProperty(value = "档案室面积") private BigDecimal archiveRoomArea; - /** fulltimeEvaluatorCount */ + @ApiModelProperty(value = "专职评价人员数量") private Integer fulltimeEvaluatorCount; - /** registeredEngineerCount */ + @ApiModelProperty(value = "注册安全工程师数量") private Integer registeredEngineerCount; - /** workplaceArea */ + @ApiModelProperty(value = "办公场所面积") private BigDecimal workplaceArea; - /** unitIntro */ + @ApiModelProperty(value = "单位简介") private String unitIntro; - /** attachmentUrl */ + @ApiModelProperty(value = "附件地址") private String attachmentUrl; - /** filingStatusCode */ + @ApiModelProperty(value = "备案状态编码") private Integer filingStatusCode; - /** filingStatusName */ + @ApiModelProperty(value = "备案状态名称") private String filingStatusName; - /** applyTypeCode */ + @ApiModelProperty(value = "申请类型编码") private Integer applyTypeCode; - /** applyTypeName */ + @ApiModelProperty(value = "申请类型名称") private String applyTypeName; - /** 变更次数（查询聚合，非表字段） */ + @ApiModelProperty(value = "变更次数（查询聚合，非表字段）") private Integer changeCount; - /** originFilingId */ + @ApiModelProperty(value = "原始备案ID") private Long originFilingId; - /** rejectReason */ + @ApiModelProperty(value = "打回原因") private String rejectReason; - /** submitTime */ + @ApiModelProperty(value = "提交时间") private java.time.LocalDateTime submitTime; - /** approveTime */ + @ApiModelProperty(value = "审核通过时间") private java.time.LocalDateTime approveTime; - /** 租户ID */ + @ApiModelProperty(value = "租户ID") private Long tenantId; } diff --git a/safety-eval-client/src/main/java/org/qinan/safetyeval/client/co/QualFilingCommitmentCO.java b/safety-eval-client/src/main/java/org/qinan/safetyeval/client/co/QualFilingCommitmentCO.java index 5d172a1..360237b 100644 --- a/safety-eval-client/src/main/java/org/qinan/safetyeval/client/co/QualFilingCommitmentCO.java +++ b/safety-eval-client/src/main/java/org/qinan/safetyeval/client/co/QualFilingCommitmentCO.java @@ -1,5 +1,7 @@ package org.qinan.safetyeval.client.co; +import io.swagger.annotations.ApiModelProperty; + import java.time.LocalDate; import lombok.Data; @@ -11,27 +13,27 @@ import lombok.Data; @Data public class QualFilingCommitmentCO { - /** 主键ID */ + @ApiModelProperty(value = "主键ID") private Long id; - /** filingId */ + @ApiModelProperty(value = "备案ID") private Long filingId; - /** commitmentContent */ + @ApiModelProperty(value = "承诺书内容") private String commitmentContent; - /** legalRepSignatureUrl */ + @ApiModelProperty(value = "法定代表人签名附件地址") private String legalRepSignatureUrl; - /** signDate */ + @ApiModelProperty(value = "签署日期") private LocalDate signDate; - /** 法定代表人机构人员id */ + @ApiModelProperty(value = "法定代表人机构人员ID") private Long legalRepPersonnelId; - /** 法定代表人姓名 */ + @ApiModelProperty(value = "法定代表人姓名") private String legalRepName; - /** 租户ID */ + @ApiModelProperty(value = "租户ID") private Long tenantId; } diff --git a/safety-eval-client/src/main/java/org/qinan/safetyeval/client/co/QualFilingComplianceCheckResultCO.java b/safety-eval-client/src/main/java/org/qinan/safetyeval/client/co/QualFilingComplianceCheckResultCO.java index 9fec492..e5c5d53 100644 --- a/safety-eval-client/src/main/java/org/qinan/safetyeval/client/co/QualFilingComplianceCheckResultCO.java +++ b/safety-eval-client/src/main/java/org/qinan/safetyeval/client/co/QualFilingComplianceCheckResultCO.java @@ -1,5 +1,6 @@ package org.qinan.safetyeval.client.co; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; /** @@ -10,12 +11,12 @@ import lombok.Data; @Data public class QualFilingComplianceCheckResultCO { - /** 检查项标题 */ + @ApiModelProperty(value = "检查项标题") private String title; - /** 检查项描述 */ + @ApiModelProperty(value = "检查项描述") private String description; - /** 检查结果状态：✅ 通过 / ❌ 未通过 / ⚠️ 警告 */ + @ApiModelProperty(value = "检查结果状态：✅ 通过 / ❌ 未通过 / ⚠️ 警告") private String status; } diff --git a/safety-eval-client/src/main/java/org/qinan/safetyeval/client/co/QualFilingDetailCO.java b/safety-eval-client/src/main/java/org/qinan/safetyeval/client/co/QualFilingDetailCO.java index 6673b43..ce6858d 100644 --- a/safety-eval-client/src/main/java/org/qinan/safetyeval/client/co/QualFilingDetailCO.java +++ b/safety-eval-client/src/main/java/org/qinan/safetyeval/client/co/QualFilingDetailCO.java @@ -1,5 +1,6 @@ package org.qinan.safetyeval.client.co; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import lombok.EqualsAndHashCode; @@ -12,11 +13,15 @@ import java.util.List; @EqualsAndHashCode(callSuper = true) public class QualFilingDetailCO extends QualFilingCO { + @ApiModelProperty(value = "备案申请材料列表") private List materials; + @ApiModelProperty(value = "法定代表人承诺书") private QualFilingCommitmentCO commitment; + @ApiModelProperty(value = "备案申请人员列表") private List personnelList; + @ApiModelProperty(value = "备案申请装备列表") private List equipmentList; } diff --git a/safety-eval-client/src/main/java/org/qinan/safetyeval/client/co/QualFilingEquipmentCO.java b/safety-eval-client/src/main/java/org/qinan/safetyeval/client/co/QualFilingEquipmentCO.java index 23181eb..af43b3f 100644 --- a/safety-eval-client/src/main/java/org/qinan/safetyeval/client/co/QualFilingEquipmentCO.java +++ b/safety-eval-client/src/main/java/org/qinan/safetyeval/client/co/QualFilingEquipmentCO.java @@ -1,5 +1,7 @@ package org.qinan.safetyeval.client.co; +import io.swagger.annotations.ApiModelProperty; + import java.math.BigDecimal; import lombok.Data; @@ -11,63 +13,63 @@ import lombok.Data; @Data public class QualFilingEquipmentCO { - /** 主键ID */ + @ApiModelProperty(value = "主键ID") private Long id; - /** filingId */ + @ApiModelProperty(value = "备案ID") private Long filingId; - /** sourceEquipmentId */ + @ApiModelProperty(value = "原始装备ID") private Long sourceEquipmentId; - /** deviceName */ + @ApiModelProperty(value = "设备名称") private String deviceName; - /** deviceModel */ + @ApiModelProperty(value = "设备型号") private String deviceModel; - /** instrumentTypeCode */ + @ApiModelProperty(value = "仪器类型编码") private String instrumentTypeCode; - /** instrumentTypeName */ + @ApiModelProperty(value = "仪器类型名称") private String instrumentTypeName; - /** deviceTypeCode */ + @ApiModelProperty(value = "设备类型编码") private String deviceTypeCode; - /** deviceTypeName */ + @ApiModelProperty(value = "设备类型名称") private String deviceTypeName; - /** manufacturer */ + @ApiModelProperty(value = "生产厂家") private String manufacturer; - /** flowDesc */ + @ApiModelProperty(value = "流量描述") private String flowDesc; - /** minFlow */ + @ApiModelProperty(value = "最小流量") private BigDecimal minFlow; - /** maxFlow */ + @ApiModelProperty(value = "最大流量") private BigDecimal maxFlow; - /** calibrationUnit */ + @ApiModelProperty(value = "校准单位") private String calibrationUnit; - /** calibrationInitValue */ + @ApiModelProperty(value = "校准初始值") private String calibrationInitValue; - /** fieldCalibrationTypeCode */ + @ApiModelProperty(value = "现场校准类型编码") private String fieldCalibrationTypeCode; - /** fieldCalibrationTypeName */ + @ApiModelProperty(value = "现场校准类型名称") private String fieldCalibrationTypeName; - /** dualChannelFlag */ + @ApiModelProperty(value = "是否双通道") private Integer dualChannelFlag; - /** calibrationReportUrl */ + @ApiModelProperty(value = "校准报告附件地址") private String calibrationReportUrl; - /** 租户ID */ + @ApiModelProperty(value = "租户ID") private Long tenantId; } diff --git a/safety-eval-client/src/main/java/org/qinan/safetyeval/client/co/QualFilingMaterialCO.java b/safety-eval-client/src/main/java/org/qinan/safetyeval/client/co/QualFilingMaterialCO.java index 9f9d417..527b382 100644 --- a/safety-eval-client/src/main/java/org/qinan/safetyeval/client/co/QualFilingMaterialCO.java +++ b/safety-eval-client/src/main/java/org/qinan/safetyeval/client/co/QualFilingMaterialCO.java @@ -1,5 +1,6 @@ package org.qinan.safetyeval.client.co; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; /** @@ -10,42 +11,42 @@ import lombok.Data; @Data public class QualFilingMaterialCO { - /** 主键ID */ + @ApiModelProperty(value = "主键ID") private Long id; - /** filingId */ + @ApiModelProperty(value = "备案ID") private Long filingId; - /** materialType */ + @ApiModelProperty(value = "材料类型") private Integer materialType; - /** materialContent */ + @ApiModelProperty(value = "材料内容") private String materialContent; - /** materialFormat */ + @ApiModelProperty(value = "材料格式") private String materialFormat; - /** sortOrder */ + @ApiModelProperty(value = "排序顺序") private Integer sortOrder; - /** requiredFlag */ + @ApiModelProperty(value = "是否必需") private Integer requiredFlag; - /** uploadStatusCode */ + @ApiModelProperty(value = "上传状态编码") private Integer uploadStatusCode; - /** uploadStatusName */ + @ApiModelProperty(value = "上传状态名称") private String uploadStatusName; - /** attachmentDesc */ + @ApiModelProperty(value = "附件描述") private String attachmentDesc; - /** attachmentUrl */ + @ApiModelProperty(value = "附件地址") private String attachmentUrl; - /** materialRemark */ + @ApiModelProperty(value = "材料备注") private String materialRemark; - /** 租户ID */ + @ApiModelProperty(value = "租户ID") private Long tenantId; } diff --git a/safety-eval-client/src/main/java/org/qinan/safetyeval/client/co/QualFilingPersonnelCO.java b/safety-eval-client/src/main/java/org/qinan/safetyeval/client/co/QualFilingPersonnelCO.java index 29178d2..995f838 100644 --- a/safety-eval-client/src/main/java/org/qinan/safetyeval/client/co/QualFilingPersonnelCO.java +++ b/safety-eval-client/src/main/java/org/qinan/safetyeval/client/co/QualFilingPersonnelCO.java @@ -1,5 +1,7 @@ package org.qinan.safetyeval.client.co; +import io.swagger.annotations.ApiModelProperty; + import java.time.LocalDate; import lombok.Data; @@ -11,84 +13,84 @@ import lombok.Data; @Data public class QualFilingPersonnelCO { - /** 主键ID */ + @ApiModelProperty(value = "主键ID") private Long id; - /** filingId */ + @ApiModelProperty(value = "备案ID") private Long filingId; - /** sourcePersonnelId */ + @ApiModelProperty(value = "原始人员ID") private Long sourcePersonnelId; - /** personName */ + @ApiModelProperty(value = "人员姓名") private String personName; - /** personTypeCode */ + @ApiModelProperty(value = "人员类型编码") private String personTypeCode; - /** personTypeName */ + @ApiModelProperty(value = "人员类型名称") private String personTypeName; - /** positionName */ + @ApiModelProperty(value = "职位名称") private String positionName; - /** titleName */ + @ApiModelProperty(value = "职称名称") private String titleName; - /** genderCode */ + @ApiModelProperty(value = "性别编码") private Integer genderCode; - /** genderName */ + @ApiModelProperty(value = "性别名称") private String genderName; - /** birthDate */ + @ApiModelProperty(value = "出生日期") private LocalDate birthDate; - /** 参加工作时间 */ + @ApiModelProperty(value = "参加工作时间") private LocalDate joinWorkDate; - /** idCardNo */ + @ApiModelProperty(value = "身份证号") private String idCardNo; - /** currentAddress */ + @ApiModelProperty(value = "现住地址") private String currentAddress; - /** officeAddress */ + @ApiModelProperty(value = "办公地址") private String officeAddress; - /** educationCode */ + @ApiModelProperty(value = "学历编码") private String educationCode; - /** educationName */ + @ApiModelProperty(value = "学历名称") private String educationName; - /** graduateSchool */ + @ApiModelProperty(value = "毕业院校") private String graduateSchool; - /** major */ + @ApiModelProperty(value = "专业") private String major; - /** qualScope */ + @ApiModelProperty(value = "资质范围") private String qualScope; - /** publications */ + @ApiModelProperty(value = "发表著作") private String publications; - /** professionalLevelCert */ + @ApiModelProperty(value = "职业资格等级证书") private String professionalLevelCert; - /** registerEngineerFlag */ + @ApiModelProperty(value = "是否注册安全工程师") private Integer registerEngineerFlag; - /** abilityDeclaration */ + @ApiModelProperty(value = "能力声明") private String abilityDeclaration; - /** workExperience */ + @ApiModelProperty(value = "工作经历") private String workExperience; - /** proofMaterialUrl */ + @ApiModelProperty(value = "证明材料附件地址") private String proofMaterialUrl; - /** 租户ID */ + @ApiModelProperty(value = "租户ID") private Long tenantId; } diff --git a/safety-eval-client/src/main/java/org/qinan/safetyeval/client/dto/PageResponse.java b/safety-eval-client/src/main/java/org/qinan/safetyeval/client/dto/PageResponse.java index 62becd9..145465e 100644 --- a/safety-eval-client/src/main/java/org/qinan/safetyeval/client/dto/PageResponse.java +++ b/safety-eval-client/src/main/java/org/qinan/safetyeval/client/dto/PageResponse.java @@ -1,5 +1,6 @@ package org.qinan.safetyeval.client.dto; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import lombok.EqualsAndHashCode; @@ -17,7 +18,7 @@ import java.util.List; @EqualsAndHashCode(callSuper = true) public class PageResponse extends SingleResponse> { - /** 总条数 */ + @ApiModelProperty(value = "总条数") private Long total; public static PageResponse of(List list, Long total) { diff --git a/safety-eval-client/src/main/java/org/qinan/safetyeval/client/dto/SingleResponse.java b/safety-eval-client/src/main/java/org/qinan/safetyeval/client/dto/SingleResponse.java index 790e0b8..0ff43b7 100644 --- a/safety-eval-client/src/main/java/org/qinan/safetyeval/client/dto/SingleResponse.java +++ b/safety-eval-client/src/main/java/org/qinan/safetyeval/client/dto/SingleResponse.java @@ -1,5 +1,6 @@ package org.qinan.safetyeval.client.dto; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; /** @@ -13,9 +14,16 @@ import lombok.Data; @Data public class SingleResponse { + @ApiModelProperty(value = "是否成功") private boolean success; + + @ApiModelProperty(value = "响应码") private String code; + + @ApiModelProperty(value = "响应消息") private String message; + + @ApiModelProperty(value = "响应数据") private T data; public static SingleResponse success(T data) {