Skip to content
sori-orgPublic

About

[2025 Graduation Project] ๐Ÿฐ ์†Œ์ƒ๊ณต์ธ์˜ ๋ชฉ์†Œ๋ฆฌ๋ฅผ ์šธ๋ ค ํผ์ง€๊ฒŒ, SORI (FE)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

ย 

History

121 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

SORI_FE

"์†Œ์ƒ๊ณต์ธ์˜ ๋ชฉ์†Œ๋ฆฌ, SORI" ํ”„๋กœ์ ํŠธ์˜ ํ”„๋ก ํŠธ์—”๋“œ ์ €์žฅ์†Œ์ž…๋‹ˆ๋‹ค. SORI๋Š” SNS ๋งˆ์ผ€ํŒ…์— ์–ด๋ ค์›€์„ ๊ฒช๋Š” ์†Œ์ƒ๊ณต์ธ๋“ค์„ ์œ„ํ•ด AI ๊ธฐ๋ฐ˜์œผ๋กœ ๋งž์ถคํ˜• ๋งˆ์ผ€ํŒ… ์ฝ˜ํ…์ธ ๋ฅผ ์ž๋™์œผ๋กœ ์ƒ์„ฑํ•ด์ฃผ๋Š” ์›น/์•ฑ ์„œ๋น„์Šค์ž…๋‹ˆ๋‹ค.

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

๊ณผ๊ฑฐ ์†Œ์ƒ๊ณต์ธ๋“ค์˜ ์ฃผ์š” ํ™๋ณด ์ˆ˜๋‹จ์€ ์ „๋‹จ์ง€, ๋ฐฐ๋„ˆ ๋“ฑ ์ธ์‡„๋งค์ฒด ์ค‘์‹ฌ์ด์—ˆ์œผ๋‚˜, ์ตœ๊ทผ์—๋Š” SNS, ๋ธ”๋กœ๊ทธ, ์˜จ๋ผ์ธ ๊ด‘๊ณ  ๋“ฑ ๋””์ง€ํ„ธ ํ”Œ๋žซํผ ์ค‘์‹ฌ์œผ๋กœ ๋น ๋ฅด๊ฒŒ ๋ณ€ํ™”ํ•˜๊ณ  ์žˆ์Šต๋‹ˆ๋‹ค. ์ด๋Ÿฌํ•œ ๋ณ€ํ™” ์†์—์„œ ์˜จ๋ผ์ธ ๋งˆ์ผ€ํŒ…์˜ ์ค‘์š”์„ฑ์€ ๋†’์•„์ง€๊ณ  ์žˆ์ง€๋งŒ, ๋งŽ์€ ์†Œ์ƒ๊ณต์ธ๋“ค์€ ์ฝ˜ํ…์ธ  ์ œ์ž‘๊ณผ SNS ํ™œ์šฉ์— ์–ด๋ ค์›€์„ ๊ฒช๊ณ  ์žˆ์œผ๋ฉฐ, ์‹œ๊ฐ„์ ยท๊ฒฝ์ œ์  ๋ถ€๋‹ด์œผ๋กœ ์ธํ•ด ํšจ๊ณผ์ ์ธ ์˜จ๋ผ์ธ ๋งˆ์ผ€ํŒ… ์‹คํ–‰์ด ์‰ฝ์ง€ ์•Š์€ ์ƒํ™ฉ์ž…๋‹ˆ๋‹ค. ํŠนํžˆ ์กฐ์‚ฌ๊ฒฐ๊ณผ ๋Œ€๋ถ€๋ถ„์˜ ์†Œ์ƒ๊ณต์ธ์˜ ์—ฐ๋ น๋Œ€๋Š” 50~60๋Œ€๋กœ ๋‚˜ํƒ€๋‚ฌ๋Š”๋ฐ ์ด๋“ค์€ SNS ์‚ฌ์šฉ ๊ฒฝํ—˜์ด ์ ๊ณ , ์ฝ˜ํ…์ธ  ๊ธฐํšยท๋””์ž์ธ ์—ญ๋Ÿ‰์ด ๋ถ€์กฑํ•˜์—ฌ ์ „๋ฌธ๊ฐ€ ์˜์กด๋„๊ฐ€ ๋†’๊ณ  ๋น„์šฉ ๋ถ€๋‹ด์ด ํฝ๋‹ˆ๋‹ค. ๊ธฐ์กด ๋งˆ์ผ€ํŒ… ๋Œ€ํ–‰ ์„œ๋น„์Šค๋Š” ์›” ์ˆ˜์‹ญ๋งŒ ์› ์ด์ƒ์˜ ๋น„์šฉ์ด ์†Œ์š”๋˜๋ฉฐ, ๋””์ž์ธ ์™ธ์ฃผ ์—ญ์‹œ 1๊ฑด๋‹น ์ˆ˜๋งŒ ์› ์ด์ƒ์˜ ๋‹จ๊ฐ€๋กœ ์†Œ์ƒ๊ณต์ธ์ด ์ง€์†์ ์œผ๋กœ ์ด์šฉํ•˜๊ธฐ์—๋Š” ๊ฒฝ์ œ์  ๋ถ€๋‹ด์ด ํฝ๋‹ˆ๋‹ค. ๋˜ํ•œ, ๋ณ€ํ™”ํ•˜๋Š” ์†Œ๋น„์ž ํŠธ๋ Œ๋“œ์™€ SNS ์•Œ๊ณ ๋ฆฌ์ฆ˜์— ๋”ฐ๋ผ ์ •ํ˜•ํ™”๋œ ์ฝ˜ํ…์ธ ๋กœ๋Š” ์†Œ๋น„์ž์˜ ๊ด€์‹ฌ์„ ๋Œ๊ธฐ ์–ด๋ ค์šด ์ƒํ™ฉ์ž…๋‹ˆ๋‹ค. ๋”ฐ๋ผ์„œ, ์ดˆ๋ณด์ž๋„ ์‰ฝ๊ฒŒ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๊ณ , ์‹œ๊ฐ„๊ณผ ๋น„์šฉ์„ ์ ˆ๊ฐํ•  ์ˆ˜ ์žˆ์œผ๋ฉฐ, ์ฐจ๋ณ„ํ™”๋œ ์ฝ˜ํ…์ธ ๋ฅผ ์ž๋™์œผ๋กœ ์ƒ์„ฑํ•ด์ฃผ๋Š” ์„œ๋น„์Šค์— ๋Œ€ํ•œ ์ˆ˜์š”๊ฐ€ ๋†’์•„์ง€๊ณ  ์žˆ์Šต๋‹ˆ๋‹ค.

