stblt-check 추가

gukyuin/stblt-check/.gradle/buildOutputCleanup/cache.properties

@@ -0,0 +1,2 @@
+#Mon Feb 02 19:50:45 KST 2026
+gradle.version=8.14

gukyuin/stblt-check/CODE_STYLE_SETUP.md

@@ -0,0 +1,112 @@
+# Code Style 설정 가이드
+
+이 문서는 프로젝트에서 Google Java Style을 자동으로 적용하기 위한 설정 가이드입니다.
+
+## 자동 포맷팅 구성
+
+### 1. 커밋 시점 자동 포맷팅 (Git Pre-commit Hook)
+
+커밋 전에 자동으로 코드를 포맷팅하고 스테이징합니다.
+
+**설정 완료:** `.git/hooks/pre-commit` 파일이 자동으로 실행됩니다.
+
+**동작 방식:**
+- 커밋 시도 시 `./gradlew spotlessApply` 자동 실행
+- 스테이징된 Java 파일을 자동으로 포맷팅
+- 포맷팅된 파일을 자동으로 다시 스테이징
+- 포맷팅이 완료되면 커밋 진행
+
+**장점:**
+- 수동으로 `spotlessApply`를 실행할 필요 없음
+- 항상 일관된 코드 스타일 유지
+- 포맷팅 누락 방지
+
+### 2. IntelliJ IDEA 저장 시점 자동 포맷팅
+
+#### 방법 1: Code Style 설정 임포트 (권장)
+
+1. **IntelliJ IDEA 열기**
+2. **Settings/Preferences** (Mac: `⌘,` / Windows: `Ctrl+Alt+S`)
+3. **Editor > Code Style > Java**
+4. **⚙️ (톱니바퀴)** 클릭 > **Import Scheme > IntelliJ IDEA code style XML**
+5. 프로젝트 루트의 `intellij-java-google-style.xml` 파일 선택
+6. **OK** 클릭
+
+#### 방법 2: 저장 시 자동 포맷팅 활성화
+
+
+**Option A: Actions on Save 설정**
+
+1. **Settings/Preferences** > **Tools > Actions on Save**
+2. 다음 옵션들을 활성화:
+   - ✅ **Reformat code**
+   - ✅ **Optimize imports**
+   - ✅ **Rearrange code** (선택사항)
+3. **Changed lines** 또는 **Whole file** 선택
+4. **OK** 클릭
+
+**Option B: Save Actions Plugin 사용 (더 많은 옵션)**
+
+1. **Settings/Preferences** > **Plugins**
+2. **Marketplace**에서 "Save Actions" 검색 및 설치
+3. **Settings/Preferences** > **Other Settings > Save Actions**
+4. 다음 옵션 활성화:
+   - ✅ **Activate save actions on save**
+   - ✅ **Reformat file**
+   - ✅ **Optimize imports**
+   - ✅ **Rearrange fields and methods** (선택사항)
+
+### 3. Gradle Spotless Plugin 수동 실행
+
+#### 코드 포맷팅 체크
+```bash
+# 포맷팅 문제 확인만 (수정하지 않음)
+./gradlew spotlessCheck
+```
+
+#### 코드 자동 포맷팅
+```bash
+# 모든 Java 파일 자동 포맷팅 적용
+./gradlew spotlessApply
+```
+
+#### 빌드 시 자동 체크
+```bash
+# 빌드 전에 자동으로 spotlessCheck 실행됨
+./gradlew build
+```
+
+## 코드 스타일 규칙
+
+프로젝트는 **Google Java Style Guide** 기반으로 다음 규칙을 따릅니다:
+
+- **Indentation**: 2 spaces (탭 아님)
+- **Line Length**: 180 characters
+- **Line Endings**: LF (Unix-style)
+- **Charset**: UTF-8
+- **Import Order**: Static imports → 빈 줄 → Regular imports
+- **Braces**: 모든 if, for, while, do 문에 중괄호 필수
+
+## 문제 해결
+
+### Pre-commit hook이 실행되지 않는 경우
+```bash
+# 실행 권한 확인 및 부여
+chmod +x .git/hooks/pre-commit
+```
+
+### Spotless 플러그인이 동작하지 않는 경우
+```bash
+# Gradle 의존성 다시 다운로드
+./gradlew clean build --refresh-dependencies
+```
+
+### IntelliJ 포맷팅이 다르게 적용되는 경우
+1. `intellij-java-google-style.xml` 다시 임포트
+2. **File > Invalidate Caches** > **Invalidate and Restart**
+
+## 추가 정보
+
+- **Google Java Style Guide**: https://google.github.io/styleguide/javaguide.html
+- **Spotless Plugin**: https://github.com/diffplug/spotless
+- **IntelliJ Code Style**: https://www.jetbrains.com/help/idea/code-style.html

