diff --git a/README.md b/README.md
index 0d4da5b7..9a09b125 100644
--- a/README.md
+++ b/README.md
@@ -1,422 +1,266 @@
+# 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` ์ดํ๋ฆฌ์ผ์ด์
์ผ๋ก ๊ตฌ์ฑ๋์ด ์๋ค.
-
-```shell
-.
-|-- README.md
-|-- admin # ๊ด๋ฆฌ์ ์ดํ๋ฆฌ์ผ์ด์
-| |-- pom.xml
-| |-- src
-| `-- target
-|-- core # ๊ณตํต ๋ชจ๋
-| |-- pom.xml
-| |-- src
-| `-- target
-|-- front # ํ๋ก ํธ ์ดํ๋ฆฌ์ผ์ด์
-| |-- pom.xml
-| |-- src
-| `-- target
-`-- pom.xml
-`-- README.md
-```
-
-### ๊ฐ ๋ชจ๋์ ๋ด๋ถ ๊ตฌ์กฐ(ํฅ์ฌ๊ณ ๋ ์ํคํ
์ฒ ์์)
+### ๐ฆ ํฅ์ฌ๊ณ ๋ ๊ตฌ์กฐ ์์
```
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 |
-| -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** | ํ์ผ ์ ์ฅ ๋ฐฉ๋ฒ | LOCAL | Y |
-
-
-### VM Options ์์
-#### `admin`, `front` ๋ชจ๋ ์ฌ์ฉ๊ฐ๋ฅํฉ๋๋ค.
-```
--Dspring.profiles.active=local
+```bash
+-Dspring.profiles.active=prod
+-Dserver.port=8081
-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
--Djasypt.encryptor.password=ko-research (๋ณ๊ฒฝ ํ์)
+-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.storage=LOCAL
--Djasypt.encryptor.password=ko-research
--Djasypt.encryptor.algorithm=PBEWITHHMACSHA512ANDAES_256
+-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
```
-
-
-
-## DB ์ค์
-### admin
-kri DB, mms DB(๋ฌธ์ ๋ฐ์ก) ๋๊ฐ์ DB ์ปค๋ฅ์
์กด์ฌ
-
-### front
-kri DB ํ๊ฐ์ DB ์ปค๋ฅ์
์กด์ฌ
-
-datasource:
-kri:
-driver-class-name: org.postgresql.Driver
-jdbc-url: ENC(mF3Z0fgCagFruOk/F2Z2PYzXhwGedE1secfYDgci+ke9z8xFEZ/GWbgXA4XeSq5D+k9/oRLOxzwx/D24tswdoHdQugHmGb0UqrW4vGBa7YFJvcnWylOpd5ppUeEIUJGv)
-username: ENC(cNXntROGOeM115QfLlVhhBz8+qY70eTWwmwLM+7AMslWmfWTq9ZPl4pVnDopJauM)
-password: ENC(kUIzqWTu0+bqjYH4Jq9TFOOh3UwY+XVvA2OlT4VXJvxWCas66UNdGRmWDQKri5fI)
-mms:
-driver-class-name: org.postgresql.Driver
-jdbc-url: ENC(TZ7H8DIFZDbsNp3PRWbz3bkJbjsx3580ljmELMJInASgpiEH66Lb8adpjt5WGXoIdZbHetlgtEFo8F+U8XUa9fjYWNOpiZ+D99XoXJUOP3s=)
-username: ENC(cNXntROGOeM115QfLlVhhBz8+qY70eTWwmwLM+7AMslWmfWTq9ZPl4pVnDopJauM)
-password: ENC(kUIzqWTu0+bqjYH4Jq9TFOOh3UwY+XVvA2OlT4VXJvxWCas66UNdGRmWDQKri5fI)
-maximum-pool-size: 2
-minimum-idle: 1
-app.module.admin.config.application.bean.JasyptConfig
-
-
-## JDBC ๋ฐ ๋ฐ์ดํฐ ํธ๋ค๋ง ๊ตฌ์ฑ ์ต์
-
-### app.initData.core
-
-```shell
--Dapp.initData.core=true # true | false
-```
-
-## ๋ฐ์ดํฐ ํธ์ถ ๋ฐ ์๋ต ์ฒ๋ฆฌ ๋ฐฉ์ ๊ฐ์ด๋
-> 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` |
+## ๐ Jasypt ์ํธํ
-- #### ๐ฅ๏ธ ์๋ฒ ๋ ๋๋ง ๋ฐฉ์ (SSR)
-๋ชฉ๋ก ๋ฐ ์์ธ ํ๋ฉด์ SSR ๋ฐฉ์์ผ๋ก ์ฒ๋ฆฌํ ์ ์์ผ๋ฉฐ, ์ํฉ์ ๋ฐ๋ผ ์ ํ์ ์ผ๋ก ์ฌ์ฉํฉ๋๋ค.
+* DB ์ปค๋ฅ์
์ ๋ณด๋ Jasypt๋ก ์ํธํ๋์ด ์ฌ์ฉ๋ฉ๋๋ค.
+* `admin`, `front` ๋ชจ๋ ๊ฐ๊ฐ์ `JasyptConfig.java` ์ค์ ์ด ํฌํจ๋์ด ์์ต๋๋ค.
-| ๊ธฐ๋ฅ | ๋ฉ์๋ | URI | ์์ |
-|------------|--------|------------------------------|------------------------|
-| ๋ชฉ๋ก ์กฐํ | GET | `/{resource-name}/list` | `/articles/list` |
-| ์์ธ ์กฐํ | GET | `/{resource-name}/{id}` | `/articles/1` |
-
-## LOG ์์ฑ ์ต์
-
-### logging.file.path
-
-```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 # ํ์ผ ์
๋ก๋ ๊ฒฝ๋ก
+| ๋ชจ๋ | ์ฐ๊ฒฐ 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
```
-ํ์ผ ์
๋ก๋ ๊ฒฝ๋ก๊ฐ ์ง์ ๋๋ฉด ์ฌ์ฉ์๊ฐ ์
๋ก๋ํ ํ์ผ์ ์ด ๊ฒฝ๋ก๋ฅผ ๊ธฐ์ค์ผ๋ก `์ฃผ์ `/`๋
์์ผ` ํด๋ ์๋์ ์ ์ฅ๋ฉ๋๋ค.
+---
-๐ ์ accessKey ์ ๋ณด๋ ์ ๊ฐ ๋ง๋ ์์ ์ ๋ณด์ด๋ฉฐ, recycle ๋ฐ๋ชจ์ฉ์ผ๋ก๋ง ์ฌ์ฉ๋๋ ์ฐธ๊ณ ํด์ฃผ์ธ์.
-
-๐ก
-`FileUploadType`์ ํ์ผ ์
๋ก๋๊ฐ ํ์ํ ์ฃผ์ ๋๋ฉ์ธ๋ค์ด ์ ์๋ enum ๊ฐ์ฒด์
๋๋ค. ์ฌ๊ธฐ path.upload.storage ์ต์
์ ๋ฐ๋ผ ํ์ผ ์
๋ก๋ ๊ฒฝ๋ก๊ฐ ๊ฒฐ์ ๋ฉ๋๋ค.
-
-### ํ์ผ ์ฐธ์กฐ
-
-์
๋ก๋๋ ํ์ผ์ ์ฐธ์กฐ๋ ์ ์์ด์ผ ํฉ๋๋ค. `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`
-#### ์ด๋
ธํ
์ด์
์ฌ์ฉ ์์
```java
@UpdateCommand
-public void operate(UpdateCmd cmd) {
+public void update(UpdateCmd cmd) {
mapper.update(cmd);
}
```
-### 3. AOP ์ธ ์๋ ์ ์ฉ์ด ํ์ํ ๊ฒฝ์ฐ: AuditUtil ์ฌ์ฉ
-AOP ์ธ์๋, ํ๋์ DAO ๋ฉ์๋ ๋ด์์ ์ฌ๋ฌ Insert/Delete ์ฒ๋ฆฌ๊ฐ ํ์ํ ๊ฒฝ์ฐ์๋ ์๋์ฒ๋ผ ์ง์ AuditUtil์ ์ฌ์ฉํ ์ ์์ต๋๋ค.
-#### AuditUtil ์ฌ์ฉ ์์
-```java
-// ๊ด๋ฆฌ์ ๋ฑ๋ก
-mapper.insertAdmin(AuditUtil.create(cmd));
-// ๊ด๋ฆฌ์์ ์ญํ ๋งคํ
-mapper.insertAdminHasRoles(
- AuditUtil.create(new SaveAdminHasRoleParam(cmd.getSeq(), cmd.getRoleIds()))
-);
-```
+๋ณต์ ๋ฑ๋ก ๋๋ ๋ณตํฉ ๋ก์ง์ `AuditUtil.create()` ๋ฐฉ์ ์ฌ์ฉ
-### 4. XML์์ ๊ณตํต ํ๋ include๋ก ์ฌ์ฌ์ฉ
-SQL ์์ฑ ์ ๊ณตํตํ๋์ ๋ฐ๋ณต ์์ฑ์ ํผํ๊ธฐ ์ํด `` ํ๊ทธ๋ก ๋ถ๋ฆฌํ์ฌ `` ๋ฐฉ์์ผ๋ก ์ฌ์ฌ์ฉํฉ๋๋ค.
-์์ธํ ์ ์๋ `CommonFieldsMapper.xml` ํ์ผ์์ ํ์ธํ ์ ์์ต๋๋ค.
+---
-| SQL ID | ์ค๋ช
| ์ฌ์ฉ ์์ |
-| ---------------------------- | -------------------------------------- | -------------------------------------------------------------- |
-| `CreateUpdateBaseColumns` | `INSERT` ์ ๊ณตํต ์ปฌ๋ผ ์ ์ | `` |
-| `CreateUpdateBaseValues` | `INSERT` ์ ๊ณตํต ์ปฌ๋ผ์ ๊ฐ ์ ์ | `` |
-| `CreateUpdateListBaseValues` | `๋ค๊ฑด INSERT` ์ ๊ณตํต ๊ฐ ์ ์ (e.g. `foreach`) | `` |
-| `UpdateBaseSet` | `UPDATE` ์ ๊ณตํต `SET` ๊ตฌ๋ฌธ | `` |
-| `DeleteBaseSet` | `์ญ์ ์ฒ๋ฆฌ์ฉ UPDATE` ์ ๊ณตํต `SET` ๊ตฌ๋ฌธ | `` |
+## ๐ XML ๊ณตํต ํ๋ include
-#### 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)
-* `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
```
-### ์ด์์๋ฒ ๋ฐฐํฌ ์คํฌ๋ฆฝํธ
+---
-## SFTP ์ ๊ทผ
-```
-sftp๋ก ์ ์ ๊ฐ๋ฅ
-IP: 115.68.193.117
-ID: etribe
-PW: Etribe@3415
-```
-### 1. war ํ์ผ ์์ฑ
-```
-mvn clean package -P war
-```
-### 2. SFTP ํ์ผ ์
๋ก๋
-```
-/home/etribe/data/upload/tmp
-```
-### 3. putty ์ ์ : root ๊ณ์ ์ผ๋ก ๋ณ๊ฒฝ
-```
-sudo su-
-```
-### 4. war ํ์ผ ์ฎ๊ธฐ๊ธฐ
-```
-sudo mv /home/etribe/data/upload/tmp/admin/ROOT.war /opt/admin-tomcat/webapps/
-sudo mv /home/etribe/data/upload/tmp/front/ROOT.war /opt/front-tomcat/webapps/
-```
-### 5. ํ์ผ ์์ ์ ๋ณ๊ฒฝ
-```
-sudo chown -R root:root /opt/admin-tomcat
-sudo chown -R root:root /opt/front-tomcat
-```
-### 6. ๊ถํ ํ์ธ
-```
-ls -l /opt/admin-tomcat/webapps/
-ls -l /opt/front-tomcat/webapps/
-```
-### 7. ํฐ์บฃ shutdown
-```
-sudo /opt/admin-tomcat/bin/shutdown.sh
-sudo /opt/front-tomcat/bin/shutdown.sh
-or
-sudo netstat -tulnp | grep 3415
-sudo netstat -tulnp | grep 3416
-sudo kill -9
-```
-### 8. ๋ฐฐํฌ ๋์๋ ROOT ํ์ผ ๋ฐฑ์
๋ณธ์ผ๋ก
-```
-sudo mv /opt/admin-tomcat/webapps/ROOT /opt/admin-tomcat/webapps/ROOT.bak
-sudo mv /opt/front-tomcat/webapps/ROOT /opt/front-tomcat/webapps/ROOT.bak
+## ๐ 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
```
-### 9. ๊ธฐ์กด war ํ์ผ ์ญ์
-```
-rm -r /opt/admin-tomcat/webapps/ROOT.war
-rm -r /opt/front-tomcat/webapps/ROOT.war
-```
-### 10. ํฐ์บฃ start
-```
-sudo /opt/admin-tomcat/bin/startup.sh
-sudo /opt/front-tomcat/bin/startup.sh
-```
-## vm option
-```
-sudo vi /opt/admin-tomcat/bin/setenv.sh
-sudo vi /opt/front-tomcat/bin/setenv.sh
-```
\ No newline at end of file
+| ํ์ผ ์ด๋ฆ | ์ค๋ช
|
+| --------------------- | ------------ |
+| `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` |
+
+---
+
+## โ ์ค์ฌ์ง์ญ ์ค์ ์ฃผ์์ฌํญ
+
+ํ
์คํธ ๊ณ์ ๋ค์ **์ค์ฌ์ง์ญ์ด `ํ
์คํธ`๋ก ์ง์ **๋์ด ์์ต๋๋ค.
+
+> ์ด๋ก ์ธํด ํด๋น ๊ณ์ ์ผ๋ก ์์ง๋ ๋ฐ์ดํฐ๋ **ํต๊ณ์ ๋ฐ์๋์ง ์์ต๋๋ค.**
+
+**์ฃผ์:**โ ๏ธ ํต๊ณ์ ํฌํจ๋๋๋ก ํ๋ ค๋ฉด **์ค์ ์ค์ฌ์ง์ญ**์ผ๋ก ๋งคํ์ด ํ์ํฉ๋๋ค.
+
+---
+
diff --git a/docs/tomcat/admin/setenv.sh b/docs/tomcat/admin/setenv.sh
index 192b0ba3..b1d8d539 100644
--- a/docs/tomcat/admin/setenv.sh
+++ b/docs/tomcat/admin/setenv.sh
@@ -4,20 +4,12 @@
export CATALINA_OPTS="$CATALINA_OPTS \
-Dspring.profiles.active=prod \
--Dspring.sql.init.mode=never \
-Dlogging.level.org.springframework.security=DEBUG \
--Dapp.initData.core=false \
-Dfile.encoding=UTF-8 \
-Djava.net.preferIPv4Stack=true \
--Dcom.amazonaws.sdk.disableEc2Metadata=true \
-Daes.secret-key=092HW829O0A0AVR0 \
-Dpath.upload.storage=LOCAL \
-Dpath.upload.public=/home/etribe/data/upload \
-Dpath.upload.tmpdir=/home/etribe/data/upload/tmp \
--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"
diff --git a/docs/tomcat/front/setenv.sh b/docs/tomcat/front/setenv.sh
index f98a5aa4..4abeacaf 100644
--- a/docs/tomcat/front/setenv.sh
+++ b/docs/tomcat/front/setenv.sh
@@ -2,18 +2,11 @@
#export CATALINA_OPTS="$CATALINA_OPTS -Dspring.profiles.active=prod -Dapp.initData.core=false -Dspring.sql.init.mode=never -Dfile.encoding=UTF-8 -Djava.net.preferIPv4Stack=true -Dcom.amazonaws.sdk.disableEc2Metadata=true -Dlogging.level.org.springframework.security=DEBUG -Dspring.datasource.driver-class-name=org.postgresql.Driver -Dspring.datasource.url=jdbc:postgresql://115.68.193.117:5432/korea_research -Dspring.datasource.username=etribe -Dspring.datasource.password=Etribe@3415 -Daes.secret-key=092HW829O0A0AVR0 -Dpath.upload.storage=SFTP -Dpath.upload.sftp.public=/home/etribe/data/upload -Dpath.upload.sftp.tmpdir=$HOME/upload/tmpdir -Dfile.upload.sftp.ip=115.68.193.117 -Dfile.upload.sftp.id=etribe -Dfile.upload.sftp.password=Etribe@3415 -Dfile.upload.sftp.port=22"
export CATALINA_OPTS="$CATALINA_OPTS \
-Dspring.profiles.active=prod \
--Dspring.sql.init.mode=never \
-Dlogging.level.org.springframework.security=DEBUG \
--Dapp.initData.core=false \
-Dfile.encoding=UTF-8 \
-Djava.net.preferIPv4Stack=true \
--Dcom.amazonaws.sdk.disableEc2Metadata=true \
+-Dpath.upload.public=/home/etribe/data/upload \
+-Dpath.upload.tmpdir=/home/etribe/data/upload/tmp \
-Daes.secret-key=092HW829O0A0AVR0 \
--Dpath.upload.storage=SFTP \
--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"