์ด์— ๋”ฐ๋ผ, ๋ณธ ํ”„๋กœ์ ํŠธ์—์„œ๋Š” AI ๊ธฐ๋ฐ˜ ์ž๋™ ์ฝ˜ํ…์ธ  ์ƒ์„ฑ ํ”Œ๋žซํผ "์†Œ๋ฆฌ(SORI)"๋ฅผ ๊ฐœ๋ฐœํ•˜์—ฌ, ์†Œ์ƒ๊ณต์ธ๋“ค์˜ ๋งˆ์ผ€ํŒ… ํšจ์œจ์„ฑ์„ ๋†’์ด๊ณ  ์ง€์—ญ ๊ฒฝ์ œ ํ™œ์„ฑํ™”์— ๊ธฐ์—ฌํ•˜๊ณ ์ž ํ•ฉ๋‹ˆ๋‹ค. '์†Œ๋ฆฌ'๋ผ๋Š” ์ด๋ฆ„์€ ์‹œ์žฅ์˜ ์†Œ๋ฆฌ์— ๊ท€ ๊ธฐ์šธ์ด๊ณ , ์†Œ์ƒ๊ณต์ธ์˜ ๋ชฉ์†Œ๋ฆฌ๋ฅผ ๋งˆ์ผ€ํŒ… ์ฝ˜ํ…์ธ ๋กœ ์šธ๋ ค ํผ์ง€๊ฒŒ ํ•œ๋‹ค๋Š” ์˜๋ฏธ๋ฅผ ๋‹ด๊ณ  ์žˆ์Šต๋‹ˆ๋‹ค. ์ด ์„œ๋น„์Šค๋Š” ์‚ฌ์šฉ์ž๊ฐ€ ๊ฐ„๋‹จํ•œ ์กฐ์ž‘๋งŒ์œผ๋กœ ํŠธ์œ„ํ„ฐ, ์ธ์Šคํƒ€๊ทธ๋žจ ๋“ฑ ์†Œ์…œ ๋ฏธ๋””์–ด์— ์ ํ•ฉํ•œ ๋งˆ์ผ€ํŒ… ์ฝ˜ํ…์ธ ๋ฅผ ์ƒ์„ฑํ•  ์ˆ˜ ์žˆ๋„๋ก ๋•์Šต๋‹ˆ๋‹ค. AI๋ฅผ ํ™œ์šฉํ•ด ์ด๋ฏธ์ง€์™€ ํ…์ŠคํŠธ ํ˜•์‹, ๋„ค์ปท๋งŒํ™”, ํ‘œ์ง€ ์ด 3๊ฐ€์ง€ ํ˜•ํƒœ๋กœ ๊ฒฐ๊ณผ๋ฅผ ์ œ๊ณตํ•˜๋ฉฐ, ๋‚ ์”จ ๋ฐ์ดํ„ฐ, ๋ฆฌ๋ทฐ ๋ฐ์ดํ„ฐ, ํŠธ๋ Œ๋“œ ๋ฐ์ดํ„ฐ, ์ง€์—ญ ํ–‰์‚ฌ ์ •๋ณด ์ค‘์—์„œ ์„ ํƒํ•˜์—ฌ ์ฝ˜ํ…์ธ ์— ๋ฐ˜์˜ํ•จ์œผ๋กœ์จ ์‚ฌ์šฉ์ž ๋งž์ถคํ˜• ๋งˆ์ผ€ํŒ… ์ž๋ฃŒ๋ฅผ ํšจ๊ณผ์ ์œผ๋กœ ์ƒ์„ฑํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์ด๋ฅผ ํ†ตํ•ด ์ •ํ˜•ํ™”๋œ ๋งˆ์ผ€ํŒ… ๋„๊ตฌ์™€ ์ฐจ๋ณ„ํ™”๋œ ๋…์ฐฝ์ ์ธ ์ฝ˜ํ…์ธ ๋ฅผ ์ œ๊ณตํ•˜๋ฉฐ, ์ฝ˜ํ…์ธ  ์ œ์ž‘ ์‹œ๊ฐ„์„ ๋‹จ์ถ•ํ•˜๊ณ  ๋งˆ์ผ€ํŒ… ๋น„์šฉ์„ ์ ˆ๊ฐํ•˜๋Š” ๋™์‹œ์—, ๋„๋‹ฌ๋ฅ ๊ณผ ๊ณ ๊ฐ ์ฐธ์—ฌ์œจ์„ ํšจ๊ณผ์ ์œผ๋กœ ๋†’์ผ ์ˆ˜ ์žˆ๋„๋ก ์ง€์›ํ•ฉ๋‹ˆ๋‹ค. ๊ถ๊ทน์ ์œผ๋กœ๋Š” ์†Œ์ƒ๊ณต์ธ์˜ ๋งˆ์ผ€ํŒ… ํšจ์œจ์„ฑ ์ฆ๋Œ€์™€ ์ง€์—ญ ๊ฒฝ์ œ ํ™œ์„ฑํ™”์— ๊ธฐ์—ฌํ•˜๋Š” ๊ฒƒ์„ ๋ชฉํ‘œ๋กœ ํ•ฉ๋‹ˆ๋‹ค.

์ฃผ์š” ๊ธฐ๋Šฅ

  • ๋งˆ์ผ€ํŒ… ์ฝ˜ํ…์ธ  ์ž๋™ ์ƒ์„ฑ: ์‚ฌ์šฉ์ž์˜ ๊ฐ„๋‹จํ•œ ์„ ํƒ(ํ™๋ณด ์ฑ„๋„, ํ™๋ณด ๋Œ€์ƒ, ํƒ€๊ฒŸ์ธต, ํฌํ•จ ์ •๋ณด ๋“ฑ)์„ ๊ธฐ๋ฐ˜์œผ๋กœ AI๊ฐ€ ์ž๋™์œผ๋กœ ๋งˆ์ผ€ํŒ… ๊ฒŒ์‹œ๋ฌผ์„ ์ƒ์„ฑํ•ฉ๋‹ˆ๋‹ค.
  • ๋‹ค์–‘ํ•œ ์ฝ˜ํ…์ธ  ํ˜•์‹: ์ด๋ฏธ์ง€/ํ…์ŠคํŠธ ํ˜•์‹, ๋„ค์ปท๋งŒํ™”, ํ‘œ์ง€ ๋“ฑ 3๊ฐ€์ง€ ํ˜•ํƒœ๋กœ ์ฝ˜ํ…์ธ ๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.
  • Tip ๋ฒ„ํŠผ: ์‚ฌ์šฉ์ž๊ฐ€ ์‰ฝ๊ฒŒ ์ดํ•ดํ•  ์ˆ˜ ์žˆ๋„๋ก ๋•์Šต๋‹ˆ๋‹ค. SNS ์‚ฌ์šฉ์ด ์ต์ˆ™ํ•˜์ง€ ์•Š์€ ์‚ฌ์šฉ์ž๋“ค์„ ์œ„ํ•ด ๊ฐ ๋‹จ๊ณ„๋ณ„๋กœ ์œ ์šฉํ•œ ์ •๋ณด๋ฅผ ์ œ๊ณตํ•˜์—ฌ ์‰ฝ๊ฒŒ ๊ธฐ๋Šฅ์„ ์ดํ•ดํ•˜๊ณ  ํ™œ์šฉํ•  ์ˆ˜ ์žˆ๋„๋ก ๋•์Šต๋‹ˆ๋‹ค.
  • My ํŽ˜์ด์ง€: ํ”„๋กœํ•„ ์ˆ˜์ •, ๋กœ๊ทธ์•„์›ƒ, ๊ฐ€๊ฒŒ ์ •๋ณด ์ˆ˜์ •, ๊ฐ€๊ฒŒ ์ •๋ณด ๋“ฑ๋ก, ๊ฐ€๊ฒŒ ์ •๋ณด ์‚ญ์ œ๋ฅผ ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
  • ๊ธฐ๋ก ๋ณด๊ธฐ: ๊ทธ๋™์•ˆ ์ƒ์„ฑํ–ˆ๋˜ ๋งˆ์ผ€ํŒ… ๊ฒŒ์‹œ๋ฌผ์„ ํ™•์ธํ•  ์ˆ˜ ์žˆ์œผ๋ฉฐ, ์˜ค๋ž˜๋œ ์ˆœ ๋˜๋Š” ์ตœ์‹  ์ˆœ์œผ๋กœ ์ •๋ ฌ์ด ๊ฐ€๋Šฅํ•ฉ๋‹ˆ๋‹ค.
  • ์นด์นด์˜ค ๋กœ๊ทธ์ธ: ์นด์นด์˜ค ๋กœ๊ทธ์ธ/์˜ค๋ž˜๋œ์ˆœ or ์ตœ์‹ ์ˆœ์œผ๋กœ ์ •๋ ฌ์ด ๊ฐ€๋Šฅํ•ฉ๋‹ˆ๋‹ค.

๊ธฐ์ˆ  ์Šคํƒ

๋ณธ ์‹œ์Šคํ…œ์€ ํด๋ผ์ด์–ธํŠธ-์„œ๋ฒ„ ์•„ํ‚คํ…์ฒ˜๋ฅผ ๊ธฐ๋ฐ˜์œผ๋กœ ๊ตฌ์ถ•๋˜์—ˆ์Šต๋‹ˆ๋‹ค. ํ”„๋ก ํŠธ์—”๋“œ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์€ ์‚ฌ์šฉ์ž์˜ ์ธํ„ฐํŽ˜์ด์Šค๋ฅผ ๋‹ด๋‹นํ•˜๋ฉฐ, ๋ฐฑ์—”๋“œ API ์„œ๋ฒ„์™€ RESTful ํ†ต์‹ ์„ ํ†ตํ•ด ๋ฐ์ดํ„ฐ๋ฅผ ์ฃผ๊ณ ๋ฐ›์Šต๋‹ˆ๋‹ค. AI ๋ชจ๋ธ์€ ๋ฐฑ์—”๋“œ์—์„œ ํ˜ธ์ถœ ๋ฐ ๊ด€๋ฆฌ๋˜๋ฉฐ, ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์— ์ €์žฅ๋œ ์ •๋ณด๋ฅผ ํ™œ์šฉํ•˜์—ฌ ๋งˆ์ผ€ํŒ… ์ฝ˜ํ…์ธ ๋ฅผ ์ƒ์„ฑํ•ฉ๋‹ˆ๋‹ค.

ํ”„๋ก ํŠธ์—”๋“œ

๋ณธ ํ”„๋กœ์ ํŠธ์˜ ํ”„๋ก ํŠธ์—”๋“œ๋Š” ํ˜„๋Œ€์ ์ธ ์›น ๊ฐœ๋ฐœ ํŠธ๋ Œ๋“œ๋ฅผ ๋ฐ˜์˜ํ•˜๊ณ  ํšจ์œจ์ ์ธ ๊ฐœ๋ฐœ ๋ฐ ์œ ์ง€๋ณด์ˆ˜๋ฅผ ์œ„ํ•ด ๋‹ค์Œ๊ณผ ๊ฐ™์€ ๊ธฐ์ˆ  ์Šคํƒ์„ ์„ ์ •ํ•˜์˜€์Šต๋‹ˆ๋‹ค.

  • ํ•ต์‹ฌ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ: React v18.3.1
    • ์ปดํฌ๋„ŒํŠธ ๊ธฐ๋ฐ˜ ๊ฐœ๋ฐœ: UI ์š”์†Œ๋ฅผ ์žฌ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ์ปดํฌ๋„ŒํŠธ๋กœ ๋ถ„๋ฆฌํ•˜์—ฌ ๊ฐœ๋ฐœ ์ƒ์‚ฐ์„ฑ ๋ฐ ์œ ์ง€๋ณด์ˆ˜์„ฑ์„ ํ–ฅ์ƒ์‹œ์ผฐ์Šต๋‹ˆ๋‹ค.
    • ์„ ์–ธ์  UI: ๋ฐ์ดํ„ฐ ๋ณ€ํ™”์— ๋”ฐ๋ฅธ UI ์—…๋ฐ์ดํŠธ๋ฅผ ํšจ์œจ์ ์œผ๋กœ ๊ด€๋ฆฌํ•˜์—ฌ ๋ณต์žกํ•œ ์‚ฌ์šฉ์ž ์ธํ„ฐํŽ˜์ด์Šค ๊ตฌํ˜„์— ์šฉ์ดํ•ฉ๋‹ˆ๋‹ค.
    • ํ™œ๋ฐœํ•œ ์ปค๋ฎค๋‹ˆํ‹ฐ: ํ’๋ถ€ํ•œ ์ž๋ฃŒ์™€ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ์ง€์›์œผ๋กœ ๊ฐœ๋ฐœ ๊ณผ์ •์˜ ๋‚œ์ด๋„๋ฅผ ๋‚ฎ์ท„์Šต๋‹ˆ๋‹ค.
  • ๋นŒ๋“œ ๋„๊ตฌ: Vite v6.0.1
    • ๋น ๋ฅธ ๊ฐœ๋ฐœ ์„œ๋ฒ„: HMR(Hot Module Replacement)์„ ํ†ตํ•œ ๋น ๋ฅธ ๊ฐœ๋ฐœ ํ™˜๊ฒฝ์„ ์ œ๊ณตํ•˜์—ฌ ๊ฐœ๋ฐœ ํšจ์œจ์„ฑ์„ ๊ทน๋Œ€ํ™”ํ–ˆ์Šต๋‹ˆ๋‹ค.
    • ์ตœ์ ํ™”๋œ ๋นŒ๋“œ: Rollup ๊ธฐ๋ฐ˜์˜ ์ตœ์ ํ™”๋œ ๋ฒˆ๋“ค๋ง์„ ํ†ตํ•ด ๋ฐฐํฌ์šฉ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์˜ ์„ฑ๋Šฅ์„ ํ™•๋ณดํ–ˆ์Šต๋‹ˆ๋‹ค.
  • ์ƒํƒœ ๊ด€๋ฆฌ: Zustand v5.0.2
    • ๊ฒฝ๋Ÿ‰์„ฑ ๋ฐ ๊ฐ„๊ฒฐ์„ฑ: ์ตœ์†Œํ•œ์˜ API๋กœ ์ „์—ญ ์ƒํƒœ๋ฅผ ํšจ๊ณผ์ ์œผ๋กœ ๊ด€๋ฆฌํ•  ์ˆ˜ ์žˆ์–ด ๋Ÿฌ๋‹ ์ปค๋ธŒ๊ฐ€ ๋‚ฎ๊ณ  ์ฝ”๋“œ์˜ ๊ฐ€๋…์„ฑ์ด ์ข‹์Šต๋‹ˆ๋‹ค.
    • ์œ ์—ฐํ•œ ์ƒํƒœ ๊ตฌ์กฐ: ๋‹ค๋‹จ๊ณ„ ํผ ๋ฐ์ดํ„ฐ(formData)์™€ UI ๊ด€๋ จ ์ƒํƒœ(currentStepIndex) ๋“ฑ ๋ณต์žกํ•œ ์ „์—ญ ์ƒํƒœ๋ฅผ ํšจ๊ณผ์ ์œผ๋กœ ๊ด€๋ฆฌํ•˜๋Š” ๋ฐ ํ™œ์šฉํ–ˆ์Šต๋‹ˆ๋‹ค.
  • HTTP ํ†ต์‹ : Axios v1.8.4
    • Promise ๊ธฐ๋ฐ˜ HTTP ํด๋ผ์ด์–ธํŠธ: ๋ฐฑ์—”๋“œ API์™€์˜ ๋น„๋™๊ธฐ ํ†ต์‹ (GET, POST ๋“ฑ)์„ ๊ฐ„ํŽธํ•˜๊ฒŒ ์ฒ˜๋ฆฌํ•˜๊ณ , ์ธํ„ฐ์…‰ํ„ฐ ๊ธฐ๋Šฅ์„ ํ†ตํ•ด ์ธ์ฆ ํ† ํฐ ๊ด€๋ฆฌ ๋ฐ ๊ณตํ†ต ์—๋Ÿฌ ํ•ธ๋“ค๋ง์„ ํšจ์œจ์ ์œผ๋กœ ๊ตฌํ˜„ํ–ˆ์Šต๋‹ˆ๋‹ค.
  • ๋ผ์šฐํŒ…: React Router DOM v6.0.2
    • SPA์—์„œ ํŽ˜์ด์ง€ ์ „ํ™˜ ๋ฐ URL ๊ด€๋ฆฌ๋ฅผ ๋‹ด๋‹นํ•˜์—ฌ ์‚ฌ์šฉ์ž๊ฐ€ ์ž์—ฐ์Šค๋Ÿฌ์šด ๋‚ด๋น„๊ฒŒ์ด์…˜ ๊ฒฝํ—˜์„ ํ•  ์ˆ˜ ์žˆ๋„๋ก ์ง€์›ํ•ฉ๋‹ˆ๋‹ค.
  • ํผ ๊ด€๋ฆฌ: React Hook Form v7.55.0, @hookform/resolvers v5.0.1, Zod v3.24.2
    • ํผ ์œ ํšจ์„ฑ ๊ฒ€์‚ฌ ๋ฐ ํผ ๋ฐ์ดํ„ฐ ๊ด€๋ฆฌ๋ฅผ ์œ„ํ•œ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ์ž…๋‹ˆ๋‹ค. ๋ Œ๋”๋ง ์ตœ์ ํ™”๋ฅผ ํ†ตํ•ด ๋ณต์žกํ•œ ํผ์—์„œ๋„ ์„ฑ๋Šฅ ์ €ํ•˜ ์—†์ด ํšจ์œจ์ ์ธ ์‚ฌ์šฉ์ž ๊ฒฝํ—˜์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.
    • react-hook-form๊ณผ ์œ ํšจ์„ฑ ๊ฒ€์‚ฌ ์Šคํ‚ค๋งˆ(์˜ˆ: Zod)๋ฅผ ์—ฐ๋™ํ•˜๋Š” ๋ฐ ์‚ฌ์šฉ๋˜์—ˆ์Šต๋‹ˆ๋‹ค.
    • Zod๋Š” ๋Ÿฐํƒ€์ž„ ์œ ํšจ์„ฑ ๊ฒ€์‚ฌ๋ฅผ ์œ„ํ•œ ์Šคํ‚ค๋งˆ ์ •์˜ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ์ž…๋‹ˆ๋‹ค. ๊ฐ•๋ ฅํ•œ ํƒ€์ž… ์ถ”๋ก  ๊ธฐ๋Šฅ์„ ์ œ๊ณตํ•˜์—ฌ ํผ ๋ฐ์ดํ„ฐ์˜ ํƒ€์ž… ์•ˆ์ „์„ฑ์„ ๋†’์ด๊ณ , ๋ฐฑ์—”๋“œ ์Šคํ‚ค๋งˆ์™€์˜ ์ผ๊ด€์„ฑ์„ ์œ ์ง€ํ•˜๋Š” ๋ฐ ๊ธฐ์—ฌํ–ˆ์Šต๋‹ˆ๋‹ค.
  • ์Šคํƒ€์ผ๋ง: styled-components v6.1.13, styled-reset v4.5.2
    • styled-components๋Š” CSS-in-JS ๋ฐฉ์‹์œผ๋กœ ์ปดํฌ๋„ŒํŠธ ์Šค์ฝ”ํ”„ ์Šคํƒ€์ผ๋ง์„ ํ†ตํ•ด ์Šคํƒ€์ผ ์ถฉ๋Œ์„ ๋ฐฉ์ง€ํ•˜๊ณ , ์ปดํฌ๋„ŒํŠธ์™€ ์Šคํƒ€์ผ์„ ํ•จ๊ป˜ ๊ด€๋ฆฌํ•˜์—ฌ ์œ ์ง€๋ณด์ˆ˜์„ฑ์„ ๋†’์˜€์Šต๋‹ˆ๋‹ค.
    • props๋ฅผ ํ™œ์šฉํ•œ ์กฐ๊ฑด๋ถ€ ์Šคํƒ€์ผ๋ง์œผ๋กœ ์œ ์—ฐํ•˜๊ณ  ์žฌ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ UI ์ปดํฌ๋„ŒํŠธ ์ƒ์„ฑ์ด ๊ฐ€๋Šฅํ–ˆ์Šต๋‹ˆ๋‹ค.
    • styled-reset์€ ๋ธŒ๋ผ์šฐ์ € ๊ฐ„ ๊ธฐ๋ณธ ์Šคํƒ€์ผ ๋ถˆ์ผ์น˜๋ฅผ ํ•ด์†Œํ•˜์—ฌ ์ผ๊ด€๋œ UI ๋ Œ๋”๋ง ํ™˜๊ฒฝ์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.
  • ๋งˆํฌ๋‹ค์šด ๋ Œ๋”๋ง: react-markdown v10.1.0
    • ๋ฐฑ์—”๋“œ์—์„œ ์ „๋‹ฌ๋ฐ›์€ ๋งˆํฌ๋‹ค์šด ํ˜•์‹์˜ ํ…์ŠคํŠธ(description)๋ฅผ HTML๋กœ ๋ณ€ํ™˜ํ•˜์—ฌ ์‚ฌ์šฉ์ž์—๊ฒŒ ํ’๋ถ€ํ•œ ์‹œ๊ฐ์  ์ฝ˜ํ…์ธ ๋ฅผ ์ œ๊ณตํ•˜๋Š” ๋ฐ ํ™œ์šฉ๋˜์—ˆ์Šต๋‹ˆ๋‹ค.
  • ๋ฐ์ดํ„ฐ ํŽ˜์นญ: @tanstack/react-query v5.74.4, @tanstack/react-query-devtools v5.74.4
    • ์„œ๋ฒ„ ์ƒํƒœ(Server State) ๊ด€๋ฆฌ๋ฅผ ์œ„ํ•œ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ์ž…๋‹ˆ๋‹ค.
    • ๋ฐ์ดํ„ฐ ์บ์‹ฑ, ๋น„๋™๊ธฐ ๋ฐ์ดํ„ฐ ๋™๊ธฐํ™”, ๋กœ๋”ฉ/์—๋Ÿฌ ์ƒํƒœ ๊ด€๋ฆฌ ๋“ฑ์„ ์ž๋™ํ™”ํ•˜์—ฌ API ๋ฐ์ดํ„ฐ ํŽ˜์นญ์˜ ๋ณต์žก์„ฑ์„ ์ค„์ด๊ณ  ์‚ฌ์šฉ์ž ๊ฒฝํ—˜์„ ํ–ฅ์ƒ์‹œ์ผฐ์Šต๋‹ˆ๋‹ค.
    • @tanstack/react-query-devtools๋Š” React Query ๊ฐœ๋ฐœ์ž ๋„๊ตฌ๋กœ, ์บ์‹ฑ๋œ ๋ฐ์ดํ„ฐ ํ™•์ธ ๋ฐ ์ฟผ๋ฆฌ ์ƒํƒœ ๋””๋ฒ„๊น…์— ํ™œ์šฉ๋˜์–ด ๊ฐœ๋ฐœ ํšจ์œจ์„ฑ์„ ๋†’์˜€์Šต๋‹ˆ๋‹ค.
  • ๊ฐœ๋ฐœ ๋„๊ตฌ: ESLint v9.15.0, MSW v2.7.4
    • ESLint๋Š” ์ฝ”๋“œ ํ’ˆ์งˆ ์œ ์ง€ ๋ฐ ์Šคํƒ€์ผ ๊ฐ€์ด๋“œ๋ฅผ ์ค€์ˆ˜ํ•˜๊ธฐ ์œ„ํ•œ ๋ฆฐํŠธ ๋„๊ตฌ์ž…๋‹ˆ๋‹ค. ํŒ€ ๋‚ด ์ฝ”๋”ฉ ์ปจ๋ฒค์…˜ ๊ฐ•์ œ ๋ฐ ์ž ์žฌ์  ์˜ค๋ฅ˜๋ฅผ ์‚ฌ์ „์— ๋ฐฉ์ง€ํ•˜๋Š” ๋ฐ ๊ธฐ์—ฌํ–ˆ์Šต๋‹ˆ๋‹ค.
    • MSW(Mock Service Worker)๋Š” ๋„คํŠธ์›Œํฌ ์š”์ฒญ์„ ๊ฐ€๋กœ์ฑ„์–ด API๋ฅผ ๋ชจํ‚นํ•˜๋Š” ๋ฐ ์‚ฌ์šฉ๋ฉ๋‹ˆ๋‹ค. ๋ฐฑ์—”๋“œ ๊ฐœ๋ฐœ์ด ์™„๋ฃŒ๋˜์ง€ ์•Š์•˜๊ฑฐ๋‚˜, ํŠน์ • ์‹œ๋‚˜๋ฆฌ์˜ค ํ…Œ์ŠคํŠธ๋ฅผ ์œ„ํ•ด ๋…๋ฆฝ์ ์ธ ํ”„๋ก ํŠธ์—”๋“œ ๊ฐœ๋ฐœ ํ™˜๊ฒฝ์„ ๊ตฌ์ถ•ํ•˜๋Š” ๋ฐ ํ™œ์šฉ๋  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

๋ฐฑ์—”๋“œ

๋ณธ ํ”„๋กœ์ ํŠธ์˜ ๋ฐฑ์—”๋“œ ์‹œ์Šคํ…œ์€ FastAPI ํ”„๋ ˆ์ž„์›Œํฌ๋ฅผ ๊ธฐ๋ฐ˜์œผ๋กœ ๊ตฌ์ถ•๋˜์—ˆ์œผ๋ฉฐ, ๋‹ค์Œ๊ณผ ๊ฐ™์€ ๊ธฐ์ˆ  ์Šคํƒ์„ ์‚ฌ์šฉํ•˜์˜€์Šต๋‹ˆ๋‹ค.

  • ์›น ํ”„๋ ˆ์ž„์›Œํฌ: FastAPI v0.110.0
    • ๋น„๋™๊ธฐ ์ง€์›์œผ๋กœ ๋น ๋ฅธ ์‘๋‹ต ์†๋„์™€ ์ž๋™ Swagger ๋ฌธ์„œ ์ƒ์„ฑ์œผ๋กœ ๊ฐœ๋ฐœ ํŽธ์˜์„ฑ์„ ์ฆ๋Œ€ํ–ˆ์Šต๋‹ˆ๋‹ค.
  • ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค: MySQL 8.x
    • ๊ตฌ์กฐํ™”๋œ ๊ด€๊ณ„ํ˜• ๋ฐ์ดํ„ฐ ๊ด€๋ฆฌ์— ์ ํ•ฉํ•˜๋ฉฐ AWS EC2์— ํ˜ธํ™˜์„ฑ์ด ์šฐ์ˆ˜ํ•ฉ๋‹ˆ๋‹ค.
  • ORM: SQLAlchemy v2.x
    • ๊ฐ์ฒด-๊ด€๊ณ„ ๋งคํ•‘์„ ํ†ตํ•ด Python ๊ฐ์ฒด ๊ธฐ๋ฐ˜ DB ์ž‘์—…์ด ๊ฐ€๋Šฅํ•ฉ๋‹ˆ๋‹ค.
  • ์ธ์ฆ: OAuth2 (Kakao), JWT
    • Kakao ์†Œ์…œ ๋กœ๊ทธ์ธ ์—ฐ๋™ ๋ฐ JWT ๊ธฐ๋ฐ˜ ์ธ์ฆ์œผ๋กœ Stateless ์•„ํ‚คํ…์ฒ˜๋ฅผ ๊ตฌํ˜„ํ–ˆ์Šต๋‹ˆ๋‹ค.
  • ํ™˜๊ฒฝ ๋ณ€์ˆ˜ ๊ด€๋ฆฌ: python-dotenv v1.0.0
    • ๋ฏผ๊ฐ ์ •๋ณด ๋ถ„๋ฆฌ๋ฅผ ์œ„ํ•œ ํ™˜๊ฒฝ ๋ณ€์ˆ˜ ์„ค์ •์„ ์šฉ์ดํ•˜๊ฒŒ ํ–ˆ์Šต๋‹ˆ๋‹ค.
  • ๋ฐฐํฌ: EC2 + Uvicorn + Nginx (Ubuntu 22.04 ๊ธฐ๋ฐ˜ EC2 ์ธ์Šคํ„ด์Šค)
    • ์œ ์—ฐํ•œ ์„œ๋ฒ„ ๊ด€๋ฆฌ ๋ฐ ์‹ค์‹œ๊ฐ„ ๋ฐฐํฌ ์ ์šฉ์ด ๊ฐ€๋Šฅํ•ฉ๋‹ˆ๋‹ค.

About

[2025 Graduation Project] ๐Ÿฐ ์†Œ์ƒ๊ณต์ธ์˜ ๋ชฉ์†Œ๋ฆฌ๋ฅผ ์šธ๋ ค ํผ์ง€๊ฒŒ, SORI (FE)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages