๐ ์ฐ์ํ ์์ด๋ค์ ์ค๊ณ ๊ณต์ - boostcampwm-2022/web33-Mildo GitHub Wiki
ํ๋ก์ ํธ ์๊ฐ
ํ ์๊ฐ
์ฐ์ํ ์์ด๋ค
J076 ๋ฐ์์ค
J127 ์ ํ๋น
J195 ์กฐํ์
J197 ์ง์ค์ฐ
Mildo
์์ธ์ ์ค์๊ฐ ๋์๋ฐ์ดํฐ API๋ฅผ ์ด์ฉํ ์ง์ญ๋ณ ์ธ๊ตฌ ๋ฐ๋ ์ ๋ณด ์ ๊ณต ์๋น์ค
1. ๊ธฐ๋ฅ ๊ตฌ์ฒดํ ํ์
1.1. ๊ฒ์ ๊ธฐ๋ฅ
1.1.1. ๊ตฌํ ๋ฐฉ์
- input์ ์ฌ์ฉํ์ฌ ์์ ๋ก์ด ๊ฒ์
- ์ฅ์ : ์ฌ์ฉ์๊ฐ ์ํ๋ ๋จ์ด๋ฅผ ์ ๋ ฅํ ์ ์์
- ๋ฌธ์ ์ : ์์ธ ์ค์๊ฐ ๋์ ๋ฐ์ดํฐ๋ ์ฃผ์ 50๊ณณ ์ฅ์์ ๋ํ ์ ๋ณด๋ง ์ ๊ณตํ์ฌ ์ผ์นํ์ง ์๋ ๊ฒฐ๊ณผ๊ฐ ๋ง์
- 50๊ณณ ์ฅ์ ๋ชฉ๋ก ์ ๊ณต
- ์ฅ์ : ํ์ฌ ์ ๊ณตํ๋ ์ฅ์๊ฐ 50๊ณณ์ผ๋ก ์ ๊ธฐ ๋๋ฌธ์ ์ฌ์ฉ์๊ฐ ์ง์ ๊ฒ์ํ๋ ๊ฒ๋ณด๋ค ๋ ๋น ๋ฅด๊ณ ์ ํํ๊ฒ ๊ฒ์ํ ์ ์์
- ๋ฌธ์ ์ : ์์ธ ์ค์๊ฐ ๋์ ๋ฐ์ดํฐ API์์ ์ ๊ณตํ๋ ์ฅ์๊ฐ ๋ง์์ง๋ฉด ์ฌ์ฉ์๊ฐ ์ด์ฉํ๊ธฐ ๋ถํธํ๋ค๋ ๋จ์ ์ด ์์ โ โํ์ฅ์ฑโ์ ๋ฌธ์
- ex) ํ์ฌ๋ ์ ๊ณตํ๋ ์ฅ์๊ฐ 50๊ณณ์ด์ง๋ง, ๋์ค์ 100, 200, 300๊ณณ์ด ๋๋ค๊ณ ํ๋ฉด ์ฌ์ฉ์๋ ๊ทธ ๋ง์ ์ฅ์ ์ค ์์ ์ํ๋ ์ฅ์๋ฅผ ์ฐพ๊ธฐ ํ๋ค ์ ์๋ ๋ฌธ์ ๋ฐ์
1.1.2. ํด๊ฒฐ ๋ฐฉ์
-
๋ชฉ๋ก๋ณด๋ค๋ input์ด ์ด์ ์ด ๋ง๊ธฐ ๋๋ฌธ์ input์ผ๋ก ๊ฒ์ํ ์ ์๋๋ก ๊ฒฐ์
-
๋จ์ : API์ ํ์ฅ์ฑ์ ๊ณ ๋ คํ๋ฉด ๋ชฉ๋ก์ ์ฅ๊ธฐ์ ์ผ๋ก ์ฌ์ฉ์ด ์ด๋ ค์
โ ๊ทธ๋์ input์ ์ฌ์ฉํ๋ ค๋ฉด ์ฃผ์ 50๊ณณ์ด ์๋ ๊ฒฝ์ฐ์ ๋ํด ์์ธ ์ฒ๋ฆฌ๋ฅผ ํด์ฃผ์ด์ผ ํจ
-
-
์์ธ ์ฒ๋ฆฌ
- ํด๋น ๊ฒ์ ๊ฒฐ๊ณผ์ ๊ฐ์ฅ ๊ฐ๊น์ด ์ฃผ์ ์ฅ์ ์ ๋
- ๋ฌธ์ ์ : ์ฅ์๋ ์ ํํ ์๋/๊ฒฝ๋๊ฐ ํ๋ ์๋ ๊ฒ์ด ์๋ ์ ๋ง์ ์๋/๊ฒฝ๋์ ์งํฉ์ด๊ธฐ ๋๋ฌธ์ ์ฅ์์ ์ฅ์์ ๊ฐ๊น์ด ์ ๋๋ฅผ ๊ณ์ฐํ๊ธฐ ์ด๋ ค์
- ํด๋น ๊ฒ์ ๊ฒฐ๊ณผ๊ฐ ์ฃผ์ ์ฅ์์ ์๋ ๊ฒฝ์ฐ ๊ทธ๋ฅ ์๋ค๋ ๋ฉ์์ง ์ถ๋ ฅ
- ๋ฌธ์ ์ : ์ฌ์ฉ์ ์ ์ฅ์์ ๋ถํธํจ์ด ์กด์ฌํ ์ ์์
- ํด๋น ๊ฒ์ ๊ฒฐ๊ณผ์ ๊ฐ์ฅ ๊ฐ๊น์ด ์ฃผ์ ์ฅ์ ์ ๋
-
๊ฒฐ๋ก
- input์ ์ฌ์ฉํ์ฌ ์์ ๋กญ๊ฒ ๊ฒ์์ ๋ฐ๋, ์ผ์ชฝ ์ฌ์ง์ฒ๋ผ ์๋ ์์ฑ ๊ธฐ๋ฅ์ ์ ๊ณตํ์ฌ ์ด์ฉ์๊ฐ ์ฃผ์ ์ฅ์๋ฅผ ์ฝ๊ฒ ์์๋ณผ ์ ์๋๋ก ํจ
- ์ฃผ์ ์ฅ์์ ํฌํจ๋์ง ์๋ ๊ฒฐ๊ณผ์ ๊ฒฝ์ฐ ์ค๋ฅธ์ชฝ ์ฌ์ง์ฒ๋ผ โ๊ฒ์ ๊ฒฐ๊ณผ๊ฐ ์ฃผ์ 50๊ณณ์ ํฌํจ๋์ง ์์ต๋๋ค.โ๋ผ๋ ๋ฉ์์ง ์ถ๋ ฅ
1.2. 24์๊ฐ ์ด๋ด์ ๋ฐ์ดํฐ
1.2.1. ํ๊ณ ์ถ์ ๊ฒ
- ํด๋น ์ง์ญ์ 24์๊ฐ ์ด๋ด์ ํผ์ก๋๋ฅผ ์๋ ๊ทธ๋ํ์ฒ๋ผ ๋ณด์ฌ์ฃผ๊ณ ์ถ์
1.2.2. ํ๊ณ์
์์ธ ์ค์๊ฐ ๋์ ๋ฐ์ดํฐ API์ ์๋ต
- โ์์ธ์ ์ค์๊ฐ ๋์๋ฐ์ดํฐโ๊ฐ ์ ๊ณตํ๋ ๊ฒ : ํผ์ก๋(๋ณดํต, ๋งค์ฐ ๋ถ๋น), ๋จ/์ฌ ์ฑ๋ณ ๋น์จ, ์ฐ๋ น๋ ๋น์จ, ์ธ๊ตฌ ์์์น ์ต๋๊ฐ/์ต์๊ฐ
- ์ฆ, โ์์ธ์ ์ค์๊ฐ ๋์๋ฐ์ดํฐโ๊ฐ ๊ณผ๊ฑฐ 24์๊ฐ์ ์ธ๊ตฌ๋ฐ๋์ ๋ํ ๋ฐ์ดํฐ๋ฅผ ์ ๊ณตํด์ฃผ์ง ์์
1.2.3. ํด๊ฒฐ ๋ฐฉ์
-
์ง์ ์ค์๊ฐ ๋์๋ฐ์ดํฐ๋ฅผ ์์งํ์ฌ 24์๊ฐ ์ด๋ด์ ์ธ๊ตฌ๋ฐ๋์ ๋ํ ๋ฐ์ดํฐ๋ฅผ ์์ฒด์ ์ผ๋ก ์ ๊ณตํจ
โ ๋ฐ๋ณต์ ์ผ๋ก API์ ์์ฒญ์ ํด์ผ ํ๊ธฐ ๋๋ฌธ์ ๊ธฐ์ ์ ์ผ๋ก ์ด๋ป๊ฒ ๊ตฌํํด์ผ ํ ์ง ๊ณ ๋ฏผ
-
24์๊ฐ ์ด๋ด์ ๋ฐ์ดํฐ ๋์ ์ฑ๋ณ ๋น์จ์ด๋ ์ฐ๋ น๋ ๋น์จ๋ก ๋์ฒดํ๋ ๋ฐฉ์๋ ์ ์๋จ
โ ์ฑ๋ณ ๋น์จ์ด๋ ์ฐ๋ น๋ ๋น์จ์ ์ ๊ณตํ๋ ๊ฒ๋ณด๋ค๋ 24์๊ฐ ์ด๋ด์ ๋ฐ์ดํฐ๊ฐ ์ฌ์ฉ์์๊ฒ ๋ ํ์ํ ์ ๋ณด๋ผ๊ณ ํ๋จํจ
-
๋ค์ 24์๊ฐ ์ด๋ด์ ์ธ๊ตฌ๋ฐ๋์ ๋ํ ๋ฐ์ดํฐ๋ฅผ ์์ฒด์ ์ผ๋ก ์ ๊ณตํ๊ธฐ๋ก ๊ฒฐ๋ก ์ง์
โ ๊ฒฐ๋ก ์ ์ง๊ณ ๋์ ํฌ๋ก ํญ๊ณผ ๊ด๋ จ๋ ๋ ผ์๊ฐ ์ด๋ฃจ์ด์ง
โ ํฌ๋ก ํญ์ ์ฒ์ ์๋น์ค์ ์ ์ฉํด๋ณด๋ ๊ฒ์ด๊ธฐ ๋๋ฌธ์ ๋๋ ค์์ ์์์ง๋ง ํ์ต์ ๋์์ด ๋ ๊ฒ ๊ฐ์์ ํฌ๋ก ํญ ๊ธฐ๋ฅ์ ๋์ ํด๋ณด๊ธฐ๋ก ํจ
โ ๊ตฌ์ฒด์ ์ธ ์ ์ฉ ๋ฐฉ๋ฒ์ ๋ํด ๋ ๋ง์ ํ ์๊ฐ ํ์ํจ(ํผ๋๋ฐฑ ํ์)
2. ํ์ ๋ฐฉ์
- ๋ถ์ ์ด ์๋ ํ์ ์ ํตํด ๋ ์ํํ๊ฒ ์ํตํ๊ณ ์๋ก์ ์ฝ๋๋ฅผ ๋ ๊น์ด ์ดํดํ๊ณ ์ถ์
2.1. ํ์ด ํ๋ก๊ทธ๋๋ฐ ํด์ผ ํ๋ค
- ์ฅ์ : ํ์ด ํ๋ก๊ทธ๋๋ฐ์ ํ๋ฉด ๊ฐ์์ ์์ฌ ๊ฒฐ์ ์ด๋ ์ฝ๋์ ๋ํด ๋ ์์ธํ๊ฒ ์ดํดํ ์ ์์
- ๋จ์ : ํ์ด ํ๋ก๊ทธ๋จ๋ฐ์ ํ๋ฉด ์ฝ๋๋ฅผ ์์ฑํ์ง ์๋ ์ธ์์ด ์๊ฒจ ๊ฐ๋ฐ ์๋๊ฐ ๋๋ ค์ง ์ ์์
2.2. ํ์ด ํ๋ก๊ทธ๋๋ฐ ์ ํด๋ ๋๋ค
- ์ฅ์ : ํ์ด ํ๋ก๊ทธ๋๋ฐ๋ง์ด ํ์ ์ ์ ๋ถ๋ผ๊ณ ๋ณผ ์ ์์ผ๋ฉฐ, ์์ฌ ๊ฒฐ์ ๊ณผ์ ์ ํจ๊ป ํ๊ฑฐ๋ ์ฝ๋ ๋ฆฌ๋ทฐ๋ฅผ ํตํด ์ถฉ๋ถํ ํ์ ์ ํ ์ ์์
- ๋จ์ : ํ์ด ํ๋ก๊ทธ๋๋ฐ๋ณด๋ค ์๋ก์ ์ฝ๋์ ๋ํด ์ดํด๋๊ฐ ๋น๊ต์ ๋ฎ์
2.3. ๋ ๋ค ๊ฒฝํํด๋ณด๋ฉด ์ข์ง ์์๊น??
- ๋ ๋ฐฉ์ ๋ชจ๋ ์ฅ์ ์ด ์๊ธฐ ๋๋ฌธ์ ๋ ๊ฐ์ ์๊ฒฌ์ ๋ชจ๋ ๋ฐ์ํ๊ธฐ๋ก ํจ
- ๋งค์ฃผ 2๋ช ์ฉ ํ์ด๋ฅผ ๋ง๋ค๊ณ , ๊ฐ ํ์ด๋ง๋ค ํ์ด ํ๋ก๊ทธ๋๋ฐ์ ํ ์ง ์๋๋ฉด ํ์ด ํ๋ก๊ทธ๋๋ฐ์ ํ์ง ์์์ง ์์จ์ ์ผ๋ก ์ ํ ์ ์๋๋ก ๊ฒฐ์ ํจ
๊ฐ์ฌํฉ๋๋ค!
[Mildo Wiki](https://github.com/boostcampwm-2022/web33-Mildo/wiki)([https://github.com/boostcampwm-2022/web33-Mildo/wiki](https://github.com/boostcampwm-2022/web33-Mildo/wiki))