📊 Java-Service-Tree-Framework-Middle-Proxy 프로젝트 구조 분석


* Spring Security 와 Keycloak 을 연동한 인증 인가 시스템 적용 ( Spring security 설정과 동작을 분리 )
* Spring OAuth2RestTemplate 을 활용한 연관 시스템간의 통신 적용 완료 ( 사용자 베이스 통신 동작을 분리 )
* Docker file 을 자동으로 구성하도록 설정
* Artifact Version 을 자동으로 구성하도록 설정
* ZuulProxy 를 활용한 MSA Gateway 구성
* Zipkin 을 활용한 Request Flow 추적

### Those who support us! ###
0. Nexus 의 Realms 에 Docker Bearer Token 을 Active 해야 Docker login 가능 함.
1. 빌드 시, Jenkins agent 가 동작하는 HOST 에 Docker Login {Nexus}를 해야만 401 없이 push 됨

----

로컬 구동 환경: 인텔리제이, Windows 10 이상 또는 Mac

1. 인텔리제이에서 해당 프로젝트를 git clone 한 후, 파일 > 프로젝트 구조(project structure)에서 JDK를 17로 설정합니다. Amazon Corretto 17을 선택했습니다.
2. 빌드 > 빌드 프로젝트(build project)를 실행합니다.
3. 우측 상단의 애플리케이션 > 구성 편집(Edit Configurations)에 들어가서 Active Profiles 입력칸에 dev라고 입력합니다.
4. 프로젝트 실행버튼을 클릭합니다.

Swagger URL = http://127.0.0.1:13131/middle-proxy-api/swagger-ui/

   🎯 프로젝트 개요

프로젝트명: Java-Service-Tree-Framework-Middle-Proxy
타입: Spring Cloud Gateway 기반 MSA 게이트웨이 / 미들웨어 프록시
역할: 마이크로서비스 간의 라우팅, 인증/인가, 통합 관리

🛠️ 기술 스택
핵심 프레임워크:

Spring Boot 2.6.3
Spring Cloud Gateway
Java 17
Gradle 7.6.4

주요 기술:

인증/인가: Keycloak + Spring Security OAuth2
세션 관리: Redis (Spring Session Data Redis)
통신: OpenFeign (서비스 간 통신)
모니터링: Zipkin (분산 추적), Elastic APM, Actuator
메시징: Kafka
API 문서화: Swagger (Springfox 3.0.0)
알림: Slack API
컨테이너: Docker

📁 주요 디렉토리 구조

