diff --git a/README.md b/README.md
index ab43a1b..df33643 100644
--- a/README.md
+++ b/README.md
@@ -1,13 +1,10 @@
# ๐ ํ๊น?
-## ํ๋ก์ ํธ ์๊ฐ
-- [ํ๊น?-ํด์ปคํค](https://github.com/Kernel360/hackathon2-talkka)์ ์ด์ ํ๋ก์ ํธ
-- ์ถํด๊ทผ์๊ฐ ๋ด๊ฐ ํ๋ ค๋ ๋ฒ์ค์ ์ข์๋ ๋ช๊ฐ๋ ๋จ์์์๊น?
-- [๊ณต๊ณต๋ฐ์ดํฐํฌํธ](https://www.data.go.kr/index.do)์์ ๋ฒ์ค ์ ๋ณด๋ฅผ ์ ๊ณต๋ฐ์ ์ค์๊ฐ ๋์ฐฉ์ ๋ณด์ ๋จ์ ์ข์๊ฐ์ ํต๊ณ ๋ฐ ์์ธก์ ์ ๊ณตํ๋ ์๋น์ค์
๋๋ค.
-
-
+- [ํ๊น? - ํด์ปคํค](https://github.com/Kernel360/hackathon2-talkka)์ ์ด์ ํ๋ก์ ํธ
+- [๊ณต๊ณต ๋ฐ์ดํฐํฌํธ](https://www.data.go.kr/index.do)์์ Open API๋ฅผ ํตํด ์์งํ ๋ฐ์ดํฐ๋ก **๋จ์ ์ข์์ ํต๊ณ ๋ฐ ์์ธก** ๋ฐ์ดํฐ๋ฅผ ์ ๊ณต ํ๋ ์๋น์ค์
๋๋ค.
## ํ์ ์๊ฐ
+
-
+## ํ๋ก์ ํธ ์๊ฐ
+
+### ๋์ค๋ค์ด ๊ฒช๋ ํ์ค
+
+
+
+- 2022๋
์ํ๋ `๊ด์ญ๋ฒ์ค ์
์ ๊ธ์ง์ ๋`๋ก ์ธํด ๋ง์ ์๋ฏผ๋ค์ด ๋ถํธํจ์ ๊ฒช๊ณ ์์ต๋๋ค.
+
+- ์ผ๋ฐ์ ์ผ๋ก ์ฌ์ฉ๋๋ ์ ํ๋ฆฌ์ผ์ด์
์์๋ **์ค์๊ฐ ๋์ฐฉ์ ๋ณด ๋ฐ์ดํฐ**๋ฅผ ์ ๊ณตํ๋ฉฐ ํน์ ํ ์ ๋ฅ์๋ก ๋์ฐฉํ๊ณ ์๋ ๋ฒ์ค์ **๋จ์ ์ข์ ์ ๋ณด**๋ฅผ ๋ณผ ์ ์์ต๋๋ค.
ํ์ง๋ง ์
์ ๊ธ์ง์ ๋๊ฐ ์ํ๋ ์ดํ ํด๋น
+ ์ ๋ฅ์ฅ์ ๊ฐ๋๋ผ๋ **๊ธด ๋๊ธฐ ์ค**๋ก ์ธํด ๋ฒ์ค๋ฅผ ํ์ง ๋ชปํ๋ ์ํฉ์ด ๋ฐ์ํ๊ณ ์์ต๋๋ค.
+
+- ์ฐ๋ฆฌ์ ์๋น์ค๋ ์ด๋ฐ ๋ฌธ์ ๋ฅผ ํด๊ฒฐํ๊ธฐ ์ํด ๊ธฐํ๋์์ต๋๋ค.
+
+### ์ด๋ป๊ฒ ํด๊ฒฐํ ๊ฒ์ธ๊ฐ?
+
+
+
+- ๋์ค๊ตํต์ ๊ฒฝ์ฐ **์ด๋ํ ์ ์๋ ๊ฒฝ๋ก๊ฐ ๋ค์**ํฉ๋๋ค.
๋ง์ฝ ๋ด๊ฐ ๊ฒฝ๋ก 1์ ํ์ฌ ์ํฉ์ ์๊ณ ์๊ณ ์ด๋ํ๊ธฐ ์ด๋ ต๋ค ํ๋จ๋๋ค๋ฉด ๊ฒฝ๋ก 2๋ก ๋ณ๊ฒฝํ ์ ์์ต๋๋ค.
+
+- ํ์ง๋ง, ์ค์ ๋ก๋ ํด๋น ์ ๋ฅ์ฅ์ ์ํฉ์ด ์ด๋ค์ง **์ค์๊ฐ์ผ๋ก ํ๋จ**ํ๊ธฐ ์ด๋ ต์ต๋๋ค.
+
+- ์ฐ๋ฆฌ๋ ์ด ๋ฌธ์ ๋ฅผ ํด๊ฒฐํ๊ธฐ ์ํด **๊ณผ๊ฑฐ์ ๋ฐ์ดํฐ๋ฅผ ์์ง**ํ์ฌ ์ฌ์ฉ์์๊ฒ **ํน์ ์๊ฐ๋์ ๋จ์ ์ข์ ์ถ์ด**๋ฅผ ์ ๊ณตํ๊ธฐ๋ก ๊ฒฐ์ ํ์์ต๋๋ค.
+ - ์ฌ์ฉ์๋ ์ ๊ณต๋๋ ๋ฐ์ดํฐ๋ฅผ ํตํด ํน์ ์๊ฐ๋์ ์ด๋ค ์ ๋ฅ์ฅ์์ ์ด๋ค ๋ฒ์ค๋ฅผ ํ์ผ ์ข ๋ ์พ์ ํ๊ฒ ์ด๋ํ ์ ์์์ง๋ฅผ ํ๋จํ ์ ์์ต๋๋ค.
+
+## ๋ฐ์ดํฐ ๊ฐ๊ณต ๋ฐฉ์
+
+### ์์ธํ ์ ๋ณด
+
+- [์๋น์ค ๊ณ ๋ฏผ๋ค by wiki](https://github.com/Kernel360/E2E2-TALKKA/wiki/%EC%84%9C%EB%B9%84%EC%8A%A4-%EA%B3%A0%EB%AF%BC%EB%93%A4)
+
+### ๊ฐ๋ตํ ์ค๋ช
+
+- [์ค์๊ฐ ์์น์ ๋ณด ์กฐํ](https://www.data.go.kr/data/15080648/openapi.do)์์ ์ ๊ณตํ๋ ๋ฐ์ดํฐ๋ฅผ **3๋ถ ๊ฐ๊ฒฉ**์ผ๋ก ์์งํฉ๋๋ค.
+ - ํด๋น ๋ฐ์ดํฐ๋ ํน์ ๋
ธ์ (ex: 3200๋ฒ ๋ฒ์ค)์ ๋ํด ์ ์ฒด ๊ฒฝ์ ์ ๋ฅ์ฅ์ ๋ณด์ฌ์ฃผ๋ฉฐ ๊ฐ ๋ฒ์ค๋ค์ด ์ด๋ ์์น์ ์๋์ง๋ฅผ ์ ๊ณตํฉ๋๋ค.
+- API ํธ์ถ ํ์ ์ ํ์ผ๋ก ์ธํด ์ฐ๋ฆฌ๋ **๋ถ๋น๋ ์๊ฐ๋(์ถ๊ทผ ์ , ํด๊ทผ ํ, ์ผ๊ทผ ํ)์** ๋ฐ์ดํฐ๋ฅผ ํ๋ฃจ ๋์ ์์งํ ํ **AM 03:00์ ํด๋น ๋ฐ์ดํฐ๋ฅผ ๊ฐ๊ณต**ํฉ๋๋ค.
+- ๋ฐ์ดํฐ ๊ฐ๊ณต์ 1์ฐจ์ ์ผ๋ก **ํน์ ๋
ธ์ ์ ๋ํด ๊ฐ ์ฐจ๋(ex: ๊ฒฝ๊ธฐ12๊ฐ3456)์ผ๋ก ๋ถ๋ฆฌ**ํ๋ฉฐ ์ดํ **๋ถ๋ฆฌ ๋ ์ฐจ๋๋ณ ๋ฐ์ดํฐ์์ ์ ๋ฅ์ฅ๋ณ ์ข์ ์ ์ ์ฅ**ํฉ๋๋ค.
+ - ์ ์ฅ ๋ ๋ฐ์ดํฐ๋ฅผ ๊ธฐ๋ฐ์ผ๋ก ํน์ ์๊ฐ๋์ ํน์ ์ ๋ฅ์ฅ์ ์ง๋๋ ๋ฒ์ค ๋
ธ์ ์ ๋ํ ์ข์ ์ ์ถ์ด, ๋ฒ์ค ๋์ฐฉ ์๊ฐ ์ถ์ด๋ฅผ ์ ๊ณตํ ์ ์์ต๋๋ค.
+- ๋ํ [์ค์๊ฐ ๋์ฐฉ์ ๋ณด](https://www.data.go.kr/data/15080346/openapi.do)์ ์ข์์์ ๊ฐ๊ณต๋ ๊ณผ๊ฑฐ ๋ฐ์ดํฐ๋ฅผ ๋น๊ตํ์ฌ **์์ ์ข์ ์๋ฅผ ๊ณ์ฐ**ํ ์ ์์ต๋๋ค.
## ๊ธฐ๋ฅ
+
### ํ์๊ฐ์
๋ฐ ๋ก๊ทธ์ธ
+
@@ -62,10 +98,10 @@
- ๋น๋ก๊ทธ์ธ ์ํ์์ ๋ฒ์ค-์ ๊ฑฐ์ฅ ์ ๋ณด ์กฐํ
- ์ค์๊ฐ ๋ฒ์ค ๋์ฐฉ์ ๋ณด ์ ๊ณต
- - ์ต๋ 2๊ฐ ๋ฒ์ค๊น์ง ๋์ฐฉ์ ๋ณด ์ ๊ณต
+ - ์ต๋ 2๊ฐ ๋ฒ์ค๊น์ง ๋์ฐฉ์ ๋ณด ์ ๊ณต
- ์ ํํ ๋ฒ์ค์ ๋ํ ํต๊ณ ๋ฐ ์์ธก ์ ๊ณต
- - ๊ณผ๊ฑฐ ๊ฐ์ ์์ผ(์ต๋ 5์ฃผ์ ๊น์ง) ์๊ฐ๋๋ณ ๋จ์ ์ข์ ํต๊ณ ์ ๊ณต
- - ๊ณผ๊ฑฐ ํต๊ณ ๋ฐ์ดํฐ๋ฅผ ๋ฐํ์ผ๋ก ํ์ฌ ๋์ฐฉ์์ ๋ฒ์ค์ ๋จ์์ข์ ์์ธก ์ ๊ณต
+ - ๊ณผ๊ฑฐ ๊ฐ์ ์์ผ(์ต๋ 5์ฃผ์ ๊น์ง) ์๊ฐ๋๋ณ ๋จ์ ์ข์ ํต๊ณ ์ ๊ณต
+ - ๊ณผ๊ฑฐ ํต๊ณ ๋ฐ์ดํฐ๋ฅผ ๋ฐํ์ผ๋ก ํ์ฌ ๋์ฐฉ์์ ๋ฒ์ค์ ๋จ์์ข์ ์์ธก ์ ๊ณต
@@ -73,8 +109,8 @@
-
### ๋ฒ์ค ๋ถ๋งํฌ
+
@@ -83,12 +119,12 @@
- ๋ถ๋งํฌ์ ์ฌ๋ฌ๊ฐ์ ๋ฒ์ค ๋ฑ๋ก ๊ฐ๋ฅ
- - ex) ์ถ๊ทผ๊ธธ : 7800๋ฒ, 3003๋ฒ
+ - ex) ์ถ๊ทผ๊ธธ : 7800๋ฒ, 3003๋ฒ
- ์ค์๊ฐ ๋ฒ์ค ๋์ฐฉ์ ๋ณด ์ ๊ณต
- - ์ต๋ 2๊ฐ ๋ฒ์ค๊น์ง ๋์ฐฉ์ ๋ณด ์ ๊ณต
+ - ์ต๋ 2๊ฐ ๋ฒ์ค๊น์ง ๋์ฐฉ์ ๋ณด ์ ๊ณต
- ๋ฑ๋ก๋ ๋ฒ์ค์ ๋ํ ํต๊ณ ๋ฐ ์์ธก ์ ๊ณต
- - ๊ณผ๊ฑฐ ๊ฐ์ ์์ผ(์ต๋ 5์ฃผ์ ๊น์ง) ์๊ฐ๋๋ณ ๋จ์ ์ข์ ํต๊ณ ์ ๊ณต
- - ๊ณผ๊ฑฐ ํต๊ณ ๋ฐ์ดํฐ๋ฅผ ๋ฐํ์ผ๋ก ํ์ฌ ๋์ฐฉ์์ ๋ฒ์ค์ ๋จ์์ข์ ์์ธก ์ ๊ณต
+ - ๊ณผ๊ฑฐ ๊ฐ์ ์์ผ(์ต๋ 5์ฃผ์ ๊น์ง) ์๊ฐ๋๋ณ ๋จ์ ์ข์ ํต๊ณ ์ ๊ณต
+ - ๊ณผ๊ฑฐ ํต๊ณ ๋ฐ์ดํฐ๋ฅผ ๋ฐํ์ผ๋ก ํ์ฌ ๋์ฐฉ์์ ๋ฒ์ค์ ๋จ์์ข์ ์์ธก ์ ๊ณต
@@ -97,12 +133,14 @@
### ๋ฒ์ค-์ ๊ฑฐ์ฅ ๋ฆฌ๋ทฐ
+
- ์ด์ฉํ ๋ฒ์ค-์ ๊ฑฐ์ฅ์ ๋ํด ์พ์ ๋ ๋ฐ ๋ฆฌ๋ทฐ ๋ฑ๋ก ๊ฐ๋ฅ
- ์ด์ฉํ ์๊ฐ๋์ ์พ์ ๋๋ฅผ ๋ฆฌ๋ทฐํ์ฌ ์ดํ ์์ธก์ ํ์ฉํ ์์ (๋ฏธ๊ตฌํ)
--
+-
+
---
@@ -110,104 +148,115 @@
### ๊ด๋ฆฌ์ ํ์ด์ง
+
-
+
#### ๊ด๋ฆฌ์ ๋์๋ณด๋
- - ์ฌ์ฉ์ ๊ด๋ฆฌ
- - ๋ถ๋งํฌ ํต๊ณ
- - ๋ฆฌ๋ทฐ ํต๊ณ
- - ์์ง ๋ฒ์ค๋
ธ์ ๊ด๋ฆฌ
- - ๊ณต๊ณต api key ๊ด๋ฆฌ
- - ์ค์ผ์ค๋ฌ ๊ด๋ฆฌ
+
+- ์ฌ์ฉ์ ๊ด๋ฆฌ
+- ๋ถ๋งํฌ ํต๊ณ
+- ๋ฆฌ๋ทฐ ํต๊ณ
+- ์์ง ๋ฒ์ค๋
ธ์ ๊ด๋ฆฌ
+- ๊ณต๊ณต api key ๊ด๋ฆฌ
+- ์ค์ผ์ค๋ฌ ๊ด๋ฆฌ
-
+
#### ์ฌ์ฉ์ ๊ด๋ฆฌ
- - ์ฌ์ฉ์ ๊ฐ์
์ ๋ณด ์กฐํ ๋ฐ ํ์ํํด(์ญ์ )
+
+- ์ฌ์ฉ์ ๊ฐ์
์ ๋ณด ์กฐํ ๋ฐ ํ์ํํด(์ญ์ )
-
+
#### ๋ถ๋งํฌ ํต๊ณ
- - ๋ฒ์ค ๋
ธ์ -์ ๊ฑฐ์ฅ ๋ณ ๋ถ๋งํฌ์ ๋ฑ๋ก๋ ํ์ ์ค๋ฆ์ฐจ์ ์กฐํ
+
+- ๋ฒ์ค ๋
ธ์ -์ ๊ฑฐ์ฅ ๋ณ ๋ถ๋งํฌ์ ๋ฑ๋ก๋ ํ์ ์ค๋ฆ์ฐจ์ ์กฐํ
-
+
#### ๋ฆฌ๋ทฐ ํต๊ณ
- - ๋ฒ์ค ๋
ธ์ -์ ๊ฑฐ์ฅ ๋ณ ๋ฆฌ๋ทฐ ๊ฐ์ ์ค๋ฆ์ฐจ์ ์กฐํ
+
+- ๋ฒ์ค ๋
ธ์ -์ ๊ฑฐ์ฅ ๋ณ ๋ฆฌ๋ทฐ ๊ฐ์ ์ค๋ฆ์ฐจ์ ์กฐํ
-
+
#### ์์ง ๋ฒ์ค๋
ธ์ ๊ด๋ฆฌ
- - ์ค์๊ฐ ์์น์ ๋ณด ์์ง ๋์ ๋
ธ์ ๊ด๋ฆฌ(๋ฑ๋ก/์ญ์ )
+
+- ์ค์๊ฐ ์์น์ ๋ณด ์์ง ๋์ ๋
ธ์ ๊ด๋ฆฌ(๋ฑ๋ก/์ญ์ )
-
+
#### ๊ณต๊ณต api key ๊ด๋ฆฌ
- - ๊ณต๊ณต api ์ฌ์ฉํ๋๊ฐ 1,000์ฒ๊ฑด/1ํ ์ด๊ธฐ ๋๋ฌธ์ ์ฌ๋ฌ๊ฐ์ apiํค๋ฅผ ๋ฑ๋กํ์ฌ ์ฌ์ฉ
- - ์์ฐฝ url๋ณ๋ก ํ๋๊ฐ ์ฃผ์ด์ง๊ธฐ ๋๋ฌธ์ ๊ฐ url๋ง๋ค ์ฌ์ฉ๋ ๋ฐ๋ก ์ง๊ณ
- - ํ๋๊ฐ ์ด๊ณผ๋ apiํค๋ ๋ค์๋ ๊น์ง ์ฌ์ฉ๋์ง ์์
+
+- ๊ณต๊ณต api ์ฌ์ฉํ๋๊ฐ 1,000์ฒ๊ฑด/1ํ ์ด๊ธฐ ๋๋ฌธ์ ์ฌ๋ฌ๊ฐ์ apiํค๋ฅผ ๋ฑ๋กํ์ฌ ์ฌ์ฉ
+- ์์ฐฝ url๋ณ๋ก ํ๋๊ฐ ์ฃผ์ด์ง๊ธฐ ๋๋ฌธ์ ๊ฐ url๋ง๋ค ์ฌ์ฉ๋ ๋ฐ๋ก ์ง๊ณ
+- ํ๋๊ฐ ์ด๊ณผ๋ apiํค๋ ๋ค์๋ ๊น์ง ์ฌ์ฉ๋์ง ์์
-
+
#### ์ค์ผ์ค๋ฌ ๊ด๋ฆฌ
- - ์ค์ผ์ค ๋ฑ๋ก์ด ๋ ์์
๊ด๋ฆฌ (์ปค์คํ
์ด๋
ธํ
์ด์
: @DynamicScheduled)
+
+- ์ค์ผ์ค ๋ฑ๋ก์ด ๋ ์์
๊ด๋ฆฌ (์ปค์คํ
์ด๋
ธํ
์ด์
: @DynamicScheduled)
- ๋ฒ์ค ์์น์ ๋ณด ์์ง (3๋ถ๊ฐ๊ฒฉ)
- api key ์ฌ์ฉ๋ ๋ฆฌ์
(๋งค์ผ 00:00)
- ์์งํ ์์น์ ๋ณด ๋ฐ์ดํฐ ๊ฐ๊ณต (๋งค์ผ 03:00)
- - ๋ฐํ์ ์ค ํฌ๋ก ์ ๋ณ๊ฒฝ ๊ฐ๋ฅ
- - ํ๊ฐ์ ์์
์ ์ฌ๋ฌ๊ฐ์ ํฌ๋ก ์ ๋ฑ๋ก ๊ฐ๋ฅ (๊ตฌ๋ถ์ "|")
-
+- ๋ฐํ์ ์ค ํฌ๋ก ์ ๋ณ๊ฒฝ ๊ฐ๋ฅ
+- ํ๊ฐ์ ์์
์ ์ฌ๋ฌ๊ฐ์ ํฌ๋ก ์ ๋ฑ๋ก ๊ฐ๋ฅ (๊ตฌ๋ถ์ "|")
+
## ERD
-
+
+
## ๊ธฐ์ ์คํ
-### BE
-- Spring Boot 3.3.2 / Java 17
-- Spring Security (with Session & Cookie)
-- Spring Data JPA
-- MySQL 8
-### FE
-- Next.js
-- Shadcn
+
+
+BE
+
+
+
+FE
+
+
-### Infra / System
-- AWS EC2
-- AWS RDS
-- Docker / Docker compose
+DB
+
+
+
+Infra / System
+
+

## ์ธ๋ถ API
+
- [๊ฒฝ๊ธฐ๋ ๋ฒ์ค ๋
ธ์ ์กฐํ](https://www.data.go.kr/data/15080666/openapi.do) : ๋ฒ์ค ๋
ธ์ ์ ๋ณด
- [๊ฒฝ๊ธฐ๋ ์ ๋ฅ์ ์กฐํ](https://www.data.go.kr/data/15080666/openapi.do) : ๋ฒ์ค ์ ๊ฑฐ์ฅ ์ ๋ณด, ๋ฒ์ค ์ ๊ฑฐ์ฅ ๊ฒฝ์ ๋
ธ์ ์ ๋ณด
- [๊ฒฝ๊ธฐ๋ ๋ฒ์ค ์์น์ ๋ณด ์กฐํ](https://www.data.go.kr/data/15080648/openapi.do) : ํน์ ๋
ธ์ ์ ํ์ฌ ์ดํ์ค์ธ ๋ฒ์ค๋ค์ ์ค์๊ฐ ์์น ์ ๋ณด
- [๊ฒฝ๊ธฐ๋ ๋ฒ์ค ๋์ฐฉ์ ๋ณด ์กฐํ](https://www.data.go.kr/data/15080346/openapi.do) : ํน์ ์ ๊ฑฐ์ฅ์ ๋์ฐฉํ๋ ์ค์๊ฐ ๋ฒ์ค ๋์ฐฉ ์ ๋ณด
-
-## ํ๋ก์ ํธ ํ์
๊ด๋ จ ์ ๋ณด
-[ํ๊น? ์ํค](https://github.com/Kernel360/E2E2-TALKKA/wiki)