배포용 수정

This commit is contained in:
주수현
2025-07-29 12:14:36 +09:00
parent e190cd9897
commit f37d9ecba5
14 changed files with 141 additions and 614 deletions

View File

@@ -26,7 +26,7 @@ Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
```
## 프로젝트 개요
## 프레임워크 개요
본 프로젝트는 **헥사고날 아키텍처(Ports & Adapters)** 기반의 Spring Boot 멀티모듈 시스템입니다.
도메인 로직과 외부 시스템(웹, DB, 파일 등)을 명확히 분리하여 유지보수성과 확장성을 극대화하였습니다.
@@ -39,7 +39,7 @@ of this license document, but changing it is not allowed.
## Structure
recycle 은 `core` 모듈을 기반으로 한 `admin`, `front`, `api` 어플리케이션으로 구성되어 있다.
recycle 은 `core` 모듈을 기반으로 한 `admin`, `front` 어플리케이션으로 구성되어 있다.
```shell
.
@@ -88,39 +88,25 @@ usecase/
| VM 변수 | 설명 | 설정 값 | 필수여부 |
|---------------------------------------------|---------------------------------------|-------------------------|------|
| -Dspring.profiles.active | Spring active 프로파일 | local, dev, prod | Y |
| -Dapp.initData.core | 어플리케이션 초기 구동에 필요한 필수 데이터 생성여부 | true, false | N |
| -Dspring.sql.init.mode | SQL 초기화 모드를 설정 | always, embedded, never | N |
| -Dpath.upload.public | 파일 업로드 경로 | 기본값 (~/upload/tmpdir) | N |
| -Dfile.encoding | JVM 속성 | `UTF-8` | Y |
| -Djava.net.preferIPv4Stack | JVM 속성. 클라이언트 IP체크시 IPv4 형식을 사용하기 위함. | true | Y |
| -Dlogging.level.org.springframework.security | 디버깅 레벨 | true | Y |
| -Daes.secret-key | 암호화 시크릿 키 | true | Y |
| **-Dserver.port** | 서버 포트 (없다면 기본 8080) | 원하는 port | Y |
| **-Dpath.upload.storage** | 파일 저장 방법 | jdbc 드라이버 | Y |
| **-Dpath.upload.sftp.public** | sftp 파일 경로 | jdbc url | Y |
| **-Dfile.upload.sftp.ip** | sftp 아이피 | SFTP 아이피 | Y |
| **-Dfile.upload.sftp.id** | sftp 아이디 | SFTP 사용자 | Y |
| **-Dfile.upload.sftp.password** | DB Password | SFTP 패스워드 | Y |
| **-Dfile.upload.sftp.port** | DB Port | SFTP 포트 | Y |
| **-Dpath.upload.storage** | 파일 저장 방법 | LOCAL | Y |
### VM Options 예시
#### `admin`, `front` 모두 사용가능합니다.
```
-Dspring.profiles.active=local
-Dapp.initData.core=false
-Dspring.sql.init.mode=never
-Dfile.encoding=UTF-8
-Djava.net.preferIPv4Stack=true
-Dserver.port=8081
-Dlogging.level.org.springframework.security=DEBUG
-Daes.secret-key=092HW829O0A0AVR0
-Dpath.upload.storage=LOCAL
-Dpath.upload.sftp.public=/home/etribe/data/upload
-Dfile.upload.sftp.ip=115.68.193.117
-Dfile.upload.sftp.id=etribe
-Dfile.upload.sftp.password=Etribe@3415
-Dfile.upload.sftp.port=22
-Djasypt.encryptor.password=ko-research (변경 필요)
-Djasypt.encryptor.algorithm=PBEWITHHMACSHA512ANDAES_256
@@ -167,20 +153,6 @@ app.module.admin.config.application.bean.JasyptConfig
-Dapp.initData.core=true # true | false
```
어플리케이션 초기 구동에 필요한 필수 데이터 생성여부. 공통코드, 메뉴 정보 및 개발에 필요한 기반 데이터 등이 여기에 해당한다.
InitAdminData, InitUriFrontData 등 *ApplicationRunner* 구현체에서 내용을 확인할 수 있다.
### spring.sql.init.mode
```shell
-Dspring.sql.init.mode=never # always | embedded | never
```
어플리케이션 초기 구동 시, schema.sql, data.sql 등 SQL 초기화 스크립트 실행 여부를 제어하는 설정.
* always : 애플리케이션 구동 시 항상 SQL 스크립트를 실행
* embedded : 내장 DB(H2 등)일 경우에만 실행
* never : SQL 스크립트를 실행하지 않음
## 데이터 호출 및 응답 처리 방식 가이드
> BO(Back Office)와 FO(Front Office) 화면에서는 기능에 따라 **Ajax 호출 방식**과 **서버 렌더링 방식(Server-Side Rendering, SSR)을** 구분하여 사용합니다.