Convention - upswp/THXSTORE GitHub Wiki

convention

Git Convention๐Ÿค™

  • commit

    • commit convention : [์ด์Šˆ ๋ฒˆํ˜ธ] ๊ธฐ๋Šฅ ๋ถ„๋ฅ˜ : ์ƒ์„ธ์„ค๋ช…(ํ•œ๊ธ€)
    • ๊ธฐ๋Šฅ๋ถ„๋ฅ˜
      • feat : ๊ธฐ๋Šฅ ์ถ”๊ฐ€
      • fix : ๋ฒ„๊ทธ ์ˆ˜์ •
      • docs : ๋ฌธ์„œ ํŽธ์ง‘
      • refactor : ๋ฆฌํŒฉํ† ๋ง
      • test : ํ…Œ์ŠคํŠธ
      • chore : ๊ทธ ์™ธ
  • branch

    • ๊ธฐ์กด์˜ git flow ๋ฐฉ์‹์„ ์œ ์ง€

      • master ๐ŸŒˆ

        • ํ”„๋กœ์ ํŠธ ์ง„ํ–‰์ƒ ๋ณ€ํ™”๊ฐ€ ์žˆ์„ ๋•Œ (๋‹จ๊ณ„๋ณ„ ๊ธฐ๋Šฅ ๊ตฌํ˜„์ด ์ข…๋ฃŒ๋œ ์‹œ์ ), 0.x๋ฒ„์ „์œผ๋กœ ์—…๋ฐ์ดํŠธ ์˜ˆ์ •
        • ์ž์œจ ํ”„๋กœ์ ํŠธ ์ข…๋ฃŒ์‹œ 1.0.0 ๋ฒ„์ „์œผ๋กœ ๋ฐฐํฌ๋ฅผ ์ตœ์ข… ๋ชฉํ‘œ๋กœํ•จ.
      • hotfix ๐Ÿšจ

        • master branch ๋ฐฐํฌ ์ดํ›„, ๊ธด๊ธ‰ํ•œ ๊ธฐ๋Šฅ ์ˆ˜์ •์— ์žˆ์–ด์„œ ์ž‘์—… ํ•  ๊ฒฝ์šฐ ์‚ฌ์šฉ.
        • ์ƒ์„ฑ : hofix/ํƒ€์ž…/๊ธฐ๋Šฅ
      • development ๐Ÿ”ฅ

        • Jenkins๋ฅผ ์ด์šฉํ•œ ๋ฐฐํฌ ์ž๋™ํ™” ์ ์šฉ ์˜ˆ์ •
      • feature branch โญ

        • ์ƒ์„ฑ : feat/ํƒ€์ž…/๊ธฐ๋Šฅ
          • ํƒ€์ž… : FE or BE
          • ๊ธฐ๋Šฅ : FE๋Š” Page ๋‹จ์œ„๋กœ, BE๋Š” ๊ธฐ๋Šฅ๋ณ„๋กœ ์˜๋ฌธ๋กœ ์ž‘์„ฑ (์˜๋ฌธ์ž‘์„ฑ์‹œ ์‹œ์ž‘ ๋Œ€๋ฌธ์ž, ํ•ฉ์„ฑ์–ด๋Š” ์นด๋ฉœ๋กœ ์ž‘์„ฑ)

JIRA Convention๐Ÿค™

  • PM

    • ๊ธฐ๋ณธ convention
      • ์Šคํ”„๋ฆฐํŠธ ์ƒ์„ฑ์„ ๊ฐ„ํŠธ์ฐจํŠธ๋ฅผ ๊ธฐ๋ฐ˜์œผ๋กœ ์ƒ์„ฑํ•œ๋‹ค.
      • ์˜ˆ์ƒํ•œ ์Šคํ”„๋ฆฐํŠธ์˜ ์ด์Šˆ๋“ค์„ ํ•ด๋‹น ์ฃผ์ฐจ์— ์‹คํ–‰ํ•œ๋‹ค.
      • ์Šคํ”„๋ฆฐํŠธ ๊ธฐ๊ฐ„์€ ๊ฐ„ํŠธ์ฐจํŠธ์˜ ๊ธฐ๊ฐ„์„ ์ค€์ˆ˜ํ•œ๋‹ค.
      • ์• ์ž์ผ ๋ฐฉ์‹์œผ๋กœ ๋ฐœ์ƒํ•˜๋Š” ์ด์Šˆ๋“ค์€ ์ƒํ™ฉ์— ๋งž๊ฒŒ ์ด์Šˆ๋ฅผ ์ถ”๊ฐ€ํ•˜์—ฌ ๊ด€๋ฆฌํ•œ๋‹ค.
      • ์ด์Šˆํ˜„ํ™ฉ์„ ํŒŒ์•…ํ•˜๊ณ  ๊ทธ๋ž˜ํ”„๋กœ ์ž‘์—…ํ™”ํ•˜์—ฌ ํ•œ๋ˆˆ์— ๋ณผ ์ˆ˜ ์žˆ๋Š” ํ™˜๊ฒฝ์„ ๊ตฌ์ถ•ํ•œ๋‹ค.
    • ์—ญํ• 
      • ์ด์Šˆ ๊ด€๋ฆฌ
        • Component๊ธฐ๋Šฅ์„ ์ด์šฉํ•ด์„œ FE, BE์„ ๊ด€๋ฆฌํ•œ๋‹ค.
      • ๋ฒ„์ „ ๊ด€๋ฆฌ
        • Releases ๊ธฐ๋Šฅ์„ ์ด์šฉํ•ด์„œ ๋ฒ„์ „์„ ๊ด€๋ฆฌํ•œ๋‹ค.
  • MEMBER

    • ๊ธฐ๋ณธ convention
      • 1์ผ ์Šคํ”„๋ฆฐํŠธ ์ž‘์—…์‹œ๊ฐ„์„ 8์‹œ๊ฐ„์œผ๋กœ ๊ณ„์‚ฐํ•˜์—ฌ 8 Point๋กœ ์ž‘์—…ํ•œ๋‹ค.
      • ๊ฐ„ํŠธ์ฐจํŠธ๋ฅผ ๊ธฐ๋ฐ˜์œผ๋กœ ์˜ˆ์ƒ ์ด์Šˆ๋ฅผ ํ•ด๋‹น ์Šคํ”„๋ฆฐํŠธ์—์„œ ๊ด€๋ฆฌํ•œ๋‹ค.
      • ์• ์ž์ผ ๋ฐฉ์‹์œผ๋กœ ๋ฐœ์ƒํ•˜๋Š” ์ด์Šˆ๋“ค์„ ํ™œ์„ฑํ™”์ค‘์ธ ์Šคํ”„๋ฆฐํŠธ์— ์‚ฝ์ž…ํ•˜์—ฌ ๊ด€๋ฆฌํ•œ๋‹ค.
      • JIRA๋ฅผ ๊ธฐ๋ฐ˜์œผ๋กœ ์Šคํฌ๋Ÿผ ํšŒ์˜๋ฅผ ์ง„ํ–‰ํ•˜๋ฉฐ, ํ•ญ์ƒ ์ตœ์‹ ํ™”๋œ ์ƒํƒœ๋กœ ์ง„ํ–‰ํ•œ๋‹ค.
    • ์—ญํ• 
      • ์ด์Šˆ ์ƒ์„ฑ

        • ๊ตฌ์„ฑ์š”์†Œ๋ฅผ ์„ ํƒํ•˜์—ฌ ์ด์Šˆ๋ฅผ ๋ถ„๋ฅ˜ํ•œ๋‹ค (๋Œ€์‹œ๋ณด๋“œ๋ฅผ ์œ„ํ•ด!)
        • ์ˆ˜์ •๋ฒ„์ „์„ ์„ ํƒํ•œ๋‹ค (๋Œ€์‹œ๋ณด๋“œ๋ฅผ ์œ„ํ•ด !)
        • ์šฐ์„ ์ˆœ์œ„๋ฅผ ๋ถ€์—ฌํ•œ๋‹ค
        • ๋‹ด๋‹น์ž๋ฅผ ์„ ํƒํ•˜๊ณ , ์—ํ”ฝ๋งํฌ, ์Šคํ”„๋ฆฐํŠธ๋ฅผ ์—ฐ๊ฒฐํ•œ๋‹ค.
        • ์ด์Šˆ๊ฐ€ ์ƒ์„ฑ๋˜๋ฉด ์Šคํ† ๋ฆฌ ํฌ์ธํŠธ๋ฅผ ๋ถ€์—ฌํ•œ๋‹ค.
      • ์ด์Šˆ ๊ด€๋ฆฌ

        • comment ๊ธฐ๋Šฅ์„ ์ด์šฉํ•ด์„œ ์†Œํ†ตํ•œ๋‹ค. @ ๋ฉ˜์…˜ ๊ธฐ๋Šฅ์„ ์ด์šฉํ•˜์—ฌ ๋ชจ๋“  ๋Œ€ํ™”๊ฐ€ JIRA๋ฅผ ์ด์šฉํ•ด์„œ ํ•  ์ˆ˜ ์žˆ๋„๋ก ํ•œ๋‹ค.
  • ์ž‘์—…์œ ํ˜• Convention

    • Epic

      • ํ•ด๋‹น ์ด์Šˆ์„ ํฌ๊ด„ํ•˜๋Š” ํฐ ๋‹จ์œ„์˜ ์—…๋ฌด
    • Story

      • Epic์„ ์ˆ˜ํ–‰ํ•˜๊ธฐ ์œ„ํ•œ main ์—…๋ฌด
    • Sub-task

      • Story๋ฅผ ์ˆ˜ํ–‰ํ•˜๊ธฐ ์œ„ํ•œ ๋ถ€์ž‘์—…
    • Task

      • Epic์„ ์ˆ˜ํ–‰ํ•˜๊ธฐ ์œ„ํ•œ sub ์—…๋ฌด(๋ฌธ์„œ์ž‘์—…, ์กฐ์‚ฌ, ํ•™์Šต ๋“ฑ)

Code Convention๐Ÿค™

footer_docs