Skip to content

๐Ÿ™‹โ€โ™‚๏ธ ์˜ค๋ฆฌ์ง€๋„ BE ๋ ˆํฌ์ง€ํ† ๋ฆฌ

Notifications You must be signed in to change notification settings

KGU-Digital-Assistant/KGU-Digital-Assistant-BE

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿšง์ง„ํ–‰์ค‘

๐Ÿญ Architecture

image

๐ŸŒŠFlow

๋ˆ„๋ฉ”์ดํŠธ_์‹œํ€€์Šค๋‹ค์ด์–ด๊ทธ๋žจrev0

Git Convention

Convention์„ ์ง€ํ‚ค๋Š” ์ด์œ ๋Š” ์ถ”ํ›„ ํŒ€ ํ”„๋กœ์ ํŠธ๋ฅผ ์ง„ํ–‰ ์‹œ ์›ํ™œํ•œ ํ˜‘์—…์„ ํ•˜๊ธฐ ์œ„ํ•œ ์—ฐ์Šต์ž…๋‹ˆ๋‹ค.

2024-09-13 ์ดํ›„ ์ ์šฉ

Branch

๋จธ๋ฆฟ๋ง ์„ค๋ช…
main ์„œ๋น„์Šค ๋ธŒ๋žœ์น˜
release ๋ฐฐํฌ ์ „ ์ž‘์—… ๊ธฐ์ค€
feature ๊ธฐ๋Šฅ ๋‹จ์œ„ ๊ตฌํ˜„
hotfix ์„œ๋น„์Šค ์ค‘ ๊ธด๊ธ‰ ์ˆ˜์ • ๊ฑด์— ๋Œ€ํ•œ ์ฒ˜๋ฆฌ
BE ๋ฐฑ์—”๋“œ ๊ฐœ๋ฐœ ๋ถ€๋ถ„

Commit

ํƒœ๊ทธ ์ด๋ฆ„ ์„ค๋ช…
Feat ์ƒˆ๋กœ์šด ๊ธฐ๋Šฅ์„ ์ถ”๊ฐ€ํ•  ๊ฒฝ์šฐ
Fix ๋ฒ„๊ทธ๋ฅผ ๊ณ ์นœ ๊ฒฝ์šฐ
Design CSS ๋“ฑ ์‚ฌ์šฉ์ž UI ๋””์ž์ธ ๋ณ€๊ฒฝ
!BREAKING CHANGE ์ปค๋‹ค๋ž€ API ๋ณ€๊ฒฝ์˜ ๊ฒฝ์šฐ
!HOTFIX ๊ธ‰ํ•˜๊ฒŒ ์น˜๋ช…์ ์ธ ๋ฒ„๊ทธ๋ฅผ ๊ณ ์ณ์•ผํ•˜๋Š” ๊ฒฝ์šฐ
Style ์ฝ”๋“œ ํฌ๋งท ๋ณ€๊ฒฝ, ์„ธ๋ฏธ ์ฝœ๋ก  ๋ˆ„๋ฝ, ์ฝ”๋“œ ์ˆ˜์ •์ด ์—†๋Š” ๊ฒฝ์šฐ
Refactor ํ”„๋กœ๋•์…˜ ์ฝ”๋“œ ๋ฆฌํŒฉํ† ๋ง
Comment ํ•„์š”ํ•œ ์ฃผ์„ ์ถ”๊ฐ€ ๋ฐ ๋ณ€๊ฒฝ
Docs ๋ฌธ์„œ๋ฅผ ์ˆ˜์ •ํ•œ ๊ฒฝ์šฐ
Test ํ…Œ์ŠคํŠธ ์ถ”๊ฐ€, ํ…Œ์ŠคํŠธ ๋ฆฌํŒฉํ† ๋ง(ํ”„๋กœ๋•์…˜ ์ฝ”๋“œ ๋ณ€๊ฒฝ X)
Chore ๋นŒ๋“œ ํƒœ์ŠคํŠธ ์—…๋ฐ์ดํŠธ, ํŒจํ‚ค์ง€ ๋งค๋‹ˆ์ €๋ฅผ ์„ค์ •ํ•˜๋Š” ๊ฒฝ์šฐ(ํ”„๋กœ๋•์…˜ ์ฝ”๋“œ ๋ณ€๊ฒฝ X)
Rename ํŒŒ์ผ ํ˜น์€ ํด๋”๋ช…์„ ์ˆ˜์ •ํ•˜๊ฑฐ๋‚˜ ์˜ฎ๊ธฐ๋Š” ์ž‘์—…๋งŒ์ธ ๊ฒฝ์šฐ
Remove ํŒŒ์ผ์„ ์‚ญ์ œํ•˜๋Š” ์ž‘์—…๋งŒ ์ˆ˜ํ–‰ํ•œ ๊ฒฝ์šฐ

commit ์ž‘์„ฑ ์‹œ ์ œ๋ชฉ, ๋ณธ๋ฌธ, ๊ผฌ๋ฆฌ๋ง ๋ถ„๋ฆฌํ•ด์„œ ์ž‘์„ฑโ—โ—โ—

์ œ๋ชฉ์€ ์–ด๋–ป๊ฒŒ ์ ๋Š”๊ฐ€?

1. ์ œ๋ชฉ์˜ ์ฒ˜์Œ์€ ๋™์‚ฌ ์›ํ˜•์œผ๋กœ ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค.
2. ์ด ๊ธ€์ž ์ˆ˜๋Š” 50์ž ์ด๋‚ด๋กœ ์ž‘์„ฑํ•ฉ๋‹ˆ๋‹ค.
3. ๋งˆ์ง€๋ง‰์— ํŠน์ˆ˜๋ฌธ์ž๋Š” ์‚ฝ์ž…ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ์˜ˆ) ๋งˆ์นจํ‘œ(.), ๋Š๋‚Œํ‘œ(!), ๋ฌผ์Œํ‘œ(?)
4. ์ œ๋ชฉ์€ ๊ฐœ์กฐ์‹ ๊ตฌ๋ฌธ์œผ๋กœ ์ž‘์„ฑํ•ฉ๋‹ˆ๋‹ค. 
์˜ˆ์‹œ)
Feat: "์ถ”๊ฐ€ get data api ํ•จ์ˆ˜"

๋ณธ๋ฌธ์€ ์–ด๋–ป๊ฒŒ ์ ๋Š”๊ฐ€?

1. ๋ณธ๋ฌธ์€ ํ•œ ์ค„ ๋‹น 72์ž ๋‚ด๋กœ ์ž‘์„ฑํ•ฉ๋‹ˆ๋‹ค.
2. ๋ณธ๋ฌธ ๋‚ด์šฉ์€ ์–‘์— ๊ตฌ์• ๋ฐ›์ง€ ์•Š๊ณ  ์ตœ๋Œ€ํ•œ ์ƒ์„ธํžˆ ์ž‘์„ฑํ•ฉ๋‹ˆ๋‹ค.
3. ๋ณธ๋ฌธ ๋‚ด์šฉ์€ ์–ด๋–ป๊ฒŒ ๋ณ€๊ฒฝํ–ˆ๋Š”์ง€ ๋ณด๋‹ค ๋ฌด์—‡์„ ๋ณ€๊ฒฝํ–ˆ๋Š”์ง€ ๋˜๋Š” ์™œ ๋ณ€๊ฒฝํ–ˆ๋Š”์ง€๋ฅผ ์„ค๋ช…ํ•ฉ๋‹ˆ๋‹ค. 

๊ผฌ๋ฆฌ๋ง์€ ์–ด๋–ป๊ฒŒ ์ ๋Š”๊ฐ€?

1. ๊ผฌ๋ฆฌ๋ง์€ optional์ด๊ณ  ์ด์Šˆ ํŠธ๋ž˜์ปค ID๋ฅผ ์ž‘์„ฑํ•ฉ๋‹ˆ๋‹ค.
2. ๊ผฌ๋ฆฌ๋ง์€ "์œ ํ˜•: #์ด์Šˆ ๋ฒˆํ˜ธ" ํ˜•์‹์œผ๋กœ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.
3. ์—ฌ๋Ÿฌ ๊ฐœ์˜ ์ด์Šˆ ๋ฒˆํ˜ธ๋ฅผ ์ ์„ ๋•Œ๋Š” ์‰ผํ‘œ๋กœ ๊ตฌ๋ถ„ํ•ฉ๋‹ˆ๋‹ค.
4. ์ด์Šˆ ํŠธ๋ž˜์ปค ์œ ํ˜•์€ ๋‹ค์Œ ์ค‘ ํ•˜๋‚˜๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.
ย  ย  - Fixes: ์ด์Šˆ ์ˆ˜์ •์ค‘ (์•„์ง ํ•ด๊ฒฐ๋˜์ง€ ์•Š์€ ๊ฒฝ์šฐ)
ย  ย  - Resolves: ์ด์Šˆ๋ฅผ ํ•ด๊ฒฐํ–ˆ์„ ๋•Œ ์‚ฌ์šฉ
ย  ย  - Ref: ์ฐธ๊ณ ํ•  ์ด์Šˆ๊ฐ€ ์žˆ์„ ๋•Œ ์‚ฌ์šฉ
ย  ย  - Related to: ํ•ด๋‹น ์ปค๋ฐ‹์— ๊ด€๋ จ๋œ ์ด์Šˆ๋ฒˆํ˜ธ (์•„์ง ํ•ด๊ฒฐ๋˜์ง€ ์•Š์€ ๊ฒฝ์šฐ)
ex) Fixes: #45 Related to: #34, #23

์˜ˆ์‹œ

Feat: "์ถ”๊ฐ€ ๋กœ๊ทธ์ธ ํ•จ์ˆ˜"  ---- ์ œ๋ชฉ

๋กœ๊ทธ์ธ API ๊ฐœ๋ฐœ           ---- ๋ณธ๋ฌธ

Resolves: #123             ---- ๊ผฌ๋ฆฌ๋ง
Ref: #456
Related to: #48, #45

์ข‹์€ ์ปค๋ฐ‹ ๋ฉ”์‹œ์ง€๋ฅผ ๋‚จ๊ธฐ๊ธฐ ์œ„ํ•œ 7๊ฐ€์ง€ ์š”์•ฝ

  1. ์ œ๋ชฉ๊ณผ ๋ณธ๋ฌธ์„ ํ•œ ์ค„ ๋„์›Œ์„œ ๊ตฌ๋ถ„ํ•ฉ๋‹ˆ๋‹ค.
  2. ์ œ๋ชฉ์„ 50๊ธ€์ž ์ด๋‚ด๋กœ ์ œํ•œํ•ฉ๋‹ˆ๋‹ค.
  3. ์ œ๋ชฉ ์ฒซ ๊ธ€์ž๋Š” ๋Œ€๋ฌธ์ž๋กœ ์ž‘์„ฑํ•ฉ๋‹ˆ๋‹ค.
  4. ์ œ๋ชฉ ๋์— .(๋งˆ์นจํ‘œ) ๋„ฃ์ง€์•Š์Šต๋‹ˆ๋‹ค.
  5. ์ œ๋ชฉ์€ ๋ช…๋ น๋ฌธ์œผ๋กœ ์‚ฌ์šฉํ•˜๊ณ  ๊ณผ๊ฑฐํ˜•์„ ์‚ฌ์šฉํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
  6. ๋ณธ๋ฌธ์˜ ํ–‰๋งˆ๋‹ค 72๊ธ€์ž ์ด๋‚ด๋กœ ์ œํ•œํ•ฉ๋‹ˆ๋‹ค.
  7. ๋ณธ๋ฌธ์€ ์–ด๋–ป๊ฒŒ ๋ณด๋‹ค๋Š” ๋ฌด์—‡๊ณผ ์™œ๋ฅผ ์„ค๋ช…ํ•˜๋ฉฐ ์ž‘์„ฑํ•ฉ๋‹ˆ๋‹ค.

About

๐Ÿ™‹โ€โ™‚๏ธ ์˜ค๋ฆฌ์ง€๋„ BE ๋ ˆํฌ์ง€ํ† ๋ฆฌ

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •