# SDL Base

Spring Boot 3 기반 백엔드와 Vue 3/Vite 기반 프론트엔드가 함께 있는 통합 프로젝트입니다.

## 개요

- 백엔드: Spring Boot 3.3.0, Java 17, Maven, MyBatis
- 프론트엔드: Vue 3, Vite 5, Vue Router, Vuex
- 배치: Quartz Scheduler
- 문서: `doc/` 하위 AsciiDoc/HTML 문서
- 프로필: `local`, `dev`, `prod`

## 프로젝트 구조

```text
sdl-base/
├── src/main/java/                # Spring Boot 애플리케이션, 설정, 컨트롤러, 서비스
├── src/main/resources/           # 공통 리소스, 메시지, MyBatis 매퍼
├── src/main/resources-local/     # local 프로필 설정
├── src/main/resources-dev/       # dev 프로필 설정
├── src/main/resources-prod/      # prod 프로필 설정
├── frontend/                     # Vue 3 + Vite 프론트엔드
├── doc/                          # 설치/구성/기능 문서
├── source/                       # 로컬 Maven 저장소로 참조하는 SDL 라이브러리
├── pom.xml                       # 백엔드 빌드 설정
└── plan.md                       # 작업 메모 및 환경 정보
```

## 주요 실행 흐름

1. 백엔드는 `com.samsung.SdlBaseBootApplication`에서 시작합니다.
2. `local` 프로필에서는 `config.properties`의 `datasource.*` 값을 사용해 직접 DB에 연결합니다.
3. `dev`, `prod` 프로필에서는 `db.jndi=sdl_ds` 기반 JNDI 데이터소스를 사용합니다.
4. MyBatis 매퍼는 PostgreSQL 경로인 `src/main/resources/sql/mybatis/postgresql/`를 사용합니다.
5. 프론트엔드는 `frontend/`에서 Vite로 실행하거나 빌드 산출물을 백엔드 정적 리소스로 내보냅니다.

## 실행 전 준비

### 백엔드

- Java 17 이상
- Maven 3.9 이상 또는 프로젝트 포함 `./mvnw`
- PostgreSQL 접근 가능 환경
- 필요 시 `JASYPT_KEY` 환경변수 설정

예시:

```bash
export JASYPT_KEY=your-jasypt-key
```

### 프론트엔드

- Node.js 20.14.0 이상
- npm

## 로컬 실행 방법

### 1. 프론트엔드 의존성 설치

```bash
cd frontend
npm install
```

### 2. 프론트엔드 개발 서버 실행

```bash
cd frontend
npm run local
```

- 기본 포트: `8081`
- API 대상: `http://localhost:8080`

### 3. 백엔드 실행

프로젝트 루트에서 실행합니다.

```bash
./mvnw spring-boot:run -Plocal
```

또는 IDE에서 `com.samsung.SdlBaseBootApplication`을 Spring Boot Application으로 실행하면 됩니다.

## 빌드 방법

### 백엔드 빌드

```bash
./mvnw clean package
```

### 프론트엔드 운영 빌드

```bash
cd frontend
npm run build
```

기본 운영 빌드 결과물은 `frontend/.env.production`의 `VITE_DIST_PATH` 설정에 따라 백엔드 웹 리소스 경로로 출력됩니다.

## 프로필별 설정 파일

- `src/main/resources-local/application.properties`
- `src/main/resources-local/config.properties`
- `src/main/resources-dev/application.properties`
- `src/main/resources-dev/config.properties`
- `src/main/resources-prod/application.properties`
- `src/main/resources-prod/config.properties`

## DB 연결 정보

`plan.md` 기준으로 현재 반영된 PostgreSQL 정보는 다음과 같습니다.

- DBMS: PostgreSQL
- 호스트: `192.168.0.60`
- 포트: `5432`
- 데이터베이스: `casaos`
- 사용자: `casaos`
- 비밀번호: `casaos`

적용 위치:

- 로컬 메인 데이터소스: `src/main/resources-local/config.properties`
- Quartz 데이터소스: `src/main/resources-dev/application.properties`
- Quartz 데이터소스: `src/main/resources-prod/application.properties`

## 참고 문서

- 설치 문서: `doc/설치/로컬설치.adoc`
- Quartz 문서: `doc/Appendix/QuartzClustering.adoc`
- 전체 문서 인덱스: `doc/index.html`

## 확인 메모

- 현재 백엔드 MyBatis 설정은 PostgreSQL 매퍼 경로를 사용하도록 정리했습니다.
- `dev`, `prod`는 애플리케이션 메인 데이터소스를 JNDI로 조회하므로 WAS/JNDI 설정도 별도로 맞아야 합니다.