gukyuin/stblt-check/COMMON_CODE_CACHE_REDIS.md

@@ -0,0 +1,282 @@
+# 공통코드 Redis 캐시 시스템 - DanielLee
+
+##  요구사항 검토
+
+### 1. **API를 통해 공통코드 제공** 
+- **구현 완료**: `CommonCodeApiController`에서 전체 공통코드 조회 API 제공
+  ```
+  GET /api/code
+  → 모든 공통코드 조회
+  ```
+- **추가 구현**: 캐시 갱신 및 상태 확인 API
+  ```
+  POST /api/code/cache/refresh     → 캐시 갱신
+  GET  /api/code/cache/status      → 캐시 상태 확인
+  ```
+
+---
+
+### 2. **애플리케이션 로딩시 Redis 캐시에 올리기** 
+- **구현 완료**: `CommonCodeCacheManager` 클래스 생성
+
+#### 초기화 메커니즘
+```java
+@Component
+@RequiredArgsConstructor
+public class CommonCodeCacheManager {
+
+  @EventListener(ApplicationReadyEvent.class)
+  public void initializeCommonCodeCache() {
+    // 애플리케이션 완전히 시작된 후 공통코드를 Redis에 미리 로드
+    List<Basic> allCommonCodes = commonCodeService.getFindAll();
+    // @Cacheable이 자동으로 Redis에 캐시함
+  }
+}
+```
+
+#### 동작 흐름
+1. 애플리케이션 시작
+2. Spring이 모든 Bean 생성 완료 (`ApplicationReadyEvent` 발생)
+3. `CommonCodeCacheManager.initializeCommonCodeCache()` 실행
+4. `commonCodeService.getFindAll()` 호출 (DB에서 조회)
+5. `@Cacheable(value = "commonCodes")` 에노테이션이 결과를 Redis에 저장
+
+---
+
+### 3. **공통코드 변경시 데이터 갱신** 
+
+#### 자동 갱신
+- **등록 (CREATE)**: `@CacheEvict` → 캐시 전체 삭제
+- **수정 (UPDATE)**: `@CacheEvict` → 캐시 전체 삭제
+- **삭제 (DELETE)**: `@CacheEvict` → 캐시 전체 삭제
+- **순서 변경**: `@CacheEvict` → 캐시 전체 삭제
+
+```java
+@CacheEvict(value = "commonCodes", allEntries = true)
+public ResponseObj save(CommonCodeDto.AddReq req) {
+  // 공통코드 저장
+  // ↓
+  // 캐시 전체 삭제 (다음 조회 시 DB에서 새로 로드)
+}
+```
+
+#### 수동 갱신 (관리자)
+```java
+POST /api/code/cache/refresh
+```
+- 공통코드 설정이 변경된 후 API를 호출하여 캐시를 강제 갱신
+
+#### 캐시 상태 모니터링
+```java
+GET /api/code/cache/status
+→ 응답: { "data": 150 }  // 캐시된 공통코드 150개
+```
+
+---
+
+## 전체 아키텍처
+
+```
+┌─────────────────────────────────────────────────────────┐
+│   클라이언트 요청                                         │
+└──────────────────┬──────────────────────────────────────┘
+                   │
+        ┌──────────▼──────────┐
+        │ CommonCodeApiController
+        └──────────┬──────────┘
+                   │
+         ┌─────────┴──────────┐
+         │                    │
+    ┌────▼─────┐      ┌──────▼────────────┐
+    │ 조회 API │      │ 캐시 관리 API      │
+    │ (GET)    │      │(POST, GET)         │
+    └────┬─────┘      └──────┬────────────┘
+         │                   │
+         │          ┌────────▼──────────┐
+         │          │CommonCodeCacheManager
+         │          │(캐시 초기화/갱신)  │
+         │          └────────┬──────────┘
+         │                   │
+    ┌────▼─────────────────┬─▼────┐
+    │ CommonCodeService    │      │
+    │ (@Cacheable)         │      │
+    │ (@CacheEvict)        │      │
+    └────┬──────────────────┴──────┘
+         │
+    ┌────▼──────────┐
+    │ Redis 캐시    │
+    │ (공통코드)    │
+    └────┬──────────┘
+         │
+    ┌────▼──────────┐
+    │ PostgreSQL DB │
+    │ (공통코드)    │
+    └───────────────┘
+```
+
+---
+
+## API 명세
+
+### 1. 공통코드 조회 (캐시됨)
+```
+GET /api/code
+
+응답:
+{
+  "data": [
+    {
+      "id": 1,
+      "code": "STATUS",
+      "name": "상태",
+      "description": "상태 공통코드",
+      "used": true,
+      ...
+    },
+    ...
+  ]
+}
+```
+
+### 2. 공통코드 캐시 갱신
+```
+POST /api/code/cache/refresh
+
+응답:
+{
+  "data": "공통코드 캐시가 갱신되었습니다."
+}
+```
+
+### 3. 캐시 상태 확인
+```
+GET /api/code/cache/status
+
+응답:
+{
+  "data": 150  // Redis에 캐시된 공통코드 개수
+}
+```
+
+---
+
+## 캐시 갱신 흐름
+
+### 자동 갱신 (CRUD 작업)
+```
+관리자가 공통코드 등록/수정/삭제
+        ↓
+CommonCodeService.save() / update() / removeCode()
+(@CacheEvict 실행)
+        ↓
+Redis 캐시 전체 삭제
+        ↓
+다음 조회 시 DB에서 새로 로드
+```
+
+### 수동 갱신 (API 호출)
+```
+관리자: POST /api/code/cache/refresh
+        ↓
+CommonCodeCacheManager.refreshCommonCodeCache()
+        ↓
+캐시 정리 + 새로운 데이터 로드
+        ↓
+Redis 캐시 업데이트 완료
+```
+
+---
+
+## 성능 최적화 효과
+
+| 항목 | 개선 전 | 개선 후 |
+|------|--------|--------|
+| **조회 속도** | DB 직접 조회 (10-100ms) | Redis 캐시 (1-5ms) | 
+| **DB 부하** | 매번 조회 | 캐시 미스시만 조회 |
+| **네트워크 대역폭** | 높음 (DB 왕복) | 낮음 (로컬 캐시) |
+| **응답 시간** | 변동적 | 일정 (캐시) |
+
+---
+
+## 추가 기능
+
+### CommonCodeUtil - 전역 공통코드 조회
+```java
+@Component
+public class CommonCodeUtil {
+  // 모든 공통코드 조회 (캐시 활용)
+  public List<Basic> getAllCommonCodes()
+  
+  // 특정 코드로 조회
+  public List<Basic> getCommonCodesByCode(String code)
+  
+  // ID로 단건 조회
+  public Optional<Basic> getCommonCodeById(Long id)
+  
+  // 코드명 조회
+  public Optional<String> getCodeName(String parentCode, String childCode)
+  
+  // 하위 코드 조회
+  public List<Basic> getChildCodesByParentCode(String parentCode)
+  
+  // 코드 사용 가능 여부 확인
+  public boolean isCodeAvailable(Long parentId, String code)
+}
+```
+
+### 사용 예시
+```java
+@RequiredArgsConstructor
+@RestController
+public class SomeController {
+  
+  private final CommonCodeUtil commonCodeUtil;
+  
+  @GetMapping("/example")
+  public void example() {
+    // 1. 모든 공통코드 조회 (캐시됨)
+    List<Basic> allCodes = commonCodeUtil.getAllCommonCodes();
+    
+    // 2. 특정 코드 조회
+    Optional<String> name = commonCodeUtil.getCodeName("PARENT", "CHILD");
+    
+    // 3. 코드 사용 가능 여부 확인
+    boolean available = commonCodeUtil.isCodeAvailable(1L, "NEW_CODE");
+  }
+}
+```
+
+---
+
+## 완료 체크리스트
+
+-  Redis 캐싱 어노테이션 적용 (@Cacheable, @CacheEvict)
+-  애플리케이션 로딩시 캐시 초기화
+-  CRUD 작업시 자동 캐시 갱신
+-  수동 캐시 갱신 API 제공
+-  캐시 상태 모니터링 API
+-  전역 공통코드 조회 유틸리티
+-  포괄적인 유닛 테스트 (12개)
+
+---
+
+## 모니터링
+
+캐시 상태를 주기적으로 모니터링:
+```bash
+# 캐시 상태 확인
+curl http://localhost:8080/api/code/cache/status
+
+# 캐시 갱신
+curl -X POST http://localhost:8080/api/code/cache/refresh
+```
+
+로그 확인:
+```
+=== 공통코드 캐시 초기화 시작 ===
+✓ 공통코드 150개가 Redis 캐시에 로드되었습니다.
+  - [STATUS] 상태 (ID: 1)
+  - [TYPE] 타입 (ID: 2)
+  ...
+=== 공통코드 캐시 초기화 완료 ===
+```

