Skip to content
kosa11-final-projectPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

ย 

History

132 Commits

Folders and files

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

Repository files navigation

ํ˜„๋Œ€๊ทธ๋ฆฐํ‘ธ๋“œ ์žฌ๊ณ  ์šด์˜ ํ”Œ๋žซํผ ํ”„๋ก ํŠธ์—”๋“œ

ํ˜„๋Œ€๊ทธ๋ฆฐํ‘ธ๋“œ์˜ ๋‹ค์ค‘ ํŒ๋งค์ฑ„๋„ ์žฌ๊ณ ๋ฅผ ํ†ตํ•ฉ ์กฐํšŒํ•˜๊ณ  ์œ„ํ—˜ ์žฌ๊ณ ์™€ AI ์‹คํ–‰ ์ „๋žต์„ ๊ด€๋ฆฌํ•˜๊ธฐ ์œ„ํ•œ B2B ์šด์˜ ํ”Œ๋žซํผ์˜ ํ”„๋ก ํŠธ์—”๋“œ ๊ธฐ๋ฐ˜์ž…๋‹ˆ๋‹ค.

์ตœ๊ทผ ํ†ต๊ณ„ ์ž‘์—…

  • AI ์ „๋žต ์„ฑ๊ณผ์™€ ์œ„ํ—˜์žฌ๊ณ  ์ถ”์ด๋ฅผ ์‹ค์ œ ํ†ต๊ณ„ API์— ์—ฐ๊ฒฐํ–ˆ์Šต๋‹ˆ๋‹ค.
  • ๊ธฐ๊ฐ„ยท์žฌ๊ณ  ์œ„์น˜ ํ•„ํ„ฐ์™€ ์„ฑ๊ณผ ์ง€ํ‘œยท์ถ”์ด ์ฐจํŠธ๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.

ํ†ตํ•ฉ ์žฌ๊ณ  ์กฐํšŒ์˜ ๋กœ์ปฌ feature ๋ฒ”์œ„๋Š” ๊ตฌํ˜„๋˜์–ด ์žˆ์Šต๋‹ˆ๋‹ค. ์•ฑ ์…ธ, ๋ผ์šฐํ„ฐ, FSD-lite ํด๋” ๊ตฌ์กฐ, HTTP ํ†ต์‹  ๊ฒฝ๊ณ„, ๋””์ž์ธ ํ† ํฐ, ์žฌ์‚ฌ์šฉ UI, Storybook, ํ…Œ์ŠคํŠธ์™€ CI ๊ธฐ๋ฐ˜์ด ๊ตฌ์„ฑ๋˜์–ด ์žˆ์œผ๋ฉฐ, ์‹ค์ œ source syncยทOracle ๋ฐ˜์˜์€ ๋ณ„๋„ ํ›„์† ๋ฒ”์œ„์ž…๋‹ˆ๋‹ค.

ํ†ตํ•ฉ ์žฌ๊ณ ์˜ ๋ฌผ๋ฆฌ ์Šคํ‚ค๋งˆ๋Š” BackEnd Flyway V1~V16์ด ์šฐ์„ ํ•ฉ๋‹ˆ๋‹ค. ํ™”๋ฉด์—์„œ๋Š” on_hand_qty ์ง‘๊ณ„๋ฅผ ๊ฐ€์šฉ์žฌ๊ณ , reserved_qty ์ง‘๊ณ„๋ฅผ ์˜ˆ์•ฝ์žฌ๊ณ , ๋‘ ๊ฐ’์˜ ํ•ฉ์ธ total_qty๋ฅผ ์ด์žฌ๊ณ ๋กœ ํ‘œ์‹œํ•˜๋ฉฐ FrontEnd๊ฐ€ ์˜ˆ์•ฝ์ˆ˜๋Ÿ‰์„ ๋‹ค์‹œ ์ฐจ๊ฐํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ์„ธ๋ถ€ ์ •ํ•ฉ์„ฑ ์ž‘์—…์€ workspace์˜ ../docs/integrated-inventory/SCHEMA-FLYWAY-WORKLIST.md๋ฅผ ๊ธฐ์ค€์œผ๋กœ ํ•ฉ๋‹ˆ๋‹ค.

Spring Security ์„ธ์…˜ ๋กœ๊ทธ์ธ๊ณผ ํ˜„์žฌ ์‚ฌ์šฉ์ž ์กฐํšŒ ๊ณ„์•ฝ์„ ์—ฐ๊ฒฐํ–ˆ์œผ๋ฉฐ, ์„ธ๋ถ€ ๊ถŒํ•œ ์ •์ฑ…, ์žฌ๊ณ  ์กฐํšŒยทํŽ˜์ด์ง€๋„ค์ด์…˜๊ณผ ๋ฐฐํฌ ํ™˜๊ฒฝ์€ ๊ธฐ๋Šฅ ๋˜๋Š” ์šด์˜ ๋‹จ๊ณ„์—์„œ ํ™•์ •ํ•ฉ๋‹ˆ๋‹ค. ๊ณตํ†ต ๊ฐœ๋ฐœ ํ™˜๊ฒฝ, lintยทformat, ํ…Œ์ŠคํŠธ์™€ PR ์ž๋™ ๊ฒ€์ฆ์€ ์ด ์ €์žฅ์†Œ์— ํฌํ•จ๋˜์–ด ์žˆ์Šต๋‹ˆ๋‹ค.

์ฒ˜์Œ ์ฐธ์—ฌํ•˜๋Š” ํŒ€์›์€ ๋จผ์ € docs/team-onboarding.md๋ฅผ ์ˆœ์„œ๋Œ€๋กœ ์ง„ํ–‰ํ•ฉ๋‹ˆ๋‹ค. ํŒ€์›์ด ์ดํ•ดํ•˜๊ธฐ ์‰ฝ๊ฒŒ ์„ค๋ช…ํ•  ๋•Œ๋Š” docs/team-frontend-handbook.md๋ฅผ ์‚ฌ์šฉํ•˜๊ณ , ํ† ํฐยท์ปดํฌ๋„ŒํŠธยทAPI์˜ ์ƒ์„ธ ๊ธฐ์ค€์€ docs/frontend-foundation-team-guide.md์—์„œ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.

๋น ๋ฅธ ์‹œ์ž‘

ํ•„์ˆ˜ ๋ฒ„์ „์€ Node.js 24 LTS์™€ pnpm 11.18.0์ž…๋‹ˆ๋‹ค. .nvmrc, package.json, CI๊ฐ€ ๋ชจ๋‘ ๊ฐ™์€ ๋ฒ„์ „์„ ๊ธฐ์ค€์œผ๋กœ ํ•ฉ๋‹ˆ๋‹ค.

node --version
corepack enable
pnpm --version
pnpm install --frozen-lockfile
cp .env.example .env.local
pnpm exec playwright install chromium
pnpm run check
pnpm run test:e2e
pnpm dev
  • node --version: v24.x
  • pnpm --version: 11.18.0
  • ์•ฑ: http://localhost:5173
  • Storybook: pnpm storybook ์‹คํ–‰ ํ›„ http://localhost:6006

Windows PowerShell์—์„œ๋Š” ํ™˜๊ฒฝ ํŒŒ์ผ์„ Copy-Item .env.example .env.local๋กœ ๋ณต์‚ฌํ•ฉ๋‹ˆ๋‹ค. ๋ชจ๋“  ๊ฐ’์— ๋กœ์ปฌ ๊ธฐ๋ณธ๊ฐ’์ด ์žˆ์œผ๋ฏ€๋กœ ์ฒซ ์‹คํ–‰์—์„œ๋Š” .env.local์˜ ๊ฐ’์„ ๊ทธ๋Œ€๋กœ ๋‘์–ด๋„ ๋ฉ๋‹ˆ๋‹ค.

PR ์ „ ํ•„์ˆ˜ ๊ฒ€์ฆ:

pnpm run audit:prod
pnpm run check
pnpm run test:e2e
pnpm run build-storybook

์šด์˜ ํ”„๋ก ํŠธ์—”๋“œ ๋ฐฐํฌ

์šด์˜ ํ”„๋ก ํŠธ์—”๋“œ๋Š” Jenkins๊ฐ€ main ๋ณ€๊ฒฝ์„ Poll SCM์œผ๋กœ ํ™•์ธํ•œ ๋’ค dist/๋ฅผ Amazon S3์— ๋™๊ธฐํ™”ํ•˜๊ณ  CloudFront ์บ์‹œ๋ฅผ ๋ฌดํšจํ™”ํ•ฉ๋‹ˆ๋‹ค. Jenkins Job, EC2 IAM Role, S3 ๋ฐ CloudFront ๊ฐ’ ์„ค์ •์€ ํ”„๋ก ํŠธ์—”๋“œ Jenkins ๋ฐฐํฌ ๊ฐ€์ด๋“œ๋ฅผ ์ฐธ๊ณ ํ•ฉ๋‹ˆ๋‹ค.

pnpm run audit:prod๋Š” high ์ด์ƒ ์šด์˜ ์˜์กด์„ฑ ์ทจ์•ฝ์ ์„ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค. pnpm run check๋Š” ESLint, Prettier ๊ฒ€์‚ฌ, Vitest, production build๋ฅผ ์ˆœ์„œ๋Œ€๋กœ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค. GitHub์—์„œ๋„ PR๋งˆ๋‹ค ๊ฐ™์€ ๊ฒ€์‚ฌ์™€ Storybook build, Playwright๋ฅผ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.

ํ™˜๊ฒฝ๋ณ€์ˆ˜๋Š” .env.example์„ ๊ธฐ์ค€์œผ๋กœ .env.local์— ์ž‘์„ฑํ•ฉ๋‹ˆ๋‹ค. VITE_๊ฐ€ ๋ถ™์€ ๊ฐ’์€ ๋ธŒ๋ผ์šฐ์ € ๋ฒˆ๋“ค์— ๋…ธ์ถœ๋˜๋ฏ€๋กœ ๋น„๋ฐ€๋ฒˆํ˜ธ, ์„ธ์…˜ ๊ฐ’, AWS ํ‚ค์™€ ๊ฐ™์€ secret์„ ๋„ฃ์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

๊ธฐ๋ณธ ํ™”๋ฉด๊ณผ ๋ผ์šฐํ„ฐ

๊ฒฝ๋กœ ํ™”๋ฉด ํ˜„์žฌ ๋ฒ”์œ„
/login ๋กœ๊ทธ์ธ CSRF ๋ฐœ๊ธ‰, ์„ธ์…˜ ๋กœ๊ทธ์ธ, ์˜ค๋ฅ˜ ์ƒํƒœ ์—ฐ๊ฒฐ
/dashboard ๋Œ€์‹œ๋ณด๋“œ ๊ธฐ๋ณธ ํŽ˜์ด์ง€์™€ ์•ฑ ์…ธ ์—ฐ๊ฒฐ
/inventory ํ†ตํ•ฉ ์žฌ๊ณ  ์กฐํšŒ ๋ชฉ๋กยทํ•„ํ„ฐยท์ƒ์„ธยทLOTยท์ˆ˜์š”์˜ˆ์ธกยท์œ„ํ—˜ยท๊ฐ€๊ฒฉยท๋ฏธํ• ๋‹น ์žฌ๊ณ  ๊ตฌํ˜„, source sync๋Š” ์ค€๋น„ ์ค‘
/ai-strategy AI ์ „๋žต ๋ฐ ์‹œ๋ฎฌ๋ ˆ์ด์…˜ ๊ธฐ๋ณธ ํŽ˜์ด์ง€ ์—ฐ๊ฒฐ
/execution AI ์ „๋žต ๊ธฐ๋ก & ์„ฑ๊ณผ ๊ธฐ๋ณธ ํŽ˜์ด์ง€ ์—ฐ๊ฒฐ
/statistics ํ†ต๊ณ„ ๊ธฐ๋ณธ ํŽ˜์ด์ง€ ์—ฐ๊ฒฐ
/heendi-loader ๋กœ๋”ฉ ๋ชจ์…˜ ํ™•์ธ MP4 ๋ ˆํผ๋Ÿฐ์Šค์™€ Lottie ์Šคํ”ผ๋„ˆ ๋น„๊ต

๋กœ๊ทธ์ธํ•˜์ง€ ์•Š์€ ์‚ฌ์šฉ์ž๊ฐ€ ๋ฃจํŠธ(/) ๋˜๋Š” ์—…๋ฌด ๊ฒฝ๋กœ์— ์ ‘๊ทผํ•˜๋ฉด /login์œผ๋กœ ์ด๋™ํ•ฉ๋‹ˆ๋‹ค. ๋กœ๊ทธ์ธ ํ›„ ๋ฃจํŠธ๋Š” /dashboard๋กœ ์ด๋™ํ•˜๋ฉฐ, ์‚ฌ์šฉ์ž๊ฐ€ ๋จผ์ € ์ ‘๊ทผํ•œ ์—…๋ฌด ๊ฒฝ๋กœ๊ฐ€ ์žˆ์œผ๋ฉด ํ•ด๋‹น ๊ฒฝ๋กœ๋กœ ๋Œ์•„๊ฐ‘๋‹ˆ๋‹ค. ๋ผ์šฐํŠธ ์ •์˜๋Š” src/app/router/router.jsx, ๋ฉ”๋‰ด์˜ ๋‹จ์ผ ์ถœ์ฒ˜๋Š” src/widgets/app-shell/model/navigation.js์ž…๋‹ˆ๋‹ค.

๊ธฐ์ˆ  ์Šคํƒ๊ณผ ์—ญํ• 

