hackathon-team3-server

๐Ÿ“  Convention

๐Ÿค Branch Naming Convention

๋จธ๋ฆฟ๋ง ์„ค๋ช…
main ์„œ๋น„์Šค ๋ธŒ๋žœ์น˜
develop ๋ฐฐํฌ ์ „ ์ž‘์—… ๊ธฐ์ค€
feature ๊ธฐ๋Šฅ ๋‹จ์œ„ ๊ตฌํ˜„
hotfix ์„œ๋น„์Šค ์ค‘ ๊ธด๊ธ‰ ์ˆ˜์ • ๊ฑด์— ๋Œ€ํ•œ ์ฒ˜๋ฆฌ
Branch Naming Convention Detail
master(main) โ”€โ”€ develop โ”€โ”€ feature
โ””โ”€โ”€ hotfix
  • ๊นƒ ํ”Œ๋กœ์šฐ๋ฅผ ๋ฒ ์ด์Šค๋กœ ํ•˜์—ฌ ํ”„๋กœ์ ํŠธ ์‚ฌ์ด์ฆˆ์— ๋งž๊ฒŒ ์žฌ์ •์˜ํ–ˆ์Šต๋‹ˆ๋‹ค.
  • ๋ธŒ๋žœ์น˜ ์ด๋ฆ„์€ cabab-case๋ฅผ ๋”ฐ๋ฆ…๋‹ˆ๋‹ค.
  • ์ด์Šˆ ๋ฒˆํ˜ธ๋Š” ๊ฐ€์žฅ ๋งˆ์ง€๋ง‰์— ์ ์Šต๋‹ˆ๋‹ค.

master(main)

  • ์‹ค์ œ ์„œ๋น„์Šค๊ฐ€ ์ด๋ฃจ์–ด์ง€๋Š” ๋ธŒ๋žœ์น˜์ž…๋‹ˆ๋‹ค.
  • ์ด ๋ธŒ๋žœ์น˜๋ฅผ ๊ธฐ์ค€์œผ๋กœ develop ๋ธŒ๋žœ์น˜๊ฐ€ ๋ถ„๊ธฐ๋ฉ๋‹ˆ๋‹ค.
  • ๋ฐฐํฌ ์ค‘, ๊ธด๊ธ‰ํ•˜๊ฒŒ ์ˆ˜์ •ํ•  ๊ฑด์ด ์ƒ๊ธธ์‹œ hotfix ๋ธŒ๋žœ์น˜๋ฅผ ๋งŒ๋“ค์–ด ์ˆ˜์ •ํ•ฉ๋‹ˆ๋‹ค.

develop

  • ๊ฐœ๋ฐœ, ํ…Œ์ŠคํŠธ, ๋ฆด๋ฆฌ์ฆˆ ๋“ฑ ๋ฐฐํฌ ์ „ ์ž‘์—…์˜ ๊ธฐ์ค€์ด ๋˜๋Š” ๋ธŒ๋žœ์น˜์ž…๋‹ˆ๋‹ค.
  • ํ•ด๋‹น ๋ธŒ๋žœ์น˜๋ฅผ default๋กœ ์„ค์ •ํ•ฉ๋‹ˆ๋‹ค.
  • ์ด ๋ธŒ๋žœ์น˜์—์„œ feature ๋ธŒ๋žœ์น˜๊ฐ€ ๋ถ„๊ธฐ๋ฉ๋‹ˆ๋‹ค.

feature

  • ๊ฐœ๋ณ„ ๊ฐœ๋ฐœ์ž๊ฐ€ ๋งก์€ ์ž‘์—…์„ ๊ฐœ๋ฐœํ•˜๋Š” ๋ธŒ๋žœ์น˜์ž…๋‹ˆ๋‹ค.
  • feature/(feature-name) ๊ณผ ๊ฐ™์ด ๋จธ๋ฆฟ๋ง์„ feature, ๊ผฌ๋ฆฟ๋ง์„ ๊ฐœ๋ฐœํ•˜๋Š” ๊ธฐ๋Šฅ์œผ๋กœ ๋ช…๋ช…ํ•ฉ๋‹ˆ๋‹ค.
  • feature-name์˜ ๊ฒฝ์šฐ cabab-case๋ฅผ ๋”ฐ๋ฆ…๋‹ˆ๋‹ค.
  • ex) feature/login-validation

hotfix

  • ์„œ๋น„์Šค ์ค‘ ๊ธด๊ธ‰ํžˆ ์ˆ˜์ •ํ•ด์•ผ ํ•  ์‚ฌํ•ญ์ด ๋ฐœ์ƒํ•  ๋•Œ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.
  • master์—์„œ ๋ถ„๊ธฐ๋ฉ๋‹ˆ๋‹ค.

๐Ÿค Commit Convention

๋จธ๋ฆฟ๋ง ์„ค๋ช…
feat ์ƒˆ๋กœ์šด ๊ธฐ๋Šฅ ์ถ”๊ฐ€
fix ๋ฒ„๊ทธ ์ˆ˜์ •
design CSS ๋“ฑ ์‚ฌ์šฉ์ž UI ๋””์ž์ธ ๋ณ€๊ฒฝ
!BREAKING CHANGE ์ปค๋‹ค๋ž€ API ๋ณ€๊ฒฝ์˜ ๊ฒฝ์šฐ
!HOTFIX ์ฝ”๋“œ ํฌ๋งท ๋ณ€๊ฒฝ, ์„ธ๋ฏธ ์ฝœ๋ก  ๋ˆ„๋ฝ, ์ฝ”๋“œ ์ˆ˜์ •์ด ์—†๋Š” ๊ฒฝ์šฐ
refactor ํ”„๋กœ๋•์…˜ ์ฝ”๋“œ ๋ฆฌํŒฉํ† ๋ง์—…
comment ํ•„์š”ํ•œ ์ฃผ์„ ์ถ”๊ฐ€ ๋ฐ ๋ณ€๊ฒฝ
docs ๋ฌธ์„œ ์ˆ˜์ •
test ํ…Œ์ŠคํŠธ ์ถ”๊ฐ€, ํ…Œ์ŠคํŠธ ๋ฆฌํŒฉํ† ๋ง(ํ”„๋กœ๋•์…˜ ์ฝ”๋“œ ๋ณ€๊ฒฝ X)
setting ํŒจํ‚ค์ง€ ์„ค์น˜, ๊ฐœ๋ฐœ ์„ค์ •
chore ๋นŒ๋“œ ํ…Œ์ŠคํŠธ ์—…๋ฐ์ดํŠธ, ํŒจํ‚ค์ง€ ๋งค๋‹ˆ์ €๋ฅผ ์„ค์ •ํ•˜๋Š” ๊ฒฝ์šฐ(ํ”„๋กœ๋•์…˜ ์ฝ”๋“œ ๋ณ€๊ฒฝ X)
rename ํŒŒ์ผ ํ˜น์€ ํด๋”๋ช…์„ ์ˆ˜์ •ํ•˜๊ฑฐ๋‚˜ ์˜ฎ๊ธฐ๋Š” ์ž‘์—…๋งŒ์ธ ๊ฒฝ์šฐ
remove ํŒŒ์ผ์„ ์‚ญ์ œํ•˜๋Š” ์ž‘์—…๋งŒ ์ˆ˜ํ–‰ํ•œ ๊ฒฝ์šฐ
Commit Convention Detail
  • <ํƒ€์ž…>: <์ œ๋ชฉ> - <์ด์Šˆ๋ฒˆํ˜ธ> ์˜ ํ˜•์‹์œผ๋กœ ์ œ๋ชฉ์„ ์•„๋ž˜ ๊ณต๋ฐฑ์ค„์— ์ž‘์„ฑ
  • ์ œ๋ชฉ์€ 50์ž ์ด๋‚ด / ๋ณ€๊ฒฝ์‚ฌํ•ญ์ด "๋ฌด์—‡"์ธ์ง€ ๋ช…ํ™•ํžˆ ์ž‘์„ฑ / ๋์— ๋งˆ์นจํ‘œ ๊ธˆ์ง€
  • ์˜ˆ) feat: ๋กœ๊ทธ์ธ ๊ธฐ๋Šฅ ์ถ”๊ฐ€ - #2
  • ๋ณธ๋ฌธ(๊ตฌ์ฒด์ ์ธ ๋‚ด์šฉ)์„ ์•„๋žซ์ค„์— ์ž‘์„ฑ
  • ์—ฌ๋Ÿฌ ์ค„์˜ ๋ฉ”์‹œ์ง€๋ฅผ ์ž‘์„ฑํ•  ๋• "-"๋กœ ๊ตฌ๋ถ„ (ํ•œ ์ค„์€ 72์ž ์ด๋‚ด)
  • ์ œ๋ชฉ๊ณผ ๋ณธ๋ฌธ์€ ํ•œ ์ค„ ๋„์›Œ ๋ถ„๋ฆฌ