# ๐Ÿ› ๏ธ ๊ฐœ๋ฐœ ๋ฐ ๊ด€๋ฆฌ ๊ทœ์น™ (Strict Development Rules) 1. **์–ธ์–ด ์„ค์ •**: ์˜์–ด๋กœ ์ƒ๊ฐํ•˜๋˜, ๋ชจ๋“  ๋‹ต๋ณ€์€ **ํ•œ๊ตญ์–ด**๋กœ ์ž‘์„ฑํ•œ๋‹ค. 2. **์ž„์˜ ์ˆ˜์ • ์ ˆ๋Œ€ ๊ธˆ์ง€ (Zero-Arbitrary Change)**: - ์‚ฌ์šฉ์ž๊ฐ€ ๋ช…์‹œ์ ์œผ๋กœ ์ง€์‹œํ•œ ๋ถ€๋ถ„ ์™ธ์—๋Š” **๋‹จ ํ•œ ์ค„์˜ ์ฝ”๋“œ๋„, ๊ทธ ์–ด๋–ค ํŒŒ์ผ๋„ ์ž„์˜๋กœ ์ˆ˜์ •, ์ •๋ฆฌ, ๋ฆฌํŒฉํ† ๋งํ•˜์ง€ ์•Š๋Š”๋‹ค.** - ์ง€์‹œ๋ฐ›์ง€ ์•Š์€ ๋‹ค๋ฅธ ํŒŒํŠธ์˜ ์ฝ”๋“œ๋Š” ์ ˆ๋Œ€ ๊ฑด๋“œ๋ฆฌ์ง€ ์•Š์œผ๋ฉฐ, ์˜ํ–ฅ ๋ฒ”์œ„๊ฐ€ ์š”์ฒญ ๋ฒ”์œ„๋ฅผ ๋ฒ—์–ด๋‚˜์ง€ ์•Š๋„๋ก '์™ธ๊ณผ ์ˆ˜์ˆ ์‹(Surgical) ์ˆ˜์ •'์„ ์›์น™์œผ๋กœ ํ•œ๋‹ค. 3. **๊ฐœ์„  ์ž‘์—… ์ ˆ์ฐจ (Test-First Approach)**: - ์‚ฌ์šฉ์ž๊ฐ€ ๊ฐœ์„ (Refactoring, Optimization ๋“ฑ)์„ ์ง€์‹œํ•œ ๊ฒฝ์šฐ, **์ˆ˜์ • ์ „ ํ˜„์žฌ ์‹œ์Šคํ…œ์ด ์ •์ƒ์ ์œผ๋กœ ์ž˜ ์ž‘๋™ํ•˜๋Š”์ง€ ๋จผ์ € ์ „์ˆ˜ ํ™•์ธ**ํ•œ๋‹ค. - ๊ธฐ์กด ๋™์ž‘ ๋ฐฉ์‹๊ณผ ์„ฑ๋Šฅ์„ ๊ธฐ์ค€(Baseline)์œผ๋กœ ์‚ผ๊ณ , ์ˆ˜์ • ํ›„์—๋„ **๊ธฐ์กด์˜ ๋ชจ๋“  ๊ธฐ๋Šฅ์ด ๋ฌด๊ฒฐํ•˜๊ฒŒ ์œ ์ง€๋˜๋Š”์ง€ ๋ฐ˜๋“œ์‹œ ํ…Œ์ŠคํŠธํ•˜์—ฌ ์ž…์ฆ**ํ•œ๋‹ค. - ๊ฒ€์ฆ ๊ฒฐ๊ณผ๋ฅผ ๋ฐ”ํƒ•์œผ๋กœ "๋ฌด์—‡์„, ์™œ, ์–ด๋–ป๊ฒŒ" ๋ฐ”๊ฟ€์ง€ ์ƒ์„ธ ๋ณด๊ณ  ํ›„, ์‚ฌ์šฉ์ž๋กœ๋ถ€ํ„ฐ **'์ง„ํ–‰์‹œ์ผœ'** ์Šน์ธ์„ ์–ป์€ ๋’ค์—๋งŒ ์ง‘ํ–‰ํ•œ๋‹ค. 4. **์„ ๋ณด๊ณ  ํ›„์Šน์ธ**: ๋ชจ๋“  ๊ธฐ๋Šฅ ์ˆ˜์ • ๋ฐ ์ฝ”๋“œ ๋ณ€๊ฒฝ ์ „์—๋Š” ์˜ˆ์ƒ ๋ฐฉ์•ˆ์„ ๋จผ์ € ๋ณด๊ณ ํ•˜๊ณ  ์Šน์ธ ์ ˆ์ฐจ๋ฅผ ๊ฑฐ์นœ๋‹ค. --- ### ๐Ÿš€ ์„œ๋ฒ„ ๊ตฌ๋™ ๋ฐ ์™ธ๋ถ€ ์ ‘์† ๊ทœ์น™ (Server Run & External Access) 1. **ํฌํŠธ ๊ณ ์ •**: ๊ฐœ๋ฐœ ์„œ๋ฒ„๋Š” ๋ฐ˜๋“œ์‹œ **8080** ํฌํŠธ๋ฅผ ์‚ฌ์šฉํ•œ๋‹ค. (`vite.config.ts` ์„ค์ • ์ค€์ˆ˜) 2. **์™ธ๋ถ€ ์ ‘์† ํ—ˆ์šฉ (Host)**: ์‚ฌ๋ฌด์‹ค ๋‚ด ํƒ€ ์ง์›์ด ์ ‘์†ํ•  ์ˆ˜ ์žˆ๋„๋ก `--host` ๋ชจ๋“œ๋กœ ๊ตฌ๋™ํ•œ๋‹ค. 3. **๊ตฌ๋™ ๋ช…๋ น์–ด**: ```bash npm run dev ``` * ํ•ด๋‹น ๋ช…๋ น์–ด ์‹คํ–‰ ์‹œ `0.0.0.0` ๋˜๋Š” `Network: http://[๋‚ด-IP]:8080/` ๊ฒฝ๋กœ๋กœ ํƒ€์ธ ์ ‘์†์ด ๊ฐ€๋Šฅํ•˜๋‹ค. 4. **IP ํ™•์ธ ๋ฐฉ๋ฒ•**: * Windows: `ipconfig` ๋ช…๋ น์–ด๋กœ 'IPv4 ์ฃผ์†Œ' ํ™•์ธ ํ›„ ๊ณต์œ . --- ### ๐ŸŽจ ITAM ์‹œ์Šคํ…œ ๋””์ž์ธ ๊ฐ€์ด๋“œ (Design Guide) 1. **๋””์ž์ธ ์ฒ ํ•™ (Design Philosophy)** * **Minimalist & Border-based**: ๋ถˆํ•„์š”ํ•œ ๋ฐ•์Šค(Card) ์‚ฌ์šฉ์„ ์ตœ์†Œํ™”ํ•˜๊ณ , ์ •๋ณด์˜ ๊ตฌ๋ถ„์€ ๊ฐ„๊ฒฐํ•œ ๋ผ์ธ(Border/Divider)์„ ํ™œ์šฉํ•˜์—ฌ ์‹œ๊ฐ์  ํ”ผ๋กœ๋„๋ฅผ ๋‚ฎ์ถฅ๋‹ˆ๋‹ค. * **Professional Achromatic**: ๋ฌด์ฑ„์ƒ‰(Black, White, Grey)์„ ๊ธฐ๋ณธ์œผ๋กœ ํ•˜์—ฌ ์ •๋ˆ๋œ ์—…๋ฌด ํ™˜๊ฒฝ์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. * **Green Accent**: ๋ธ”๋ฃจ ๋Œ€์‹  ์ง™์€ ๊ทธ๋ฆฐ(`#1E5149`)์„ ํฌ์ธํŠธ ์ปฌ๋Ÿฌ๋กœ ์‚ฌ์šฉํ•˜์—ฌ ์ฐจ๋ถ„ํ•œ ์ „๋ฌธ์„ฑ์„ ๊ฐ•์กฐํ•ฉ๋‹ˆ๋‹ค. 2. **ํƒ€์ดํฌ๊ทธ๋ž˜ํ”ผ (Typography)** * **Font Family**: `Pretendard` (์ „์—ญ ์ ์šฉ) * **Letter Spacing**: `-0.02em` (์•ฝ -2%) ์ ์šฉ. ์ž๊ฐ„์„ ์ข๊ฒŒ ์„ค์ •ํ•˜์—ฌ ๋ฐ€๋„ ์žˆ๊ณ  ์„ธ๋ จ๋œ ๊ฐ€๋…์„ฑ์„ ํ™•๋ณดํ•ฉ๋‹ˆ๋‹ค. * **Weights**: 400(Regular), 500(Medium), 600(SemiBold), 700(Bold). 3. **์ปฌ๋Ÿฌ ํŒ”๋ ˆํŠธ (Color Palette)** * **Point Color**: `#1E5149` (Deep Green) - ๊ฐ•์กฐ, ํ™œ์„ฑํ™” ์ƒํƒœ, ์ฃผ์š” ์•ก์…˜ ๋ฒ„ํŠผ. * **Text**: Main(`#111827` - Near Black), Muted(`#6B7280` - Grey). * **Border/Divider**: `#E5E7EB` (Light Grey) - ์ •๋ณด ๊ตฌ๋ถ„์„ ์œ„ํ•œ ์–‡์€ ์‹ค์„ . * **Background**: `#FFFFFF` (White) / `#F9FAFB` (Off White). 4. **๋ ˆ์ด์•„์›ƒ ๋ฐ ์ปดํฌ๋„ŒํŠธ ๊ทœ์น™ (Layout Rules)** * **Box-less Design**: ๊ผญ ํ•„์š”ํ•œ ์ •๋ณด ๋ฌถ์Œ(๋ฐ์ดํ„ฐ ๊ทธ๋ฃนํ™” ๋“ฑ)์ด ์•„๋‹ˆ๋ฉด ๋ฐ•์Šค ํ˜•ํƒœ์˜ ํ…Œ๋‘๋ฆฌ๋‚˜ ๋ฐฐ๊ฒฝ ์‚ฌ์šฉ์„ ์ง€์–‘ํ•ฉ๋‹ˆ๋‹ค. * **Line-based Division**: ์„น์…˜ ๊ฐ„์˜ ๊ตฌ๋ถ„์€ 1px ๋‘๊ป˜์˜ ์–‡์€ ์‹ค์„ (Border)์„ ํ†ตํ•ด ๋ช…ํ™•ํžˆ ํ•ฉ๋‹ˆ๋‹ค. * **Table**: ๋ฐฐ๊ฒฝ์ƒ‰์ด๋‚˜ ํ™”๋ คํ•œ ํšจ๊ณผ ์—†์ด ํ–‰(Row) ๊ฐ„์˜ ์–‡์€ ๊ตฌ๋ถ„์„ ๋งŒ ์‚ฌ์šฉํ•˜์—ฌ ๋ฐ์ดํ„ฐ ๋ณธ์—ฐ์— ์ง‘์ค‘ํ•˜๊ฒŒ ํ•ฉ๋‹ˆ๋‹ค. * **Input/Button**: ์ž…๋ ฅ ํ•„๋“œ์™€ ๋ฒ„ํŠผ์€ ์ตœ์†Œํ•œ์˜ ๋ณด๋”์™€ ํฌ์ธํŠธ ์ปฌ๋Ÿฌ๋งŒ ์‚ฌ์šฉํ•˜์—ฌ ์ •๊ฐˆํ•˜๊ฒŒ ํ‘œํ˜„ํ•ฉ๋‹ˆ๋‹ค. * **Modal (๋ชจ๋‹ฌ ๊ณตํ†ต ๊ทœ์น™)**: * **Header**: ์ง™์€ ๊ทธ๋ฆฐ(`#1E5149`) ๋ฐฐ๊ฒฝ์— ํ™”์ดํŠธ ํ…์ŠคํŠธ๋ฅผ ์‚ฌ์šฉํ•˜๋ฉฐ, ์šฐ์ธก ์ƒ๋‹จ์— ๋ช…ํ™•ํ•œ 'X' ๋‹ซ๊ธฐ ๋ฒ„ํŠผ์„ ๋ฐฐ์น˜ํ•ฉ๋‹ˆ๋‹ค. * **Interaction**: ์‚ฌ์šฉ์ž์˜ ํŽธ์˜๋ฅผ ์œ„ํ•ด `ESC` ํ‚ค๋ฅผ ๋ˆ„๋ฅด๊ฑฐ๋‚˜ ๋ชจ๋‹ฌ ๋ฐ”๊นฅ ์˜์—ญ(Overlay)์„ ํด๋ฆญํ•˜๋ฉด ๋ชจ๋‹ฌ์ด ๋‹ซํžˆ๋„๋ก ๊ตฌํ˜„ํ•ฉ๋‹ˆ๋‹ค. * **Layout**: `detail.png` ๊ธฐ์ค€์˜ 2์—ด ๊ทธ๋ฆฌ๋“œ ์‹œ์Šคํ…œ์„ ๊ถŒ์žฅํ•˜๋ฉฐ, ํ•˜๋‹จ ์šฐ์ธก์— ์•ก์…˜ ๋ฒ„ํŠผ(๋‹ซ๊ธฐ, ์ €์žฅ ๋“ฑ)์„ ๋ฐฐ์น˜ํ•ฉ๋‹ˆ๋‹ค.