Merge branch 'main' of https://demo.stam.kr/leejisun9/bio_backend

Reviewed-on: #3

.gitignore

@@ -39,8 +39,12 @@ jacoco.exec
 .classpath
 .settings/
 bin/
+.metadata/
 
 # Temporary files created by the OS
 .DS_Store
 Thumbs.db
 /nginx-1.28.0/logs/nginx.pid
+
+# Upload files
+uploads/

Dockerfile

@@ -1,25 +0,0 @@
-# ./my-spring-app/Dockerfile
-
-# 공식 OpenJDK 이미지를 기반으로 사용
-FROM openjdk:17-jdk-slim
-
-# 컨테이너의 작업 디렉터리를 설정
-WORKDIR /app
-
-# Gradle Wrapper와 빌드 파일을 컨테이너에 복사
-COPY gradlew .
-COPY gradle ./gradle
-
-# 프로젝트 설정 파일들을 복사
-COPY build.gradle .
-COPY settings.gradle .
-
-# 의존성을 미리 다운로드
-RUN ./gradlew dependencies
-
-# 소스 파일들을 복사
-COPY src ./src
-
-# Gradle Wrapper를 사용하여 애플리케이션을 실행
-# 이 명령어는 docker-compose.yml에서 개발용 명령으로 덮어쓸 것입니다.
-CMD ["./gradlew", "bootRun"]

README.md

@@ -10,6 +10,28 @@
 - **Container**: Docker + Kubernetes
 - **API Documentation**: Swagger (SpringDoc OpenAPI)
 
+## 개발 환경 설정
+
+### Eclipse/STS 사용 시 필수 설정
+
+**Annotation Processing 설정이 필요합니다.**
+
+STS에서 프로젝트를 열었을 때 컴파일 오류가 발생하는 경우, 다음 설정을 확인하세요:
+
+1. **프로젝트 우클릭** → **Properties** 선택
+2. **Java Compiler** → **Annotation Processing** 선택
+3. 다음 설정을 확인/적용:
+   - **Enable project specific settings** 체크
+   - **Enable annotation processing** 체크
+   - **Enable processing in editor** 체크 해제 (선택사항)
+   - **Generated source directory**: `build/generated/sources/annotationProcessor/java/main`
+   - **Generated test source directory**: `build/generated/sources/annotationProcessor/java/test`
+
+**설정 이유:**
+- MapStruct 매퍼 인터페이스의 구현체가 자동 생성됩니다
+- QueryDSL Q클래스들이 자동 생성됩니다
+- 이 설정이 없으면 컴파일 오류가 발생할 수 있습니다
+
 ## 개발 가이드
 
 ### 1. 프로젝트 구조
@@ -17,28 +39,171 @@
 ```
 src/main/java/com/bio/bio_backend/
 ├── domain/                    # 도메인별 패키지
-│   └── user/
+│   └── base/                 # 기본 도메인
 │       └── member/           # 회원 도메인
 │           ├── controller/    # API 엔드포인트
 │           ├── service/       # 비즈니스 로직
 │           ├── repository/    # 데이터 접근
 │           ├── entity/        # JPA 엔티티
-│           └── dto/          # 데이터 전송 객체
+│           ├── dto/          # 데이터 전송 객체
+│           ├── mapper/       # MapStruct 매퍼
+│           └── enums/        # 도메인 열거형
 ├── global/                    # 공통 설정
 │   ├── config/               # 설정 클래스
 │   ├── security/             # 보안 설정
 │   ├── exception/            # 예외 처리
-│   └── utils/                # 유틸리티
+│   ├── aop/                  # AOP 로깅
-└── BioBackendApplication.java
+│   ├── filter/               # HTTP 로깅 필터
+│   ├── utils/                # 유틸리티
+│   ├── constants/            # 상수 정의
+│   ├── dto/                  # 공통 DTO
+│   ├── entity/               # 공통 엔티티
+│   └── annotation/           # 커스텀 어노테이션
+├── BioBackendApplication.java
+└── ServletInitializer.java
 ```
 
-### 2. API 문서화 (Swagger)
+### 2. API 응답 표준화 (ApiResponseDto)
+
+#### 응답 구조
+
+모든 API 응답은 `ApiResponseDto<T>` 형태로 표준화되어 있습니다.
+
+```java
+public class ApiResponseDto<T> {
+    private boolean success;    // 성공/실패 여부 (true/false)
+    private int code;           // HTTP 상태 코드
+    private String message;     // 응답 메시지 (ApiResponseCode enum 값)
+    private String description; // 응답 설명
+    private T data;            // 실제 데이터 (제네릭 타입)
+}
+```
+
+#### 응답 예시
+
+**성공 응답 (201 Created)**
+
+```json
+{
+  "success": true,
+  "code": 201,
+  "message": "COMMON_SUCCESS_CREATED",
+  "description": "성공적으로 생성되었습니다",
+  "data": {
+    "seq": 1,
+    "userId": "user123",
+    "name": "홍길동"
+  }
+}
+```
+
+**실패 응답 (409 Conflict)**
+
+```json
+{
+  "success": false,
+  "code": 409,
+  "message": "USER_ID_DUPLICATE",
+  "description": "이미 존재하는 사용자 ID입니다"
+}
+```
+
+#### 사용 방법
+
+**Controller에서 응답 생성**
+
+```java
+@PostMapping("/members")
+public ResponseEntity<ApiResponseDto<CreateMemberResponseDto>> createMember(@RequestBody CreateMemberRequestDto requestDto) {
+    // ... 비즈니스 로직 ...
+
+    // 성공 응답
+    ApiResponseDto<CreateMemberResponseDto> apiResponse =
+        ApiResponseDto.success(ApiResponseCode.COMMON_SUCCESS_CREATED, responseDto);
+
+    return ResponseEntity.status(HttpStatus.CREATED).body(apiResponse);
+}
+```
+
+**공용 응답 코드 사용**
+
+```java
+// ApiResponseCode.java
+public enum ApiResponseCode {
+    // 공용 성공 코드
+    COMMON_SUCCESS(HttpStatus.OK.value(), "요청 성공"),
+    COMMON_SUCCESS_CREATED(HttpStatus.CREATED.value(), "성공적으로 생성되었습니다"),
+    COMMON_SUCCESS_UPDATED(HttpStatus.OK.value(), "성공적으로 수정되었습니다"),
+    COMMON_SUCCESS_DELETED(HttpStatus.OK.value(), "성공적으로 삭제되었습니다"),
+    COMMON_SUCCESS_RETRIEVED(HttpStatus.OK.value(), "성공적으로 조회되었습니다"),
+
+    // 공용 오류 코드
+    COMMON_BAD_REQUEST(HttpStatus.BAD_REQUEST.value(), "필수 요청 본문이 누락되었거나 오류가 발생했습니다"),
+    COMMON_UNAUTHORIZED(HttpStatus.UNAUTHORIZED.value(), "인증에 실패했습니다"),
+    COMMON_FORBIDDEN(HttpStatus.FORBIDDEN.value(), "접근이 거부되었습니다"),
+    COMMON_NOT_FOUND(HttpStatus.NOT_FOUND.value(), "리소스를 찾을 수 없습니다"),
+    COMMON_CONFLICT(HttpStatus.CONFLICT.value(), "충돌이 발생했습니다"),
+    COMMON_INTERNAL_SERVER_ERROR(HttpStatus.INTERNAL_SERVER_ERROR.value(), "서버에서 오류가 발생했습니다"),
+
+    // 사용자 관련 코드
+    USER_ID_DUPLICATE(HttpStatus.CONFLICT.value(), "이미 존재하는 사용자 ID입니다"),
+    USER_NOT_FOUND(HttpStatus.UNAUTHORIZED.value(), "사용자를 찾을 수 없습니다. 인증에 실패했습니다"),
+    USER_PASSWORD_INVALID(HttpStatus.UNAUTHORIZED.value(), "비밀번호가 올바르지 않습니다")
+}
+```
+
+#### 핵심 규칙
+
+- **모든 API 응답**: `ApiResponseDto<T>`로 감싸서 반환
+- **공용 응답 코드**: `COMMON_` 접두사로 시작하는 범용 코드 사용
+- **일관된 구조**: `success`, `code`, `message`, `description`, `data` 필드로 표준화
+- **성공/실패 구분**: `success` 필드로 명확한 성공/실패 여부 전달
+- **제네릭 활용**: `<T>`를 통해 다양한 데이터 타입 지원
+
+### 3. JWT 인증 시스템
+
+#### 토큰 구성
+
+- **Access Token** - 쿠키에 저장, 자동 갱신
+- **Refresh Token** - 쿠키에 저장, 자동 갱신
+
+#### 자동 토큰 갱신
+
+**모든 API 요청마다 자동으로 처리됩니다:**
+
+1. **Access Token 유효**: 정상 요청 처리
+2. **Access Token 만료**: Refresh Token으로 자동 갱신
+3. **새 Access Token 발급**: 응답 헤더에 자동 설정
+4. **Refresh Token 갱신**: 보안을 위해 매번 새로운 토큰 발급
+
+#### 주요 컴포넌트
+
+- **`JwtTokenIssuanceFilter`**: 로그인 시 토큰 발급
+- **`JwtTokenValidationFilter`**: 요청마다 토큰 검증 및 갱신
+- **`JwtUtils`**: 토큰 생성, 검증, 갱신 유틸리티
+
+### 4. API 문서화 (Swagger)
 
 #### Swagger UI 접속
 
 - **URL**: `http://localhost:8080/service/swagger-ui.html`
 - **API Docs**: `http://localhost:8080/service/api-docs`
 
+### 5. 시스템 모니터링 (Actuator)
+
+#### Health 체크
+
+- **기본 Health**: `http://localhost:8080/service/actuator/health`
+- **Readiness Probe**: `http://localhost:8080/service/actuator/health/readiness`
+- **Liveness Probe**: `http://localhost:8080/service/actuator/health/liveness`
+
+#### 시스템 정보
+
+- **애플리케이션 정보**: `http://localhost:8080/service/actuator/info`
+- **환경 설정**: `http://localhost:8080/service/actuator/env`
+- **설정 속성**: `http://localhost:8080/service/actuator/configprops`
+- **메트릭**: `http://localhost:8080/service/actuator/metrics`
+
 #### 주요 어노테이션
 
 ```java
@@ -46,7 +211,8 @@ src/main/java/com/bio/bio_backend/
 @Operation(summary = "회원 가입", description = "새로운 회원을 등록합니다.")
 @ApiResponses(value = {
     @ApiResponse(responseCode = "201", description = "회원 가입 성공"),
-    @ApiResponse(responseCode = "400", description = "잘못된 요청 데이터")
+    @ApiResponse(responseCode = "400", description = "잘못된 요청 데이터", content = @Content),
+    @ApiResponse(responseCode = "409", description = "중복된 사용자 정보", content = @Content)
 })
 ```
 
@@ -55,7 +221,7 @@ src/main/java/com/bio/bio_backend/
 - **SwaggerConfig.java**: OpenAPI 기본 정보 설정
 - **application.properties**: Swagger UI 커스터마이징
 
-### 3. 트랜잭션 관리
+### 6. 트랜잭션 관리
 
 #### 기본 설정
 
@@ -79,14 +245,14 @@ public class MemberServiceImpl {
 - **메서드별**: 데이터 수정 시에만 `@Transactional` 개별 적용
 - **설정**: `spring.jpa.open-in-view=false` (성능 최적화)
 
-### 4. 오류 등록 및 사용
+### 7. 오류 등록 및 사용
 
 #### 오류 코드 등록
 
 ```java
 // ApiResponseCode.java
 public enum ApiResponseCode {
-    USER_ID_DUPLICATE("400", "이미 존재하는 사용자 ID입니다."),
+    USER_ID_DUPLICATE(HttpStatus.CONFLICT.value(), "User ID already exists"),
 }
 ```
 
@@ -105,3 +271,150 @@ throw new ApiException(ApiResponseCode.USER_ID_DUPLICATE);
 - **오류 코드**: `ApiResponseCode` enum에 모든 오류 정의
 - **예외 클래스**: `ApiException`으로 비즈니스 로직 예외 처리
 - **자동 처리**: `GlobalExceptionHandler`가 일관된 응답 형태로 변환
+
+### 8. 로깅 시스템
+
+#### @LogExecution 어노테이션 사용법
+
+**메서드 실행 로깅을 위한 필수 어노테이션입니다.**
+
+##### 기본 사용법
+
+```java
+@LogExecution("회원 등록")
+@PostMapping("/register")
+public ResponseEntity<ApiResponseDto<CreateMemberResponseDto>> createMember(@RequestBody CreateMemberRequestDto requestDto) {
+    // 메서드 실행 시 자동으로 로그 출력
+}
+```
+
+##### 로그 출력 예시
+
+**메서드 시작 시:**
+
+```
+[START] 회원 등록 | 호출경로: MemberController.createMember | 사용자: 고명빈(kmbin92)
+```
+
+**메서드 성공 시:**
+
+```
+[SUCCESS] 회원 등록 | 호출경로: MemberController.createMember | 사용자: 고명빈(kmbin92) | 시간: 200ms
+```
+
+**메서드 실패 시:**
+
+```
+[FAILED] 회원 등록 | 호출경로: MemberController.createMember | 사용자: 고명빈(kmbin92) | 시간: 23ms | 오류: 이미 존재하는 사용자 ID입니다
+```
+
+##### 어노테이션 설정
+
+```java
+@LogExecution("사용자 정보 조회")
+public UserDto getUserInfo() { }
+
+@LogExecution("주문 처리")
+public OrderDto processOrder() { }
+```
+
+##### 로깅 시스템 구성
+
+1. **MethodExecutionLoggingAspect**: 메서드 실행 로깅 (AOP)
+2. **HttpLoggingFilter**: HTTP 요청/응답 로깅 (필터)
+3. **logback-spring.xml**: 로그 파일 관리 및 설정
+
+**중요**: `@LogExecution` 어노테이션이 없으면 메서드 실행 로그가 출력되지 않습니다
+
+### 9. MapStruct
+
+**매퍼 인터페이스**
+
+```java
+@Mapper(componentModel = "spring")
+public interface MemberMapper {
+    MemberDto toDto(Member member);
+    Member toEntity(MemberDto dto);
+}
+```
+
+**사용 예시**
+
+```java
+// Entity → DTO
+MemberDto dto = memberMapper.toDto(member);
+
+// DTO → Entity
+Member entity = memberMapper.toEntity(dto);
+```
+
+**자동 생성**: 컴파일 시 `MemberMapperImpl` 구현체 생성
+
+### 10. BaseEntity 상속
+
+**모든 엔티티는 `BaseEntity` 상속을 원칙으로 합니다.**
+
+#### 자동 생성 필드
+
+- **OID**: `@PrePersist`에서 자동 생성 (고유 식별자)
+- **생성일시**: `@CreatedDate`로 자동 설정
+- **수정일시**: `@LastModifiedDate`로 자동 갱신
+- **생성자/수정자 OID**: 사용자 추적용
+
+#### 사용 예시
+
+```java
+@Entity
+@Table(name = "st_members")
+public class Member extends BaseEntity {
+    // OID, 생성일시, 수정일시 등이 자동으로 관리됨
+    private String userId;
+    private String name;
+}
+```
+
+### 11. DTO 네이밍 규칙
+
+#### 기본 원칙
+
+- **API 계층**: `Dto` 접미사 유지
+- **Service 계층**: 역할에 따라 `Dto` 접미사 결정
+
+#### 사용 예시
+
+```java
+// API 계층 (Dto 유지)
+CreateMemberRequestDto, GetMemberResponseDto
+
+// Service 계층 - 비즈니스 핵심 (Dto 유지)
+MemberDto
+
+// Service 계층 - 내부 전달 (Dto 제거)
+MemberSearchCondition
+```
+
+#### 핵심 규칙
+
+- **API 노출**: `Dto` 유지
+- **비즈니스 핵심**: `Dto` 유지
+- **내부 전달**: `Dto` 제거
+
+### 12. 데이터베이스 스키마
+
+**데이터베이스 테이블 구조는 `ddl/schema_entity.sql`에 정의되어 있습니다.**
+
+#### 스키마 파일
+
+- **위치**: `ddl/schema_entity.sql`
+- **내용**: 모든 엔티티 테이블의 CREATE TABLE DDL 스크립트
+
+#### 초기화 스크립트
+
+- **위치**: `src/main/resources/schema_initial.sql`
+- **내용**: 서버 부팅 시 자동 실행되는 초기화 스크립트 (예: shedlock 테이블 등)
+
+#### 사용 방법
+
+- **자동 생성**: 애플리케이션 시작 시 `schema_entity.sql`로 엔티티 테이블 자동 생성
+- **초기화**: 서버 부팅 시 `schema_initial.sql`로 시스템 테이블 자동 생성
+- **설정**: `spring.jpa.hibernate.ddl-auto=none`으로 Hibernate 자동 스키마 생성 비활성화

build.gradle

@@ -2,6 +2,7 @@ plugins {
 	id 'java'
 	id 'org.springframework.boot' version '3.5.4'
 	id 'io.spring.dependency-management' version '1.1.7'
+	id 'com.google.cloud.tools.jib' version '3.4.0' // Jib 플러그인 추가
 }
 
 group = 'com.bio'
@@ -26,6 +27,7 @@ repositories {
 dependencies {
     developmentOnly 'org.springframework.boot:spring-boot-devtools'
 	implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
+
 	// PostgreSQL JDBC
     runtimeOnly 'org.postgresql:postgresql'
 	implementation 'org.springframework.boot:spring-boot-starter-web'
@@ -36,6 +38,9 @@ dependencies {
 	// Validation
 	implementation 'org.springframework.boot:spring-boot-starter-validation'
 	
+	// Spring Boot Actuator
+	implementation 'org.springframework.boot:spring-boot-starter-actuator'
+	
 	// MapStruct
 	implementation 'org.mapstruct:mapstruct:1.5.5.Final'
 	annotationProcessor 'org.mapstruct:mapstruct-processor:1.5.5.Final'
@@ -43,8 +48,12 @@ dependencies {
 	// MyBatis
 	implementation 'org.mybatis.spring.boot:mybatis-spring-boot-starter:3.0.3'
 
+	implementation 'org.springframework.boot:spring-boot-starter-actuator'
+	
 	// jwt
 	implementation 'io.jsonwebtoken:jjwt-api:0.12.5'
+	runtimeOnly 'io.jsonwebtoken:jjwt-impl:0.12.5'
+	runtimeOnly 'io.jsonwebtoken:jjwt-jackson:0.12.5'
 
 	// lombok
 	compileOnly 'org.projectlombok:lombok'
@@ -53,28 +62,68 @@ dependencies {
 	testImplementation 'org.springframework.boot:spring-boot-starter-test'
 	testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
 
-	// querydsl
+	// QueryDSL
 	implementation 'io.github.openfeign.querydsl:querydsl-jpa:6.11'
 	annotationProcessor 'io.github.openfeign.querydsl:querydsl-apt:6.11:jpa'
 	annotationProcessor 'jakarta.annotation:jakarta.annotation-api'
 	annotationProcessor 'jakarta.persistence:jakarta.persistence-api'
 
 	// p6spy
-	implementation 'com.github.gavlyukovskiy:p6spy-spring-boot-starter:1.9.0'
+	implementation 'com.github.gavlyukovskiy:p6spy-spring-boot-starter:1.12.0'
 	
 	// SpringDoc OpenAPI (Swagger)
 	implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.8.9'
+	
+	// ShedLock for distributed scheduling
+	implementation 'net.javacrumbs.shedlock:shedlock-spring:5.10.2'
+	implementation 'net.javacrumbs.shedlock:shedlock-provider-jdbc-template:5.10.2'
 }
 
 tasks.named('test') {
 	useJUnitPlatform()
 }
 
-// querydsl
+// annotationProcessor(QueryDSL, MapStruct)
-def generatedSrcDir = 'build/generated/sources/annotation-processor'
+// * Annotation Processing 설정이 필요한경우 "build/generated/sources/annotationProcessor/java/main" 경로 등록
+def generatedSrcDir = layout.buildDirectory.dir("generated/sources/annotationProcessor/java/main").get().asFile
+
 clean {
 	delete file(generatedSrcDir)
 }
 tasks.withType(JavaCompile).configureEach {
-	options.generatedSourceOutputDirectory = file(generatedSrcDir)
+	options.annotationProcessorGeneratedSourcesDirectory = file(generatedSrcDir)
+}
+
+jib {
+  from {
+    image = 'demo.stam.kr/leejisun9/eclipse-temurin:17-jre'     // 가벼운 JRE 베이스
+    // (선택) 인증서 추가/회사 CA 필요 시 extraDirectories 사용
+  }
+  to {
+    image = 'demo.stam.kr/leejisun9/bio-backend'; //tags = ['1.0.0']  // 기본 대상 레지스트리
+    // tags는 skaffold가 자동 주입. 로컬 단독 빌드시 -Djib.to.tags=로 지정 가능
+  }
+  container {
+    // Spring Boot 컨테이너 런타임 옵션
+    ports = ['8080']
+    jvmFlags = [
+      '-XX:+UseContainerSupport',
+      '-Dserver.port=8080',
+      '-XX:InitialRAMPercentage=50.0',
+      '-XX:MaxRAMPercentage=75.0'
+    ]
+    environment = [ 'SPRING_PROFILES_ACTIVE': 'dev' ]
+    // (선택) non-root 권장 (권한 필요한 리소스 없는 경우)
+    // user = '65532:65532'
+    // workingDirectory = '/app'
+  }
+  // (선택) 계층 최적화/추가 파일
+  // extraDirectories {
+  //   paths {
+  //     path {
+  //       from = file('docker/extra')   // 예: CA cert, 설정 템플릿
+  //       into = '/opt/extra'
+  //     }
+  //   }
+  // }
 }

ddl/schema.sql

@@ -1,18 +0,0 @@
-
-    create table st_member (
-        use_flag boolean not null,
-        created_at timestamp(6) not null,
-        created_oid bigint,
-        last_login_at timestamp(6),
-        oid bigint not null,
-        updated_at timestamp(6) not null,
-        updated_oid bigint,
-        role varchar(40) not null check (role in ('MEMBER','ADMIN','USER','SYSTEM_ADMIN')),
-        password varchar(100) not null,
-        user_id varchar(100) not null,
-        refresh_token varchar(200),
-        primary key (oid)
-    );
-
-    create index idx_member_user_id 
-       on st_member (user_id);

ddl/schema_entity.sql

@@ -0,0 +1,291 @@
+
+    create table st_common_code (
+        sort_order integer not null,
+        use_flag boolean not null,
+        created_at timestamp(6) not null,
+        created_oid bigint,
+        oid bigint not null,
+        updated_at timestamp(6) not null,
+        updated_oid bigint,
+        code varchar(50) not null unique,
+        group_code varchar(50) not null,
+        parent_code varchar(50),
+        character_ref1 varchar(100),
+        character_ref2 varchar(100),
+        character_ref3 varchar(100),
+        character_ref4 varchar(100),
+        character_ref5 varchar(100),
+        name varchar(100) not null,
+        description varchar(500),
+        created_id varchar(255),
+        updated_id varchar(255),
+        primary key (oid)
+    );
+
+    comment on column st_common_code.sort_order is
+        '정렬 순번';
+
+    comment on column st_common_code.use_flag is
+        '사용 여부';
+
+    comment on column st_common_code.created_at is
+        '생성일시';
+
+    comment on column st_common_code.created_oid is
+        '생성자 OID';
+
+    comment on column st_common_code.oid is
+        'OID';
+
+    comment on column st_common_code.updated_at is
+        '수정일시';
+
+    comment on column st_common_code.updated_oid is
+        '수정자 OID';
+
+    comment on column st_common_code.code is
+        '코드';
+
+    comment on column st_common_code.group_code is
+        '그룹 코드';
+
+    comment on column st_common_code.parent_code is
+        '부모 코드';
+
+    comment on column st_common_code.character_ref1 is
+        '문자 참조1';
+
+    comment on column st_common_code.character_ref2 is
+        '문자 참조2';
+
+    comment on column st_common_code.character_ref3 is
+        '문자 참조3';
+
+    comment on column st_common_code.character_ref4 is
+        '문자 참조4';
+
+    comment on column st_common_code.character_ref5 is
+        '문자 참조5';
+
+    comment on column st_common_code.name is
+        '코드명';
+
+    comment on column st_common_code.description is
+        '설명';
+
+    comment on column st_common_code.created_id is
+        '생성자 ID';
+
+    comment on column st_common_code.updated_id is
+        '수정자 ID';
+
+    create table st_common_group_code (
+        sort_order integer not null,
+        use_flag boolean not null,
+        created_at timestamp(6) not null,
+        created_oid bigint,
+        oid bigint not null,
+        updated_at timestamp(6) not null,
+        updated_oid bigint,
+        code varchar(50) not null unique,
+        character_ref1_title varchar(100),
+        character_ref2_title varchar(100),
+        character_ref3_title varchar(100),
+        character_ref4_title varchar(100),
+        character_ref5_title varchar(100),
+        name varchar(100) not null,
+        created_id varchar(255),
+        updated_id varchar(255),
+        primary key (oid)
+    );
+
+    comment on column st_common_group_code.sort_order is
+        '정렬 순번';
+
+    comment on column st_common_group_code.use_flag is
+        '사용 여부';
+
+    comment on column st_common_group_code.created_at is
+        '생성일시';
+
+    comment on column st_common_group_code.created_oid is
+        '생성자 OID';
+
+    comment on column st_common_group_code.oid is
+        'OID';
+
+    comment on column st_common_group_code.updated_at is
+        '수정일시';
+
+    comment on column st_common_group_code.updated_oid is
+        '수정자 OID';
+
+    comment on column st_common_group_code.code is
+        '코드';
+
+    comment on column st_common_group_code.character_ref1_title is
+        '문자 참조 타이틀1';
+
+    comment on column st_common_group_code.character_ref2_title is
+        '문자 참조 타이틀2';
+
+    comment on column st_common_group_code.character_ref3_title is
+        '문자 참조 타이틀3';
+
+    comment on column st_common_group_code.character_ref4_title is
+        '문자 참조 타이틀4';
+
+    comment on column st_common_group_code.character_ref5_title is
+        '문자 참조 타이틀5';
+
+    comment on column st_common_group_code.name is
+        '코드명';
+
+    comment on column st_common_group_code.created_id is
+        '생성자 ID';
+
+    comment on column st_common_group_code.updated_id is
+        '수정자 ID';
+
+    create table st_file (
+        use_flag boolean not null,
+        created_at timestamp(6) not null,
+        created_oid bigint,
+        file_size bigint not null,
+        group_oid bigint,
+        oid bigint not null,
+        updated_at timestamp(6) not null,
+        updated_oid bigint,
+        content_type varchar(255) not null,
+        created_id varchar(255),
+        description varchar(255),
+        file_path varchar(255) not null,
+        original_file_name varchar(255) not null,
+        stored_file_name varchar(255) not null,
+        updated_id varchar(255),
+        primary key (oid)
+    );
+
+    comment on column st_file.use_flag is
+        '사용 여부';
+
+    comment on column st_file.created_at is
+        '생성일시';
+
+    comment on column st_file.created_oid is
+        '생성자 OID';
+
+    comment on column st_file.file_size is
+        '파일 크기';
+
+    comment on column st_file.group_oid is
+        '그룹 OID';
+
+    comment on column st_file.oid is
+        'OID';
+
+    comment on column st_file.updated_at is
+        '수정일시';
+
+    comment on column st_file.updated_oid is
+        '수정자 OID';
+
+    comment on column st_file.content_type is
+        '콘텐츠 타입';
+
+    comment on column st_file.created_id is
+        '생성자 ID';
+
+    comment on column st_file.description is
+        '설명';
+
+    comment on column st_file.file_path is
+        '파일 경로';
+
+    comment on column st_file.original_file_name is
+        '원본 파일명';
+
+    comment on column st_file.stored_file_name is
+        '저장 파일명';
+
+    comment on column st_file.updated_id is
+        '수정자 ID';
+
+    create table st_member (
+        use_flag boolean not null,
+        created_at timestamp(6) not null,
+        created_oid bigint,
+        last_login_at timestamp(6),
+        oid bigint not null,
+        updated_at timestamp(6) not null,
+        updated_oid bigint,
+        login_ip varchar(45),
+        name varchar(100) not null,
+        password varchar(100) not null,
+        user_id varchar(100) not null,
+        refresh_token varchar(1024),
+        created_id varchar(255),
+        email varchar(255) not null,
+        updated_id varchar(255),
+        primary key (oid)
+    );
+
+    comment on column st_member.use_flag is
+        '사용 여부';
+
+    comment on column st_member.created_at is
+        '생성일시';
+
+    comment on column st_member.created_oid is
+        '생성자 OID';
+
+    comment on column st_member.last_login_at is
+        '마지막 로그인 일시';
+
+    comment on column st_member.oid is
+        'OID';
+
+    comment on column st_member.updated_at is
+        '수정일시';
+
+    comment on column st_member.updated_oid is
+        '수정자 OID';
+
+    comment on column st_member.login_ip is
+        '로그인 IP';
+
+    comment on column st_member.name is
+        '이름';
+
+    comment on column st_member.password is
+        '비밀번호';
+
+    comment on column st_member.user_id is
+        '사용자 ID';
+
+    comment on column st_member.refresh_token is
+        '리프레시 토큰';
+
+    comment on column st_member.created_id is
+        '생성자 ID';
+
+    comment on column st_member.email is
+        '이메일';
+
+    comment on column st_member.updated_id is
+        '수정자 ID';
+
+    create index idx_common_code_code 
+       on st_common_code (code);
+
+    create index idx_common_code_group_code 
+       on st_common_code (group_code);
+
+    create index idx_common_code_parent_code 
+       on st_common_code (parent_code);
+
+    create index idx_common_group_code_code 
+       on st_common_group_code (code);
+
+    create index idx_member_user_id 
+       on st_member (user_id);

k8s/deployment.yaml

@@ -1,21 +0,0 @@
-apiVersion: apps/v1
-kind: Deployment
-metadata:
-  name: bio-backend-deployment
-  labels:
-    app: bio-backend
-spec:
-  replicas: 1
-  selector:
-    matchLabels:
-      app: bio-backend
-  template:
-    metadata:
-      labels:
-        app: bio-backend
-    spec:
-      containers:
-      - name: bio-backend
-        image: backend-0.0.1:latest # 여기에 Skaffold가 빌드할 이미지 이름을 사용합니다.
-        ports:
-        - containerPort: 8081

nginx-1.28.0/conf/nginx.conf

@@ -4,6 +4,7 @@ events {
 }
 
 http {
+
     include mime.types;
     default_type application/octet-stream;
     sendfile on;
@@ -30,6 +31,7 @@ http {
             proxy_set_header X-Real-IP $remote_addr;
             proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
             proxy_http_version 1.1;
+            proxy_set_header X-Forwarded-Proto $scheme;
             proxy_set_header Upgrade $http_upgrade;
             proxy_set_header Connection $connection_upgrade;
         }
@@ -40,6 +42,7 @@ http {
             proxy_set_header Host $host;
             proxy_set_header X-Real-IP $remote_addr;
             proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+            proxy_set_header X-Forwarded-Proto $scheme;
         }
 
         # (선택) 업로드 크게 받을 때

skaffold.yaml

@@ -1,12 +0,0 @@
-apiVersion: skaffold/v4beta13
-kind: Config
-metadata:
-  name: bio-backend
-build:
-  artifacts:
-    - image: backend-0.0.1
-      docker:
-        dockerfile: Dockerfile
-manifests:
-  rawYaml:
-    - k8s/deployment.yaml

src/main/java/com/bio/bio_backend/BioBackendApplication.java

@@ -2,10 +2,12 @@ package com.bio.bio_backend;
 
 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.boot.context.properties.EnableConfigurationProperties;
 import org.springframework.data.jpa.repository.config.EnableJpaAuditing;
 
 @SpringBootApplication
 @EnableJpaAuditing
+@EnableConfigurationProperties
 public class BioBackendApplication {
 
 	public static void main(String[] args) {

src/main/java/com/bio/bio_backend/domain/admin/common_code/controller/CommonCodeController.java

@@ -0,0 +1,208 @@
+package com.bio.bio_backend.domain.admin.common_code.controller;
+
+import com.bio.bio_backend.domain.admin.common_code.dto.*;
+import com.bio.bio_backend.domain.admin.common_code.service.CommonCodeService;
+import com.bio.bio_backend.domain.admin.common_code.mapper.CommonCodeMapper;
+import com.bio.bio_backend.domain.admin.common_code.mapper.CommonGroupCodeMapper;
+import com.bio.bio_backend.global.dto.ApiResponseDto;
+import com.bio.bio_backend.global.constants.ApiResponseCode;
+import com.bio.bio_backend.global.annotation.LogExecution;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.responses.ApiResponses;
+import io.swagger.v3.oas.annotations.media.Content;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.*;
+
+import jakarta.validation.Valid;
+import java.util.List;
+
+@Slf4j
+@RestController
+@RequestMapping("/admin/common-codes")
+@RequiredArgsConstructor
+@Tag(name = "공통 코드 관리", description = "공통 코드 및 그룹 코드 관리 API")
+public class CommonCodeController {
+    
+    private final CommonCodeService commonCodeService;
+    private final CommonCodeMapper commonCodeMapper;
+    private final CommonGroupCodeMapper commonGroupCodeMapper;
+    
+    // 그룹 코드 관련 API
+    @LogExecution("그룹 코드 생성")
+    @Operation(summary = "그룹 코드 생성", description = "새로운 그룹 코드를 생성합니다.")
+    @ApiResponses({
+        @ApiResponse(responseCode = "201", description = "그룹 코드 생성 성공"),
+        @ApiResponse(responseCode = "400", description = "잘못된 요청 데이터", content = @Content),
+        @ApiResponse(responseCode = "409", description = "중복된 그룹 코드", content = @Content)
+    })
+    @PostMapping("/group")
+    public ResponseEntity<ApiResponseDto<CreateCommonGroupCodeResponseDto>> createGroupCode(@RequestBody @Valid CreateCommonGroupCodeRequestDto requestDto) {
+        CommonGroupCodeDto groupCodeDto = commonGroupCodeMapper.toCommonGroupCodeDto(requestDto);
+        CommonGroupCodeDto createdGroupCode = commonCodeService.createGroupCode(groupCodeDto);
+        CreateCommonGroupCodeResponseDto responseDto = commonGroupCodeMapper.toCreateCommonGroupCodeResponseDto(createdGroupCode);
+        ApiResponseDto<CreateCommonGroupCodeResponseDto> apiResponse = ApiResponseDto.success(ApiResponseCode.COMMON_SUCCESS_CREATED, responseDto);
+        
+        return ResponseEntity.status(HttpStatus.CREATED).body(apiResponse);
+    }
+    
+    @LogExecution("그룹 코드 수정")
+    @Operation(summary = "그룹 코드 수정", description = "기존 그룹 코드를 수정합니다.")
+    @ApiResponses({
+        @ApiResponse(responseCode = "200", description = "그룹 코드 수정 성공"),
+        @ApiResponse(responseCode = "400", description = "잘못된 요청 데이터", content = @Content),
+        @ApiResponse(responseCode = "404", description = "그룹 코드를 찾을 수 없음", content = @Content)
+    })
+    @PutMapping("/group/{code}")
+    public ResponseEntity<ApiResponseDto<String>> updateGroupCode(
+            @PathVariable String code, 
+            @RequestBody @Valid UpdateCommonGroupCodeRequestDto requestDto) {
+        CommonGroupCodeDto groupCodeDto = commonGroupCodeMapper.toCommonGroupCodeDto(requestDto);
+        commonCodeService.updateGroupCode(code, groupCodeDto);
+        return ResponseEntity.ok(ApiResponseDto.success(ApiResponseCode.COMMON_SUCCESS_UPDATED));
+    }
+    
+    @LogExecution("그룹 코드 삭제")
+    @Operation(summary = "그룹 코드 삭제", description = "그룹 코드를 삭제합니다.")
+    @ApiResponses({
+        @ApiResponse(responseCode = "200", description = "그룹 코드 삭제 성공"),
+        @ApiResponse(responseCode = "400", description = "하위 공통 코드가 존재하여 삭제할 수 없음", content = @Content),
+        @ApiResponse(responseCode = "404", description = "그룹 코드를 찾을 수 없음", content = @Content)
+    })
+    @DeleteMapping("/group/{code}")
+    public ResponseEntity<ApiResponseDto<Void>> deleteGroupCode(@PathVariable String code) {
+        commonCodeService.deleteGroupCode(code);
+        return ResponseEntity.ok(ApiResponseDto.success(ApiResponseCode.COMMON_SUCCESS_DELETED));
+    }
+    
+    @LogExecution("그룹 코드 조회")
+    @Operation(summary = "그룹 코드 조회", description = "특정 그룹 코드를 조회합니다.")
+    @ApiResponses({
+        @ApiResponse(responseCode = "200", description = "그룹 코드 조회 성공"),
+        @ApiResponse(responseCode = "404", description = "그룹 코드를 찾을 수 없음", content = @Content)
+    })
+    @GetMapping("/group/{code}")
+    public ResponseEntity<ApiResponseDto<CommonGroupCodeDto>> getGroupCode(@PathVariable String code) {
+        CommonGroupCodeDto groupCode = commonCodeService.getGroupCode(code);
+        return ResponseEntity.ok(ApiResponseDto.success(ApiResponseCode.COMMON_SUCCESS_RETRIEVED, groupCode));
+    }
+    
+    @LogExecution("전체 그룹 코드 조회")
+    @Operation(summary = "전체 그룹 코드 조회", description = "모든 그룹 코드를 조회합니다.")
+    @ApiResponses({
+        @ApiResponse(responseCode = "200", description = "전체 그룹 코드 조회 성공")
+    })
+    @GetMapping("/group")
+    public ResponseEntity<ApiResponseDto<List<CommonGroupCodeDto>>> getAllGroupCodes() {
+        List<CommonGroupCodeDto> groupCodes = commonCodeService.getAllGroupCodes();
+        return ResponseEntity.ok(ApiResponseDto.success(ApiResponseCode.COMMON_SUCCESS_RETRIEVED, groupCodes));
+    }
+    
+    @LogExecution("활성 그룹 코드 조회")
+    @Operation(summary = "활성 그룹 코드 조회", description = "사용 중인 그룹 코드만 조회합니다.")
+    @ApiResponses({
+        @ApiResponse(responseCode = "200", description = "활성 그룹 코드 조회 성공")
+    })
+    @GetMapping("/group/active")
+    public ResponseEntity<ApiResponseDto<List<CommonGroupCodeDto>>> getActiveGroupCodes() {
+        List<CommonGroupCodeDto> groupCodes = commonCodeService.getActiveGroupCodes();
+        return ResponseEntity.ok(ApiResponseDto.success(ApiResponseCode.COMMON_SUCCESS_RETRIEVED, groupCodes));
+    }
+    
+    // 공통 코드 관련 API
+    @LogExecution("공통 코드 생성")
+    @Operation(summary = "공통 코드 생성", description = "새로운 공통 코드를 생성합니다.")
+    @ApiResponses({
+        @ApiResponse(responseCode = "201", description = "공통 코드 생성 성공"),
+        @ApiResponse(responseCode = "400", description = "잘못된 요청 데이터", content = @Content),
+        @ApiResponse(responseCode = "409", description = "중복된 공통 코드", content = @Content)
+    })
+    @PostMapping
+    public ResponseEntity<ApiResponseDto<CreateCommonCodeResponseDto>> createCode(@RequestBody @Valid CreateCommonCodeRequestDto requestDto) {
+        CommonCodeDto commonCodeDto = commonCodeMapper.toCommonCodeDto(requestDto);
+        CommonCodeDto createdCommonCode = commonCodeService.createCode(commonCodeDto);
+        CreateCommonCodeResponseDto responseDto = commonCodeMapper.toCreateCommonCodeResponseDto(createdCommonCode);
+        ApiResponseDto<CreateCommonCodeResponseDto> apiResponse = ApiResponseDto.success(ApiResponseCode.COMMON_SUCCESS_CREATED, responseDto);
+        
+        return ResponseEntity.status(HttpStatus.CREATED).body(apiResponse);
+    }
+    
+    @LogExecution("공통 코드 수정")
+    @Operation(summary = "공통 코드 수정", description = "기존 공통 코드를 수정합니다.")
+    @ApiResponses({
+        @ApiResponse(responseCode = "200", description = "공통 코드 수정 성공"),
+        @ApiResponse(responseCode = "400", description = "잘못된 요청 데이터", content = @Content),
+        @ApiResponse(responseCode = "404", description = "공통 코드를 찾을 수 없음", content = @Content)
+    })
+    @PutMapping("/{code}")
+    public ResponseEntity<ApiResponseDto<String>> updateCode(
+            @PathVariable String code, 
+            @RequestBody @Valid UpdateCommonCodeRequestDto requestDto) {
+        CommonCodeDto commonCodeDto = commonCodeMapper.toCommonCodeDto(requestDto);
+        commonCodeService.updateCode(code, commonCodeDto);
+        return ResponseEntity.ok(ApiResponseDto.success(ApiResponseCode.COMMON_SUCCESS_UPDATED));
+    }
+    
+    @LogExecution("공통 코드 삭제")
+    @Operation(summary = "공통 코드 삭제", description = "공통 코드를 삭제합니다.")
+    @ApiResponses({
+        @ApiResponse(responseCode = "200", description = "공통 코드 삭제 성공"),
+        @ApiResponse(responseCode = "400", description = "하위 공통 코드가 존재하여 삭제할 수 없음", content = @Content),
+        @ApiResponse(responseCode = "404", description = "공통 코드를 찾을 수 없음", content = @Content)
+    })
+    @DeleteMapping("/{code}")
+    public ResponseEntity<ApiResponseDto<Void>> deleteCode(@PathVariable String code) {
+        commonCodeService.deleteCode(code);
+        return ResponseEntity.ok(ApiResponseDto.success(ApiResponseCode.COMMON_SUCCESS_DELETED));
+    }
+    
+    @LogExecution("공통 코드 조회")
+    @Operation(summary = "공통 코드 조회", description = "특정 공통 코드를 조회합니다.")
+    @ApiResponses({
+        @ApiResponse(responseCode = "200", description = "공통 코드 조회 성공"),
+        @ApiResponse(responseCode = "404", description = "공통 코드를 찾을 수 없음", content = @Content)
+    })
+    @GetMapping("/{code}")
+    public ResponseEntity<ApiResponseDto<GetCommonCodeResponseDto>> getCode(@PathVariable String code) {
+        GetCommonCodeResponseDto commonCode = commonCodeService.getCodeWithJoinInfo(code);
+        return ResponseEntity.ok(ApiResponseDto.success(ApiResponseCode.COMMON_SUCCESS_RETRIEVED, commonCode));
+    }
+    
+    @LogExecution("그룹별 공통 코드 조회")
+    @Operation(summary = "그룹별 공통 코드 조회", description = "특정 그룹에 속한 공통 코드들을 조회합니다.")
+    @ApiResponses({
+        @ApiResponse(responseCode = "200", description = "그룹별 공통 코드 조회 성공")
+    })
+    @GetMapping("/group/{groupCode}/codes")
+    public ResponseEntity<ApiResponseDto<List<CommonCodeDto>>> getCodesByGroupCode(@PathVariable String groupCode) {
+        List<CommonCodeDto> commonCodes = commonCodeService.getActiveCodesByGroupCode(groupCode);
+        return ResponseEntity.ok(ApiResponseDto.success(ApiResponseCode.COMMON_SUCCESS_RETRIEVED, commonCodes));
+    }
+    
+    @LogExecution("상위 코드별 공통 코드 조회")
+    @Operation(summary = "상위 코드별 공통 코드 조회", description = "특정 상위 코드에 속한 공통 코드들을 조회합니다.")
+    @ApiResponses({
+        @ApiResponse(responseCode = "200", description = "상위 코드별 공통 코드 조회 성공")
+    })
+    @GetMapping("/parent/{parentCode}/codes")
+    public ResponseEntity<ApiResponseDto<List<CommonCodeDto>>> getCodesByParentCode(@PathVariable String parentCode) {
+        List<CommonCodeDto> commonCodes = commonCodeService.getActiveCodesByParentCode(parentCode);
+        return ResponseEntity.ok(ApiResponseDto.success(ApiResponseCode.COMMON_SUCCESS_RETRIEVED, commonCodes));
+    }
+    
+    @LogExecution("전체 공통 코드 조회")
+    @Operation(summary = "전체 공통 코드 조회", description = "모든 공통 코드를 조회합니다.")
+    @ApiResponses({
+        @ApiResponse(responseCode = "200", description = "전체 공통 코드 조회 성공")
+    })
+    @GetMapping
+    public ResponseEntity<ApiResponseDto<List<CommonCodeDto>>> getAllCodes() {
+        List<CommonCodeDto> commonCodes = commonCodeService.getAllCodes();
+        return ResponseEntity.ok(ApiResponseDto.success(ApiResponseCode.COMMON_SUCCESS_RETRIEVED, commonCodes));
+    }
+}

src/main/java/com/bio/bio_backend/domain/admin/common_code/dto/CommonCodeDto.java

@@ -0,0 +1,27 @@
+package com.bio.bio_backend.domain.admin.common_code.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class CommonCodeDto {
+    
+    private Long oid;
+    private String code;
+    private String name;
+    private String description;
+    private String groupCode;
+    private String parentCode;
+    private String characterRef1;
+    private String characterRef2;
+    private String characterRef3;
+    private String characterRef4;
+    private String characterRef5;
+    private Integer sortOrder;
+    private Boolean useFlag;
+}

src/main/java/com/bio/bio_backend/domain/admin/common_code/dto/CommonGroupCodeDto.java

@@ -0,0 +1,24 @@
+package com.bio.bio_backend.domain.admin.common_code.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class CommonGroupCodeDto {
+    
+    private Long oid;
+    private String code;
+    private String name;
+    private String characterRef1Title;
+    private String characterRef2Title;
+    private String characterRef3Title;
+    private String characterRef4Title;
+    private String characterRef5Title;
+    private Integer sortOrder;
+    private Boolean useFlag;
+}

src/main/java/com/bio/bio_backend/domain/admin/common_code/dto/CreateCommonCodeRequestDto.java

@@ -0,0 +1,55 @@
+package com.bio.bio_backend.domain.admin.common_code.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class CreateCommonCodeRequestDto {
+    
+    @NotBlank(message = "코드는 필수입니다")
+    @Size(max = 50, message = "코드는 50자를 초과할 수 없습니다")
+    private String code;
+    
+    @NotBlank(message = "이름은 필수입니다")
+    @Size(max = 100, message = "이름은 100자를 초과할 수 없습니다")
+    private String name;
+    
+    @Size(max = 500, message = "설명은 500자를 초과할 수 없습니다")
+    private String description;
+    
+    @NotBlank(message = "그룹 코드는 필수입니다")
+    @Size(max = 50, message = "그룹 코드는 50자를 초과할 수 없습니다")
+    private String groupCode;
+    
+    @Size(max = 50, message = "상위 코드는 50자를 초과할 수 없습니다")
+    private String parentCode;
+    
+    @Size(max = 100, message = "문자 참조1은 100자를 초과할 수 없습니다")
+    private String characterRef1;
+    
+    @Size(max = 100, message = "문자 참조2는 100자를 초과할 수 없습니다")
+    private String characterRef2;
+    
+    @Size(max = 100, message = "문자 참조3은 100자를 초과할 수 없습니다")
+    private String characterRef3;
+    
+    @Size(max = 100, message = "문자 참조4는 100자를 초과할 수 없습니다")
+    private String characterRef4;
+    
+    @Size(max = 100, message = "문자 참조5는 100자를 초과할 수 없습니다")
+    private String characterRef5;
+    
+    @Builder.Default
+    private Integer sortOrder = 0;
+    
+    @Builder.Default
+    private Boolean useFlag = true;
+}

src/main/java/com/bio/bio_backend/domain/admin/common_code/dto/CreateCommonCodeResponseDto.java

@@ -0,0 +1,27 @@
+package com.bio.bio_backend.domain.admin.common_code.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class CreateCommonCodeResponseDto {
+    
+    private Long oid;
+    private String code;
+    private String name;
+    private String description;
+    private String groupCode;
+    private String parentCode;
+    private String characterRef1;
+    private String characterRef2;
+    private String characterRef3;
+    private String characterRef4;
+    private String characterRef5;
+    private Integer sortOrder;
+    private Boolean useFlag;
+}

src/main/java/com/bio/bio_backend/domain/admin/common_code/dto/CreateCommonGroupCodeRequestDto.java

@@ -0,0 +1,45 @@
+package com.bio.bio_backend.domain.admin.common_code.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class CreateCommonGroupCodeRequestDto {
+    
+    @NotBlank(message = "코드는 필수입니다")
+    @Size(max = 50, message = "코드는 50자를 초과할 수 없습니다")
+    private String code;
+    
+    @NotBlank(message = "이름은 필수입니다")
+    @Size(max = 100, message = "이름은 100자를 초과할 수 없습니다")
+    private String name;
+    
+    @Size(max = 100, message = "차트 참조1 제목은 100자를 초과할 수 없습니다")
+    private String characterRef1Title;
+    
+    @Size(max = 100, message = "차트 참조2 제목은 100자를 초과할 수 없습니다")
+    private String characterRef2Title;
+    
+    @Size(max = 100, message = "차트 참조3 제목은 100자를 초과할 수 없습니다")
+    private String characterRef3Title;
+    
+    @Size(max = 100, message = "차트 참조4 제목은 100자를 초과할 수 없습니다")
+    private String characterRef4Title;
+    
+    @Size(max = 100, message = "차트 참조5 제목은 100자를 초과할 수 없습니다")
+    private String characterRef5Title;
+    
+    @Builder.Default
+    private Integer sortOrder = 0;
+    
+    @Builder.Default
+    private Boolean useFlag = true;
+}

src/main/java/com/bio/bio_backend/domain/admin/common_code/dto/CreateCommonGroupCodeResponseDto.java

@@ -0,0 +1,24 @@
+package com.bio.bio_backend.domain.admin.common_code.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class CreateCommonGroupCodeResponseDto {
+    
+    private Long oid;
+    private String code;
+    private String name;
+    private String characterRef1Title;
+    private String characterRef2Title;
+    private String characterRef3Title;
+    private String characterRef4Title;
+    private String characterRef5Title;
+    private Integer sortOrder;
+    private Boolean useFlag;
+}

src/main/java/com/bio/bio_backend/domain/admin/common_code/dto/GetCommonCodeResponseDto.java

@@ -0,0 +1,68 @@
+package com.bio.bio_backend.domain.admin.common_code.dto;
+
+import jakarta.persistence.*;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.time.LocalDateTime;
+
+/**
+ * 공통 코드 조회용 Response DTO
+ * CommonGroupCode의 name과 Member의 name을 join을 통해 함께 조회
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@SqlResultSetMapping(
+    name = "GetCommonCodeResponseDtoMapping",
+    classes = @ConstructorResult(
+        targetClass = GetCommonCodeResponseDto.class,
+        columns = {
+            @ColumnResult(name = "code", type = String.class),
+            @ColumnResult(name = "name", type = String.class),
+            @ColumnResult(name = "description", type = String.class),
+            @ColumnResult(name = "group_code", type = String.class),
+            @ColumnResult(name = "parent_code", type = String.class),
+            @ColumnResult(name = "character_ref1", type = String.class),
+            @ColumnResult(name = "character_ref2", type = String.class),
+            @ColumnResult(name = "character_ref3", type = String.class),
+            @ColumnResult(name = "character_ref4", type = String.class),
+            @ColumnResult(name = "character_ref5", type = String.class),
+            @ColumnResult(name = "sort_order", type = Integer.class),
+            @ColumnResult(name = "use_flag", type = Boolean.class),
+            @ColumnResult(name = "created_at", type = LocalDateTime.class),
+            @ColumnResult(name = "updated_at", type = LocalDateTime.class),
+            @ColumnResult(name = "group_code_name", type = String.class),
+            @ColumnResult(name = "created_by_name", type = String.class),
+            @ColumnResult(name = "updated_by_name", type = String.class)
+        }
+    )
+)
+public class GetCommonCodeResponseDto {
+    
+    // CommonCode 기본 정보
+    private String code;
+    private String name;
+    private String description;
+    private String groupCode;
+    private String parentCode;
+    private String characterRef1;
+    private String characterRef2;
+    private String characterRef3;
+    private String characterRef4;
+    private String characterRef5;
+    private Integer sortOrder;
+    private Boolean useFlag;
+    
+    // BaseEntity 정보
+    private LocalDateTime createdAt;
+    private LocalDateTime updatedAt;
+    
+    // Join을 통해 가져올 정보
+    private String groupCodeName;        // CommonGroupCode의 name
+    private String createdByName;        // 생성자 Member의 name
+    private String updatedByName;        // 수정자 Member의 name
+}

src/main/java/com/bio/bio_backend/domain/admin/common_code/dto/UpdateCommonCodeRequestDto.java

@@ -0,0 +1,49 @@
+package com.bio.bio_backend.domain.admin.common_code.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class UpdateCommonCodeRequestDto {
+    
+    @NotBlank(message = "이름은 필수입니다")
+    @Size(max = 100, message = "이름은 100자를 초과할 수 없습니다")
+    private String name;
+    
+    @Size(max = 500, message = "설명은 500자를 초과할 수 없습니다")
+    private String description;
+    
+    @NotBlank(message = "그룹 코드는 필수입니다")
+    @Size(max = 50, message = "그룹 코드는 50자를 초과할 수 없습니다")
+    private String groupCode;
+    
+    @Size(max = 50, message = "상위 코드는 50자를 초과할 수 없습니다")
+    private String parentCode;
+    
+    @Size(max = 100, message = "문자 참조1은 100자를 초과할 수 없습니다")
+    private String characterRef1;
+    
+    @Size(max = 100, message = "문자 참조2는 100자를 초과할 수 없습니다")
+    private String characterRef2;
+    
+    @Size(max = 100, message = "문자 참조3은 100자를 초과할 수 없습니다")
+    private String characterRef3;
+    
+    @Size(max = 100, message = "문자 참조4는 100자를 초과할 수 없습니다")
+    private String characterRef4;
+    
+    @Size(max = 100, message = "문자 참조5는 100자를 초과할 수 없습니다")
+    private String characterRef5;
+    
+    private Integer sortOrder;
+    
+    private Boolean useFlag;
+}

src/main/java/com/bio/bio_backend/domain/admin/common_code/dto/UpdateCommonGroupCodeRequestDto.java

@@ -0,0 +1,39 @@
+package com.bio.bio_backend.domain.admin.common_code.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class UpdateCommonGroupCodeRequestDto {
+    
+    @NotBlank(message = "이름은 필수입니다")
+    @Size(max = 100, message = "이름은 100자를 초과할 수 없습니다")
+    private String name;
+    
+    @Size(max = 100, message = "문자 참조1 제목은 100자를 초과할 수 없습니다")
+    private String characterRef1Title;
+    
+    @Size(max = 100, message = "문자 참조2 제목은 100자를 초과할 수 없습니다")
+    private String characterRef2Title;
+    
+    @Size(max = 100, message = "문자 참조3 제목은 100자를 초과할 수 없습니다")
+    private String characterRef3Title;
+    
+    @Size(max = 100, message = "문자 참조4 제목은 100자를 초과할 수 없습니다")
+    private String characterRef4Title;
+    
+    @Size(max = 100, message = "문자 참조5 제목은 100자를 초과할 수 없습니다")
+    private String characterRef5Title;
+    
+    private Integer sortOrder;
+    
+    private Boolean useFlag;
+}

src/main/java/com/bio/bio_backend/domain/admin/common_code/entity/CommonCode.java

@@ -0,0 +1,88 @@
+package com.bio.bio_backend.domain.admin.common_code.entity;
+
+import com.bio.bio_backend.global.constants.AppConstants;
+import com.bio.bio_backend.global.entity.BaseEntity;
+import jakarta.persistence.*;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.Setter;
+import org.hibernate.annotations.Comment;
+
+@Entity
+@Getter @Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@Table(
+    name = AppConstants.TABLE_PREFIX + "common_code",
+    indexes = {
+        @Index(name = "idx_common_code_code", columnList = "code"),
+        @Index(name = "idx_common_code_group_code", columnList = "group_code"),
+        @Index(name = "idx_common_code_parent_code", columnList = "parent_code")
+    }
+)
+public class CommonCode extends BaseEntity {
+
+    @Column(name = "code", nullable = false, length = 50, unique = true)
+    @Comment("코드")
+    private String code;
+
+    @Column(name = "name", nullable = false, length = 100)
+    @Comment("코드명")
+    private String name;
+
+    @Column(name = "description", length = 500)
+    @Comment("설명")
+    private String description;
+
+    @Column(name = "group_code", nullable = false, length = 50)
+    @Comment("그룹 코드")
+    private String groupCode;
+
+    @Column(name = "parent_code", length = 50)
+    @Comment("부모 코드")
+    private String parentCode;
+
+    @Column(name = "character_ref1", length = 100)
+    @Comment("문자 참조1")
+    private String characterRef1;
+
+    @Column(name = "character_ref2", length = 100)
+    @Comment("문자 참조2")
+    private String characterRef2;
+
+    @Column(name = "character_ref3", length = 100)
+    @Comment("문자 참조3")
+    private String characterRef3;
+
+    @Column(name = "character_ref4", length = 100)
+    @Comment("문자 참조4")
+    private String characterRef4;
+
+    @Column(name = "character_ref5", length = 100)
+    @Comment("문자 참조5")
+    private String characterRef5;
+
+    @Column(name = "sort_order", nullable = false)
+    @Comment("정렬 순번")
+    @Builder.Default
+    private Integer sortOrder = 0;
+
+    @Column(name = "use_flag", nullable = false)
+    @Comment("사용 여부")
+    @Builder.Default
+    private Boolean useFlag = true;
+
+    // 관계 설정
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(
+        name = "group_code", 
+        referencedColumnName = "code",
+        insertable = false, 
+        updatable = false,
+        foreignKey = @ForeignKey(value = ConstraintMode.NO_CONSTRAINT)
+    )
+    private CommonGroupCode commonGroupCode;
+}

src/main/java/com/bio/bio_backend/domain/admin/common_code/entity/CommonGroupCode.java

@@ -0,0 +1,63 @@
+package com.bio.bio_backend.domain.admin.common_code.entity;
+
+import com.bio.bio_backend.global.constants.AppConstants;
+import com.bio.bio_backend.global.entity.BaseEntity;
+import jakarta.persistence.*;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.Setter;
+import org.hibernate.annotations.Comment;
+
+@Entity
+@Getter @Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@Table(
+    name = AppConstants.TABLE_PREFIX + "common_group_code",
+    indexes = {
+        @Index(name = "idx_common_group_code_code", columnList = "code")
+    }
+)
+public class CommonGroupCode extends BaseEntity {
+
+    @Column(name = "code", nullable = false, length = 50, unique = true)
+    @Comment("코드")
+    private String code;
+
+    @Column(name = "name", nullable = false, length = 100)
+    @Comment("코드명")
+    private String name;
+
+    @Column(name = "character_ref1_title", length = 100)
+    @Comment("문자 참조 타이틀1")
+    private String characterRef1Title;
+
+    @Column(name = "character_ref2_title", length = 100)
+    @Comment("문자 참조 타이틀2")
+    private String characterRef2Title;
+
+    @Column(name = "character_ref3_title", length = 100)
+    @Comment("문자 참조 타이틀3")
+    private String characterRef3Title;
+
+    @Column(name = "character_ref4_title", length = 100)
+    @Comment("문자 참조 타이틀4")
+    private String characterRef4Title;
+
+    @Column(name = "character_ref5_title", length = 100)
+    @Comment("문자 참조 타이틀5")
+    private String characterRef5Title;
+
+    @Column(name = "sort_order", nullable = false)
+    @Comment("정렬 순번")
+    @Builder.Default
+    private Integer sortOrder = 0;
+
+    @Column(name = "use_flag", nullable = false)
+    @Comment("사용 여부")
+    @Builder.Default
+    private Boolean useFlag = true;
+}

src/main/java/com/bio/bio_backend/domain/admin/common_code/mapper/CommonCodeMapper.java

@@ -0,0 +1,58 @@
+package com.bio.bio_backend.domain.admin.common_code.mapper;
+
+import com.bio.bio_backend.domain.admin.common_code.dto.CommonCodeDto;
+import com.bio.bio_backend.domain.admin.common_code.dto.CreateCommonCodeRequestDto;
+import com.bio.bio_backend.domain.admin.common_code.dto.CreateCommonCodeResponseDto;
+import com.bio.bio_backend.domain.admin.common_code.dto.UpdateCommonCodeRequestDto;
+import com.bio.bio_backend.domain.admin.common_code.entity.CommonCode;
+import com.bio.bio_backend.global.annotation.IgnoreBaseEntityMapping;
+import com.bio.bio_backend.global.config.GlobalMapperConfig;
+import org.mapstruct.Mapper;
+import org.mapstruct.Mapping;
+
+import java.util.List;
+
+@Mapper(config = GlobalMapperConfig.class)
+public interface CommonCodeMapper {
+    
+    /**
+     * CommonCode 엔티티를 CommonCodeDto로 변환
+     */
+    CommonCodeDto toCommonCodeDto(CommonCode commonCode);
+
+    /**
+     * CommonCodeDto를 CommonCode 엔티티로 변환
+     */
+    @Mapping(target = "commonGroupCode", ignore = true)
+    CommonCode toCommonCode(CommonCodeDto commonCodeDto);
+    
+    /**
+     * CommonCode 엔티티 리스트를 CommonCodeDto 리스트로 변환
+     */
+    List<CommonCodeDto> toCommonCodeDtoList(List<CommonCode> commonCodes);
+    
+    /**
+     * CommonCodeDto를 CreateCommonCodeResponseDto로 변환
+     */
+    CreateCommonCodeResponseDto toCreateCommonCodeResponseDto(CommonCodeDto commonCodeDto);
+    
+    /**
+     * CreateCommonCodeRequestDto를 CommonCodeDto로 변환
+     */
+    @Mapping(target = "oid", ignore = true)
+    CommonCodeDto toCommonCodeDto(CreateCommonCodeRequestDto createRequestDto);
+    
+    /**
+     * UpdateCommonCodeRequestDto를 CommonCodeDto로 변환
+     */
+    @Mapping(target = "oid", ignore = true)
+    @Mapping(target = "code", ignore = true)
+    CommonCodeDto toCommonCodeDto(UpdateCommonCodeRequestDto updateRequestDto);
+    
+    /**
+     * CommonCodeDto의 값으로 CommonCode 엔티티를 업데이트
+     */
+    @IgnoreBaseEntityMapping
+    @Mapping(target = "commonGroupCode", ignore = true)
+    void updateCommonCodeFromDto(CommonCodeDto commonCodeDto, @org.mapstruct.MappingTarget CommonCode commonCode);
+}

src/main/java/com/bio/bio_backend/domain/admin/common_code/mapper/CommonGroupCodeMapper.java

@@ -0,0 +1,56 @@
+package com.bio.bio_backend.domain.admin.common_code.mapper;
+
+import com.bio.bio_backend.domain.admin.common_code.dto.CommonGroupCodeDto;
+import com.bio.bio_backend.domain.admin.common_code.dto.CreateCommonGroupCodeRequestDto;
+import com.bio.bio_backend.domain.admin.common_code.dto.CreateCommonGroupCodeResponseDto;
+import com.bio.bio_backend.domain.admin.common_code.dto.UpdateCommonGroupCodeRequestDto;
+import com.bio.bio_backend.domain.admin.common_code.entity.CommonGroupCode;
+import com.bio.bio_backend.global.annotation.IgnoreBaseEntityMapping;
+import com.bio.bio_backend.global.config.GlobalMapperConfig;
+import org.mapstruct.Mapper;
+import org.mapstruct.Mapping;
+
+import java.util.List;
+
+@Mapper(config = GlobalMapperConfig.class)
+public interface CommonGroupCodeMapper {
+    
+    /**
+     * CommonGroupCode 엔티티를 CommonGroupCodeDto로 변환
+     */
+    CommonGroupCodeDto toCommonGroupCodeDto(CommonGroupCode commonGroupCode);
+
+    /**
+     * CommonGroupCodeDto를 CommonGroupCode 엔티티로 변환
+     */
+    CommonGroupCode toCommonGroupCode(CommonGroupCodeDto commonGroupCodeDto);
+    
+    /**
+     * CommonGroupCode 엔티티 리스트를 CommonGroupCodeDto 리스트로 변환
+     */
+    List<CommonGroupCodeDto> toCommonGroupCodeDtoList(List<CommonGroupCode> commonGroupCodes);
+    
+    /**
+     * CommonGroupCodeDto를 CreateCommonGroupCodeResponseDto로 변환
+     */
+    CreateCommonGroupCodeResponseDto toCreateCommonGroupCodeResponseDto(CommonGroupCodeDto commonGroupCodeDto);
+    
+    /**
+     * CreateCommonGroupCodeRequestDto를 CommonGroupCodeDto로 변환
+     */
+    @Mapping(target = "oid", ignore = true)
+    CommonGroupCodeDto toCommonGroupCodeDto(CreateCommonGroupCodeRequestDto createRequestDto);
+    
+    /**
+     * UpdateCommonGroupCodeRequestDto를 CommonGroupCodeDto로 변환
+     */
+    @Mapping(target = "oid", ignore = true)
+    @Mapping(target = "code", ignore = true)
+    CommonGroupCodeDto toCommonGroupCodeDto(UpdateCommonGroupCodeRequestDto updateRequestDto);
+    
+    /**
+     * CommonGroupCodeDto의 값으로 CommonGroupCode 엔티티를 업데이트
+     */
+    @IgnoreBaseEntityMapping
+    void updateCommonGroupCodeFromDto(CommonGroupCodeDto commonGroupCodeDto, @org.mapstruct.MappingTarget CommonGroupCode commonGroupCode);
+}

src/main/java/com/bio/bio_backend/domain/admin/common_code/repository/CommonCodeRepository.java

@@ -0,0 +1,20 @@
+package com.bio.bio_backend.domain.admin.common_code.repository;
+
+import com.bio.bio_backend.domain.admin.common_code.entity.CommonCode;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import java.util.List;
+import java.util.Optional;
+
+@Repository
+public interface CommonCodeRepository extends JpaRepository<CommonCode, Long>, CommonCodeRepositoryCustom {
+    
+    Optional<CommonCode> findByCode(String code);
+    
+    boolean existsByCode(String code);
+    
+    boolean existsByGroupCode(String groupCode);
+    
+    boolean existsByParentCode(String parentCode);
+}

src/main/java/com/bio/bio_backend/domain/admin/common_code/repository/CommonCodeRepositoryCustom.java

@@ -0,0 +1,47 @@
+package com.bio.bio_backend.domain.admin.common_code.repository;
+
+import com.bio.bio_backend.domain.admin.common_code.dto.GetCommonCodeResponseDto;
+import com.bio.bio_backend.domain.admin.common_code.entity.CommonCode;
+import java.util.List;
+import java.util.Optional;
+
+/**
+ * QueryDSL을 활용한 커스텀 쿼리 메서드들을 정의하는 인터페이스
+ * 복잡한 쿼리나 동적 쿼리가 필요한 경우 이 인터페이스를 구현하여 사용합니다.
+ */
+public interface CommonCodeRepositoryCustom {
+
+    /**
+     * 그룹 코드로 활성화된 공통 코드들을 정렬 순서대로 조회합니다.
+     *
+     * @param groupCode 그룹 코드
+     * @return List<CommonCode> 활성화된 공통 코드 목록
+     */
+    List<CommonCode> findByGroupCode(String groupCode);
+
+    /**
+     * 부모 코드로 활성화된 공통 코드들을 정렬 순서대로 조회합니다.
+     *
+     * @param parentCode 부모 코드
+     * @return List<CommonCode> 활성화된 공통 코드 목록
+     */
+    List<CommonCode> findByParentCode(String parentCode);
+
+    /**
+     * 특정 공통 코드를 조회하며 CommonGroupCode와 Member 정보를 join하여 함께 조회합니다.
+     * QueryDSL을 사용하여 성능 최적화된 쿼리를 실행합니다.
+     *
+     * @param code 조회할 공통 코드
+     * @return Optional<GetCommonCodeResponseDto> 조회된 공통 코드 정보 (없으면 empty)
+     */
+    Optional<GetCommonCodeResponseDto> findCodeWithJoinInfo(String code);
+
+    /**
+     * 특정 공통 코드를 조회하며 CommonGroupCode와 Member 정보를 join하여 함께 조회합니다.
+     * Native Query를 사용한 버전 (사용하지 않음, 참고용)
+     *
+     * @param code 조회할 공통 코드
+     * @return Optional<GetCommonCodeResponseDto> 조회된 공통 코드 정보 (없으면 empty)
+     */
+    Optional<GetCommonCodeResponseDto> findCodeWithJoinInfoNative(String code);
+}

src/main/java/com/bio/bio_backend/domain/admin/common_code/repository/CommonCodeRepositoryImpl.java

@@ -0,0 +1,96 @@
+package com.bio.bio_backend.domain.admin.common_code.repository;
+
+import com.bio.bio_backend.domain.admin.common_code.dto.GetCommonCodeResponseDto;
+import com.bio.bio_backend.domain.admin.common_code.entity.CommonCode;
+import com.bio.bio_backend.domain.admin.common_code.entity.QCommonCode;
+import com.bio.bio_backend.domain.admin.common_code.entity.QCommonGroupCode;
+import com.bio.bio_backend.domain.base.member.entity.QMember;
+import com.querydsl.core.types.Projections;
+import com.querydsl.jpa.impl.JPAQueryFactory;
+import jakarta.persistence.EntityManager;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Repository;
+
+import java.util.List;
+import java.util.Optional;
+
+@Repository
+@RequiredArgsConstructor
+public class CommonCodeRepositoryImpl implements CommonCodeRepositoryCustom {
+
+    private final JPAQueryFactory queryFactory;
+    private final EntityManager entityManager;
+
+    private final QCommonCode commonCode = QCommonCode.commonCode;
+    private final QCommonGroupCode commonGroupCode = QCommonGroupCode.commonGroupCode;
+    private final QMember member = QMember.member;
+
+    @Override
+    public List<CommonCode> findByGroupCode(String groupCode) {
+        return queryFactory
+                .selectFrom(commonCode)
+                .where(commonCode.groupCode.eq(groupCode)
+                        .and(commonCode.useFlag.eq(true)))
+                .orderBy(commonCode.sortOrder.asc())
+                .fetch();
+    }
+
+    @Override
+    public List<CommonCode> findByParentCode(String parentCode) {
+        return queryFactory
+                .selectFrom(commonCode)
+                .where(commonCode.parentCode.eq(parentCode)
+                        .and(commonCode.useFlag.eq(true)))
+                .orderBy(commonCode.sortOrder.asc())
+                .fetch();
+    }
+
+    @Override
+    public Optional<GetCommonCodeResponseDto> findCodeWithJoinInfo(String code) {
+        return Optional.ofNullable(
+            queryFactory
+                .select(Projections.constructor(GetCommonCodeResponseDto.class,
+                    commonCode.code, commonCode.name, commonCode.description,
+                    commonCode.groupCode, commonCode.parentCode,
+                    commonCode.characterRef1, commonCode.characterRef2, commonCode.characterRef3,
+                    commonCode.characterRef4, commonCode.characterRef5,
+                    commonCode.sortOrder, commonCode.useFlag,
+                    commonCode.createdAt, commonCode.updatedAt,
+                    commonGroupCode.name, member.name, member.name
+                ))
+                .from(commonCode)
+                .leftJoin(commonGroupCode).on(commonCode.groupCode.eq(commonGroupCode.code))
+                .leftJoin(member).on(commonCode.createdOid.eq(member.oid))
+                .leftJoin(member).on(commonCode.updatedOid.eq(member.oid))
+                .where(commonCode.code.eq(code))
+                .fetchOne()
+        );
+    }
+
+    @Override
+    public Optional<GetCommonCodeResponseDto> findCodeWithJoinInfoNative(String code) {
+        String nativeQuery = """
+            SELECT cc.code, cc.name, cc.description, cc.group_code, cc.parent_code,
+                   cc.character_ref1, cc.character_ref2, cc.character_ref3, cc.character_ref4, cc.character_ref5,
+                   cc.sort_order, cc.use_flag, cc.created_at, cc.updated_at,
+                   cgc.name as group_code_name, cm1.name as created_by_name, cm2.name as updated_by_name
+            FROM st_common_code cc
+            LEFT JOIN st_common_group_code cgc ON cc.group_code = cgc.code
+            LEFT JOIN st_member cm1 ON cc.created_oid = cm1.oid
+            LEFT JOIN st_member cm2 ON cc.updated_oid = cm2.oid
+            WHERE cc.code = :code
+            """;
+
+        try {
+            @SuppressWarnings("unchecked")
+            List<GetCommonCodeResponseDto> results = entityManager
+                .createNativeQuery(nativeQuery, "GetCommonCodeResponseDtoMapping")
+                .setParameter("code", code)
+                .getResultList();
+            
+            return results.isEmpty() ? Optional.empty() : Optional.of(results.get(0));
+        } catch (Exception e) {
+            return Optional.empty();
+        }
+    }
+}

src/main/java/com/bio/bio_backend/domain/admin/common_code/repository/CommonGroupCodeRepository.java

@@ -0,0 +1,18 @@
+package com.bio.bio_backend.domain.admin.common_code.repository;
+
+import com.bio.bio_backend.domain.admin.common_code.entity.CommonGroupCode;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import java.util.List;
+import java.util.Optional;
+
+@Repository
+public interface CommonGroupCodeRepository extends JpaRepository<CommonGroupCode, Long> {
+    
+    Optional<CommonGroupCode> findByCode(String code);
+    
+    List<CommonGroupCode> findByUseFlagOrderBySortOrderAsc(Boolean useFlag);
+    
+    boolean existsByCode(String code);
+}

src/main/java/com/bio/bio_backend/domain/admin/common_code/service/CommonCodeService.java

@@ -0,0 +1,28 @@
+package com.bio.bio_backend.domain.admin.common_code.service;
+
+import com.bio.bio_backend.domain.admin.common_code.dto.CommonCodeDto;
+import com.bio.bio_backend.domain.admin.common_code.dto.CommonGroupCodeDto;
+import com.bio.bio_backend.domain.admin.common_code.dto.GetCommonCodeResponseDto;
+
+import java.util.List;
+
+public interface CommonCodeService {
+    
+    // 그룹 코드 관련
+    CommonGroupCodeDto createGroupCode(CommonGroupCodeDto groupCodeDto);
+    void updateGroupCode(String code, CommonGroupCodeDto groupCodeDto);
+    void deleteGroupCode(String code);
+    CommonGroupCodeDto getGroupCode(String code);
+    List<CommonGroupCodeDto> getAllGroupCodes();
+    List<CommonGroupCodeDto> getActiveGroupCodes();
+    
+    // 공통 코드 관련
+    CommonCodeDto createCode(CommonCodeDto codeDto);
+    void updateCode(String code, CommonCodeDto codeDto);
+    void deleteCode(String code);
+    CommonCodeDto getCode(String code);
+    GetCommonCodeResponseDto getCodeWithJoinInfo(String code);
+    List<CommonCodeDto> getActiveCodesByGroupCode(String groupCode);
+    List<CommonCodeDto> getActiveCodesByParentCode(String parentCode);
+    List<CommonCodeDto> getAllCodes();
+}

src/main/java/com/bio/bio_backend/domain/admin/common_code/service/CommonCodeServiceImpl.java

@@ -0,0 +1,160 @@
+package com.bio.bio_backend.domain.admin.common_code.service;
+
+import com.bio.bio_backend.domain.admin.common_code.dto.CommonCodeDto;
+import com.bio.bio_backend.domain.admin.common_code.dto.CommonGroupCodeDto;
+import com.bio.bio_backend.domain.admin.common_code.dto.GetCommonCodeResponseDto;
+import com.bio.bio_backend.domain.admin.common_code.entity.CommonCode;
+import com.bio.bio_backend.domain.admin.common_code.entity.CommonGroupCode;
+import com.bio.bio_backend.domain.admin.common_code.mapper.CommonCodeMapper;
+import com.bio.bio_backend.domain.admin.common_code.mapper.CommonGroupCodeMapper;
+import com.bio.bio_backend.domain.admin.common_code.repository.CommonCodeRepository;
+import com.bio.bio_backend.domain.admin.common_code.repository.CommonGroupCodeRepository;
+import com.bio.bio_backend.global.exception.ApiException;
+import com.bio.bio_backend.global.constants.ApiResponseCode;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.List;
+
+@Slf4j
+@Service
+@RequiredArgsConstructor
+@Transactional(readOnly = true)
+public class CommonCodeServiceImpl implements CommonCodeService {
+    
+    private final CommonGroupCodeRepository commonGroupCodeRepository;
+    private final CommonCodeRepository commonCodeRepository;
+    private final CommonCodeMapper commonCodeMapper;
+    private final CommonGroupCodeMapper commonGroupCodeMapper;
+    
+    // 그룹 코드 관련 메서드들
+    @Override
+    @Transactional
+    public CommonGroupCodeDto createGroupCode(CommonGroupCodeDto groupCodeDto) {
+        if (commonGroupCodeRepository.existsByCode(groupCodeDto.getCode())) {
+            throw new ApiException(ApiResponseCode.COMMON_CODE_DUPLICATE);
+        }
+        
+        CommonGroupCode groupCode = commonGroupCodeMapper.toCommonGroupCode(groupCodeDto);
+        CommonGroupCode savedGroupCode = commonGroupCodeRepository.save(groupCode);
+        return commonGroupCodeMapper.toCommonGroupCodeDto(savedGroupCode);
+    }
+    
+    @Override
+    @Transactional
+    public void updateGroupCode(String code, CommonGroupCodeDto groupCodeDto) {
+        CommonGroupCode existingGroupCode = commonGroupCodeRepository.findByCode(code)
+            .orElseThrow(() -> new ApiException(ApiResponseCode.COMMON_TARGET_NOT_FOUND));
+        
+        commonGroupCodeMapper.updateCommonGroupCodeFromDto(groupCodeDto, existingGroupCode);
+        commonGroupCodeRepository.save(existingGroupCode);
+    }
+    
+    @Override
+    @Transactional
+    public void deleteGroupCode(String code) {
+        CommonGroupCode groupCode = commonGroupCodeRepository.findByCode(code)
+            .orElseThrow(() -> new ApiException(ApiResponseCode.COMMON_TARGET_NOT_FOUND));
+        
+        // 하위 공통 코드가 있는지 확인
+        if (commonCodeRepository.existsByGroupCode(code)) {
+            throw new ApiException(ApiResponseCode.COMMON_CODE_ERROR_001);
+        }
+        
+        commonGroupCodeRepository.delete(groupCode);
+    }
+    
+    @Override
+    public CommonGroupCodeDto getGroupCode(String code) {
+        CommonGroupCode groupCode = commonGroupCodeRepository.findByCode(code)
+            .orElseThrow(() -> new ApiException(ApiResponseCode.COMMON_NOT_FOUND));
+        return commonGroupCodeMapper.toCommonGroupCodeDto(groupCode);
+    }
+    
+    @Override
+    public List<CommonGroupCodeDto> getAllGroupCodes() {
+        List<CommonGroupCode> groupCodes = commonGroupCodeRepository.findAll();
+        return commonGroupCodeMapper.toCommonGroupCodeDtoList(groupCodes);
+    }
+    
+    @Override
+    public List<CommonGroupCodeDto> getActiveGroupCodes() {
+        List<CommonGroupCode> groupCodes = commonGroupCodeRepository.findByUseFlagOrderBySortOrderAsc(true);
+        return commonGroupCodeMapper.toCommonGroupCodeDtoList(groupCodes);
+    }
+    
+    // 공통 코드 관련 메서드들
+    @Override
+    @Transactional
+    public CommonCodeDto createCode(CommonCodeDto commonCodeDto) {
+        if (commonCodeRepository.existsByCode(commonCodeDto.getCode())) {
+            throw new ApiException(ApiResponseCode.COMMON_CODE_DUPLICATE);
+        }
+        
+        // 그룹 코드 존재 여부 확인
+        if (!commonGroupCodeRepository.existsByCode(commonCodeDto.getGroupCode())) {
+            throw new ApiException(ApiResponseCode.COMMON_CODE_ERROR_002);
+        }
+        
+        CommonCode commonCode = commonCodeMapper.toCommonCode(commonCodeDto);
+        CommonCode savedCommonCode = commonCodeRepository.save(commonCode);
+        return commonCodeMapper.toCommonCodeDto(savedCommonCode);
+    }
+    
+    @Override
+    @Transactional
+    public void updateCode(String code, CommonCodeDto commonCodeDto) {
+        CommonCode existingCommonCode = commonCodeRepository.findByCode(code)
+            .orElseThrow(() -> new ApiException(ApiResponseCode.COMMON_CODE_ERROR_003));
+        
+        commonCodeMapper.updateCommonCodeFromDto(commonCodeDto, existingCommonCode);
+        commonCodeRepository.save(existingCommonCode);
+    }
+    
+    @Override
+    @Transactional
+    public void deleteCode(String code) {
+        CommonCode commonCode = commonCodeRepository.findByCode(code)
+            .orElseThrow(() -> new ApiException(ApiResponseCode.COMMON_CODE_ERROR_003));
+        
+        // 하위 공통 코드가 있는지 확인
+        if (commonCodeRepository.existsByParentCode(code)) {
+            throw new ApiException(ApiResponseCode.COMMON_CODE_ERROR_001);
+        }
+        
+        commonCodeRepository.delete(commonCode);
+    }
+    
+    @Override
+    public CommonCodeDto getCode(String code) {
+        CommonCode commonCode = commonCodeRepository.findByCode(code)
+            .orElseThrow(() -> new ApiException(ApiResponseCode.COMMON_CODE_ERROR_003));
+        return commonCodeMapper.toCommonCodeDto(commonCode);
+    }
+    
+    @Override
+    public GetCommonCodeResponseDto getCodeWithJoinInfo(String code) {
+        return commonCodeRepository.findCodeWithJoinInfo(code)
+            .orElseThrow(() -> new ApiException(ApiResponseCode.COMMON_CODE_ERROR_003));
+    }
+    
+    @Override
+    public List<CommonCodeDto> getActiveCodesByGroupCode(String groupCode) {
+        List<CommonCode> commonCodes = commonCodeRepository.findByGroupCode(groupCode);
+        return commonCodeMapper.toCommonCodeDtoList(commonCodes);
+    }
+    
+    @Override
+    public List<CommonCodeDto> getActiveCodesByParentCode(String parentCode) {
+        List<CommonCode> commonCodes = commonCodeRepository.findByParentCode(parentCode);
+        return commonCodeMapper.toCommonCodeDtoList(commonCodes);
+    }
+    
+    @Override
+    public List<CommonCodeDto> getAllCodes() {
+        List<CommonCode> commonCodes = commonCodeRepository.findAll();
+        return commonCodeMapper.toCommonCodeDtoList(commonCodes);
+    }
+}

src/main/java/com/bio/bio_backend/domain/base/file/controller/FileController.java

@@ -0,0 +1,101 @@
+package com.bio.bio_backend.domain.base.file.controller;
+
+import com.bio.bio_backend.domain.base.file.dto.FileUploadRequestDto;
+import com.bio.bio_backend.domain.base.file.dto.FileUploadResponseDto;
+import com.bio.bio_backend.domain.base.file.dto.MultipleFileUploadRequestDto;
+import com.bio.bio_backend.domain.base.file.dto.MultipleFileUploadResponseDto;
+import com.bio.bio_backend.domain.base.file.service.FileService;
+import com.bio.bio_backend.global.dto.ApiResponseDto;
+import com.bio.bio_backend.global.constants.ApiResponseCode;
+import com.bio.bio_backend.global.annotation.LogExecution;
+import com.bio.bio_backend.global.utils.FileUtils;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.responses.ApiResponses;
+import io.swagger.v3.oas.annotations.media.Content;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.core.io.ByteArrayResource;
+import org.springframework.http.HttpHeaders;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.*;
+import com.bio.bio_backend.domain.base.file.entity.File;
+
+
+@Tag(name = "File", description = "파일 업로드/다운로드 API")
+@RestController
+@RequestMapping("/files")
+@RequiredArgsConstructor
+@Slf4j
+public class FileController {
+
+    private final FileService fileService;
+    
+    @LogExecution("파일 업로드")
+    @Operation(summary = "파일 업로드", description = "단일 파일을 업로드합니다.")
+    @ApiResponses({
+        @ApiResponse(responseCode = "200", description = "파일 업로드 성공"),
+        @ApiResponse(responseCode = "400", description = "잘못된 요청 데이터", content = @Content),
+        @ApiResponse(responseCode = "500", description = "파일 업로드 실패", content = @Content)
+    })
+    @PostMapping("/upload")
+    public ResponseEntity<ApiResponseDto<FileUploadResponseDto>> uploadFile(
+            @ModelAttribute FileUploadRequestDto requestDto) {
+        
+        FileUploadResponseDto responseDto = fileService.uploadFile(requestDto);
+        
+        return ResponseEntity.ok(ApiResponseDto.success(ApiResponseCode.FILE_UPLOAD_SUCCESS, responseDto));
+    }
+
+    @LogExecution("다중 파일 업로드")
+    @Operation(summary = "다중 파일 업로드", description = "여러 파일을 동시에 업로드합니다.")
+    @ApiResponses({
+        @ApiResponse(responseCode = "200", description = "다중 파일 업로드 성공"),
+        @ApiResponse(responseCode = "400", description = "잘못된 요청 데이터", content = @Content),
+        @ApiResponse(responseCode = "500", description = "다중 파일 업로드 실패", content = @Content)
+    })
+    @PostMapping("/upload-multiple")
+    public ResponseEntity<ApiResponseDto<MultipleFileUploadResponseDto>> uploadMultipleFiles(
+            @ModelAttribute MultipleFileUploadRequestDto requestDto) {
+        
+        MultipleFileUploadResponseDto responseDto = fileService.uploadMultipleFiles(requestDto);
+        
+        return ResponseEntity.ok(ApiResponseDto.success(ApiResponseCode.FILE_UPLOAD_SUCCESS, responseDto));
+    }
+    
+    @LogExecution("파일 다운로드")
+    @Operation(summary = "파일 다운로드", description = "파일 ID로 파일을 다운로드합니다.")
+    @ApiResponses({
+        @ApiResponse(responseCode = "200", description = "파일 다운로드 성공"),
+        @ApiResponse(responseCode = "404", description = "파일을 찾을 수 없음", content = @Content),
+        @ApiResponse(responseCode = "500", description = "파일 다운로드 실패", content = @Content)
+    })
+    @GetMapping("/download/{oid}")
+    public ResponseEntity<ByteArrayResource> downloadFile(@PathVariable Long oid) {
+        // 파일 정보 먼저 조회
+        File file = fileService.getFileByOid(oid);
+        byte[] fileData = fileService.downloadFile(oid);
+        ByteArrayResource resource = new ByteArrayResource(fileData);
+        
+        return ResponseEntity.ok()
+                .header(HttpHeaders.CONTENT_DISPOSITION, 
+                    "attachment; filename=\"" + file.getOriginalFileName() + "\"")
+                .header(HttpHeaders.CONTENT_TYPE, file.getContentType())
+                .body(resource);
+    }
+    
+    @LogExecution("파일 논리적 삭제")
+    @Operation(summary = "파일 논리적 삭제", description = "파일 ID로 파일을 논리적으로 삭제합니다. (use_flag를 false로 변경)")
+    @ApiResponses({
+        @ApiResponse(responseCode = "200", description = "파일 논리적 삭제 성공"),
+        @ApiResponse(responseCode = "404", description = "파일을 찾을 수 없음", content = @Content),
+        @ApiResponse(responseCode = "500", description = "파일 논리적 삭제 실패", content = @Content)
+    })
+    @DeleteMapping("/{oid}")
+    public ResponseEntity<ApiResponseDto<Void>> deleteFile(@PathVariable Long oid) {
+        fileService.deleteFile(oid);
+        return ResponseEntity.ok(ApiResponseDto.success(ApiResponseCode.FILE_DELETE_SUCCESS));
+    }
+}

src/main/java/com/bio/bio_backend/domain/base/file/dto/FileUploadDto.java

@@ -0,0 +1,16 @@
+package com.bio.bio_backend.domain.base.file.dto;
+
+import lombok.Builder;
+import lombok.Data;
+import java.util.List;
+
+@Data
+@Builder
+public class FileUploadDto {
+    private Long groupOid;
+    private List<FileUploadResponseDto> files;  // 파일 정보들
+    private int totalCount;
+    private int successCount;
+    private int failureCount;
+    private List<String> errorMessages;
+}

src/main/java/com/bio/bio_backend/domain/base/file/dto/FileUploadRequestDto.java

@@ -0,0 +1,10 @@
+package com.bio.bio_backend.domain.base.file.dto;
+
+import lombok.Data;
+import org.springframework.web.multipart.MultipartFile;
+
+@Data
+public class FileUploadRequestDto {
+    private MultipartFile file;
+    private String description;
+}

src/main/java/com/bio/bio_backend/domain/base/file/dto/FileUploadResponseDto.java

@@ -0,0 +1,15 @@
+package com.bio.bio_backend.domain.base.file.dto;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+import lombok.Builder;
+import lombok.Data;
+
+@Data
+@Builder
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class FileUploadResponseDto {
+    private Long oid;
+    private Long groupOid;
+    private String originalFileName;
+    private String downloadUrl;
+}

src/main/java/com/bio/bio_backend/domain/base/file/dto/MultipleFileUploadRequestDto.java

@@ -0,0 +1,13 @@
+package com.bio.bio_backend.domain.base.file.dto;
+
+import lombok.Builder;
+import lombok.Data;
+import org.springframework.web.multipart.MultipartFile;
+import java.util.List;
+
+@Data
+@Builder
+public class MultipleFileUploadRequestDto {
+    private List<MultipartFile> files;
+    private String description;
+}

src/main/java/com/bio/bio_backend/domain/base/file/dto/MultipleFileUploadResponseDto.java

@@ -0,0 +1,16 @@
+package com.bio.bio_backend.domain.base.file.dto;
+
+import lombok.Builder;
+import lombok.Data;
+import java.util.List;
+
+@Data
+@Builder
+public class MultipleFileUploadResponseDto {
+    private List<FileUploadResponseDto> files;
+    private Long groupOid;
+    private int totalCount;
+    private int successCount;
+    private int failureCount;
+    private List<String> errorMessages;
+}

src/main/java/com/bio/bio_backend/domain/base/file/entity/File.java

@@ -0,0 +1,50 @@
+package com.bio.bio_backend.domain.base.file.entity;
+
+import com.bio.bio_backend.global.constants.AppConstants;
+import com.bio.bio_backend.global.entity.BaseEntity;
+import jakarta.persistence.*;
+import lombok.*;
+import org.hibernate.annotations.Comment;
+
+@Entity
+@Table(name = AppConstants.TABLE_PREFIX + "file")
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class File extends BaseEntity {
+    
+    @Column(nullable = false)
+    @Comment("원본 파일명")
+    private String originalFileName;
+    
+    @Column(nullable = false)
+    @Comment("저장 파일명")
+    private String storedFileName;
+    
+    @Column(nullable = false)
+    @Comment("파일 경로")
+    private String filePath;
+        
+    @Column(nullable = false)
+    @Comment("파일 크기")
+    private Long fileSize;
+    
+    @Column(nullable = false)
+    @Comment("콘텐츠 타입")
+    private String contentType;
+    
+    @Column
+    @Comment("설명")
+    private String description;
+    
+    @Column
+    @Comment("그룹 OID")
+    private Long groupOid;
+    
+    @Column(nullable = false)
+    @Comment("사용 여부")
+    @Builder.Default
+    private Boolean useFlag = true;
+}

src/main/java/com/bio/bio_backend/domain/base/file/repository/FileRepository.java

@@ -0,0 +1,13 @@
+package com.bio.bio_backend.domain.base.file.repository;
+
+import com.bio.bio_backend.domain.base.file.entity.File;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import java.util.Optional;
+
+@Repository
+public interface FileRepository extends JpaRepository<File, Long> {
+
+    Optional<File> findByOidAndUseFlagTrue(Long id);
+}

src/main/java/com/bio/bio_backend/domain/base/file/service/FileService.java

@@ -0,0 +1,15 @@
+package com.bio.bio_backend.domain.base.file.service;
+
+import com.bio.bio_backend.domain.base.file.dto.FileUploadRequestDto;
+import com.bio.bio_backend.domain.base.file.dto.FileUploadResponseDto;
+import com.bio.bio_backend.domain.base.file.dto.MultipleFileUploadRequestDto;
+import com.bio.bio_backend.domain.base.file.dto.MultipleFileUploadResponseDto;
+import com.bio.bio_backend.domain.base.file.entity.File;
+
+public interface FileService {
+    FileUploadResponseDto uploadFile(FileUploadRequestDto requestDto);
+    MultipleFileUploadResponseDto uploadMultipleFiles(MultipleFileUploadRequestDto requestDto);
+    File getFileByOid(Long oid);
+    byte[] downloadFile(Long oid);
+    void deleteFile(Long oid); // 논리적 삭제 (use_flag를 false로 변경)
+}

src/main/java/com/bio/bio_backend/domain/base/file/service/FileServiceImpl.java

@@ -0,0 +1,206 @@
+package com.bio.bio_backend.domain.base.file.service;
+
+import com.bio.bio_backend.domain.base.file.dto.FileUploadRequestDto;
+import com.bio.bio_backend.domain.base.file.dto.FileUploadResponseDto;
+import com.bio.bio_backend.domain.base.file.dto.MultipleFileUploadRequestDto;
+import com.bio.bio_backend.domain.base.file.dto.MultipleFileUploadResponseDto;
+import com.bio.bio_backend.domain.base.file.entity.File;
+import com.bio.bio_backend.domain.base.file.repository.FileRepository;
+import com.bio.bio_backend.global.exception.ApiException;
+import com.bio.bio_backend.global.constants.ApiResponseCode;
+import com.bio.bio_backend.global.utils.FileUtils;
+import com.bio.bio_backend.global.utils.SecurityUtils;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.web.multipart.MultipartFile;
+
+import java.io.IOException;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.nio.file.Paths;
+import java.util.ArrayList;
+import java.util.List;
+
+import static com.bio.bio_backend.global.utils.OidUtils.generateOid;
+
+@Service
+@RequiredArgsConstructor
+@Slf4j
+@Transactional(readOnly = true)
+public class FileServiceImpl implements FileService {
+
+    private final FileRepository fileRepository;
+    
+    @Value("${app.file.upload.path}")
+    private String uploadPath;
+    
+    @Value("${server.servlet.context-path}")
+    private String contextPath;
+    
+    @Override
+    @Transactional
+    public FileUploadResponseDto uploadFile(FileUploadRequestDto requestDto) {
+        MultipartFile multipartFile = requestDto.getFile();
+        
+        try {
+            // 파일 유효성 검사
+            FileUtils.validateFile(multipartFile);
+        } catch (IllegalArgumentException e) {
+            throw new ApiException(ApiResponseCode.FILE_EMPTY);
+        }
+        
+        // 파일 업로드 처리
+        File savedFile = processFileUpload(multipartFile, requestDto.getDescription(), generateOid());
+        
+        // 응답 DTO 생성 및 반환
+        return FileUploadResponseDto.builder()
+            .oid(savedFile.getOid())
+            .groupOid(savedFile.getGroupOid())
+            .originalFileName(savedFile.getOriginalFileName())
+            .downloadUrl(contextPath + "/files/download/" + savedFile.getOid())
+            .build();
+    }
+    
+    @Override
+    @Transactional
+    public MultipleFileUploadResponseDto uploadMultipleFiles(MultipleFileUploadRequestDto requestDto) {
+        List<MultipartFile> files = requestDto.getFiles();
+        
+        try {
+            // 파일 리스트 유효성 검사
+            FileUtils.validateFileList(files);
+        } catch (IllegalArgumentException e) {
+            throw new ApiException(ApiResponseCode.FILE_EMPTY);
+        }
+        
+        List<FileUploadResponseDto> uploadedFiles = new ArrayList<>();
+        List<String> errorMessages = new ArrayList<>();
+        int successCount = 0;
+        int failureCount = 0;
+
+        Long groupOid = generateOid();
+        for (MultipartFile multipartFile : files) {
+            try {
+                // 개별 파일 유효성 검사
+                if (multipartFile.isEmpty()) {
+                    String errorMsg = "파일 '" + multipartFile.getOriginalFilename() + "'이 비어있습니다.";
+                    errorMessages.add(errorMsg);
+                    failureCount++;
+                    continue;
+                }
+                
+                // 단일 파일 업로드 처리
+                File savedFile = processFileUpload(multipartFile, requestDto.getDescription(), groupOid);
+                FileUploadResponseDto uploadedFile = FileUploadResponseDto.builder()
+                                .oid(savedFile.getOid())
+                                .originalFileName(savedFile.getOriginalFileName())
+                                .downloadUrl(contextPath + "/files/download/" + savedFile.getOid())
+                                .build();
+                
+                uploadedFiles.add(uploadedFile);
+                successCount++;
+                
+                log.info("파일 업로드 성공: {}", multipartFile.getOriginalFilename());
+                
+            } catch (Exception ex) {
+                String fileName = multipartFile.getOriginalFilename() != null ? multipartFile.getOriginalFilename() : "알 수 없는 파일";
+                log.error("파일 업로드 실패: {}", fileName, ex);
+                errorMessages.add("파일 '" + fileName + "' 업로드 실패: " + ex.getMessage());
+                failureCount++;
+            }
+        }
+        
+        return MultipleFileUploadResponseDto.builder()
+                .groupOid(groupOid)
+                .files(uploadedFiles)
+                .totalCount(files.size())
+                .successCount(successCount)
+                .failureCount(failureCount)
+                .errorMessages(errorMessages)
+                .build();
+    }
+    
+    /**
+     * 파일 업로드 처리
+     */
+    private File processFileUpload(MultipartFile multipartFile, String description, Long groupOid) {
+        String originalFileName = FileUtils.cleanFileName(multipartFile.getOriginalFilename());
+        
+        try {
+            // 항상 년월일 기반으로 폴더 생성 (예: uploads/2024/01/15/)
+            Path uploadDir = FileUtils.createYearMonthUploadDirectory(uploadPath);
+            log.debug("년월 기반 폴더 사용: {}", uploadDir);
+            
+            // 파일명 및 확장자 처리
+            String fileExtension = FileUtils.extractFileExtension(originalFileName);
+            String storedFileName = FileUtils.generateUniqueFileName(fileExtension);
+            
+            // 파일 저장
+            Path targetLocation = FileUtils.saveFileToDisk(multipartFile, uploadDir, storedFileName);
+            
+            // DB에 파일 정보 저장
+            File file = createFileEntity(originalFileName, storedFileName, targetLocation, multipartFile, description, groupOid);
+            
+            return fileRepository.save(file);
+            
+        } catch (IOException ex) {
+            log.error("파일 업로드 실패: {}", originalFileName, ex);
+            throw new ApiException(ApiResponseCode.FILE_UPLOAD_FAILED, ex);
+        }
+    }
+
+    private File createFileEntity(String originalFileName, String storedFileName, Path targetLocation, 
+                                MultipartFile multipartFile, String description, Long groupOid) {
+        return File.builder()
+                .originalFileName(originalFileName)
+                .storedFileName(storedFileName)
+                .filePath(targetLocation.toString())
+                .fileSize(multipartFile.getSize())
+                .contentType(multipartFile.getContentType())
+                .description(description)
+                .groupOid(groupOid)
+                .build();
+    }
+    
+    @Override
+    public File getFileByOid(Long oid) {
+        return fileRepository.findByOidAndUseFlagTrue(oid)
+                .orElseThrow(() -> new ApiException(ApiResponseCode.FILE_NOT_FOUND));
+    }
+    
+    @Override
+    public byte[] downloadFile(Long oid) {
+        File file = fileRepository.findByOidAndUseFlagTrue(oid)
+                .orElseThrow(() -> new ApiException(ApiResponseCode.FILE_NOT_FOUND));
+        
+        try {
+            Path filePath = Paths.get(file.getFilePath());
+            return Files.readAllBytes(filePath);
+        } catch (IOException ex) {
+            log.error("파일 다운로드 실패: {}", file.getOriginalFileName(), ex);
+            throw new ApiException(ApiResponseCode.FILE_DOWNLOAD_FAILED, ex);
+        }
+    }
+    
+    @Override
+    @Transactional
+    public void deleteFile(Long oid) {
+        File file = fileRepository.findByOidAndUseFlagTrue(oid)
+                .orElseThrow(() -> new ApiException(ApiResponseCode.FILE_NOT_FOUND));
+
+        String currentUserId = SecurityUtils.getCurrentUserId();
+        // 현재 사용자가 파일 소유자인지 확인
+        if (currentUserId == null || !currentUserId.equals(file.getCreatedId())) {
+            throw new ApiException(ApiResponseCode.COMMON_FORBIDDEN);
+        }
+        
+        // 논리적 삭제: use_flag를 false로 변경
+        file.setUseFlag(false);
+        fileRepository.save(file);
+        
+        log.info("파일 논리적 삭제 완료: oid={}, fileName={}", oid, file.getOriginalFileName());
+    }
+}

src/main/java/com/bio/bio_backend/domain/base/member/controller/MemberController.java

@@ -0,0 +1,112 @@
+package com.bio.bio_backend.domain.base.member.controller;
+
+import com.bio.bio_backend.global.dto.ApiResponseDto;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.*;
+
+import jakarta.validation.Valid;
+import com.bio.bio_backend.domain.base.member.dto.MemberDto;
+import com.bio.bio_backend.domain.base.member.dto.GetMemberResponseDto;
+import com.bio.bio_backend.domain.base.member.dto.CreateMemberRequestDto;
+import com.bio.bio_backend.domain.base.member.dto.CreateMemberResponseDto;
+
+import com.bio.bio_backend.domain.base.member.dto.MemberSearchCondition;
+import com.bio.bio_backend.domain.base.member.dto.GetMembersRequestDto;
+import com.bio.bio_backend.domain.base.member.dto.GetMembersPagedRequestDto;
+import com.bio.bio_backend.global.dto.PagedResult;
+import com.bio.bio_backend.domain.base.member.service.MemberService;
+import com.bio.bio_backend.domain.base.member.mapper.MemberMapper;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.responses.ApiResponses;
+import io.swagger.v3.oas.annotations.media.Content;
+import io.swagger.v3.oas.annotations.media.Schema;
+import com.bio.bio_backend.global.constants.ApiResponseCode;
+import com.bio.bio_backend.global.annotation.LogExecution;
+import com.bio.bio_backend.global.utils.SecurityUtils;
+import com.bio.bio_backend.global.utils.JwtUtils;
+import jakarta.servlet.http.HttpServletResponse;
+
+
+import java.util.List;
+
+
+@Tag(name = "Member", description = "회원 관련 API")
+@RestController
+@RequestMapping("/members")
+@RequiredArgsConstructor
+@Slf4j
+public class MemberController {
+
+    private final MemberService memberService;
+    private final MemberMapper memberMapper;
+    private final JwtUtils jwtUtils;
+
+    @LogExecution("회원 등록")
+    @Operation(summary = "회원 등록", description = "새로운 회원을 등록합니다.")
+    @ApiResponses({
+        @ApiResponse(responseCode = "201", description = "회원 가입 성공"),
+        @ApiResponse(responseCode = "400", description = "잘못된 요청 데이터", content = @Content),
+        @ApiResponse(responseCode = "409", description = "중복된 사용자 정보", content = @Content)
+    })
+    @PostMapping("/register")
+    public ResponseEntity<ApiResponseDto<CreateMemberResponseDto>> createMember(@RequestBody @Valid CreateMemberRequestDto requestDto) {
+        MemberDto createdMember = memberService.createMember(memberMapper.toMemberDto(requestDto));
+        CreateMemberResponseDto responseDto = memberMapper.toCreateMemberResponseDto(createdMember);
+        ApiResponseDto<CreateMemberResponseDto> apiResponse = ApiResponseDto.success(ApiResponseCode.COMMON_SUCCESS_CREATED, responseDto);
+        
+        return ResponseEntity.status(HttpStatus.CREATED).body(apiResponse);
+    }
+
+    @LogExecution("회원 목록 조회")
+    @Operation(summary = "회원 목록 조회", description = "활성화된 모든 회원의 목록을 조회합니다.")
+    @ApiResponses({
+        @ApiResponse(responseCode = "200", description = "회원 목록 조회 성공"),
+        @ApiResponse(responseCode = "400", description = "잘못된 요청 파라미터", content = @Content)
+    })
+    @GetMapping
+    public ResponseEntity<ApiResponseDto<List<GetMemberResponseDto>>> getMembers(@ModelAttribute GetMembersRequestDto requestDto) {
+        MemberSearchCondition condition = memberMapper.toSearchCondition(requestDto);
+        List<GetMemberResponseDto> members = memberService.getMembers(condition);
+        ApiResponseDto<List<GetMemberResponseDto>> apiResponse = ApiResponseDto.success(ApiResponseCode.COMMON_SUCCESS, members);
+        log.info("회원 목록 조회 완료: {}명", members.size());
+
+        return ResponseEntity.ok(apiResponse);
+    }
+
+    @LogExecution("회원 목록 조회 (페이지네이션)")
+    @Operation(summary = "회원 목록 조회 (페이지네이션)", description = "페이지네이션을 적용한 회원 목록을 조회합니다.")
+    @ApiResponses({
+        @ApiResponse(responseCode = "200", description = "회원 목록 조회 성공"),
+        @ApiResponse(responseCode = "400", description = "잘못된 요청 파라미터", content = @Content)
+    })
+    @GetMapping("/paged")
+    public ResponseEntity<ApiResponseDto<PagedResult<GetMemberResponseDto>>> getMembersPaged(@ModelAttribute GetMembersPagedRequestDto requestDto) {
+        MemberSearchCondition condition = memberMapper.toSearchCondition(requestDto);
+        PagedResult<GetMemberResponseDto> pagedMembers = memberService.getMembersPaged(condition, requestDto.getPage(), requestDto.getSize());
+        ApiResponseDto<PagedResult<GetMemberResponseDto>> apiResponse = ApiResponseDto.success(ApiResponseCode.COMMON_SUCCESS, pagedMembers);
+        log.info("페이지네이션된 회원 목록 조회 완료: 페이지={}, 크기={}, 전체={}명", requestDto.getPage(), requestDto.getSize(), pagedMembers.getTotalElements());
+
+        return ResponseEntity.ok(apiResponse);
+    }
+
+    @LogExecution("로그아웃")
+    @Operation(summary = "로그아웃", description = "사용자 로그아웃을 처리합니다.")
+    @ApiResponses({
+        @ApiResponse(responseCode = "200", description = "로그아웃 성공")
+    })
+    @PostMapping("/logout")
+    public ResponseEntity<ApiResponseDto<Void>> logout(HttpServletResponse response) {
+        String userId = SecurityUtils.getCurrentUserId();
+        memberService.deleteRefreshToken(userId);
+        // 모든 토큰 쿠키 삭제
+        jwtUtils.deleteAllTokenCookies(response);
+        log.info("사용자 로그아웃 완료: {}", userId);
+
+        return ResponseEntity.ok(ApiResponseDto.success(ApiResponseCode.COMMON_SUCCESS));
+    }
+}

src/main/java/com/bio/bio_backend/domain/base/member/dto/CreateMemberRequestDto.java

@@ -1,4 +1,4 @@
-package com.bio.bio_backend.domain.user.member.dto;
+package com.bio.bio_backend.domain.base.member.dto;
 
 import lombok.AllArgsConstructor;
 import lombok.Builder;
@@ -6,6 +6,7 @@ import lombok.Data;
 import lombok.NoArgsConstructor;
 
 import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Email;
 
 @Data
 @Builder
@@ -18,4 +19,11 @@ public class CreateMemberRequestDto {
     
     @NotBlank(message = "비밀번호는 필수입니다.")
     private String password;
+    
+    @NotBlank(message = "사용자명은 필수입니다.")
+    private String name;
+    
+    @NotBlank(message = "이메일은 필수입니다.")
+    @Email(message = "올바른 이메일 형식이 아닙니다.")
+    private String email;
 }

src/main/java/com/bio/bio_backend/domain/base/member/dto/CreateMemberResponseDto.java

@@ -1,6 +1,5 @@
-package com.bio.bio_backend.domain.user.member.dto;
+package com.bio.bio_backend.domain.base.member.dto;
 
-import com.bio.bio_backend.domain.user.member.enums.MemberRole;
 import lombok.AllArgsConstructor;
 import lombok.Builder;
 import lombok.Data;
@@ -16,7 +15,6 @@ public class CreateMemberResponseDto {
     
     private Long oid;
     private String userId;
-    private MemberRole role;
     private Boolean useFlag;
     private LocalDateTime createdAt;
     private LocalDateTime updatedAt;

src/main/java/com/bio/bio_backend/domain/base/member/dto/GetMemberResponseDto.java

@@ -0,0 +1,28 @@
+package com.bio.bio_backend.domain.base.member.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.time.LocalDateTime;
+
+/**
+ * 회원 조회용 Response DTO
+ * 민감한 정보(password, refreshToken, loginIp)는 제외하고 안전한 정보만 포함
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class GetMemberResponseDto {
+    
+    private Long oid;
+    private String userId;
+    private String name;
+    private String email;
+    private Boolean useFlag;
+    private LocalDateTime lastLoginAt;
+    private LocalDateTime createdAt;
+    private LocalDateTime updatedAt;
+}

src/main/java/com/bio/bio_backend/domain/base/member/dto/GetMembersPagedRequestDto.java

@@ -0,0 +1,25 @@
+package com.bio.bio_backend.domain.base.member.dto;
+
+import com.bio.bio_backend.global.dto.BasePagedRequestDto;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * 회원 목록 조회 요청용 DTO (검색 조건 + 페이지네이션 포함)
+ * GET /members/paged
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class GetMembersPagedRequestDto extends BasePagedRequestDto {
+    
+    private String userId;
+    private String name;
+    private String email;
+    private String searchKeyword;
+    private String createdDateFrom;
+    private String createdDateTo;
+    private String lastLoginFrom;
+    private String lastLoginTo;
+}

src/main/java/com/bio/bio_backend/domain/base/member/dto/GetMembersRequestDto.java

@@ -0,0 +1,22 @@
+package com.bio.bio_backend.domain.base.member.dto;
+
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * 회원 목록 조회 요청용 DTO (검색 조건만 포함)
+ * GET /members
+ */
+@Data
+@NoArgsConstructor
+public class GetMembersRequestDto {
+    
+    private String userId;
+    private String name;
+    private String email;
+    private String searchKeyword;
+    private String createdDateFrom;
+    private String createdDateTo;
+    private String lastLoginFrom;
+    private String lastLoginTo;
+}

src/main/java/com/bio/bio_backend/domain/base/member/dto/LoginRequestDto.java

@@ -1,4 +1,4 @@
-package com.bio.bio_backend.domain.user.member.dto;
+package com.bio.bio_backend.domain.base.member.dto;
 
 import lombok.AllArgsConstructor;
 import lombok.Builder;

src/main/java/com/bio/bio_backend/domain/base/member/dto/LoginResponseDto.java

@@ -1,4 +1,4 @@
-package com.bio.bio_backend.domain.user.member.dto;
+package com.bio.bio_backend.domain.base.member.dto;
 
 import lombok.AllArgsConstructor;
 import lombok.Builder;
@@ -14,6 +14,6 @@ import java.time.LocalDateTime;
 public class LoginResponseDto {
     
     private String userId;
-    private String role;
+    private String name;
     private LocalDateTime lastLoginAt;
 }

src/main/java/com/bio/bio_backend/domain/base/member/dto/MemberDto.java

@@ -1,12 +1,10 @@
-package com.bio.bio_backend.domain.user.member.dto;
+package com.bio.bio_backend.domain.base.member.dto;
 
-import com.bio.bio_backend.domain.user.member.enums.MemberRole;
 import lombok.AllArgsConstructor;
 import lombok.Builder;
 import lombok.Data;
 import lombok.NoArgsConstructor;
 import org.springframework.security.core.GrantedAuthority;
-import org.springframework.security.core.authority.SimpleGrantedAuthority;
 import org.springframework.security.core.userdetails.UserDetails;
 
 import java.time.LocalDateTime;
@@ -22,16 +20,18 @@ public class MemberDto implements UserDetails {
     private Long oid;
     private String userId;
     private String password;
-    private MemberRole role;
+    private String name;
+    private String email;
     private Boolean useFlag;
     private String refreshToken;
+    private String loginIp;
     private LocalDateTime lastLoginAt;
     private LocalDateTime createdAt;
     private LocalDateTime updatedAt;
     
     @Override
     public Collection<? extends GrantedAuthority> getAuthorities() {
-        return Collections.singletonList(new SimpleGrantedAuthority("ROLE_" + this.role.getValue()));
+        return Collections.emptyList();
     }
     
     @Override
@@ -39,21 +39,11 @@ public class MemberDto implements UserDetails {
         return this.userId;
     }
     
-    @Override
-    public boolean isAccountNonExpired() {
-        return true;
-    }
-    
     @Override
     public boolean isAccountNonLocked() {
         return this.useFlag != null && this.useFlag;
     }
     
-    @Override
-    public boolean isCredentialsNonExpired() {
-        return true;
-    }
-    
     @Override
     public boolean isEnabled() {
         return this.useFlag != null && this.useFlag;

src/main/java/com/bio/bio_backend/domain/base/member/dto/MemberSearchCondition.java

@@ -0,0 +1,23 @@
+package com.bio.bio_backend.domain.base.member.dto;
+
+import lombok.Builder;
+import lombok.Getter;
+import lombok.Setter;
+
+/**
+ * 회원 검색 조건
+ */
+@Builder
+@Getter
+@Setter
+public class MemberSearchCondition {
+    
+    private String userId;
+    private String name;
+    private String email;
+    private String searchKeyword;
+    private String createdDateFrom;
+    private String createdDateTo;
+    private String lastLoginFrom;
+    private String lastLoginTo;
+}

src/main/java/com/bio/bio_backend/domain/base/member/entity/Member.java

@@ -1,6 +1,6 @@
-package com.bio.bio_backend.domain.user.member.entity;
+package com.bio.bio_backend.domain.base.member.entity;
 
-import com.bio.bio_backend.domain.user.member.enums.MemberRole;
+import com.bio.bio_backend.global.constants.AppConstants;
 import com.bio.bio_backend.global.entity.BaseEntity;
 import jakarta.persistence.*;
 import lombok.AllArgsConstructor;
@@ -11,13 +11,15 @@ import lombok.Setter;
 
 import java.time.LocalDateTime;
 
+import org.hibernate.annotations.Comment;
+
 @Entity
 @Getter @Setter
 @NoArgsConstructor
 @AllArgsConstructor
 @Builder
 @Table(
-    name = "st_member",
+    name = AppConstants.TABLE_PREFIX + "member",
     indexes = {
         @Index(name = "idx_member_user_id", columnList = "user_id")
     }
@@ -25,23 +27,36 @@ import java.time.LocalDateTime;
 public class Member extends BaseEntity {
 
     @Column(name = "user_id", nullable = false, length = 100)
+    @Comment("사용자 ID")
     private String userId;
 
     @Column(name = "password", nullable = false, length = 100)
+    @Comment("비밀번호")
     private String password;
 
-    @Enumerated(EnumType.STRING)
+    @Column(name = "name", nullable = false, length = 100)
-    @Column(name = "role", nullable = false, length = 40)
+    @Comment("이름")
-    private MemberRole role;
+    private String name;
+
+    @Column(name = "email", nullable = false, length = 255)
+    @Comment("이메일")
+    private String email;
 
     @Column(name = "use_flag", nullable = false)
+    @Comment("사용 여부")
     @Builder.Default
     private Boolean useFlag = true;
 
-    @Column(name = "refresh_token", length = 200)
+    @Column(name = "refresh_token", length = 1024)
+    @Comment("리프레시 토큰")
     private String refreshToken;
 
+    @Column(name = "login_ip", length = 45)  // IPv6 지원을 위해 45자
+    @Comment("로그인 IP")
+    private String loginIp;
+
     @Column(name = "last_login_at")
+    @Comment("마지막 로그인 일시")
     private LocalDateTime lastLoginAt;
     
 }

src/main/java/com/bio/bio_backend/domain/base/member/mapper/MemberMapper.java

@@ -0,0 +1,84 @@
+package com.bio.bio_backend.domain.base.member.mapper;
+
+import com.bio.bio_backend.domain.base.member.dto.CreateMemberRequestDto;
+import com.bio.bio_backend.domain.base.member.dto.CreateMemberResponseDto;
+import com.bio.bio_backend.domain.base.member.dto.LoginResponseDto;
+import com.bio.bio_backend.domain.base.member.dto.MemberDto;
+import com.bio.bio_backend.domain.base.member.dto.MemberSearchCondition;
+import com.bio.bio_backend.domain.base.member.dto.GetMembersRequestDto;
+import com.bio.bio_backend.domain.base.member.dto.GetMembersPagedRequestDto;
+import com.bio.bio_backend.domain.base.member.dto.GetMemberResponseDto;
+import com.bio.bio_backend.domain.base.member.entity.Member;
+import com.bio.bio_backend.global.annotation.IgnoreBaseEntityMapping;
+import com.bio.bio_backend.global.config.GlobalMapperConfig;
+import org.mapstruct.Mapper;
+import org.mapstruct.Mapping;
+import java.util.List;
+
+@Mapper(config = GlobalMapperConfig.class)
+public interface MemberMapper {
+    
+    /**
+     * CreateMemberRequestDto를 MemberDto로 변환
+     * 기본값 설정: useFlag = true
+     */
+    @Mapping(target = "oid", ignore = true)
+    @Mapping(target = "useFlag", constant = "true")
+    @Mapping(target = "refreshToken", ignore = true)
+    @Mapping(target = "loginIp", ignore = true)
+    @Mapping(target = "lastLoginAt", ignore = true)
+    @Mapping(target = "createdAt", ignore = true)
+    @Mapping(target = "updatedAt", ignore = true)
+    MemberDto toMemberDto(CreateMemberRequestDto requestDto);
+    
+    /**
+     * Member 엔티티를 MemberDto로 변환
+     */
+    MemberDto toMemberDto(Member member);
+    
+    /**
+     * MemberDto를 Member 엔티티로 변환
+     */
+    Member toMember(MemberDto memberDto);
+    
+    /**
+     * Member 엔티티 리스트를 MemberDto 리스트로 변환
+     */
+    List<MemberDto> toMemberDtoList(List<Member> members);
+    
+    /**
+     * MemberDto를 CreateMemberResponseDto로 변환
+     */
+    CreateMemberResponseDto toCreateMemberResponseDto(MemberDto memberDto);
+    
+    /**
+     * MemberDto의 값으로 기존 Member 엔티티 업데이트 (null이 아닌 필드만)
+     */
+    @IgnoreBaseEntityMapping
+    void updateMemberFromDto(MemberDto memberDto, @org.mapstruct.MappingTarget Member member);
+    
+    /**
+     * MemberDto를 LoginResponseDto로 변환
+     */
+    LoginResponseDto toLoginResponseDto(MemberDto memberDto);
+    
+    /**
+     * Member 엔티티를 GetMemberResponseDto로 변환 (민감한 정보 제외)
+     */
+    GetMemberResponseDto toGetMemberResponseDto(Member member);
+    
+    /**
+     * Member 엔티티 리스트를 GetMemberResponseDto 리스트로 변환 (민감한 정보 제외)
+     */
+    List<GetMemberResponseDto> toGetMemberResponseDtoList(List<Member> members);
+    
+    /**
+     * GetMembersRequestDto를 MemberSearchCondition으로 변환
+     */
+    MemberSearchCondition toSearchCondition(GetMembersRequestDto request);
+    
+    /**
+     * GetMembersPagedRequestDto를 MemberSearchCondition으로 변환
+     */
+    MemberSearchCondition toSearchCondition(GetMembersPagedRequestDto request);
+}

src/main/java/com/bio/bio_backend/domain/base/member/repository/MemberRepository.java

@@ -0,0 +1,22 @@
+package com.bio.bio_backend.domain.base.member.repository;
+
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import com.bio.bio_backend.domain.base.member.entity.Member;
+import java.util.List;
+
+@Repository
+public interface MemberRepository extends JpaRepository<Member, Long>, MemberRepositoryCustom {
+
+    // 사용자 ID 존재 여부 확인
+    boolean existsByUserId(String userId);
+    
+    // 활성화된 회원 목록 조회
+    List<Member> findByUseFlagTrue();
+    
+    // 활성화된 회원 목록 조회 (페이지네이션)
+    Page<Member> findByUseFlagTrue(Pageable pageable);
+}

src/main/java/com/bio/bio_backend/domain/base/member/repository/MemberRepositoryCustom.java

@@ -0,0 +1,36 @@
+package com.bio.bio_backend.domain.base.member.repository;
+
+import com.bio.bio_backend.domain.base.member.dto.MemberSearchCondition;
+import com.bio.bio_backend.domain.base.member.entity.Member;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import java.util.List;
+import java.util.Optional;
+
+public interface MemberRepositoryCustom {
+
+    /**
+     * 활성화된 사용자 중에서 사용자 ID로 검색하여 조회합니다.
+     *
+     * @param userId 사용자 ID
+     * @return Optional<Member> 회원 정보 (없으면 empty)
+     */
+    Optional<Member> findActiveMemberByUserId(String userId);
+    
+    /**
+     * QueryDSL을 사용한 회원 목록 조회 (검색 조건 + 페이징)
+     *
+     * @param condition 검색 조건
+     * @param pageable 페이징 정보
+     * @return Page<Member> 검색된 회원 목록
+     */
+    Page<Member> findMembers(MemberSearchCondition condition, Pageable pageable);
+    
+    /**
+     * QueryDSL을 사용한 회원 목록 조회 (검색 조건)
+     *
+     * @param condition 검색 조건
+     * @return List<Member> 검색된 회원 목록
+     */
+    List<Member> findMembers(MemberSearchCondition condition);
+}

src/main/java/com/bio/bio_backend/domain/base/member/repository/MemberRepositoryImpl.java

@@ -0,0 +1,129 @@
+package com.bio.bio_backend.domain.base.member.repository;
+
+import com.bio.bio_backend.domain.base.member.dto.MemberSearchCondition;
+import com.bio.bio_backend.domain.base.member.entity.Member;
+import com.bio.bio_backend.domain.base.member.entity.QMember;
+import com.querydsl.core.BooleanBuilder;
+import com.querydsl.jpa.impl.JPAQueryFactory;
+import lombok.RequiredArgsConstructor;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.PageImpl;
+import org.springframework.data.domain.Pageable;
+import org.springframework.stereotype.Repository;
+import org.springframework.util.StringUtils;
+
+import java.time.LocalDate;
+import java.time.format.DateTimeFormatter;
+import java.util.List;
+import java.util.Optional;
+
+/**
+ * QueryDSL을 활용하여 MemberRepositoryCustom 인터페이스를 구현하는 클래스
+ * 복잡한 쿼리나 동적 쿼리를 QueryDSL로 작성하여 성능과 가독성을 향상시킵니다.
+ */
+@Repository
+@RequiredArgsConstructor
+public class MemberRepositoryImpl implements MemberRepositoryCustom {
+
+    private final JPAQueryFactory queryFactory;
+    private final QMember member = QMember.member;
+
+    @Override
+    public Optional<Member> findActiveMemberByUserId(String userId) {
+        // 활성화된 사용자 중에서 사용자 ID로 검색
+        Member foundMember = queryFactory
+                .selectFrom(member)
+                .where(member.userId.eq(userId)
+                        .and(member.useFlag.eq(true)))
+                .fetchOne();
+
+        return Optional.ofNullable(foundMember);
+    }
+
+    @Override
+    public Page<Member> findMembers(MemberSearchCondition condition, Pageable pageable) {
+        BooleanBuilder builder = buildSearchConditions(condition);
+        
+        List<Member> members = queryFactory
+                .selectFrom(member)
+                .where(builder)
+                .orderBy(member.createdAt.desc())
+                .offset(pageable.getOffset())
+                .limit(pageable.getPageSize())
+                .fetch();
+        
+        Long total = queryFactory
+                .select(member.count())
+                .from(member)
+                .where(builder)
+                .fetchOne();
+        
+        return new PageImpl<>(members, pageable, total);
+    }
+    
+    @Override
+    public List<Member> findMembers(MemberSearchCondition condition) {
+        return queryFactory
+                .selectFrom(member)
+                .where(buildSearchConditions(condition))
+                .orderBy(member.createdAt.desc())
+                .fetch();
+    }
+    
+    /**
+     * 검색 조건들을 조합하여 BooleanBuilder 생성
+     */
+    private BooleanBuilder buildSearchConditions(MemberSearchCondition condition) {
+        BooleanBuilder builder = new BooleanBuilder();
+        
+        // 기본 조건: useFlag = true (활성화된 회원만 조회)
+        builder.and(member.useFlag.eq(true));
+        
+        // 사용자 ID (정확 일치)
+        if (StringUtils.hasText(condition.getUserId())) {
+            builder.and(member.userId.eq(condition.getUserId()));
+        }
+        
+        // 이름 (부분 일치)
+        if (StringUtils.hasText(condition.getName())) {
+            builder.and(member.name.containsIgnoreCase(condition.getName()));
+        }
+        
+        // 이메일 (부분 일치)
+        if (StringUtils.hasText(condition.getEmail())) {
+            builder.and(member.email.containsIgnoreCase(condition.getEmail()));
+        }
+        
+        // 통합 검색 키워드 (이름, 이메일, 사용자ID에서 검색)
+        if (StringUtils.hasText(condition.getSearchKeyword())) {
+            String keyword = condition.getSearchKeyword();
+            builder.and(member.name.containsIgnoreCase(keyword)
+                    .or(member.email.containsIgnoreCase(keyword))
+                    .or(member.userId.containsIgnoreCase(keyword)));
+        }
+        
+
+        // 생성일 범위
+        if (StringUtils.hasText(condition.getCreatedDateFrom())) {
+            LocalDate fromDate = LocalDate.parse(condition.getCreatedDateFrom(), DateTimeFormatter.ISO_LOCAL_DATE);
+            builder.and(member.createdAt.goe(fromDate.atStartOfDay()));
+        }
+        if (StringUtils.hasText(condition.getCreatedDateTo())) {
+            LocalDate toDate = LocalDate.parse(condition.getCreatedDateTo(), DateTimeFormatter.ISO_LOCAL_DATE);
+            builder.and(member.createdAt.loe(toDate.atTime(23, 59, 59)));
+        }
+        
+        // 마지막 로그인 범위
+        if (StringUtils.hasText(condition.getLastLoginFrom())) {
+            LocalDate fromDate = LocalDate.parse(condition.getLastLoginFrom(), DateTimeFormatter.ISO_LOCAL_DATE);
+            builder.and(member.lastLoginAt.goe(fromDate.atStartOfDay()));
+        }
+        if (StringUtils.hasText(condition.getLastLoginTo())) {
+            LocalDate toDate = LocalDate.parse(condition.getLastLoginTo(), DateTimeFormatter.ISO_LOCAL_DATE);
+            builder.and(member.lastLoginAt.loe(toDate.atTime(23, 59, 59)));
+        }
+        
+        return builder;
+    }
+
+}

src/main/java/com/bio/bio_backend/domain/base/member/scheduler/MemberSyncScheduler.java

@@ -0,0 +1,105 @@
+package com.bio.bio_backend.domain.base.member.scheduler;
+
+import com.bio.bio_backend.domain.base.member.dto.MemberDto;
+import com.bio.bio_backend.domain.base.member.service.MemberService;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import net.javacrumbs.shedlock.spring.annotation.SchedulerLock;
+import org.springframework.scheduling.annotation.Scheduled;
+import org.springframework.stereotype.Service;
+
+import java.util.concurrent.ThreadLocalRandom;
+
+/**
+ * 멤버 동기화 스케줄러
+ * ShedLock을 사용하여 분산 환경에서 중복 실행을 방지합니다.
+ */
+@Service
+@RequiredArgsConstructor
+@Slf4j
+public class MemberSyncScheduler {
+
+    private final MemberService memberService;
+
+    /**
+     * 1시간마다 멤버 동기화를 실행합니다.
+     * 현재는 더미 데이터를 생성하지만, 추후 실제 조직도 연동으로 변경 예정입니다.
+     */
+    @Scheduled(cron = "0 0 * * * *") // 1시간마다
+    @SchedulerLock(name = "memberSync", lockAtMostFor = "50m", lockAtLeastFor = "5m")
+    public void syncMembersAtTopOfHour() {
+        log.info("1시간마다 멤버 동기화 시작");
+        try {
+            int createdCount = createDummyMembers(5); // 1시간마다 5명씩 생성
+            log.info("1시간마다 멤버 동기화 완료: {}명 생성", createdCount);
+        } catch (Exception e) {
+            log.error("1시간마다 멤버 동기화 실패: {}", e.getMessage(), e);
+        }
+    }
+
+    /**
+     * 매일 새벽 2시에 대량 동기화를 실행합니다.
+     */
+    @Scheduled(cron = "0 0 2 * * *") // 매일 새벽 2시
+    @SchedulerLock(name = "memberBulkSync", lockAtMostFor = "30m", lockAtLeastFor = "5m")
+    public void bulkSyncMembers() {
+        log.info("일일 대량 멤버 동기화 시작");
+        try {
+            int createdCount = createDummyMembers(20); // 새벽에 20명씩 생성
+            log.info("일일 대량 멤버 동기화 완료: {}명 생성", createdCount);
+        } catch (Exception e) {
+            log.error("일일 대량 멤버 동기화 실패: {}", e.getMessage(), e);
+        }
+    }
+
+    /**
+     * 더미 멤버를 생성합니다.
+     * 추후 실제 조직도 API 연동으로 변경될 예정입니다.
+     *
+     * @param count 생성할 멤버 수
+     * @return 실제 생성된 멤버 수
+     */
+    private int createDummyMembers(int count) {
+        int createdCount = 0;
+        
+        for (int i = 0; i < count; i++) {
+            try {
+                String randomSuffix = String.valueOf(System.currentTimeMillis() + i);
+                
+                MemberDto memberDto = MemberDto.builder()
+                    .userId("user_" + randomSuffix)
+                    .password("password123") // 실제로는 더 복잡한 패스워드 생성
+                    .name(generateRandomName())
+                    .email("user_" + randomSuffix + "@company.com")
+                    .build();
+                
+                memberService.createMember(memberDto);
+                createdCount++;
+                
+                log.debug("더미 멤버 생성 완료: {}", memberDto.getUserId());
+                
+            } catch (Exception e) {
+                log.warn("더미 멤버 생성 실패 ({}번째): {}", i + 1, e.getMessage());
+                // 개별 멤버 생성 실패는 전체 프로세스를 중단하지 않음
+            }
+        }
+        
+        return createdCount;
+    }
+
+    /**
+     * 랜덤한 이름을 생성합니다.
+     * 실제 환경에서는 조직도에서 가져온 실제 이름을 사용합니다.
+     *
+     * @return 생성된 랜덤 이름
+     */
+    private String generateRandomName() {
+        String[] surnames = {"김", "이", "박", "최", "정", "강", "조", "윤", "장", "임"};
+        String[] givenNames = {"민수", "지영", "현우", "수진", "태현", "은지", "동훈", "예린", "준호", "서연"};
+        
+        String surname = surnames[ThreadLocalRandom.current().nextInt(surnames.length)];
+        String givenName = givenNames[ThreadLocalRandom.current().nextInt(givenNames.length)];
+        
+        return surname + givenName;
+    }
+}

src/main/java/com/bio/bio_backend/domain/base/member/service/MemberService.java

@@ -0,0 +1,40 @@
+package com.bio.bio_backend.domain.base.member.service;
+
+import org.springframework.security.core.userdetails.UserDetails;
+import org.springframework.security.core.userdetails.UserDetailsService;
+
+import com.bio.bio_backend.domain.base.member.dto.MemberDto;
+import com.bio.bio_backend.domain.base.member.dto.GetMemberResponseDto;
+import com.bio.bio_backend.domain.base.member.dto.MemberSearchCondition;
+import com.bio.bio_backend.global.dto.PagedResult;
+
+import java.util.List;
+
+public interface MemberService extends UserDetailsService {
+
+    UserDetails loadUserByUsername(String id);
+
+    MemberDto createMember(MemberDto memberDTO);
+
+    String getRefreshToken(String id);
+
+    void deleteRefreshToken(String id);
+
+    void updateMember(MemberDto member);
+    
+    /**
+     * 검색 조건에 따른 회원 목록 조회
+     * @param condition 검색 조건
+     * @return GetMemberResponseDto 리스트
+     */
+    List<GetMemberResponseDto> getMembers(MemberSearchCondition condition);
+    
+    /**
+     * 페이지네이션된 회원 목록 조회
+     * @param condition 검색 조건
+     * @param page 페이지 번호
+     * @param size 페이지 크기
+     * @return PagedResult<GetMemberResponseDto> 페이지네이션된 회원 목록
+     */
+    PagedResult<GetMemberResponseDto> getMembersPaged(MemberSearchCondition condition, int page, int size);
+}

src/main/java/com/bio/bio_backend/domain/base/member/service/MemberServiceImpl.java

@@ -0,0 +1,113 @@
+package com.bio.bio_backend.domain.base.member.service;
+
+import com.bio.bio_backend.domain.base.member.dto.MemberDto;
+import com.bio.bio_backend.domain.base.member.dto.GetMemberResponseDto;
+import com.bio.bio_backend.domain.base.member.dto.MemberSearchCondition;
+import com.bio.bio_backend.global.dto.PagedResult;
+import com.bio.bio_backend.domain.base.member.entity.Member;
+import com.bio.bio_backend.domain.base.member.mapper.MemberMapper;
+import com.bio.bio_backend.domain.base.member.repository.MemberRepository;
+import com.bio.bio_backend.global.exception.ApiException;
+import com.bio.bio_backend.global.constants.ApiResponseCode;
+import com.bio.bio_backend.global.constants.AppConstants;
+
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.security.core.userdetails.UserDetails;
+import org.springframework.security.core.userdetails.UsernameNotFoundException;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.PageRequest;
+import org.springframework.data.domain.Pageable;
+
+import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.List;
+
+@Service
+@RequiredArgsConstructor
+@Slf4j
+@Transactional(readOnly = true)
+public class MemberServiceImpl implements MemberService {
+
+    private final MemberMapper memberMapper;  // MapStruct Mapper 사용
+    private final MemberRepository memberRepository;
+    private final BCryptPasswordEncoder bCryptPasswordEncoder;
+
+    @Override
+    public UserDetails loadUserByUsername(String id) throws UsernameNotFoundException {
+        Member member = memberRepository.findActiveMemberByUserId(id)
+                .orElseThrow(() -> new UsernameNotFoundException("사용자를 찾을 수 없습니다: " + id));
+        return memberMapper.toMemberDto(member);
+    }
+
+    @Override
+    @Transactional
+    public MemberDto createMember(MemberDto memberDto) {
+        // userId 중복 체크
+        if (memberRepository.existsByUserId(memberDto.getUserId())) {
+            throw new ApiException(ApiResponseCode.USER_ID_DUPLICATE);
+        }
+        
+        Member member = Member.builder()
+                .userId(memberDto.getUserId())
+                .password(bCryptPasswordEncoder.encode(memberDto.getPassword()))
+                .name(memberDto.getName())
+                .email(memberDto.getEmail())
+                .build();
+        
+        member.setCreatedOid(AppConstants.ADMIN_OID);
+        member.setCreatedId(AppConstants.ADMIN_USER_ID);
+        member.setUpdatedOid(AppConstants.ADMIN_OID);
+        member.setUpdatedId(AppConstants.ADMIN_USER_ID);
+        
+        Member savedMember = memberRepository.save(member);
+        
+        return memberMapper.toMemberDto(savedMember);
+    }
+
+    @Override
+    @Transactional
+    public void updateMember(MemberDto memberDto) {
+        Member member = memberRepository.findActiveMemberByUserId(memberDto.getUserId())
+                .orElseThrow(() -> new ApiException(ApiResponseCode.USER_NOT_FOUND));
+        
+        memberMapper.updateMemberFromDto(memberDto, member);
+        memberRepository.save(member);
+    }
+
+    @Override
+    public String getRefreshToken(String id) {
+        Member member = memberRepository.findActiveMemberByUserId(id)
+                .orElseThrow(() -> new ApiException(ApiResponseCode.USER_NOT_FOUND));
+        
+        return member.getRefreshToken();
+    }
+
+    @Override
+    @Transactional
+    public void deleteRefreshToken(String id) {
+        Member member = memberRepository.findActiveMemberByUserId(id)
+                .orElseThrow(() -> new ApiException(ApiResponseCode.USER_NOT_FOUND));
+        
+        member.setRefreshToken(null);
+        memberRepository.save(member);
+    }
+    
+    @Override
+    public List<GetMemberResponseDto> getMembers(MemberSearchCondition condition) {
+        List<Member> members = memberRepository.findMembers(condition);
+        
+        return memberMapper.toGetMemberResponseDtoList(members);
+    }
+    
+    @Override
+    public PagedResult<GetMemberResponseDto> getMembersPaged(MemberSearchCondition condition, int page, int size) {
+        Pageable pageable = PageRequest.of(page, size);
+        Page<Member> memberPage = memberRepository.findMembers(condition, pageable);
+        List<GetMemberResponseDto> members = memberMapper.toGetMemberResponseDtoList(memberPage.getContent());
+
+        return PagedResult.of(memberPage, members);
+    }
+}

src/main/java/com/bio/bio_backend/domain/user/member/controller/MemberController.java

@@ -1,119 +0,0 @@
-package com.bio.bio_backend.domain.user.member.controller;
-
-import com.bio.bio_backend.global.dto.CustomApiResponse;
-import org.springframework.http.HttpStatus;
-import org.springframework.http.ResponseEntity;
-import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
-import org.springframework.web.bind.annotation.GetMapping;
-import org.springframework.web.bind.annotation.PostMapping;
-import org.springframework.web.bind.annotation.RequestBody;
-import org.springframework.web.bind.annotation.RestController;
-
-import jakarta.validation.Valid;
-import com.bio.bio_backend.domain.user.member.dto.MemberDto;
-import com.bio.bio_backend.domain.user.member.dto.CreateMemberRequestDto;
-import com.bio.bio_backend.domain.user.member.dto.CreateMemberResponseDto;
-import com.bio.bio_backend.domain.user.member.service.MemberService;
-import com.bio.bio_backend.domain.user.member.mapper.MemberMapper;
-import lombok.RequiredArgsConstructor;
-import lombok.extern.slf4j.Slf4j;
-import io.swagger.v3.oas.annotations.Operation;
-import io.swagger.v3.oas.annotations.responses.ApiResponse;
-import io.swagger.v3.oas.annotations.responses.ApiResponses;
-import io.swagger.v3.oas.annotations.media.Content;
-import io.swagger.v3.oas.annotations.media.Schema;
-
-
-@RestController
-@RequiredArgsConstructor
-@Slf4j
-public class MemberController {
-
-    private final MemberService memberService;
-    private final MemberMapper memberMapper;
-    private final BCryptPasswordEncoder bCryptPasswordEncoder;
-
-    @Operation(summary = "회원 가입", description = "새로운 회원을 등록합니다.", tags = {"Member"})
-    @ApiResponses({
-        @ApiResponse(responseCode = "201", description = "회원 가입 성공", content = @Content(schema = @Schema(implementation = CreateMemberResponseDto.class))),
-        @ApiResponse(responseCode = "400", description = "잘못된 요청 데이터", content = @Content(schema = @Schema(implementation = CustomApiResponse.class))),
-        @ApiResponse(responseCode = "409", description = "중복된 사용자 정보", content = @Content(schema = @Schema(implementation = CustomApiResponse.class)))
-    })
-    @PostMapping("/members")
-    public ResponseEntity<CreateMemberResponseDto> createMember(@RequestBody @Valid CreateMemberRequestDto requestDto) {
-        MemberDto member = memberMapper.toMemberDto(requestDto);
-        MemberDto createdMember = memberService.createMember(member);
-        CreateMemberResponseDto responseDto = memberMapper.toCreateMemberResponseDto(createdMember);
-
-        return ResponseEntity.status(HttpStatus.CREATED).body(responseDto);
-    }
-
-    // @PostMapping("/member/list")
-    // public ResponseEntity<List<ResponseMember>> getMemberList(@RequestBody(required = false) Map<String, String> params) {
-
-    //     if(params == null){
-    //         params = new HashMap<>();
-    //     }
-
-    //     Iterable<MemberDTO> memberList = memberService.selectMemberList(params);
-
-    //     List<ResponseMember> result = new ArrayList<>();
-
-    //     memberList.forEach(m -> {
-    //         result.add(new ModelMapper().map(m, ResponseMember.class));
-    //     });
-
-    //     return ResponseEntity.status(HttpStatus.OK).body(result);
-    // }
-
-    // @GetMapping("/member/{seq}")
-    // public ResponseEntity<ResponseMember> selectMember(@PathVariable("seq") int seq) {
-
-    //     MemberDTO member = memberService.selectMember(seq);
-
-    //     ResponseMember responseMember = mapper.map(member, ResponseMember.class);
-
-    //     return ResponseEntity.status(HttpStatus.OK).body(responseMember);
-    // }
-
-    // @PutMapping("/member")
-    // public CustomApiResponse<Void> updateMember(@RequestBody @Valid CreateMemberRequestDTO requestMember, @AuthenticationPrincipal MemberDTO registrant) {
-    //     // 현재 JWT는 사용자 id 값을 통하여 생성, 회원정보 변경 시 JWT 재발급 여부 검토
-
-    //     MemberDTO member = mapper.map(requestMember, MemberDTO.class);
-
-    //     if (requestMember.getPassword() != null) {
-    //         member.setPw(bCryptPasswordEncoder.encode(requestMember.getPassword()));
-    //     }
-
-    //     member.setRegSeq(registrant.getSeq());
-    //     memberService.updateMember(member);
-
-    //     return CustomApiResponse.success(ApiResponseCode.USER_INFO_CHANGE, null);
-    // }
-
-    // @DeleteMapping("/member")
-    // public CustomApiResponse<Void> deleteMember(@RequestBody @Valid CreateMemberRequestDTO requestMember){
-
-    //     MemberDTO member = mapper.map(requestMember, MemberDTO.class);
-
-    //     memberService.deleteMember(member);
-
-    //     return CustomApiResponse.success(ApiResponseCode.USER_DELETE_SUCCESSFUL, null);
-    // }
-
-    // @PostMapping("/logout")
-    // public CustomApiResponse<Void> logout(@AuthenticationPrincipal MemberDTO member) {
-
-    //     String id = member.getId();
-
-    //     try {
-    //         memberService.deleteRefreshToken(id);
-    //     } catch (Exception e) {
-    //         return CustomApiResponse.fail(ApiResponseCode.INTERNAL_SERVER_ERROR, null);
-    //     }
-
-    //     return CustomApiResponse.success(ApiResponseCode.LOGOUT_SUCCESSFUL, null);
-    // }
-
-}

src/main/java/com/bio/bio_backend/domain/user/member/enums/MemberRole.java

@@ -1,39 +0,0 @@
-package com.bio.bio_backend.domain.user.member.enums;
-
-import lombok.Getter;
-import lombok.RequiredArgsConstructor;
-
-/**
- * 회원 역할을 정의하는 Enum
- */
-@Getter
-@RequiredArgsConstructor
-public enum MemberRole {
-    
-    MEMBER("MEMBER", "일반 회원"),
-    ADMIN("ADMIN", "관리자"),
-    USER("USER", "사용자"),
-    SYSTEM_ADMIN("SYSTEM_ADMIN", "시스템 관리자");
-    
-    private final String value;
-    private final String description;
-    
-    /**
-     * 문자열 값으로부터 MemberRole을 찾는 메서드
-     */
-    public static MemberRole fromValue(String value) {
-        for (MemberRole role : values()) {
-            if (role.value.equals(value)) {
-                return role;
-            }
-        }
-        throw new IllegalArgumentException("Unknown MemberRole value: " + value);
-    }
-    
-    /**
-     * 기본 역할 반환
-     */
-    public static MemberRole getDefault() {
-        return MEMBER;
-    }
-}

src/main/java/com/bio/bio_backend/domain/user/member/exception/UserDuplicateException.java

@@ -1,12 +0,0 @@
-package com.bio.bio_backend.domain.user.member.exception;
-
-public class UserDuplicateException extends RuntimeException {
-    
-    public UserDuplicateException(String message) {
-        super(message);
-    }
-    
-    public UserDuplicateException(String message, Throwable cause) {
-        super(message, cause);
-    }
-}

src/main/java/com/bio/bio_backend/domain/user/member/mapper/MemberMapper.java

@@ -1,50 +0,0 @@
-package com.bio.bio_backend.domain.user.member.mapper;
-
-import com.bio.bio_backend.domain.user.member.dto.CreateMemberRequestDto;
-import com.bio.bio_backend.domain.user.member.dto.CreateMemberResponseDto;
-import com.bio.bio_backend.domain.user.member.dto.MemberDto;
-import com.bio.bio_backend.domain.user.member.entity.Member;
-import com.bio.bio_backend.domain.user.member.enums.MemberRole;
-import org.mapstruct.Mapper;
-import org.mapstruct.Mapping;
-import org.mapstruct.factory.Mappers;
-import java.util.List;
-
-@Mapper(componentModel = "spring")
-public interface MemberMapper {
-    
-    MemberMapper INSTANCE = Mappers.getMapper(MemberMapper.class);
-    
-    /**
-     * CreateMemberRequestDto를 MemberDto로 변환
-     * 기본값 설정: role = MemberRole.MEMBER, useFlag = true
-     */
-    @Mapping(target = "oid", ignore = true)
-    @Mapping(target = "role", expression = "java(com.bio.bio_backend.domain.user.member.enums.MemberRole.getDefault())")
-    @Mapping(target = "useFlag", constant = "true")
-    @Mapping(target = "refreshToken", ignore = true)
-    @Mapping(target = "lastLoginAt", ignore = true)
-    @Mapping(target = "createdAt", ignore = true)
-    @Mapping(target = "updatedAt", ignore = true)
-    MemberDto toMemberDto(CreateMemberRequestDto requestDto);
-    
-    /**
-     * Member 엔티티를 MemberDto로 변환
-     */
-    MemberDto toMemberDto(Member member);
-    
-    /**
-     * MemberDto를 Member 엔티티로 변환
-     */
-    Member toMember(MemberDto memberDto);
-    
-    /**
-     * Member 엔티티 리스트를 MemberDto 리스트로 변환
-     */
-    List<MemberDto> toMemberDtoList(List<Member> members);
-    
-    /**
-     * MemberDto를 CreateMemberResponseDto로 변환
-     */
-    CreateMemberResponseDto toCreateMemberResponseDto(MemberDto memberDto);
-}

src/main/java/com/bio/bio_backend/domain/user/member/repository/MemberRepository.java

@@ -1,17 +0,0 @@
-package com.bio.bio_backend.domain.user.member.repository;
-
-import org.springframework.data.jpa.repository.JpaRepository;
-import org.springframework.stereotype.Repository;
-
-import com.bio.bio_backend.domain.user.member.entity.Member;
-import java.util.Optional;
-
-@Repository
-public interface MemberRepository extends JpaRepository<Member, Long> {
-    
-    // 사용자 ID로 회원 조회 (Optional 반환)
-    Optional<Member> findByUserId(String userId);
-    
-    // 사용자 ID 존재 여부 확인
-    boolean existsByUserId(String userId);
-} 

src/main/java/com/bio/bio_backend/domain/user/member/repository/MemberRepositoryCustom.java

@@ -1,68 +0,0 @@
-package com.bio.bio_backend.domain.user.member.repository;
-
-import com.bio.bio_backend.domain.user.member.entity.Member;
-import org.springframework.data.domain.Page;
-import org.springframework.data.domain.Pageable;
-
-import java.util.List;
-import java.util.Optional;
-
-/**
- * QueryDSL을 활용한 커스텀 쿼리 메서드들을 정의하는 인터페이스
- * 복잡한 쿼리나 동적 쿼리가 필요한 경우 이 인터페이스를 구현하여 사용합니다.
- */
-public interface MemberRepositoryCustom {
-
-    /**
-     * 사용자 ID로 회원을 조회합니다.
-     * QueryDSL을 사용하여 더 유연한 쿼리 작성이 가능합니다.
-     *
-     * @param userId 사용자 ID
-     * @return Optional<Member> 회원 정보 (없으면 empty)
-     */
-    Optional<Member> findByUserIdCustom(String userId);
-
-    /**
-     * 역할(Role)별로 회원 목록을 조회합니다.
-     *
-     * @param role 회원 역할
-     * @return List<Member> 해당 역할을 가진 회원 목록
-     */
-    List<Member> findByRole(String role);
-
-    /**
-     * 사용 여부별로 회원 목록을 조회합니다.
-     *
-     * @param useFlag 사용 여부
-     * @return List<Member> 해당 사용 여부를 가진 회원 목록
-     */
-    List<Member> findByUseFlag(Boolean useFlag);
-
-    /**
-     * 사용자 ID와 사용 여부로 회원을 조회합니다.
-     *
-     * @param userId 사용자 ID
-     * @param useFlag 사용 여부
-     * @return Optional<Member> 회원 정보
-     */
-    Optional<Member> findByUserIdAndUseFlag(String userId, Boolean useFlag);
-
-    /**
-     * 검색 조건에 따른 회원 목록을 페이징하여 조회합니다.
-     *
-     * @param userId 사용자 ID (부분 검색)
-     * @param role 회원 역할
-     * @param useFlag 사용 여부
-     * @param pageable 페이징 정보
-     * @return Page<Member> 페이징된 회원 목록
-     */
-    Page<Member> findMembersByCondition(String userId, String role, Boolean useFlag, Pageable pageable);
-
-    /**
-     * 마지막 로그인 시간이 특정 시간 이후인 회원들을 조회합니다.
-     *
-     * @param lastLoginAfter 마지막 로그인 기준 시간
-     * @return List<Member> 해당 조건을 만족하는 회원 목록
-     */
-    List<Member> findActiveMembersByLastLogin(java.time.LocalDateTime lastLoginAfter);
-}

src/main/java/com/bio/bio_backend/domain/user/member/repository/MemberRepositoryImpl.java

@@ -1,131 +0,0 @@
-package com.bio.bio_backend.domain.user.member.repository;
-
-import com.bio.bio_backend.domain.user.member.entity.Member;
-import com.bio.bio_backend.domain.user.member.entity.QMember;
-import com.bio.bio_backend.domain.user.member.enums.MemberRole;
-import com.querydsl.core.BooleanBuilder;
-import com.querydsl.core.types.dsl.BooleanExpression;
-import com.querydsl.jpa.impl.JPAQueryFactory;
-import lombok.RequiredArgsConstructor;
-import org.springframework.data.domain.Page;
-import org.springframework.data.domain.PageImpl;
-import org.springframework.data.domain.Pageable;
-import org.springframework.stereotype.Repository;
-
-import java.time.LocalDateTime;
-import java.util.List;
-import java.util.Optional;
-
-/**
- * QueryDSL을 활용하여 MemberRepositoryCustom 인터페이스를 구현하는 클래스
- * 복잡한 쿼리나 동적 쿼리를 QueryDSL로 작성하여 성능과 가독성을 향상시킵니다.
- */
-@Repository
-@RequiredArgsConstructor
-public class MemberRepositoryImpl implements MemberRepositoryCustom {
-
-    private final JPAQueryFactory queryFactory;
-
-    /**
-     * QMember 인스턴스를 생성하여 쿼리에서 사용합니다.
-     * QueryDSL의 Q클래스를 통해 타입 안전한 쿼리 작성이 가능합니다.
-     */
-    private final QMember member = QMember.member;
-
-    @Override
-    public Optional<Member> findByUserIdCustom(String userId) {
-        // QueryDSL을 사용하여 사용자 ID로 회원을 조회합니다.
-        // eq() 메서드를 사용하여 정확한 일치 조건을 설정합니다.
-        Member foundMember = queryFactory
-                .selectFrom(member)
-                .where(member.userId.eq(userId))
-                .fetchOne();
-
-        return Optional.ofNullable(foundMember);
-    }
-
-    @Override
-    public List<Member> findByRole(String role) {
-        // 역할별로 회원을 조회합니다.
-        // String을 MemberRole enum으로 변환하여 비교합니다.
-        return queryFactory
-                .selectFrom(member)
-                .where(member.role.eq(MemberRole.fromValue(role)))
-                .fetch();
-    }
-
-    @Override
-    public List<Member> findByUseFlag(Boolean useFlag) {
-        // 사용 여부별로 회원을 조회합니다.
-        return queryFactory
-                .selectFrom(member)
-                .where(member.useFlag.eq(useFlag))
-                .fetch();
-    }
-
-    @Override
-    public Optional<Member> findByUserIdAndUseFlag(String userId, Boolean useFlag) {
-        // 사용자 ID와 사용 여부를 모두 만족하는 회원을 조회합니다.
-        // and() 메서드를 사용하여 여러 조건을 결합합니다.
-        Member foundMember = queryFactory
-                .selectFrom(member)
-                .where(member.userId.eq(userId)
-                        .and(member.useFlag.eq(useFlag)))
-                .fetchOne();
-
-        return Optional.ofNullable(foundMember);
-    }
-
-    @Override
-    public Page<Member> findMembersByCondition(String userId, String role, Boolean useFlag, Pageable pageable) {
-        // BooleanBuilder를 사용하여 동적 쿼리를 구성합니다.
-        // null이 아닌 조건만 쿼리에 포함시킵니다.
-        BooleanBuilder builder = new BooleanBuilder();
-
-        // 사용자 ID가 제공된 경우 부분 검색 조건을 추가합니다.
-        if (userId != null && !userId.trim().isEmpty()) {
-            builder.and(member.userId.containsIgnoreCase(userId));
-        }
-
-        // 역할이 제공된 경우 정확한 일치 조건을 추가합니다.
-        if (role != null && !role.trim().isEmpty()) {
-            builder.and(member.role.eq(MemberRole.fromValue(role)));
-        }
-
-        // 사용 여부가 제공된 경우 정확한 일치 조건을 추가합니다.
-        if (useFlag != null) {
-            builder.and(member.useFlag.eq(useFlag));
-        }
-
-        // 전체 개수를 조회합니다.
-        long total = queryFactory
-                .selectFrom(member)
-                .where(builder)
-                .fetchCount();
-
-        // 페이징 조건을 적용하여 결과를 조회합니다.
-        List<Member> content = queryFactory
-                .selectFrom(member)
-                .where(builder)
-                .orderBy(member.createdAt.desc()) // 생성일 기준 내림차순 정렬
-                .offset(pageable.getOffset())
-                .limit(pageable.getPageSize())
-                .fetch();
-
-        // Page 객체를 생성하여 반환합니다.
-        return new PageImpl<>(content, pageable, total);
-    }
-
-    @Override
-    public List<Member> findActiveMembersByLastLogin(LocalDateTime lastLoginAfter) {
-        // 마지막 로그인 시간이 특정 시간 이후인 활성 회원들을 조회합니다.
-        // 여러 조건을 조합하여 복잡한 쿼리를 작성합니다.
-        return queryFactory
-                .selectFrom(member)
-                .where(member.useFlag.eq(true) // 사용 중인 상태
-                        .and(member.lastLoginAt.isNotNull()) // 마지막 로그인 시간이 존재
-                        .and(member.lastLoginAt.after(lastLoginAfter))) // 특정 시간 이후
-                .orderBy(member.lastLoginAt.desc()) // 마지막 로그인 시간 기준 내림차순 정렬
-                .fetch();
-    }
-}

src/main/java/com/bio/bio_backend/domain/user/member/service/MemberService.java

@@ -1,30 +0,0 @@
-package com.bio.bio_backend.domain.user.member.service;
-
-import java.util.List;
-import java.util.Map;
-
-import org.springframework.security.core.userdetails.UserDetails;
-import org.springframework.security.core.userdetails.UserDetailsService;
-
-import com.bio.bio_backend.domain.user.member.dto.MemberDto;
-
-public interface MemberService extends UserDetailsService {
-
-    UserDetails loadUserByUsername(String id);
-
-    MemberDto createMember(MemberDto memberDTO);
-
-    void updateRefreshToken(MemberDto memberDTO);
-
-    String getRefreshToken(String id);
-
-    int deleteRefreshToken(String id);
-
-    List<MemberDto> selectMemberList(Map<String, String> params);
-
-    MemberDto selectMember(long seq);
-
-    int updateMember(MemberDto member);
-
-    int deleteMember(MemberDto member);
-}

src/main/java/com/bio/bio_backend/domain/user/member/service/MemberServiceImpl.java

@@ -1,149 +0,0 @@
-package com.bio.bio_backend.domain.user.member.service;
-
-import com.bio.bio_backend.domain.user.member.dto.MemberDto;
-import com.bio.bio_backend.domain.user.member.entity.Member;
-import com.bio.bio_backend.domain.user.member.enums.MemberRole;
-import com.bio.bio_backend.domain.user.member.mapper.MemberMapper;
-import com.bio.bio_backend.domain.user.member.repository.MemberRepository;
-import com.bio.bio_backend.domain.user.member.exception.UserDuplicateException;
-import com.bio.bio_backend.global.exception.ApiException;
-import com.bio.bio_backend.global.utils.ApiResponseCode;
-import lombok.RequiredArgsConstructor;
-import lombok.extern.slf4j.Slf4j;
-import org.springframework.security.core.userdetails.UserDetails;
-import org.springframework.security.core.userdetails.UsernameNotFoundException;
-import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
-import org.springframework.stereotype.Service;
-import org.springframework.transaction.annotation.Transactional;
-
-import java.util.List;
-import java.util.Map;
-
-import static com.bio.bio_backend.global.utils.OidUtil.generateOid;
-
-@Service
-@RequiredArgsConstructor
-@Slf4j
-@Transactional(readOnly = true)
-public class MemberServiceImpl implements MemberService {
-
-    private final MemberMapper memberMapper;  // MapStruct Mapper 사용
-    private final MemberRepository memberRepository;
-    private final BCryptPasswordEncoder bCryptPasswordEncoder;
-
-    @Override
-    public UserDetails loadUserByUsername(String id) throws UsernameNotFoundException {
-        // JPA 레파지토리를 사용하여 회원 조회
-        Member member = memberRepository.findByUserId(id)
-                .orElseThrow(() -> new UsernameNotFoundException("User not found with id : " + id));
-        
-        // MapStruct를 사용하여 Member 엔티티를 MemberDto로 변환
-        MemberDto memberDto = memberMapper.toMemberDto(member);
-        
-        return memberDto;
-    }
-
-    @Override
-    @Transactional
-    public MemberDto createMember(MemberDto memberDTO) {
-        // userId 중복 체크
-        if (memberRepository.existsByUserId(memberDTO.getUserId())) {
-            throw new ApiException(ApiResponseCode.USER_ID_DUPLICATE);
-        }
-        
-        Member member = Member.builder()
-                .userId(memberDTO.getUserId())
-                .password(bCryptPasswordEncoder.encode(memberDTO.getPassword()))
-                .role(MemberRole.getDefault())
-                .build();
-
-        Long oid = generateOid();
-        member.setOid(oid);
-        member.setCreatedOid(oid);
-        
-        Member savedMember = memberRepository.save(member);
-        
-        return memberMapper.toMemberDto(savedMember);
-    }
-
-    @Override
-    @Transactional
-    public void updateRefreshToken(MemberDto memberDTO) {
-        // JPA를 사용하여 refresh token 업데이트
-        Member member = memberRepository.findByUserId(memberDTO.getUserId())
-                .orElseThrow(() -> new RuntimeException("회원을 찾을 수 없습니다. id: " + memberDTO.getUserId()));
-        
-        member.setRefreshToken(memberDTO.getRefreshToken());
-        memberRepository.save(member);
-    }
-
-    @Override
-    public String getRefreshToken(String id) {
-        Member member = memberRepository.findByUserId(id)
-                .orElseThrow(() -> new RuntimeException("회원을 찾을 수 없습니다. id: " + id));
-        
-        return member.getRefreshToken();
-    }
-
-    @Override
-    @Transactional
-    public int deleteRefreshToken(String id) {
-        Member member = memberRepository.findByUserId(id)
-                .orElseThrow(() -> new RuntimeException("회원을 찾을 수 없습니다. id: " + id));
-        
-        member.setRefreshToken(null);
-        memberRepository.save(member);
-        return 1; // 성공 시 1 반환
-    }
-
-    @Override
-    public List<MemberDto> selectMemberList(Map<String, String> params) {
-        // JPA를 사용하여 회원 목록 조회 (간단한 구현)
-        List<Member> members = memberRepository.findAll();
-        
-        // MapStruct를 사용하여 Member 엔티티 리스트를 MemberDto 리스트로 변환
-        return memberMapper.toMemberDtoList(members);
-    }
-
-    @Override
-    public MemberDto selectMember(long seq) {
-        // JPA 레파지토리를 사용하여 회원 조회
-        Member member = memberRepository.findById(seq)
-                .orElseThrow(() -> new RuntimeException("회원을 찾을 수 없습니다. seq: " + seq));
-        
-        // MapStruct를 사용하여 Member 엔티티를 MemberDto로 자동 변환
-        return memberMapper.toMemberDto(member);
-    }
-
-    @Override
-    @Transactional
-    public int updateMember(MemberDto memberDto) {
-        Member member = memberRepository.findByUserId(memberDto.getUserId())
-                .orElseThrow(() -> new RuntimeException("회원을 찾을 수 없습니다. id: " + memberDto.getUserId()));
-        
-        // 비밀번호가 변경된 경우 암호화
-        if (memberDto.getPassword() != null && !memberDto.getPassword().isEmpty()) {
-            member.setPassword(bCryptPasswordEncoder.encode(memberDto.getPassword()));
-        }
-        
-        member.setRole(memberDto.getRole());
-        member.setUseFlag(memberDto.getUseFlag());
-        
-        memberRepository.save(member);
-        return 1; // 성공 시 1 반환
-    }
-
-    @Override
-    @Transactional
-    public int deleteMember(MemberDto memberDto) {
-        Member member = memberRepository.findByUserId(memberDto.getUserId())
-                .orElseThrow(() -> new RuntimeException("회원을 찾을 수 없습니다. id: " + memberDto.getUserId()));
-
-        member.setUseFlag(false);
-        
-        log.info("회원 삭제 처리: {}", member.toString());
-        
-        memberRepository.save(member);
-        return 1; // 성공 시 1 반환
-    }
-}

src/main/java/com/bio/bio_backend/global/annotation/IgnoreBaseEntityMapping.java

@@ -0,0 +1,24 @@
+package com.bio.bio_backend.global.annotation;
+
+import org.mapstruct.Mapping;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * BaseEntity의 감사 필드들을 ignore 처리하는 MapStruct 커스텀 어노테이션
+ * 여러 매퍼에서 공통으로 사용할 수 있습니다.
+ */
+@Target(ElementType.METHOD)
+@Retention(RetentionPolicy.CLASS)
+@Mapping(target = "oid", ignore = true)
+@Mapping(target = "createdAt", ignore = true)
+@Mapping(target = "updatedAt", ignore = true)
+@Mapping(target = "createdOid", ignore = true)
+@Mapping(target = "updatedOid", ignore = true)
+@Mapping(target = "createdId", ignore = true)
+@Mapping(target = "updatedId", ignore = true)
+public @interface IgnoreBaseEntityMapping {
+}

src/main/java/com/bio/bio_backend/global/annotation/LogExecution.java

@@ -0,0 +1,15 @@
+package com.bio.bio_backend.global.annotation;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * 메서드 실행 로깅 어노테이션
+ */
+@Target(ElementType.METHOD)
+@Retention(RetentionPolicy.RUNTIME)
+public @interface LogExecution {
+    String value() default "";
+}

src/main/java/com/bio/bio_backend/global/aop/MethodExecutionLoggingAspect.java

@@ -0,0 +1,55 @@
+package com.bio.bio_backend.global.aop;
+
+import lombok.extern.slf4j.Slf4j;
+import org.aspectj.lang.ProceedingJoinPoint;
+import org.aspectj.lang.annotation.Around;
+import org.aspectj.lang.annotation.Aspect;
+import org.springframework.security.core.Authentication;
+import org.springframework.security.core.context.SecurityContextHolder;
+import org.springframework.stereotype.Component;
+
+@Aspect
+@Component
+@Slf4j
+public class MethodExecutionLoggingAspect {
+    
+    @Around("@annotation(logExecution)")
+    public Object logExecution(ProceedingJoinPoint pjp, com.bio.bio_backend.global.annotation.LogExecution logExecution) throws Throwable {
+        String message = logExecution.value().isEmpty() ? 
+            pjp.getSignature().getName() : logExecution.value();
+        
+        String className = pjp.getTarget().getClass().getSimpleName();
+        String methodName = pjp.getSignature().getName();
+        
+        String userInfo = getCurrentUser();
+        
+        long startTime = System.currentTimeMillis();
+        log.info("[START] {} | 호출경로: {}.{} | 사용자: {}", 
+                message, className, methodName, userInfo);
+        
+        try {
+            Object result = pjp.proceed();
+            long duration = System.currentTimeMillis() - startTime;
+            log.info("[SUCCESS] {} | 호출경로: {}.{} | 사용자: {} | 시간: {}ms", 
+                    message, className, methodName, userInfo, duration);
+            return result;
+        } catch (Exception e) {
+            long duration = System.currentTimeMillis() - startTime;
+            log.error("[FAILED] {} | 호출경로: {}.{} | 사용자: {} | 시간: {}ms | 오류: {}", 
+                    message, className, methodName, userInfo, duration, e.getMessage());
+            throw e;
+        }
+    }
+    
+    private String getCurrentUser() {
+        try {
+            Authentication auth = SecurityContextHolder.getContext().getAuthentication();
+            if (auth != null && auth.isAuthenticated() && !"anonymousUser".equals(auth.getName())) {
+                return auth.getName();
+            }
+            return "인증되지 않은 사용자";
+        } catch (Exception e) {
+            return "알 수 없는 사용자";
+        }
+    }
+}

src/main/java/com/bio/bio_backend/global/config/AppConfig.java

@@ -1,9 +1,16 @@
 package com.bio.bio_backend.global.config;
 
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;
+import com.fasterxml.jackson.datatype.jsr310.ser.LocalDateTimeSerializer;
+import com.fasterxml.jackson.datatype.jsr310.deser.LocalDateTimeDeserializer;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
 import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
 
+import java.time.LocalDateTime;
+import java.time.format.DateTimeFormatter;
+
 @Configuration
 public class AppConfig {
     
@@ -11,4 +18,21 @@ public class AppConfig {
     public BCryptPasswordEncoder bCryptPasswordEncoder() {
         return new BCryptPasswordEncoder();
     }
+    
+    @Bean
+    public ObjectMapper objectMapper() {
+        ObjectMapper mapper = new ObjectMapper();
+        
+        // JavaTimeModule 등록
+        JavaTimeModule javaTimeModule = new JavaTimeModule();
+        
+        // LocalDateTime 직렬화/역직렬화 설정
+        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
+        javaTimeModule.addSerializer(LocalDateTime.class, new LocalDateTimeSerializer(formatter));
+        javaTimeModule.addDeserializer(LocalDateTime.class, new LocalDateTimeDeserializer(formatter));
+        
+        mapper.registerModule(javaTimeModule);
+        
+        return mapper;
+    }
 }

src/main/java/com/bio/bio_backend/global/config/CorsConfig.java

@@ -1,26 +1,55 @@
 package com.bio.bio_backend.global.config;
 
+import org.springframework.beans.factory.annotation.Value;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
 import org.springframework.web.cors.CorsConfiguration;
 import org.springframework.web.cors.UrlBasedCorsConfigurationSource;
 import org.springframework.web.filter.CorsFilter;
 
+import java.util.Arrays;
+import java.util.List;
+
 @Configuration
 public class CorsConfig {
+    
+    @Value("${cors.allowed-origins:http://localhost:3000,http://localhost:8080}")
+    private String allowedOrigins;
+    
     @Bean
     public CorsFilter corsFilter() {
         UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
         CorsConfiguration config = new CorsConfiguration();
-        config.addAllowedOriginPattern("*");
+        
-        config.addAllowedHeader("*");
+        // 허용할 Origin 설정
-        config.addAllowedMethod("*");
+        List<String> origins = Arrays.asList(allowedOrigins.split(","));
+        config.setAllowedOrigins(origins);
+        
+        // 허용할 헤더 설정
+        config.setAllowedHeaders(Arrays.asList(
+            "Authorization",
+            "Content-Type",
+            "X-Requested-With",
+            "Accept",
+            "Origin",
+            "Access-Control-Request-Method",
+            "Access-Control-Request-Headers"
+        ));
+        
+        // 허용할 HTTP 메서드 설정
+        config.setAllowedMethods(Arrays.asList(
+            "GET", "POST", "PUT", "DELETE", "OPTIONS", "PATCH"
+        ));
+        
+        // 인증 정보 포함 허용 (JWT 토큰 등)
         config.setAllowCredentials(true);
         
-        config.addExposedHeader("Authorization");
+        // Preflight 요청 캐시 시간 (초)
+        config.setMaxAge(3600L);
+        
+        // 모든 경로에 적용
         source.registerCorsConfiguration("/**", config);
 
         return new CorsFilter(source);
-
     }
 }

src/main/java/com/bio/bio_backend/global/config/GlobalMapperConfig.java

@@ -0,0 +1,21 @@
+package com.bio.bio_backend.global.config;
+
+import org.mapstruct.*;
+
+@MapperConfig(
+    componentModel = "spring",
+    
+    // null 값은 매핑하지 않음 (부분 업데이트)
+    nullValuePropertyMappingStrategy = NullValuePropertyMappingStrategy.IGNORE,
+    
+    // NPE 방지용 null 체크
+    nullValueCheckStrategy = NullValueCheckStrategy.ALWAYS,
+    
+    // 매핑 누락 시 컴파일 오류
+    unmappedTargetPolicy = ReportingPolicy.ERROR,
+    
+    // 컬렉션 매핑 전략
+    collectionMappingStrategy = CollectionMappingStrategy.ACCESSOR_ONLY
+)
+public interface GlobalMapperConfig {
+}

src/main/java/com/bio/bio_backend/global/config/SchedulerConfig.java

@@ -0,0 +1,38 @@
+package com.bio.bio_backend.global.config;
+
+import net.javacrumbs.shedlock.core.LockProvider;
+import net.javacrumbs.shedlock.provider.jdbctemplate.JdbcTemplateLockProvider;
+import net.javacrumbs.shedlock.spring.annotation.EnableSchedulerLock;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.jdbc.core.JdbcTemplate;
+import org.springframework.scheduling.annotation.EnableScheduling;
+
+import javax.sql.DataSource;
+
+/**
+ * 스케줄러 및 분산 락 설정을 위한 Configuration 클래스
+ * ShedLock을 사용하여 분산 환경에서 스케줄러 중복 실행을 방지합니다.
+ */
+@Configuration
+@EnableScheduling
+@EnableSchedulerLock(defaultLockAtMostFor = "10m")
+public class SchedulerConfig {
+
+    /**
+     * ShedLock용 LockProvider Bean을 생성합니다.
+     * JDBC 기반으로 분산 락을 관리합니다.
+     *
+     * @param dataSource 데이터소스
+     * @return JdbcTemplateLockProvider 인스턴스
+     */
+    @Bean
+    public LockProvider lockProvider(DataSource dataSource) {
+        return new JdbcTemplateLockProvider(
+            JdbcTemplateLockProvider.Configuration.builder()
+                .withJdbcTemplate(new JdbcTemplate(dataSource))
+                .usingDbTime() // DB 시간 사용으로 서버 간 시간차 문제 해결
+                .build()
+        );
+    }
+}

src/main/java/com/bio/bio_backend/global/config/SecurityPathConfig.java

@@ -0,0 +1,42 @@
+package com.bio.bio_backend.global.config;
+
+import lombok.Getter;
+import lombok.Setter;
+import org.springframework.boot.context.properties.ConfigurationProperties;
+import org.springframework.stereotype.Component;
+
+import java.util.ArrayList;
+import java.util.List;
+
+@Getter
+@Setter
+@Component
+@ConfigurationProperties(prefix = "security")
+public class SecurityPathConfig {
+    
+    private List<String> permitAllPaths = new ArrayList<>();
+    
+    /**
+     * 주어진 경로가 허용된 경로인지 확인
+     * @param path 확인할 경로
+     * @param contextPath 컨텍스트 경로
+     * @return 허용 여부
+     */
+    public boolean isPermittedPath(String path, String contextPath) {
+        if (permitAllPaths == null) {
+            return false;
+        }
+        
+        return permitAllPaths.stream()
+                .anyMatch(permittedPath -> {
+                    String fullPath = contextPath + permittedPath;
+                    if (permittedPath.endsWith("/**")) {
+                        // /** 패턴 처리
+                        String basePath = fullPath.substring(0, fullPath.length() - 2);
+                        return path.startsWith(basePath);
+                    } else {
+                        return path.equals(fullPath);
+                    }
+                });
+    }
+}

src/main/java/com/bio/bio_backend/global/config/SwaggerConfig.java

@@ -2,7 +2,6 @@ package com.bio.bio_backend.global.config;
 
 import io.swagger.v3.oas.models.OpenAPI;
 import io.swagger.v3.oas.models.info.Info;
-import io.swagger.v3.oas.models.info.Contact;
 import io.swagger.v3.oas.models.info.License;
 import io.swagger.v3.oas.models.servers.Server;
 import org.springframework.context.annotation.Bean;
@@ -22,10 +21,6 @@ public class SwaggerConfig {
                         .version("v1.0.0")
                         .license(new License()
                                 .name("STAM License")
-                                .url("https://stam.kr/")))
+                                .url("https://stam.kr/")));
-                .servers(List.of(
-                        new Server().url("http://localhost:8080/service").description("Local Development Server"),
-                        new Server().url("https://api.bio.com/service").description("Production Server")
-                ));
     }
 }

src/main/java/com/bio/bio_backend/global/constants/ApiResponseCode.java

@@ -0,0 +1,98 @@
+package com.bio.bio_backend.global.constants;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import org.springframework.http.HttpStatus;
+
+/*
+ * API 관련 RESPONSE ENUM
+ */
+
+@Getter
+@AllArgsConstructor
+public enum ApiResponseCode {
+    
+    /*공통 Code*/
+    // 200 OK
+    COMMON_SUCCESS(HttpStatus.OK.value(), "요청을 성공하였습니다"),
+    COMMON_SUCCESS_CREATED(HttpStatus.CREATED.value(), "성공적으로 생성되었습니다"),
+    COMMON_SUCCESS_UPDATED(HttpStatus.OK.value(), "성공적으로 수정되었습니다"),
+    COMMON_SUCCESS_DELETED(HttpStatus.OK.value(), "성공적으로 삭제되었습니다"),
+    COMMON_SUCCESS_RETRIEVED(HttpStatus.OK.value(), "성공적으로 조회되었습니다"),
+
+    // 400 Bad Request
+    COMMON_BAD_REQUEST(HttpStatus.BAD_REQUEST.value(), "필수 요청 본문이 누락되었거나 오류가 발생했습니다"),
+    COMMON_FORMAT_WRONG(HttpStatus.BAD_REQUEST.value(), "요청 형식이 올바르지 않습니다"),
+    COMMON_ARGUMENT_NOT_VALID(HttpStatus.BAD_REQUEST.value(), "인자가 유효하지 않습니다"),
+
+    // 401 Unauthorized
+    COMMON_UNAUTHORIZED(HttpStatus.UNAUTHORIZED.value(), "인증에 실패했습니다"),
+
+    // 403 Forbidden
+    COMMON_FORBIDDEN(HttpStatus.FORBIDDEN.value(), "접근이 거부되었습니다"),
+
+    // 404 Not Found
+    COMMON_NOT_FOUND(HttpStatus.NOT_FOUND.value(), "리소스를 찾을 수 없습니다"),
+    COMMON_TARGET_NOT_FOUND(HttpStatus.NOT_FOUND.value(), "대상을 찾을 수 없습니다"),
+
+    // 405 Method Not Allowed
+    COMMON_METHOD_NOT_ALLOWED(HttpStatus.METHOD_NOT_ALLOWED.value(), "허용되지 않는 메소드입니다"),
+
+    // 409 Conflict
+    COMMON_CONFLICT(HttpStatus.CONFLICT.value(), "충돌이 발생했습니다"),
+    COMMON_CODE_DUPLICATE(HttpStatus.CONFLICT.value(), "동일한 코드가 존재합니다"),
+
+    // 500 Internal Server Error
+    COMMON_INTERNAL_SERVER_ERROR(HttpStatus.INTERNAL_SERVER_ERROR.value(), "서버에서 오류가 발생했습니다"),
+    COMMON_INDEX_OUT_OF_BOUND(HttpStatus.INTERNAL_SERVER_ERROR.value(), "인덱스가 범위를 벗어났습니다"),
+    COMMON_JSON_PROCESSING_EXCEPTION(HttpStatus.INTERNAL_SERVER_ERROR.value(), "유효한 JSON 형식인지 확인해주세요"),
+
+    /*사용자 관련 Code*/
+    // 200 OK
+    LOGIN_SUCCESSFUL(HttpStatus.OK.value(), "로그인에 성공했습니다"),
+    LOGOUT_SUCCESSFUL(HttpStatus.OK.value(), "로그아웃에 성공했습니다"),
+    USER_INFO_CHANGE(HttpStatus.OK.value(), "사용자 정보가 성공적으로 수정되었습니다"),
+    USER_DELETE_SUCCESSFUL(HttpStatus.OK.value(), "사용자가 성공적으로 삭제되었습니다"),
+
+    // 409 Conflict
+    USER_ID_DUPLICATE(HttpStatus.CONFLICT.value(), "이미 존재하는 사용자 ID입니다"),
+
+    // 401 Unauthorized
+    USER_NOT_FOUND(HttpStatus.UNAUTHORIZED.value(), "사용자를 찾을 수 없습니다. 인증에 실패했습니다"),
+    USER_PASSWORD_INVALID(HttpStatus.UNAUTHORIZED.value(), "비밀번호가 올바르지 않습니다"),
+
+    // JWT 관련
+    JWT_SIGNATURE_MISMATCH(HttpStatus.UNAUTHORIZED.value(), "JWT 서명이 일치하지 않습니다. 인증에 실패했습니다"),
+    JWT_TOKEN_NULL(HttpStatus.UNAUTHORIZED.value(), "JWT 토큰이 null입니다"),
+    JWT_TOKEN_EXPIRED(HttpStatus.UNAUTHORIZED.value(), "토큰이 만료되었습니다"),
+    INVALID_CLIENT_IP(HttpStatus.UNAUTHORIZED.value(), "클라이언트 IP 주소가 일치하지 않습니다"),
+    ALL_TOKEN_INVALID(HttpStatus.UNAUTHORIZED.value(), "액세스 토큰과 리프레시 토큰이 모두 만료되었거나 유효하지 않습니다"),
+
+    /*파일 관련 Code*/
+    // 200 OK
+    FILE_UPLOAD_SUCCESS(HttpStatus.OK.value(), "파일이 성공적으로 업로드되었습니다"),
+    FILE_DOWNLOAD_SUCCESS(HttpStatus.OK.value(), "파일 다운로드가 성공했습니다"),
+    FILE_DELETE_SUCCESS(HttpStatus.OK.value(), "파일이 성공적으로 삭제되었습니다"),
+
+    // 400 Bad Request
+    FILE_EMPTY(HttpStatus.BAD_REQUEST.value(), "업로드할 파일이 없습니다"),
+    FILE_INVALID_FORMAT(HttpStatus.BAD_REQUEST.value(), "지원하지 않는 파일 형식입니다"),
+
+    // 404 Not Found
+    FILE_NOT_FOUND(HttpStatus.NOT_FOUND.value(), "파일을 찾을 수 없습니다"),
+
+    // 500 Internal Server Error
+    FILE_UPLOAD_FAILED(HttpStatus.INTERNAL_SERVER_ERROR.value(), "파일 업로드에 실패했습니다"),
+    FILE_DOWNLOAD_FAILED(HttpStatus.INTERNAL_SERVER_ERROR.value(), "파일 다운로드에 실패했습니다"),
+    FILE_DELETE_FAILED(HttpStatus.INTERNAL_SERVER_ERROR.value(), "파일 삭제에 실패했습니다"),
+
+    /*공통 코드 관련 Code*/
+    // 400 Bad Request
+    COMMON_CODE_ERROR_001(HttpStatus.BAD_REQUEST.value(), "하위 공통 코드가 존재하여 삭제할 수 없습니다."),
+    COMMON_CODE_ERROR_002(HttpStatus.BAD_REQUEST.value(), "존재하지 않는 그룹 코드입니다"),
+    COMMON_CODE_ERROR_003(HttpStatus.NOT_FOUND.value(), "공통 코드를 찾을 수 없습니다");
+
+    private final int statusCode;
+    private final String description;
+
+}

src/main/java/com/bio/bio_backend/global/constants/AppConstants.java

@@ -0,0 +1,10 @@
+package com.bio.bio_backend.global.constants;
+
+public class AppConstants {
+    public static final String TABLE_PREFIX = "st_";
+    
+    // 관리자 관련 상수
+    public static final Long ADMIN_OID = 1000000000000000L;
+    public static final String ADMIN_USER_ID = "admin";
+    public static final String ADMIN_NAME = "시스템관리자";
+}

src/main/java/com/bio/bio_backend/global/dto/ApiResponseDto.java

@@ -0,0 +1,49 @@
+package com.bio.bio_backend.global.dto;
+
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+
+import com.bio.bio_backend.global.constants.ApiResponseCode;
+import lombok.Data;
+import lombok.RequiredArgsConstructor;
+
+@Data
+@RequiredArgsConstructor
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class ApiResponseDto<T> {
+
+    private static final boolean SUCCESS = true;
+    private static final boolean FAIL = false;
+
+    private boolean success;
+    private int code;
+    private String message;
+    private String description;
+    private T data;
+
+    private ApiResponseDto(boolean success, int code, String message, String description, T data){
+        this.success = success;
+        this.code = code;
+        this.message = message;
+        this.description = description;
+        this.data = data;
+    }
+
+    public static <T> ApiResponseDto<T> success(ApiResponseCode responseCode, T data) {
+        return new ApiResponseDto<T>(SUCCESS, responseCode.getStatusCode(), responseCode.name(), responseCode.getDescription(), data);
+    }
+
+    public static <T> ApiResponseDto<T> success(ApiResponseCode responseCode) {
+        return new ApiResponseDto<T>(SUCCESS, responseCode.getStatusCode(), responseCode.name(), responseCode.getDescription(), null);
+    }
+
+    public static <T> ApiResponseDto<T> fail(ApiResponseCode responseCode, T data) {
+        return new ApiResponseDto<T>(FAIL, responseCode.getStatusCode(), responseCode.name(), responseCode.getDescription(), data);
+    }
+
+    public static <T> ApiResponseDto<T> fail(ApiResponseCode responseCode) {
+        return new ApiResponseDto<T>(FAIL, responseCode.getStatusCode(), responseCode.name(), responseCode.getDescription(), null);
+    }
+
+}
+

src/main/java/com/bio/bio_backend/global/dto/BasePagedRequestDto.java

@@ -0,0 +1,28 @@
+package com.bio.bio_backend.global.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.Max;
+
+/**
+ * 기본 페이징 요청 DTO
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class BasePagedRequestDto {
+    
+    @Min(value = 0, message = "페이지 번호는 0 이상이어야 합니다")
+    @Builder.Default
+    private int page = 0;
+    
+    @Min(value = 1, message = "페이지 크기는 1 이상이어야 합니다")
+    @Max(value = 100, message = "페이지 크기는 100 이하여야 합니다")
+    @Builder.Default
+    private int size = 10;
+}

src/main/java/com/bio/bio_backend/global/dto/BasePagedResponseDto.java

@@ -0,0 +1,24 @@
+package com.bio.bio_backend.global.dto;
+
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import lombok.experimental.SuperBuilder;
+
+/**
+ * 기본 페이징 응답 DTO
+ * 모든 페이징 응답에서 공통으로 사용되는 필드들을 포함
+ */
+@Data
+@SuperBuilder
+@NoArgsConstructor
+public class BasePagedResponseDto {
+    
+    private int currentPage;        // 현재 페이지
+    private int totalPages;         // 전체 페이지 수
+    private long totalElements;     // 전체 요소 수
+    private int size;              // 페이지 크기
+    private boolean hasNext;       // 다음 페이지 존재 여부
+    private boolean hasPrevious;   // 이전 페이지 존재 여부
+    private boolean isFirst;       // 첫 번째 페이지 여부
+    private boolean isLast;        // 마지막 페이지 여부
+}

src/main/java/com/bio/bio_backend/global/dto/CustomApiResponse.java

@@ -1,39 +0,0 @@
-package com.bio.bio_backend.global.dto;
-
-
-import com.fasterxml.jackson.annotation.JsonInclude;
-
-import com.bio.bio_backend.global.utils.ApiResponseCode;
-import lombok.Data;
-import lombok.RequiredArgsConstructor;
-
-//공통 response Class
-@Data
-@RequiredArgsConstructor
-@JsonInclude(JsonInclude.Include.NON_NULL)
-public class CustomApiResponse<T> {
-
-    private int code;
-    private String message;
-    private String description;
-    private T data;
-
-    private static final int SUCCESS = 200;
-
-    private CustomApiResponse(int code, String message, String description, T data){
-        this.code = code;
-        this.message = message;
-        this.description = description;
-        this.data = data;
-    }
-
-    public static <T> CustomApiResponse<T> success(ApiResponseCode responseCode, T data) {
-        return new CustomApiResponse<T>(SUCCESS, responseCode.name(), responseCode.getDescription(), data);
-    }
-
-    public static <T> CustomApiResponse<T> fail(ApiResponseCode responseCode, T data) {
-        return new CustomApiResponse<T>(responseCode.getStatusCode(), responseCode.name(), responseCode.getDescription(), data);
-    }
-
-}
-

src/main/java/com/bio/bio_backend/global/dto/PagedResult.java

@@ -0,0 +1,34 @@
+package com.bio.bio_backend.global.dto;
+
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import org.springframework.data.domain.Page;
+
+import java.util.List;
+
+/**
+ * 페이지네이션된 결과를 담는 제네릭 클래스
+ * @param <T> 페이지네이션할 데이터의 타입
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class PagedResult<T> extends BasePagedResponseDto {
+    
+    private List<T> content;
+    
+    public static <T> PagedResult<T> of(Page<?> page, List<T> content) {
+        PagedResult<T> result = new PagedResult<>();
+        result.setContent(content);
+        result.setCurrentPage(page.getNumber());
+        result.setTotalPages(page.getTotalPages());
+        result.setTotalElements(page.getTotalElements());
+        result.setSize(page.getSize());
+        result.setHasNext(page.hasNext());
+        result.setHasPrevious(page.hasPrevious());
+        result.setFirst(page.isFirst());
+        result.setLast(page.isLast());
+        return result;
+    }
+}

src/main/java/com/bio/bio_backend/global/entity/BaseEntity.java

@@ -3,13 +3,15 @@ package com.bio.bio_backend.global.entity;
 import jakarta.persistence.*;
 import lombok.Getter;
 import lombok.Setter;
+
+import org.hibernate.annotations.Comment;
 import org.springframework.data.annotation.CreatedDate;
 import org.springframework.data.annotation.LastModifiedDate;
 import org.springframework.data.jpa.domain.support.AuditingEntityListener;
 
 import java.time.LocalDateTime;
 
-import static com.bio.bio_backend.global.utils.OidUtil.generateOid;
+
 
 /**
  * 모든 엔티티가 상속받는 기본 엔티티 클래스
@@ -18,30 +20,38 @@ import static com.bio.bio_backend.global.utils.OidUtil.generateOid;
 @Getter
 @Setter
 @MappedSuperclass
-@EntityListeners(AuditingEntityListener.class)
+@EntityListeners({AuditingEntityListener.class, BaseEntityListener.class})
 public abstract class BaseEntity {
 
     @Id
     @Column(name = "oid", nullable = false)
+    @Comment("OID")
     private Long oid;
 
     @CreatedDate
     @Column(name = "created_at", nullable = false, updatable = false)
+    @Comment("생성일시")
     private LocalDateTime createdAt;
 
     @LastModifiedDate
     @Column(name = "updated_at", nullable = false)
+    @Comment("수정일시")
     private LocalDateTime updatedAt;
 
     @Column(name = "created_oid", updatable = false)
+    @Comment("생성자 OID")
     private Long createdOid;
 
     @Column(name = "updated_oid")
+    @Comment("수정자 OID")
     private Long updatedOid;
 
-    @PrePersist
+    @Column(name = "created_id", updatable = false)
-    protected void onCreate() {
+    @Comment("생성자 ID")
-        if(this.oid == null) this.oid = generateOid();
+    private String createdId;
-        if(this.createdOid != null && this.updatedOid == null) this.updatedOid = this.createdOid;
+
-    }
+    @Column(name = "updated_id")
+    @Comment("수정자 ID")
+    private String updatedId;
+    
 }

src/main/java/com/bio/bio_backend/global/entity/BaseEntityListener.java

@@ -0,0 +1,61 @@
+package com.bio.bio_backend.global.entity;
+
+import com.bio.bio_backend.global.utils.SecurityUtils;
+import jakarta.persistence.PrePersist;
+import jakarta.persistence.PreUpdate;
+import lombok.extern.slf4j.Slf4j;
+
+import static com.bio.bio_backend.global.utils.OidUtils.generateOid;
+
+/**
+ * BaseEntity의 createdOid와 updatedOid 필드를 자동으로 설정하는 엔티티 리스너
+ */
+@Slf4j
+public class BaseEntityListener {
+
+    @PrePersist
+    public void prePersist(BaseEntity entity) {
+        if (entity.getOid() == null) {
+            entity.setOid(generateOid());
+        }
+        
+        try {
+            String currentUserId = SecurityUtils.getCurrentUserId();
+            Long currentUserOid = SecurityUtils.getCurrentUserOid();
+            
+            if (currentUserOid != null) {
+                entity.setCreatedOid(currentUserOid);
+                entity.setUpdatedOid(currentUserOid);
+            }
+            
+            if (currentUserId != null) {
+                entity.setCreatedId(currentUserId);
+                entity.setUpdatedId(currentUserId);
+            }
+        } catch (SecurityException | IllegalStateException e) {
+            log.warn("등록자 정보 설정 실패: {}", e.getMessage());
+        } catch (Exception e) {
+            log.error("등록자 정보 설정 오류: {}", e.getMessage(), e);
+        }
+    }
+
+    @PreUpdate
+    public void preUpdate(BaseEntity entity) {
+        try {
+            String currentUserId = SecurityUtils.getCurrentUserId();
+            Long currentUserOid = SecurityUtils.getCurrentUserOid();
+            
+            if (currentUserOid != null) {
+                entity.setUpdatedOid(currentUserOid);
+            }
+            
+            if (currentUserId != null) {
+                entity.setUpdatedId(currentUserId);
+            }
+        } catch (SecurityException | IllegalStateException e) {
+            log.warn("수정자 정보 설정 실패: {}", e.getMessage());
+        } catch (Exception e) {
+            log.error("수정자 정보 설정 오류: {}", e.getMessage(), e);
+        }
+    }
+}

src/main/java/com/bio/bio_backend/global/exception/ApiException.java

@@ -1,7 +1,7 @@
 package com.bio.bio_backend.global.exception;
 
 import lombok.Getter;
-import com.bio.bio_backend.global.utils.ApiResponseCode;
+import com.bio.bio_backend.global.constants.ApiResponseCode;
 
 @Getter
 public class ApiException extends RuntimeException {

src/main/java/com/bio/bio_backend/global/exception/CustomAuthenticationFailureHandler.java

@@ -14,8 +14,8 @@ import com.fasterxml.jackson.databind.ObjectMapper;
 import jakarta.servlet.ServletException;
 import jakarta.servlet.http.HttpServletRequest;
 import jakarta.servlet.http.HttpServletResponse;
-import com.bio.bio_backend.global.dto.CustomApiResponse;
+import com.bio.bio_backend.global.dto.ApiResponseDto;
-import com.bio.bio_backend.global.utils.ApiResponseCode;
+import com.bio.bio_backend.global.constants.ApiResponseCode;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 
@@ -29,25 +29,21 @@ public class CustomAuthenticationFailureHandler implements AuthenticationFailure
 
     @Override
     public void onAuthenticationFailure(HttpServletRequest request, HttpServletResponse response, AuthenticationException exception) throws IOException, ServletException {
-
-        log.info("exception : " + exception.toString());
-
         response.setContentType(MediaType.APPLICATION_JSON_VALUE);
         response.setCharacterEncoding("UTF-8");
         response.setStatus(HttpStatus.UNAUTHORIZED.value());
 
-        CustomApiResponse<String> apiResponse;
+        ApiResponseDto<String> apiResponse;
         if (exception instanceof UsernameNotFoundException) {
-            apiResponse = CustomApiResponse.fail(ApiResponseCode.USER_NOT_FOUND, null);
+            apiResponse = ApiResponseDto.fail(ApiResponseCode.USER_NOT_FOUND);
         } else if (exception instanceof BadCredentialsException) {
-            apiResponse = CustomApiResponse.fail(ApiResponseCode.AUTHENTICATION_FAILED, null);
+            apiResponse = ApiResponseDto.fail(ApiResponseCode.COMMON_UNAUTHORIZED);
         } else {
             response.setStatus(HttpStatus.INTERNAL_SERVER_ERROR.value());
-            apiResponse = CustomApiResponse.fail(ApiResponseCode.INTERNAL_SERVER_ERROR, null);
+            apiResponse = ApiResponseDto.fail(ApiResponseCode.COMMON_INTERNAL_SERVER_ERROR);
         }
 
         String jsonResponse = objectMapper.writeValueAsString(apiResponse);
         response.getWriter().write(jsonResponse);
-
     }
 }

src/main/java/com/bio/bio_backend/global/exception/GlobalExceptionHandler.java

@@ -1,105 +1,44 @@
 package com.bio.bio_backend.global.exception;
 
-import java.util.Objects;
-
-import org.springframework.http.converter.HttpMessageNotReadableException;
-import org.springframework.web.HttpRequestMethodNotSupportedException;
 import org.springframework.web.bind.annotation.ExceptionHandler;
 import org.springframework.web.bind.annotation.RestControllerAdvice;
 import org.springframework.web.bind.MethodArgumentNotValidException;
-import org.springframework.web.servlet.resource.NoResourceFoundException;
 
-import com.fasterxml.jackson.core.JsonProcessingException;
+import com.bio.bio_backend.global.dto.ApiResponseDto;
-
+import com.bio.bio_backend.global.constants.ApiResponseCode;
-import io.jsonwebtoken.ExpiredJwtException;
+import org.springframework.http.HttpStatus;
-import io.jsonwebtoken.JwtException;
+import org.springframework.http.ResponseEntity;
-import io.jsonwebtoken.MalformedJwtException;
+import lombok.extern.slf4j.Slf4j;
-import io.jsonwebtoken.security.SignatureException;
-import com.bio.bio_backend.global.dto.CustomApiResponse;
-import com.bio.bio_backend.global.utils.ApiResponseCode;
-import com.bio.bio_backend.domain.user.member.exception.UserDuplicateException;
 
 @RestControllerAdvice
+@Slf4j
 public class GlobalExceptionHandler {
-    @ExceptionHandler(HttpMessageNotReadableException.class)
-    public CustomApiResponse<Void> handleHttpMessageNotReadableException(HttpMessageNotReadableException e) {
-        if (Objects.requireNonNull(e.getMessage()).contains("JSON parse error")) {
-            return CustomApiResponse.fail(ApiResponseCode.COMMON_FORMAT_WRONG, null);
-        }
-        return CustomApiResponse.fail(ApiResponseCode.COMMON_BAD_REQUEST, null);
-    }
-
-    @ExceptionHandler(HttpRequestMethodNotSupportedException.class)
-    public CustomApiResponse<Void> handleHttpRequestMethodNotSupportedException(HttpRequestMethodNotSupportedException e) {
-        return CustomApiResponse.fail(ApiResponseCode.COMMON_METHOD_NOT_ALLOWED, null);
-    }
-
-    @ExceptionHandler(NoResourceFoundException.class)
-    public CustomApiResponse<Void> handleNoResourceFoundException(NoResourceFoundException e){
-        return CustomApiResponse.fail(ApiResponseCode.COMMON_NOT_FOUND, null);
-    }
-
-    @ExceptionHandler(IllegalArgumentException.class)
-    public CustomApiResponse<Void> handleIllegalArgumentException(IllegalArgumentException e){
-        return CustomApiResponse.fail(ApiResponseCode.ARGUMENT_NOT_VALID, null);
-    }
-
-    @ExceptionHandler(IndexOutOfBoundsException.class)
-    public CustomApiResponse<Void> handleIndexOutOfBoundsException(IndexOutOfBoundsException e){
-        return CustomApiResponse.fail(ApiResponseCode.INDEX_OUT_OF_BOUND, null);
-    }
-
-    @ExceptionHandler(SignatureException.class)
-    public CustomApiResponse<Void> handleSignatureException(SignatureException e) {
-        return CustomApiResponse.fail(ApiResponseCode.JWT_SIGNATURE_MISMATCH, null);
-    }
-
-    @ExceptionHandler(MalformedJwtException.class)
-    public CustomApiResponse<Void> handleMalformedJwtException(MalformedJwtException e) {
-        return CustomApiResponse.fail(ApiResponseCode.JWT_SIGNATURE_MISMATCH, null);
-    }
-
-    @ExceptionHandler(JwtException.class)
-    public CustomApiResponse<Void> handleJwtExceptionException(JwtException e) {
-        return CustomApiResponse.fail(ApiResponseCode.JWT_TOKEN_NULL, null);
-    }
-
-    @ExceptionHandler(ExpiredJwtException.class)
-    public CustomApiResponse<Void> handleExpiredJwtException(ExpiredJwtException e) {
-        return CustomApiResponse.fail(ApiResponseCode.JWT_TOKEN_EXPIRED, null);
-    }
-    
-    @ExceptionHandler(JsonProcessingException.class)
-    public CustomApiResponse<Void> handleExpiredJwtException(JsonProcessingException e) {
-        return CustomApiResponse.fail(ApiResponseCode.JSON_PROCESSING_EXCEPTION, null);
-    }
 
     @ExceptionHandler(ApiException.class)
-    public CustomApiResponse<Void> handleApiException(ApiException e) {
+    public ResponseEntity<ApiResponseDto<Void>> handleApiException(ApiException e) {
-        return CustomApiResponse.fail(e.getResponseCode(), null);
+        ApiResponseDto<Void> response = ApiResponseDto.fail(e.getResponseCode());
+        return ResponseEntity.status(e.getResponseCode().getStatusCode()).body(response);
     }
     
     @ExceptionHandler(MethodArgumentNotValidException.class)
-    public CustomApiResponse<Object> handleMethodArgumentNotValidException(MethodArgumentNotValidException e) {
+    public ResponseEntity<ApiResponseDto<Object>> handleMethodArgumentNotValidException(MethodArgumentNotValidException e) {
         // 검증 실패한 필드들의 상세 오류 정보 추출
         var errors = e.getBindingResult().getFieldErrors().stream()
             .map(error -> new ValidationError(error.getField(), error.getDefaultMessage()))
             .toList();
         
-        return CustomApiResponse.fail(ApiResponseCode.ARGUMENT_NOT_VALID, errors);
+        ApiResponseDto<Object> response = ApiResponseDto.fail(ApiResponseCode.COMMON_ARGUMENT_NOT_VALID, errors);
+        return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(response);
     }
 
     // 검증 오류 상세 정보를 위한 내부 클래스
-    private static class ValidationError {
+    private record ValidationError(String field, String message) {}
-        private final String field;
-        private final String message;
 
-        public ValidationError(String field, String message) {
+    @ExceptionHandler(Exception.class)
-            this.field = field;
+    public ResponseEntity<ApiResponseDto<Void>> handleException(Exception e) {
-            this.message = message;
+        log.error("Unexpected error occurred", e);
-        }
         
-        public String getField() { return field; }
+        ApiResponseDto<Void> response = ApiResponseDto.fail(ApiResponseCode.COMMON_INTERNAL_SERVER_ERROR);
-        public String getMessage() { return message; }
+        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(response);
     }
 }

src/main/java/com/bio/bio_backend/global/exception/JwtAccessDeniedHandler.java

@@ -1,42 +0,0 @@
-package com.bio.bio_backend.global.exception;
-
-import java.io.IOException;
-
-import org.springframework.beans.factory.annotation.Qualifier;
-import org.springframework.http.MediaType;
-import org.springframework.security.access.AccessDeniedException;
-import org.springframework.security.web.access.AccessDeniedHandler;
-import org.springframework.stereotype.Component;
-import org.springframework.web.servlet.HandlerExceptionResolver;
-
-import com.fasterxml.jackson.databind.ObjectMapper;
-
-import jakarta.servlet.ServletException;
-import jakarta.servlet.http.HttpServletRequest;
-import jakarta.servlet.http.HttpServletResponse;
-import com.bio.bio_backend.global.dto.CustomApiResponse;
-import com.bio.bio_backend.global.utils.ApiResponseCode;
-
-@Component
-public class JwtAccessDeniedHandler implements AccessDeniedHandler {
-    private final HandlerExceptionResolver resolver;
-
-    public JwtAccessDeniedHandler(@Qualifier("handlerExceptionResolver") HandlerExceptionResolver resolver) {
-        this.resolver = resolver;
-    }
-
-    @Override
-    public void handle(HttpServletRequest request, HttpServletResponse response, AccessDeniedException accessDeniedException) throws IOException, ServletException {
-
-        Exception exception = (Exception) request.getAttribute("exception");
-
-        if (exception != null) {
-            resolver.resolveException(request, response, null, exception);
-        } else {
-            response.setStatus(HttpServletResponse.SC_FORBIDDEN);
-            response.setContentType(MediaType.APPLICATION_JSON_VALUE);
-            new ObjectMapper().writeValue(response.getWriter(),
-                    CustomApiResponse.fail(ApiResponseCode.COMMON_FORBIDDEN, null));
-        }
-    }
-}

src/main/java/com/bio/bio_backend/global/exception/JwtAuthenticationEntryPoint.java

@@ -1,35 +0,0 @@
-package com.bio.bio_backend.global.exception;
-
-import jakarta.servlet.ServletException;
-import jakarta.servlet.http.HttpServletRequest;
-import jakarta.servlet.http.HttpServletResponse;
-import lombok.extern.slf4j.Slf4j;
-import org.springframework.beans.factory.annotation.Qualifier;
-import org.springframework.security.core.AuthenticationException;
-import org.springframework.security.web.AuthenticationEntryPoint;
-import org.springframework.stereotype.Component;
-import org.springframework.web.servlet.HandlerExceptionResolver;
-
-import java.io.IOException;
-
-@Component
-@Slf4j
-public class JwtAuthenticationEntryPoint implements AuthenticationEntryPoint {
-    private final HandlerExceptionResolver resolver;
-
-    public JwtAuthenticationEntryPoint(@Qualifier("handlerExceptionResolver") HandlerExceptionResolver resolver) {
-        this.resolver = resolver;
-    }
-
-    @Override
-    public void commence(HttpServletRequest request, HttpServletResponse response, AuthenticationException authException) throws IOException, ServletException {
-
-        Exception exception = (Exception) request.getAttribute("exception");
-        response.setStatus(HttpServletResponse.SC_UNAUTHORIZED);
-
-        if (exception == null) {
-            return;
-        }
-        resolver.resolveException(request, response, null, exception);
-    }
-}

src/main/java/com/bio/bio_backend/global/filter/HttpLoggingFilter.java

@@ -1,57 +1,199 @@
-//package com.bio.bio_backend.filter;
+package com.bio.bio_backend.global.filter;
-//
+
-//import java.io.IOException;
+import jakarta.servlet.FilterChain;
-//import java.sql.Timestamp;
+import jakarta.servlet.ServletException;
-//
+import jakarta.servlet.http.HttpServletRequest;
-//import org.springframework.security.core.Authentication;
+import jakarta.servlet.http.HttpServletResponse;
-//import org.springframework.security.core.context.SecurityContextHolder;
+import lombok.extern.slf4j.Slf4j;
-//import org.springframework.web.filter.OncePerRequestFilter;
+import org.springframework.stereotype.Component;
-//
+import org.springframework.core.annotation.Order;
-//import jakarta.servlet.FilterChain;
+import org.springframework.web.filter.OncePerRequestFilter;
-//import jakarta.servlet.ServletException;
+import org.springframework.web.util.ContentCachingRequestWrapper;
-//import jakarta.servlet.http.HttpServletRequest;
+import org.springframework.web.util.ContentCachingResponseWrapper;
-//import jakarta.servlet.http.HttpServletResponse;
+
-//import com.bio.bio_backend.domain.common.dto.AccessLogDTO;
+import java.io.IOException;
-//import com.bio.bio_backend.domain.common.service.AccessLogService;
+import java.nio.charset.Charset;
-//import com.bio.bio_backend.domain.user.member.dto.MemberDTO;
+import java.nio.charset.StandardCharsets;
-//import com.bio.bio_backend.global.utils.HttpUtils;
+import java.util.*;
-//
+import org.slf4j.MDC;
-//public class HttpLoggingFilter extends OncePerRequestFilter {
+
-//
+@Slf4j
-////	private AccessLogService accessLogService;
+@Component
-//	private HttpUtils httpUtils;
+@Order(2)
-//
+public class HttpLoggingFilter extends OncePerRequestFilter {
-//	public HttpLoggingFilter(AccessLogService accessLogService, HttpUtils httpUtils) {
+
-//		this.accessLogService = accessLogService;
+    private static final int MAX_LOG_BODY = 10 * 1024; // 10 KB
-//		this.httpUtils = httpUtils;
+
-//	}
+    @Override
-//
+    protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain)
-//	@Override
+            throws ServletException, IOException {
-//	protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain)
+
-//			throws ServletException, IOException {
+        long startTime = System.currentTimeMillis();
-//		// Request 요청 시간
+
-//		Long startedAt = System.currentTimeMillis();
+        ContentCachingRequestWrapper wrappedRequest =
-//		filterChain.doFilter(request, response);
+                (request instanceof ContentCachingRequestWrapper)
-//		Long finishedAt = System.currentTimeMillis();
+                        ? (ContentCachingRequestWrapper) request
-//
+                        : new ContentCachingRequestWrapper(request);
-//		Authentication auth = SecurityContextHolder.getContext().getAuthentication();
+
-//		MemberDTO member = null;
+        ContentCachingResponseWrapper wrappedResponse =
-//		if(auth != null && auth.getPrincipal() instanceof MemberDTO) {
+                (response instanceof ContentCachingResponseWrapper)
-//			member = (MemberDTO) auth.getPrincipal();
+                        ? (ContentCachingResponseWrapper) response
-//		}
+                        : new ContentCachingResponseWrapper(response);
-//
+
-//		AccessLogDTO log = new AccessLogDTO();
+        log.info("********************************************************************************");
-//		log.setMbrSeq(member == null ? -1 : member.getSeq());
+        log.info("* [START] HTTP LOGGING | TRACE ID: {}", getCurrentTraceId());
-//		log.setType(httpUtils.getResponseType(response.getContentType()));
+        log.info("* Method: {} | URI: {}", wrappedRequest.getMethod(), wrappedRequest.getRequestURI());
-//		log.setMethod(request.getMethod());
+        log.info("* Headers: {}", getRequestHeaders(wrappedRequest));
-//		log.setIp(httpUtils.getClientIp());
+        log.info("********************************************************************************");
-//		log.setUri(request.getRequestURI());
+
-//		log.setReqAt(new Timestamp(startedAt));
+        try {
-//		log.setResAt(new Timestamp(finishedAt));
+            filterChain.doFilter(wrappedRequest, wrappedResponse);
-//		log.setElapsedTime(finishedAt - startedAt);
+        } finally {
-//		log.setResStatus(String.valueOf(response.getStatus()));
+            long duration = System.currentTimeMillis() - startTime;
-//
+            String reqBody = extractRequestBody(wrappedRequest);
-//		accessLogService.createAccessLog(log);
+            String resBody = extractResponseBody(wrappedResponse);
-//	}
+
-//
+            log.info("********************************************************************************");
-//}
+            log.info("* [END] HTTP LOGGING");
+            log.info("* Method: {} | URI: {}", wrappedRequest.getMethod(), wrappedRequest.getRequestURI());
+            log.info("* Status: {} | Duration: {}ms", wrappedResponse.getStatus(), duration);
+            log.info("* Req Body: {}", maskSensitiveData(reqBody));
+            log.info("* Res Headers: {}", getResponseHeaders(wrappedResponse));
+            log.info("* Res Body: {}", maskSensitiveData(resBody));
+            log.info("********************************************************************************");
+
+            wrappedResponse.copyBodyToResponse();
+        }
+    }
+
+    private String extractRequestBody(ContentCachingRequestWrapper wrapper) {
+        // multipart/form-data 등은 보통 로깅 제외
+        String ct = Optional.ofNullable(wrapper.getContentType()).orElse("");
+        if (ct.toLowerCase(Locale.ROOT).startsWith("multipart/")) {
+            return "(multipart skipped)";
+        }
+
+        byte[] buf = wrapper.getContentAsByteArray();
+        if (buf == null || buf.length == 0) return "";
+        Charset cs = resolveCharset(wrapper.getCharacterEncoding());
+        String s = new String(buf, cs);
+        return truncate(s, MAX_LOG_BODY);
+    }
+
+    private String extractResponseBody(ContentCachingResponseWrapper wrapper) {
+        byte[] buf = wrapper.getContentAsByteArray();
+        if (buf == null || buf.length == 0) return "";
+        
+        // UTF-8로 고정하여 한글 깨짐 방지
+        String s = new String(buf, StandardCharsets.UTF_8);
+        return truncate(s, MAX_LOG_BODY);
+    }
+
+    private Charset resolveCharset(String enc) {
+        try {
+            return (enc != null) ? Charset.forName(enc) : StandardCharsets.UTF_8;
+        } catch (Exception e) {
+            return StandardCharsets.UTF_8;
+        }
+    }
+
+    private String truncate(String s, int max) {
+        if (s == null) return "N/A";
+        if (s.length() <= max) return s;
+        return s.substring(0, max) + "...(truncated)";
+    }
+
+    // 민감 정보 마스킹 (간단/범용)
+    private String maskSensitiveData(String body) {
+        if (body == null || body.isEmpty()) return "N/A";
+        // JSON 키 기준 토큰/비번류 마스킹 (대소문자 무시)
+        String masked = body
+                .replaceAll("(?i)(\"password\"\\s*:\\s*\")([^\"]+)(\")", "$1***$3")
+                .replaceAll("(?i)(\"AccessToken\"\\s*:\\s*\")([^\"]+)(\")", "$1***$3")
+                .replaceAll("(?i)(\"RefreshToken\"\\s*:\\s*\")([^\"]+)(\")", "$1***$3")
+                .replaceAll("(?i)(\"authorization\"\\s*:\\s*\")([^\"]+)(\")", "$1***$3");
+        // x-www-form-urlencoded 형태의 password 파라미터 마스킹
+        masked = masked.replaceAll("(?i)(^|[&])password=([^&]*)", "$1password=***");
+        return masked;
+    }
+
+    private String getRequestHeaders(HttpServletRequest request) {
+        Map<String, String> headers = new LinkedHashMap<>();
+        // 필요한 헤더만 추리거나, 전부 찍고 민감한 건 마스킹
+        Collections.list(request.getHeaderNames()).forEach(name -> {
+            String value = request.getHeader(name);
+            if (value == null) {
+                headers.put(name, null);
+                return;
+            }
+
+            if ("cookie".equalsIgnoreCase(name)) {
+                headers.put(name, maskCookieHeader(value));
+                return;
+            }
+
+            // 기타 헤더는 그대로 기록 (요구사항에 따라 최소 마스킹 적용)
+            headers.put(name, value);
+        });
+        return headers.toString();
+    }
+
+    private String getResponseHeaders(HttpServletResponse response) {
+        Map<String, String> headers = new LinkedHashMap<>();
+        for (String name : response.getHeaderNames()) {
+            if ("set-cookie".equalsIgnoreCase(name)) {
+                List<String> values = new ArrayList<>(response.getHeaders(name));
+                List<String> masked = new ArrayList<>();
+                for (String v : values) {
+                    masked.add(maskSetCookieHeader(v));
+                }
+                headers.put(name, String.join(",", masked));
+                continue;
+            }
+
+            headers.put(name, String.join(",", response.getHeaders(name)));
+        }
+        if (response.getContentType() != null) {
+            headers.putIfAbsent("Content-Type", response.getContentType());
+        }
+        return headers.toString();
+    }
+
+    // Cookie 헤더: "a=1; AccessToken=xxx; RefreshToken=yyy" 형태 중 AccessToken/RefreshToken만 마스킹
+    private String maskCookieHeader(String cookieHeader) {
+        if (cookieHeader == null || cookieHeader.isEmpty()) return cookieHeader;
+        String masked = cookieHeader
+                .replaceAll("(?i)(^|;\\s*)(AccessToken)=([^;]*)", "$1$2=***")
+                .replaceAll("(?i)(^|;\\s*)(RefreshToken)=([^;]*)", "$1$2=***");
+        return masked;
+    }
+
+    // Set-Cookie: "AccessToken=xxx; Path=/; HttpOnly; ..." 형태 중 AccessToken/RefreshToken만 마스킹
+    private String maskSetCookieHeader(String setCookie) {
+        if (setCookie == null || setCookie.isEmpty()) return setCookie;
+        String masked = setCookie
+                .replaceAll("(?i)^(AccessToken)=([^;]*)", "$1=***")
+                .replaceAll("(?i)^(RefreshToken)=([^;]*)", "$1=***");
+        return masked;
+    }
+
+    @Override
+    protected boolean shouldNotFilter(HttpServletRequest request) {
+        String path = request.getRequestURI();
+        return path.startsWith("/static/")
+                || path.startsWith("/css/")
+                || path.startsWith("/js/")
+                || path.startsWith("/images/")
+                || path.equals("/favicon.ico")
+                || path.startsWith("/actuator/health");
+    }
+
+    /**
+     * 현재 스레드의 TRACE ID를 반환합니다.
+     * @return TRACE ID 또는 "N/A"
+     */
+    private String getCurrentTraceId() {
+        String traceId = MDC.get("traceId");
+        return traceId != null ? traceId : "N/A";
+    }
+}

src/main/java/com/bio/bio_backend/global/filter/JwtTokenIssuanceFilter.java

@@ -0,0 +1,98 @@
+package com.bio.bio_backend.global.filter;
+
+import com.fasterxml.jackson.databind.ObjectMapper;
+import jakarta.servlet.FilterChain;
+import jakarta.servlet.ServletException;
+import jakarta.servlet.http.HttpServletRequest;
+import jakarta.servlet.http.HttpServletResponse;
+import com.bio.bio_backend.global.dto.ApiResponseDto;
+import com.bio.bio_backend.domain.base.member.dto.LoginRequestDto;
+import com.bio.bio_backend.domain.base.member.dto.LoginResponseDto;
+import com.bio.bio_backend.domain.base.member.dto.MemberDto;
+import com.bio.bio_backend.domain.base.member.mapper.MemberMapper;
+import com.bio.bio_backend.domain.base.member.service.MemberService;
+import com.bio.bio_backend.global.constants.ApiResponseCode;
+import com.bio.bio_backend.global.utils.JwtUtils;
+import com.bio.bio_backend.global.utils.HttpUtils;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.MediaType;
+import org.springframework.security.authentication.AuthenticationManager;
+import org.springframework.security.authentication.AuthenticationServiceException;
+import org.springframework.security.authentication.UsernamePasswordAuthenticationToken;
+import org.springframework.security.core.Authentication;
+import org.springframework.security.core.AuthenticationException;
+import org.springframework.security.core.context.SecurityContext;
+import org.springframework.security.core.context.SecurityContextHolder;
+import org.springframework.security.core.context.SecurityContextHolderStrategy;
+import org.springframework.security.core.userdetails.UserDetails;
+import org.springframework.security.web.authentication.UsernamePasswordAuthenticationFilter;
+
+import java.io.IOException;
+import java.time.LocalDateTime;
+
+@RequiredArgsConstructor
+@Slf4j
+public class JwtTokenIssuanceFilter extends UsernamePasswordAuthenticationFilter {
+
+    private final AuthenticationManager authenticationManager;
+    private final JwtUtils jwtUtils;
+    private final ObjectMapper objectMapper;
+    private final MemberService memberService;
+    private final HttpUtils httpUtils;
+    private final MemberMapper memberMapper;
+
+    // 사용자 login 인증 처리
+    @Override
+    public Authentication attemptAuthentication(HttpServletRequest request, HttpServletResponse response) throws AuthenticationException {
+        try {
+            LoginRequestDto requestDto = new ObjectMapper().readValue(request.getInputStream(), LoginRequestDto.class);
+            UsernamePasswordAuthenticationToken authToken = new UsernamePasswordAuthenticationToken(
+                requestDto.getUserId(), requestDto.getPassword());
+
+            return authenticationManager.authenticate(authToken);
+        } catch (IOException e) {
+            throw new AuthenticationServiceException("로그인 요청 파싱 중 오류가 발생했습니다", e);
+        }
+    }
+
+    // 사용자 인증 성공 후 token 발급
+    @Override
+    protected void successfulAuthentication(HttpServletRequest request, HttpServletResponse response,
+                                            FilterChain chain, Authentication authResult) throws IOException, ServletException {
+
+        UserDetails userDetails = (UserDetails) authResult.getPrincipal();
+        MemberDto member = (MemberDto) userDetails;
+        
+        // 토큰 생성
+        String accessToken = jwtUtils.createAccessToken(member.getOid(), member.getUserId(), member.getName());
+        String refreshToken = jwtUtils.createRefreshToken(member.getUserId(), httpUtils.getClientIp());
+        
+        member.setRefreshToken(refreshToken);
+        member.setLoginIp(httpUtils.getClientIp());
+        member.setLastLoginAt(LocalDateTime.now());
+        memberService.updateMember(member);
+
+        // Refresh 토큰 쿠키 저장
+        jwtUtils.setRefreshTokenCookie(response, refreshToken);
+
+        // Access 토큰 쿠키 저장
+        jwtUtils.setAccessTokenCookie(response, accessToken);
+
+        SecurityContextHolderStrategy contextHolder = SecurityContextHolder.getContextHolderStrategy();
+        SecurityContext context = contextHolder.createEmptyContext();
+        context.setAuthentication(authResult);
+        contextHolder.setContext(context);
+
+        LoginResponseDto loginResponseDto = memberMapper.toLoginResponseDto(member);
+
+        // login 성공 메시지 전송
+        response.setStatus(HttpStatus.OK.value());
+        response.setContentType(MediaType.APPLICATION_JSON_VALUE + ";charset=UTF-8");
+        objectMapper.writeValue(
+            response.getWriter(),
+            ApiResponseDto.success(ApiResponseCode.LOGIN_SUCCESSFUL, loginResponseDto)
+        );
+    }
+}

src/main/java/com/bio/bio_backend/global/filter/JwtTokenValidationFilter.java

@@ -0,0 +1,132 @@
+package com.bio.bio_backend.global.filter;
+
+import java.io.IOException;
+
+import com.bio.bio_backend.domain.base.member.dto.MemberDto;
+import com.bio.bio_backend.global.utils.HttpUtils;
+
+import org.springframework.http.MediaType;
+import org.springframework.security.authentication.UsernamePasswordAuthenticationToken;
+import org.springframework.security.core.context.SecurityContextHolder;
+import org.springframework.security.core.userdetails.UserDetails;
+import org.springframework.security.web.authentication.WebAuthenticationDetailsSource;
+import org.springframework.web.filter.OncePerRequestFilter;
+
+import com.fasterxml.jackson.databind.ObjectMapper;
+
+import jakarta.servlet.FilterChain;
+import jakarta.servlet.ServletException;
+import jakarta.servlet.http.HttpServletRequest;
+import jakarta.servlet.http.HttpServletResponse;
+import com.bio.bio_backend.global.dto.ApiResponseDto;
+import com.bio.bio_backend.domain.base.member.service.MemberService;
+import com.bio.bio_backend.global.constants.ApiResponseCode;
+import com.bio.bio_backend.global.utils.JwtUtils;
+
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+
+@RequiredArgsConstructor
+@Slf4j
+public class JwtTokenValidationFilter extends OncePerRequestFilter {
+
+    private final JwtUtils jwtUtils;
+    private final HttpUtils httpUtils;
+    private final MemberService memberService;
+
+
+
+    @Override
+    protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response,
+                                    FilterChain filterChain) throws ServletException, IOException {
+
+        log.debug("JWT 토큰 검증 필터 실행 - URI: {}", request.getRequestURI());
+
+        String accessToken = jwtUtils.extractAccessJwtFromCookie(request);
+        String refreshToken = jwtUtils.extractRefreshJwtFromCookie(request);
+
+        // Access Token이 있고 유효한 경우
+        if (accessToken != null && jwtUtils.validateAccessToken(accessToken)) {
+            String username = jwtUtils.extractUsername(accessToken);
+            UserDetails userDetails = jwtUtils.createUserDetailsFromToken(accessToken);
+
+            if (userDetails != null) {
+                UsernamePasswordAuthenticationToken authentication =
+                        new UsernamePasswordAuthenticationToken(userDetails, null, userDetails.getAuthorities());
+                authentication.setDetails(new WebAuthenticationDetailsSource().buildDetails(request));
+                SecurityContextHolder.getContext().setAuthentication(authentication);
+                
+                log.debug("Access Token 인증 성공: {}", username);
+                filterChain.doFilter(request, response);
+                return;
+            }
+        } else {
+            // Access Token이 없거나 만료된 경우, Refresh Token으로 갱신 시도
+            if (refreshToken != null) {
+                // 1. Refresh Token 유효성 검증
+                if (!jwtUtils.isValidRefreshToken(refreshToken)) {
+                    log.warn("Refresh Token이 유효하지 않습니다. URI: {}", request.getRequestURI());
+                    sendJsonResponse(response, ApiResponseDto.fail(ApiResponseCode.JWT_TOKEN_EXPIRED));
+                    return;
+                }
+
+                // 2. IP 주소 검증
+                if (!jwtUtils.isValidClientIp(refreshToken, httpUtils.getClientIp())) {
+                    log.warn("클라이언트 IP 주소가 일치하지 않습니다. URI: {}, IP: {}",
+                            request.getRequestURI(), request.getRemoteAddr());
+                    sendJsonResponse(response, ApiResponseDto.fail(ApiResponseCode.INVALID_CLIENT_IP));
+                    return;
+                }
+
+                // 모든 검증을 통과한 경우 토큰 갱신 진행
+                String username = jwtUtils.extractUsername(refreshToken);
+
+                UserDetails userDetails = memberService.loadUserByUsername(username);
+
+                // 새로운 Access Token 생성
+                String newAccessToken = jwtUtils.createAccessToken(
+                    ((MemberDto) userDetails).getOid(),
+                    userDetails.getUsername(), 
+                    ((MemberDto) userDetails).getName()
+                );
+
+                // 새로운 Access Token을 쿠키에 설정
+                jwtUtils.setAccessTokenCookie(response, newAccessToken);
+
+                // Refresh Token 갱신
+                String newRefreshToken = jwtUtils.createRefreshToken(username, httpUtils.getClientIp());
+                jwtUtils.setRefreshTokenCookie(response, newRefreshToken);
+
+                MemberDto member = (MemberDto) userDetails;
+                member.setRefreshToken(newRefreshToken);
+                member.setLoginIp(httpUtils.getClientIp());
+                memberService.updateMember(member);
+
+                // 인증 정보 설정
+                UsernamePasswordAuthenticationToken authentication =
+                        new UsernamePasswordAuthenticationToken(userDetails, null, userDetails.getAuthorities());
+                authentication.setDetails(new WebAuthenticationDetailsSource().buildDetails(request));
+                SecurityContextHolder.getContext().setAuthentication(authentication);
+
+                log.info("토큰 자동 갱신 성공: {}", username);
+                filterChain.doFilter(request, response);
+                return;
+            }
+
+        }
+
+        // 토큰이 없거나 모두 유효하지 않은 경우
+        log.warn("유효한 JWT 토큰이 없습니다. URI: {}", request.getRequestURI());
+        sendJsonResponse(response, ApiResponseDto.fail(ApiResponseCode.JWT_TOKEN_NULL));
+    }
+
+    private void sendJsonResponse(HttpServletResponse response, ApiResponseDto<?> apiResponse) throws IOException {
+        response.setContentType(MediaType.APPLICATION_JSON_VALUE);
+        response.setCharacterEncoding("UTF-8");
+        response.setStatus(apiResponse.getCode());
+
+        ObjectMapper objectMapper = new ObjectMapper();
+        String jsonResponse = objectMapper.writeValueAsString(apiResponse);
+        response.getWriter().write(jsonResponse);
+    }
+}

src/main/java/com/bio/bio_backend/global/filter/TraceIdFilter.java

@@ -0,0 +1,51 @@
+package com.bio.bio_backend.global.filter;
+
+import org.slf4j.MDC;
+import org.springframework.core.annotation.Order;
+import org.springframework.stereotype.Component;
+import org.springframework.web.filter.OncePerRequestFilter;
+
+import jakarta.servlet.FilterChain;
+import jakarta.servlet.ServletException;
+import jakarta.servlet.http.HttpServletRequest;
+import jakarta.servlet.http.HttpServletResponse;
+import java.io.IOException;
+import java.util.UUID;
+
+@Component
+@Order(1)
+public class TraceIdFilter extends OncePerRequestFilter {
+
+    private static final String TRACE_ID_HEADER = "X-Trace-Id";
+    private static final String TRACE_ID_MDC_KEY = "traceId";
+
+    @Override
+    protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain)
+            throws ServletException, IOException {
+        
+        try {
+            // 헤더에서 TRACE ID를 가져오거나 새로 생성
+            String traceId = request.getHeader(TRACE_ID_HEADER);
+            if (traceId == null || traceId.trim().isEmpty()) {
+                traceId = generateTraceId();
+            }
+            
+            // MDC에 TRACE ID 설정
+            MDC.put(TRACE_ID_MDC_KEY, traceId);
+            
+            // 응답 헤더에 TRACE ID 추가
+            response.addHeader(TRACE_ID_HEADER, traceId);
+            
+            filterChain.doFilter(request, response);
+            
+        } finally {
+            // 요청 처리 완료 후 MDC 정리
+            MDC.remove(TRACE_ID_MDC_KEY);
+        }
+    }
+
+    private String generateTraceId() {
+        // UUID 기반 TRACE ID 생성 (8자리로 축약)
+        return UUID.randomUUID().toString().substring(0, 8);
+    }
+}

src/main/java/com/bio/bio_backend/global/filter/UriAllowFilter.java

@@ -1,11 +1,9 @@
-package com.bio.bio_backend.global.security;
+package com.bio.bio_backend.global.filter;
 
 
-import java.util.Arrays;
 import java.util.regex.Pattern;
 
 import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.context.annotation.Bean;
 import org.springframework.stereotype.Component;
 
 import jakarta.servlet.http.HttpServletRequest;

src/main/java/com/bio/bio_backend/global/security/JwtAuthenticationFilter.java

@@ -1,121 +0,0 @@
-package com.bio.bio_backend.global.security;
-
-import com.fasterxml.jackson.databind.ObjectMapper;
-import jakarta.servlet.FilterChain;
-import jakarta.servlet.ServletException;
-import jakarta.servlet.http.Cookie;
-import jakarta.servlet.http.HttpServletRequest;
-import jakarta.servlet.http.HttpServletResponse;
-import com.bio.bio_backend.global.dto.CustomApiResponse;
-import com.bio.bio_backend.domain.user.member.dto.LoginRequestDto;
-import com.bio.bio_backend.domain.user.member.dto.LoginResponseDto;
-import com.bio.bio_backend.domain.user.member.dto.MemberDto;
-import com.bio.bio_backend.domain.user.member.service.MemberService;
-import com.bio.bio_backend.global.utils.ApiResponseCode;
-import com.bio.bio_backend.global.utils.JwtUtils;
-import lombok.RequiredArgsConstructor;
-import lombok.SneakyThrows;
-import lombok.extern.slf4j.Slf4j;
-import org.springframework.core.env.Environment;
-import org.springframework.http.HttpStatus;
-import org.springframework.http.MediaType;
-import org.springframework.security.authentication.AuthenticationManager;
-import org.springframework.security.authentication.AuthenticationServiceException;
-import org.springframework.security.authentication.UsernamePasswordAuthenticationToken;
-import org.springframework.security.core.Authentication;
-import org.springframework.security.core.AuthenticationException;
-import org.springframework.security.core.context.SecurityContext;
-import org.springframework.security.core.context.SecurityContextHolder;
-import org.springframework.security.core.context.SecurityContextHolderStrategy;
-import org.springframework.security.core.userdetails.UserDetails;
-import org.springframework.security.web.authentication.UsernamePasswordAuthenticationFilter;
-
-import java.io.IOException;
-import java.sql.Timestamp;
-import java.time.LocalDateTime;
-import java.util.Objects;
-
-@RequiredArgsConstructor
-@Slf4j
-public class JwtAuthenticationFilter extends UsernamePasswordAuthenticationFilter {
-
-    private final AuthenticationManager authenticationManager;
-    private final MemberService memberService;
-    private final JwtUtils jwtUtils;
-    private final Environment env;
-
-    // 사용자 login 인증 처리
-    @SneakyThrows
-    @Override
-    public Authentication attemptAuthentication(HttpServletRequest request, HttpServletResponse response)
-            throws AuthenticationException {
-
-        LoginRequestDto requestDto = new ObjectMapper().readValue(request.getInputStream(), LoginRequestDto.class);
-
-//        UsernamePasswordAuthenticationToken authToken;
-        UsernamePasswordAuthenticationToken authToken = new UsernamePasswordAuthenticationToken(requestDto.getUserId(), requestDto.getPassword());
-
-        /*
-        if (req.getLoginLogFlag() == 1) {
-            authToken = new UsernamePasswordAuthenticationToken("admin2", "test123!"); // 비밀번호는 실제 비밀번호로 설정해야 함
-        } else {
-            throw new AuthenticationServiceException("login fail");
-        }
-         */
-        return authenticationManager.authenticate(authToken);
-    }
-
-    // 사용자 인증 성공 후 token 발급
-    @Override
-    protected void successfulAuthentication(HttpServletRequest request, HttpServletResponse response,
-                                            FilterChain chain, Authentication authResult) throws IOException, ServletException {
-
-        UserDetails userDetails = (UserDetails) authResult.getPrincipal();
-
-        MemberDto member = (MemberDto) userDetails;
-        
-        String accessToken = jwtUtils.generateToken(member.getUserId(), member.getRole().getValue(),
-                Long.parseLong(Objects.requireNonNull(env.getProperty("token.expiration_time_access"))));
-
-        String refreshToken = jwtUtils.generateToken(member.getUserId(), member.getRole().getValue(),
-                Long.parseLong(Objects.requireNonNull(env.getProperty("token.expiration_time_refresh"))));
-        
-
-        member.setRefreshToken(refreshToken);
-        member.setLastLoginAt(LocalDateTime.now());
-
-        memberService.updateRefreshToken(member);
-
-        // Refresh 토큰 쿠키 저장
-        Cookie refreshTokenCookie = new Cookie("RefreshToken", refreshToken);
-        refreshTokenCookie.setHttpOnly(true);
-        refreshTokenCookie.setSecure(false);
-        refreshTokenCookie.setPath("/");
-        refreshTokenCookie.setMaxAge(Integer.parseInt(env.getProperty("token.expiration_time_refresh")));
-
-        // JWT 토큰 전달
-        response.setHeader("Authorization", "Bearer " + accessToken);
-//        response.addCookie(refreshTokenCookie);
-        response.addHeader("Set-Cookie", 
-        	    String.format("%s=%s; HttpOnly; Secure; Path=/; Max-Age=%d; SameSite=None", 
-        	    refreshTokenCookie.getName(), 
-        	    refreshTokenCookie.getValue(), 
-        	    refreshTokenCookie.getMaxAge()));
-
-        SecurityContextHolderStrategy contextHolder = SecurityContextHolder.getContextHolderStrategy();
-        SecurityContext context = contextHolder.createEmptyContext();
-        context.setAuthentication(authResult);
-        contextHolder.setContext(context);
-
-        LoginResponseDto memberData = new LoginResponseDto();
-        memberData.setUserId(member.getUserId());
-        memberData.setRole(member.getRole().getValue());
-        memberData.setLastLoginAt(member.getLastLoginAt());
-
-        // login 성공 메시지 전송
-        response.setStatus(HttpStatus.OK.value());
-        response.setContentType(MediaType.APPLICATION_JSON_VALUE);
-        new ObjectMapper().writeValue(response.getWriter(),
-                CustomApiResponse.success(ApiResponseCode.LOGIN_SUCCESSFUL, memberData));
-    }
-}