Merge branch 'refs/heads/dev' into first_open_fetch

# Conflicts:
#	core/src/test/java/app/module/core/common/util/AESEncryptUtilTest.java
This commit is contained in:
주수현
2025-07-21 10:11:56 +09:00
1593 changed files with 21739 additions and 47968 deletions

View File

@@ -26,6 +26,11 @@ Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
```
## 프로젝트 개요
본 프로젝트는 **헥사고날 아키텍처(Ports & Adapters)** 기반의 Spring Boot 멀티모듈 시스템입니다.
도메인 로직과 외부 시스템(웹, DB, 파일 등)을 명확히 분리하여 유지보수성과 확장성을 극대화하였습니다.
## Prerequisites
* JDK 17+
@@ -43,14 +48,6 @@ recycle 은 `core` 모듈을 기반으로 한 `admin`, `front`, `api` 어플리
| |-- pom.xml
| |-- src
| `-- target
|-- api # API 모듈 (JWT 토큰 기반 인증)
| |-- pom.xml
| |-- src
| `-- target
|-- aws # AWS 서비스 전략(strategy) 모듈
| |-- pom.xml
| |-- src
| `-- target
|-- core # 공통 모듈
| |-- pom.xml
| |-- src
@@ -60,6 +57,7 @@ recycle 은 `core` 모듈을 기반으로 한 `admin`, `front`, `api` 어플리
| |-- src
| `-- target
`-- pom.xml
`-- README.md
```
⚡ AWS S3 업로드를 이용하지 않는다면, pom.xml 에서 `aws`모듈 관련 내용을 삭제하면 된다.
@@ -72,6 +70,26 @@ recycle 의 demo 가 궁금하다면 아래 URL 에서 확인 해주세요.
- `recycle-api` - https://recycle-api.etribe.co.kr/swagger-ui/index.html
- `recycle-front` - https://recycle-front.etribe.co.kr/ 계정정보 (generalUser/generalUser1@#$)
### 각 모듈의 내부 구조(헥사고날 아키텍처 예시)
```
usecase/
└── daily/
└── expense/
├── ports/
│ ├── application/
│ │ └── DailyExpenseService.java
│ ├── DailyExpensePortIn.java
│ └── DailyExpensePortOut.java
└── adapters/
├── persistence/
│ └── DailyExpenseDao.java
└── web/
└── DailyExpenseController.java
```
- **ports/**: 도메인 서비스 및 인터페이스(Port)
- **adapters/**: 외부 시스템(웹, DB 등) 연결 어댑터
## VM Options
@@ -97,7 +115,7 @@ recycle 의 demo 가 궁금하다면 아래 URL 에서 확인 해주세요.
### VM Options 예시
#### `admin`, `front`, `api` 모두 사용가능합니다.
#### `admin`, `front` 모두 사용가능합니다.
```
-Dspring.profiles.active=local
-Dapp.initData.core=false
@@ -108,14 +126,9 @@ recycle 의 demo 가 궁금하다면 아래 URL 에서 확인 해주세요.
-Dserver.port=8080
-Dserver.forward-headers-strategy=native
-Dlogging.level.org.springframework.security=DEBUG
-Dspring.datasource.driver-class-name=org.postgresql.Driver
-Dspring.datasource.url=jdbc:postgresql://15.165.180.203:5432/korea_research
-Dspring.datasource.username=ko_research
-Dspring.datasource.password=koresearch1@#4
-Daes.secret-key=092HW829O0A0AVR0
-Dpath.upload.storage=LOCAL
-Dpath.upload.sftp.public=/home/etribe/data/upload
-Dpath.upload.sftp.tmpdir=${user.home}/upload/tmpdir
-Dfile.upload.sftp.ip=115.68.193.117
-Dfile.upload.sftp.id=etribe
-Dfile.upload.sftp.password=Etribe@3415
@@ -127,8 +140,11 @@ recycle 의 demo 가 궁금하다면 아래 URL 에서 확인 해주세요.
-Dspring.datasource.hikari.connection-timeout=5000
-Dspring.datasource.hikari.leak-detection-threshold=30000
```
** 주의 : 운영서버일 경우 -Dpath.upload.storage=SFTP로 설정
** 주의 : 운영서버일 경우 vm옵션 추가
-Dspring.profiles.active=prod
-Dpath.upload.storage=SFTP
-Djasypt.encryptor.password=ko-research
-Djasypt.encryptor.algorithm=PBEWITHHMACSHA512ANDAES_256
## JDBC 및 데이터 핸들링 구성 옵션