์˜์—ญ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ์—ญํ• ๊ณผ ์‚ฌ์šฉ ๊ธฐ์ค€ ํ˜„์žฌ ์ƒํƒœ
UI React 19, JavaScript ํ•จ์ˆ˜ ์ปดํฌ๋„ŒํŠธ์™€ hooks ๊ธฐ๋ฐ˜ UI ๊ธฐ๋ฐ˜ ์—ฐ๊ฒฐ ์™„๋ฃŒ
๋นŒ๋“œ Vite ๊ฐœ๋ฐœ ์„œ๋ฒ„, ๋ฒˆ๋“ค, @ โ†’ src alias, ์„ ํƒ์  /api proxy ์™„๋ฃŒ
ํŒจํ‚ค์ง€ pnpm ์˜์กด์„ฑ๊ณผ lockfile ๊ด€๋ฆฌ ์™„๋ฃŒ
๋ผ์šฐํ„ฐ React Router DOM v7 URL, ์ค‘์ฒฉ layout, ํŽ˜์ด์ง€ ์ด๋™ ์™„๋ฃŒ
์„œ๋ฒ„ ์ƒํƒœ TanStack Query v5 ์„œ๋ฒ„ ๋ฐ์ดํ„ฐ ์บ์‹œ, ๋กœ๋”ฉยท์˜ค๋ฅ˜, ์žฌ์กฐํšŒ, ๋ฌดํšจํ™” Provider์™€ query options ์˜ˆ์‹œ ์™„๋ฃŒ
HTTP Axios base URL, timeout, ์ฟ ํ‚ค ์ „์†ก, CSRF header, ์˜ค๋ฅ˜ ์ •๊ทœํ™” ๊ณตํ†ต client ์™„๋ฃŒ
ํด๋ผ์ด์–ธํŠธ ์ƒํƒœ Zustand ์—ฌ๋Ÿฌ ํ™”๋ฉด์ด ๊ณต์œ ํ•˜๋Š” UI ์ƒํƒœ๋งŒ ๊ด€๋ฆฌ ์„ค์น˜ ์™„๋ฃŒ, ํ•„์š”ํ•  ๋•Œ store ์ƒ์„ฑ
ํผ React Hook Form, Zod ์ž…๋ ฅ ์ƒํƒœ, ๊ฒ€์ฆ, ์ œ์ถœ ์ฒ˜๋ฆฌ ๋กœ๊ทธ์ธ ํผ ์ ์šฉ ์™„๋ฃŒ
ํ…Œ์ด๋ธ” TanStack Table v8 ์ปฌ๋Ÿผยทํ–‰ ๋ชจ๋ธ๊ณผ ์ •๋ ฌ, ์žฌ์‚ฌ์šฉ ํ…Œ์ด๋ธ” ๊ป๋ฐ๊ธฐ DataTable ์™„๋ฃŒ
์ฐจํŠธ Recharts ์ˆ˜์š”์˜ˆ์ธก ๋ฐ ์ „๋žต ์„ฑ๊ณผ ์‹œ๊ฐํ™” ์ˆ˜์š”์˜ˆ์ธก ํƒญ ์ ์šฉ ์™„๋ฃŒ
์Šคํƒ€์ผ Tailwind CSS v4 layout๊ณผ token ๊ธฐ๋ฐ˜ ์Šคํƒ€์ผ๋ง ์™„๋ฃŒ
UI ์†Œ์Šค shadcn/ui ๋ฐฉ์‹ ์ฝ”๋“œ๋ฅผ ํ”„๋กœ์ ํŠธ๊ฐ€ ์†Œ์œ ํ•˜๊ณ  ๋””์ž์ธ ํ† ํฐ์— ๋งž์ถฐ ์ˆ˜์ • ์™„๋ฃŒ
ํด๋ž˜์Šค ์กฐํ•ฉ cn, clsx, tailwind-merge ์กฐ๊ฑด๋ถ€ class์™€ Tailwind ์ถฉ๋Œ ์ •๋ฆฌ ์™„๋ฃŒ
variant Class Variance Authority Button, Badge์ฒ˜๋Ÿผ ์˜๋ฏธ ์žˆ๋Š” variant ๊ด€๋ฆฌ ์™„๋ฃŒ
์ ‘๊ทผ์„ฑ primitive Radix Slot, Tooltip asChild, tooltip, ํ‚ค๋ณด๋“œยทํฌ์ปค์Šค ๊ธฐ๋ฐ˜ ์™„๋ฃŒ
์•„์ด์ฝ˜ reicon-react ์•ฑ์—์„œ ์‚ฌ์šฉํ•˜๋Š” ์œ ์ผํ•œ ์•„์ด์ฝ˜ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ์™„๋ฃŒ
๋ชจ์…˜ lottie-web ๊ณตํ†ต Lottie ๋กœ๋”ฉ ์Šคํ”ผ๋„ˆ๋ฅผ ๋™์  import๋กœ ์žฌ์ƒ ์™„๋ฃŒ
UI ๋ฌธ์„œ Storybook ๋””์ž์ธ ํ† ํฐ๊ณผ ๊ณตํ†ต ์ปดํฌ๋„ŒํŠธ ์ƒํƒœ ํ™•์ธ ์™„๋ฃŒ
๋‹จ์œ„ ํ…Œ์ŠคํŠธ Vitest formatter, mapper, query key, ์ƒํƒœ ๊ทœ์น™ ๊ฒ€์ฆ ๊ธฐ๋ฐ˜ ์™„๋ฃŒ
E2E Playwright ๋ผ์šฐํŒ…๊ณผ ์‹ค์ œ ์‚ฌ์šฉ์ž ํ๋ฆ„ ๊ฒ€์ฆ ๊ธฐ๋ฐ˜ ์™„๋ฃŒ
์ฝ”๋“œ ํ’ˆ์งˆ ESLint, Prettier ์˜ค๋ฅ˜ ํƒ์ง€์™€ ๊ณตํ†ต ํฌ๋งท ๊ฒ€์ฆ ์™„๋ฃŒ
CI GitHub Actions PR๋งˆ๋‹ค lint, format, test, build, Storybook, E2E ๊ฒ€์ฆ ์™„๋ฃŒ

@tanstack/react-virtual์€ ์„ค์น˜ํ•˜์ง€ ์•Š์•˜์Šต๋‹ˆ๋‹ค. ์ด ์„œ๋น„์Šค๋Š” ์„œ๋ฒ„ ํŽ˜์ด์ง€๋„ค์ด์…˜์„ ๊ธฐ๋ณธ์œผ๋กœ ํ•˜๋ฉฐ, ํ•œ ํŽ˜์ด์ง€์˜ ํ–‰ ์ˆ˜ ๋•Œ๋ฌธ์— ์‹ค์ œ ์„ฑ๋Šฅ ๋ฌธ์ œ๊ฐ€ ํ™•์ธ๋  ๋•Œ๋งŒ ๋ณ„๋„๋กœ ๋„์ž…ํ•ฉ๋‹ˆ๋‹ค. HTTP ํด๋ผ์ด์–ธํŠธ๋Š” Axios๋กœ ํ†ต์ผํ–ˆ๊ณ  Ky ๊ด€๋ จ ์ฝ”๋“œ๋Š” ์‚ฌ์šฉํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

FSD-lite ์ ์šฉ ๋ฒ”์œ„

์ด ํ”„๋กœ์ ํŠธ๋Š” Feature-Sliced Design์„ ์ „๋ถ€ ์—„๊ฒฉํ•˜๊ฒŒ ์ ์šฉํ•˜์ง€ ์•Š๊ณ , 4๋ช…์˜ ํ’€์Šคํƒ ํŒ€์›์ด ๋น ๋ฅด๊ฒŒ ์ดํ•ดํ•  ์ˆ˜ ์žˆ๋Š” FSD-lite๋กœ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.

์ ์šฉํ•˜๋Š” ์ด์œ :

  • ํŽ˜์ด์ง€๊ฐ€ ๋Š˜์–ด๋„ UI, ๋„๋ฉ”์ธ ๊ทœ์น™, ์‚ฌ์šฉ์ž ํ–‰๋™, ์„œ๋ฒ„ ํ†ต์‹ ์˜ ์ฑ…์ž„์ด ์„ž์ด์ง€ ์•Š๊ฒŒ ํ•ฉ๋‹ˆ๋‹ค.
  • ์žฌ๊ณ  ์ƒํƒœ, ํ•„ํ„ฐ, ์ƒ์„ธ Drawer์ฒ˜๋Ÿผ ์—ฌ๋Ÿฌ ํ™”๋ฉด์—์„œ ์žฌ์‚ฌ์šฉ๋˜๋Š” ๊ธฐ๋Šฅ์˜ ์œ„์น˜๋ฅผ ์˜ˆ์ธกํ•  ์ˆ˜ ์žˆ๊ฒŒ ํ•ฉ๋‹ˆ๋‹ค.
  • ํ•œ ํŒŒ์ผ์— ํŽ˜์ด์ง€ ์ „์ฒด ๋กœ์ง์ด ์Œ“์ด๋Š” ๊ฒƒ์„ ๋ง‰๊ณ  ํŒ€์›์ด ๋™์‹œ์— ์ž‘์—…ํ•  ๋•Œ ์ถฉ๋Œ ๋ฒ”์œ„๋ฅผ ์ค„์ž…๋‹ˆ๋‹ค.
  • shared๊ฐ€ ์žฌ๊ณ ๋‚˜ ์ „๋žต ๊ฐ™์€ ๋„๋ฉ”์ธ์„ ์•Œ์ง€ ๋ชปํ•˜๊ฒŒ ํ•ด ๊ณตํ†ต ์ปดํฌ๋„ŒํŠธ์˜ ์žฌ์‚ฌ์šฉ์„ฑ์„ ์œ ์ง€ํ•ฉ๋‹ˆ๋‹ค.

์˜์กด์„ฑ์€ ์œ„์—์„œ ์•„๋ž˜ ๋ฐฉํ–ฅ์œผ๋กœ๋งŒ ํ๋ฆ…๋‹ˆ๋‹ค.