Java-Service-Tree-Framework-Middle-Proxy/
│
├── 📂 src/
│   └── 📂 main/
│       ├── 📂 java/com/arms/
│       │   ├── 📄 Application.java                    # 메인 애플리케이션 진입점
│       │   │
│       │   ├── 📂 api/                                # API 엔드포인트 레이어
│       │   │   ├── 📂 keycloak/                       # Keycloak 연동 API
│       │   │   ├── 📂 mapping/                        # 데이터 매핑 API
│       │   │   ├── 📂 req/                            # 요청 처리 API
│       │   │   ├── 📂 scheduler/                      # 스케줄러 관리
│       │   │   ├── 📂 user/                           # 사용자 관리 API
│       │   │   └── 📂 util/                           # API 유틸리티
│       │   │
│       │   ├── 📂 client/                             # 외부 클라이언트 통신
│       │   │   └── 📂 dwr/                            # DWR(Direct Web Remoting) 클라이언트
│       │   │
│       │   ├── 📂 config/                             # 애플리케이션 설정
│       │   │   ├── 📄 AppConfig.java                  # 기본 앱 설정
│       │   │   ├── 📄 KeycloakConfig.java             # Keycloak 설정
│       │   │   ├── 📄 RedisConfig.java                # Redis 세션 설정
│       │   │   ├── 📄 KafkaConfig.java                # Kafka 메시징 설정
│       │   │   ├── 📄 OpenFeignConfig.java            # Feign 클라이언트 설정
│       │   │   ├── 📄 SlackConfig.java                # Slack 알림 설정
│       │   │   ├── 📄 ThreadPoolConfig.java           # 스레드 풀 설정
│       │   │   ├── 📄 WebConfig.java                  # 웹 설정
│       │   │   ├── 📄 FeignResponseDecoderConfig.java # Feign 응답 디코더
│       │   │   ├── 📄 PropertiesConfiguration.java    # 프로퍼티 설정
│       │   │   │
│       │   │   ├── 📂 filter/                         # 요청/응답 필터
│       │   │   ├── 📂 handler/                        # 예외/이벤트 핸들러
│       │   │   ├── 📂 interceptor/                    # HTTP 인터셉터
│       │   │   ├── 📂 security/                       # 보안 설정
│       │   │   └── 📂 swagger/                        # Swagger API 문서 설정
│       │   │
│       │   └── 📂 util/                               # 공통 유틸리티
│       │       └── 📄 DataSerializer.java             # 데이터 직렬화 유틸
│       │
│       └── 📂 resources/                              # 리소스 파일
│           ├── 📄 application.yml                     # 기본 설정 파일
│           ├── 📄 application-dev.yml                 # 개발 환경 설정
│           ├── 📄 application-stg.yml                 # 스테이징 환경 설정
│           ├── 📄 application-live.yml                # 운영 환경 설정
│           ├── 📄 banner.txt                          # 시작 배너
│           ├── 📄 rebel.xml                           # JRebel 설정
│           │
│           └── 📂 logback/                            # 로깅 설정
│               ├── 📄 console-appender.xml            # 콘솔 로그 설정
│               ├── 📄 logback-dev.xml                 # 개발 환경 로그
│               ├── 📄 logback-stg.xml                 # 스테이징 환경 로그
│               └── 📄 logback-live.xml                # 운영 환경 로그
│
├── 📂 certs/                                          # SSL/TLS 인증서
│   ├── 📂 313_co_kr/                                  # 313.co.kr 도메인 인증서
│   │   ├── 📄 313_co_kr.crt                           # 인증서 파일
│   │   ├── 📄 313_co_kr.pfx                           # PKCS#12 인증서
│   │   ├── 📄 313_co_kr_SHA256WITHRSA.key             # 개인 키
│   │   └── 📂 ChainCA/                                # 체인 인증서
│   │
│   └── 📂 a-rms_net/                                  # a-rms.net 도메인 인증서
│       ├── 📄 a-rms_net.crt
│       ├── 📄 a-rms_net.pfx
│       ├── 📄 a-rms_net_SHA256WITHRSA.key
│       └── 📂 ChainCA/
│
├── 📂 Redis-x64-3.2.100/                             # Redis 서버 (Windows용)
│   ├── 📄 redis-server.exe                           # Redis 실행 파일
│   ├── 📄 redis-cli.exe                              # Redis CLI 도구
│   ├── 📄 redis.windows.conf                         # Redis 설정 파일
│   └── 📄 redis.windows-service.conf                 # Windows 서비스 설정
│
├── 📂 gradle/                                         # Gradle Wrapper
│   └── 📂 wrapper/
│       ├── 📄 gradle-wrapper.jar
│       └── 📄 gradle-wrapper.properties
│
├── 📂 .github/                                        # GitHub 설정
│   └── 📂 workflows/
│       └── 📄 release-drafter.yml                    # Release 자동화
│
├── 📂 .idea/                                          # IntelliJ IDEA 설정
│   ├── 📄 workspace.xml
│   ├── 📄 compiler.xml
│   ├── 📄 gradle.xml
│   └── 📄 vcs.xml
│
├── 📂 .gradle/                                        # Gradle 캐시
│
├── 📄 build.gradle                                    # Gradle 빌드 스크립트
├── 📄 settings.gradle                                 # Gradle 프로젝트 설정
├── 📄 gradlew                                         # Gradle Wrapper (Unix)
├── 📄 gradlew.bat                                     # Gradle Wrapper (Windows)
│
├── 📄 Dockerfile                                      # Docker 이미지 빌드
├── 📄 docker-entrypoint.sh                            # Docker 컨테이너 진입점
│
├── 📄 elastic-a

⚙️ 주요 설정 및 기능
1. 인증/인가 시스템

Keycloak 통합
Spring Security OAuth2 (Resource Server + Client)
JWT 토큰 기반 인증
Redis 기반 세션 관리

2. Gateway 기능

Spring Cloud Gateway를 통한 라우팅
요청/응답 필터링
부하 분산

3. 통합 기능

OpenFeign을 통한 서비스 간 통신
Kafka 메시지 브로커 통합
Slack 알림 통합

4. 모니터링 & 추적

Zipkin을 통한 분산 추적
Elastic APM 성능 모니터링
Spring Cloud Sleuth
Actuator Health Check

5. 빌드 & 배포

자동 버전 관리 (Nexus에서 메타데이터 조회하여 자동 증가)
Docker 이미지 자동 생성
Maven Nexus 배포 자동화
SonarQube 코드 품질 분석

🔐 보안 설정

SSL/TLS 인증서 관리 (313.co.kr, a-rms.net)
Keycloak 기반 중앙 인증
OAuth2 Resource Server

🌐 환경별 설정

dev: 개발 환경
stg: 스테이징 환경
live: 운영 환경

📦 버전 관리

현재 버전: 25.10.x (자동 증가)
Nexus Repository: http://www.313.co.kr/nexus/repository/ple-releases/
Docker Registry: 313.co.kr:5550

🎪 특징

마이크로서비스 게이트웨이: 모든 요청의 진입점 역할
중앙 인증: Keycloak 기반 SSO (Single Sign-On)
통합 라우팅: 여러 백엔드 서비스로 요청 라우팅
분산 추적: Zipkin으로 서비스 간 호출 추적
자동화 빌드: 버전 자동 증가 및 Docker 이미지 자동 생성

이 프로젝트는 A-RMS 시스템의 API Gateway이자 인증 프록시 역할을 하는 핵심 미들웨어로 보입니다. 
모든 클라이언트 요청이 이 게이트웨이를 통과하여 각 마이크로서비스로 라우팅되는 구조입니다.