# 🎯 Java-Service-Tree-Framework-Backend-Core

> A-RMS의 핵심 비즈니스 로직 및 데이터 관리 백엔드 서비스

[![Java](https://img.shields.io/badge/Java-11-orange.svg)](https://openjdk.java.net/)
[![Spring Boot](https://img.shields.io/badge/Spring%20Boot-2.3.12-brightgreen.svg)](https://spring.io/projects/spring-boot)
[![Spring Cloud](https://img.shields.io/badge/Spring%20Cloud-Hoxton.SR9-blue.svg)](https://spring.io/projects/spring-cloud)
[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)

## 📋 목차

- [프로젝트 개요](#-프로젝트-개요)
- [주요 기능](#-주요-기능)
- [기술 스택](#-기술-스택)
- [시스템 아키텍처](#-시스템-아키텍처)
- [프로젝트 구조](#-프로젝트-구조)
- [시작하기](#-시작하기)
- [API 문서](#-api-문서)
- [배포](#-배포)
- [개발 가이드](#-개발-가이드)

---

## 🎯 프로젝트 개요

**Backend-Core**는 A-RMS(Requirements Management System)의 핵심 백엔드 서비스로, 모든 비즈니스 로직, 데이터 관리, 그리고 엔터프라이즈 기능을 제공합니다.

### 핵심 역할

- 📊 **요구사항 관리**: 요구사항 생명주기 전체 관리
- 🔗 **Jira 통합**: Jira Cloud/Server 연동 및 동기화
- 📈 **분석 엔진**: 비용/시간/범위/리소스 분석
- 📄 **리포팅**: Full Data Report, SWOT 분석
- 👥 **제품/서비스 관리**: 제품 및 버전 관리
- 📝 **위키 & 블로그**: 문서 관리 시스템
- 🔐 **보안 & 인증**: Keycloak 통합 인증/인가

### 마이크로서비스 아키텍처

```
                    [Global-Config Server]
                              ↓
        ┌─────────────────────┼─────────────────────┐
        ↓                     ↓                     ↓
   [Backend-Core] ⭐    [Engine-Fire]        [Middleware-Proxy]
        ↓                     ↓                     ↓
   [MySQL DB]            [Kafka]              [API Gateway]
        ↓
   [Flyway Migration]
```

---

## ✨ 주요 기능

### 1. 요구사항 관리 (Requirement Management)

#### 요구사항 생명주기
- **요구사항 추가** (`reqadd`) - 새로운 요구사항 등록
- **요구사항 상태** (`reqstate`) - 상태 전환 관리
- **요구사항 우선순위** (`reqpriority`) - 우선순위 관리
- **요구사항 난이도** (`reqdifficulty`) - 복잡도 평가
- **요구사항 리뷰** (`reqreview`) - 검토 프로세스
- **요구사항 코멘트** (`reqcomment`) - 협업 및 논의

#### 상태 관리
- 상태 카테고리 시스템
- 상태 전환 워크플로우
- 상태 변경 이력 추적 (로그)

#### 캘린더 뷰
- 요구사항 일정 관리
- 간트 차트 통합
- 마일스톤 추적

### 2. Jira 통합

#### Jira 서버 관리
```java
- jiraserver: Jira 서버 설정 관리
- jiraserverlog: 서버 변경 이력
- jiraserver_pure: 순수 서버 데이터
- jiraserver_project_pure: 서버-프로젝트 관계
```

#### Jira 프로젝트 동기화
```java
- jiraproject: Jira 프로젝트 매핑
- jiraprojectlog: 프로젝트 변경 이력
- jiraproject_pure: 순수 프로젝트 데이터
- jiraproject_issuetype_pure: 프로젝트-이슈타입 관계
```

#### Jira 메타데이터
```java
- jiraissuetype: 이슈 타입 (Bug, Task, Story 등)
- jiraissuestatus: 이슈 상태 (To Do, In Progress, Done 등)
- jiraissuestatuscategorymap: 상태 카테고리 매핑
- jiraissuepriority: 이슈 우선순위
- jiraissueresolution: 이슈 해결책 (Fixed, Won't Fix 등)
```

### 3. 제품/서비스 관리

#### 제품 서비스 (Product Service)
```java
- pdservice: 제품 서비스 마스터
- pdservicelog: 제품 변경 이력
- pdserviceversion: 제품 버전 관리
- pdserviceversionlog: 버전 변경 이력
- pdservice_detail: 제품 상세 정보
- pdservice_pure: 순수 제품 데이터
```

**기능:**
- 제품 계층 구조 (Tree 구조)
- 버전별 요구사항 매핑
- 제품 로드맵 관리
- 릴리즈 계획

### 4. 분석 엔진

#### 4가지 분석 영역
```
api/analysis/
├── cost/       # 비용 분석
│   └── 예산 추적, ROI 계산
├── time/       # 시간 분석
│   └── 일정 준수율, 지연 분석
├── scope/      # 범위 분석
│   └── 기능 범위, 변경 관리
└── resource/   # 리소스 분석
    └── 인력 배치, 업무 부하
```

**주요 메트릭:**
- 요구사항 완료율
- 평균 해결 시간
- 우선순위 분포
- 상태별 통계

### 5. 리포팅 시스템

#### Full Data Report
```java
api/report/fulldata/
```
- 전체 요구사항 데이터 추출
- Excel/PDF 형식 지원
- 커스텀 필터링

#### 메일 리포트
```java
api/report/mail/
```
- 정기 리포트 자동 발송
- Thymeleaf 템플릿 엔진
- HTML 메일 지원

### 6. 대시보드

```java
api/dashboard/
```
**위젯:**
- 요구사항 현황판
- 진척도 차트
- 우선순위 분포
- 팀별 워크로드
- 이슈 트렌드

### 7. 글로벌 트리맵

```java
api/globaltreemap/
```
**Tree 기반 데이터 구조:**
- 계층적 데이터 관리
- 드래그 앤 드롭 재정렬
- 부모-자식 관계 관리
- 경로 탐색

### 8. 위키 & 블로그

#### 위키
```java
api/wiki/
```
- Markdown 지원
- 버전 관리
- 검색 기능

#### 블로그
```java
api/blog/
```
- 기술 블로그
- 카테고리 관리
- 태그 시스템

### 9. 백오피스 시스템

```java
api/backoffice/
├── config/       # 시스템 설정
├── information/  # 시스템 정보
└── system/       # 시스템 관리
```

**관리 기능:**
- 사용자 관리
- 권한 관리
- 시스템 설정
- 로그 모니터링

### 10. 마케팅 & 고객 관리

#### 뉴스레터
```java
api/newsletter/
```
- 구독자 관리
- 메일 발송
- 템플릿 관리

#### 고객 사례
```java
api/clientcase/
```
- 성공 사례 관리
- 레퍼런스 관리

#### 패치노트
```java
api/patchnote/
```
- 버전 릴리즈 노트
- 변경사항 공지

#### PoC (Proof of Concept)
```java
api/poc/
```
- PoC 요청 관리
- 진행 상태 추적
- 결과 보고

---

## 🔧 기술 스택

### 핵심 프레임워크

| 카테고리 | 기술 | 버전 |
|---------|------|------|
| **Language** | Java | 11 |
| **Framework** | Spring Boot | 2.3.12 |
| **Cloud** | Spring Cloud | Hoxton.SR9 |
| **Build** | Gradle | 6.9.1 |
| **Container** | Docker | Latest |

### 주요 라이브러리

#### Spring Boot Starters
```gradle
// Web & REST API
implementation 'org.springframework.boot:spring-boot-starter-web'

// AOP
implementation 'org.springframework.boot:spring-boot-starter-aop'

// Cache
implementation 'org.springframework.boot:spring-boot-starter-cache'

// Validation
implementation 'org.springframework.boot:spring-boot-starter-validation'

// Actuator
implementation 'org.springframework.boot:spring-boot-starter-actuator'

// Mail
implementation 'org.springframework.boot:spring-boot-starter-mail'

// Thymeleaf (Template Engine)
implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'
```

#### 데이터 액세스
```gradle
// JPA & Hibernate
implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
implementation 'org.hibernate:hibernate-core:5.6.15.Final'
implementation 'org.hibernate:hibernate-entitymanager:5.6.15.Final'

// MyBatis
implementation 'org.mybatis.spring.boot:mybatis-spring-boot-starter:2.3.1'

// MySQL
implementation 'mysql:mysql-connector-java:8.0.32'

// Flyway (DB Migration)
implementation 'org.flywaydb:flyway-core'

// SQL Logging
implementation 'org.bgee.log4jdbc-log4j2:log4jdbc-log4j2-jdbc4.1:1.16'
```

#### Spring Cloud
```gradle
// Config Client
implementation 'org.springframework.cloud:spring-cloud-starter-config'

// OpenFeign (MSA Communication)
implementation 'org.springframework.cloud:spring-cloud-starter-openfeign'

// Sleuth (Distributed Tracing)
implementation 'org.springframework.cloud:spring-cloud-starter-sleuth:2.2.6.RELEASE'

// Zipkin (Tracing Server)
implementation 'org.springframework.cloud:spring-cloud-sleuth-zipkin:2.2.6.RELEASE'
```

#### 보안
```gradle
// Spring Security
implementation 'org.springframework.security:spring-security-web:5.3.13.RELEASE'

// Keycloak
implementation 'org.keycloak:keycloak-spring-security-adapter:12.0.4'
```

#### 메시징 & 알림
```gradle
// Kafka
implementation 'org.springframework.kafka:spring-kafka'

// Slack API
implementation 'com.slack.api:slack-api-client:1.25.1'
```

#### 문서 처리
```gradle
// Apache POI (Excel)
implementation 'org.apache.poi:poi:5.1.0'
implementation 'org.apache.poi:poi-ooxml:5.1.0'

// HTML Parser
implementation 'org.jsoup:jsoup:1.14.3'
```

#### 유틸리티
```gradle
// ModelMapper (DTO-Entity 변환)
implementation 'org.modelmapper:modelmapper:3.1.1'

// Lombok
implementation 'org.projectlombok:lombok'

// Guava
implementation 'com.google.guava:guava:32.0.1-jre'

// Gson
implementation 'com.google.code.gson:gson:2.10.1'

// Apache Commons
implementation 'org.apache.commons:commons-lang3:3.12.0'
implementation 'org.apache.commons:commons-collections4:4.4'
implementation 'org.apache.commons:commons-text:1.10.0'
implementation 'commons-beanutils:commons-beanutils:1.9.4'
```

#### 웹 기술
```gradle
// DWR (Direct Web Remoting)
implementation '313devgrp:dwr:3.3.3'

// File Upload
implementation 'commons-fileupload:commons-fileupload:1.5'

// Email
implementation 'javax.mail:mail:1.4.7'
```

#### 테스트 & 품질
```gradle
// JUnit 5
testImplementation 'org.junit.jupiter:junit-jupiter-api:5.6.0'
testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine'

// Spring Boot Test
testImplementation 'org.springframework.boot:spring-boot-starter-test'

// Unitils
implementation 'org.unitils:unitils:2.4'
```

#### 문서화
```gradle
// Swagger
implementation 'io.springfox:springfox-boot-starter:3.0.0'
implementation 'io.springfox:springfox-swagger-ui:3.0.0'
```

#### 브라우저 자동화
```gradle
// Selenium WebDriver
implementation 'org.seleniumhq.selenium:selenium-java:4.25.0'

// WebDriver Manager
implementation 'io.github.bonigarcia:webdrivermanager:5.9.2'
```

---

## 🏗️ 시스템 아키텍처

### 계층 구조

```
┌────────────────────────────────────────┐
│         Presentation Layer             │
│    (Controller, REST API, DWR)         │
└────────────────┬───────────────────────┘
                 ↓
┌────────────────────────────────────────┐
│          Service Layer                 │
│   (Business Logic, Transaction)        │
└────────────────┬───────────────────────┘
                 ↓
┌────────────────────────────────────────┐
│       Data Access Layer                │
│      (JPA, MyBatis, DAO)               │
└────────────────┬───────────────────────┘
                 ↓
┌────────────────────────────────────────┐
│          Database Layer                │
│      (MySQL, Flyway Migration)         │
└────────────────────────────────────────┘
```

### Tree Service Framework

**핵심 개념:**
```java
// 모든 도메인 객체를 Tree 구조로 관리
public interface TreeService {
    Node addNode(Node node);
    Node getNode(Long id);
    List<Node> getChildren(Long parentId);
    void moveNode(Long nodeId, Long newParentId);
    void deleteNode(Long id);
}
```

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

### 전자정부 프레임워크 통합

```
egovframework/
├── spring/
│   ├── context-common.xml      # 공통 설정
│   ├── context-hibernate.xml   # Hibernate 설정
│   └── context-jdbc.xml         # JDBC 설정
├── mybatis/                     # MyBatis 매퍼
├── message/                     # 메시지 리소스
└── validator/                   # 검증 규칙
```

### Flyway 데이터베이스 마이그레이션

```
com/arms/db/
├── V1__init_aRMS.sql   # 초기 스키마
├── V2__init_aRMS.sql   # 2차 마이그레이션
├── ...
└── V38__init_aRMS.sql  # 최신 마이그레이션
```

**마이그레이션 전략:**
- 버전 기반 순차 적용
- 롤백 불가 (Forward Only)
- 자동 체크섬 검증
- 실행 이력 관리

---

## 📂 프로젝트 구조

```
src/main/java/com/arms/
├── Application.java                    # 메인 애플리케이션
│
├── api/                                # API 계층
│   ├── requirement/                    # ⭐ 요구사항 관리
│   │   ├── reqadd/                    # 요구사항 추가
│   │   ├── reqaddlog/                 # 요구사항 로그
│   │   ├── reqstate/                  # 요구사항 상태
│   │   ├── reqstatus/                 # 요구사항 진행상황
│   │   ├── reqpriority/               # 우선순위
│   │   ├── reqdifficulty/             # 난이도
│   │   ├── reqreview/                 # 리뷰
│   │   ├── reqcomment/                # 코멘트
│   │   └── reqstatus_calendar/        # 캘린더
│   │
│   ├── jira/                          # ⭐ Jira 통합
│   │   ├── jiraserver/                # Jira 서버 설정
│   │   ├── jiraproject/               # Jira 프로젝트
│   │   ├── jiraissuetype/             # 이슈 타입
│   │   ├── jiraissuestatus/           # 이슈 상태
│   │   ├── jiraissuepriority/         # 이슈 우선순위
│   │   └── jiraissueresolution/       # 이슈 해결책
│   │
│   ├── product_service/               # ⭐ 제품/서비스 관리
│   │   ├── pdservice/                 # 제품 서비스
│   │   ├── pdserviceversion/          # 제품 버전
│   │   ├── pdservice_detail/          # 제품 상세
│   │   └── pdservice_pure/            # 순수 제품 데이터
│   │
│   ├── analysis/                      # ⭐ 분석 엔진
│   │   ├── cost/                      # 비용 분석
│   │   ├── time/                      # 시간 분석
│   │   ├── scope/                     # 범위 분석
│   │   ├── resource/                  # 리소스 분석
│   │   └── topmenu/                   # 분석 메뉴
│   │
│   ├── dashboard/                     # 대시보드
│   ├── report/                        # 리포팅
│   │   ├── fulldata/                  # Full Data Report
│   │   └── mail/                      # 메일 리포트
│   │
│   ├── globaltreemap/                 # 글로벌 트리맵
│   ├── wiki/                          # 위키
│   ├── blog/                          # 블로그
│   ├── newsletter/                    # 뉴스레터
│   ├── clientcase/                    # 고객 사례
│   ├── patchnote/                     # 패치노트
│   ├── poc/                           # PoC 관리
│   │
│   ├── backoffice/                    # 백오피스
│   │   ├── config/                    # 시스템 설정
│   │   ├── information/               # 시스템 정보
│   │   └── system/                    # 시스템 관리
│   │
│   ├── dwralarm/                      # DWR 알람
│   │
│   └── util/                          # 유틸리티
│       ├── aes/                       # 암호화
│       ├── aspect/                    # AOP
│       ├── communicate/               # 통신
│       ├── dynamicdbmaker/            # 동적 DB 생성
│       ├── dynamicscheduler/          # 동적 스케줄러
│       ├── filerepository/            # 파일 저장소
│       ├── slack/                     # Slack 알림
│       └── model/                     # 공통 모델
│
├── config/                            # 설정 클래스
│   ├── ArmsDetailUrlConfig.java       # URL 상세 설정
│   ├── DwrConfig.java                 # DWR 설정
│   ├── JdbcConfig.java                # JDBC 설정
│   ├── KafkaConfig.java               # Kafka 설정
│   ├── MybatisConfig.java             # MyBatis 설정
│   ├── OpenFeignConfig.java           # OpenFeign 설정
│   ├── RouteTableConfig.java          # 라우팅 테이블
│   ├── SlackConfig.java               # Slack 설정
│   ├── SpringDataConfig.java          # JPA 설정
│   ├── Swagger2Config.java            # Swagger 설정
│   ├── ThreadPoolConfig.java          # 스레드 풀
│   ├── ThymeleafConfig.java           # Thymeleaf 설정
│   └── WebConfig.java                 # Web MVC 설정
│
└── egovframework/                     # 전자정부 프레임워크
    └── javaservice/
        └── treeframework/             # Tree Service Framework

src/main/resources/
├── application.yml                    # 애플리케이션 설정
├── bootstrap-dev.yml                  # 개발 환경 설정
├── bootstrap-stg.yml                  # 스테이징 환경 설정
├── bootstrap-live.yml                 # 운영 환경 설정
├── com/arms/
│   ├── db/                            # Flyway 마이그레이션
│   │   ├── V1__init_aRMS.sql
│   │   ├── V2__init_aRMS.sql
│   │   └── ...
│   └── egovframework/
│       ├── spring/                    # Spring 설정 XML
│       ├── mybatis/                   # MyBatis 매퍼
│       ├── message/                   # 메시지 리소스
│       └── validator/                 # 검증 규칙
├── dwr.xml                            # DWR 설정
├── logback/                           # 로그 설정
│   ├── logback-dev.xml
│   ├── logback-stg.xml
│   └── logback-live.xml
├── static/                            # 정적 리소스
└── templates/                         # Thymeleaf 템플릿
    ├── mail.html
    ├── chart.html
    └── poc/                           # PoC 메일 템플릿
```

---

## 🚀 시작하기

### 필수 요구사항

- ☕ **Java 11** 이상
- 🐘 **Gradle 6.9.1** 이상
- 🐬 **MySQL 8.0** 이상
- 🌍 **Global-Config Server** (실행 중)
- 🐳 **Docker** (선택사항)

### 1. Repository Clone

```bash
git clone -b dev https://github.com/313DEVGRP/Java-Service-Tree-Framework-Backend-Core.git
cd Java-Service-Tree-Framework-Backend-Core
```

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

#### MySQL 설치 및 데이터베이스 생성

```sql
-- MySQL 접속
mysql -u root -p

-- 데이터베이스 생성
CREATE DATABASE arms_dev CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- 사용자 생성 및 권한 부여
CREATE USER 'arms_user'@'%' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON arms_dev.* TO 'arms_user'@'%';
FLUSH PRIVILEGES;
```

### 3. 환경 설정

#### bootstrap-dev.yml 설정

```yaml
spring:
  cloud:
    config:
      uri: http://localhost:33133  # Global-Config Server URL
      profile: dev
      name: javaServiceTreeFrameworkBackendCore
```

#### Config Server의 설정 파일 (javaServiceTreeFrameworkBackendCore-dev.yml)

```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/arms_dev?useSSL=false&serverTimezone=Asia/Seoul
    username: arms_user
    password: your_password
    driver-class-name: com.mysql.cj.jdbc.Driver
  
  jpa:
    hibernate:
      ddl-auto: validate  # Flyway 사용으로 validate만
    show-sql: true
  
  flyway:
    enabled: true
    locations: classpath:com/arms/db
    baseline-on-migrate: true

server:
  port: 31313

# Kafka 설정 (선택사항)
spring:
  kafka:
    bootstrap-servers: localhost:9092
```

### 4. 프로파일 설정

#### IntelliJ IDEA
```
Run/Debug Configurations → Active profiles: dev
```

#### 커맨드라인
```bash
export SPRING_PROFILES_ACTIVE=dev
```

### 5. 빌드

```bash
# Gradle Wrapper 권한 (Linux/Mac)
chmod +x gradlew

# 빌드
./gradlew clean build

# 테스트 제외 빌드
./gradlew clean build -x test
```

### 6. 실행

#### 로컬 실행

```bash
# Gradle로 실행
./gradlew bootRun

# JAR로 실행
java -jar build/libs/Java-Service-Tree-Framework-Backend-Core-25.10.x.jar
```

#### Docker로 실행

```bash
# Docker 이미지 빌드
./gradlew docker

# Docker 컨테이너 실행
docker run -d \
  -p 31313:31313 \
  --name backend-core \
  -e SPRING_PROFILES_ACTIVE=dev \
  -e SPRING_DATASOURCE_URL=jdbc:mysql://host.docker.internal:3306/arms_dev \
  313.co.kr:5550/313devgrp/java-service-tree-framework-backend-core:25.10.x
```

### 7. 헬스 체크

```bash
# 서버 상태 확인
curl http://localhost:31313/actuator/health

# 응답 예시
{
  "status": "UP",
  "components": {
    "db": {
      "status": "UP",
      "details": {
        "database": "MySQL",
        "validationQuery": "isValid()"
      }
    }
  }
}
```

### 8. Swagger UI

```
http://localhost:31313/swagger-ui/
```

---

## 📖 API 문서

### 주요 API 엔드포인트

#### 요구사항 관리

| Method | Endpoint | 설명 |
|--------|----------|------|
| GET | `/api/reqadd/{id}` | 요구사항 조회 |
| POST | `/api/reqadd` | 요구사항 생성 |
| PUT | `/api/reqadd/{id}` | 요구사항 수정 |
| DELETE | `/api/reqadd/{id}` | 요구사항 삭제 |
| GET | `/api/reqadd/tree` | 요구사항 트리 조회 |
| GET | `/api/reqstatus` | 요구사항 상태 조회 |

#### Jira 통합

| Method | Endpoint | 설명 |
|--------|----------|------|
| GET | `/api/jiraserver` | Jira 서버 목록 |
| POST | `/api/jiraserver` | Jira 서버 등록 |
| GET | `/api/jiraproject` | Jira 프로젝트 목록 |
| POST | `/api/jiraproject/sync` | Jira 프로젝트 동기화 |

#### 제품/서비스 관리

| Method | Endpoint | 설명 |
|--------|----------|------|
| GET | `/api/pdservice` | 제품 서비스 목록 |
| POST | `/api/pdservice` | 제품 서비스 생성 |
| GET | `/api/pdserviceversion` | 제품 버전 목록 |
| POST | `/api/pdserviceversion` | 제품 버전 생성 |

#### 분석

| Method | Endpoint | 설명 |
|--------|----------|------|
| GET | `/api/analysis/cost` | 비용 분석 |
| GET | `/api/analysis/time` | 시간 분석 |
| GET | `/api/analysis/scope` | 범위 분석 |
| GET | `/api/analysis/resource` | 리소스 분석 |

#### 대시보드

| Method | Endpoint | 설명 |
|--------|----------|------|
| GET | `/api/dashboard/summary` | 대시보드 요약 |
| GET | `/api/dashboard/chart` | 차트 데이터 |

#### 리포트

| Method | Endpoint | 설명 |
|--------|----------|------|
| POST | `/api/report/fulldata` | Full Data Report 생성 |
| POST | `/api/report/mail` | 메일 리포트 발송 |

---

## 🐳 배포

### Docker 배포

#### 1. 이미지 빌드

```bash
# Gradle Task
./gradlew docker

# 수동 빌드
docker build -t 313devgrp/java-service-tree-framework-backend-core:25.10.x .
```

#### 2. 이미지 푸시

```bash
docker push 313.co.kr:5550/313devgrp/java-service-tree-framework-backend-core:25.10.x
```

#### 3. Docker Compose

```yaml
version: '3.8'

services:
  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: rootpass
      MYSQL_DATABASE: arms_dev
      MYSQL_USER: arms_user
      MYSQL_PASSWORD: arms_password
    ports:
      - "3306:3306"
    volumes:
      - mysql-data:/var/lib/mysql

  backend-core:
    image: 313.co.kr:5550/313devgrp/java-service-tree-framework-backend-core:25.10.x
    depends_on:
      - mysql
    ports:
      - "31313:31313"
    environment:
      SPRING_PROFILES_ACTIVE: dev
      SPRING_CLOUD_CONFIG_URI: http://global-config:33133
      SPRING_DATASOURCE_URL: jdbc:mysql://mysql:3306/arms_dev
      SPRING_DATASOURCE_USERNAME: arms_user
      SPRING_DATASOURCE_PASSWORD: arms_password

volumes:
  mysql-data:
```

```bash
docker-compose up -d
```

### Maven Repository 배포

```bash
./gradlew publish
```

---

## 👨‍💻 개발 가이드

### 코딩 컨벤션

#### 네이밍 규칙
- **클래스**: PascalCase (예: `RequirementController`)
- **메서드**: camelCase (예: `getRequirement`)
- **상수**: UPPER_SNAKE_CASE (예: `MAX_RETRY_COUNT`)
- **패키지**: lowercase (예: `com.arms.api.requirement`)

#### Tree Service 사용

```java
@Service
public class RequirementService extends TreeServiceImpl<Requirement> {
    
    // 요구사항 추가
    public Requirement addRequirement(Requirement req) {
        return addNode(req);
    }
    
    // 요구사항 트리 조회
    public List<Requirement> getRequirementTree(Long rootId) {
        return getChildrenRecursive(rootId);
    }
    
    // 요구사항 이동
    public void moveRequirement(Long reqId, Long newParentId) {
        moveNode(reqId, newParentId);
    }
}
```

### 데이터베이스 마이그레이션

#### 새 마이그레이션 파일 생성

```sql
-- V39__add_new_feature.sql
CREATE TABLE IF NOT EXISTS T_ARMS_NEW_FEATURE (
    c_id BIGINT AUTO_INCREMENT PRIMARY KEY,
    c_name VARCHAR(255) NOT NULL,
    c_created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
```

**파일명 규칙:**
- `V{버전}__설명.sql`
- 버전은 순차적으로 증가
- 밑줄 두 개(`__`)로 버전과 설명 구분

### 로깅

```java
@Slf4j
@Service
public class RequirementService {
    
    public Requirement create(RequirementDTO dto) {
        log.debug("Creating requirement: {}", dto);
        
        try {
            Requirement req = save(dto);
            log.info("Successfully created requirement: {}", req.getId());
            return req;
        } catch (Exception e) {
            log.error("Failed to create requirement", e);
            throw e;
        }
    }
}
```

---

## 🔍 문제 해결

### 1. Flyway 마이그레이션 실패

**증상:**
```
FlywayException: Validate failed: Checksum mismatch
```

**해결:**
```sql
-- Flyway 이력 확인
SELECT * FROM flyway_schema_history;

-- 문제가 있는 마이그레이션 삭제 (주의!)
DELETE FROM flyway_schema_history WHERE version = '문제버전';

-- 또는 Flyway repair
./gradlew flywayRepair
```

### 2. Config Server 연결 실패

**증상:**
```
Could not resolve placeholder 'spring.datasource.url'
```

**해결:**
```bash
# Config Server 확인
curl http://localhost:33133/javaServiceTreeFrameworkBackendCore/dev

# bootstrap.yml 확인
spring:
  cloud:
    config:
      uri: http://localhost:33133
      fail-fast: true  # 연결 실패 시 시작 중단
```

### 3. MySQL 연결 실패

**증상:**
```
Communications link failure
```

**해결:**
```bash
# MySQL 상태 확인
systemctl status mysql

# 방화벽 확인
sudo ufw allow 3306

# MySQL 설정 확인
my.cnf에서 bind-address = 0.0.0.0
```

---

## 📞 연락처

- **Maintainer**: 313DEVGRP
- **Email**: 313@313.co.kr
- **Website**: http://www.313.co.kr

---

## 📄 라이선스

Copyright © 2025 313DEVGRP. All rights reserved.

This project is licensed under the MIT License.

---

**Made with ❤️ by 313DEVGRP**

> Backend-Core는 A-RMS의 **심장부**로, 모든 비즈니스 로직과 데이터를 관리하는 핵심 서비스입니다!