1. 统一包名修改

zt-module-template/pom.xml

@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <parent>
+        <artifactId>zt</artifactId>
+        <groupId>com.zt.plat</groupId>
+        <version>${revision}</version>
+    </parent>
+    <modules>
+        <module>zt-module-template-api</module>
+        <module>zt-module-template-server</module>
+    </modules>
+    <modelVersion>4.0.0</modelVersion>
+
+    <artifactId>zt-module-template</artifactId>
+    <packaging>pom</packaging>
+
+    <name>${project.artifactId}</name>
+    <description>
+        样例模块。
+    </description>
+
+</project>

zt-module-template/zt-module-template-api/pom.xml

@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <parent>
+        <artifactId>zt-module-template</artifactId>
+        <groupId>com.zt.plat</groupId>
+        <version>${revision}</version>
+    </parent>
+    <modelVersion>4.0.0</modelVersion>
+    <artifactId>zt-module-template-api</artifactId>
+    <packaging>jar</packaging>
+
+    <name>${project.artifactId}</name>
+    <description>
+        暴露给其它模块调用
+    </description>
+
+    <dependencies>
+        <dependency>
+            <groupId>com.zt.plat</groupId>
+            <artifactId>zt-common</artifactId>
+        </dependency>
+        <!-- Web 相关 -->
+        <dependency>
+            <groupId>org.springdoc</groupId> <!-- 接口文档：使用最新版本的 Swagger 模型 -->
+            <artifactId>springdoc-openapi-starter-webmvc-api</artifactId>
+            <scope>provided</scope>
+        </dependency>
+
+        <!-- 参数校验 -->
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-validation</artifactId>
+            <optional>true</optional>
+        </dependency>
+
+        <!-- RPC 远程调用相关 -->
+        <dependency>
+            <groupId>org.springframework.cloud</groupId>
+            <artifactId>spring-cloud-starter-openfeign</artifactId>
+            <optional>true</optional>
+        </dependency>
+    </dependencies>
+
+</project>

zt-module-template/zt-module-template-api/src/main/java/com/zt/plat/module/template/enums/ErrorCodeConstants.java

@@ -0,0 +1,19 @@
+package com.zt.plat.module.template.enums;
+
+import com.zt.plat.framework.common.exception.ErrorCode;
+
+/**
+ * Template 错误码枚举类
+ * Template 系统，使用 1_100_000_000 段
+ */
+public interface ErrorCodeConstants {
+
+    // ========== 模板样例 1_100_000_000 ==========
+    ErrorCode EXAMPLE_NOT_EXISTS = new ErrorCode(1_100_000_000, "模板样例不存在");
+    // ========== 合同 补充编号 ==========
+    ErrorCode DEMO_CONTRACT_NOT_EXISTS = new ErrorCode(2_100_000_000, "合同不存在");
+
+    // ========== 虚拟化表格 1_100_000_001 ==========
+    ErrorCode DEMO_VIRTUALIZED_TABLE_NOT_EXISTS = new ErrorCode(1_100_000_001, "虚拟化表格不存在");
+
+}

zt-module-template/zt-module-template-server/Dockerfile

@@ -0,0 +1,19 @@
+## AdoptOpenJDK 停止发布 OpenJDK 二进制，而 Eclipse Temurin 是它的延伸，提供更好的稳定性
+
+FROM 172.16.46.66:10043/base-service/eclipse-temurin:21-jre
+
+## 创建目录，并使用它作为工作目录
+RUN mkdir -p /cloud-module-template-server
+WORKDIR /cloud-module-template-server
+## 将后端项目的 Jar 文件，复制到镜像中
+COPY ./target/cloud-module-template-server.jar app.jar
+
+## 设置 TZ 时区
+## 设置 JAVA_OPTS 环境变量，可通过 docker run -e "JAVA_OPTS=" 进行覆盖
+ENV TZ=Asia/Shanghai JAVA_OPTS="-Xms512m -Xmx512m"
+
+## 暴露后端项目的 48080 端口
+EXPOSE 48100
+
+## 启动后端项目
+CMD java ${JAVA_OPTS} -Djava.security.egd=file:/dev/./urandom -jar app.jar

zt-module-template/zt-module-template-server/src/main/java/com/zt/plat/module/template/TemplateServerApplication.java

@@ -0,0 +1,18 @@
+package com.zt.plat.module.template;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+/**
+ * 项目的启动类
+ *
+ * @author 周迪
+ */
+@SpringBootApplication
+public class TemplateServerApplication {
+
+    public static void main(String[] args) {
+        SpringApplication.run(TemplateServerApplication.class, args);
+    }
+
+}

zt-module-template/zt-module-template-server/src/main/java/com/zt/plat/module/template/controller/admin/contract/vo/DemoContractPageReqVO.java