gukyuin/stblt-check/Dockerfile-dev

@@ -0,0 +1,29 @@
+# Stage 1: Build stage (gradle build는 Jenkins에서 이미 수행)
+FROM eclipse-temurin:21-jre-jammy
+
+# GDAL 설치
+RUN apt-get update && apt-get install -y \
+    gdal-bin \
+    libgdal-dev \
+    && rm -rf /var/lib/apt/lists/*
+
+ARG UID=1000
+ARG GID=1000
+
+RUN groupadd -g ${GID} manager01 \
+ && useradd -u ${UID} -g ${GID} -m manager01
+
+USER manager01
+
+# 작업 디렉토리 설정
+WORKDIR /app
+
+# JAR 파일 복사 (Jenkins에서 빌드된 ROOT.jar)
+COPY build/libs/ROOT.jar app.jar
+
+# 포트 노출
+EXPOSE 8080
+
+# 애플리케이션 실행
+# dev 프로파일로 실행
+ENTRYPOINT ["java", "-jar", "-Dspring.profiles.active=dev", "app.jar"]

gukyuin/stblt-check/Jenkinsfile-dev

@@ -0,0 +1,94 @@
+pipeline {
+    agent any
+    tools {
+        jdk 'jdk21'
+    }
+    environment {
+        BRANCH = 'develop'
+        GIT_REPO = 'https://10.100.0.10:3210/dabeeo/kamco-dabeeo-backoffice.git'
+    }
+
+
+    stages {
+        stage('Checkout') {
+          steps {
+            checkout([
+              $class: 'GitSCM',
+              branches: [[name: "${env.BRANCH}"]],
+              userRemoteConfigs: [[
+                url: "${env.GIT_REPO}",
+                credentialsId: 'jenkins-dev-token'
+              ]]
+            ])
+          }
+        }
+        stage('Get Commit Hash') {
+          steps {
+            script {
+              env.COMMIT_HASH = sh(script: "git rev-parse --short HEAD", returnStdout: true).trim()
+              echo "Current commit hash: ${env.COMMIT_HASH}"
+            }
+          }
+        }
+
+        stage('Build') {
+          steps {
+            sh "./gradlew clean build -x test"
+          }
+        }
+
+        stage('Docker Build & Deploy') {
+          steps {
+            script {
+              echo "Building Docker image with tag: ${env.COMMIT_HASH}"
+
+              // IMAGE_TAG 환경변수 설정 후 docker-compose로 빌드 및 배포
+              sh """
+                export IMAGE_TAG=${env.COMMIT_HASH}
+
+                # 기존 컨테이너 중지 및 제거
+                docker-compose -f docker-compose-dev.yml down || true
+
+                # 새 이미지 빌드
+                docker-compose -f docker-compose-dev.yml build
+
+                # latest 태그도 추가
+                docker tag kamco-changedetection-api:${env.COMMIT_HASH} kamco-changedetection-api:latest
+
+                # 컨테이너 시작
+                docker-compose -f docker-compose-dev.yml up -d
+              """
+
+              // 헬스체크 대기
+              echo "Waiting for application to be ready..."
+              sh """
+                for i in {1..30}; do
+                  if docker exec kamco-changedetection-api curl -f http://localhost:8080/monitor/health > /dev/null 2>&1; then
+                    echo "✅ Application is healthy!"
+                    docker-compose -f docker-compose-dev.yml ps
+                    exit 0
+                  fi
+                  echo "⏳ Waiting for application... (\$i/30)"
+                  sleep 2
+                done
+                echo "⚠️ Warning: Health check timeout, checking container status..."
+                docker-compose -f docker-compose-dev.yml ps
+              """
+            }
+          }
+        }
+
+        stage('Cleanup Old Images') {
+          steps {
+            script {
+              echo "Cleaning up old Docker images..."
+              sh """
+                # Keep latest 5 images, remove older ones
+                docker images kamco-changedetection-api --format "{{.ID}} {{.Tag}}" | \
+                  grep -v latest | tail -n +6 | awk '{print \$1}' | xargs -r docker rmi || true
+              """
+            }
+          }
+        }
+    }
+}

gukyuin/stblt-check/README.md

@@ -0,0 +1,26 @@
+# GUKYUIN STBLT CHECK
+
+> 국유인에 연동된 폴리곤의 적합여부 상태를 체크하여 업데이트 하는 schedule
+
+## 📋 프로젝트 소개
+
+**stblt-check**는 국유인에 연동된 폴리곤의 적합여부 상태를 체크하여 업데이트 하는 schedule 입니다.
+
+## 🚀 시작하기
+GukYuinApiStbltJobService 의 findGukYuinEligibleForSurvey 메소드가 매일 03:00에 schedule 실행됨
+
+```bash
+./gradlew spotlessApply
+```
+```bash
+./gradlew clean build
+```
+```bash
+Java -jar stblt-check.jar \
+```
+### 필수 요구사항
+
+- Java 21 (JDK 21)
+- PostgreSQL 12+ (PostGIS 확장 필요)
+- Gradle 8.x (또는 Gradle Wrapper 사용)
+- Docker & Docker Compose (선택사항)

gukyuin/stblt-check/build.gradle

@@ -0,0 +1,110 @@
+plugins {
+  id 'java'
+  id 'org.springframework.boot' version '3.5.7'
+  id 'io.spring.dependency-management' version '1.1.7'
+  id 'com.diffplug.spotless' version '6.25.0'
+}
+
+group = 'com.kamco.cd'
+version = '0.0.1-SNAPSHOT'
+description = 'stblt-check'
+
+java {
+  toolchain {
+    languageVersion = JavaLanguageVersion.of(21)
+  }
+}
+
+bootJar {
+    archiveFileName = "stblt-check.jar"
+}
+
+jar {
+    enabled = false   // plain.jar 안 만들기(혼동 방지)
+}
+
+configurations {
+  compileOnly {
+    extendsFrom annotationProcessor
+  }
+}
+
+repositories {
+  mavenCentral()
+  maven { url "https://repo.osgeo.org/repository/release/" }
+}
+
+dependencies {
+  implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
+  implementation 'org.springframework.boot:spring-boot-starter-web'
+  compileOnly 'org.projectlombok:lombok'
+  runtimeOnly 'org.postgresql:postgresql'
+  annotationProcessor 'org.projectlombok:lombok'
+  testImplementation 'org.springframework.boot:spring-boot-starter-test'
+  testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
+  implementation 'org.springframework.boot:spring-boot-starter-validation'
+
+  //geometry
+  implementation 'com.fasterxml.jackson.core:jackson-databind'
+  implementation "org.geotools:gt-shapefile:30.0"
+  implementation "org.geotools:gt-referencing:30.0"
+  implementation "org.geotools:gt-geojson:30.0"
+  implementation 'org.locationtech.jts.io:jts-io-common:1.20.0'
+  implementation 'org.locationtech.jts:jts-core:1.19.0'
+  implementation 'org.hibernate:hibernate-spatial:6.2.7.Final'
+  implementation 'org.geotools:gt-main:30.0'
+  implementation("org.geotools:gt-geotiff:30.0") {
+    exclude group: "javax.media", module: "jai_core"
+  }
+  implementation 'org.geotools:gt-epsg-hsql:30.0'
+
+  //  QueryDSL JPA
+  implementation 'com.querydsl:querydsl-jpa:5.0.0:jakarta'
+
+  //  Q클래스 생성용 annotationProcessor
+  annotationProcessor 'com.querydsl:querydsl-apt:5.0.0:jakarta'
+  annotationProcessor 'jakarta.annotation:jakarta.annotation-api'
+  annotationProcessor 'jakarta.persistence:jakarta.persistence-api'
+
+  // actuator
+  implementation 'org.springframework.boot:spring-boot-starter-actuator'
+
+  // Redis
+  implementation 'org.springframework.boot:spring-boot-starter-data-redis'
+
+  // SpringDoc OpenAPI (Swagger)
+  implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.7.0'
+
+  // Apache Commons Compress for archive handling
+  implementation 'org.apache.commons:commons-compress:1.26.0'
+
+  implementation 'com.fasterxml.jackson.datatype:jackson-datatype-jsr310'
+  implementation 'org.reflections:reflections:0.10.2'
+
+
+  implementation 'org.locationtech.jts:jts-core:1.19.0'
+  implementation 'org.locationtech.jts.io:jts-io-common:1.19.0'
+}
+
+configurations.configureEach {
+  exclude group: 'javax.media', module: 'jai_core'
+}
+
+tasks.named('test') {
+  useJUnitPlatform()
+}
+
+// Spotless configuration for code formatting (2-space indent)
+spotless {
+  java {
+    target 'src/**/*.java'
+    googleJavaFormat('1.19.2')  // Default Google Style = 2 spaces (NO .aosp()!)
+    trimTrailingWhitespace()
+    endWithNewline()
+  }
+}
+
+// Run spotlessCheck before build
+tasks.named('build') {
+  dependsOn 'spotlessCheck'
+}