app โ†’ pages โ†’ widgets โ†’ features โ†’ entities โ†’ shared
๊ณ„์ธต ์—ญํ•  ์ด ํ”„๋กœ์ ํŠธ์˜ ์˜ˆ์‹œ
app ์•ฑ ์ „์ฒด ์ƒ๋ช…์ฃผ๊ธฐ์™€ ์กฐ๋ฆฝ Provider, Router, AppLayout
pages URL์— ๋Œ€์‘ํ•˜๋Š” ์ตœ์ข… ํ™”๋ฉด ์กฐํ•ฉ InventoryPage, DashboardPage
widgets ์—ฌ๋Ÿฌ featureยทentity๋ฅผ ๋ฌถ์€ ๋…๋ฆฝ ์—…๋ฌด ๋ธ”๋ก AppShell, InventoryTable, InventorySummary
features ์‚ฌ์šฉ์ž์˜ ํ•œ ๊ฐ€์ง€ ํ–‰๋™๊ณผ ๊ทธ ์ƒํƒœ inventory-filter, inventory-sync, inventory-detail
entities ๋„๋ฉ”์ธ ๋ฐ์ดํ„ฐ, API, ํ‘œ์‹œ ๊ทœ์น™ inventory, product, sales-channel, strategy
shared ๋„๋ฉ”์ธ์„ ๋ชจ๋ฅด๋Š” ๊ณตํ†ต ๊ธฐ๋ฐ˜ UI primitive, Axios client, env, ์œ ํ‹ธ๋ฆฌํ‹ฐ
_template ํŒ€์›์šฉ ๊ตฌ์กฐ ์˜ˆ์‹œ ์ƒˆ slice๋ฅผ ๋งŒ๋“ค ๋•Œ ์ฐธ๊ณ ํ•˜๋ฉฐ ์•ฑ์—์„œ importํ•˜์ง€ ์•Š์Œ

FSD๋ฅผ ์–ต์ง€๋กœ ์ ์šฉํ•˜์ง€ ์•Š๋Š” ๊ธฐ์ค€:

  • ํ•œ ํŽ˜์ด์ง€์—์„œ๋งŒ ์“ฐ๋Š” ์ฝ”๋“œ๋Š” ๋จผ์ € ํ•ด๋‹น pages/<page> ์•ˆ์— ๋‘ก๋‹ˆ๋‹ค.
  • ๋‘ ๊ณณ ์ด์ƒ์—์„œ ๊ฐ™์€ ์˜๋ฏธ์™€ ์ƒํƒœ ๊ทœ์น™์œผ๋กœ ์‚ฌ์šฉ๋  ๋•Œ widgets, features, entities๋กœ ์˜ฌ๋ฆฝ๋‹ˆ๋‹ค.
  • ๋‹จ์ˆœ ๋ฐฐ์น˜๋งŒ ํ•˜๋Š” ์ปดํฌ๋„ŒํŠธ๋ฅผ ๋ฌด์กฐ๊ฑด widget์œผ๋กœ ๋งŒ๋“ค์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
  • ๋‹จ์ˆœ ํด๋ฆญ handler๋ฅผ ๋ฌด์กฐ๊ฑด feature๋กœ ๋งŒ๋“ค์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
  • shared/ui์—๋Š” ํ˜„๋Œ€๊ทธ๋ฆฐํ‘ธ๋“œ, ์žฌ๊ณ , LOT, ์ „๋žต ๊ฐ™์€ ๋„๋ฉ”์ธ ์šฉ์–ด๋ฅผ ๋„ฃ์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
  • ๊ฐ slice ์™ธ๋ถ€์—์„œ๋Š” ๊ฐ€๋Šฅํ•œ ํ•œ index.js ๊ณต๊ฐœ ์ง„์ž…์ ์œผ๋กœ importํ•ฉ๋‹ˆ๋‹ค.

ํด๋” ๊ตฌ์กฐ

src/
โ”œโ”€ app/
โ”‚  โ”œโ”€ providers/                 # TanStack Query, Tooltip
โ”‚  โ”œโ”€ router/                    # ์ „์ฒด route ์ •์˜
โ”‚  โ””โ”€ layouts/                   # ์ „์—ญ widget๊ณผ Outlet ๋ฐฐ์น˜
โ”œโ”€ pages/
โ”‚  โ”œโ”€ dashboard/                 # /dashboard
โ”‚  โ”œโ”€ inventory/                 # /inventory
โ”‚  โ”œโ”€ ai-strategy/               # /ai-strategy
โ”‚  โ”œโ”€ execution/                 # /execution
โ”‚  โ””โ”€ statistics/                # /statistics
โ”œโ”€ widgets/
โ”‚  โ”œโ”€ app-shell/                 # ์‹ค์ œ Header, Sidebar, navigation ์กฐํ•ฉ
โ”‚  โ”œโ”€ inventory-summary/         # ์žฌ๊ณ  ์š”์•ฝ ์—…๋ฌด ๋ธ”๋ก
โ”‚  โ”œโ”€ inventory-table/           # ํ•„ํ„ฐ์™€ ์žฌ๊ณ  ํ…Œ์ด๋ธ” ์กฐํ•ฉ
โ”‚  โ”œโ”€ inventory-detail-drawer/   # ๋น ๋ฅธ ์ƒ์„ธ ํ™•์ธ ๋ธ”๋ก
โ”‚  โ””โ”€ strategy-performance/      # ์ „๋žต ์„ฑ๊ณผ ๋ธ”๋ก
โ”œโ”€ features/
โ”‚  โ”œโ”€ inventory-filter/          # ์žฌ๊ณ  ํ•„ํ„ฐ ํ–‰๋™
โ”‚  โ”œโ”€ inventory-sync/            # ์žฌ๊ณ  ๋™๊ธฐํ™” ํ–‰๋™
โ”‚  โ””โ”€ inventory-detail/          # ์ƒ์„ธ ์—ด๊ธฐ ํ–‰๋™
โ”œโ”€ entities/
โ”‚  โ”œโ”€ inventory/
โ”‚  โ”‚  โ”œโ”€ api/                    # API ํ•จ์ˆ˜, query key์™€ options
โ”‚  โ”‚  โ”œโ”€ model/                  # ์žฌ๊ณ  ํƒ€์ž…ยท์ƒํƒœยท๋„๋ฉ”์ธ ๊ทœ์น™
โ”‚  โ”‚  โ””โ”€ ui/                     # ์œ„ํ—˜ badge, ๋ฒ”์œ„ ์นด๋“œ, LOT ํ–‰
โ”‚  โ”œโ”€ product/
โ”‚  โ”œโ”€ sales-channel/
โ”‚  โ””โ”€ strategy/
โ”œโ”€ shared/
โ”‚  โ”œโ”€ api/                       # Axios, CSRF, ApiError, requestJson
โ”‚  โ”œโ”€ config/                    # ํ™˜๊ฒฝ๋ณ€์ˆ˜ ์ •๊ทœํ™”
โ”‚  โ”œโ”€ hooks/                     # useMediaQuery ๋“ฑ ๋ฒ”์šฉ React hook
โ”‚  โ”œโ”€ lib/                       # cn๊ณผ ์ˆซ์žยท๋‚ ์งœ formatter
โ”‚  โ””โ”€ ui/                        # shadcn ๊ธฐ๋ฐ˜ ๊ณตํ†ต UI์™€ Storybook
โ”œโ”€ _template/                    # FSD ์‚ฌ์šฉ ์˜ˆ์‹œ ๋ฌธ์„œ
โ”œโ”€ styles.css                    # ์ „์—ญ ๋””์ž์ธ ํ† ํฐ๊ณผ ์†Œ์œ ๊ถŒ๋ณ„ CSS
โ””โ”€ main.jsx                      # ์•ฑ ์ง„์ž…์ 

