Skip to content

Latest commit

ย 

History

History
134 lines (105 loc) ยท 4.14 KB

README.md

File metadata and controls

134 lines (105 loc) ยท 4.14 KB

My๋ ฅ์„œ (MyRecord)

๋ˆ„๊ตฌ๋‚˜ ๊ฐ„๋‹จํ•˜๊ฒŒ ์ž‘์„ฑํ•˜๋Š” ๋‚˜์˜ ์—ญ์‚ฌ, My๋ ฅ์„œ

์•ˆ์ „ํ•˜๊ณ  ๊ฐ„ํŽธํ•œ ์˜จ๋ผ์ธ ์ด๋ ฅ์„œ ์ž‘์„ฑ ์„œ๋น„์Šค

๐Ÿšง ์ง„ํ–‰ ์ƒํ™ฉ

  • ํ”„๋กœ์ ํŠธ ์ดˆ๊ธฐ ์„ค์ • (2024-09-05)
  • ๊ธฐ๋ณธ ๋ ˆ์ด์•„์›ƒ ๊ตฌํ˜„ (2024-09-27)
  • shadcn/ui ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ ์ค‘
  • ๋ฐ˜์‘ํ˜• ๋””์ž์ธ ๊ฐœ์„  ์ค‘ ...

๐ŸŽฏ ์†Œ๊ฐœ

My๋ ฅ์„œ๋Š” Next.js ๊ธฐ๋ฐ˜์˜ ์˜จ๋ผ์ธ ์ด๋ ฅ์„œ ์ž‘์„ฑ ์›น ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์ž…๋‹ˆ๋‹ค. ์ด๋ ฅ์„œ์—๋Š” ๊ฐœ์ธ์˜ ํ•™๋ ฅ, ๊ฒฝ๋ ฅ, ์—ฐ๋ฝ์ฒ˜ ๋“ฑ ๋ฏผ๊ฐํ•œ ๊ฐœ์ธ์ •๋ณด๊ฐ€ ํฌํ•จ๋ฉ๋‹ˆ๋‹ค. ์ด๋Ÿฌํ•œ ์ •๋ณด๋ฅผ ์„œ๋ฒ„์— ์ €์žฅํ•˜๋Š” ์ˆœ๊ฐ„, ์œ ์ถœ ์œ„ํ—˜์ด ๋ฐœ์ƒํ•  ์ˆ˜ ์žˆ๋‹ค๋Š” ์ ์„ ๊ณ ๋ฏผํ–ˆ์Šต๋‹ˆ๋‹ค.

๊ทธ๋ž˜์„œ My๋ ฅ์„œ๋Š” ๋ชจ๋“  ๋ฐ์ดํ„ฐ๋ฅผ ์˜ค์ง ์‚ฌ์šฉ์ž์˜ ๋ธŒ๋ผ์šฐ์ €์—๋งŒ ์ €์žฅํ•˜๊ณ , ์„œ๋ฒ„๋ฅผ ์ „ํ˜€ ์‚ฌ์šฉํ•˜์ง€ ์•Š๋Š” ๋ฐฉ์‹์„ ์„ ํƒํ–ˆ์Šต๋‹ˆ๋‹ค. ๋งˆ์น˜ ๊ฐœ์ธ ์ปดํ“จํ„ฐ์—์„œ ๋ฌธ์„œ ์ž‘์—…์„ ํ•˜๋Š” ๊ฒƒ์ฒ˜๋Ÿผ, ์‚ฌ์šฉ์ž์˜ ์†Œ์ค‘ํ•œ ์ •๋ณด๋Š” ์‚ฌ์šฉ์ž์˜ ๊ธฐ๊ธฐ์—๋งŒ ์•ˆ์ „ํ•˜๊ฒŒ ๋ณด๊ด€๋ฉ๋‹ˆ๋‹ค.

