๐Ÿ‘€ ์šฐ์•„ํ•œ ์•„์ด๋“ค์˜ ์„ค๊ณ„ ๊ณต์œ  - boostcampwm-2022/web33-Mildo GitHub Wiki

ํ”„๋กœ์ ํŠธ ์†Œ๊ฐœ

ํŒ€ ์†Œ๊ฐœ

์šฐ์•„ํ•œ ์•„์ด๋“ค

J076 ๋ฐ•์ƒ์ค€

J127 ์œ ํ•œ๋นˆ

J195 ์กฐํ˜„์ •

J197 ์ง€์œค์šฐ

Mildo

์„œ์šธ์‹œ ์‹ค์‹œ๊ฐ„ ๋„์‹œ๋ฐ์ดํ„ฐ API๋ฅผ ์ด์šฉํ•œ ์ง€์—ญ๋ณ„ ์ธ๊ตฌ ๋ฐ€๋„ ์ •๋ณด ์ œ๊ณต ์„œ๋น„์Šค

1. ๊ธฐ๋Šฅ ๊ตฌ์ฒดํ™” ํšŒ์˜

1.1. ๊ฒ€์ƒ‰ ๊ธฐ๋Šฅ

1.1.1. ๊ตฌํ˜„ ๋ฐฉ์•ˆ

  1. input์„ ์‚ฌ์šฉํ•˜์—ฌ ์ž์œ ๋กœ์šด ๊ฒ€์ƒ‰
    • ์žฅ์  : ์‚ฌ์šฉ์ž๊ฐ€ ์›ํ•˜๋Š” ๋‹จ์–ด๋ฅผ ์ž…๋ ฅํ•  ์ˆ˜ ์žˆ์Œ
    • ๋ฌธ์ œ์  : ์„œ์šธ ์‹ค์‹œ๊ฐ„ ๋„์‹œ ๋ฐ์ดํ„ฐ๋Š” ์ฃผ์š” 50๊ณณ ์žฅ์†Œ์— ๋Œ€ํ•œ ์ •๋ณด๋งŒ ์ œ๊ณตํ•˜์—ฌ ์ผ์น˜ํ•˜์ง€ ์•Š๋Š” ๊ฒฐ๊ณผ๊ฐ€ ๋งŽ์Œ
  2. 50๊ณณ ์žฅ์†Œ ๋ชฉ๋ก ์ œ๊ณต
    • ์žฅ์  : ํ˜„์žฌ ์ œ๊ณตํ•˜๋Š” ์žฅ์†Œ๊ฐ€ 50๊ณณ์œผ๋กœ ์ ๊ธฐ ๋•Œ๋ฌธ์— ์‚ฌ์šฉ์ž๊ฐ€ ์ง์ ‘ ๊ฒ€์ƒ‰ํ•˜๋Š” ๊ฒƒ๋ณด๋‹ค ๋” ๋น ๋ฅด๊ณ  ์ •ํ™•ํ•˜๊ฒŒ ๊ฒ€์ƒ‰ํ•  ์ˆ˜ ์žˆ์Œ
    • ๋ฌธ์ œ์  : ์„œ์šธ ์‹ค์‹œ๊ฐ„ ๋„์‹œ ๋ฐ์ดํ„ฐ API์—์„œ ์ œ๊ณตํ•˜๋Š” ์žฅ์†Œ๊ฐ€ ๋งŽ์•„์ง€๋ฉด ์‚ฌ์šฉ์ž๊ฐ€ ์ด์šฉํ•˜๊ธฐ ๋ถˆํŽธํ•˜๋‹ค๋Š” ๋‹จ์ ์ด ์žˆ์Œ โ†’ โ€˜ํ™•์žฅ์„ฑโ€™์˜ ๋ฌธ์ œ
      • ex) ํ˜„์žฌ๋Š” ์ œ๊ณตํ•˜๋Š” ์žฅ์†Œ๊ฐ€ 50๊ณณ์ด์ง€๋งŒ, ๋‚˜์ค‘์— 100, 200, 300๊ณณ์ด ๋œ๋‹ค๊ณ  ํ•˜๋ฉด ์‚ฌ์šฉ์ž๋Š” ๊ทธ ๋งŽ์€ ์žฅ์†Œ ์ค‘ ์—์„œ ์›ํ•˜๋Š” ์žฅ์†Œ๋ฅผ ์ฐพ๊ธฐ ํž˜๋“ค ์ˆ˜ ์žˆ๋Š” ๋ฌธ์ œ ๋ฐœ์ƒ

1.1.2. ํ•ด๊ฒฐ ๋ฐฉ์•ˆ

  1. ๋ชฉ๋ก๋ณด๋‹ค๋Š” input์ด ์ด์ ์ด ๋งŽ๊ธฐ ๋•Œ๋ฌธ์— input์œผ๋กœ ๊ฒ€์ƒ‰ํ•  ์ˆ˜ ์žˆ๋„๋ก ๊ฒฐ์ •

    • ๋‹จ์  : API์˜ ํ™•์žฅ์„ฑ์„ ๊ณ ๋ คํ•˜๋ฉด ๋ชฉ๋ก์€ ์žฅ๊ธฐ์ ์œผ๋กœ ์‚ฌ์šฉ์ด ์–ด๋ ค์›€

      โ†’ ๊ทธ๋ž˜์„œ input์„ ์‚ฌ์šฉํ•˜๋ ค๋ฉด ์ฃผ์š” 50๊ณณ์ด ์•„๋‹Œ ๊ฒฝ์šฐ์— ๋Œ€ํ•ด ์˜ˆ์™ธ ์ฒ˜๋ฆฌ๋ฅผ ํ•ด์ฃผ์–ด์•ผ ํ•จ

  2. ์˜ˆ์™ธ ์ฒ˜๋ฆฌ

    1. ํ•ด๋‹น ๊ฒ€์ƒ‰ ๊ฒฐ๊ณผ์™€ ๊ฐ€์žฅ ๊ฐ€๊นŒ์šด ์ฃผ์š” ์žฅ์†Œ ์œ ๋„
      • ๋ฌธ์ œ์  : ์žฅ์†Œ๋ž€ ์ •ํ™•ํ•œ ์œ„๋„/๊ฒฝ๋„๊ฐ€ ํ•˜๋‚˜ ์žˆ๋Š” ๊ฒƒ์ด ์•„๋‹Œ ์ˆ˜ ๋งŽ์€ ์œ„๋„/๊ฒฝ๋„์˜ ์ง‘ํ•ฉ์ด๊ธฐ ๋•Œ๋ฌธ์— ์žฅ์†Œ์™€ ์žฅ์†Œ์˜ ๊ฐ€๊นŒ์šด ์ •๋„๋ฅผ ๊ณ„์‚ฐํ•˜๊ธฐ ์–ด๋ ค์›€
    2. ํ•ด๋‹น ๊ฒ€์ƒ‰ ๊ฒฐ๊ณผ๊ฐ€ ์ฃผ์š” ์žฅ์†Œ์— ์—†๋Š” ๊ฒฝ์šฐ ๊ทธ๋ƒฅ ์—†๋‹ค๋Š” ๋ฉ”์‹œ์ง€ ์ถœ๋ ฅ
      • ๋ฌธ์ œ์  : ์‚ฌ์šฉ์ž ์ž…์žฅ์—์„œ ๋ถˆํŽธํ•จ์ด ์กด์žฌํ•  ์ˆ˜ ์žˆ์Œ
  3. ๊ฒฐ๋ก 

    • input์„ ์‚ฌ์šฉํ•˜์—ฌ ์ž์œ ๋กญ๊ฒŒ ๊ฒ€์ƒ‰์„ ๋ฐ›๋˜, ์™ผ์ชฝ ์‚ฌ์ง„์ฒ˜๋Ÿผ ์ž๋™ ์™„์„ฑ ๊ธฐ๋Šฅ์„ ์ œ๊ณตํ•˜์—ฌ ์ด์šฉ์ž๊ฐ€ ์ฃผ์š” ์žฅ์†Œ๋ฅผ ์‰ฝ๊ฒŒ ์•Œ์•„๋ณผ ์ˆ˜ ์žˆ๋„๋ก ํ•จ
    • ์ฃผ์š” ์žฅ์†Œ์— ํฌํ•จ๋˜์ง€ ์•Š๋Š” ๊ฒฐ๊ณผ์˜ ๊ฒฝ์šฐ ์˜ค๋ฅธ์ชฝ ์‚ฌ์ง„์ฒ˜๋Ÿผ โ€˜๊ฒ€์ƒ‰ ๊ฒฐ๊ณผ๊ฐ€ ์ฃผ์š” 50๊ณณ์— ํฌํ•จ๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.โ€™๋ผ๋Š” ๋ฉ”์‹œ์ง€ ์ถœ๋ ฅ

Untitled (1) Untitled (2)

1.2. 24์‹œ๊ฐ„ ์ด๋‚ด์˜ ๋ฐ์ดํ„ฐ