์‚ฌ์ด๋“œ๋ฐ”์™€ ํ—ค๋”์˜ ๊ณตํ†ต primitive๋Š” shared/ui, ์‹ค์ œ ๋ฉ”๋‰ดยท์‚ฌ์šฉ์žยทํ˜„์žฌ ๊ฒฝ๋กœ๋ฅผ ๋ฌถ๋Š” ์กฐํ•ฉ์€ widgets/app-shell, ์ตœ์ข… ๋ฐฐ์น˜๋Š” app/layouts/AppLayout.jsx๊ฐ€ ๋‹ด๋‹นํ•ฉ๋‹ˆ๋‹ค. ๋”ฐ๋ผ์„œ Layout ํ•œ ํŒŒ์ผ์— ์ „์ฒด navigation JSX๋ฅผ ๋„ฃ์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

๊ตฌ์ฒด์ ์ธ ์ƒˆ ๊ธฐ๋Šฅ ๋ฐฐ์น˜ ์˜ˆ์‹œ๋Š” src/_template/README.md๋ฅผ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.

๋ฐ˜๋ณต๋˜๋Š” ํ•˜์œ„ ํด๋”์™€ ํŒŒ์ผ ์ด๋ฆ„

FSD ๊ณ„์ธต ์•ˆ์—์„œ๋Š” ๋‹ค์Œ segment ์ด๋ฆ„์„ ๊ฐ™์€ ์˜๋ฏธ๋กœ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.

์ด๋ฆ„ ์—ญํ•  ์˜ˆ์‹œ
api endpoint ํ•จ์ˆ˜, query key, QueryยทMutation options inventoryApi.js, inventoryQueries.js
api/clients Axios์ฒ˜๋Ÿผ ์‹ค์ œ HTTP ๋„๊ตฌ์˜ ๊ณตํ†ต instance axiosClient.js
model mapper, schema, constants, store์™€ ๋„๋ฉ”์ธ ์ƒํƒœ ๊ทœ์น™ inventoryMapper.js
ui ์‚ฌ์šฉ์ž์—๊ฒŒ ๋ณด์ด๋Š” React ์ปดํฌ๋„ŒํŠธ InventoryScopeCard.jsx
lib React์™€ ๋„๋ฉ”์ธ์— ์˜์กดํ•˜์ง€ ์•Š๋Š” ์ˆœ์ˆ˜ ์œ ํ‹ธ๋ฆฌํ‹ฐ formatter, cn.js
hooks ์—ฌ๋Ÿฌ ๊ณณ์—์„œ ์žฌ์‚ฌ์šฉํ•˜๋Š” React hook useMediaQuery.js
config ํ™˜๊ฒฝ๋ณ€์ˆ˜์™€ ๋ณ€๊ฒฝ๋˜์ง€ ์•Š๋Š” ์•ฑ ์„ค์ • env.js
providers ์•ฑ ์ „์ฒด Context์™€ ์™ธ๋ถ€ Provider ์—ฐ๊ฒฐ AppProviders.jsx
layouts ์ „์—ญ widget๊ณผ Router Outlet ๋ฐฐ์น˜ AppLayout.jsx
router route, redirect, lazy route ๊ฒฝ๊ณ„ router.jsx
stories ๊ณตํ†ต UI์˜ ๋…๋ฆฝ ์ƒํƒœ ๋ฌธ์„œ Button.stories.jsx

lib์€ React ์—†์ด ์ž…๋ ฅ์„ ๊ฒฐ๊ณผ๋กœ ๋ฐ”๊พธ๋Š” ์ˆœ์ˆ˜ ์ฝ”๋“œ, hooks๋Š” React lifecycle๊ณผ state๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ์ฝ”๋“œ์ž…๋‹ˆ๋‹ค. api๋Š” ํ†ต์‹ , model์€ ํ†ต์‹  ๊ฒฐ๊ณผ๋ฅผ ํ”„๋ก ํŠธ ๋„๋ฉ”์ธ์œผ๋กœ ํ•ด์„ํ•˜๋Š” ์—ญํ• ์ž…๋‹ˆ๋‹ค.

ํŒŒ์ผ ์ด๋ฆ„๋„ ์—ญํ• ์„ ๋“œ๋Ÿฌ๋‚ด๋„๋ก ํ†ต์ผํ•ฉ๋‹ˆ๋‹ค.

ํŒจํ„ด ์˜๋ฏธ
*Api.js endpoint๋ณ„ HTTP ํ•จ์ˆ˜
*Queries.js query key์™€ Query options factory
*Mutations.js mutation options์™€ ๋ฌดํšจํ™” ๊ทœ์น™
*Mapper.js API DTO๋ฅผ ํ”„๋ก ํŠธ ๋ชจ๋ธ๋กœ ๋ณ€ํ™˜
*Schema.js Zod ๊ฒ€์ฆ schema
*Store.js Zustand ์ „์—ญ UI store
use*.js React hook
*.test.js Vitest ํ…Œ์ŠคํŠธ
*.stories.jsx Storybook ๋ฌธ์„œ
index.js slice ์™ธ๋ถ€์— ๋…ธ์ถœํ•  ๊ณต๊ฐœ API

๋” ์ž์„ธํ•œ ์œ„์น˜ ๊ฒฐ์ •, ๋ช…๋ช…, ์ƒํƒœ ์†Œ์œ ๊ถŒ ๊ธฐ์ค€์€ docs/development-conventions.md๋ฅผ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.

API ํ†ต์‹  ๊ทœ์น™

Axios์™€ TanStack Query๋Š” ๋Œ€์ฒด ๊ด€๊ณ„๊ฐ€ ์•„๋‹ˆ๋ผ ์„œ๋กœ ๋‹ค๋ฅธ ์ฑ…์ž„์„ ๊ฐ€์ง‘๋‹ˆ๋‹ค.

Page / Widget
  โ†’ TanStack Query options
    โ†’ Entity API function
      โ†’ requestJson
        โ†’ axiosClient
          โ†’ Spring Boot API
  • Axios๋Š” ์‹ค์ œ HTTP ์š”์ฒญ, timeout, withCredentials, CSRF header, ๊ณตํ†ต ์˜ค๋ฅ˜ ๋ณ€ํ™˜์„ ๋‹ด๋‹นํ•ฉ๋‹ˆ๋‹ค.
  • TanStack Query๋Š” ์„œ๋ฒ„ ์ƒํƒœ ์บ์‹œ, ๋กœ๋”ฉยท์˜ค๋ฅ˜ ์ƒํƒœ, ์žฌ์กฐํšŒ์™€ ๋ฌดํšจํ™”๋ฅผ ๋‹ด๋‹นํ•ฉ๋‹ˆ๋‹ค.
  • ํŽ˜์ด์ง€์™€ UI ์ปดํฌ๋„ŒํŠธ์—์„œ Axios๋ฅผ ์ง์ ‘ importํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
  • API ์‘๋‹ต์„ Zustand์— ๋ณต์‚ฌํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
  • Query์˜ signal์„ API ํ•จ์ˆ˜๊นŒ์ง€ ์ „๋‹ฌํ•ด ์ทจ์†Œ ๊ฐ€๋Šฅํ•œ ์š”์ฒญ์„ ์œ ์ง€ํ•ฉ๋‹ˆ๋‹ค.
  • query key๋Š” entity๋ณ„ key factory์—์„œ ๊ด€๋ฆฌํ•ฉ๋‹ˆ๋‹ค.
  • shared/api๋Š” getJson, postJson, putJson, patchJson, deleteJson, headJson named helper๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.

์‚ฌ์šฉ ์˜ˆ์‹œ:

import { useQuery } from '@tanstack/react-query';
import { inventoryListQueryOptions } from '@/entities/inventory';

const query = useQuery(inventoryListQueryOptions(filters));