ํŠน์žฅ์ 

  • ๊ฐœ์ธ์ •๋ณด ๋ณดํ˜ธ:

    • ์„œ๋ฒ„ ์—†์ด ๋ธŒ๋ผ์šฐ์ €์—์„œ๋งŒ ๋™์ž‘ํ•˜์—ฌ ๋ฐ์ดํ„ฐ ์œ ์ถœ ์›์ฒœ ์ฐจ๋‹จ
    • AES-256 ์•”ํ˜ธํ™”๋กœ ๋กœ์ปฌ ๋ฐ์ดํ„ฐ ๋ณดํ˜ธ
    • IndexedDB๋ฅผ ํ†ตํ•œ ์•ˆ์ „ํ•œ ๋ฐ์ดํ„ฐ ์ €์žฅ
    • CSP๋ฅผ ํ†ตํ•œ ๋ฆฌ์†Œ์Šค ๋ณด์•ˆ ๊ฐ•ํ™”
  • ์•ˆ์ •์ ์ธ ๋ฐ์ดํ„ฐ ๊ด€๋ฆฌ:

    • ์‹ค์‹œ๊ฐ„ ์ž๋™ ์ €์žฅ
    • ๋ธŒ๋ผ์šฐ์ € ์ถฉ๋Œ ๋Œ€๋น„ ๋ฐ์ดํ„ฐ ๋ฐฑ์—…
    • JSON ํ˜•์‹ ๋ฐ์ดํ„ฐ ์ด์‹์„ฑ
    • ์™„์ „ํ•œ ์ดˆ๊ธฐํ™” ๋ฐ ๋ณต์› ์‹œ์Šคํ…œ
  • ์‚ฌ์šฉ์ž ๊ฒฝํ—˜ ๊ณ ๋ ค:

    • ๋“œ๋ž˜๊ทธ ์•ค ๋“œ๋กญ ์„น์…˜ ์ •๋ ฌ
    • ์ปค์Šคํ…€ ์„น์…˜ ์ง€์›
    • PC ํ™˜๊ฒฝ ์ตœ์ ํ™” UI
    • PDF ์ถœ๋ ฅ ์ง€์›
  • ์„ฑ๋Šฅ ๋ฐ ์ ‘๊ทผ์„ฑ:

    • ๋™์  ์ž„ํฌํŠธ๋ฅผ ํ†ตํ•œ ๋ฒˆ๋“ค ์ตœ์ ํ™”
    • ์ด๋ฏธ์ง€ ์••์ถ• ๋ฐ ์ตœ์ ํ™”
    • ์‹œ๋งจํ‹ฑ HTML๊ณผ ARIA ๋ ˆ์ด๋ธ”

๋ฐ์ดํ„ฐ ๋ณด์•ˆ ์•ˆ๋‚ด

๐Ÿ’ก ์‚ฌ์šฉ์ž์˜ ์†Œ์ค‘ํ•œ ์ •๋ณด๋ฅผ ์•ˆ์ „ํ•˜๊ฒŒ ์ง€ํ‚ค๊ธฐ ์œ„ํ•œ ์•ˆ๋‚ด

My๋ ฅ์„œ๋Š” ๋ชจ๋“  ๋ฐ์ดํ„ฐ๋ฅผ ์•”ํ˜ธํ™”ํ•˜์—ฌ ์•ˆ์ „ํ•˜๊ฒŒ ๋ณด๊ด€ํ•ฉ๋‹ˆ๋‹ค. ํ•˜์ง€๋งŒ ๋” ์ฒ ์ €ํ•œ ๋ณด์•ˆ์„ ์œ„ํ•ด์„œ๋Š” ์‚ฌ์šฉ์ž์˜ ์ปดํ“จํ„ฐ๋„ ์•ˆ์ „ํ•˜๊ฒŒ ๊ด€๋ฆฌ๋˜์–ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

  • ์‹ ๋ขฐํ•  ์ˆ˜ ์žˆ๋Š” ๋ฐฑ์‹  ํ”„๋กœ๊ทธ๋žจ ์‚ฌ์šฉ
  • ์šด์˜์ฒด์ œ์™€ ๋ธŒ๋ผ์šฐ์ €์˜ ์ตœ์‹  ๋ณด์•ˆ ์—…๋ฐ์ดํŠธ ์œ ์ง€
  • ์ค‘์š”ํ•œ ์ž‘์—… ํ›„์—๋Š” ๋ฐ์ดํ„ฐ ๋‚ด๋ณด๋‚ด๊ธฐ ๊ธฐ๋Šฅ์œผ๋กœ ๋ฐฑ์—…ํ•˜๊ธฐ

โœจ ์ฃผ์š” ๊ธฐ๋Šฅ

1. ๋ฐ์ดํ„ฐ ๊ด€๋ฆฌ

  • ๐Ÿ“ ์‹ค์‹œ๊ฐ„ ์ž๋™ ์ €์žฅ
  • ๐Ÿ”’ ๋กœ์ปฌ ๋ฐ์ดํ„ฐ ์•”ํ˜ธํ™”
  • ๐Ÿ“ค ๋ฐ์ดํ„ฐ ์ด์‹์„ฑ
    • JSON ํ˜•์‹ ๋‚ด๋ณด๋‚ด๊ธฐ/๊ฐ€์ ธ์˜ค๊ธฐ
    • ํฌ๋กœ์Šค ๋ธŒ๋ผ์šฐ์ € ์ง€์›
    • ๊ธฐ๊ธฐ ๊ฐ„ ๋ฐ์ดํ„ฐ ์ด๋™
  • ๐Ÿ”„ ์ดˆ๊ธฐํ™” ๋ฐ ๋ณต์›

