birc-generator 0.5.5

package/templates/base/application.yml.hbs

@@ -0,0 +1,18 @@
+spring:
+  application:
+    name: {{projectName}}
+  datasource:
+    url: ${DB_URL:jdbc:mysql://localhost:3306/app}
+    username: ${DB_USERNAME:root}
+    password: ${DB_PASSWORD:}
+  jpa:
+    hibernate:
+      ddl-auto: validate
+    open-in-view: false
+
+server:
+  port: ${SPRING_SERVER_PORT:8080}
+
+# 下面這行是 plop add 的插入點，不要刪、不要移動位置。
+# 新的 feature 設定會被插到這行「之後」。
+# birc-generator:config-anchor

package/templates/base/bircrc.hbs

@@ -0,0 +1,14 @@
+{
+  "basePackage": "{{basePackage}}",
+  "projectNameKebab": "{{projectNameKebab}}",
+  "multiModule": {{multiModule}},
+  "srcPath": "src/main/java",
+  "resourcesPath": "src/main/resources",
+  "applicationYmlPath": "src/main/resources/application.yml",
+  "buildGradlePath": "build.gradle",
+  "entityPackage": "{{entityPackage}}",
+  "daoPackage": "{{daoPackage}}",
+  "entityPath": "{{entityPath}}",
+  "daoPath": "{{daoPath}}",
+  "features": {{{featuresJson}}}
+}

package/templates/base/build.gradle.hbs

@@ -0,0 +1,33 @@
+plugins {
+    id 'java'
+    id 'org.springframework.boot' version '{{springBootVersion}}'
+    id 'io.spring.dependency-management' version '{{dependencyManagementVersion}}'
+}
+
+group = '{{basePackage}}'
+version = '0.0.1-SNAPSHOT'
+
+java {
+    sourceCompatibility = '21'
+}
+
+repositories {
+    mavenCentral()
+}
+
+dependencies {
+    // 下面這行是 plop add 的插入點，不要刪、不要移動位置。
+    // 新的 feature 依賴會被插到這行「之後」。
+    // birc-generator:dependency-anchor
+    implementation 'org.springframework.boot:spring-boot-starter-web'
+    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
+    implementation 'org.springframework.boot:spring-boot-starter-validation'
+    compileOnly 'org.projectlombok:lombok'
+    annotationProcessor 'org.projectlombok:lombok'
+    runtimeOnly 'com.mysql:mysql-connector-j'
+    testImplementation 'org.springframework.boot:spring-boot-starter-test'
+}
+
+tasks.named('test') {
+    useJUnitPlatform()
+}

package/templates/base/gitignore.hbs

@@ -0,0 +1,15 @@
+build/
+.gradle/
+.env
+upload/
+uploads/
+logs/
+*.iml
+.idea/
+.classpath
+.factorypath
+.project
+.settings/
+.springBeans
+.sts4-cache/
+!gradle/wrapper/gradle-wrapper.jar

package/templates/client/ExternalApiClient.hbs

@@ -0,0 +1,28 @@
+package {{basePackage}}.client;
+
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Component;
+import org.springframework.web.client.RestClient;
+
+/**
+ * 呼叫外部 API 的封裝範例，用 Spring 6 的 RestClient（同步、比 WebClient 簡單，
+ * 如果專案已經是 reactive 技術棧，改用 WebClient 會更一致）。
+ *
+ * TODO：這裡只示範一個 GET 方法，實際的 path、request/response DTO、
+ * 錯誤處理（4xx/5xx 轉成專案自己的例外）請依實際要接的 API 改寫。
+ */
+@Slf4j
+@Component
+@RequiredArgsConstructor
+public class ExternalApiClient {
+
+    private final RestClient externalApiRestClient;
+
+    public String ping() {
+        return externalApiRestClient.get()
+                .uri("/health")
+                .retrieve()
+                .body(String.class);
+    }
+}

package/templates/client/ExternalApiClientConfig.hbs

@@ -0,0 +1,26 @@
+package {{basePackage}}.config;
+
+import lombok.RequiredArgsConstructor;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.http.client.SimpleClientHttpRequestFactory;
+import org.springframework.web.client.RestClient;
+
+@Configuration
+@RequiredArgsConstructor
+public class ExternalApiClientConfig {
+
+    private final ExternalApiProperties properties;
+
+    @Bean
+    public RestClient externalApiRestClient() {
+        SimpleClientHttpRequestFactory requestFactory = new SimpleClientHttpRequestFactory();
+        requestFactory.setConnectTimeout(properties.getConnectTimeoutMs());
+        requestFactory.setReadTimeout(properties.getReadTimeoutMs());
+
+        return RestClient.builder()
+                .baseUrl(properties.getBaseUrl())
+                .requestFactory(requestFactory)
+                .build();
+    }
+}

package/templates/client/ExternalApiProperties.hbs

@@ -0,0 +1,30 @@
+package {{basePackage}}.config;
+
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotBlank;
+import lombok.Getter;
+import lombok.Setter;
+import org.springframework.boot.context.properties.ConfigurationProperties;
+import org.springframework.stereotype.Component;
+import org.springframework.validation.annotation.Validated;
+
+/**
+ * 外部 API 的連線設定，對應 application.yml 的 external.api.*。
+ * 一個專案如果要呼叫多個外部服務，複製這個類別改名即可，不用共用同一組設定。
+ */
+@Getter
+@Setter
+@Validated
+@Component
+@ConfigurationProperties(prefix = "external.api")
+public class ExternalApiProperties {
+
+    @NotBlank
+    private String baseUrl = "https://example.com";
+
+    @Min(1)
+    private int connectTimeoutMs = 3000;
+
+    @Min(1)
+    private int readTimeoutMs = 5000;
+}

package/templates/client/application-yml-block.hbs

@@ -0,0 +1,7 @@
+---
+# --- client（由 birc-generator add 產生） ---
+external:
+  api:
+    base-url: ${EXTERNAL_API_BASE_URL:https://example.com}
+    connect-timeout-ms: 3000
+    read-timeout-ms: 5000

package/templates/controller.hbs

@@ -0,0 +1,55 @@
+package {{basePackage}}.controller;
+
+import lombok.RequiredArgsConstructor;
+{{#if withExample}}
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+{{/if}}
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+{{#if withExample}}
+import {{basePackage}}.validation.ValidGroup;
+import {{basePackage}}.web.Result;
+import {{basePackage}}.dto.{{pascalCase entityName}}CreateRequest;
+import {{basePackage}}.dto.{{pascalCase entityName}}Response;
+{{/if}}
+import {{basePackage}}.service.{{pascalCase entityName}}Service;
+
+@RestController
+@RequestMapping("/api/{{lowerCase entityName}}s")
+@RequiredArgsConstructor
+public class {{pascalCase entityName}}Controller {
+
+    private final {{pascalCase entityName}}Service service;
+{{#if withExample}}
+
+    @PostMapping
+    public Result<{{pascalCase entityName}}Response> create(
+            @Validated(ValidGroup.Create.class) @RequestBody {{pascalCase entityName}}CreateRequest request) {
+        return Result.success(service.create(request));
+    }
+
+    @GetMapping("/{id}")
+    public Result<{{pascalCase entityName}}Response> getById(@PathVariable Long id) {
+        return Result.success(service.getById(id));
+    }
+
+    @PutMapping("/{id}")
+    public Result<{{pascalCase entityName}}Response> update(
+            @PathVariable Long id,
+            @Validated(ValidGroup.Update.class) @RequestBody {{pascalCase entityName}}CreateRequest request) {
+        return Result.success(service.update(id, request));
+    }
+
+    @DeleteMapping("/{id}")
+    public Result<Void> delete(@PathVariable Long id) {
+        service.deleteById(id);
+        return Result.success();
+    }
+{{/if}}
+}

package/templates/dao.hbs

@@ -0,0 +1,11 @@
+package {{daoPackage}};
+
+import org.springframework.stereotype.Repository;
+import {{entityPackage}}.{{pascalCase entityName}};
+
+@Repository
+public interface {{pascalCase entityName}}DAO extends BaseDAO<{{pascalCase entityName}}, Long> {
+{{#if withExample}}
+    // 需要額外查詢時再在這裡加方法，例如 findByName
+{{/if}}
+}

package/templates/docker/Dockerfile.hbs

@@ -0,0 +1,29 @@
+# 多階段 build，用專案自己的 Gradle wrapper。
+# 不以 build-arg / ARG 傳任何帳密：build args 會留在 image layer，
+# 有 Harbor 拉取權的人用 docker history 就看得到。
+FROM eclipse-temurin:21-jdk-alpine AS builder
+
+WORKDIR /workspace
+COPY gradlew .
+COPY gradle gradle
+COPY build.gradle settings.gradle ./
+COPY modules/{{projectNameKebab}}-config/build.gradle modules/{{projectNameKebab}}-config/
+COPY modules/{{projectNameKebab}}-database-config/build.gradle modules/{{projectNameKebab}}-database-config/
+RUN chmod +x ./gradlew
+RUN ./gradlew dependencies --no-daemon || true
+
+COPY src src
+COPY modules modules
+RUN ./gradlew bootJar --no-daemon -x test
+
+FROM eclipse-temurin:21-jre-alpine
+
+WORKDIR /app
+RUN addgroup -S spring && adduser -S spring -G spring \
+    && mkdir -p /app/upload && chown -R spring:spring /app/upload
+COPY --from=builder /workspace/build/libs/*.jar app.jar
+RUN chown spring:spring app.jar
+USER spring:spring
+
+EXPOSE 8080
+ENTRYPOINT ["java", "-Djava.security.egd=file:/dev/./urandom", "-jar", "app.jar"]

package/templates/docker/docker-compose.prod.yml.hbs

@@ -0,0 +1,65 @@
+services:
+  db:
+    image: mysql:8.4
+    container_name: {{dashCase projectName}}_db
+    restart: unless-stopped
+    environment:
+      MYSQL_ROOT_PASSWORD: ${DB_ROOT_PASSWORD}
+      MYSQL_DATABASE: ${DB_DATABASE}
+      MYSQL_USER: ${DB_USER}
+      MYSQL_PASSWORD: ${DB_PASSWORD}
+      TZ: ${TZ:-Asia/Taipei}
+    volumes:
+      - type: volume
+        source: db_data
+        target: /var/lib/mysql
+    command:
+      - --character-set-server
+      - utf8mb4
+      - --collation-server
+      - utf8mb4_unicode_ci
+    healthcheck:
+      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-p${DB_ROOT_PASSWORD}"]
+      interval: 5s
+      timeout: 5s
+      retries: 10
+    logging:
+      driver: json-file
+      options:
+        max-size: "10m"
+        max-file: "3"
+
+  app:
+    image: ${DOCKER_IMAGE:-{{dashCase projectName}}-app}:${APP_TAG:-latest}
+    container_name: {{dashCase projectName}}_app
+    restart: unless-stopped
+    ports:
+      - target: 8080
+        published: ${SERVER_PORT:-8080}
+        protocol: tcp
+    environment:
+      DB_URL: jdbc:mysql://db:3306/${DB_DATABASE}
+      DB_USERNAME: ${DB_USER}
+      DB_PASSWORD: ${DB_PASSWORD}
+      TZ: ${TZ:-Asia/Taipei}
+      SPRING_PROFILES_ACTIVE: prod
+      FILE_STORAGE_PATH: /app/upload
+      SENTRY_DSN: ${SENTRY_DSN:-}
+    volumes:
+      - type: volume
+        source: app_uploads
+        target: /app/upload
+    depends_on:
+      db:
+        condition: service_healthy
+    logging:
+      driver: json-file
+      options:
+        max-size: "10m"
+        max-file: "3"
+
+volumes:
+  db_data:
+    name: {{dashCase projectName}}_db_data
+  app_uploads:
+    name: {{dashCase projectName}}_app_uploads

package/templates/docker/docker-compose.yml.hbs

@@ -0,0 +1,52 @@
+services:
+  db:
+    image: mysql:5.7
+    container_name: {{dashCase projectName}}_db
+    restart: unless-stopped
+    environment:
+      MYSQL_ROOT_PASSWORD: ${DB_ROOT_PASSWORD}
+      MYSQL_DATABASE: ${DB_DATABASE}
+      MYSQL_USER: ${DB_USER}
+      MYSQL_PASSWORD: ${DB_PASSWORD}
+      TZ: ${TZ:-Asia/Taipei}
+    ports:
+      - "${DB_PORT:-3306}:3306"
+    volumes:
+      - db_data:/var/lib/mysql
+    command:
+      - --character-set-server=utf8mb4
+      - --collation-server=utf8mb4_unicode_ci
+    healthcheck:
+      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-uroot", "-p${DB_ROOT_PASSWORD}"]
+      interval: 5s
+      timeout: 5s
+      retries: 30
+      start_period: 180s
+
+  app:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    image: ${DOCKER_IMAGE:-{{dashCase projectName}}-app}:dev
+    container_name: {{dashCase projectName}}_app
+    restart: unless-stopped
+    ports:
+      - "${SERVER_PORT:-8080}:8080"
+      # JDWP 沒有驗證，綁 loopback 只給本機 debugger 用，不對外開。
+      - "127.0.0.1:${DEBUG_PORT:-5005}:5005"
+    environment:
+      DB_URL: jdbc:mysql://db:3306/${DB_DATABASE}
+      DB_USERNAME: ${DB_USER}
+      DB_PASSWORD: ${DB_PASSWORD}
+      TZ: ${TZ:-Asia/Taipei}
+      SPRING_PROFILES_ACTIVE: dev
+      FILE_STORAGE_PATH: /app/upload
+    volumes:
+      - ./upload:/app/upload
+    depends_on:
+      db:
+        condition: service_healthy
+
+volumes:
+  db_data:
+    name: {{dashCase projectName}}_db_data

package/templates/docker/dockerignore.hbs

@@ -0,0 +1,6 @@
+build/
+.gradle/
+.git/
+.idea/
+*.iml
+.env

package/templates/docker/env.example.hbs

@@ -0,0 +1,24 @@
+# MySQL（docker compose up -d db）
+# 密碼由產生器隨機生成，僅供本機開發；正式環境請自行更換。
+DB_ROOT_PASSWORD={{dbRootPassword}}
+DB_DATABASE={{snakeCase projectNameKebab}}
+DB_USER={{snakeCase projectNameKebab}}_user
+DB_PASSWORD={{dbPassword}}
+DB_PORT=3306
+
+# Spring Boot（bootRun 前先把 .env 載入目前 shell；Bash 用 source，PowerShell 見 README）
+DB_URL=jdbc:mysql://127.0.0.1:3306/{{snakeCase projectNameKebab}}
+DB_USERNAME={{snakeCase projectNameKebab}}_user
+TZ=Asia/Taipei
+SERVER_PORT=8080
+DEBUG_PORT=5005
+FILE_STORAGE_PATH=./upload
+LOG_LEVEL=INFO
+LOG_PATH=./logs
+
+# 正式環境映像（docker-compose.prod.yml）
+DOCKER_IMAGE={{snakeCase projectNameKebab}}_app
+APP_TAG=latest
+
+# 可選
+SENTRY_DSN=

package/templates/dto-request.hbs

@@ -0,0 +1,19 @@
+package {{basePackage}}.dto;
+{{#if withExample}}
+
+{{#each extraImports}}
+import {{this}};
+{{/each}}
+import jakarta.validation.constraints.NotNull;
+import {{basePackage}}.validation.ValidGroup;
+{{/if}}
+
+public record {{pascalCase entityName}}CreateRequest(
+{{#if withExample}}
+{{#each makeFields}}
+        @NotNull(groups = {ValidGroup.Create.class, ValidGroup.Update.class})
+        {{this.type}} {{this.name}}{{#unless @last}},{{/unless}}
+{{/each}}
+{{/if}}
+) {
+}

package/templates/dto-response.hbs

@@ -0,0 +1,13 @@
+package {{basePackage}}.dto;
+{{#if withExample}}
+
+{{#each extraImports}}
+import {{this}};
+{{/each}}
+{{/if}}
+
+public record {{pascalCase entityName}}Response(
+        Long id{{#if withExample}}{{#each makeFields}},
+        {{this.type}} {{this.name}}{{/each}}{{/if}}
+) {
+}

package/templates/email/EmailAsyncConfig.hbs

@@ -0,0 +1,28 @@
+package {{basePackage}}.config;
+
+import java.util.concurrent.Executor;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.scheduling.annotation.EnableAsync;
+import org.springframework.scheduling.concurrent.ThreadPoolTaskExecutor;
+
+/**
+ * 寄信專用的執行緒池，跟其他 @Async 用途分開，避免寄信卡住其他非同步工作，
+ * 反之亦然。如果專案已經有共用的 @EnableAsync 設定，把這個 @EnableAsync 拿掉即可，
+ * 一個專案只需要一個。
+ */
+@Configuration
+@EnableAsync
+public class EmailAsyncConfig {
+
+    @Bean
+    public Executor mailExecutor() {
+        ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
+        executor.setCorePoolSize(2);
+        executor.setMaxPoolSize(4);
+        executor.setQueueCapacity(50);
+        executor.setThreadNamePrefix("mail-");
+        executor.initialize();
+        return executor;
+    }
+}

package/templates/email/EmailService.hbs

@@ -0,0 +1,26 @@
+package {{basePackage}}.service;
+
+import java.util.Map;
+
+/**
+ * 郵件服務介面。
+ *
+ * 骨架由 birc-generator（plop add，選 email）產生。實際的寄信情境 （例如報名確認、活動取消通知）請依專案需求另外擴充方法，
+ * 不要把所有情境都塞進單一 send()。
+ */
+public interface EmailService {
+
+    /**
+     * 寄送一封使用 Thymeleaf 模板渲染內容的郵件。
+     *
+     * @param to
+     *            收件人
+     * @param subject
+     *            主旨
+     * @param templateName
+     *            對應 src/main/resources/email/ 底下的模板檔名（不含 .html）
+     * @param variables
+     *            模板變數
+     */
+    void send(String to, String subject, String templateName, Map<String, Object> variables);
+}

package/templates/email/EmailServiceImpl.hbs

@@ -0,0 +1,49 @@
+package {{basePackage}}.service.impl;
+
+import jakarta.mail.internet.MimeMessage;
+import java.util.Map;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.mail.javamail.JavaMailSender;
+import org.springframework.mail.javamail.MimeMessageHelper;
+import org.springframework.scheduling.annotation.Async;
+import org.springframework.stereotype.Service;
+import org.thymeleaf.context.Context;
+import org.thymeleaf.spring6.SpringTemplateEngine;
+import {{basePackage}}.service.EmailService;
+
+/**
+ * 郵件服務實作。
+ *
+ * 寄信是 @Async，透過同時產生的 EmailAsyncConfig 裡定義的 mailExecutor 執行緒池送出， 呼叫端不會被阻塞；失敗只記
+ * log，不往外拋，避免寄信失敗連帶讓主流程 rollback。 這個行為跟寄信本身該不該擋住主流程有關，如果你的情境是「寄信失敗要讓操作失敗」，
+ * 請不要照抄這個 catch-and-log 寫法。
+ */
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class EmailServiceImpl implements EmailService {
+
+    private final JavaMailSender mailSender;
+    private final SpringTemplateEngine templateEngine;
+
+    @Override
+    @Async("mailExecutor")
+    public void send(String to, String subject, String templateName, Map<String, Object> variables) {
+        try {
+            Context context = new Context();
+            context.setVariables(variables);
+            String html = templateEngine.process("email/" + templateName, context);
+
+            MimeMessage message = mailSender.createMimeMessage();
+            MimeMessageHelper helper = new MimeMessageHelper(message, true, "UTF-8");
+            helper.setTo(to);
+            helper.setSubject(subject);
+            helper.setText(html, true);
+
+            mailSender.send(message);
+        } catch (Exception e) {
+            log.error("寄信失敗，to={}, template={}, error={}", to, templateName, e.getMessage());
+        }
+    }
+}

package/templates/email/application-yml-block.hbs

@@ -0,0 +1,19 @@
+---
+# --- email（由 birc-generator add 產生，環境變數請放 .env） ---
+# 用 --- 開新的 YAML document，避免跟既有的 spring: 區塊在同一份 document 裡重複 key
+# （SnakeYAML 對同一 document 內重複的 top-level key 是後蓋前，不會自動合併）
+spring:
+  mail:
+    host: ${MAIL_HOST:smtp.gmail.com}
+    port: ${MAIL_PORT:587}
+    username: ${MAIL_USERNAME}
+    password: ${MAIL_PASSWORD}
+    properties:
+      mail:
+        smtp:
+          auth: true
+          starttls:
+            enable: true
+birc:
+  mail:
+    admin-email: ${MAIL_ADMIN_EMAIL:admin@example.com}

package/templates/email/build-gradle-dep.hbs

@@ -0,0 +1,2 @@
+    implementation 'org.springframework.boot:spring-boot-starter-mail'
+    implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'

package/templates/email/sample-template.hbs

@@ -0,0 +1,16 @@
+<!DOCTYPE html>
+<html xmlns:th="http://www.thymeleaf.org">
+<head>
+    <meta charset="UTF-8" />
+    <title th:text="${subject}">通知信</title>
+</head>
+<body style="font-family: sans-serif; line-height: 1.6;">
+    <p th:text="${greeting} ?: '您好，'"></p>
+    <p>
+        這是 birc-generator 產生的範例模板，實際內容請自行修改。
+        變數用 Thymeleaf 語法帶入，例如 <code>th:text="${activityName}"</code>。
+    </p>
+    <hr />
+    <p style="color: #888; font-size: 12px;">此為系統自動發送信件，請勿直接回覆。</p>
+</body>
+</html>

package/templates/entity.hbs

@@ -0,0 +1,46 @@
+package {{entityPackage}};
+
+{{#each entityImports}}
+import {{this}};
+{{/each}}
+import jakarta.persistence.Entity;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+{{#if withExample}}
+import jakarta.persistence.Column;
+{{/if}}
+import jakarta.persistence.Table;
+{{#if withSoftDelete}}
+import org.hibernate.annotations.SoftDelete;
+import org.hibernate.annotations.SoftDeleteType;
+{{/if}}
+import lombok.Getter;
+import lombok.Setter;
+
+@Entity
+{{#if withSoftDelete}}
+@SoftDelete(columnName = "deleted_at", strategy = SoftDeleteType.TIMESTAMP)
+{{/if}}
+@Table(name = "{{snakeCase entityName}}")
+@Getter
+@Setter
+public class {{pascalCase entityName}} {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+{{#if withExample}}
+{{#each makeFields}}
+
+    @Column(name = "{{this.snakeName}}")
+    private {{this.type}} {{this.name}};
+{{/each}}
+
+    @Column(name = "created_at", insertable = false, updatable = false)
+    private LocalDateTime createdAt;
+
+    @Column(name = "updated_at", insertable = false, updatable = false)
+    private LocalDateTime updatedAt;
+{{/if}}
+}

package/templates/exception/ExceptionHandleController.hbs

@@ -0,0 +1,16 @@
+package {{basePackage}}.controller;
+
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.ExceptionHandler;
+import org.springframework.web.bind.annotation.RestControllerAdvice;
+import {{basePackage}}.exception.ProjectException;
+import {{basePackage}}.web.Result;
+
+@RestControllerAdvice
+public class ExceptionHandleController {
+
+    @ExceptionHandler(ProjectException.class)
+    public ResponseEntity<Result<Void>> handleProjectException(ProjectException e) {
+        return ResponseEntity.status(e.getHttpStatus()).body(Result.failure(e.getErrorCode(), e.getMessage()));
+    }
+}