๊ณตํ†ต ํ†ต์‹  ์ฝ”๋“œ๋Š” src/shared/api, ์žฌ๊ณ  API ์˜ˆ์‹œ๋Š” src/entities/inventory/api์— ์žˆ์Šต๋‹ˆ๋‹ค.

๋ณ€๊ฒฝ ์š”์ฒญ์ด ์ƒ๊ธฐ๋ฉด ์‹ค์ œ ๋„๋ฉ”์ธ API์—์„œ ๊ฐ™์€ options ๊ตฌ์กฐ๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. ์•„์ง ๋ฐฑ์—”๋“œ ๊ณ„์•ฝ์ด ์—†๋Š” ์žฌ๊ณ  ์ˆ˜์ •ยท์‚ญ์ œ endpoint๋ฅผ ๋ฏธ๋ฆฌ ๋งŒ๋“ค์ง€๋Š” ์•Š์Šต๋‹ˆ๋‹ค.

import { postJson } from '@/shared/api';

export function syncInventory(body, signal) {
  return postJson({
    path: 'v1/inventory-sync',
    body,
    signal,
  });
}

์„ธ์…˜ ๋กœ๊ทธ์ธ์€ ๋‹ค์Œ Spring Security ๊ณ„์•ฝ์„ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.

GET  /api/v1/auth/csrf   -> CSRF cookie์™€ header ์ •๋ณด ๋ฐœ๊ธ‰
POST /api/v1/auth/login  -> loginId, password๋กœ ์„ธ์…˜ ๋กœ๊ทธ์ธ
GET  /api/v1/auth/me     -> ํ˜„์žฌ ์„ธ์…˜ ์‚ฌ์šฉ์ž ์กฐํšŒ
POST /api/v1/auth/logout -> ์„œ๋ฒ„ ์„ธ์…˜๊ณผ ์ธ์ฆ cookie ์ œ๊ฑฐ

์•ฑ์€ /me์˜ 401 AUTH-001์„ ๋น„๋กœ๊ทธ์ธ ์ƒํƒœ๋กœ ํ•ด์„ํ•˜๊ณ  ๋ณดํ˜ธ๋œ ์—…๋ฌด ๊ฒฝ๋กœ๋ฅผ /login์œผ๋กœ ์ „ํ™˜ํ•ฉ๋‹ˆ๋‹ค. ๋„คํŠธ์›Œํฌ ์˜ค๋ฅ˜๋‚˜ ์„œ๋ฒ„ ์˜ค๋ฅ˜๋Š” ๋กœ๊ทธ์ธ ํ™”๋ฉด์œผ๋กœ ์ˆจ๊ธฐ์ง€ ์•Š๊ณ  ๋‹ค์‹œ ์‹œ๋„ํ•  ์ˆ˜ ์žˆ๋Š” ์˜ค๋ฅ˜ ์ƒํƒœ๋กœ ํ‘œ์‹œํ•ฉ๋‹ˆ๋‹ค. ์„ธ์…˜ ID๋Š” localStorage, sessionStorage ๋˜๋Š” Zustand์— ์ €์žฅํ•˜์ง€ ์•Š์œผ๋ฉฐ ๋ธŒ๋ผ์šฐ์ €์˜ HttpOnly cookie๊ฐ€ ๊ด€๋ฆฌํ•ฉ๋‹ˆ๋‹ค. ๋กœ๊ทธ์•„์›ƒ ์„ฑ๊ณต ์‹œ ์‚ฌ์šฉ์ž๋ณ„ ์„œ๋ฒ„ ์บ์‹œ๋ฅผ ์ œ๊ฑฐํ•˜๊ณ  /login์œผ๋กœ ์ด๋™ํ•ฉ๋‹ˆ๋‹ค. ์—…๋ฌด API์˜ 401 AUTH-001์€ ์ „์—ญ ์„ธ์…˜ ๋งŒ๋ฃŒ๋กœ ์ฒ˜๋ฆฌํ•˜์—ฌ ์ „์ฒด ์„œ๋ฒ„ ์บ์‹œ๋ฅผ ์ œ๊ฑฐํ•˜๊ณ  ํ˜„์žฌ URL์„ ๋ณด์กดํ•œ ๋’ค ๋กœ๊ทธ์ธ ํ™”๋ฉด์œผ๋กœ ์ด๋™ํ•ฉ๋‹ˆ๋‹ค. ์„ธ๋ถ€ 403 ๊ถŒํ•œ ์ •์ฑ…์€ ํ›„์† ๊ธฐ๋Šฅ์—์„œ ์—ฐ๊ฒฐํ•ฉ๋‹ˆ๋‹ค.

์žฌ์‚ฌ์šฉ UI ๊ทœ์น™

๊ณตํ†ต ์ปดํฌ๋„ŒํŠธ๋Š” src/shared/ui/index.js๋ฅผ ํ†ตํ•ด ๊ฐ€์ ธ์˜ต๋‹ˆ๋‹ค.

import { Badge, Button, Card, DataTable, LottieLoader } from '@/shared/ui';

ํ˜„์žฌ ์ค€๋น„๋œ ์ฃผ์š” ์ปดํฌ๋„ŒํŠธ:

  • ํ–‰๋™: Button, IconButton
  • ์ž…๋ ฅ: Input, Select, Checkbox
  • ํ‘œ๋ฉด: Card, MetricCard, DetailLayout, Drawer
  • ์ƒํƒœ: Badge, StatusDot, Alert, StateView, Skeleton
  • ๋ฐ์ดํ„ฐ: Table, DataTable, Tabs
  • ๋ณด์กฐ UI: Avatar, Tooltip, Icon, Sidebar
  • ๋ชจ์…˜: LoadingMedia, LottieLoader

์‚ฌ์šฉ ์ˆœ์„œ:

  1. ๋จผ์ € shared/ui์™€ Storybook์—์„œ ๊ธฐ์กด ์ปดํฌ๋„ŒํŠธ๋ฅผ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.
  2. ๊ธฐ์กด ์ปดํฌ๋„ŒํŠธ์˜ variant, size, tone, className์œผ๋กœ ํ•ด๊ฒฐํ•ฉ๋‹ˆ๋‹ค.
  3. ๋ฒ”์šฉ ํ‘œํ˜„๋งŒ shared/ui์— ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค.
  4. ์œ„ํ—˜๋“ฑ๊ธ‰, LOT, ์žฌ๊ณ  ๋ฒ”์œ„์ฒ˜๋Ÿผ ๋„๋ฉ”์ธ ์˜๋ฏธ๊ฐ€ ์žˆ์œผ๋ฉด entities/inventory/ui์— ๋‘ก๋‹ˆ๋‹ค.
  5. ๊ณตํ†ต ์ปดํฌ๋„ŒํŠธ๋ฅผ ์ถ”๊ฐ€ํ•˜๊ฑฐ๋‚˜ variant๋ฅผ ๋ณ€๊ฒฝํ•˜๋ฉด Storybook๋„ ํ•จ๊ป˜ ๊ฐฑ์‹ ํ•ฉ๋‹ˆ๋‹ค.

cn()์€ ์กฐ๊ฑด๋ถ€ class ์กฐํ•ฉ๊ณผ Tailwind ์ถฉ๋Œ ์ •๋ฆฌ์— ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. cva()๋Š” Button, Badge, Input์ฒ˜๋Ÿผ ์˜๋ฏธ ์žˆ๋Š” variant๊ฐ€ ๋ฐ˜๋ณต๋  ๋•Œ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. ํŽ˜์ด์ง€ ์ „์šฉ layout์— cva๋ฅผ ๋งŒ๋“ค๊ฑฐ๋‚˜ ํ™”๋ฉด๋งˆ๋‹ค ๋™์ผํ•œ HTMLยทCSS๋ฅผ ๋‹ค์‹œ ์ž‘์„ฑํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

์ˆซ์ž, ๊ธˆ์•ก, ํผ์„ผํŠธ, ์ˆ˜๋Ÿ‰, ๋‚ ์งœ์™€ ์†Œ๋น„๊ธฐํ•œ ํ‘œ๊ธฐ๋Š” ๊ณตํ†ต formatter๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.