@@ -0,0 +1,54 @@
+package com.zt.plat.module.template.controller.admin.contract.vo;
+
+import lombok.*;
+import java.util.*;
+import io.swagger.v3.oas.annotations.media.Schema;
+import com.zt.plat.framework.common.pojo.PageParam;
+import java.math.BigDecimal;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+
+import static com.zt.plat.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - 合同分页 Request VO")
+@Data
+public class DemoContractPageReqVO extends PageParam {
+
+    @Schema(description = "合同编号")
+    private String code;
+
+    @Schema(description = "合同名称", example = "李四")
+    private String name;
+
+    @Schema(description = "合同状态", example = "1")
+    private Short status;
+
+    @Schema(description = "流程实例ID", example = "7282")
+    private Long processInstanceId;
+
+    @Schema(description = "签订日期")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] signDate;
+
+    @Schema(description = "合同开始日期")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] startDate;
+
+    @Schema(description = "合同结束日期")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] endDate;
+
+    @Schema(description = "合同金额")
+    private BigDecimal amount;
+
+    @Schema(description = "备注", example = "随便")
+    private String remark;
+
+    @Schema(description = "创建时间")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] createTime;
+
+    @Schema(description = "岗位ID", example = "26779")
+    private Long postId;
+
+}

zt-module-template/zt-module-template-server/src/main/java/com/zt/plat/module/template/controller/admin/contract/vo/DemoContractRespVO.java

@@ -0,0 +1,80 @@
+package com.zt.plat.module.template.controller.admin.contract.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.*;
+import java.util.*;
+import java.math.BigDecimal;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+import com.alibaba.excel.annotation.*;
+
+@Schema(description = "管理后台 - 合同 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class DemoContractRespVO {
+
+    @Schema(description = "合同ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "29614")
+    @ExcelProperty("合同ID")
+    private Long id;
+
+    @Schema(description = "合同编号", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("合同编号")
+    private String code;
+
+    @Schema(description = "合同名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "李四")
+    @ExcelProperty("合同名称")
+    private String name;
+
+    @Schema(description = "合同状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @ExcelProperty("合同状态")
+    private Short status;
+
+    @Schema(description = "流程实例ID", example = "7282")
+    @ExcelProperty("流程实例ID")
+    private Long processInstanceId;
+
+    @Schema(description = "签订日期")
+    @ExcelProperty("签订日期")
+    private LocalDateTime signDate;
+
+    @Schema(description = "合同开始日期")
+    @ExcelProperty("合同开始日期")
+    private LocalDateTime startDate;
+
+    @Schema(description = "合同结束日期")
+    @ExcelProperty("合同结束日期")
+    private LocalDateTime endDate;
+
+    @Schema(description = "合同金额", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("合同金额")
+    private BigDecimal amount;
+
+    @Schema(description = "备注", example = "随便")
+    @ExcelProperty("备注")
+    private String remark;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("创建时间")
+    private LocalDateTime createTime;
+
+    @Schema(description = "公司ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "9176")
+    @ExcelProperty("公司ID")
+    private Long companyId;
+
+    @Schema(description = "公司名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "张三")
+    @ExcelProperty("公司名称")
+    private String companyName;
+
+    @Schema(description = "部门ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "23987")
+    @ExcelProperty("部门ID")
+    private Long deptId;
+
+    @Schema(description = "部门名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "芋艿")
+    @ExcelProperty("部门名称")
+    private String deptName;
+
+    @Schema(description = "岗位ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "26779")
+    @ExcelProperty("岗位ID")
+    private Long postId;
+
+}

zt-module-template/zt-module-template-server/src/main/java/com/zt/plat/module/template/controller/admin/contract/vo/DemoContractSaveReqVO.java

@@ -0,0 +1,42 @@
+package com.zt.plat.module.template.controller.admin.contract.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.*;
+import java.util.*;
+import jakarta.validation.constraints.*;
+import java.math.BigDecimal;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 合同新增/修改 Request VO")
+@Data
+public class DemoContractSaveReqVO {
+
+    @Schema(description = "合同ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "29614")
+    private Long id;
+
+    @Schema(description = "合同名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "李四")
+    @NotEmpty(message = "合同名称不能为空")
+    private String name;
+
+    @Schema(description = "签订日期")
+    private LocalDateTime signDate;
+
+    @Schema(description = "合同开始日期")
+    private LocalDateTime startDate;
+
+    @Schema(description = "合同结束日期")
+    private LocalDateTime endDate;
+
+    @Schema(description = "合同金额", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "合同金额不能为空")
+    private BigDecimal amount;
+
+    @Schema(description = "备注", example = "随便")
+    private String remark;
+
+    @Schema(description = "岗位ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "26779")
+    @NotNull(message = "岗位ID不能为空")
+    private Long postId;
+
+}