1.2.1. ํ•˜๊ณ  ์‹ถ์€ ๊ฒƒ

  • ํ•ด๋‹น ์ง€์—ญ์˜ 24์‹œ๊ฐ„ ์ด๋‚ด์˜ ํ˜ผ์žก๋„๋ฅผ ์•„๋ž˜ ๊ทธ๋ž˜ํ”„์ฒ˜๋Ÿผ ๋ณด์—ฌ์ฃผ๊ณ  ์‹ถ์Œ

์‚ฌ์ง„ PNG

1.2.2. ํ•œ๊ณ„์ 

แ„‰แ…ณแ„แ…ณแ„…แ…ตแ†ซแ„‰แ…ฃแ†บ 2022-11-11 แ„‹แ…ฉแ„Œแ…ฅแ†ซ 10 56 20

์„œ์šธ ์‹ค์‹œ๊ฐ„ ๋„์‹œ ๋ฐ์ดํ„ฐ API์˜ ์‘๋‹ต

  • โ€˜์„œ์šธ์‹œ ์‹ค์‹œ๊ฐ„ ๋„์‹œ๋ฐ์ดํ„ฐโ€™๊ฐ€ ์ œ๊ณตํ•˜๋Š” ๊ฒƒ : ํ˜ผ์žก๋„(๋ณดํ†ต, ๋งค์šฐ ๋ถ๋น”), ๋‚จ/์—ฌ ์„ฑ๋ณ„ ๋น„์œจ, ์—ฐ๋ น๋Œ€ ๋น„์œจ, ์ธ๊ตฌ ์˜ˆ์ƒ์น˜ ์ตœ๋Œ“๊ฐ’/์ตœ์†Ÿ๊ฐ’
  • ์ฆ‰, โ€˜์„œ์šธ์‹œ ์‹ค์‹œ๊ฐ„ ๋„์‹œ๋ฐ์ดํ„ฐโ€™๊ฐ€ ๊ณผ๊ฑฐ 24์‹œ๊ฐ„์˜ ์ธ๊ตฌ๋ฐ€๋„์— ๋Œ€ํ•œ ๋ฐ์ดํ„ฐ๋ฅผ ์ œ๊ณตํ•ด์ฃผ์ง€ ์•Š์Œ

1.2.3. ํ•ด๊ฒฐ ๋ฐฉ์•ˆ

  1. ์ง์ ‘ ์‹ค์‹œ๊ฐ„ ๋„์‹œ๋ฐ์ดํ„ฐ๋ฅผ ์ˆ˜์ง‘ํ•˜์—ฌ 24์‹œ๊ฐ„ ์ด๋‚ด์˜ ์ธ๊ตฌ๋ฐ€๋„์— ๋Œ€ํ•œ ๋ฐ์ดํ„ฐ๋ฅผ ์ž์ฒด์ ์œผ๋กœ ์ œ๊ณตํ•จ

    โ†’ ๋ฐ˜๋ณต์ ์œผ๋กœ API์— ์š”์ฒญ์„ ํ•ด์•ผ ํ•˜๊ธฐ ๋•Œ๋ฌธ์— ๊ธฐ์ˆ ์ ์œผ๋กœ ์–ด๋–ป๊ฒŒ ๊ตฌํ˜„ํ•ด์•ผ ํ• ์ง€ ๊ณ ๋ฏผ

  2. 24์‹œ๊ฐ„ ์ด๋‚ด์˜ ๋ฐ์ดํ„ฐ ๋Œ€์‹  ์„ฑ๋ณ„ ๋น„์œจ์ด๋‚˜ ์—ฐ๋ น๋Œ€ ๋น„์œจ๋กœ ๋Œ€์ฒดํ•˜๋Š” ๋ฐฉ์•ˆ๋„ ์ œ์‹œ๋จ

    โ†’ ์„ฑ๋ณ„ ๋น„์œจ์ด๋‚˜ ์—ฐ๋ น๋Œ€ ๋น„์œจ์„ ์ œ๊ณตํ•˜๋Š” ๊ฒƒ๋ณด๋‹ค๋Š” 24์‹œ๊ฐ„ ์ด๋‚ด์˜ ๋ฐ์ดํ„ฐ๊ฐ€ ์‚ฌ์šฉ์ž์—๊ฒŒ ๋” ํ•„์š”ํ•œ ์ •๋ณด๋ผ๊ณ  ํŒ๋‹จํ•จ

  3. ๋‹ค์‹œ 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))