import {
  formatCurrency,
  formatDateTime,
  formatDaysRemaining,
  formatNumber,
  formatPercent,
  formatQuantity,
} from '@/shared/lib/format';

๊ธฐ๋ณธ ํ‘œ๊ธฐ๋Š” 2,058, โ‚ฉ8,900, 14.3%, 205๊ฐœ, 2026.08.08 09:05, D-43์ด๋ฉฐ ํ‘œ์‹œํ•  ์ˆ˜ ์—†๋Š” ๊ฐ’์€ -๋กœ ํ†ต์ผํ•ฉ๋‹ˆ๋‹ค. ํ™”๋ฉด๋งˆ๋‹ค toLocaleString()์ด๋‚˜ ๋‚ ์งœ ๋ฌธ์ž์—ด ์กฐํ•ฉ์„ ๋‹ค์‹œ ์ž‘์„ฑํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

๋””์ž์ธ ๊ฐ€์ด๋“œ

๋””์ž์ธ ๋ฐฉํ–ฅ์€ Mesh Forecast ์Šคํƒ€์ผ๊ณผ Dashboard Filter Foundations ์ปฌ๋Ÿฌ ์‹œ์Šคํ…œ์ž…๋‹ˆ๋‹ค. ์—…๋ฌด์šฉ ํ™”๋ฉด์ด๋ฏ€๋กœ ์žฅ์‹๋ณด๋‹ค ํ‘œ, ํ•„ํ„ฐ, ๊ฒ€์ƒ‰๊ณผ ์ƒํƒœ ๋น„๊ต์˜ ๋ช…ํ™•์„ฑ์„ ์šฐ์„ ํ•ฉ๋‹ˆ๋‹ค.

์ปฌ๋Ÿฌ

์—ญํ•  ์ƒ‰์ƒ ์‚ฌ์šฉ ๊ธฐ์ค€
Main #27B06E primary ํ–‰๋™, ํ™œ์„ฑ navigation, ์–‘ํ˜ธ ์ƒํƒœ
Sub Mint #11C6AB ๋ณด์กฐ ๊ฐ•์กฐ
Sub Cyan #00B0D7 ์ •๋ณด, ๋ณดํ†ต ์ƒํƒœ
Sub Orange #FDA643 ์ฃผ์˜ ์ƒํƒœ
Mint Soft #DAF7E9 ์–‘ํ˜ธยทprimary soft ๋ฐฐ๊ฒฝ
Cyan Soft #CFF4FC ์ •๋ณด soft ๋ฐฐ๊ฒฝ
Orange Soft #FFEC2C ์ฃผ์˜ soft ๊ฐ•์กฐ
Danger #D92D20 ์œ„ํ—˜๊ณผ ์‹คํŒจ ์ƒํƒœ
Danger Soft #FEE4E2 ์œ„ํ—˜ soft ๋ฐฐ๊ฒฝ
Gray 900 #282828 ์ œ๋ชฉ๊ณผ ํ•ต์‹ฌ ํ…์ŠคํŠธ
Gray 700 #747474 ๋ณธ๋ฌธ ํ…์ŠคํŠธ
Gray 500 #8E8E8E ์„ค๋ช…๊ณผ placeholder
Gray 300/200/50 #C1C1C1 / #DADADA / #F4F4F4 border์™€ ๋ฐฐ๊ฒฝ ๋‹จ๊ณ„

์œ„ํ—˜๋“ฑ๊ธ‰์€ ์ƒ‰์ƒ๋งŒ์œผ๋กœ ๊ตฌ๋ถ„ํ•˜์ง€ ์•Š๊ณ  ํ…์ŠคํŠธ์™€ Reicon ์•„์ด์ฝ˜์„ ํ•จ๊ป˜ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. ์ƒ‰์ด ์žˆ๋Š” ๋ฒ„ํŠผ์€ ํฐ์ƒ‰ ๊ธ€์ž, ํฐ์ƒ‰ ๋ฒ„ํŠผ์€ Gray 900 ๊ธ€์ž๋ฅผ ๊ธฐ๋ณธ์œผ๋กœ ํ•ฉ๋‹ˆ๋‹ค.

ํƒ€์ดํฌ๊ทธ๋ž˜ํ”ผ

Pretendard ๊ฐ€๋ณ€ ํฐํŠธ ํ•˜๋‚˜๋งŒ ์‚ฌ์šฉํ•˜๋ฉฐ ํŒŒ์ผ์€ public/fonts/PretendardVariable.woff2์— ํฌํ•จ๋˜์–ด ์žˆ์Šต๋‹ˆ๋‹ค.

Token ํฌ๊ธฐ ๊ธฐ๋ณธ ๊ตต๊ธฐ ์šฉ๋„
headline1 1.375rem ยท 22px 700 ํŽ˜์ด์ง€ ๋Œ€ํ‘œ ์ œ๋ชฉ
headline2 1.25rem ยท 20px 700 ํฐ ์„น์…˜ ์ œ๋ชฉ
subtitle1 1rem ยท 16px 600 ์นด๋“œยทํŒจ๋„ ์ œ๋ชฉ
subtitle2 0.875rem ยท 14px 600 ๋ณด์กฐ ์ œ๋ชฉ
body1 0.875rem ยท 14px 400 ๊ธฐ๋ณธ ๋ณธ๋ฌธ
body2 0.75rem ยท 12px 500 ์กฐ๋ฐ€ํ•œ ์—…๋ฌด UI ๋ณธ๋ฌธ
description 0.75rem ยท 12px 400 ์„ค๋ช…๊ณผ metadata

๊ธฐ๋ณธ ๊ตต๊ธฐ๋Š” --font-weight-regular(400), --font-weight-medium(500), --font-weight-semibold(600), --font-weight-bold(700), --font-weight-extrabold(800)์œผ๋กœ ๊ด€๋ฆฌํ•ฉ๋‹ˆ๋‹ค. ์ปดํฌ๋„ŒํŠธ์—์„œ๋Š” --font-weight-headline1, --font-weight-button, --font-weight-metric์ฒ˜๋Ÿผ ์—ญํ• ๋ณ„ semantic token์„ ์šฐ์„  ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.

์ˆซ์ž๋Š” ๋น„๊ต๊ฐ€ ์‰ฝ๋„๋ก ์ „์—ญ tabular-nums๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. ์ปดํฌ๋„ŒํŠธ์—์„œ ์ž„์˜ px ํฌ๊ธฐ๋‚˜ ์ƒ‰์ƒ์„ ํ•˜๋“œ์ฝ”๋”ฉํ•˜์ง€ ์•Š๊ณ  src/styles.css์˜ semantic token์„ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.

