# KOREA-RESEARCH μ‹œμŠ€ν…œ ## πŸ“Œ ν”„λ‘œμ νŠΈ κ°œμš” **KOREA-RESEARCH**λŠ” **ν—₯사고날 μ•„ν‚€ν…μ²˜(Ports & Adapters)** 기반의 Spring Boot λ©€ν‹°λͺ¨λ“ˆ μ‹œμŠ€ν…œμž…λ‹ˆλ‹€. 도메인 둜직과 μ™ΈλΆ€ μ˜μ‘΄μ„±μ„ λͺ…ν™•νžˆ λΆ„λ¦¬ν•˜μ—¬ **μœ μ§€λ³΄μˆ˜μ„±κ³Ό ν™•μž₯μ„±**을 κ·ΉλŒ€ν™”ν•˜μ˜€μŠ΅λ‹ˆλ‹€. --- ## βœ… Prerequisites - JDK 17+ - Maven - PostgreSQL --- ## πŸ“‚ ν”„λ‘œμ νŠΈ ꡬ쑰 ``` β”œβ”€β”€ admin # κ΄€λ¦¬μž μ–΄ν”Œλ¦¬μΌ€μ΄μ…˜ β”œβ”€β”€ core # 곡톡 도메인 및 둜직 β”œβ”€β”€ front # μ‚¬μš©μž μ–΄ν”Œλ¦¬μΌ€μ΄μ…˜ └── pom.xml ``` > λͺ¨λ“  μ• ν”Œλ¦¬μΌ€μ΄μ…˜μ€ `core` λͺ¨λ“ˆμ„ μ€‘μ‹¬μœΌλ‘œ μœ μ¦ˆμΌ€μ΄μŠ€, 포트, μ–΄λŒ‘ν„° ꡬ쑰둜 κ΅¬μ„±λ©λ‹ˆλ‹€. ### πŸ“¦ ν—₯사고날 ꡬ쑰 μ˜ˆμ‹œ ``` usecase/ └── daily/ └── expense/ β”œβ”€β”€ ports/ β”‚ β”œβ”€β”€ application/ β”‚ β”‚ └── DailyExpenseService.java β”‚ β”œβ”€β”€ DailyExpensePortIn.java β”‚ └── DailyExpensePortOut.java └── adapters/ β”œβ”€β”€ persistence/ β”‚ └── DailyExpenseDao.java └── web/ └── DailyExpenseController.java ```` --- ## βš™οΈ VM Options ```bash -Dspring.profiles.active=prod -Dserver.port=8081 -Dfile.encoding=UTF-8 -Djava.net.preferIPv4Stack=true -Dlogging.level.org.springframework.security=DEBUG -Daes.secret-key=092HW829O0A0AVR0 -Dpath.upload.storage=LOCAL -Dpath.upload.public=/home/etribe/data/upload -Dpath.upload.tmpdir=/home/etribe/data/upload/tmp -Djasypt.encryptor.password=ko-research -Djasypt.encryptor.algorithm=PBEWITHHMACSHA512ANDAES_256 ```` ## πŸ’» 둜컬 ꡬ동 μ‹œ ν•„μˆ˜ μ„€μ • 둜컬 ν™˜κ²½μ—μ„œ ꡬ동 μ‹œ μ•„λž˜ JVM μ˜΅μ…˜λ“€μ„ μ„€μ •ν•΄ μ£Όμ„Έμš”: ```bash -Dspring.profiles.active=local -Dpath.upload.public=/home/etribe/data/upload -Dpath.upload.tmpdir=/home/etribe/data/upload/tmp -Djasypt.encryptor.password=ko-research -Djasypt.encryptor.algorithm=PBEWITHHMACSHA512ANDAES_256 ``` > πŸ’‘ `-Djasypt.encryptor.password`와 `-Djasypt.encryptor.algorithm`λŠ” ν™˜κ²½μ— 따라 **μˆ˜μ • κ°€λŠ₯**ν•©λ‹ˆλ‹€. --- ## πŸ” Jasypt μ•”ν˜Έν™” * DB 컀λ„₯μ…˜ μ •λ³΄λŠ” Jasypt둜 μ•”ν˜Έν™”λ˜μ–΄ μ‚¬μš©λ©λ‹ˆλ‹€. * `admin`, `front` λͺ¨λ“ˆ 각각에 `JasyptConfig.java` 섀정이 ν¬ν•¨λ˜μ–΄ μžˆμŠ΅λ‹ˆλ‹€. ```yaml jasypt: encryptor: password: # 별도 관리 algorithm: # 별도 관리 ``` μ˜ˆμ‹œ: ```yaml spring: datasource: kri: jdbc-url: ENC(...) username: ENC(...) password: ENC(...) mms: jdbc-url: ENC(...) username: ENC(...) password: ENC(...) ``` --- ## πŸ—ƒοΈ DB ꡬ성 | λͺ¨λ“ˆ | μ—°κ²° DB | | ------- | ----------------------- | | `admin` | kri DB, mms DB (문자 λ°œμ†‘μš©) | | `front` | kri DB | --- ## πŸ”„ 닀쀑 DB μ„€μ • (admin) * `admin` λͺ¨λ“ˆμ—λŠ” `MMSDBConfig.java`λ₯Ό ν†΅ν•œ **mms μ „μš© DataSource** 섀정이 μžˆμŠ΅λ‹ˆλ‹€. * MyBatis λ§€νΌλŠ” 별도 μœ„μΉ˜λ‘œ κ΅¬λΆ„λ©λ‹ˆλ‹€. ```yaml mybatis: mapper-locations: kri: classpath*:mappers/**/*Mapper.xml mms: classpath*:mappers/mms/*Mapper.xml configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl ``` --- ## 🧩 MyBatis 닀쀑 DB μ„€μ • μ˜ˆμ‹œ (`MMSDBConfig.java`) ```java @MapperScan( basePackages = "app.module.mms.**.persistence", sqlSessionFactoryRef = "mmsSqlSessionFactory") ``` ## πŸ“€ 파일 μ—…λ‘œλ“œ ```bash -Dpath.upload.public=/home/etribe/data/upload ``` 파일 μ €μž₯ κ΅¬μ‘°λŠ” `주제/년월일/파일λͺ…`이며, `FileUploadType` Enum에 따라 κ²½λ‘œκ°€ κ²°μ •λ©λ‹ˆλ‹€. ```java fileUrlPortIn.getInline(type, path, name); fileUrlPortIn.getAttachment(type, id); ``` --- ## 🧾 Audit 곡톡 ν•„λ“œ μžλ™ μ£Όμž… * AOP 기반 μžλ™ μ£Όμž… λ°©μ‹μœΌλ‘œ 생성/μˆ˜μ •/μ‚­μ œ μ‹œ ν•„λ“œ λ°˜λ³΅μ„ μ΅œμ†Œν™”ν•©λ‹ˆλ‹€. * 곡톡 ν•„λ“œ: `createdAt`, `createdBy`, `updatedAt`, `updatedBy`, `deletedAt`, `deletedBy`, `isDeleted` | μ–΄λ…Έν…Œμ΄μ…˜ | μ£Όμž… ν•„λ“œ | | ---------------- | ------------------------------------------ | | `@CreateCommand` | createdAt, createdBy, updatedAt, updatedBy | | `@UpdateCommand` | updatedAt, updatedBy | | `@DeleteCommand` | deletedAt, deletedBy | ### βœ… κΈ°λ³Έ μ‚¬μš©λ²• λͺ¨λ“  CommandλŠ” AuditCommandλ₯Ό μƒμ†ν•˜κ³ , Service/DAO λ©”μ„œλ“œμ— μ–΄λ…Έν…Œμ΄μ…˜λ§Œ 뢙이면 μžλ™μœΌλ‘œ ν•„λ“œμ— 값이 μ£Όμž…λ©λ‹ˆλ‹€. ```java @UpdateCommand public void update(UpdateCmd cmd) { mapper.update(cmd); // updatedAt, updatedBy μžλ™ μ£Όμž… } ``` ```java public class UpdateCmd extends AuditCommand { private Long seq; } ``` ### βœ… 볡합적인 CRUD 처리 μ‹œ ν•˜λ‚˜μ˜ 둜직 μ•ˆμ—μ„œ insert, update, delete λ“± μ—¬λŸ¬ DB μž‘μ—…μ΄ ν•¨κ»˜ μ²˜λ¦¬λ˜λŠ” 경우, `AuditUtil`의 μœ ν‹Έ λ©”μ„œλ“œλ₯Ό μ‚¬μš©ν•©λ‹ˆλ‹€. ```java // κ΄€λ¦¬μž 등둝 mapper.insertAdmin(AuditUtil.create(cmd)); // κ΄€λ¦¬μž μ—­ν•  λ§€ν•‘ (닀건) mapper.insertAdminHasRoles( AuditUtil.create(new SaveAdminHasRoleParam(cmd.getSeq(), cmd.getRoleIds())) ); ``` --- ## πŸ” XML 곡톡 ν•„λ“œ include ```xml ``` 곡톡 SQL은 `CommonFieldsMapper.xml` 에 μ •μ˜λ˜μ–΄ μžˆμŠ΅λ‹ˆλ‹€. --- ## πŸ“¦ νŒ¨ν‚€μ§• (WAR) ```bash $ mvn clean package -P war ``` --- ## πŸ”Œ API 호좜 방식 ### BO (κ΄€λ¦¬μž) | κΈ°λŠ₯ | 방식 | URI μ˜ˆμ‹œ | | ------- | ---- | -------------------------------------- | | λͺ©λ‘/등둝 λ“± | Ajax | `/api/household/daily/list`, `/save` λ“± | | 상세 쑰회 | SSR | `/household/{id}` | ### FO (μ‚¬μš©μž) | κΈ°λŠ₯ | 방식 | URI μ˜ˆμ‹œ | | -------- | ---- | -------------------------------------------------------- | | 등둝/μˆ˜μ •/μ‚­μ œ | Ajax | `/api/record/income/{searchMonth}/{groupNo}/form/{id}` λ“± | | λͺ©λ‘/상세 쑰회 | SSR | `/record/income/{searchMonth}/{groupNo}`, `/form/{id}` λ“± | --- ## πŸ“‹ 둜그 μ„€μ • ```bash -Dlogging.file.path=~/logs ``` | 파일 이름 | μ„€λͺ… | | --------------------- | ------------ | | `admin-app.log` | κ΄€λ¦¬μž 전체 둜그 | | `admin-app-ERROR.log` | κ΄€λ¦¬μž μ—λŸ¬ μ „μš© 둜그 | | `front-app.log` | ν”„λ‘ νŠΈ 전체 둜그 | | `front-app-ERROR.log` | ν”„λ‘ νŠΈ μ—λŸ¬ μ „μš© 둜그 | --- ## ⏱️ 배치 μŠ€μΌ€μ€„λŸ¬ `AutoSchedulesController.java`에 μ •μ˜λ˜μ–΄ 있으며, 총 3개의 λ°°μΉ˜κ°€ μ‘΄μž¬ν•©λ‹ˆλ‹€. | 배치λͺ… | μ‹€ν–‰ μ£ΌκΈ° | μ„€λͺ… | | ----------- | ------------ | -------------------------- | | 월별 μž…λ ₯ μƒνƒœ 등둝 | λ§€μ›” 1일 0μ‹œ 0초 | 월별 μž…λ ₯ μƒνƒœλ₯Ό μ΄ˆκΈ°ν™” 등둝함 | | 문자 μžλ™ λ°œμ†‘ | 맀일 17μ‹œ 0λΆ„ | mms DBλ‘œλΆ€ν„° μˆ˜μ‹  λŒ€μƒ μΆ”μΆœ ν›„ 문자 λ°œμ†‘ | | μ›”μ΄ˆ μ΄μ›”κΈˆ 등둝 | λ§€μ›” 16일 0μ‹œ 0초 | 이전 달 데이터λ₯Ό κΈ°μ€€μœΌλ‘œ μ΄μ›”κΈˆ 등둝 | --- ## πŸ‘€ ν…ŒμŠ€νŠΈ 계정 계정 ID | λΉ„λ°€λ²ˆν˜Έ | κΆŒν•œ | | ------------ | ------- | ------- | | `koadmin` | `0701!` | κ΄€λ¦¬μž κΆŒν•œ | | `kolocal` | `0701@` | 지방싀사 κΆŒν•œ | | `kosearcher` | `0701#` | 쑰사원 κΆŒν•œ | --- ## 🧾 μž„κ°€ 계정 λͺ©λ‘ | κ°€κ΅¬λ²ˆν˜Έ | λΉ„λ°€λ²ˆν˜Έ | | ------- | ------ | | `22221` | `1111` | | `22222` | `1111` | --- ## ❗ 싀사지역 μ„€μ • μ£Όμ˜μ‚¬ν•­ ν…ŒμŠ€νŠΈ 계정듀은 **싀사지역이 `ν…ŒμŠ€νŠΈ`둜 μ§€μ •**λ˜μ–΄ μžˆμŠ΅λ‹ˆλ‹€. > 이둜 인해 ν•΄λ‹Ή κ³„μ •μœΌλ‘œ μˆ˜μ§‘λœ λ°μ΄ν„°λŠ” **톡계에 λ°˜μ˜λ˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€.** **주의:**⚠️ 톡계에 ν¬ν•¨λ˜λ„λ‘ ν•˜λ €λ©΄ **μ‹€μ œ 싀사지역**으둜 맀핑이 ν•„μš”ν•©λ‹ˆλ‹€. ---