📊 Java-Service-Tree-Framework-Backend-Core 프로젝트 분석
🎯 프로젝트 개요
Java-Service-Tree-Framework-Backend-Core는 A-RMS(Requirements Management System)의 핵심 백엔드 서비스로, 요구사항 관리, Jira 통합, 제품/서비스 관리를 중심으로 하는 엔터프라이즈급 마이크로서비스 애플리케이션입니다.
주요 특징

트리 기반 아키텍처: 모든 도메인 데이터를 계층적 트리 구조로 관리
Jira 통합: Jira Cloud/Server와의 완전한 양방향 동기화
마이크로서비스 아키텍처: Spring Cloud 기반 분산 시스템
전자정부 프레임워크 통합: 한국 공공기관 표준 준수


🏗️ 아키텍처 분석
1. 계층 구조
   ┌─────────────────────────────────────────┐
   │     Presentation Layer                  │
   │  • REST Controllers                     │
   │  • DWR Remote Services                  │
   │  • Swagger API Documentation            │
   └──────────────┬──────────────────────────┘
   ↓
   ┌─────────────────────────────────────────┐
   │     Business Logic Layer                │
   │  • Tree Service Framework               │
   │  • Domain Services                      │
   │  • Transaction Management               │
   └──────────────┬──────────────────────────┘
   ↓
   ┌─────────────────────────────────────────┐
   │     Data Access Layer                   │
   │  • Spring Data JPA                      │
   │  • MyBatis (Complex Queries)            │
   │  • Hibernate ORM                        │
   └──────────────┬──────────────────────────┘
   ↓
   ┌─────────────────────────────────────────┐
   │     Infrastructure Layer                │
   │  • MySQL Database                       │
   │  • Flyway Migration                     │
   │  • Config Server Integration            │
   └─────────────────────────────────────────┘
2. 핵심 기술 스택
   분류기술버전용도LanguageJava11주 개발 언어FrameworkSpring Boot2.3.12애플리케이션 프레임워크CloudSpring CloudHoxton.SR9마이크로서비스 관리ORMHibernate5.6.15객체-관계 매핑ORMMyBatis2.3.1복잡한 SQL 쿼리DatabaseMySQL8.0.32주 데이터베이스MigrationFlyway6.4.4DB 스키마 버전 관리BuildGradle6.9.1빌드 자동화ContainerDockerLatest컨테이너화

📦 모듈 구조 분석
1. 요구사항 관리 모듈 (Requirement)
   api/requirement/
   ├── reqadd/              # 요구사항 추가
   ├── reqaddlog/           # 요구사항 로그
   ├── reqadd_pure/         # 순수 요구사항 데이터
   ├── reqadd_state_pure/   # 요구사항-상태 관계
   ├── reqstate/            # 요구사항 상태 관리
   ├── reqstate_category/   # 상태 카테고리
   ├── reqstatus/           # 요구사항 진행 상태
   ├── reqstatus_calendar/  # 캘린더 뷰
   ├── reqpriority/         # 우선순위
   ├── reqdifficulty/       # 난이도
   ├── reqreview/           # 리뷰 프로세스
   ├── reqreviewcomment/    # 리뷰 코멘트
   ├── reqcomment/          # 일반 코멘트
   └── *log/                # 변경 이력 추적
   특징:

완전한 요구사항 생명주기 관리
이력 추적(Audit) 기능 내장
Tree 구조로 계층적 요구사항 표현
상태 전환 워크플로우 지원

2. Jira 통합 모듈 (Jira Integration)
   api/jira/
   ├── jiraserver/                    # Jira 서버 설정
   ├── jiraserver_pure/               # 순수 서버 데이터
   ├── jiraserver_project_pure/       # 서버-프로젝트 관계
   ├── jiraproject/                   # Jira 프로젝트 매핑
   ├── jiraproject_pure/              # 순수 프로젝트 데이터
   ├── jiraproject_issuetype_pure/    # 프로젝트-이슈타입 관계
   ├── jiraissuetype/                 # 이슈 타입
   ├── jiraissuestatus/               # 이슈 상태
   ├── jiraissuestatuscategorymap/    # 상태-카테고리 매핑
   ├── jiraissuepriority/             # 이슈 우선순위
   ├── jiraissueresolution/           # 이슈 해결책
   └── *log/                          # Jira 동기화 로그
   특징:

Jira Cloud/Server 모두 지원
메타데이터 완전 동기화
양방향 데이터 매핑
실시간 동기화 로그

3. 제품/서비스 관리 모듈 (Product Service)
   api/product_service/
   ├── pdservice/           # 제품 서비스 마스터
   ├── pdservicelog/        # 제품 변경 이력
   ├── pdserviceversion/    # 제품 버전 관리
   ├── pdserviceversionlog/ # 버전 변경 이력
   ├── pdservice_detail/    # 제품 상세 정보
   └── pdservice_pure/      # 순수 제품 데이터
   특징:

제품 계층 구조(Tree)
버전별 요구사항 매핑
릴리즈 계획 관리
제품 로드맵 지원

4. 분석 엔진 (Analysis)
   api/analysis/
   ├── cost/       # 비용 분석 (예산, ROI)
   ├── time/       # 시간 분석 (일정 준수율, 지연)
   ├── scope/      # 범위 분석 (기능 범위, 변경)
   ├── resource/   # 리소스 분석 (인력, 업무 부하)
   └── topmenu/    # 분석 메뉴 관리
   특징:

4가지 분석 차원 제공
실시간 메트릭 계산
차트 데이터 생성
대시보드 연동

5. 리포팅 & 대시보드
   api/report/
   ├── fulldata/   # Full Data Report (Excel/PDF)
   └── mail/       # 메일 리포트 (자동 발송)

api/dashboard/  # 실시간 대시보드 위젯
6. 백오피스 & 유틸리티
   api/backoffice/
   ├── config/       # 시스템 설정
   ├── information/  # 시스템 정보
   └── system/       # 시스템 관리

api/util/
├── aes/                # 암호화/복호화
├── aspect/             # AOP 공통 관심사
├── communicate/        # 타 서비스 통신
├── dynamicdbmaker/     # 동적 DB 생성
├── dynamicscheduler/   # 동적 스케줄러
├── filerepository/     # 파일 저장소
├── slack/              # Slack 알림
└── model/              # 공통 모델

🔧 주요 설정 및 인프라
1. Spring Cloud 통합
   java// Config Server Client
   spring.cloud.config.uri=http://global-config:33133

// OpenFeign (MSA 간 통신)
@EnableFeignClients

// Sleuth + Zipkin (분산 트레이싱)
spring.cloud.sleuth.enabled=true
spring.zipkin.base-url=http://zipkin:9411
2. 보안 설정
   java// Keycloak 통합 인증/인가
   keycloak.auth-server-url=https://keycloak.example.com/auth
   keycloak.realm=arms-realm
   keycloak.resource=backend-core

// Spring Security
@EnableWebSecurity
```

### 3. 데이터베이스 설정

**이중 ORM 전략:**
- **JPA/Hibernate**: 단순 CRUD, 엔티티 관리
- **MyBatis**: 복잡한 조인, 통계 쿼리, 성능 최적화

**Flyway 마이그레이션:**
```
resources/com/arms/db/
├── V1__init_aRMS.sql
├── V2__init_aRMS.sql
├── ...
└── V38__init_aRMS.sql
4. 메시징 & 알림
   java// Kafka (이벤트 스트리밍)
   spring.kafka.bootstrap-servers=localhost:9092

// Slack (알림)
slack.api.token=xoxb-...
slack.channel=#arms-notifications

// Email (리포팅)
spring.mail.host=smtp.gmail.com
5. 모니터링 & 관찰성
   java// Actuator (헬스체크, 메트릭)
   management.endpoints.web.exposure.include=*

// Micrometer (메트릭 수집)
management.metrics.export.prometheus.enabled=true

// Sleuth + Zipkin (분산 트레이싱)
spring.sleuth.sampler.probability=1.0

🎨 디자인 패턴 및 아키텍처 특징
1. Tree Service Framework
   핵심 개념:
   프로젝트의 모든 도메인 객체를 트리 구조로 관리하는 독자적인 프레임워크
   java// 예시 구조
   public interface TreeService<T extends TreeNode> {
   T addNode(T node);
   T getNode(Long id);
   List<T> getChildren(Long parentId);
   List<T> getChildrenRecursive(Long nodeId);
   void moveNode(Long nodeId, Long newParentId);
   void deleteNode(Long id);
   }
