init

backend/common/common-web/pom.xml

@@ -0,0 +1,34 @@
+<?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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>com.k12study</groupId>
+        <artifactId>k12study-backend</artifactId>
+        <version>0.1.0-SNAPSHOT</version>
+        <relativePath>../../pom.xml</relativePath>
+    </parent>
+    <artifactId>common-web</artifactId>
+    <dependencies>
+        <dependency>
+            <groupId>com.k12study</groupId>
+            <artifactId>common-api</artifactId>
+            <version>${project.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>com.k12study</groupId>
+            <artifactId>common-core</artifactId>
+            <version>${project.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>com.k12study</groupId>
+            <artifactId>common-security</artifactId>
+            <version>${project.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+        </dependency>
+    </dependencies>
+</project>

backend/common/common-web/src/main/java/com/k12study/common/web/config/CommonWebMvcConfiguration.java

@@ -0,0 +1,40 @@
+package com.k12study.common.web.config;
+
+import com.k12study.common.core.constants.SecurityConstants;
+import com.k12study.common.core.utils.TraceIdHolder;
+import com.k12study.common.security.context.RequestUserContext;
+import com.k12study.common.security.context.RequestUserContextHolder;
+import jakarta.servlet.FilterChain;
+import jakarta.servlet.ServletException;
+import jakarta.servlet.http.HttpServletRequest;
+import jakarta.servlet.http.HttpServletResponse;
+import java.io.IOException;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.web.filter.OncePerRequestFilter;
+
+@Configuration
+public class CommonWebMvcConfiguration extends OncePerRequestFilter {
+
+    @Override
+    protected void doFilterInternal(HttpServletRequest request,
+                                    HttpServletResponse response,
+                                    FilterChain filterChain) throws ServletException, IOException {
+        try {
+            String traceId = request.getHeader(SecurityConstants.TRACE_ID);
+            TraceIdHolder.set(traceId == null || traceId.isBlank() ? TraceIdHolder.getOrCreate() : traceId);
+
+            RequestUserContextHolder.set(new RequestUserContext(
+                    request.getHeader(SecurityConstants.HEADER_USER_ID),
+                    request.getHeader(SecurityConstants.HEADER_USERNAME),
+                    request.getHeader(SecurityConstants.HEADER_DISPLAY_NAME),
+                    request.getHeader(SecurityConstants.HEADER_TENANT_ID),
+                    request.getHeader(SecurityConstants.HEADER_DEPT_ID)
+            ));
+            response.setHeader(SecurityConstants.TRACE_ID, TraceIdHolder.getOrCreate());
+            filterChain.doFilter(request, response);
+        } finally {
+            TraceIdHolder.clear();
+            RequestUserContextHolder.clear();
+        }
+    }
+}

backend/common/common-web/src/main/java/com/k12study/common/web/exception/BizException.java

@@ -0,0 +1,14 @@
+package com.k12study.common.web.exception;
+
+public class BizException extends RuntimeException {
+    private final int code;
+
+    public BizException(int code, String message) {
+        super(message);
+        this.code = code;
+    }
+
+    public int getCode() {
+        return code;
+    }
+}

backend/common/common-web/src/main/java/com/k12study/common/web/exception/GlobalExceptionHandler.java

@@ -0,0 +1,19 @@
+package com.k12study.common.web.exception;
+
+import com.k12study.common.api.response.ApiResponse;
+import org.springframework.web.bind.annotation.ExceptionHandler;
+import org.springframework.web.bind.annotation.RestControllerAdvice;
+
+@RestControllerAdvice
+public class GlobalExceptionHandler {
+
+    @ExceptionHandler(BizException.class)
+    public ApiResponse<Void> handleBizException(BizException exception) {
+        return ApiResponse.failure(exception.getCode(), exception.getMessage());
+    }
+
+    @ExceptionHandler(Exception.class)
+    public ApiResponse<Void> handleException(Exception exception) {
+        return ApiResponse.failure(500, exception.getMessage());
+    }
+}