[Sprint Mission5]

1. ํ”„๋กœ์ ํŠธ ๋งˆ์ผ์Šคํ†ค

  • RESTful API๋กœ ์žฌ์„ค๊ณ„ ๋ฐ ๋ฆฌํŒฉํ† ๋ง
  • Swagger๋ฅผ ํ™œ์šฉํ•œ API ๋ฌธ์„œ ์ž๋™ํ™”
  • ํ”„๋ก ํŠธ์—”๋“œ ์—ฐ๋™
  • PaaS๋ฅผ ํ™œ์šฉํ•œ ๋ฐฐํฌ

2. ์ฃผ์š” ๋ณ€๊ฒฝ ์‚ฌํ•ญ

2-1. Google Java Style Guide๊ฐ€ ์ ์šฉ ๋˜์—ˆ์Šต๋‹ˆ๋‹ค.

  • IntelliJ ์ ์šฉ ๋ฐฉ๋ฒ•
    • Google์—์„œ ์ œ๊ณตํ•˜๋Š” IntelliJ ์ ์šฉ ํŒŒ์ผ์„ ๋‹ค์šด๋กœ๋“œํ•ฉ๋‹ˆ๋‹ค.
    • IntelliJ ์„ค์ • > Editor > Code Style ๋ฉ”๋‰ด์—์„œ ๋‹ค์šด๋กœ๋“œํ•œ xml ํŒŒ์ผ์„ ์ž„ํฌํŠธํ•ฉ๋‹ˆ๋‹ค.
    • ํŒŒ์ผ์ด ์ˆ˜์ •๋  ๋•Œ๋งˆ๋‹ค ์Šคํƒ€์ผ์ด ์ž๋™์œผ๋กœ ์ ์šฉ๋  ์ˆ˜ ์žˆ๋„๋ก ์„ค์ •ํ•ฉ๋‹ˆ๋‹ค.

3. ๊ธฐ๋ณธ ์š”๊ตฌ์‚ฌํ•ญ

  • ์Šคํ”„๋ฆฐํŠธ ๋ฏธ์…˜#4์—์„œ ๊ตฌํ˜„ํ•œ API๋ฅผ RESTful API๋กœ ๋‹ค์‹œ ์„ค๊ณ„ํ•ด๋ณด์„ธ์š”.
    • API ์ŠคํŽ™์„ ํ™•์ธํ•˜๊ณ  ๋ณธ์ธ์ด ์„ค๊ณ„ํ•œ API์™€ ๋น„๊ตํ•ด๋ณด์„ธ์š”.
    • oasdiff๋ฅผ ํ™œ์šฉํ•˜๋ฉด ์ข€ ๋” ์ˆ˜์›”ํ•˜๊ฒŒ ๋น„๊ตํ•  ์ˆ˜ ์žˆ์–ด์š”.
    • API ์„ค๊ณ„์— ์ •๋‹ต์€ ์—†์ง€๋งŒ, ์ด์–ด์ง€๋Š” ์š”๊ตฌ์‚ฌํ•ญ๊ณผ ๋ฏธ์…˜์„ ์›ํ™œํžˆ ์ˆ˜ํ–‰ํ•˜๊ธฐ ์œ„ํ•ด ์ œ๊ณต๋œ API ์ŠคํŽ™์— ๋งž์ถ”์–ด ๊ตฌํ˜„ํ•ด์ฃผ์„ธ์š”.
    • ํŠนํžˆ, ์‹ฌํ™” ์š”๊ตฌ์‚ฌํ•ญ์—์„œ ์ œ๊ณต๋˜๋Š” ํ”„๋ก ํŠธ์—”๋“œ ์ฝ”๋“œ๋Š” ์ œ๊ณต๋œ API ์ŠคํŽ™์„ ์ค€์ˆ˜ํ•ด์•ผ ์—ฐ๋™ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
  • Postman์„ ํ™œ์šฉํ•ด ์ปจํŠธ๋กค๋Ÿฌ๋ฅผ ํ…Œ์ŠคํŠธ ํ•˜์„ธ์š”.
    • Postman API ํ…Œ์ŠคํŠธ ๊ฒฐ๊ณผ๋ฅผ exportํ•˜์—ฌ PR์— ์ฒจ๋ถ€ํ•ด์ฃผ์„ธ์š”.
  • springdoc-openapi๋ฅผ ํ™œ์šฉํ•˜์—ฌ Swagger ๊ธฐ๋ฐ˜์˜ API ๋ฌธ์„œ๋ฅผ ์ƒ์„ฑํ•˜์„ธ์š”.
  • Swagger-UI๋ฅผ ํ™œ์šฉํ•ด API๋ฅผ ํ…Œ์ŠคํŠธํ•ด๋ณด์„ธ์š”.

4. ์‹ฌํ™” ์š”๊ตฌ์‚ฌํ•ญ

  • ๋‹ค์Œ์˜ ์ •์  ๋ฆฌ์†Œ์Šค๋ฅผ ์„œ๋น™ํ•˜์—ฌ ํ”„๋ก ํŠธ์—”๋“œ์™€ ํ†ตํ•ฉํ•ด๋ณด์„ธ์š”. API ์ŠคํŽ™์„ ์ค€์ˆ˜ํ–ˆ๋‹ค๋ฉด ์ž˜ ๋™์ž‘ํ• ๊ฑฐ์˜ˆ์š”.

    fe_1.0.0.zip

    ํ™”๋ฉด ๊ฐ€์ด๋“œ

  • Railway.app์„ ํ™œ์šฉํ•˜์—ฌ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ๋ฐฐํฌํ•ด๋ณด์„ธ์š”.

    • Railway.app์€ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ์‰ฝ๊ฒŒ ๋ฐฐํฌํ•  ์ˆ˜ ์žˆ๋„๋ก ๋„์™€์ฃผ๋Š” PaaS์ž…๋‹ˆ๋‹ค.
    • Railway.app์— ๊ฐ€์ž…ํ•˜๊ณ , ๋ฐฐํฌํ•  GitHub ๋ ˆํฌ์ง€ํ† ๋ฆฌ๋ฅผ ์—ฐ๊ฒฐํ•˜์„ธ์š”.
    • Settings > Network ์„น์…˜์—์„œ Generate Domain ๋ฒ„ํŠผ์„ ํ†ตํ•ด ๋„๋ฉ”์ธ์„ ์ƒ์„ฑํ•˜์„ธ์š”.
    • ์ƒ์„ฑ๋œ ๋„๋ฉ”์ธ์— ์ ‘์†ํ•ด ๋ฐฐํฌ๋œ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ํ…Œ์ŠคํŠธํ•ด๋ณด์„ธ์š”.

๋ฌด๋ฃŒ ์‚ฌ์šฉ ์ œํ•œ์ด ์žˆ์œผ๋ฏ€๋กœ, ์ฝ”๋“œ ๋ฆฌ๋ทฐ ์ดํ›„์—๋Š” ๋ฐฐํฌ ์ธ์Šคํ„ด์Šค๋ฅผ ์‚ญ์ œํ•ด์ฃผ์„ธ์š”.

Leave a comment