```

**장점:**
- 계층적 데이터의 자연스러운 표현
- 부모-자식 관계 명확화
- 경로 탐색 용이
- 드래그 앤 드롭 UI 구현 간편

### 2. 로그 테이블 패턴

모든 주요 엔티티에 대해 `*log` 테이블을 생성하여 변경 이력 추적:
```
reqadd      → reqaddlog
jiraserver  → jiraserverlog
pdservice   → pdservicelog
```

**이점:**
- 완전한 감사 추적(Audit Trail)
- 변경 이력 조회
- 복원 가능성
- 규정 준수(Compliance)

### 3. Pure 데이터 패턴

`*_pure` 접미사를 가진 테이블로 외부 시스템(Jira 등)의 원본 데이터 저장:
```
jiraserver_pure
jiraproject_pure
reqadd_pure
```

**목적:**
- 원본 데이터 보존
- 매핑 데이터와 분리
- 동기화 검증
- 데이터 무결성

### 4. 전자정부 프레임워크 통합
```
egovframework/
├── spring/
│   ├── context-common.xml
│   ├── context-hibernate.xml
│   └── context-jdbc.xml
├── mybatis/
├── message/
└── validator/
한국 공공기관 표준 준수로 정부 프로젝트 적용 가능

🚀 배포 및 운영
Docker 배포
bash# 이미지 빌드
./gradlew docker

# 컨테이너 실행
docker run -d \
-p 31313:31313 \
--name backend-core \
-e SPRING_PROFILES_ACTIVE=dev \
313.co.kr:5550/313devgrp/java-service-tree-framework-backend-core:25.11.x
Maven Repository 배포
bash# Nexus Repository에 배포
./gradlew publish
환경별 설정

개발(dev): bootstrap-dev.yml
스테이징(stg): bootstrap-stg.yml
운영(live): bootstrap-live.yml


📊 코드 품질 및 의존성
의존성 통계

총 의존성: 약 250개 라이브러리
Spring 관련: 60+
데이터 액세스: 20+
보안: 10+
유틸리티: 30+
테스트: 15+

주요 의존성 카테고리

Spring Ecosystem (60+)

Spring Boot, Cloud, Data, Security, Kafka


데이터 처리 (20+)

Hibernate, MyBatis, MySQL, Flyway


통합 & 통신 (15+)

OpenFeign, Kafka, Slack API, Selenium


문서 & 리포팅 (10+)

Apache POI, Thymeleaf, Swagger


보안 & 인증 (10+)

Keycloak, Spring Security, Bouncy Castle




💡 핵심 강점
1. 확장 가능한 트리 아키텍처

계층적 데이터를 자연스럽게 표현
복잡한 요구사항 구조화 가능
유연한 데이터 모델링

2. 완벽한 Jira 통합

Cloud/Server 모두 지원
양방향 동기화
메타데이터 완전 매핑

3. 엔터프라이즈급 기능

분석 엔진 (비용, 시간, 범위, 리소스)
리포팅 시스템
대시보드
백오피스

4. 마이크로서비스 아키텍처

Spring Cloud 기반
Config Server 통합
분산 트레이싱
이벤트 기반 통신

5. 운영 안정성

Flyway 데이터베이스 마이그레이션
완전한 이력 추적
헬스체크 및 모니터링
Docker 컨테이너화

6. 한국 표준 준수

전자정부 프레임워크 통합
공공기관 적용 가능


🔍 개선 제안 사항
1. 테스트 커버리지

단위 테스트 확대 필요
통합 테스트 강화
E2E 테스트 추가

2. 문서화

API 문서 자동화 (Swagger 활용)
아키텍처 다이어그램 추가
개발자 가이드 보완

3. 성능 최적화

쿼리 최적화
캐싱 전략 개선
비동기 처리 확대

4. 보안 강화

API 인증/인가 강화
민감 데이터 암호화
보안 스캔 자동화

5. 모니터링

로그 집중화 (ELK Stack)
APM 도구 통합
알림 규칙 정의


📚 결론
Java-Service-Tree-Framework-Backend-Core는 요구사항 관리 시스템의 핵심 백엔드로서 다음과 같은 특징을 가진 성숙한 엔터프라이즈 애플리케이션입니다:
✅ 아키텍처: 트리 기반의 독창적인 설계로 계층적 데이터 관리에 최적화
✅ 통합성: Jira, Kafka, Slack 등 주요 도구들과의 완벽한 통합
✅ 확장성: 마이크로서비스 아키텍처로 수평 확장 가능
✅ 안정성: Flyway 마이그레이션, 이력 추적, 모니터링 등 운영 안정성 확보
✅ 표준 준수: 전자정부 프레임워크 통합으로 공공기관 적용 가능
현재 버전 25.11.x는 프로덕션 레디 상태이며, 지속적인 개선과 기능 추가가 이루어지고 있는 활발한 프로젝트입니다.