2. ์„น์…˜ ๊ด€๋ฆฌ

  • โœ๏ธ ๊ธฐ๋ณธ ์„น์…˜ (๊ฒฝ๋ ฅ, ํ•™๋ ฅ)
  • โž• ์ปค์Šคํ…€ ์„น์…˜ ์ถ”๊ฐ€/์ˆ˜์ •/์‚ญ์ œ
  • ๐Ÿ”„ ๋“œ๋ž˜๊ทธ ์•ค ๋“œ๋กญ ์ˆœ์„œ ๋ณ€๊ฒฝ
  • ๐Ÿ“Œ ์„น์…˜ ์ ‘๊ธฐ/ํŽผ์น˜๊ธฐ

3. ๋ฌธ์„œ ๊ด€๋ฆฌ

  • ๐Ÿ–จ๏ธ PDF ์ถœ๋ ฅ
  • ๐Ÿ“ฑ ๋ฐ˜์‘ํ˜• ๋””์ž์ธ (PC ์ตœ์ ํ™”)

๐Ÿ› ๏ธ ๊ธฐ์ˆ  ์Šคํƒ

Core

  • Next.js 14
  • React 18
  • Tailwind CSS
  • Zustand (์ƒํƒœ๊ด€๋ฆฌ)

์ฃผ์š” ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ

  • UI/UX

    • @dnd-kit/* : ๋“œ๋ž˜๊ทธ ์•ค ๋“œ๋กญ ๊ตฌํ˜„
    • react-modal : ์ ‘๊ทผ์„ฑ์ด ๊ณ ๋ ค๋œ ๋ชจ๋‹ฌ
    • react-transition-group : ๋ถ€๋“œ๋Ÿฌ์šด ์• ๋‹ˆ๋ฉ”์ด์…˜ ์ฒ˜๋ฆฌ
  • ๋ฐ์ดํ„ฐ & ๋ณด์•ˆ

    • crypto-js : AES-256 ์•”ํ˜ธํ™”
    • dexie : IndexedDB ๋ž˜ํผ
    • browser-image-compression : ์ด๋ฏธ์ง€ ์ตœ์ ํ™”
  • ๊ธฐ๋Šฅ

    • react-to-print : PDF ์ถœ๋ ฅ (๋™์  ์ž„ํฌํŠธ)
    • react-daum-postcode : ์ฃผ์†Œ ๊ฒ€์ƒ‰ (๋™์  ์ž„ํฌํŠธ)

๊ฐœ๋ฐœ ๋„๊ตฌ

  • ESLint : ์ฝ”๋“œ ํ’ˆ์งˆ ๊ด€๋ฆฌ
  • @next/bundle-analyzer : ๋ฒˆ๋“ค ์ตœ์ ํ™”
  • Vercel : ๋ฐฐํฌ ๋ฐ ๋ถ„์„

๐Ÿš€ ์‹œ์ž‘ํ•˜๊ธฐ

์„ค์น˜ ๋ฐฉ๋ฒ•

# ์ €์žฅ์†Œ ๋ณต์ œ
git clone https://github.com/gr22nist/MYR.git

# ์ข…์†์„ฑ ์„ค์น˜
npm install

# ๊ฐœ๋ฐœ ์„œ๋ฒ„ ์‹คํ–‰
npm run dev

ํ™˜๊ฒฝ ๋ณ€์ˆ˜ ์„ค์ •

.env.local ํŒŒ์ผ์„ ์ƒ์„ฑํ•˜๊ณ  ๋‹ค์Œ ๋ณ€์ˆ˜๋ฅผ ์„ค์ •ํ•˜์„ธ์š”:

NEXT_PUBLIC_SECRET_KEY=your-secret-key  # AES-256 ์•”ํ˜ธํ™”์— ์‚ฌ์šฉ๋  ํ‚ค

๐ŸŒ ๋ธŒ๋ผ์šฐ์ € ์ง€์›

  • Chrome (์ตœ์‹  ๋ฒ„์ „)
  • Firefox (์ตœ์‹  ๋ฒ„์ „)
  • Safari (์ตœ์‹  ๋ฒ„์ „)
  • Edge (์ตœ์‹  ๋ฒ„์ „)

โš ๏ธ Internet Explorer๋Š” ์ง€์›ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค

๐Ÿ” ๋ฐ๋ชจ

๐Ÿ“ ๋ผ์ด์„ ์Šค

์ด ํ”„๋กœ์ ํŠธ๋Š” MIT ๋ผ์ด์„ ์Šค๋ฅผ ๋”ฐ๋ฆ…๋‹ˆ๋‹ค. ์ž์„ธํ•œ ๋‚ด์šฉ์€ LICENSE ํŒŒ์ผ์„ ์ฐธ๊ณ ํ•˜์„ธ์š”.