diff --git a/README.md b/README.md
index 27bddca8..95a2aeed 100644
--- a/README.md
+++ b/README.md
@@ -1,404 +1,299 @@
+# KOREA-RESEARCH μμ€ν
-# KOREA-RESEARCH
+## π νλ‘μ νΈ κ°μ
+
+**KOREA-RESEARCH**λ μκ° ν¨λμ μΌκ³λΆ μμ§ λ° κ΄λ¦¬λ₯Ό μν μμ€ν
μ
λλ€.
+μ΄ μμ€ν
μ ν₯μ¬κ³ λ μν€ν
μ²(Ports & Adapters) ν¨ν΄μ μ μ©ν Spring Boot κΈ°λ°μ λ©ν°λͺ¨λ νλ μμν¬λ₯Ό κΈ°λ°μΌλ‘ νμ¬ μμ± λμμ΅λλ€.
+
+---
+
+## β
Prerequisites
+
+- JDK 17+
+- Maven
+- PostgreSQL
+
+---
+
+## π νλ‘μ νΈ κ΅¬μ‘°
```
-β¬βββββββββ¬ β¬ββββ¬ βββ
-ββ¬βββ€ β ββ¬ββ β ββ€
-β΄ββββββββ β΄ ββββ΄βββββ - framework for spring developers exploring JPA
+βββ admin # κ΄λ¦¬μ μ΄ν리μΌμ΄μ
+βββ core # κ³΅ν΅ λλ©μΈ λ° λ‘μ§
+βββ front # μ¬μ©μ μ΄ν리μΌμ΄μ
+βββ pom.xml
- _____\ _______
- / \ | /\
- /_______/ |_____/ \
- | \ / / /
- \ \ \/ /
- \ / \__/_
- \/ ____ /\
- / \ / \
- /\ \ / /
- \ \/ /
- \___\__/
-
-GNU GENERAL PUBLIC LICENSE
-Version 3, 29 June 2007
-
-Copyright (C) 2007 Free Software Foundation, Inc.
-Everyone is permitted to copy and distribute verbatim copies
-of this license document, but changing it is not allowed.
```
-## νλ‘μ νΈ κ°μ
+> λͺ¨λ μ ν리μΌμ΄μ
μ `core` λͺ¨λμ μ€μ¬μΌλ‘ ν¬νΈ, μ΄λν° κ΅¬μ‘°λ‘ κ΅¬μ±λ©λλ€.
-λ³Έ νλ‘μ νΈλ **ν₯μ¬κ³ λ μν€ν
μ²(Ports & Adapters)** κΈ°λ°μ Spring Boot λ©ν°λͺ¨λ μμ€ν
μ
λλ€.
-λλ©μΈ λ‘μ§κ³Ό μΈλΆ μμ€ν
(μΉ, DB, νμΌ λ±)μ λͺ
νν λΆλ¦¬νμ¬ μ μ§λ³΄μμ±κ³Ό νμ₯μ±μ κ·Ήλννμμ΅λλ€.
-
-## Prerequisites
-
-* JDK 17+
-* Maven
-* PostgreSQL
-
-## Structure
-
-recycle μ `core` λͺ¨λμ κΈ°λ°μΌλ‘ ν `admin`, `front`, `api` μ΄ν리μΌμ΄μ
μΌλ‘ ꡬμ±λμ΄ μλ€.
-
-```shell
-.
-|-- README.md
-|-- admin # κ΄λ¦¬μ μ΄ν리μΌμ΄μ
-| |-- pom.xml
-| |-- src
-| `-- target
-|-- core # κ³΅ν΅ λͺ¨λ
-| |-- pom.xml
-| |-- src
-| `-- target
-|-- front # νλ‘ νΈ μ΄ν리μΌμ΄μ
-| |-- pom.xml
-| |-- src
-| `-- target
-`-- pom.xml
-`-- README.md
-```
-
-β‘ AWS S3 μ
λ‘λλ₯Ό μ΄μ©νμ§ μλλ€λ©΄, pom.xml μμ `aws`λͺ¨λ κ΄λ ¨ λ΄μ©μ μμ νλ©΄ λλ€.
-β‘ `admin`, `front`, `api` μ€ μ€μ νλ‘μ νΈμμ μ¬μ©ν λͺ¨λλ§ λ¨κΈ°κ³ μμ ν΄μ£ΌμΈμ.
-
-βοΈ Dockerfile κ³Ό .gitlab-ci.yml μ μμ ν΄μ£ΌμΈμ : ) recycle demo μ©μ΄κΈ°μ μ¬λ €λΆμ νλ‘μ νΈμμλ μλ―Έκ° μμ΅λλ€.
-
-recycle μ demo κ° κΆκΈνλ€λ©΄ μλ URL μμ νμΈ ν΄μ£ΌμΈμ.
-- `recycle-admin` - https://recycle-admin.etribe.co.kr κ³μ μ 보 (recycle-super/recycle1@#$)
-- `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 λ±) μ°κ²° μ΄λν°
+βββ daily/
+βββ expense/
+βββ ports/
+β βββ application/
+β β βββ DailyExpenseService.java
+β βββ DailyExpensePortIn.java
+β βββ DailyExpensePortOut.java
+βββ adapters/
+βββ persistence/
+β βββ DailyExpenseDao.java
+βββ web/
+βββ DailyExpenseController.java
+````
-## VM Options
+---
-νλ μμν¬ μ€ν μ νμν μλ° VM μ΅μ
μ μλμ κ°λ€.
+## βοΈ VM Options
-| 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/public) | N |
-| -Dpath.upload.tmpdir | μμ νμΌ μ
λ‘λ κ²½λ‘ | κΈ°λ³Έκ° (~/upload/tmpdir) | N |
-| -Dlogging.file.path | λ‘κ·Έ νμΌ μμ± κ²½λ‘ | κΈ°λ³Έκ° (~/logs) | N |
-| -Dfile.encoding | JVM μμ± | `UTF-8` | Y |
-| -Djava.net.preferIPv4Stack | JVM μμ±. ν΄λΌμ΄μΈνΈ IP체ν¬μ IPv4 νμμ μ¬μ©νκΈ° μν¨. | true | Y |
-| -Dcom.amazonaws.sdk.disableEc2Metadata | aws λͺ¨λμ ec2 metadata μ μ‘ λκΈ° | true | N |
-| **-Dserver.port** (2023-03-25 μΆκ°) | μλ² ν¬νΈ (μλ€λ©΄ κΈ°λ³Έ 8080) | μνλ port | N |
-| **-Dserver.forward-headers-strategy** (2023-03-25 μΆκ°) | νλ‘μ μλ²(nginx, apache)μ μ μλ `X-Forward-For`, `X-Forwarded-Proto` μ€μ κ°μ μ΄μ©νλ €λ©΄ `native` λ‘ μ€μ ν΄μ£Όλ©΄ λλ€. (λ΄μ₯ 컨ν
μ΄λλ₯Ό μ¬μ©νλ κ²½μ°μλ§ μ ν¨) | `native` | N |
-| **-Dspring.datasource.driver-class-name** (2023-03-25 μΆκ°) | JDBC Driver. μλ€λ©΄ JDBC URLμ κΈ°μ€μΌλ‘ JPAκ° νλ¨νλ€. | jdbc λλΌμ΄λ² | Y |
-| **-Dspring.datasource.url** (2023-03-25 μΆκ°) | JDBC URL | jdbc url | N |
-| **-Dspring.datasource.username** (2023-03-25 μΆκ°) | DB Username | DB μ¬μ©μ | Y |
-| **-Dspring.datasource.password** (2023-03-25 μΆκ°) | DB Password | DB ν¨μ€μλ | Y |
-
-
-### VM Options μμ
-#### `admin`, `front` λͺ¨λ μ¬μ©κ°λ₯ν©λλ€.
-```
--Dspring.profiles.active=local
--Dapp.initData.core=false
--Dspring.sql.init.mode=never
+```bash
+-Dspring.profiles.active=prod
+-Dserver.port=8081
-Dfile.encoding=UTF-8
-Djava.net.preferIPv4Stack=true
--Dcom.amazonaws.sdk.disableEc2Metadata=true
--Dserver.port=8080
--Dserver.forward-headers-strategy=native
-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
--Dspring.datasource.hikari.maximum-pool-size=10
--Dspring.datasource.hikari.minimum-idle=5
--Dspring.datasource.hikari.idle-timeout=120000
--Dspring.datasource.hikari.max-lifetime=900000
--Dspring.datasource.hikari.connection-timeout=5000
--Dspring.datasource.hikari.leak-detection-threshold=30000
-```
-** μ£Όμ : μ΄μμλ²μΌ κ²½μ° vmμ΅μ
μΆκ°
--Dspring.profiles.active=prod
--Dpath.upload.storage=SFTP
+-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
+````
+## π» λ‘컬 ꡬλ μ νμ μ€μ
-## JDBC λ° λ°μ΄ν° νΈλ€λ§ κ΅¬μ± μ΅μ
+λ‘컬 νκ²½μμ ꡬλ μ μλ JVM μ΅μ
λ€μ νκ²½μ λ§κ² μ€μ ν΄ μ£ΌμΈμ
-### app.initData.core
-
-```shell
--Dapp.initData.core=true # true | false
+```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
```
-μ΄ν리μΌμ΄μ
μ΄κΈ° ꡬλμ νμν νμ λ°μ΄ν° μμ±μ¬λΆ. 곡ν΅μ½λ, λ©λ΄ μ 보 λ° κ°λ°μ νμν κΈ°λ° λ°μ΄ν° λ±μ΄ μ¬κΈ°μ ν΄λΉνλ€.
-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)μ** ꡬλΆνμ¬ μ¬μ©ν©λλ€.
-
-### BO (Back Office: κ΄λ¦¬μ νλ©΄)
-- #### π‘ Ajax νΈμΆ λ°©μ (REST API, JSON μλ΅)
-λ€μ κΈ°λ₯μ Ajaxλ₯Ό ν΅ν΄ REST API(JSON)λ₯Ό νΈμΆν©λλ€
-
-| κΈ°λ₯ | λ©μλ | URI | μμ |
-|----------|----------|------------------------------------|------------------------|
-| λͺ©λ‘ μ‘°ν | GET | `/api/{resource-name}/list` | `/api/articles/list` |
-| λ±λ‘ | POST | `/api/{resource-name}/create` | `/api/articles/create` |
-| μμ | PUT/PATCH | `/api/{resource-name}/update` | `/api/articles/update` |
-| μμ | DELETE | `/api/{resource-name}/remove` | `/api/articles/remove` |
-| λ±λ‘ & μμ |POST | `/api/{resource-name}/save` | `/api/articles/save` |
-
-
-- #### π₯οΈ μλ² λ λλ§ λ°©μ (SSR)
-μμΈ μ‘°ν(view) νλ©΄μ SSR λ°©μμΌλ‘ μ²λ¦¬ν©λλ€.
-
-| κΈ°λ₯ | λ©μλ | URI | μμ |
-|------------|--------|------------------------|---------------|
-| μμΈ μ‘°ν | GET | `/{resource-name}/{id}` | `/articles/1` |
+> π‘ `-Djasypt.encryptor.password`μ `-Djasypt.encryptor.algorithm`λ νκ²½μ λ°λΌ **μμ κ°λ₯**ν©λλ€.
---
-### FO (Front Office: μ¬μ©μ νλ©΄)
-- #### π‘ Ajax νΈμΆ λ°©μ (REST API, JSON μλ΅)
-λ€μ κΈ°λ₯μ Ajax κΈ°λ° REST API νΈμΆλ‘ μ²λ¦¬ν©λλ€.
-| κΈ°λ₯ | λ©μλ | URI | μμ |
-|------|------------|-------------------------|--------------------------|
-| λ±λ‘ | POST | `/api/{resource-name}/create` | `/api/articles/create` |
-| μμ | PUT/PATCH | `/api/{resource-name}/update` | `/api/articles/update` |
-| μμ | DELETE | `/api/{resource-name}/remove` | `/api/articles/remove` |
+## β οΈ λ‘컬 DB μ°κ²° κ΄λ ¨ μλ΄
-- #### π₯οΈ μλ² λ λλ§ λ°©μ (SSR)
-λͺ©λ‘ λ° μμΈ νλ©΄μ SSR λ°©μμΌλ‘ μ²λ¦¬ν μ μμΌλ©°, μν©μ λ°λΌ μ νμ μΌλ‘ μ¬μ©ν©λλ€.
+νμ¬ μ 곡λ DB μ€μ μ **μ΄μ μλ²μ© μ 보**λ§ ν¬ν¨λμ΄ μμ΅λλ€.
+λ‘컬 νκ²½μμ ꡬλνκΈ° μν΄μλ **λ‘컬 DB μ€μ μ λ³λλ‘ κ΅¬μ±ν΄μΌ ν©λλ€.**
-| κΈ°λ₯ | λ©μλ | URI | μμ |
-|------------|--------|------------------------------|------------------------|
-| λͺ©λ‘ μ‘°ν | GET | `/{resource-name}/list` | `/articles/list` |
-| μμΈ μ‘°ν | GET | `/{resource-name}/{id}` | `/articles/1` |
+* `application-local.yml`μ λ‘컬 DB μ μ μ 보λ₯Ό μ
λ ₯ν΄μΌ ν©λλ€.
+* μ΄μ DBμ μ§μ μ κ·Όνμ¬ κ°λ°νμ§ μλλ‘ μ£Όμκ° νμν©λλ€
+* `Jasypt`λ‘ μνΈνλ DB κ³μ μ λ³΄κ° μλ κ²½μ°, λ‘컬 λΉλ°λ²νΈ 볡νΈνλ₯Ό μν `encryptor.password`κ° λ°λμ νμν©λλ€.
-## LOG μμ± μ΅μ
+---
+## π Jasypt μνΈν
-### logging.file.path
+* DB 컀λ₯μ
μ 보λ Jasyptλ‘ μνΈνλμ΄ μ¬μ©λ©λλ€.
+* `admin`, `front` λͺ¨λ κ°κ°μ `JasyptConfig.java` μ€μ μ΄ ν¬ν¨λμ΄ μμ΅λλ€.
-```shell
--Dlogging.file.path=~/logs # κΈ°λ³Έκ° ${user.home}/logs
+```yaml
+jasypt:
+ encryptor:
+ password: # λ³λ κ΄λ¦¬
+ algorithm: # λ³λ κ΄λ¦¬
```
-λ‘κ·Έ νμΌ μμ± κ²½λ‘λ₯Ό μ§μ νλ€. μ§μ λ κ²½λ‘μ μλμ κ°μ λ‘κ·Έ νμΌμ΄ μμ±λλ€.
+μμ:
-```shell
-admin-app.log # μ΄λλ―Ό μ 체 λ‘κ·Έ
-admin-app-ERROR.log # μ΄λλ―Ό λ‘κ·Έ μ€ ERROR λΆλΆ νν°λ§
-front-app.log # νλ‘ νΈ μ 체 λ‘κ·Έ
-front-app-ERROR.log # νλ‘ νΈ λ‘κ·Έ μ€ ERROR λΆλΆ νν°λ§
+```yaml
+spring:
+ datasource:
+ kri:
+ jdbc-url: ENC(...)
+ username: ENC(...)
+ password: ENC(...)
+ mms:
+ jdbc-url: ENC(...)
+ username: ENC(...)
+ password: ENC(...)
```
-## File κ΅¬μ± μ΅μ
+---
-### νμΌ μ
λ‘λ
+## ποΈ DB ꡬμ±
-```shell
--Dpath.upload.public=~/upload/public # νμΌ μ
λ‘λ κ²½λ‘
--Dpath.upload.tmpdir=~/upload/tmpdir # tmp λλ ν 리 κ²½λ‘
+| λͺ¨λ | μ°κ²° 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
```
-νμΌ μ
λ‘λ κ²½λ‘κ° μ§μ λλ©΄ μ¬μ©μκ° μ
λ‘λν νμΌμ μ΄ κ²½λ‘λ₯Ό κΈ°μ€μΌλ‘ `μ£Όμ `/`λ
μμΌ` ν΄λ μλμ μ μ₯λ©λλ€.
-tmpdir μ μλΈλ¦Ώ 컨ν
μ΄λκ° multipart νμΌ μ
λ‘λ μ λμ©λ μ²λ¦¬λ₯Ό μν΄ μμνμΌμ μ μ₯νλ 곡κ°μ
λλ€.
+---
-νμΌ μμ€ν
μΈμ AWS S3 λ‘λ μ
λ‘λν΄μΌ νλ€λ©΄, μλ AWS CLI λ₯Ό μ΄μ©νκΈ° μν μ 보λ₯Ό μ 곡ν΄μ£Όμ΄μΌ ν©λλ€.
-
-```shell
--Dapp.aws.s3.accessKey=AKIAZF27HETWNITZBZOF # AMI μμ λ°κΈν μ¬μ©μ μμΈμ€ ν€
--Dapp.aws.s3.secretKey=IhnTG0X7Wav8ak3cbYR1l8UAjL+gbnXdWJRM11cx # AMI μμ λ°κΈν μ¬μ©μ μν¬λ¦Ώ ν€
--Dapp.aws.s3.bucketName=etribe # S3 λ²ν· μ΄λ¦
--Dapp.aws.s3.bucketFolder=/recycle/upload # S3 λ²ν· λλ ν 리
--Dapp.aws.s3.domain=dixjkmptx5pkm.cloudfront.net # S3 νΉμ cloudfront λλ©μΈ
-```
-
-π μ accessKey μ 보λ μ κ° λ§λ μμ μ 보μ΄λ©°, recycle λ°λͺ¨μ©μΌλ‘λ§ μ¬μ©λλ μ°Έκ³ ν΄μ£ΌμΈμ.
-
-π‘ recycle μ νμΌ μμ€ν
μ
λ‘λμ S3 μ
λ‘λλ₯Ό μ¬μ© λͺ©μ μ λ§κ² μ νν μ μλ μ μ°μ±μ μ 곡ν©λλ€.
-`FileUploadType`μ νμΌ μ
λ‘λκ° νμν μ£Όμ λλ©μΈλ€μ΄ μ μλ enum κ°μ²΄μ
λλ€. μ¬κΈ° κΈ°μ λ `FileStorageType` μμ±μ λ°λΌ νμΌ μ
λ‘λ κ²½λ‘κ° κ²°μ λ©λλ€.
-
-### νμΌ μ°Έμ‘°
-
-μ
λ‘λλ νμΌμ μ°Έμ‘°λ μ μμ΄μΌ ν©λλ€. `fileUrlPortIn`λ νμΌμ΄ νμΌ μμ€ν
μ μλ S3 μ μλ μ νν μ°Έμ‘° URL μ μ λ¬ν΄μ£Όλ μΈν°νμ΄μ€μ
λλ€.
+## π§© MyBatis λ€μ€ DB μ€μ μμ (`MMSDBConfig.java`)
```java
-// μ°Έμ‘° URL μ λ¬ - inline λ°©μ
-fileUrlPortIn.getInline(
- uploadFile.getType().getFileStorageType(),
- uploadFile.getPath(),
- uploadFile.getName());
-
-// μ°Έμ‘° URL μ λ¬ - attachment λ°©μ
- fileUrlPortIn.getAttachment(
- uploadFile.getType().getFileStorageType(),
- uploadFile.getId());
+@MapperScan(
+ basePackages = "app.module.mms.**.persistence",
+ sqlSessionFactoryRef = "mmsSqlSessionFactory")
```
-`inline` κ³Ό `attachment` λ μλ΅ ν€λμ content-disposition μμ± κ°μ μλ―Έν©λλ€.
-μ
λ‘λλ νμΌμ μ¬μ©μμκ² μ λ¬ν λ `inline` κ³Ό `attachment` λ λ°©μ μ€ μ건μ λ§κ² μ¬μ©νλ©΄ λ©λλ€.
+## π€ νμΌ μ
λ‘λ
-## κ³΅ν΅ νλ(Audit) μλ μ£Όμ
λ°©λ² (AOPκΈ°λ°)
-createdAt, createdBy, updatedAt, updatedBy, deletedAt, deletedBy, isDeleted μ κ°μ κ³΅ν΅ μ΄λ ₯ νλλ
-λ§€λ² μλμΌλ‘ μ€μ νμ§ μμλ λλλ‘, AOPλ₯Ό νμ©ν΄ μλμΌλ‘ μ£Όμ
λλλ‘ κ΅¬μ±νμ΅λλ€.
-
-### 1. 기본 ꡬ쑰
-create, update, delete μ Command κ°μ²΄μ AuditCommandλ₯Ό μμν©λλ€.
-#### AuditCommand μ¬μ© μμ
-``` java
-// νμ: AuditCommand μμ
-public class UpdateCmd extends AuditCommand {
- private Long seq;
- ...
-}
-```
-AuditCommandλ μλ λ©μλλ₯Ό μ 곡νλ©°, κ°κ° μμ±/μμ /μμ μμ
μ νμν νλλ₯Ό μλμΌλ‘ μ€μ ν©λλ€.
-``` java
-public class AuditCommand {
- private LocalDateTime createdAt;
- private String createdBy;
- private LocalDateTime updatedAt;
- private String updatedBy;
- private LocalDateTime deletedAt;
- private String deletedBy;
-
- public void create() { ... }
- public void update() { ... }
- public void delete() { ... }
-}
+```bash
+-Dpath.upload.public=/home/etribe/data/upload
```
-### 2. AOP κΈ°λ° μ΄λ
Έν
μ΄μ
μλ μ£Όμ
-service λλ dao λ΄μ
-@CreateCommand, @UpdateCommand, @DeleteCommand μ΄λ
Έν
μ΄μ
μ ν΅ν΄
-AOPκ° μλμΌλ‘ ν΄λΉ λ©μλμ νλΌλ―Έν°(AuditCommand μμ κ°μ²΄)μ κ³΅ν΅ νλλ₯Ό μ£Όμ
ν©λλ€.
+νμΌ μ μ₯ ꡬ쑰λ `μ£Όμ /λ
μμΌ/νμΌλͺ
`μ΄λ©°, `FileUploadType` Enumμ λ°λΌ κ²½λ‘κ° κ²°μ λ©λλ€.
-| μ΄λ
Έν
μ΄μ
| μλ μ€μ λλ νλ |
-| ---------------- | -------------------------------------------------- |
-| `@CreateCommand` | `createdAt`, `createdBy`, `updatedAt`, `updatedBy` |
-| `@UpdateCommand` | `updatedAt`, `updatedBy` |
-| `@DeleteCommand` | `updatedAt`, `updatedBy`, `deletedAt`, `deletedBy` |
+```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 operate(UpdateCmd cmd) {
- mapper.update(cmd);
+public void update(UpdateCmd cmd) {
+ mapper.update(cmd); // updatedAt, updatedBy μλ μ£Όμ
}
```
-### 3. AOP μΈ μλ μ μ©μ΄ νμν κ²½μ°: AuditUtil μ¬μ©
-AOP μΈμλ, νλμ DAO λ©μλ λ΄μμ μ¬λ¬ Insert/Delete μ²λ¦¬κ° νμν κ²½μ°μλ μλμ²λΌ μ§μ AuditUtilμ μ¬μ©ν μ μμ΅λλ€.
-#### AuditUtil μ¬μ© μμ
+```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()))
);
```
+---
-### 4. XMLμμ κ³΅ν΅ νλ includeλ‘ μ¬μ¬μ©
-SQL μμ± μ 곡ν΅νλμ λ°λ³΅ μμ±μ νΌνκΈ° μν΄ `` νκ·Έλ‘ λΆλ¦¬νμ¬ `` λ°©μμΌλ‘ μ¬μ¬μ©ν©λλ€.
-μμΈν μ μλ `CommonFieldsMapper.xml` νμΌμμ νμΈν μ μμ΅λλ€.
+## π XML κ³΅ν΅ νλ include
-| SQL ID | μ€λͺ
| μ¬μ© μμ |
-| ---------------------------- | -------------------------------------- | -------------------------------------------------------------- |
-| `CreateUpdateBaseColumns` | `INSERT` μ κ³΅ν΅ μ»¬λΌ μ μ | `` |
-| `CreateUpdateBaseValues` | `INSERT` μ κ³΅ν΅ μ»¬λΌμ κ° μ μ | `` |
-| `CreateUpdateListBaseValues` | `λ€κ±΄ INSERT` μ κ³΅ν΅ κ° μ μ (e.g. `foreach`) | `` |
-| `UpdateBaseSet` | `UPDATE` μ κ³΅ν΅ `SET` ꡬ문 | `` |
-| `DeleteBaseSet` | `μμ μ²λ¦¬μ© UPDATE` μ κ³΅ν΅ `SET` ꡬ문 | `` |
-
-#### include μ¬μ© μμ
```xml
-UPDATE household
-SET
- owner_name = #{ownerName},
- owner_age = #{ownerAge},
- tel = #{tel},
- phone = #{phone},
- region = #{region},
- city = #{city},
- address_detail = #{addressDetail},
-
-WHERE seq = ${seq}
+
```
+κ³΅ν΅ SQLμ `CommonFieldsMapper.xml` μ μ μλμ΄ μμ΅λλ€.
-## PACKAGING
+---
-λ°°ν¬λ°©μ μ€μ μ μν΄ λκ°μ§ maven νλ‘νμΌμ μ 곡νλ€.
+## π¦ ν¨ν€μ§ (WAR)
-* `jar` (default)
-* `war` Jeus, WebLogic, Tomcat λ± λ³λ μΈμ₯ 컨ν
μ΄λ μ΄μ©μ μ¬μ©
-
-maven λΉλ μ νλ‘νμΌμ μ§μ νμ§ μμΌλ©΄ κΈ°λ³Έ `jar` νλ‘νμΌλ‘ λμνκ³ , `war` μ κ²½μ° λͺ
μμ μΈ μ§μ μ΄ νμνλ€.
-
-μλλ admin λΉλμ `war` νλ‘νμΌμ μ§μ ν μμμ΄λ€.
-
-```shell
-$ mvn --projects admin --also-make clean package -DskipTests -P war
-
-# λΉλ ν, admin/target λλ ν 리μ war κ° μμ±λκ±Έ νμΈν μ μλ€.
-$ ll admin/target
--rw-r--r-- 1 user 197121 94905770 4μ 22 09:59 admin-0.0.1-SNAPSHOT.war
+```bash
+$ mvn clean package -P war
```
-## κ°λ° μλ² νκ²½
+---
-### database - postgresql 14.17
+## π API νΈμΆ λ°©μ
-```
-URL: jdbc:postgresql://15.165.180.203:5432/korea_research
-USERNAME: ko_research
-PASSWORD: koresearch1@#4
+### 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 DEPLOY
+| νμΌ μ΄λ¦ | μ€λͺ
|
+| --------------------- | ------------ |
+| `admin-app.log` | κ΄λ¦¬μ μ 체 λ‘κ·Έ |
+| `admin-app-ERROR.log` | κ΄λ¦¬μ μλ¬ μ μ© λ‘κ·Έ |
+| `front-app.log` | νλ‘ νΈ μ 체 λ‘κ·Έ |
+| `front-app-ERROR.log` | νλ‘ νΈ μλ¬ μ μ© λ‘κ·Έ |
-#### `deploy_dev_admin` λΈλ μΉλ‘ merge! pipeline μ€ν ν μλ URL μμ νμΈκ°λ₯.
-* https://ko-research-admin.etribe.co.kr
+---
-### π FRONT DEPLOY
+## β±οΈ λ°°μΉ μ€μΌμ€λ¬
+
+`AutoSchedulesController.java`μ μ μλμ΄ μμΌλ©°, μ΄ 3κ°μ λ°°μΉκ° μ‘΄μ¬ν©λλ€.
+
+| λ°°μΉλͺ
| μ€ν μ£ΌκΈ° | μ€λͺ
|
+| ----------- | ------------ | -------------------------- |
+| μλ³ μ
λ ₯ μν λ±λ‘ | λ§€μ 1μΌ 0μ 0μ΄ | μλ³ μ
λ ₯ μνλ₯Ό μ΄κΈ°ν λ±λ‘ν¨ |
+| λ¬Έμ μλ λ°μ‘ | λ§€μΌ 17μ 0λΆ | mms DBλ‘λΆν° μμ λμ μΆμΆ ν λ¬Έμ λ°μ‘ |
+| μμ΄ μ΄μκΈ λ±λ‘ | λ§€μ 16μΌ 0μ 0μ΄ | μ΄μ λ¬ λ°μ΄ν°λ₯Ό κΈ°μ€μΌλ‘ μ΄μκΈ λ±λ‘ |
+
+---
+
+## π€μ΄μμλ² ν
μ€νΈ κ³μ
+ κ³μ ID | λΉλ°λ²νΈ | κΆν |
+| ------------ | ------- | ------- |
+| `koadmin` | `0701!` | κ΄λ¦¬μ κΆν |
+| `kolocal` | `0701@` | μ§λ°©μ€μ¬ κΆν |
+| `kosearcher` | `0701#` | μ‘°μ¬μ κΆν |
+
+---
+
+## π§Ύ μ΄μμλ² μκ° κ³μ λͺ©λ‘
+
+| μκ°λ²νΈ | λΉλ°λ²νΈ |
+|---------| ------ |
+| `22221` | `1111` |
+| `22222` | `1111` |
+
+---
+
+## β μ€μ¬μ§μ μ€μ μ£Όμμ¬ν
+
+ν
μ€νΈ κ³μ λ€μ **μ€μ¬μ§μμ΄ `ν
μ€νΈ`λ‘ μ§μ **λμ΄ μμ΅λλ€.
+
+> μ΄λ‘ μΈν΄ ν΄λΉ κ³μ μΌλ‘ μμ§λ λ°μ΄ν°λ **ν΅κ³μ λ°μλμ§ μμ΅λλ€.**
+
+**μ£Όμ:**β οΈ ν΅κ³μ ν¬ν¨λλλ‘ νλ €λ©΄ **μ€μ μ€μ¬μ§μ**μΌλ‘ λ§€νμ΄ νμν©λλ€.
+
+---
-#### `deploy_dev_front` λΈλ μΉλ‘ merge! pipeline μ€ν ν μλ URL μμ νμΈκ°λ₯.
-* https://ko-research-front.etribe.co.kr
\ No newline at end of file