# 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 -Dspring.sql.init.mode=never -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`λŠ” ν™˜κ²½μ— 따라 **μˆ˜μ • κ°€λŠ₯**ν•©λ‹ˆλ‹€. --- ## ⚠️ 둜컬 DB μ—°κ²° κ΄€λ ¨ μ•ˆλ‚΄ ν˜„μž¬ 제곡된 DB 섀정은 **운영 μ„œλ²„μš© 정보**만 ν¬ν•¨λ˜μ–΄ μžˆμŠ΅λ‹ˆλ‹€. 둜컬 ν™˜κ²½μ—μ„œ κ΅¬λ™ν•˜κΈ° μœ„ν•΄μ„œλŠ” **둜컬 DB 섀정을 λ³„λ„λ‘œ ꡬ성해야 ν•©λ‹ˆλ‹€.** * `application-local.yml`에 둜컬 DB 접속 정보λ₯Ό μž…λ ₯ν•΄μ•Ό ν•©λ‹ˆλ‹€. * 운영 DB에 직접 μ ‘κ·Όν•˜μ—¬ κ°œλ°œν•˜μ§€ μ•Šλ„λ‘ μ£Όμ˜κ°€ ν•„μš”ν•©λ‹ˆλ‹€ * `Jasypt`둜 μ•”ν˜Έν™”λœ DB 계정 정보가 μžˆλŠ” 경우, 둜컬 λΉ„λ°€λ²ˆν˜Έ λ³΅ν˜Έν™”λ₯Ό μœ„ν•œ `encryptor.password`κ°€ λ°˜λ“œμ‹œ ν•„μš”ν•©λ‹ˆλ‹€. -- λ‹€μŒμ€ `-Dspring.sql.init.mode=always` μ˜΅μ…˜ κ΄€λ ¨ λ‚΄μš©μ„ **μΈμˆ˜μΈκ³„ λ¬Έμ„œ** ν˜•μ‹μœΌλ‘œ μ •λ¦¬ν•œ μ˜ˆμ‹œμž…λ‹ˆλ‹€. 운영 ν™˜κ²½μ—μ„œμ˜ μœ„ν—˜μ„±κΉŒμ§€ κ°•μ‘°ν•΄μ„œ μž‘μ„±ν–ˆμŠ΅λ‹ˆλ‹€. --- ## βš™οΈ 둜컬 DB μ΄ˆκΈ°ν™” 및 `initData` 적용 방법 ### βœ… Spring Boot ν”„λ‘œμ νŠΈμ—μ„œλŠ” `initData` SQL 슀크립트λ₯Ό 톡해 둜컬 DB에 초기 데이터λ₯Ό μ‚½μž…ν•  수 μžˆμŠ΅λ‹ˆλ‹€. 이λ₯Ό μœ„ν•΄ **VM μ˜΅μ…˜ 섀정이 λ°˜λ“œμ‹œ ν•„μš”**ν•©λ‹ˆλ‹€. --- ### πŸ› οΈ 적용 방법 1. **VM μ˜΅μ…˜ μΆ”κ°€** ``` -Dspring.sql.init.mode=always ``` 2. **μ„œλ²„ μž¬κΈ°λ™** * μœ„ μ˜΅μ…˜μ„ μ μš©ν•˜κ³  μ„œλ²„λ₯Ό μž¬κΈ°λ™ν•˜λ©΄ λ‹€μŒκ³Ό 같은 λ™μž‘μ΄ μˆ˜ν–‰λ©λ‹ˆλ‹€: * **λͺ¨λ“  ν…Œμ΄λΈ” DROP** * **μŠ€ν‚€λ§ˆ μž¬μƒμ„± (CREATE)** * **`01.init-data.sql` λ“±μ˜ μ΄ˆκΈ°ν™” SQL μ‹€ν–‰** 3. **μ΄ˆκΈ°ν™” μ™„λ£Œ ν›„ ν•„μˆ˜ μž‘μ—…β€ΌοΈ** ``` VM μ˜΅μ…˜μ„ λ°˜λ“œμ‹œ μ•„λž˜μ™€ 같이 λ³€κ²½: -Dspring.sql.init.mode=never ``` * 계속 `always` μƒνƒœλ‘œ 두면, μ„œλ²„ 기동 μ‹œλ§ˆλ‹€ 데이터가 **λͺ¨λ‘ μ‚­μ œλ¨** ⚠️⚠️⚠️ --- ### ⚠️ 운영 ν™˜κ²½ μ£Όμ˜μ‚¬ν•­ > πŸ’₯ **운영 μ„œλ²„μ—λŠ” μ ˆλŒ€ `-Dspring.sql.init.mode=always` 섀정을 μ‚¬μš©ν•˜μ§€ λ§ˆμ„Έμš”!!** > 이 섀정은 λͺ¨λ“  ν…Œμ΄λΈ”κ³Ό 데이터λ₯Ό μ œκ±°ν•˜κ³  λ‹€μ‹œ μƒμ„±ν•˜λ―€λ‘œ, > 운영 DB에 적용 μ‹œ **치λͺ…적인 데이터 손싀**이 λ°œμƒν•  수 μžˆμŠ΅λ‹ˆλ‹€. --- ### ℹ️ μ˜΅μ…˜ μ„€λͺ… | μ˜΅μ…˜κ°’ | μ„€λͺ… | | -------- | ----------------------------- | | `never` | SQL μ΄ˆκΈ°ν™” 슀크립트 **μ‹€ν–‰ν•˜μ§€ μ•ŠμŒ** (κΈ°λ³Έ) | | `always` | SQL μ΄ˆκΈ°ν™” 슀크립트 **항상 싀행함** | --- ### πŸ“ μ΄ˆκΈ°ν™” 슀크립트 μœ„μΉ˜ μ˜ˆμ‹œ * `core/src/main/resources/sql/schema/02_create-table.sql` (DDL) * `core/src/main/resources/sql/schema/02_create-function.sql` (DDL) * `core/src/main/resources/sql/schema/02_create-view.sql` (DDL) * `core/src/main/resources/sql/data/01_init_data.sql` (DML) --- --- ## πŸ” 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") ``` ## πŸ”§ 일계뢀 등둝 κ°€λŠ₯ λ‚ μ§œ `DailyRecordConstants.java`λŠ” **일계뢀 등둝 및 μˆ˜μ • κ°€λŠ₯ μ‹œμ μ— λŒ€ν•œ μ •μ±… μƒμˆ˜**λ₯Ό μ •μ˜ν•˜κ³  μžˆμŠ΅λ‹ˆλ‹€. --- ### βœ… μ •μ±… μ •μ˜ | ν•­λͺ© | μ •μ±… μ„€λͺ… | μƒμˆ˜λͺ… | κ°’ | | ------- | ------------------------ | ---------------------- |------------------------| | 등둝 κ°€λŠ₯ μ›” | ν•΄λ‹Ή μ›” κΈ°μ€€, **이전 μ›”λ§Œ 등둝 κ°€λŠ₯** | `REGISTER_LIMIT_MONTH` | `1` β†’ *μž„μ‹œλ‘œ `4` μ„€μ • 쀑* | | 등둝 κ°€λŠ₯ 일 | ν•΄λ‹Ή μ›” **15μΌκΉŒμ§€λ§Œ 등둝 κ°€λŠ₯** | `REGISTER_LIMIT_DAY` | `15` β†’ *μž„μ‹œλ‘œ `31` μ„€μ • 쀑* | | μˆ˜μ • κ°€λŠ₯ μ›” | ν•΄λ‹Ή μ›” κΈ°μ€€, **이전 μ›”λ§Œ μˆ˜μ • κ°€λŠ₯** | `MODIFY_LIMIT_MONTH` | `1` β†’ *μž„μ‹œλ‘œ `4` μ„€μ • 쀑* | | μˆ˜μ • κ°€λŠ₯ 일 | ν•΄λ‹Ή μ›” **15μΌκΉŒμ§€λ§Œ μˆ˜μ • κ°€λŠ₯** | `MODIFY_LIMIT_DAY` | `15` β†’ *μž„μ‹œλ‘œ `31` μ„€μ • 쀑* | --- ### ⚠️ ν˜„μž¬ μž„μ‹œ μ„€μ • 사항 ν˜„μž¬ μ‹œμŠ€ν…œμ—μ„œλŠ” **등둝 κ°€λŠ₯ μ›”(`REGISTER_LIMIT_MONTH`)** 및 **μˆ˜μ • κ°€λŠ₯ μ›”(`MODIFY_LIMIT_MONTH`)** 값을 **μž„μ‹œλ‘œ `4달` **등둝 κ°€λŠ₯ 일(`REGISTER_LIMIT_DAY`)** 및 **μˆ˜μ • κ°€λŠ₯ 일(`MODIFY_LIMIT_DAY`)** 값을 **μž„μ‹œλ‘œ `31일`둜 μ„€μ •**ν•΄ λ‘μ—ˆμœΌλ©°, **정책상 μ›λž˜λŠ” `15일`둜 μ œν•œ**λ˜μ–΄μ•Ό ν•©λ‹ˆλ‹€. > πŸ“Œ ν–₯ν›„ 운영 정책에 따라 **`이전월`** **`15일`둜 볡원 μ˜ˆμ •**으둜 ν•΄λ‹Ήκ°’μœΌλ‘œ μˆ˜μ •ν•œ war파일 제곡 --- ## πŸ“€ 파일 μ—…λ‘œλ“œ ```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` | | `22223` | `1111` | | `22224` | `1111` | | `22225` | `1111` | | `22226` | `1111` | --- ## ❗ 싀사지역 μ„€μ • μ£Όμ˜μ‚¬ν•­ ν…ŒμŠ€νŠΈ 계정듀은 **싀사지역이 `ν…ŒμŠ€νŠΈ`둜 μ§€μ •**λ˜μ–΄ μžˆμŠ΅λ‹ˆλ‹€. > 이둜 인해 ν•΄λ‹Ή κ³„μ •μœΌλ‘œ μˆ˜μ§‘λœ λ°μ΄ν„°λŠ” **톡계에 λ°˜μ˜λ˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€.** **주의:**⚠️ 톡계에 ν¬ν•¨λ˜λ„λ‘ ν•˜λ €λ©΄ **μ‹€μ œ 싀사지역**으둜 맀핑이 ν•„μš”ν•©λ‹ˆλ‹€. ---