๊ฐ„๊ฒฉ๊ณผ ํ‘œ๋ฉด

  • ๊ฐ„๊ฒฉ์€ 4px ๊ธฐ๋ฐ˜์˜ --space-* primitive scale์„ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.
  • ์ž์ฃผ ์“ฐ๋Š” semantic ๊ฐ„๊ฒฉ์€ --spacing-page-x, --spacing-section-gap, --spacing-card-padding, --spacing-table-cell-x/y๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.
  • control height๋Š” --control-height-sm(32px), --control-height-default(40px), --control-height-lg(48px)๋กœ ํ†ต์ผํ•ฉ๋‹ˆ๋‹ค.
  • control radius: 0.375rem ยท 6px
  • bar/card radius: 0.5rem ยท 8px
  • panel radius: 0.5rem ยท 8px
  • field gap: 0.5rem ยท 8px
  • bar gap: 0.75rem ยท 12px
  • ๋น ๋ฅธ motion: 160ms, ๊ธฐ๋ณธ motion: 220ms
  • ๋ฐ์€ Gray 50 ๋ฐฐ๊ฒฝ๊ณผ ํฐ์ƒ‰ ์ž‘์—… ํ‘œ๋ฉด์„ ๊ธฐ๋ณธ์œผ๋กœ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.
  • Mesh ํšจ๊ณผ๋Š” ํŽ˜์ด์ง€ ๋ฐฐ๊ฒฝ๊ณผ ์ค‘์š”ํ•œ ์š”์•ฝ ํ‘œ๋ฉด์—๋งŒ ์ œํ•œ์ ์œผ๋กœ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.
  • ํ…Œ์ด๋ธ”๊ณผ ํ•„ํ„ฐ๋Š” ๋ถˆํˆฌ๋ช…ํ•œ ์ž‘์—… ํ‘œ๋ฉด์œผ๋กœ ์œ ์ง€ํ•ฉ๋‹ˆ๋‹ค.
  • ์นด๋“œ๋ฅผ ํŽ˜์ด์ง€ ๊ตฌํš์ฒ˜๋Ÿผ ๋‚จ์šฉํ•˜๊ฑฐ๋‚˜ ์นด๋“œ ์•ˆ์— ์นด๋“œ๋ฅผ ์ค‘์ฒฉํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
  • ์•„์ด์ฝ˜์€ reicon-react๋งŒ ์‚ฌ์šฉํ•˜๊ณ , ์•„์ด์ฝ˜ ๋ฒ„ํŠผ์—๋Š” accessible label๊ณผ tooltip์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.
  • ZONE๊ณผ KAN์€ UI ๋ชจ๋ธ, ํ•„ํ„ฐ, ํ‘œ ์ปฌ๋Ÿผ, URL ํŒŒ๋ผ๋ฏธํ„ฐ์— ํฌํ•จํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

๋””์ž์ธ ํ† ํฐ๊ณผ ์‹ค์ œ ์ปดํฌ๋„ŒํŠธ ์ƒํƒœ๋Š” Storybook์˜ Foundations/Design tokens์™€ Shared UI ๊ทธ๋ฃน์—์„œ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค. ๋””์ž์ธ ๋ ˆํผ๋Ÿฐ์Šค์™€ AI ์ž‘์—…์šฉ ๊ธฐ์ค€์€ docs/design-references/ui8-dashboard-style-reference.md์— ์žˆ์Šต๋‹ˆ๋‹ค.

๋กœ๋”ฉ ๋ชจ์…˜

์›๋ณธ ํฐ๋”” MP4๋Š” public/animations/heendi-loader-reference.mp4์— ๋ ˆํผ๋Ÿฐ์Šค๋กœ ๋ณด๊ด€ํ•ฉ๋‹ˆ๋‹ค. ์ž‘์€ ๊ณตํ†ต ๋กœ๋”ฉ ์˜์—ญ์—์„œ๋Š” public/projects/hg-inventory-loader/scene-1/lottie.json๊ณผ LottieLoader๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.

  • MP4: ์บ๋ฆญํ„ฐ๊ฐ€ ํฌํ•จ๋œ ํฐ ๋กœ๋”ฉ ํ™”๋ฉด ๋ ˆํผ๋Ÿฐ์Šค
  • Lottie: ํˆฌ๋ช… ๋ฐฐ๊ฒฝ, ์ƒ‰์ƒ ์Šฌ๋กฏ, ๋ฐ˜๋ณต ๊ฐ€๋Šฅํ•œ ์ž‘์€ ๊ณตํ†ต ์Šคํ”ผ๋„ˆ
  • prefers-reduced-motion: ์ž๋™ ์žฌ์ƒ์„ ์ค‘์ง€ํ•ด ์ ‘๊ทผ์„ฑ ์„ค์ •์„ ๋”ฐ๋ฆ„

์ดˆ๊ธฐ ์„ธํŒ… ์™„๋ฃŒ ๋ฒ”์œ„

์™„๋ฃŒ:

  • ReactยทViteยทpnpm ์•ฑ ๊ธฐ๋ฐ˜
  • FSD-lite ํด๋” ๊ตฌ์กฐ์™€ ์˜ˆ์‹œ slice
  • ์•ฑ ์…ธ, Header, Sidebar, ๊ธฐ๋ณธ ๋ผ์šฐํ„ฐ
  • Dashboard Filter Foundations ๋””์ž์ธ ํ† ํฐ๊ณผ Pretendard
  • shadcn ๊ธฐ๋ฐ˜ ์žฌ์‚ฌ์šฉ UI์™€ Storybook
  • AxiosยทCSRFยทApiError ๊ณตํ†ต ํ†ต์‹  ๊ฒฝ๊ณ„
  • ์„ธ์…˜ ๋กœ๊ทธ์ธ, /me ์ธ์ฆ ๋ณต์›๊ณผ ๋ณดํ˜ธ ๋ผ์šฐํ„ฐ
  • ์—…๋ฌด API์˜ ์ „์—ญ ์„ธ์…˜ ๋งŒ๋ฃŒ ๊ฐ์ง€, ์บ์‹œ ์ •๋ฆฌ์™€ ์›๋ž˜ ๊ฒฝ๋กœ ๋ณต๊ท€
  • React Hook FormยทZod ๊ธฐ๋ฐ˜ ๋กœ๊ทธ์ธ ํ™”๋ฉด
  • TanStack Query Provider, inventory query key/options ์˜ˆ์‹œ
  • TanStack Table ๊ธฐ๋ฐ˜ ์žฌ์‚ฌ์šฉ DataTable
  • MP4 ๋ ˆํผ๋Ÿฐ์Šค์™€ Lottie ๊ณตํ†ต ๋กœ๋”
  • Vitest์™€ Playwright ๊ธฐ๋ณธ ๊ฒ€์ฆ
  • ๊ณตํ†ต ๋ฐ์ดํ„ฐ formatter์™€ ๋‹จ์œ„ ํ…Œ์ŠคํŠธ
  • APIยทQueryยทmapperยทURL ์ƒํƒœ ์ „์ฒด ํ๋ฆ„ ํ…œํ”Œ๋ฆฟ
  • ํด๋”ยทํŒŒ์ผ ๋ช…๋ช… ๊ทœ์น™๊ณผ ๊ธฐ๋Šฅ ๊ฐœ๋ฐœ ์ฒดํฌ๋ฆฌ์ŠคํŠธ
  • GitHub PR ํ…œํ”Œ๋ฆฟ
  • Node.js 24 LTS์™€ pnpm ๋ฒ„์ „ ๊ณ ์ •
  • ESLintยทPrettier ๊ณตํ†ต ๊ฒ€์‚ฌ
  • GitHub Actions PR ์ž๋™ ๊ฒ€์ฆ
  • .env* ๋น„๋ฐ€์ •๋ณด ๋ณดํ˜ธ ๊ทœ์น™

๊ธฐ๋Šฅ ๋˜๋Š” ์šด์˜ ๋‹จ๊ณ„์—์„œ ์ง„ํ–‰:

  • ์‹ค์ œ Spring Boot API์™€ ์‘๋‹ต mapper ์—ฐ๊ฒฐ
  • Spring Security ์„ธ๋ถ€ ์—ญํ• ยท๊ถŒํ•œ ์ •์ฑ…
  • ์‹ค์ œ ์žฌ๊ณ  ์กฐํšŒ, ์„œ๋ฒ„ ํŽ˜์ด์ง€๋„ค์ด์…˜, URL ํ•„ํ„ฐ์™€ ์ •๋ ฌ
  • ์žฌ๊ณ  ์ƒ์„ธ์™€ AI ์ „๋žต ์—…๋ฌด ๊ธฐ๋Šฅ
  • Zustand, React Hook Form, Zod, Recharts์˜ ์‹ค์ œ ๋„๋ฉ”์ธ ์ ์šฉ
  • ๋ฐฐํฌ ์•„ํ‚คํ…์ฒ˜์™€ ํ™˜๊ฒฝ๋ณ„ ์„ค์ •

์ฐธ๊ณ  ๋ฌธ์„œ

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages