Merge remote-tracking branch 'origin/main'

.gitignore

@@ -39,6 +39,7 @@ jacoco.exec
 .classpath
 .settings/
 bin/
+.metadata/
 
 # Temporary files created by the OS
 .DS_Store

Dockerfile

@@ -0,0 +1,19 @@
+# --- build stage ---
+FROM gradle:8.10.2-jdk17-alpine AS build
+WORKDIR /workspace
+COPY . .
+# 테스트는 생략(필요시 제거)
+RUN ./gradlew --no-daemon clean bootJar -x test
+
+# --- run stage ---
+FROM eclipse-temurin:17-jre-alpine
+WORKDIR /app
+RUN apk add --no-cache tzdata && cp /usr/share/zoneinfo/Asia/Seoul /etc/localtime
+# 로그 디렉터리 생성 및 권한 설정
+RUN mkdir -p /app/logs && chown -R 1000:1000 /app
+RUN addgroup -S app && adduser -S app -G app -u 1000
+USER app
+COPY --from=build /workspace/build/libs/*.jar /app/app.jar
+EXPOSE 8080
+ENV JAVA_OPTS="-Xms256m -Xmx512m"
+ENTRYPOINT ["sh","-c","java $JAVA_OPTS -jar /app/app.jar"]

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. 프로젝트 구조
@@ -66,7 +88,7 @@ public class ApiResponseDto<T> {
   "success": true,
   "code": 201,
   "message": "COMMON_SUCCESS_CREATED",
-  "description": "Created successfully",
+  "description": "성공적으로 생성되었습니다",
   "data": {
     "seq": 1,
     "userId": "user123",
@@ -82,7 +104,7 @@ public class ApiResponseDto<T> {
   "success": false,
   "code": 409,
   "message": "USER_ID_DUPLICATE",
-  "description": "User ID already exists"
+  "description": "이미 존재하는 사용자 ID입니다"
 }
 ```
 
@@ -142,8 +164,8 @@ public enum ApiResponseCode {
 
 #### 토큰 구성
 
-- **Access Token**: 15분 (900,000ms) - API 요청 시 사용
+- **Access Token** - 쿠키에 저장, 자동 갱신
-- **Refresh Token**: 7일 (604,800,000ms) - 쿠키에 저장, 자동 갱신
+- **Refresh Token** - 쿠키에 저장, 자동 갱신
 
 #### 자동 토큰 갱신
 
@@ -189,10 +211,8 @@ public enum ApiResponseCode {
 @Operation(summary = "회원 가입", description = "새로운 회원을 등록합니다.")
 @ApiResponses(value = {
     @ApiResponse(responseCode = "201", description = "회원 가입 성공"),
-    @ApiResponse(responseCode = "400", description = "잘못된 요청 데이터",
+    @ApiResponse(responseCode = "400", description = "잘못된 요청 데이터", content = @Content),
-                content = @Content(schema = @Schema(implementation = ApiResponseDto.class))),
+    @ApiResponse(responseCode = "409", description = "중복된 사용자 정보", content = @Content)
-    @ApiResponse(responseCode = "409", description = "중복된 사용자 정보",
-                content = @Content(schema = @Schema(implementation = ApiResponseDto.class)))
 })
 ```
 

build.gradle

@@ -62,7 +62,7 @@ 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'
@@ -83,13 +83,16 @@ 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)
+	options.encoding = 'UTF-8'
 }
 
 jib {

ddl/schema_entity.sql

@@ -1,291 +1,491 @@
-
+
-    create table st_common_code (
+    create table st_auth_group (
-        sort_order integer not null,
+        created_at timestamp(6) not null,
-        use_flag boolean not null,
+        created_oid bigint,
-        created_at timestamp(6) not null,
+        oid bigint not null,
-        created_oid bigint,
+        updated_at timestamp(6) not null,
-        oid bigint not null,
+        updated_oid bigint,
-        updated_at timestamp(6) not null,
+        name varchar(100),
-        updated_oid bigint,
+        created_id varchar(255),
-        code varchar(50) not null unique,
+        updated_id varchar(255),
-        group_code varchar(50) not null,
+        primary key (oid)
-        parent_code varchar(50),
+    );
-        character_ref1 varchar(100),
+
-        character_ref2 varchar(100),
+    comment on column st_auth_group.created_at is
-        character_ref3 varchar(100),
+        '생성일시';
-        character_ref4 varchar(100),
+
-        character_ref5 varchar(100),
+    comment on column st_auth_group.created_oid is
-        name varchar(100) not null,
+        '생성자 OID';
-        description varchar(500),
+
-        created_id varchar(255),
+    comment on column st_auth_group.oid is
-        updated_id varchar(255),
+        'OID';
-        primary key (oid)
+
-    );
+    comment on column st_auth_group.updated_at is
-
+        '수정일시';
-    comment on column st_common_code.sort_order is
+
-        '정렬 순번';
+    comment on column st_auth_group.updated_oid is
-
+        '수정자 OID';
-    comment on column st_common_code.use_flag is
+
-        '사용 여부';
+    comment on column st_auth_group.name is
-
+        '권한 그룹명';
-    comment on column st_common_code.created_at is
+
-        '생성일시';
+    comment on column st_auth_group.created_id is
-
+        '생성자 ID';
-    comment on column st_common_code.created_oid is
+
-        '생성자 OID';
+    comment on column st_auth_group.updated_id is
-
+        '수정자 ID';
-    comment on column st_common_code.oid is
+
-        'OID';
+    create table st_auth_group_resource (
-
+        auth_group_oid bigint,
-    comment on column st_common_code.updated_at is
+        created_at timestamp(6) not null,
-        '수정일시';
+        created_oid bigint,
-
+        oid bigint not null,
-    comment on column st_common_code.updated_oid is
+        resource_oid bigint,
-        '수정자 OID';
+        updated_at timestamp(6) not null,
-
+        updated_oid bigint,
-    comment on column st_common_code.code is
+        created_id varchar(255),
-        '코드';
+        updated_id varchar(255),
-
+        primary key (oid)
-    comment on column st_common_code.group_code is
+    );
-        '그룹 코드';
+
-
+    comment on column st_auth_group_resource.auth_group_oid is
-    comment on column st_common_code.parent_code is
+        '권한 그룹 OID';
-        '부모 코드';
+
-
+    comment on column st_auth_group_resource.created_at is
-    comment on column st_common_code.character_ref1 is
+        '생성일시';
-        '문자 참조1';
+
-
+    comment on column st_auth_group_resource.created_oid is
-    comment on column st_common_code.character_ref2 is
+        '생성자 OID';
-        '문자 참조2';
+
-
+    comment on column st_auth_group_resource.oid is
-    comment on column st_common_code.character_ref3 is
+        'OID';
-        '문자 참조3';
+
-
+    comment on column st_auth_group_resource.resource_oid is
-    comment on column st_common_code.character_ref4 is
+        '리소스 OID';
-        '문자 참조4';
+
-
+    comment on column st_auth_group_resource.updated_at is
-    comment on column st_common_code.character_ref5 is
+        '수정일시';
-        '문자 참조5';
+
-
+    comment on column st_auth_group_resource.updated_oid is
-    comment on column st_common_code.name is
+        '수정자 OID';
-        '코드명';
+
-
+    comment on column st_auth_group_resource.created_id is
-    comment on column st_common_code.description is
+        '생성자 ID';
-        '설명';
+
-
+    comment on column st_auth_group_resource.updated_id is
-    comment on column st_common_code.created_id is
+        '수정자 ID';
-        '생성자 ID';
+
-
+    create table st_common_code (
-    comment on column st_common_code.updated_id is
+        sort_order integer not null,
-        '수정자 ID';
+        use_flag boolean not null,
-
+        created_at timestamp(6) not null,
-    create table st_common_group_code (
+        created_oid bigint,
-        sort_order integer not null,
+        oid bigint not null,
-        use_flag boolean not null,
+        updated_at timestamp(6) not null,
-        created_at timestamp(6) not null,
+        updated_oid bigint,
-        created_oid bigint,
+        code varchar(50) not null unique,
-        oid bigint not null,
+        group_code varchar(50) not null,
-        updated_at timestamp(6) not null,
+        parent_code varchar(50),
-        updated_oid bigint,
+        character_ref1 varchar(100),
-        code varchar(50) not null unique,
+        character_ref2 varchar(100),
-        character_ref1_title varchar(100),
+        character_ref3 varchar(100),
-        character_ref2_title varchar(100),
+        character_ref4 varchar(100),
-        character_ref3_title varchar(100),
+        character_ref5 varchar(100),
-        character_ref4_title varchar(100),
+        name varchar(100) not null,
-        character_ref5_title varchar(100),
+        description varchar(500),
-        name varchar(100) not null,
+        created_id varchar(255),
-        created_id varchar(255),
+        updated_id varchar(255),
-        updated_id varchar(255),
+        primary key (oid)
-        primary key (oid)
+    );
-    );
+
-
+    comment on column st_common_code.sort_order is
-    comment on column st_common_group_code.sort_order is
+        '정렬 순번';
-        '정렬 순번';
+
-
+    comment on column st_common_code.use_flag is
-    comment on column st_common_group_code.use_flag is
+        '사용 여부';
-        '사용 여부';
+
-
+    comment on column st_common_code.created_at is
-    comment on column st_common_group_code.created_at is
+        '생성일시';
-        '생성일시';
+
-
+    comment on column st_common_code.created_oid is
-    comment on column st_common_group_code.created_oid is
+        '생성자 OID';
-        '생성자 OID';
+
-
+    comment on column st_common_code.oid is
-    comment on column st_common_group_code.oid is
+        'OID';
-        'OID';
+
-
+    comment on column st_common_code.updated_at is
-    comment on column st_common_group_code.updated_at is
+        '수정일시';
-        '수정일시';
+
-
+    comment on column st_common_code.updated_oid is
-    comment on column st_common_group_code.updated_oid is
+        '수정자 OID';
-        '수정자 OID';
+
-
+    comment on column st_common_code.code is
-    comment on column st_common_group_code.code is
+        '코드';
-        '코드';
+
-
+    comment on column st_common_code.group_code is
-    comment on column st_common_group_code.character_ref1_title is
+        '그룹 코드';
-        '문자 참조 타이틀1';
+
-
+    comment on column st_common_code.parent_code is
-    comment on column st_common_group_code.character_ref2_title is
+        '부모 코드';
-        '문자 참조 타이틀2';
+
-
+    comment on column st_common_code.character_ref1 is
-    comment on column st_common_group_code.character_ref3_title is
+        '문자 참조1';
-        '문자 참조 타이틀3';
+
-
+    comment on column st_common_code.character_ref2 is
-    comment on column st_common_group_code.character_ref4_title is
+        '문자 참조2';
-        '문자 참조 타이틀4';
+
-
+    comment on column st_common_code.character_ref3 is
-    comment on column st_common_group_code.character_ref5_title is
+        '문자 참조3';
-        '문자 참조 타이틀5';
+
-
+    comment on column st_common_code.character_ref4 is
-    comment on column st_common_group_code.name is
+        '문자 참조4';
-        '코드명';
+
-
+    comment on column st_common_code.character_ref5 is
-    comment on column st_common_group_code.created_id is
+        '문자 참조5';
-        '생성자 ID';
+
-
+    comment on column st_common_code.name is
-    comment on column st_common_group_code.updated_id is
+        '코드명';
-        '수정자 ID';
+
-
+    comment on column st_common_code.description is
-    create table st_file (
+        '설명';
-        use_flag boolean not null,
+
-        created_at timestamp(6) not null,
+    comment on column st_common_code.created_id is
-        created_oid bigint,
+        '생성자 ID';
-        file_size bigint not null,
+
-        group_oid bigint,
+    comment on column st_common_code.updated_id is
-        oid bigint not null,
+        '수정자 ID';
-        updated_at timestamp(6) not null,
+
-        updated_oid bigint,
+    create table st_common_group_code (
-        content_type varchar(255) not null,
+        sort_order integer not null,
-        created_id varchar(255),
+        use_flag boolean not null,
-        description varchar(255),
+        created_at timestamp(6) not null,
-        file_path varchar(255) not null,
+        created_oid bigint,
-        original_file_name varchar(255) not null,
+        oid bigint not null,
-        stored_file_name varchar(255) not null,
+        updated_at timestamp(6) not null,
-        updated_id varchar(255),
+        updated_oid bigint,
-        primary key (oid)
+        code varchar(50) not null unique,
-    );
+        character_ref1_title varchar(100),
-
+        character_ref2_title varchar(100),
-    comment on column st_file.use_flag is
+        character_ref3_title varchar(100),
-        '사용 여부';
+        character_ref4_title varchar(100),
-
+        character_ref5_title varchar(100),
-    comment on column st_file.created_at is
+        name varchar(100) not null,
-        '생성일시';
+        created_id varchar(255),
-
+        updated_id varchar(255),
-    comment on column st_file.created_oid is
+        primary key (oid)
-        '생성자 OID';
+    );
-
+
-    comment on column st_file.file_size is
+    comment on column st_common_group_code.sort_order is
-        '파일 크기';
+        '정렬 순번';
-
+
-    comment on column st_file.group_oid is
+    comment on column st_common_group_code.use_flag is
-        '그룹 OID';
+        '사용 여부';
-
+
-    comment on column st_file.oid is
+    comment on column st_common_group_code.created_at is
-        'OID';
+        '생성일시';
-
+
-    comment on column st_file.updated_at is
+    comment on column st_common_group_code.created_oid is
-        '수정일시';
+        '생성자 OID';
-
+
-    comment on column st_file.updated_oid is
+    comment on column st_common_group_code.oid is
-        '수정자 OID';
+        'OID';
-
+
-    comment on column st_file.content_type is
+    comment on column st_common_group_code.updated_at is
-        '콘텐츠 타입';
+        '수정일시';
-
+
-    comment on column st_file.created_id is
+    comment on column st_common_group_code.updated_oid is
-        '생성자 ID';
+        '수정자 OID';
-
+
-    comment on column st_file.description is
+    comment on column st_common_group_code.code is
-        '설명';
+        '코드';
-
+
-    comment on column st_file.file_path is
+    comment on column st_common_group_code.character_ref1_title is
-        '파일 경로';
+        '문자 참조 타이틀1';
-
+
-    comment on column st_file.original_file_name is
+    comment on column st_common_group_code.character_ref2_title is
-        '원본 파일명';
+        '문자 참조 타이틀2';
-
+
-    comment on column st_file.stored_file_name is
+    comment on column st_common_group_code.character_ref3_title is
-        '저장 파일명';
+        '문자 참조 타이틀3';
-
+
-    comment on column st_file.updated_id is
+    comment on column st_common_group_code.character_ref4_title is
-        '수정자 ID';
+        '문자 참조 타이틀4';
-
+
-    create table st_member (
+    comment on column st_common_group_code.character_ref5_title is
-        use_flag boolean not null,
+        '문자 참조 타이틀5';
-        created_at timestamp(6) not null,
+
-        created_oid bigint,
+    comment on column st_common_group_code.name is
-        last_login_at timestamp(6),
+        '코드명';
-        oid bigint not null,
+
-        updated_at timestamp(6) not null,
+    comment on column st_common_group_code.created_id is
-        updated_oid bigint,
+        '생성자 ID';
-        login_ip varchar(45),
+
-        name varchar(100) not null,
+    comment on column st_common_group_code.updated_id is
-        password varchar(100) not null,
+        '수정자 ID';
-        user_id varchar(100) not null,
+
-        refresh_token varchar(1024),
+    create table st_file (
-        created_id varchar(255),
+        use_flag boolean not null,
-        email varchar(255) not null,
+        created_at timestamp(6) not null,
-        updated_id varchar(255),
+        created_oid bigint,
-        primary key (oid)
+        file_size bigint not null,
-    );
+        group_oid bigint,
-
+        oid bigint not null,
-    comment on column st_member.use_flag is
+        updated_at timestamp(6) not null,
-        '사용 여부';
+        updated_oid bigint,
-
+        content_type varchar(255) not null,
-    comment on column st_member.created_at is
+        created_id varchar(255),
-        '생성일시';
+        description varchar(255),
-
+        file_path varchar(255) not null,
-    comment on column st_member.created_oid is
+        original_file_name varchar(255) not null,
-        '생성자 OID';
+        stored_file_name varchar(255) not null,
-
+        updated_id varchar(255),
-    comment on column st_member.last_login_at is
+        primary key (oid)
-        '마지막 로그인 일시';
+    );
-
+
-    comment on column st_member.oid is
+    comment on column st_file.use_flag is
-        'OID';
+        '사용 여부';
-
+
-    comment on column st_member.updated_at is
+    comment on column st_file.created_at is
-        '수정일시';
+        '생성일시';
-
+
-    comment on column st_member.updated_oid is
+    comment on column st_file.created_oid is
-        '수정자 OID';
+        '생성자 OID';
-
+
-    comment on column st_member.login_ip is
+    comment on column st_file.file_size is
-        '로그인 IP';
+        '파일 크기';
-
+
-    comment on column st_member.name is
+    comment on column st_file.group_oid is
-        '이름';
+        '그룹 OID';
-
+
-    comment on column st_member.password is
+    comment on column st_file.oid is
-        '비밀번호';
+        'OID';
-
+
-    comment on column st_member.user_id is
+    comment on column st_file.updated_at is
-        '사용자 ID';
+        '수정일시';
-
+
-    comment on column st_member.refresh_token is
+    comment on column st_file.updated_oid is
-        '리프레시 토큰';
+        '수정자 OID';
-
+
-    comment on column st_member.created_id is
+    comment on column st_file.content_type is
-        '생성자 ID';
+        '콘텐츠 타입';
-
+
-    comment on column st_member.email is
+    comment on column st_file.created_id is
-        '이메일';
+        '생성자 ID';
-
+
-    comment on column st_member.updated_id is
+    comment on column st_file.description is
-        '수정자 ID';
+        '설명';
-
+
-    create index idx_common_code_code 
+    comment on column st_file.file_path is
-       on st_common_code (code);
+        '파일 경로';
-
+
-    create index idx_common_code_group_code 
+    comment on column st_file.original_file_name is
-       on st_common_code (group_code);
+        '원본 파일명';
-
+
-    create index idx_common_code_parent_code 
+    comment on column st_file.stored_file_name is
-       on st_common_code (parent_code);
+        '저장 파일명';
-
+
-    create index idx_common_group_code_code 
+    comment on column st_file.updated_id is
-       on st_common_group_code (code);
+        '수정자 ID';
-
+
-    create index idx_member_user_id 
+    create table st_member (
-       on st_member (user_id);
+        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 table st_member_auth_group (
+        auth_group_oid bigint,
+        created_at timestamp(6) not null,
+        created_oid bigint,
+        member_oid bigint,
+        oid bigint not null,
+        updated_at timestamp(6) not null,
+        updated_oid bigint,
+        created_id varchar(255),
+        updated_id varchar(255),
+        primary key (oid)
+    );
+
+    comment on column st_member_auth_group.auth_group_oid is
+        '권한 그룹 OID';
+
+    comment on column st_member_auth_group.created_at is
+        '생성일시';
+
+    comment on column st_member_auth_group.created_oid is
+        '생성자 OID';
+
+    comment on column st_member_auth_group.member_oid is
+        '사용자 OID';
+
+    comment on column st_member_auth_group.oid is
+        'OID';
+
+    comment on column st_member_auth_group.updated_at is
+        '수정일시';
+
+    comment on column st_member_auth_group.updated_oid is
+        '수정자 OID';
+
+    comment on column st_member_auth_group.created_id is
+        '생성자 ID';
+
+    comment on column st_member_auth_group.updated_id is
+        '수정자 ID';
+
+    create table st_resource (
+        menu_yn boolean,
+        sort_order integer,
+        created_at timestamp(6) not null,
+        created_oid bigint,
+        oid bigint not null,
+        parent_code bigint,
+        updated_at timestamp(6) not null,
+        updated_oid bigint,
+        type varchar(50),
+        code varchar(100),
+        name varchar(100),
+        path varchar(100),
+        created_id varchar(255),
+        description varchar(255),
+        updated_id varchar(255),
+        primary key (oid)
+    );
+
+    comment on column st_resource.menu_yn is
+        '메뉴여부';
+
+    comment on column st_resource.sort_order is
+        '정렬 순서';
+
+    comment on column st_resource.created_at is
+        '생성일시';
+
+    comment on column st_resource.created_oid is
+        '생성자 OID';
+
+    comment on column st_resource.oid is
+        'OID';
+
+    comment on column st_resource.parent_code is
+        '부모 코드';
+
+    comment on column st_resource.updated_at is
+        '수정일시';
+
+    comment on column st_resource.updated_oid is
+        '수정자 OID';
+
+    comment on column st_resource.type is
+        '리소스 유형(메뉴, 페이지, 컴포넌트)';
+
+    comment on column st_resource.code is
+        '코드';
+
+    comment on column st_resource.name is
+        '리소스명';
+
+    comment on column st_resource.path is
+        '주소';
+
+    comment on column st_resource.created_id is
+        '생성자 ID';
+
+    comment on column st_resource.description is
+        '설명';
+
+    comment on column st_resource.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);
+
+    alter table if exists st_auth_group_resource 
+       add constraint FKqw6aih072qipjh1r88f0dbfd6 
+       foreign key (auth_group_oid) 
+       references st_auth_group;
+
+    alter table if exists st_auth_group_resource 
+       add constraint FKrvq0ta0bwef2kt6ahklo7f3k4 
+       foreign key (resource_oid) 
+       references st_resource;
+
+    alter table if exists st_member_auth_group 
+       add constraint FKob027cxsjfyvewjb8xp6hjkbm 
+       foreign key (auth_group_oid) 
+       references st_auth_group;
+
+    alter table if exists st_member_auth_group 
+       add constraint FKqew1t81hap15dmn78p8xhunhj 
+       foreign key (member_oid) 
+       references st_member;

gradle/wrapper/gradle-wrapper.properties

@@ -1,6 +1,6 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.14.3-bin.zip
+distributionUrl=http\://services.gradle.org/distributions/gradle-8.14.3-bin.zip
 networkTimeout=10000
 validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME

nginx-1.28.0/conf/nginx_docker_bak.conf

@@ -0,0 +1,51 @@
+
+events {
+    worker_connections 1024;
+}
+
+http {
+
+    include mime.types;
+    default_type application/octet-stream;
+    sendfile on;
+    keepalive_timeout 65;
+
+    # (선택) 로그 위치
+    access_log /var/log/nginx/access.log;
+    error_log  /var/log/nginx/error.log warn;
+
+    # 웹소켓용
+    map $http_upgrade $connection_upgrade {
+        default upgrade;
+        ''      close;
+    }
+
+    server {
+        listen 80;
+        server_name localhost;
+
+        # Nuxt(개발서버 3000)
+        location / {
+            proxy_pass http://frontend:3000;
+            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_http_version 1.1;
+            proxy_set_header X-Forwarded-Proto $scheme;
+            proxy_set_header Upgrade $http_upgrade;
+            proxy_set_header Connection $connection_upgrade;
+        }
+
+        # Spring Boot(8080)
+        location /service/ {
+            proxy_pass http://backend:8080;
+            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;
+        }
+
+        # (선택) 업로드 크게 받을 때
+        # client_max_body_size 50m;
+    }
+}

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

@@ -38,8 +38,8 @@ public class CommonCodeController {
     @Operation(summary = "그룹 코드 생성", description = "새로운 그룹 코드를 생성합니다.")
     @ApiResponses({
         @ApiResponse(responseCode = "201", description = "그룹 코드 생성 성공"),
-        @ApiResponse(responseCode = "400", description = "잘못된 요청 데이터", content = @Content(schema = @Schema(implementation = ApiResponseDto.class))),
+        @ApiResponse(responseCode = "400", description = "잘못된 요청 데이터", content = @Content),
-        @ApiResponse(responseCode = "409", description = "중복된 그룹 코드", content = @Content(schema = @Schema(implementation = ApiResponseDto.class)))
+        @ApiResponse(responseCode = "409", description = "중복된 그룹 코드", content = @Content)
     })
     @PostMapping("/group")
     public ResponseEntity<ApiResponseDto<CreateCommonGroupCodeResponseDto>> createGroupCode(@RequestBody @Valid CreateCommonGroupCodeRequestDto requestDto) {
@@ -55,8 +55,8 @@ public class CommonCodeController {
     @Operation(summary = "그룹 코드 수정", description = "기존 그룹 코드를 수정합니다.")
     @ApiResponses({
         @ApiResponse(responseCode = "200", description = "그룹 코드 수정 성공"),
-        @ApiResponse(responseCode = "400", description = "잘못된 요청 데이터", content = @Content(schema = @Schema(implementation = ApiResponseDto.class))),
+        @ApiResponse(responseCode = "400", description = "잘못된 요청 데이터", content = @Content),
-        @ApiResponse(responseCode = "404", description = "그룹 코드를 찾을 수 없음", content = @Content(schema = @Schema(implementation = ApiResponseDto.class)))
+        @ApiResponse(responseCode = "404", description = "그룹 코드를 찾을 수 없음", content = @Content)
     })
     @PutMapping("/group/{code}")
     public ResponseEntity<ApiResponseDto<String>> updateGroupCode(
@@ -71,8 +71,8 @@ public class CommonCodeController {
     @Operation(summary = "그룹 코드 삭제", description = "그룹 코드를 삭제합니다.")
     @ApiResponses({
         @ApiResponse(responseCode = "200", description = "그룹 코드 삭제 성공"),
-        @ApiResponse(responseCode = "400", description = "하위 공통 코드가 존재하여 삭제할 수 없음", content = @Content(schema = @Schema(implementation = ApiResponseDto.class))),
+        @ApiResponse(responseCode = "400", description = "하위 공통 코드가 존재하여 삭제할 수 없음", content = @Content),
-        @ApiResponse(responseCode = "404", description = "그룹 코드를 찾을 수 없음", content = @Content(schema = @Schema(implementation = ApiResponseDto.class)))
+        @ApiResponse(responseCode = "404", description = "그룹 코드를 찾을 수 없음", content = @Content)
     })
     @DeleteMapping("/group/{code}")
     public ResponseEntity<ApiResponseDto<Void>> deleteGroupCode(@PathVariable String code) {
@@ -84,7 +84,7 @@ public class CommonCodeController {
     @Operation(summary = "그룹 코드 조회", description = "특정 그룹 코드를 조회합니다.")
     @ApiResponses({
         @ApiResponse(responseCode = "200", description = "그룹 코드 조회 성공"),
-        @ApiResponse(responseCode = "404", description = "그룹 코드를 찾을 수 없음", content = @Content(schema = @Schema(implementation = ApiResponseDto.class)))
+        @ApiResponse(responseCode = "404", description = "그룹 코드를 찾을 수 없음", content = @Content)
     })
     @GetMapping("/group/{code}")
     public ResponseEntity<ApiResponseDto<CommonGroupCodeDto>> getGroupCode(@PathVariable String code) {
@@ -119,8 +119,8 @@ public class CommonCodeController {
     @Operation(summary = "공통 코드 생성", description = "새로운 공통 코드를 생성합니다.")
     @ApiResponses({
         @ApiResponse(responseCode = "201", description = "공통 코드 생성 성공"),
-        @ApiResponse(responseCode = "400", description = "잘못된 요청 데이터", content = @Content(schema = @Schema(implementation = ApiResponseDto.class))),
+        @ApiResponse(responseCode = "400", description = "잘못된 요청 데이터", content = @Content),
-        @ApiResponse(responseCode = "409", description = "중복된 공통 코드", content = @Content(schema = @Schema(implementation = ApiResponseDto.class)))
+        @ApiResponse(responseCode = "409", description = "중복된 공통 코드", content = @Content)
     })
     @PostMapping
     public ResponseEntity<ApiResponseDto<CreateCommonCodeResponseDto>> createCode(@RequestBody @Valid CreateCommonCodeRequestDto requestDto) {
@@ -136,8 +136,8 @@ public class CommonCodeController {
     @Operation(summary = "공통 코드 수정", description = "기존 공통 코드를 수정합니다.")
     @ApiResponses({
         @ApiResponse(responseCode = "200", description = "공통 코드 수정 성공"),
-        @ApiResponse(responseCode = "400", description = "잘못된 요청 데이터", content = @Content(schema = @Schema(implementation = ApiResponseDto.class))),
+        @ApiResponse(responseCode = "400", description = "잘못된 요청 데이터", content = @Content),
-        @ApiResponse(responseCode = "404", description = "공통 코드를 찾을 수 없음", content = @Content(schema = @Schema(implementation = ApiResponseDto.class)))
+        @ApiResponse(responseCode = "404", description = "공통 코드를 찾을 수 없음", content = @Content)
     })
     @PutMapping("/{code}")
     public ResponseEntity<ApiResponseDto<String>> updateCode(
@@ -152,8 +152,8 @@ public class CommonCodeController {
     @Operation(summary = "공통 코드 삭제", description = "공통 코드를 삭제합니다.")
     @ApiResponses({
         @ApiResponse(responseCode = "200", description = "공통 코드 삭제 성공"),
-        @ApiResponse(responseCode = "400", description = "하위 공통 코드가 존재하여 삭제할 수 없음", content = @Content(schema = @Schema(implementation = ApiResponseDto.class))),
+        @ApiResponse(responseCode = "400", description = "하위 공통 코드가 존재하여 삭제할 수 없음", content = @Content),
-        @ApiResponse(responseCode = "404", description = "공통 코드를 찾을 수 없음", content = @Content(schema = @Schema(implementation = ApiResponseDto.class)))
+        @ApiResponse(responseCode = "404", description = "공통 코드를 찾을 수 없음", content = @Content)
     })
     @DeleteMapping("/{code}")
     public ResponseEntity<ApiResponseDto<Void>> deleteCode(@PathVariable String code) {
@@ -165,7 +165,7 @@ public class CommonCodeController {
     @Operation(summary = "공통 코드 조회", description = "특정 공통 코드를 조회합니다.")
     @ApiResponses({
         @ApiResponse(responseCode = "200", description = "공통 코드 조회 성공"),
-        @ApiResponse(responseCode = "404", description = "공통 코드를 찾을 수 없음", content = @Content(schema = @Schema(implementation = ApiResponseDto.class)))
+        @ApiResponse(responseCode = "404", description = "공통 코드를 찾을 수 없음", content = @Content)
     })
     @GetMapping("/{code}")
     public ResponseEntity<ApiResponseDto<GetCommonCodeResponseDto>> getCode(@PathVariable String code) {

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

@@ -14,10 +14,6 @@ import org.springframework.stereotype.Repository;
 import java.util.List;
 import java.util.Optional;
 
-/**
- * QueryDSL을 활용하여 CommonCodeRepositoryCustom 인터페이스를 구현하는 클래스
- * 복잡한 쿼리나 동적 쿼리를 QueryDSL로 작성하여 성능과 가독성을 향상시킵니다.
- */
 @Repository
 @RequiredArgsConstructor
 public class CommonCodeRepositoryImpl implements CommonCodeRepositoryCustom {
@@ -25,10 +21,6 @@ public class CommonCodeRepositoryImpl implements CommonCodeRepositoryCustom {
     private final JPAQueryFactory queryFactory;
     private final EntityManager entityManager;
 
-    /**
-     * Q클래스 인스턴스들을 생성하여 쿼리에서 사용합니다.
-     * QueryDSL의 Q클래스를 통해 타입 안전한 쿼리 작성이 가능합니다.
-     */
     private final QCommonCode commonCode = QCommonCode.commonCode;
     private final QCommonGroupCode commonGroupCode = QCommonGroupCode.commonGroupCode;
     private final QMember member = QMember.member;

src/main/java/com/bio/bio_backend/domain/base/authgroup/controller/AuthGroupController.java

@@ -0,0 +1,45 @@
+package com.bio.bio_backend.domain.base.authgroup.controller;
+
+import com.bio.bio_backend.domain.base.authgroup.dto.AuthGroupDto;
+import com.bio.bio_backend.domain.base.authgroup.service.AuthGroupService;
+import lombok.RequiredArgsConstructor;
+import org.springframework.web.bind.annotation.*;
+import lombok.extern.slf4j.Slf4j;
+import io.swagger.v3.oas.annotations.tags.Tag;
+
+import java.util.List;
+
+@RestController
+@RequestMapping("/auth_group")
+@RequiredArgsConstructor
+@Tag(name = "AuthGroup", description = "")
+@Slf4j
+public class AuthGroupController {
+
+    private final AuthGroupService authGroupService;
+
+    @PostMapping("/create")
+    public AuthGroupDto create(@RequestBody AuthGroupDto authGroupDto) {
+        return authGroupService.create(authGroupDto);
+    }
+
+    @GetMapping("/{id}")
+    public AuthGroupDto getById(@PathVariable Long id) {
+        return authGroupService.getById(id);
+    }
+
+    @GetMapping
+    public List<AuthGroupDto> getAll() {
+        return authGroupService.getAll();
+    }
+
+    @PutMapping("/{id}")
+    public AuthGroupDto update(@PathVariable Long id, @RequestBody AuthGroupDto dto) {
+        return authGroupService.update(id, dto);
+    }
+
+    @DeleteMapping("/{id}")
+    public void delete(@PathVariable Long id) {
+        authGroupService.delete(id);
+    }
+}

src/main/java/com/bio/bio_backend/domain/base/authgroup/dto/AuthGroupDto.java

@@ -0,0 +1,14 @@
+package com.bio.bio_backend.domain.base.authgroup.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class AuthGroupDto {
+    private String name;
+}

src/main/java/com/bio/bio_backend/domain/base/authgroup/entity/AuthGroup.java

@@ -0,0 +1,27 @@
+package com.bio.bio_backend.domain.base.authgroup.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 + "auth_group")
+public class AuthGroup extends BaseEntity {
+
+    @Column(name = "name", length = 100)
+    @Comment("권한 그룹명")
+    private String name;
+}

src/main/java/com/bio/bio_backend/domain/base/authgroup/mapper/AuthGroupMapper.java

@@ -0,0 +1,13 @@
+package com.bio.bio_backend.domain.base.authgroup.mapper;
+
+import com.bio.bio_backend.global.config.GlobalMapperConfig;
+import com.bio.bio_backend.domain.base.authgroup.entity.AuthGroup;
+import com.bio.bio_backend.domain.base.authgroup.dto.AuthGroupDto;
+import org.mapstruct.Mapper;
+
+@Mapper(config = GlobalMapperConfig.class)
+public interface AuthGroupMapper {
+    AuthGroup toEntity(AuthGroupDto dto);
+
+    AuthGroupDto toDto(AuthGroup entity);
+}

src/main/java/com/bio/bio_backend/domain/base/authgroup/repository/AuthGroupRepository.java

@@ -0,0 +1,9 @@
+package com.bio.bio_backend.domain.base.authgroup.repository;
+
+import com.bio.bio_backend.domain.base.authgroup.entity.AuthGroup;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+@Repository
+public interface AuthGroupRepository extends JpaRepository<AuthGroup, Long>, AuthGroupRepositoryCustom {
+}

src/main/java/com/bio/bio_backend/domain/base/authgroup/repository/AuthGroupRepositoryCustom.java

@@ -0,0 +1,12 @@
+package com.bio.bio_backend.domain.base.authgroup.repository;
+
+import com.bio.bio_backend.domain.base.authgroup.entity.AuthGroup;
+import java.util.Optional;
+
+/**
+ * QueryDSL을 활용한 커스텀 쿼리 메서드들을 정의하는 인터페이스
+ * 복잡한 쿼리나 동적 쿼리가 필요한 경우 이 인터페이스를 구현하여 사용합니다.
+ */
+public interface AuthGroupRepositoryCustom {
+
+}

src/main/java/com/bio/bio_backend/domain/base/authgroup/repository/AuthGroupRepositoryImpl.java

@@ -0,0 +1,26 @@
+package com.bio.bio_backend.domain.base.authgroup.repository;
+
+import com.bio.bio_backend.domain.base.authgroup.entity.AuthGroup;
+import com.bio.bio_backend.domain.base.authgroup.entity.QAuthGroup;
+import com.querydsl.jpa.impl.JPAQueryFactory;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Repository;
+
+import java.util.Optional;
+
+/**
+ * QueryDSL을 활용하여 AuthGroupRepositoryCustom 인터페이스를 구현하는 클래스
+ * 복잡한 쿼리나 동적 쿼리를 QueryDSL로 작성하여 성능과 가독성을 향상시킵니다.
+ */
+@Repository
+@RequiredArgsConstructor
+public class AuthGroupRepositoryImpl implements AuthGroupRepositoryCustom {
+
+    private final JPAQueryFactory queryFactory;
+
+    /**
+     * QAuthGroup 인스턴스를 생성하여 쿼리에서 사용합니다.
+     * QueryDSL의 Q클래스를 통해 타입 안전한 쿼리 작성이 가능합니다.
+     */
+    private final QAuthGroup authGroup = QAuthGroup.authGroup;
+}

src/main/java/com/bio/bio_backend/domain/base/authgroup/service/AuthGroupService.java

@@ -0,0 +1,16 @@
+package com.bio.bio_backend.domain.base.authgroup.service;
+
+import com.bio.bio_backend.domain.base.authgroup.dto.AuthGroupDto;
+import java.util.List;
+
+public interface AuthGroupService {
+    AuthGroupDto create(AuthGroupDto dto);
+
+    AuthGroupDto getById(Long id);
+
+    List<AuthGroupDto> getAll();
+
+    AuthGroupDto update(Long id, AuthGroupDto dto);
+
+    void delete(Long id);
+}

src/main/java/com/bio/bio_backend/domain/base/authgroup/service/AuthGroupServiceImpl.java

@@ -0,0 +1,54 @@
+package com.bio.bio_backend.domain.base.authgroup.service;
+
+import com.bio.bio_backend.domain.base.authgroup.dto.AuthGroupDto;
+import com.bio.bio_backend.domain.base.authgroup.entity.AuthGroup;
+import com.bio.bio_backend.domain.base.authgroup.repository.AuthGroupRepository;
+import com.bio.bio_backend.domain.base.authgroup.mapper.AuthGroupMapper;
+import org.springframework.stereotype.Service;
+import lombok.RequiredArgsConstructor;
+
+import java.util.List;
+import java.util.stream.Collectors;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.transaction.annotation.Transactional;
+
+@Service
+@RequiredArgsConstructor
+@Slf4j
+@Transactional(readOnly = true)
+public class AuthGroupServiceImpl implements AuthGroupService {
+
+    private final AuthGroupRepository repository;
+    private final AuthGroupMapper mapper;
+
+    @Override
+    @Transactional
+    public AuthGroupDto create(AuthGroupDto dto) {
+        AuthGroup entity = mapper.toEntity(dto);
+        return mapper.toDto(repository.save(entity));
+    }
+
+    @Override
+    public AuthGroupDto getById(Long id) {
+        return repository.findById(id).map(mapper::toDto).orElse(null);
+    }
+
+    @Override
+    public List<AuthGroupDto> getAll() {
+        return repository.findAll().stream().map(mapper::toDto).collect(Collectors.toList());
+    }
+
+    @Override
+    @Transactional
+    public AuthGroupDto update(Long id, AuthGroupDto dto) {
+        AuthGroup entity = repository.findById(id).orElseThrow();
+        // TODO: update fields
+        return mapper.toDto(repository.save(entity));
+    }
+
+    @Override
+    @Transactional
+    public void delete(Long id) {
+        repository.deleteById(id);
+    }
+}

src/main/java/com/bio/bio_backend/domain/base/authgroupresource/controller/AuthGroupResourceController.java

@@ -0,0 +1,51 @@
+package com.bio.bio_backend.domain.base.authgroupresource.controller;
+
+import com.bio.bio_backend.domain.base.authgroupresource.dto.AuthGroupResourceDto;
+import com.bio.bio_backend.domain.base.authgroupresource.dto.ReplaceAuthGroupResourcesRequest;
+import com.bio.bio_backend.domain.base.authgroupresource.service.AuthGroupResourceService;
+import lombok.RequiredArgsConstructor;
+import org.springframework.web.bind.annotation.*;
+import lombok.extern.slf4j.Slf4j;
+import io.swagger.v3.oas.annotations.tags.Tag;
+
+import java.util.List;
+
+@RestController
+@RequestMapping("/auth_group_resource")
+@RequiredArgsConstructor
+@Tag(name = "AuthGroupResource", description = "")
+@Slf4j
+public class AuthGroupResourceController {
+
+    private final AuthGroupResourceService service;
+
+    @PostMapping("/create")
+    public AuthGroupResourceDto create(@RequestBody AuthGroupResourceDto dto) {
+        return service.create(dto);
+    }
+
+    @GetMapping("/{id}")
+    public AuthGroupResourceDto getById(@PathVariable Long id) {
+        return service.getById(id);
+    }
+
+    @GetMapping
+    public List<AuthGroupResourceDto> getAll() {
+        return service.getAll();
+    }
+
+    @PutMapping("/{id}")
+    public AuthGroupResourceDto update(@PathVariable Long id, @RequestBody AuthGroupResourceDto dto) {
+        return service.update(id, dto);
+    }
+
+    @DeleteMapping("/{id}")
+    public void delete(@PathVariable Long id) {
+        service.delete(id);
+    }
+
+    @PostMapping("/replace")
+    public void replaceAuthGroupResources(@RequestBody ReplaceAuthGroupResourcesRequest request) {
+        service.replaceAuthGroupResources(request.getAuthGroupOid(), request.getResourceOids());
+    }
+}

src/main/java/com/bio/bio_backend/domain/base/authgroupresource/dto/AuthGroupResourceDto.java

@@ -0,0 +1,18 @@
+package com.bio.bio_backend.domain.base.authgroupresource.dto;
+
+import com.bio.bio_backend.domain.base.authgroup.entity.AuthGroup;
+import com.bio.bio_backend.domain.base.resource.entity.Resource;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class AuthGroupResourceDto {
+    private AuthGroup authGroupOid;
+    private Resource resourceOid;
+}

src/main/java/com/bio/bio_backend/domain/base/authgroupresource/dto/ReplaceAuthGroupResourcesRequest.java

@@ -0,0 +1,12 @@
+package com.bio.bio_backend.domain.base.authgroupresource.dto;
+
+import java.util.List;
+
+import lombok.Data;
+
+@Data
+public class ReplaceAuthGroupResourcesRequest {
+    private Long authGroupOid;
+    private List<Long> resourceOids;
+}
+

src/main/java/com/bio/bio_backend/domain/base/authgroupresource/entity/AuthGroupResource.java

@@ -0,0 +1,36 @@
+package com.bio.bio_backend.domain.base.authgroupresource.entity;
+
+import com.bio.bio_backend.domain.base.authgroup.entity.AuthGroup;
+import com.bio.bio_backend.domain.base.resource.entity.Resource;
+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 + "auth_group_resource")
+
+public class AuthGroupResource extends BaseEntity {
+
+    @JoinColumn(name = "auth_group_oid")
+    @ManyToOne(fetch = FetchType.LAZY)
+    @Comment("권한 그룹 OID")
+    private AuthGroup authGroupOid;
+
+    @JoinColumn(name = "resource_oid")
+    @ManyToOne(fetch = FetchType.LAZY)
+    @Comment("리소스 OID")
+    private Resource resourceOid;
+}

src/main/java/com/bio/bio_backend/domain/base/authgroupresource/mapper/AuthGroupResourceMapper.java

@@ -0,0 +1,13 @@
+package com.bio.bio_backend.domain.base.authgroupresource.mapper;
+
+import com.bio.bio_backend.global.config.GlobalMapperConfig;
+import com.bio.bio_backend.domain.base.authgroupresource.entity.AuthGroupResource;
+import com.bio.bio_backend.domain.base.authgroupresource.dto.AuthGroupResourceDto;
+import org.mapstruct.Mapper;
+
+@Mapper(config = GlobalMapperConfig.class)
+public interface AuthGroupResourceMapper {
+    AuthGroupResource toEntity(AuthGroupResourceDto dto);
+
+    AuthGroupResourceDto toDto(AuthGroupResource entity);
+}

src/main/java/com/bio/bio_backend/domain/base/authgroupresource/repository/AuthGroupResourceRepository.java

@@ -0,0 +1,17 @@
+package com.bio.bio_backend.domain.base.authgroupresource.repository;
+
+import com.bio.bio_backend.domain.base.authgroupresource.entity.AuthGroupResource;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.data.jpa.repository.Modifying;
+import org.springframework.data.jpa.repository.Query;
+import org.springframework.data.repository.query.Param;
+import org.springframework.stereotype.Repository;
+
+@Repository
+public interface AuthGroupResourceRepository
+                extends JpaRepository<AuthGroupResource, Long>, AuthGroupResourceRepositoryCustom {
+
+        @Modifying
+        @Query("delete from AuthGroupResource agr where agr.authGroupOid.oid = :authGroupOid")
+        void deleteByAuthGroupOid(@Param("authGroupOid") Long authGroupOid);
+}

src/main/java/com/bio/bio_backend/domain/base/authgroupresource/repository/AuthGroupResourceRepositoryCustom.java

@@ -0,0 +1,12 @@
+package com.bio.bio_backend.domain.base.authgroupresource.repository;
+
+import com.bio.bio_backend.domain.base.authgroupresource.entity.AuthGroupResource;
+import java.util.Optional;
+
+/**
+ * QueryDSL을 활용한 커스텀 쿼리 메서드들을 정의하는 인터페이스
+ * 복잡한 쿼리나 동적 쿼리가 필요한 경우 이 인터페이스를 구현하여 사용합니다.
+ */
+public interface AuthGroupResourceRepositoryCustom {
+
+}

src/main/java/com/bio/bio_backend/domain/base/authgroupresource/repository/AuthGroupResourceRepositoryImpl.java

@@ -0,0 +1,26 @@
+package com.bio.bio_backend.domain.base.authgroupresource.repository;
+
+import com.bio.bio_backend.domain.base.authgroupresource.entity.AuthGroupResource;
+import com.bio.bio_backend.domain.base.authgroupresource.entity.QAuthGroupResource;
+import com.querydsl.jpa.impl.JPAQueryFactory;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Repository;
+
+import java.util.Optional;
+
+/**
+ * QueryDSL을 활용하여 AuthGroupResourceRepositoryCustom 인터페이스를 구현하는 클래스
+ * 복잡한 쿼리나 동적 쿼리를 QueryDSL로 작성하여 성능과 가독성을 향상시킵니다.
+ */
+@Repository
+@RequiredArgsConstructor
+public class AuthGroupResourceRepositoryImpl implements AuthGroupResourceRepositoryCustom {
+
+    private final JPAQueryFactory queryFactory;
+
+    /**
+     * QAuthGroupResource 인스턴스를 생성하여 쿼리에서 사용합니다.
+     * QueryDSL의 Q클래스를 통해 타입 안전한 쿼리 작성이 가능합니다.
+     */
+    private final QAuthGroupResource authGroupResource = QAuthGroupResource.authGroupResource;
+}

src/main/java/com/bio/bio_backend/domain/base/authgroupresource/service/AuthGroupResourceService.java

@@ -0,0 +1,21 @@
+package com.bio.bio_backend.domain.base.authgroupresource.service;
+
+import com.bio.bio_backend.domain.base.authgroupresource.dto.AuthGroupResourceDto;
+import java.util.List;
+
+public interface AuthGroupResourceService {
+    AuthGroupResourceDto create(AuthGroupResourceDto dto);
+
+    AuthGroupResourceDto getById(Long id);
+
+    List<AuthGroupResourceDto> getAll();
+
+    AuthGroupResourceDto update(Long id, AuthGroupResourceDto dto);
+
+    void delete(Long id);
+
+    /**
+     * 특정 authGroupOid의 기존 매핑을 모두 삭제하고, 전달된 resourceOid 목록으로 재등록
+     */
+    void replaceAuthGroupResources(Long authGroupOid, List<Long> resourceOids);
+}

src/main/java/com/bio/bio_backend/domain/base/authgroupresource/service/AuthGroupResourceServiceImpl.java

@@ -0,0 +1,80 @@
+package com.bio.bio_backend.domain.base.authgroupresource.service;
+
+import com.bio.bio_backend.domain.base.authgroupresource.dto.AuthGroupResourceDto;
+import com.bio.bio_backend.domain.base.authgroupresource.entity.AuthGroupResource;
+import com.bio.bio_backend.domain.base.authgroupresource.repository.AuthGroupResourceRepository;
+import com.bio.bio_backend.domain.base.authgroupresource.mapper.AuthGroupResourceMapper;
+import org.springframework.stereotype.Service;
+import lombok.RequiredArgsConstructor;
+
+import java.util.List;
+import java.util.stream.Collectors;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.transaction.annotation.Transactional;
+import com.bio.bio_backend.domain.base.authgroup.entity.AuthGroup;
+import com.bio.bio_backend.domain.base.resource.entity.Resource;
+
+@Service
+@RequiredArgsConstructor
+@Slf4j
+@Transactional(readOnly = true)
+public class AuthGroupResourceServiceImpl implements AuthGroupResourceService {
+
+    private final AuthGroupResourceRepository repository;
+    private final AuthGroupResourceMapper mapper;
+
+    @Override
+    @Transactional
+    public AuthGroupResourceDto create(AuthGroupResourceDto dto) {
+        AuthGroupResource entity = mapper.toEntity(dto);
+        return mapper.toDto(repository.save(entity));
+    }
+
+    @Override
+    public AuthGroupResourceDto getById(Long id) {
+        return repository.findById(id).map(mapper::toDto).orElse(null);
+    }
+
+    @Override
+    public List<AuthGroupResourceDto> getAll() {
+        return repository.findAll().stream().map(mapper::toDto).collect(Collectors.toList());
+    }
+
+    @Override
+    @Transactional
+    public AuthGroupResourceDto update(Long id, AuthGroupResourceDto dto) {
+        AuthGroupResource entity = repository.findById(id).orElseThrow();
+        // TODO: update fields
+        return mapper.toDto(repository.save(entity));
+    }
+
+    @Override
+    @Transactional
+    public void delete(Long id) {
+        repository.deleteById(id);
+    }
+
+    @Override
+    @Transactional
+    public void replaceAuthGroupResources(Long authGroupOid, List<Long> resourceOids) {
+        repository.deleteByAuthGroupOid(authGroupOid);
+
+        if (resourceOids == null || resourceOids.isEmpty()) {
+            return;
+        }
+
+        AuthGroup groupRef = new AuthGroup();
+        groupRef.setOid(authGroupOid);
+
+        for (Long resourceOid : resourceOids) {
+            Resource resourceRef = new Resource();
+            resourceRef.setOid(resourceOid);
+
+            AuthGroupResource entity = AuthGroupResource.builder()
+                    .authGroupOid(groupRef)
+                    .resourceOid(resourceRef)
+                    .build();
+            repository.save(entity);
+        }
+    }
+}

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

@@ -37,8 +37,8 @@ public class FileController {
     @Operation(summary = "파일 업로드", description = "단일 파일을 업로드합니다.")
     @ApiResponses({
         @ApiResponse(responseCode = "200", description = "파일 업로드 성공"),
-        @ApiResponse(responseCode = "400", description = "잘못된 요청 데이터", content = @Content(schema = @Schema(implementation = ApiResponseDto.class))),
+        @ApiResponse(responseCode = "400", description = "잘못된 요청 데이터", content = @Content),
-        @ApiResponse(responseCode = "500", description = "파일 업로드 실패", content = @Content(schema = @Schema(implementation = ApiResponseDto.class)))
+        @ApiResponse(responseCode = "500", description = "파일 업로드 실패", content = @Content)
     })
     @PostMapping("/upload")
     public ResponseEntity<ApiResponseDto<FileUploadResponseDto>> uploadFile(
@@ -53,8 +53,8 @@ public class FileController {
     @Operation(summary = "다중 파일 업로드", description = "여러 파일을 동시에 업로드합니다.")
     @ApiResponses({
         @ApiResponse(responseCode = "200", description = "다중 파일 업로드 성공"),
-        @ApiResponse(responseCode = "400", description = "잘못된 요청 데이터", content = @Content(schema = @Schema(implementation = ApiResponseDto.class))),
+        @ApiResponse(responseCode = "400", description = "잘못된 요청 데이터", content = @Content),
-        @ApiResponse(responseCode = "500", description = "다중 파일 업로드 실패", content = @Content(schema = @Schema(implementation = ApiResponseDto.class)))
+        @ApiResponse(responseCode = "500", description = "다중 파일 업로드 실패", content = @Content)
     })
     @PostMapping("/upload-multiple")
     public ResponseEntity<ApiResponseDto<MultipleFileUploadResponseDto>> uploadMultipleFiles(
@@ -69,8 +69,8 @@ public class FileController {
     @Operation(summary = "파일 다운로드", description = "파일 ID로 파일을 다운로드합니다.")
     @ApiResponses({
         @ApiResponse(responseCode = "200", description = "파일 다운로드 성공"),
-        @ApiResponse(responseCode = "404", description = "파일을 찾을 수 없음", content = @Content(schema = @Schema(implementation = ApiResponseDto.class))),
+        @ApiResponse(responseCode = "404", description = "파일을 찾을 수 없음", content = @Content),
-        @ApiResponse(responseCode = "500", description = "파일 다운로드 실패", content = @Content(schema = @Schema(implementation = ApiResponseDto.class)))
+        @ApiResponse(responseCode = "500", description = "파일 다운로드 실패", content = @Content)
     })
     @GetMapping("/download/{oid}")
     public ResponseEntity<ByteArrayResource> downloadFile(@PathVariable Long oid) {
@@ -90,8 +90,8 @@ public class FileController {
     @Operation(summary = "파일 논리적 삭제", description = "파일 ID로 파일을 논리적으로 삭제합니다. (use_flag를 false로 변경)")
     @ApiResponses({
         @ApiResponse(responseCode = "200", description = "파일 논리적 삭제 성공"),
-        @ApiResponse(responseCode = "404", description = "파일을 찾을 수 없음", content = @Content(schema = @Schema(implementation = ApiResponseDto.class))),
+        @ApiResponse(responseCode = "404", description = "파일을 찾을 수 없음", content = @Content),
-        @ApiResponse(responseCode = "500", description = "파일 논리적 삭제 실패", content = @Content(schema = @Schema(implementation = ApiResponseDto.class)))
+        @ApiResponse(responseCode = "500", description = "파일 논리적 삭제 실패", content = @Content)
     })
     @DeleteMapping("/{oid}")
     public ResponseEntity<ApiResponseDto<Void>> deleteFile(@PathVariable Long oid) {

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

@@ -50,8 +50,8 @@ public class MemberController {
     @Operation(summary = "회원 등록", description = "새로운 회원을 등록합니다.")
     @ApiResponses({
         @ApiResponse(responseCode = "201", description = "회원 가입 성공"),
-        @ApiResponse(responseCode = "400", description = "잘못된 요청 데이터", content = @Content(schema = @Schema(implementation = ApiResponseDto.class))),
+        @ApiResponse(responseCode = "400", description = "잘못된 요청 데이터", content = @Content),
-        @ApiResponse(responseCode = "409", description = "중복된 사용자 정보", content = @Content(schema = @Schema(implementation = ApiResponseDto.class)))
+        @ApiResponse(responseCode = "409", description = "중복된 사용자 정보", content = @Content)
     })
     @PostMapping("/register")
     public ResponseEntity<ApiResponseDto<CreateMemberResponseDto>> createMember(@RequestBody @Valid CreateMemberRequestDto requestDto) {
@@ -66,7 +66,7 @@ public class MemberController {
     @Operation(summary = "회원 목록 조회", description = "활성화된 모든 회원의 목록을 조회합니다.")
     @ApiResponses({
         @ApiResponse(responseCode = "200", description = "회원 목록 조회 성공"),
-        @ApiResponse(responseCode = "400", description = "잘못된 요청 파라미터", content = @Content(schema = @Schema(implementation = ApiResponseDto.class)))
+        @ApiResponse(responseCode = "400", description = "잘못된 요청 파라미터", content = @Content)
     })
     @GetMapping
     public ResponseEntity<ApiResponseDto<List<GetMemberResponseDto>>> getMembers(@ModelAttribute GetMembersRequestDto requestDto) {
@@ -82,7 +82,7 @@ public class MemberController {
     @Operation(summary = "회원 목록 조회 (페이지네이션)", description = "페이지네이션을 적용한 회원 목록을 조회합니다.")
     @ApiResponses({
         @ApiResponse(responseCode = "200", description = "회원 목록 조회 성공"),
-        @ApiResponse(responseCode = "400", description = "잘못된 요청 파라미터", content = @Content(schema = @Schema(implementation = ApiResponseDto.class)))
+        @ApiResponse(responseCode = "400", description = "잘못된 요청 파라미터", content = @Content)
     })
     @GetMapping("/paged")
     public ResponseEntity<ApiResponseDto<PagedResult<GetMemberResponseDto>>> getMembersPaged(@ModelAttribute GetMembersPagedRequestDto requestDto) {

src/main/java/com/bio/bio_backend/domain/base/memberauthgroup/controller/MemberAuthGroupController.java

@@ -0,0 +1,51 @@
+package com.bio.bio_backend.domain.base.memberauthgroup.controller;
+
+import com.bio.bio_backend.domain.base.memberauthgroup.dto.MemberAuthGroupDto;
+import com.bio.bio_backend.domain.base.memberauthgroup.dto.ReplaceMemberAuthGroupsRequest;
+import com.bio.bio_backend.domain.base.memberauthgroup.service.MemberAuthGroupService;
+import lombok.RequiredArgsConstructor;
+import org.springframework.web.bind.annotation.*;
+import lombok.extern.slf4j.Slf4j;
+import io.swagger.v3.oas.annotations.tags.Tag;
+
+import java.util.List;
+
+@RestController
+@RequestMapping("/member_auth_group")
+@RequiredArgsConstructor
+@Tag(name = "MemberAuthGroup", description = "")
+@Slf4j
+public class MemberAuthGroupController {
+
+    private final MemberAuthGroupService service;
+
+    @PostMapping
+    public MemberAuthGroupDto create(@RequestBody MemberAuthGroupDto dto) {
+        return service.create(dto);
+    }
+
+    @GetMapping("/{id}")
+    public MemberAuthGroupDto getById(@PathVariable Long id) {
+        return service.getById(id);
+    }
+
+    @GetMapping
+    public List<MemberAuthGroupDto> getAll() {
+        return service.getAll();
+    }
+
+    @PutMapping("/{id}")
+    public MemberAuthGroupDto update(@PathVariable Long id, @RequestBody MemberAuthGroupDto dto) {
+        return service.update(id, dto);
+    }
+
+    @DeleteMapping("/{id}")
+    public void delete(@PathVariable Long id) {
+        service.delete(id);
+    }
+
+    @PostMapping("/replace")
+    public void replaceMemberAuthGroups(@RequestBody ReplaceMemberAuthGroupsRequest request) {
+        service.replaceMemberAuthGroups(request.getMemberOid(), request.getAuthGroupOids());
+    }
+}

src/main/java/com/bio/bio_backend/domain/base/memberauthgroup/dto/MemberAuthGroupDto.java

@@ -0,0 +1,18 @@
+package com.bio.bio_backend.domain.base.memberauthgroup.dto;
+
+import com.bio.bio_backend.domain.base.authgroup.entity.AuthGroup;
+import com.bio.bio_backend.domain.base.member.entity.Member;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class MemberAuthGroupDto {
+    private Member memberOid;
+    private AuthGroup authGroupOid;
+}

src/main/java/com/bio/bio_backend/domain/base/memberauthgroup/dto/ReplaceMemberAuthGroupsRequest.java

@@ -0,0 +1,12 @@
+package com.bio.bio_backend.domain.base.memberauthgroup.dto;
+
+import java.util.List;
+
+import lombok.Data;
+
+@Data
+public class ReplaceMemberAuthGroupsRequest {
+    private Long memberOid;
+    private List<Long> authGroupOids;
+}
+

src/main/java/com/bio/bio_backend/domain/base/memberauthgroup/entity/MemberAuthGroup.java

@@ -0,0 +1,35 @@
+package com.bio.bio_backend.domain.base.memberauthgroup.entity;
+
+import com.bio.bio_backend.domain.base.authgroup.entity.AuthGroup;
+import com.bio.bio_backend.domain.base.member.entity.Member;
+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 + "member_auth_group")
+public class MemberAuthGroup extends BaseEntity {
+
+    @Comment("사용자 OID")
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "member_oid")
+    private Member memberOid;
+
+    @Comment("권한 그룹 OID")
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "auth_group_oid")
+    private AuthGroup authGroupOid;
+}

src/main/java/com/bio/bio_backend/domain/base/memberauthgroup/mapper/MemberAuthGroupMapper.java

@@ -0,0 +1,13 @@
+package com.bio.bio_backend.domain.base.memberauthgroup.mapper;
+
+import com.bio.bio_backend.global.config.GlobalMapperConfig;
+import com.bio.bio_backend.domain.base.memberauthgroup.entity.MemberAuthGroup;
+import com.bio.bio_backend.domain.base.memberauthgroup.dto.MemberAuthGroupDto;
+import org.mapstruct.Mapper;
+
+@Mapper(config = GlobalMapperConfig.class)
+public interface MemberAuthGroupMapper {
+    MemberAuthGroup toEntity(MemberAuthGroupDto dto);
+
+    MemberAuthGroupDto toDto(MemberAuthGroup entity);
+}

src/main/java/com/bio/bio_backend/domain/base/memberauthgroup/repository/MemberAuthGroupRepository.java

@@ -0,0 +1,17 @@
+package com.bio.bio_backend.domain.base.memberauthgroup.repository;
+
+import com.bio.bio_backend.domain.base.memberauthgroup.entity.MemberAuthGroup;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.data.jpa.repository.Modifying;
+import org.springframework.data.jpa.repository.Query;
+import org.springframework.data.repository.query.Param;
+import org.springframework.stereotype.Repository;
+
+@Repository
+public interface MemberAuthGroupRepository
+                extends JpaRepository<MemberAuthGroup, Long>, MemberAuthGroupRepositoryCustom {
+
+        @Modifying
+        @Query("delete from MemberAuthGroup mag where mag.memberOid.oid = :memberOid")
+        void deleteByMemberOid(@Param("memberOid") Long memberOid);
+}

src/main/java/com/bio/bio_backend/domain/base/memberauthgroup/repository/MemberAuthGroupRepositoryCustom.java

@@ -0,0 +1,9 @@
+package com.bio.bio_backend.domain.base.memberauthgroup.repository;
+
+/**
+ * QueryDSL을 활용한 커스텀 쿼리 메서드들을 정의하는 인터페이스
+ * 복잡한 쿼리나 동적 쿼리가 필요한 경우 이 인터페이스를 구현하여 사용합니다.
+ */
+public interface MemberAuthGroupRepositoryCustom {
+
+}

src/main/java/com/bio/bio_backend/domain/base/memberauthgroup/repository/MemberAuthGroupRepositoryImpl.java

@@ -0,0 +1,24 @@
+package com.bio.bio_backend.domain.base.memberauthgroup.repository;
+
+import com.bio.bio_backend.domain.base.memberauthgroup.entity.QMemberAuthGroup;
+import com.querydsl.jpa.impl.JPAQueryFactory;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Repository;
+
+
+/**
+ * QueryDSL을 활용하여 MemberAuthGroupRepositoryCustom 인터페이스를 구현하는 클래스
+ * 복잡한 쿼리나 동적 쿼리를 QueryDSL로 작성하여 성능과 가독성을 향상시킵니다.
+ */
+@Repository
+@RequiredArgsConstructor
+public class MemberAuthGroupRepositoryImpl implements MemberAuthGroupRepositoryCustom {
+
+    private final JPAQueryFactory queryFactory;
+
+    /**
+     * QMemberAuthGroup 인스턴스를 생성하여 쿼리에서 사용합니다.
+     * QueryDSL의 Q클래스를 통해 타입 안전한 쿼리 작성이 가능합니다.
+     */
+    private final QMemberAuthGroup memberAuthGroup = QMemberAuthGroup.memberAuthGroup;
+}

src/main/java/com/bio/bio_backend/domain/base/memberauthgroup/service/MemberAuthGroupService.java

@@ -0,0 +1,21 @@
+package com.bio.bio_backend.domain.base.memberauthgroup.service;
+
+import com.bio.bio_backend.domain.base.memberauthgroup.dto.MemberAuthGroupDto;
+import java.util.List;
+
+public interface MemberAuthGroupService {
+    MemberAuthGroupDto create(MemberAuthGroupDto dto);
+
+    MemberAuthGroupDto getById(Long id);
+
+    List<MemberAuthGroupDto> getAll();
+
+    MemberAuthGroupDto update(Long id, MemberAuthGroupDto dto);
+
+    void delete(Long id);
+
+    /**
+     * 특정 memberOid의 기존 매핑을 모두 삭제하고, 전달된 authGroupOid 목록으로 재등록
+     */
+    void replaceMemberAuthGroups(Long memberOid, List<Long> authGroupOids);
+}

src/main/java/com/bio/bio_backend/domain/base/memberauthgroup/service/MemberAuthGroupServiceImpl.java

@@ -0,0 +1,80 @@
+package com.bio.bio_backend.domain.base.memberauthgroup.service;
+
+import com.bio.bio_backend.domain.base.memberauthgroup.dto.MemberAuthGroupDto;
+import com.bio.bio_backend.domain.base.memberauthgroup.entity.MemberAuthGroup;
+import com.bio.bio_backend.domain.base.memberauthgroup.repository.MemberAuthGroupRepository;
+import com.bio.bio_backend.domain.base.memberauthgroup.mapper.MemberAuthGroupMapper;
+import org.springframework.stereotype.Service;
+import lombok.RequiredArgsConstructor;
+
+import java.util.List;
+import java.util.stream.Collectors;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.transaction.annotation.Transactional;
+import com.bio.bio_backend.domain.base.authgroup.entity.AuthGroup;
+import com.bio.bio_backend.domain.base.member.entity.Member;
+
+@Service
+@RequiredArgsConstructor
+@Slf4j
+@Transactional(readOnly = true)
+public class MemberAuthGroupServiceImpl implements MemberAuthGroupService {
+
+    private final MemberAuthGroupRepository repository;
+    private final MemberAuthGroupMapper mapper;
+
+    @Override
+    @Transactional
+    public MemberAuthGroupDto create(MemberAuthGroupDto dto) {
+        MemberAuthGroup entity = mapper.toEntity(dto);
+        return mapper.toDto(repository.save(entity));
+    }
+
+    @Override
+    public MemberAuthGroupDto getById(Long id) {
+        return repository.findById(id).map(mapper::toDto).orElse(null);
+    }
+
+    @Override
+    public List<MemberAuthGroupDto> getAll() {
+        return repository.findAll().stream().map(mapper::toDto).collect(Collectors.toList());
+    }
+
+    @Override
+    @Transactional
+    public MemberAuthGroupDto update(Long id, MemberAuthGroupDto dto) {
+        MemberAuthGroup entity = repository.findById(id).orElseThrow();
+        // TODO: update fields
+        return mapper.toDto(repository.save(entity));
+    }
+
+    @Override
+    @Transactional
+    public void delete(Long id) {
+        repository.deleteById(id);
+    }
+
+    @Override
+    @Transactional
+    public void replaceMemberAuthGroups(Long memberOid, List<Long> authGroupOids) {
+        repository.deleteByMemberOid(memberOid);
+
+        if (authGroupOids == null || authGroupOids.isEmpty()) {
+            return;
+        }
+
+        Member memberRef = new Member();
+        memberRef.setOid(memberOid);
+
+        for (Long groupOid : authGroupOids) {
+            AuthGroup groupRef = new AuthGroup();
+            groupRef.setOid(groupOid);
+
+            MemberAuthGroup entity = MemberAuthGroup.builder()
+                    .memberOid(memberRef)
+                    .authGroupOid(groupRef)
+                    .build();
+            repository.save(entity);
+        }
+    }
+}

src/main/java/com/bio/bio_backend/domain/base/resource/controller/ResourceController.java

@@ -0,0 +1,50 @@
+package com.bio.bio_backend.domain.base.resource.controller;
+
+import com.bio.bio_backend.domain.base.resource.dto.ResourceDto;
+import com.bio.bio_backend.domain.base.resource.service.ResourceService;
+import lombok.RequiredArgsConstructor;
+import org.springframework.web.bind.annotation.*;
+import lombok.extern.slf4j.Slf4j;
+import io.swagger.v3.oas.annotations.tags.Tag;
+
+import java.util.List;
+
+@RestController
+@RequestMapping("/resource")
+@RequiredArgsConstructor
+@Tag(name = "Resource", description = "")
+@Slf4j
+public class ResourceController {
+
+    private final ResourceService service;
+
+    @PostMapping("")
+    public ResourceDto create(@RequestBody ResourceDto dto) {
+        return service.createResource(dto);
+    }
+
+    @PostMapping("/list")
+    public List<ResourceDto> createList(@RequestBody List<ResourceDto> list) {
+        return service.createResourceList(list);
+    }
+
+    @GetMapping("/{id}")
+    public ResourceDto getById(@PathVariable Long id) {
+        return service.getById(id);
+    }
+
+    @GetMapping
+    public List<ResourceDto> getAll() {
+        return service.getAll();
+    }
+
+    @PutMapping("/{id}")
+    public ResourceDto update(@PathVariable Long id, @RequestBody ResourceDto dto) {
+        return service.update(id, dto);
+    }
+
+    @DeleteMapping("/{id}")
+    public void delete(@PathVariable Long id) {
+        service.delete(id);
+    }
+}

src/main/java/com/bio/bio_backend/domain/base/resource/dto/ResourceDto.java

@@ -0,0 +1,21 @@
+package com.bio.bio_backend.domain.base.resource.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class ResourceDto {
+    private String code;
+    private String name;
+    private long parentCode;
+    private String type;
+    private String path;
+    private int sortOrder;
+    private String description;
+    private boolean menuYn;
+}

src/main/java/com/bio/bio_backend/domain/base/resource/entity/Resource.java

@@ -0,0 +1,56 @@
+package com.bio.bio_backend.domain.base.resource.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 + "resource")
+public class Resource extends BaseEntity {
+
+    @Column(name = "code", length = 100)
+    @Comment("코드")
+    private String code;
+
+    @Column(name = "name", length = 100)
+    @Comment("리소스명")
+    private String name;
+
+    @Column(name = "parent_code")
+    @Comment("부모 코드")
+    private long parentCode;
+
+    @Column(name = "type", length = 50)
+    @Comment("리소스 유형(메뉴, 페이지, 컴포넌트)")
+    private String type;
+
+    @Column(name = "path", length = 100)
+    @Comment("주소")
+    private String path;
+
+    @Column(name = "sort_order")
+    @Comment("정렬 순서")
+    private int sortOrder;
+
+    @Column(name = "description", length = 255)
+    @Comment("설명")
+    private String description;
+
+    @Column(name = "menu_yn")
+    @Comment("메뉴여부")
+    private boolean menuYn;
+
+}

src/main/java/com/bio/bio_backend/domain/base/resource/mapper/ResourceMapper.java

@@ -0,0 +1,13 @@
+package com.bio.bio_backend.domain.base.resource.mapper;
+
+import com.bio.bio_backend.global.config.GlobalMapperConfig;
+import com.bio.bio_backend.domain.base.resource.entity.Resource;
+import com.bio.bio_backend.domain.base.resource.dto.ResourceDto;
+import org.mapstruct.Mapper;
+
+@Mapper(config = GlobalMapperConfig.class)
+public interface ResourceMapper {
+    Resource toEntity(ResourceDto dto);
+
+    ResourceDto toDto(Resource entity);
+}

src/main/java/com/bio/bio_backend/domain/base/resource/repository/ResourceRepository.java

@@ -0,0 +1,9 @@
+package com.bio.bio_backend.domain.base.resource.repository;
+
+import com.bio.bio_backend.domain.base.resource.entity.Resource;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+@Repository
+public interface ResourceRepository extends JpaRepository<Resource, Long>, ResourceRepositoryCustom {
+}

src/main/java/com/bio/bio_backend/domain/base/resource/repository/ResourceRepositoryCustom.java

@@ -0,0 +1,15 @@
+package com.bio.bio_backend.domain.base.resource.repository;
+
+import com.bio.bio_backend.domain.base.resource.entity.Resource;
+
+import java.util.List;
+
+/**
+ * QueryDSL을 활용한 커스텀 쿼리 메서드들을 정의하는 인터페이스
+ * 복잡한 쿼리나 동적 쿼리가 필요한 경우 이 인터페이스를 구현하여 사용합니다.
+ */
+public interface ResourceRepositoryCustom {
+
+    List<Resource> findResourcesByMemberId(Long memberOId);
+
+}

src/main/java/com/bio/bio_backend/domain/base/resource/repository/ResourceRepositoryImpl.java

@@ -0,0 +1,47 @@
+package com.bio.bio_backend.domain.base.resource.repository;
+
+import com.bio.bio_backend.domain.base.resource.entity.Resource;
+import com.bio.bio_backend.domain.base.authgroup.entity.QAuthGroup;
+import com.bio.bio_backend.domain.base.authgroupresource.entity.QAuthGroupResource;
+import com.bio.bio_backend.domain.base.memberauthgroup.entity.QMemberAuthGroup;
+import com.bio.bio_backend.domain.base.resource.entity.QResource;
+import com.querydsl.jpa.impl.JPAQueryFactory;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Repository;
+
+import java.util.List;
+
+/**
+ * QueryDSL을 활용하여 ResourceRepositoryCustom 인터페이스를 구현하는 클래스
+ * 복잡한 쿼리나 동적 쿼리를 QueryDSL로 작성하여 성능과 가독성을 향상시킵니다.
+ */
+@Repository
+@RequiredArgsConstructor
+public class ResourceRepositoryImpl implements ResourceRepositoryCustom {
+
+    private final JPAQueryFactory queryFactory;
+
+    /**
+     * QResource 인스턴스를 생성하여 쿼리에서 사용합니다.
+     * QueryDSL의 Q클래스를 통해 타입 안전한 쿼리 작성이 가능합니다.
+     */
+    // private final QMember member = QMember.member;
+    private final QMemberAuthGroup memberAuthGroup = QMemberAuthGroup.memberAuthGroup;
+    private final QAuthGroup authGroup = QAuthGroup.authGroup;
+    private final QAuthGroupResource authGroupResource = QAuthGroupResource.authGroupResource;
+    private final QResource resource = QResource.resource;
+
+    @Override
+    public List<Resource> findResourcesByMemberId(Long memberOId) {
+        return queryFactory
+                .select(resource).distinct()
+                .from(resource)
+                // join(연결할 Q-Type).on(연결 조건) 형태로 명시적 조인
+                .join(authGroupResource).on(authGroupResource.resourceOid.eq(resource))
+                .join(authGroup).on(authGroupResource.authGroupOid.eq(authGroup))
+                .join(memberAuthGroup).on(memberAuthGroup.authGroupOid.eq(authGroup))
+                // 최종적으로 Member ID로 필터링
+                .where(memberAuthGroup.memberOid.oid.eq(memberOId))
+                .fetch();
+    }
+}

src/main/java/com/bio/bio_backend/domain/base/resource/service/ResourceService.java

@@ -0,0 +1,18 @@
+package com.bio.bio_backend.domain.base.resource.service;
+
+import com.bio.bio_backend.domain.base.resource.dto.ResourceDto;
+import java.util.List;
+
+public interface ResourceService {
+    ResourceDto createResource(ResourceDto dto);
+
+    List<ResourceDto> createResourceList(List<ResourceDto> list);
+
+    ResourceDto getById(Long id);
+
+    List<ResourceDto> getAll();
+
+    ResourceDto update(Long id, ResourceDto dto);
+
+    void delete(Long id);
+}

src/main/java/com/bio/bio_backend/domain/base/resource/service/ResourceServiceImpl.java

@@ -0,0 +1,79 @@
+package com.bio.bio_backend.domain.base.resource.service;
+
+import com.bio.bio_backend.domain.base.resource.dto.ResourceDto;
+import com.bio.bio_backend.domain.base.resource.entity.Resource;
+import com.bio.bio_backend.domain.base.resource.repository.ResourceRepository;
+import com.bio.bio_backend.domain.base.resource.mapper.ResourceMapper;
+import org.springframework.stereotype.Service;
+import lombok.RequiredArgsConstructor;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.stream.Collectors;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.transaction.annotation.Transactional;
+
+@Service
+@RequiredArgsConstructor
+@Slf4j
+@Transactional(readOnly = true)
+public class ResourceServiceImpl implements ResourceService {
+
+    private final ResourceRepository repository;
+    private final ResourceMapper mapper;
+
+    @Override
+    @Transactional
+    public ResourceDto createResource(ResourceDto dto) {
+        try {
+            Resource entity = mapper.toEntity(dto);
+            return mapper.toDto(repository.save(entity));
+        } catch (Exception e) {
+            return null;
+        }
+    }
+
+    @Transactional
+    @Override
+    public List<ResourceDto> createResourceList(List<ResourceDto> list) {
+
+        List<ResourceDto> resultList = new ArrayList<>();
+
+        for (ResourceDto dto : list) {
+            try {
+                Resource entity = mapper.toEntity(dto);
+                resultList.add(mapper.toDto(repository.save(entity)));
+            } catch (Exception e) {
+                ResourceDto resultDto = null;
+                resultList.add(resultDto);
+            }
+        }
+
+        return resultList;
+    }
+
+    @Override
+    public ResourceDto getById(Long id) {
+        return repository.findById(id).map(mapper::toDto).orElse(null);
+    }
+
+    @Override
+    public List<ResourceDto> getAll() {
+        return repository.findAll().stream().map(mapper::toDto).collect(Collectors.toList());
+    }
+
+    @Override
+    @Transactional
+    public ResourceDto update(Long id, ResourceDto dto) {
+        Resource entity = repository.findById(id).orElseThrow();
+        // TODO: update fields
+        return mapper.toDto(repository.save(entity));
+    }
+
+    @Override
+    @Transactional
+    public void delete(Long id) {
+        repository.deleteById(id);
+    }
+
+}

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

@@ -1,24 +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);
+        
+        // Preflight 요청 캐시 시간 (초)
+        config.setMaxAge(3600L);
+        
+        // 모든 경로에 적용
         source.registerCorsConfiguration("/**", config);
 
         return new CorsFilter(source);
-
     }
 }

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

@@ -2,6 +2,7 @@ package com.bio.bio_backend.global.security;
 
 import com.bio.bio_backend.global.filter.JwtTokenIssuanceFilter;
 import com.bio.bio_backend.global.filter.JwtTokenValidationFilter;
+import com.bio.bio_backend.global.config.CorsConfig;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
 import org.springframework.core.annotation.Order;
@@ -15,6 +16,7 @@ import org.springframework.security.config.http.SessionCreationPolicy;
 import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
 import org.springframework.security.web.SecurityFilterChain;
 import org.springframework.security.web.authentication.UsernamePasswordAuthenticationFilter;
+import org.springframework.web.filter.CorsFilter;
 
 import com.fasterxml.jackson.databind.ObjectMapper;
 
@@ -37,6 +39,12 @@ public class WebSecurity {
     private final ObjectMapper objectMapper;
     private final HttpUtils httpUtils;
     private final MemberMapper memberMapper;
+    private final CorsConfig corsConfig; // CorsConfig 주입
+
+    // CORS 필터 빈 가져오기
+    private CorsFilter getCorsFilter() {
+        return corsConfig.corsFilter();
+    }
 
     private JwtTokenIssuanceFilter getJwtTokenIssuanceFilter(AuthenticationManager authenticationManager) {
         JwtTokenIssuanceFilter filter = new JwtTokenIssuanceFilter(authenticationManager, jwtUtils, objectMapper, memberService, httpUtils, memberMapper);
@@ -86,6 +94,7 @@ public class WebSecurity {
             .sessionManagement(session -> 
                 session.sessionCreationPolicy(SessionCreationPolicy.STATELESS)
             );
+            //.addFilterBefore(getCorsFilter(), UsernamePasswordAuthenticationFilter.class);    // cors를 nginx 통해 처리 중
         return http.build();
     }
 
@@ -117,6 +126,7 @@ public class WebSecurity {
                 session.sessionCreationPolicy(SessionCreationPolicy.STATELESS)
             )
             .logout(AbstractHttpConfigurer::disable)
+            //.addFilterBefore(getCorsFilter(), UsernamePasswordAuthenticationFilter.class)     // cors를 nginx 통해 처리 중
             .addFilterBefore(getJwtTokenIssuanceFilter(authenticationManager), UsernamePasswordAuthenticationFilter.class)  // 토큰 발급
             .addFilterBefore(getJwtTokenValidationFilter(), UsernamePasswordAuthenticationFilter.class);  // 토큰 검증
 

src/main/resources/application.properties

@@ -49,6 +49,7 @@ spring.jpa.properties.hibernate.order_updates=true
 spring.jpa.properties.javax.persistence.schema-generation.scripts.action=create
 spring.jpa.properties.javax.persistence.schema-generation.scripts.create-target=ddl/schema_entity.sql
 spring.jpa.properties.hibernate.hbm2ddl.schema-generation.script.append=false
+spring.jpa.properties.hibernate.hbm2ddl.charset_name=UTF-8
 
 # ========================================
 # 로그 레벨 설정