์ฝ˜ํ…์ธ  ๋Œ€ํ‘œ ์ด๋ฏธ์ง€ - ๐Ÿ“„ Claude๋กœ ๊ณ„์•ฝ์„œ ์ฃผ์š” ์กฐํ•ญ ์ž๋™์ถ”์ถœ ๋ด‡ ๊ตฌ์ถ•ํ•˜๊ธฐ

๐Ÿ“„ Claude๋กœ ๊ณ„์•ฝ์„œ ์ฃผ์š” ์กฐํ•ญ ์ž๋™์ถ”์ถœ ๋ด‡ ๊ตฌ์ถ•ํ•˜๊ธฐ

AI๊ฐ€ ๊ณ„์•ฝ์„œ๋ฅผ ์ฝ๊ณ  ํ•ต์‹ฌ๋งŒ ์™์™ ๋ฝ‘์•„๋‚ด๋Š” ๋งˆ๋ฒ• ๊ฐ™์€ ์ž๋™ํ™” ์‹œ์Šคํ…œ ๋งŒ๋“ค๊ธฐ ๐Ÿค–โœจ

๊ณ„์•ฝ์„œ ์ž๋™ ๋ถ„์„ ์‹œ์Šคํ…œ ์›๋ณธ ๊ณ„์•ฝ์„œ AI Claude ํ•ต์‹ฌ ์กฐํ•ญ ์ถ”์ถœ ๊ณ„์•ฝ๊ธฐ๊ฐ„: 2๋…„ ๊ณ„์•ฝ๊ธˆ: 1์–ต์› ์œ„์•ฝ๊ธˆ: 20% ๊ฐฑ์‹ ์กฐ๊ฑด: ํ˜‘์˜ ์ž๋™ ์ •๋ฆฌ ์™„๋ฃŒ! โšก ์ˆ˜์ž‘์—… ๋Œ€๋น„ 95% ์‹œ๊ฐ„ ๋‹จ์ถ• โšก

๐ŸŽฏ ์™œ ๊ณ„์•ฝ์„œ ์ž๋™์ถ”์ถœ ๋ด‡์ด ํ•„์š”ํ• ๊นŒ?

๋งค์ผ ์ˆ˜์‹ญ, ์ˆ˜๋ฐฑ ์žฅ์˜ ๊ณ„์•ฝ์„œ๋ฅผ ๊ฒ€ํ† ํ•ด์•ผ ํ•˜๋Š” ๋ฒ•๋ฌดํŒ€, ๊ตฌ๋งคํŒ€, ์˜์—…ํŒ€์˜ ๊ณ ์ถฉ์„ ์ƒ๊ฐํ•ด๋ด. ๐Ÿ“š
๊ฐ ๊ณ„์•ฝ์„œ๋งˆ๋‹ค ์ค‘์š”ํ•œ ์กฐํ•ญ๋“ค์ด ์–ด๋””์— ์ˆจ์–ด์žˆ๋Š”์ง€ ์ฐพ์•„๋‚ด๋ ค๋ฉด ํ•œ ์žฅ๋‹น ์ตœ์†Œ 30๋ถ„์—์„œ 1์‹œ๊ฐ„์€ ์กฑํžˆ ๊ฑธ๋ ค.
๊ฒŒ๋‹ค๊ฐ€ ์‚ฌ๋žŒ์ด ํ•˜๋‹ค ๋ณด๋ฉด ์‹ค์ˆ˜๋„ ์ƒ๊ธฐ๊ณ , ์ค‘์š”ํ•œ ์กฐํ•ญ์„ ๋†“์น˜๋Š” ๊ฒฝ์šฐ๋„ ์žˆ์ง€.

์ด๋Ÿฐ ๋ฐ˜๋ณต์ ์ด๊ณ  ์ง€๋ฃจํ•œ ์ž‘์—…์„ AI์—๊ฒŒ ๋งก๊ธฐ๋ฉด ์–ด๋–จ๊นŒ? ๐Ÿค”
๋ฐ”๋กœ ์—ฌ๊ธฐ์„œ Claude ๊ฐ™์€ ๋Œ€ํ˜• ์–ธ์–ด๋ชจ๋ธ(LLM)์ด ๋น›์„ ๋ฐœํ•˜๋Š” ๊ฑฐ์•ผ.
Claude๋Š” ๊ธด ๋ฌธ์„œ๋ฅผ ์ดํ•ดํ•˜๊ณ , ๋งฅ๋ฝ์„ ํŒŒ์•…ํ•˜๊ณ , ํ•ต์‹ฌ ์ •๋ณด๋ฅผ ์ถ”์ถœํ•˜๋Š” ๋ฐ ์ •๋ง ํƒ์›”ํ•œ ๋Šฅ๋ ฅ์„ ๊ฐ€์ง€๊ณ  ์žˆ๊ฑฐ๋“ .

๐Ÿ’ก ์‹ค์ œ ํ™œ์šฉ ์‚ฌ๋ก€ โ€ข ๋Œ€ํ˜• ๋กœํŽŒ: ํ•˜๋ฃจ ํ‰๊ท  200๊ฑด์˜ ๊ณ„์•ฝ์„œ ๊ฒ€ํ†  ์‹œ๊ฐ„์„ 70% ๋‹จ์ถ•
โ€ข ์Šคํƒ€ํŠธ์—…: ํˆฌ์ž ๊ณ„์•ฝ์„œ ๋ฆฌ๋ทฐ ํ”„๋กœ์„ธ์Šค๋ฅผ 3์ผ์—์„œ 4์‹œ๊ฐ„์œผ๋กœ ์••์ถ•
โ€ข ๊ตฌ๋งค๋ถ€์„œ: ๊ณต๊ธ‰์—…์ฒด ๊ณ„์•ฝ ์กฐ๊ฑด ๋น„๊ต ๋ถ„์„ ์ž๋™ํ™”๋กœ ํ˜‘์ƒ๋ ฅ 30% ํ–ฅ์ƒ
โ€ข ๋ถ€๋™์‚ฐ ์ค‘๊ฐœ: ์ž„๋Œ€์ฐจ ๊ณ„์•ฝ์„œ ํ•ต์‹ฌ ์กฐํ•ญ ์ฆ‰์‹œ ์ถ”์ถœ๋กœ ๊ณ ๊ฐ ๋งŒ์กฑ๋„ ์ƒ์Šน

๐Ÿง  Claude๊ฐ€ ๊ณ„์•ฝ์„œ ๋ถ„์„์— ์ตœ์ ์ธ ์ด์œ 

์—ฌ๋Ÿฌ AI ๋ชจ๋ธ ์ค‘์—์„œ๋„ Claude๋ฅผ ์„ ํƒํ•˜๋Š” ๋ฐ๋Š” ๋ช…ํ™•ํ•œ ์ด์œ ๊ฐ€ ์žˆ์–ด.
ํŠนํžˆ Anthropic์˜ Claude 3 ์‹œ๋ฆฌ์ฆˆ(Haiku, Sonnet, Opus)๋Š” ๊ณ„์•ฝ์„œ ๊ฐ™์€ ๋ฒ•๋ฅ  ๋ฌธ์„œ ์ฒ˜๋ฆฌ์— ๊ฐ•์ ์„ ๋ณด์—ฌ์ฃผ๊ฑฐ๋“ . ๐Ÿ’ช

๐Ÿ“Œ Claude์˜ ํ•ต์‹ฌ ๊ฐ•์ 

1๏ธโƒฃ ๊ธด ์ปจํ…์ŠคํŠธ ์œˆ๋„์šฐ (์ตœ๋Œ€ 200K ํ† ํฐ)
์ผ๋ฐ˜์ ์ธ ๊ณ„์•ฝ์„œ๋Š” ๋ณดํ†ต 10~50ํŽ˜์ด์ง€ ์ •๋„์ธ๋ฐ, Claude๋Š” ํ•œ ๋ฒˆ์— ์ˆ˜๋ฐฑ ํŽ˜์ด์ง€๋ฅผ ์ฒ˜๋ฆฌํ•  ์ˆ˜ ์žˆ์–ด.
์ด๊ฒŒ ์–ผ๋งˆ๋‚˜ ์ค‘์š”ํ•œ์ง€ ์•Œ์•„? ๋ฌธ์„œ๋ฅผ ์ชผ๊ฐœ์ง€ ์•Š๊ณ  ์ „์ฒด ๋งฅ๋ฝ์„ ์œ ์ง€ํ•˜๋ฉด์„œ ๋ถ„์„ํ•  ์ˆ˜ ์žˆ๋‹ค๋Š” ๊ฑฐ์•ผ. ๐Ÿ“–

2๏ธโƒฃ ๋›ฐ์–ด๋‚œ ์ง€์‹œ์‚ฌํ•ญ ์ค€์ˆ˜ ๋Šฅ๋ ฅ
"์ด ๊ณ„์•ฝ์„œ์—์„œ ๊ธˆ์•ก, ๊ธฐ๊ฐ„, ์œ„์•ฝ ์กฐ๊ฑด๋งŒ ์ถ”์ถœํ•ด์ค˜"๋ผ๊ณ  ํ•˜๋ฉด ์ •๋ง ๊ทธ๊ฒƒ๋งŒ ๊น”๋”ํ•˜๊ฒŒ ๋ฝ‘์•„๋‚ด.
๋‹ค๋ฅธ ๋ชจ๋ธ๋“ค์€ ๊ฐ€๋” ์—‰๋šฑํ•œ ์ •๋ณด๊นŒ์ง€ ์„ž์–ด์„œ ์ฃผ๋Š” ๊ฒฝ์šฐ๊ฐ€ ์žˆ๋Š”๋ฐ, Claude๋Š” ์ง€์‹œ๋ฅผ ์ •ํ™•ํžˆ ๋”ฐ๋ผ. ๐ŸŽฏ

3๏ธโƒฃ ๊ตฌ์กฐํ™”๋œ ์ถœ๋ ฅ ์ƒ์„ฑ
JSON, XML, ํ‘œ ํ˜•์‹ ๋“ฑ ์›ํ•˜๋Š” ํฌ๋งท์œผ๋กœ ๊ฒฐ๊ณผ๋ฅผ ๋ฐ›์„ ์ˆ˜ ์žˆ์–ด.
์ด๊ฑด ๋‚˜์ค‘์— ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์— ์ €์žฅํ•˜๊ฑฐ๋‚˜ ๋‹ค๋ฅธ ์‹œ์Šคํ…œ๊ณผ ์—ฐ๋™ํ•  ๋•Œ ์—„์ฒญ ํŽธํ•ด. ๐Ÿ”ง

4๏ธโƒฃ ๋ฒ•๋ฅ  ์šฉ์–ด ์ดํ•ด๋„
"์„ ์ดํ–‰์˜๋ฌด", "์†ํ•ด๋ฐฐ์ƒ์˜ˆ์ •์•ก", "๋ถˆ๊ฐ€ํ•ญ๋ ฅ ์กฐํ•ญ" ๊ฐ™์€ ์ „๋ฌธ ์šฉ์–ด๋“ค์„ ์ •ํ™•ํžˆ ์ดํ•ดํ•˜๊ณ  ์ฒ˜๋ฆฌํ•ด.
์ผ๋ฐ˜ AI๋Š” ์ด๋Ÿฐ ์šฉ์–ด๋ฅผ ๊ทธ๋ƒฅ ๋‹จ์–ด๋กœ๋งŒ ์ธ์‹ํ•˜์ง€๋งŒ, Claude๋Š” ๋ฒ•์  ์˜๋ฏธ๊นŒ์ง€ ํŒŒ์•…ํ•˜๊ฑฐ๋“ . โš–๏ธ
๐ŸŽ“ ์žฌ๋Šฅ๋„ท ํŒ! AI ์ž๋™ํ™” ์‹œ์Šคํ…œ ๊ตฌ์ถ•์ด ์ฒ˜์Œ์ด๋ผ๋ฉด, ์žฌ๋Šฅ๋„ท์—์„œ ๊ฒฝํ—˜ ๋งŽ์€ ๊ฐœ๋ฐœ์ž๋“ค์˜ ๋„์›€์„ ๋ฐ›์•„๋ณด๋Š” ๊ฒƒ๋„ ์ข‹์€ ๋ฐฉ๋ฒ•์ด์•ผ.
ํŠนํžˆ ํ”„๋กฌํ”„ํŠธ ์—”์ง€๋‹ˆ์–ด๋ง์ด๋‚˜ API ์—ฐ๋™ ๋ถ€๋ถ„์—์„œ ์ „๋ฌธ๊ฐ€์˜ ์กฐ์–ธ์ด ํฐ ๋„์›€์ด ๋  ์ˆ˜ ์žˆ์–ด! ๐Ÿš€

๐Ÿ—๏ธ ์‹œ์Šคํ…œ ์•„ํ‚คํ…์ฒ˜ ์„ค๊ณ„ํ•˜๊ธฐ

๋ณธ๊ฒฉ์ ์œผ๋กœ ๋ด‡์„ ๋งŒ๋“ค๊ธฐ ์ „์—, ์ „์ฒด ์‹œ์Šคํ…œ์ด ์–ด๋–ป๊ฒŒ ๋™์ž‘ํ• ์ง€ ์„ค๊ณ„๋ถ€ํ„ฐ ํ•ด์•ผ ํ•ด.
๊ฑด๋ฌผ์„ ์ง€์„ ๋•Œ ์„ค๊ณ„๋„๊ฐ€ ํ•„์š”ํ•˜๋“ฏ์ด, ์†Œํ”„ํŠธ์›จ์–ด๋„ ๋งˆ์ฐฌ๊ฐ€์ง€์•ผ. ๐Ÿ›๏ธ

์‹œ์Šคํ…œ ์•„ํ‚คํ…์ฒ˜ ํ๋ฆ„๋„ 1. ๋ฌธ์„œ ์ž…๋ ฅ PDF/DOCX 2. ํ…์ŠคํŠธ ์ถ”์ถœ OCR/Parser 3. ์ „์ฒ˜๋ฆฌ ์ •์ œ/๋ถ„ํ•  4. Claude API ๋ถ„์„ ์š”์ฒญ 5. ์กฐํ•ญ ์ถ”์ถœ ๊ตฌ์กฐํ™” 6. ํ›„์ฒ˜๋ฆฌ ๊ฒ€์ฆ/ํฌ๋งทํŒ… 7. ๊ฒฐ๊ณผ ์ €์žฅ DB/ํŒŒ์ผ 8. ์‚ฌ์šฉ์ž ์ถœ๋ ฅ ๋Œ€์‹œ๋ณด๋“œ ํ•ต์‹ฌ ์ปดํฌ๋„ŒํŠธ โ€ข ๋ฌธ์„œ ํŒŒ์„œ: PyPDF2, python-docx, Tesseract OCR โ€ข API ํด๋ผ์ด์–ธํŠธ: Anthropic Python SDK โ€ข ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค: PostgreSQL + SQLAlchemy โ€ข ์›น ํ”„๋ ˆ์ž„์›Œํฌ: FastAPI + React (์„ ํƒ์‚ฌํ•ญ)
๐Ÿ” ๊ฐ ๋‹จ๊ณ„๋ณ„ ์ƒ์„ธ ์„ค๋ช…

Step 1: ๋ฌธ์„œ ์ž…๋ ฅ ๐Ÿ“ฅ
์‚ฌ์šฉ์ž๊ฐ€ ๊ณ„์•ฝ์„œ ํŒŒ์ผ์„ ์—…๋กœ๋“œํ•˜๋Š” ๋‹จ๊ณ„์•ผ. PDF, DOCX, ์ด๋ฏธ์ง€ ํŒŒ์ผ ๋“ฑ ๋‹ค์–‘ํ•œ ํ˜•์‹์„ ์ง€์›ํ•ด์•ผ ํ•ด.
ํŒŒ์ผ ํฌ๊ธฐ ์ œํ•œ(๋ณดํ†ต 10MB ์ดํ•˜)๊ณผ ๋ณด์•ˆ ๊ฒ€์ฆ๋„ ์ด ๋‹จ๊ณ„์—์„œ ์ฒ˜๋ฆฌํ•˜์ง€.

Step 2: ํ…์ŠคํŠธ ์ถ”์ถœ ๐Ÿ“
PDF์—์„œ ํ…์ŠคํŠธ๋ฅผ ๋ฝ‘์•„๋‚ด๋Š” ์ž‘์—…์ด์•ผ. ์Šค์บ”๋œ ๋ฌธ์„œ๋ผ๋ฉด OCR(๊ด‘ํ•™ ๋ฌธ์ž ์ธ์‹)์ด ํ•„์š”ํ•ด.
PyPDF2๋Š” ๋””์ง€ํ„ธ PDF์šฉ, Tesseract๋Š” ์ด๋ฏธ์ง€/์Šค์บ” ๋ฌธ์„œ์šฉ์œผ๋กœ ์‚ฌ์šฉํ•ด.

Step 3: ์ „์ฒ˜๋ฆฌ ๐Ÿงน
์ถ”์ถœ๋œ ํ…์ŠคํŠธ๋ฅผ ์ •์ œํ•˜๋Š” ๋‹จ๊ณ„์•ผ. ๋ถˆํ•„์š”ํ•œ ๊ณต๋ฐฑ ์ œ๊ฑฐ, ํŠน์ˆ˜๋ฌธ์ž ์ฒ˜๋ฆฌ, ํŽ˜์ด์ง€ ๋ฒˆํ˜ธ ์ œ๊ฑฐ ๋“ฑ์„ ํ•ด.
๋ฌธ์„œ๊ฐ€ ๋„ˆ๋ฌด ๊ธธ๋ฉด Claude์˜ ํ† ํฐ ์ œํ•œ์„ ๊ณ ๋ คํ•ด์„œ ์ ์ ˆํžˆ ๋ถ„ํ• ํ•˜๊ธฐ๋„ ํ•ด.

Step 4: Claude API ํ˜ธ์ถœ ๐Ÿค–
์ „์ฒ˜๋ฆฌ๋œ ํ…์ŠคํŠธ์™€ ํ•จ๊ป˜ ํ”„๋กฌํ”„ํŠธ๋ฅผ Claude์—๊ฒŒ ๋ณด๋‚ด๋Š” ๋‹จ๊ณ„์•ผ.
์—ฌ๊ธฐ์„œ ํ”„๋กฌํ”„ํŠธ ์„ค๊ณ„๊ฐ€ ์ •๋ง ์ค‘์š”ํ•œ๋ฐ, ์ด๊ฑด ๋’ค์—์„œ ์ž์„ธํžˆ ๋‹ค๋ฃฐ๊ฒŒ!

Step 5: ์กฐํ•ญ ์ถ”์ถœ ๋ฐ ๊ตฌ์กฐํ™” ๐Ÿ“Š
Claude๊ฐ€ ๋ฐ˜ํ™˜ํ•œ ๊ฒฐ๊ณผ๋ฅผ ํŒŒ์‹ฑํ•ด์„œ ๊ตฌ์กฐํ™”๋œ ๋ฐ์ดํ„ฐ๋กœ ๋งŒ๋“ค์–ด.
JSON ํ˜•์‹์œผ๋กœ ๋ฐ›์œผ๋ฉด ํŒŒ์ด์ฌ ๋”•์…”๋„ˆ๋ฆฌ๋กœ ์‰ฝ๊ฒŒ ๋ณ€ํ™˜ํ•  ์ˆ˜ ์žˆ์ง€.

Step 6: ํ›„์ฒ˜๋ฆฌ ๋ฐ ๊ฒ€์ฆ โœ…
์ถ”์ถœ๋œ ๋ฐ์ดํ„ฐ์˜ ์œ ํšจ์„ฑ์„ ๊ฒ€์ฆํ•ด. ๋‚ ์งœ ํ˜•์‹์ด ๋งž๋Š”์ง€, ๊ธˆ์•ก์— ์ด์ƒํ•œ ๊ฐ’์€ ์—†๋Š”์ง€ ์ฒดํฌํ•˜๋Š” ๊ฑฐ์•ผ.
ํ•„์š”ํ•˜๋ฉด ์ถ”๊ฐ€ ํฌ๋งทํŒ…๋„ ํ•˜๊ณ .

Step 7: ๊ฒฐ๊ณผ ์ €์žฅ ๐Ÿ’พ
์ฒ˜๋ฆฌ๋œ ๋ฐ์ดํ„ฐ๋ฅผ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์— ์ €์žฅํ•˜๊ฑฐ๋‚˜ ํŒŒ์ผ๋กœ ๋‚ด๋ณด๋‚ด.
๋‚˜์ค‘์— ๊ฒ€์ƒ‰ํ•˜๊ฑฐ๋‚˜ ๋ถ„์„ํ•  ์ˆ˜ ์žˆ๋„๋ก ์ธ๋ฑ์‹ฑ๋„ ํ•ด์ฃผ๋ฉด ์ข‹์•„.

Step 8: ์‚ฌ์šฉ์ž์—๊ฒŒ ์ถœ๋ ฅ ๐Ÿ“ฑ
์›น ๋Œ€์‹œ๋ณด๋“œ๋‚˜ ์ด๋ฉ”์ผ, ์Šฌ๋ž™ ๋ฉ”์‹œ์ง€ ๋“ฑ์œผ๋กœ ๊ฒฐ๊ณผ๋ฅผ ์ „๋‹ฌํ•ด.
์‹œ๊ฐํ™”๋œ ํ˜•ํƒœ๋กœ ๋ณด์—ฌ์ฃผ๋ฉด ์‚ฌ์šฉ์ž ๊ฒฝํ—˜์ด ํ›จ์”ฌ ์ข‹์•„์ ธ.

๐Ÿ’ป ๊ฐœ๋ฐœ ํ™˜๊ฒฝ ์„ธํŒ…ํ•˜๊ธฐ

์ด์ œ ์‹ค์ œ๋กœ ์ฝ”๋“œ๋ฅผ ์ž‘์„ฑํ•  ์ค€๋น„๋ฅผ ํ•ด๋ณด์ž! ๐Ÿ› ๏ธ
ํ•„์š”ํ•œ ๋„๊ตฌ๋“ค์„ ์„ค์น˜ํ•˜๊ณ  ๊ฐœ๋ฐœ ํ™˜๊ฒฝ์„ ๊ตฌ์ถ•ํ•˜๋Š” ๊ณผ์ •์ด์•ผ.

๐Ÿ”ง ํ•„์ˆ˜ ๋„๊ตฌ ๋ฐ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ

1. Python 3.8 ์ด์ƒ
์ตœ์‹  ๋ฒ„์ „์˜ ํŒŒ์ด์ฌ์„ ์‚ฌ์šฉํ•˜๋Š” ๊ฒŒ ์ข‹์•„. 3.10์ด๋‚˜ 3.11์„ ์ถ”์ฒœํ•ด.

2. Anthropic Python SDK
Claude API๋ฅผ ์‰ฝ๊ฒŒ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๊ฒŒ ํ•ด์ฃผ๋Š” ๊ณต์‹ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ์•ผ.

3. ๋ฌธ์„œ ์ฒ˜๋ฆฌ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ
โ€ข PyPDF2 ๋˜๋Š” pdfplumber: PDF ํ…์ŠคํŠธ ์ถ”์ถœ
โ€ข python-docx: Word ๋ฌธ์„œ ์ฒ˜๋ฆฌ
โ€ข pytesseract: OCR ๊ธฐ๋Šฅ (์ด๋ฏธ์ง€์—์„œ ํ…์ŠคํŠธ ์ถ”์ถœ)
โ€ข Pillow: ์ด๋ฏธ์ง€ ์ฒ˜๋ฆฌ

4. ์›น ํ”„๋ ˆ์ž„์›Œํฌ (์„ ํƒ)
โ€ข FastAPI: ๋น ๋ฅด๊ณ  ํ˜„๋Œ€์ ์ธ API ์„œ๋ฒ„
โ€ข Flask: ๊ฐ€๋ณ๊ณ  ๊ฐ„๋‹จํ•œ ์›น ํ”„๋ ˆ์ž„์›Œํฌ

5. ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค (์„ ํƒ)
โ€ข PostgreSQL + psycopg2: ๊ด€๊ณ„ํ˜• DB
โ€ข MongoDB + pymongo: NoSQL DB
โ€ข SQLite: ๊ฐ„๋‹จํ•œ ํ”„๋กœํ† ํƒ€์ž…์šฉ
๐Ÿ“ฆ ํŒจํ‚ค์ง€ ์„ค์น˜ ๋ช…๋ น์–ด

# ๊ฐ€์ƒํ™˜๊ฒฝ ์ƒ์„ฑ ๋ฐ ํ™œ์„ฑํ™”
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# ํ•„์ˆ˜ ํŒจํ‚ค์ง€ ์„ค์น˜
pip install anthropic
pip install PyPDF2 pdfplumber
pip install python-docx
pip install pytesseract pillow
pip install fastapi uvicorn
pip install python-multipart  # ํŒŒ์ผ ์—…๋กœ๋“œ์šฉ
pip install pydantic  # ๋ฐ์ดํ„ฐ ๊ฒ€์ฆ์šฉ

# ์„ ํƒ์  ํŒจํ‚ค์ง€
pip install sqlalchemy psycopg2-binary
pip install python-dotenv  # ํ™˜๊ฒฝ๋ณ€์ˆ˜ ๊ด€๋ฆฌ
โš ๏ธ ์ฃผ์˜์‚ฌํ•ญ Tesseract OCR ์„ค์น˜:
pytesseract๋Š” ํŒŒ์ด์ฌ ๋ž˜ํผ์ผ ๋ฟ์ด๊ณ , ์‹ค์ œ Tesseract ์—”์ง„์€ ๋ณ„๋„๋กœ ์„ค์น˜ํ•ด์•ผ ํ•ด.
โ€ข Windows: https://github.com/UB-Mannheim/tesseract/wiki ์—์„œ ์„ค์น˜ ํŒŒ์ผ ๋‹ค์šด๋กœ๋“œ
โ€ข Mac: brew install tesseract
โ€ข Linux: sudo apt-get install tesseract-ocr

API ํ‚ค ๊ด€๋ฆฌ:
Claude API ํ‚ค๋Š” ์ ˆ๋Œ€ ์ฝ”๋“œ์— ์ง์ ‘ ๋„ฃ์ง€ ๋ง๊ณ , ํ™˜๊ฒฝ๋ณ€์ˆ˜๋‚˜ .env ํŒŒ์ผ๋กœ ๊ด€๋ฆฌํ•ด์•ผ ํ•ด!
๊นƒํ—ˆ๋ธŒ์— ์˜ฌ๋ฆด ๋•Œ ์‹ค์ˆ˜๋กœ ํ‚ค๊ฐ€ ๋…ธ์ถœ๋˜๋ฉด ํฐ์ผ๋‚˜๊ฑฐ๋“ . ๐Ÿ”
๐Ÿ”‘ ํ™˜๊ฒฝ๋ณ€์ˆ˜ ์„ค์ • (.env ํŒŒ์ผ)

# .env ํŒŒ์ผ ์ƒ์„ฑ
ANTHROPIC_API_KEY=your_api_key_here
MAX_FILE_SIZE=10485760  # 10MB
ALLOWED_EXTENSIONS=pdf,docx,doc
DATABASE_URL=postgresql://user:password@localhost/contracts

๐Ÿ“ ํ•ต์‹ฌ ์ฝ”๋“œ ๊ตฌํ˜„ํ•˜๊ธฐ

๋“œ๋””์–ด ๋ณธ๊ฒฉ์ ์ธ ์ฝ”๋”ฉ ์‹œ๊ฐ„์ด์•ผ! ๐ŸŽ‰
๊ฐ ๊ธฐ๋Šฅ๋ณ„๋กœ ๋ชจ๋“ˆํ™”ํ•ด์„œ ๊ตฌํ˜„ํ•˜๋ฉด ๋‚˜์ค‘์— ์œ ์ง€๋ณด์ˆ˜ํ•˜๊ธฐ๋„ ํŽธํ•˜๊ณ , ์žฌ์‚ฌ์šฉ์„ฑ๋„ ๋†’์•„์ ธ.

๐Ÿ“„ 1. ๋ฌธ์„œ ํŒŒ์„œ ๋ชจ๋“ˆ (document_parser.py)

import PyPDF2
import docx
from PIL import Image
import pytesseract
from typing import Optional
import logging

logger = logging.getLogger(__name__)

class DocumentParser:
    """๋‹ค์–‘ํ•œ ํ˜•์‹์˜ ๋ฌธ์„œ์—์„œ ํ…์ŠคํŠธ๋ฅผ ์ถ”์ถœํ•˜๋Š” ํด๋ž˜์Šค"""
    
    def __init__(self):
        self.supported_formats = ['pdf', 'docx', 'doc', 'png', 'jpg', 'jpeg']
    
    def extract_text(self, file_path: str) -> Optional[str]:
        """
        ํŒŒ์ผ ๊ฒฝ๋กœ๋ฅผ ๋ฐ›์•„์„œ ํ…์ŠคํŠธ๋ฅผ ์ถ”์ถœ
        
        Args:
            file_path: ๋ฌธ์„œ ํŒŒ์ผ ๊ฒฝ๋กœ
            
        Returns:
            ์ถ”์ถœ๋œ ํ…์ŠคํŠธ ๋˜๋Š” None
        """
        file_extension = file_path.split('.')[-1].lower()
        
        try:
            if file_extension == 'pdf':
                return self._extract_from_pdf(file_path)
            elif file_extension in ['docx', 'doc']:
                return self._extract_from_docx(file_path)
            elif file_extension in ['png', 'jpg', 'jpeg']:
                return self._extract_from_image(file_path)
            else:
                logger.error(f"์ง€์›ํ•˜์ง€ ์•Š๋Š” ํŒŒ์ผ ํ˜•์‹: {file_extension}")
                return None
        except Exception as e:
            logger.error(f"ํ…์ŠคํŠธ ์ถ”์ถœ ์ค‘ ์˜ค๋ฅ˜ ๋ฐœ์ƒ: {str(e)}")
            return None
    
    def _extract_from_pdf(self, file_path: str) -> str:
        """PDF ํŒŒ์ผ์—์„œ ํ…์ŠคํŠธ ์ถ”์ถœ"""
        text = ""
        
        with open(file_path, 'rb') as file:
            pdf_reader = PyPDF2.PdfReader(file)
            
            for page_num in range(len(pdf_reader.pages)):
                page = pdf_reader.pages[page_num]
                text += page.extract_text()
        
        # ํ…์ŠคํŠธ๊ฐ€ ๊ฑฐ์˜ ์—†์œผ๋ฉด ์Šค์บ”๋œ PDF์ผ ๊ฐ€๋Šฅ์„ฑ
        if len(text.strip()) < 100:
            logger.warning("PDF์—์„œ ํ…์ŠคํŠธ๊ฐ€ ๊ฑฐ์˜ ์ถ”์ถœ๋˜์ง€ ์•Š์Œ. OCR ์‹œ๋„...")
            return self._ocr_pdf(file_path)
        
        return text
    
    def _extract_from_docx(self, file_path: str) -> str:
        """DOCX ํŒŒ์ผ์—์„œ ํ…์ŠคํŠธ ์ถ”์ถœ"""
        doc = docx.Document(file_path)
        text = ""
        
        for paragraph in doc.paragraphs:
            text += paragraph.text + "\n"
        
        # ํ‘œ ๋‚ด์šฉ๋„ ์ถ”์ถœ
        for table in doc.tables:
            for row in table.rows:
                for cell in row.cells:
                    text += cell.text + "\t"
                text += "\n"
        
        return text
    
    def _extract_from_image(self, file_path: str) -> str:
        """์ด๋ฏธ์ง€ ํŒŒ์ผ์—์„œ OCR๋กœ ํ…์ŠคํŠธ ์ถ”์ถœ"""
        image = Image.open(file_path)
        text = pytesseract.image_to_string(image, lang='kor+eng')
        return text
    
    def _ocr_pdf(self, file_path: str) -> str:
        """์Šค์บ”๋œ PDF๋ฅผ ์ด๋ฏธ์ง€๋กœ ๋ณ€ํ™˜ ํ›„ OCR"""
        # pdf2image ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ํ•„์š”
        from pdf2image import convert_from_path
        
        images = convert_from_path(file_path)
        text = ""
        
        for image in images:
            text += pytesseract.image_to_string(image, lang='kor+eng')
        
        return text
    
    def preprocess_text(self, text: str) -> str:
        """์ถ”์ถœ๋œ ํ…์ŠคํŠธ ์ „์ฒ˜๋ฆฌ"""
        # ์—ฐ์†๋œ ๊ณต๋ฐฑ ์ œ๊ฑฐ
        text = ' '.join(text.split())
        
        # ํŽ˜์ด์ง€ ๋ฒˆํ˜ธ ํŒจํ„ด ์ œ๊ฑฐ (์˜ˆ: "- 1 -", "Page 1")
        import re
        text = re.sub(r'-\s*\d+\s*-', '', text)
        text = re.sub(r'Page\s+\d+', '', text, flags=re.IGNORECASE)
        
        # ํŠน์ˆ˜๋ฌธ์ž ์ •๋ฆฌ (ํ•„์š”ํ•œ ๊ฒฝ์šฐ)
        # text = re.sub(r'[^\w\s๊ฐ€-ํžฃ.,;:()\[\]{}]', '', text)
        
        return text.strip()
๐Ÿค– 2. Claude API ํด๋ผ์ด์–ธํŠธ ๋ชจ๋“ˆ (claude_client.py)

import anthropic
import json
from typing import Dict, List, Optional
import os
from dotenv import load_dotenv

load_dotenv()

class ClaudeContractAnalyzer:
    """Claude API๋ฅผ ์‚ฌ์šฉํ•œ ๊ณ„์•ฝ์„œ ๋ถ„์„ ํด๋ž˜์Šค"""
    
    def __init__(self, api_key: Optional[str] = None):
        self.api_key = api_key or os.getenv('ANTHROPIC_API_KEY')
        self.client = anthropic.Anthropic(api_key=self.api_key)
        self.model = "claude-3-sonnet-20240229"  # ๋˜๋Š” claude-3-opus
    
    def extract_contract_clauses(self, contract_text: str) -> Dict:
        """
        ๊ณ„์•ฝ์„œ ํ…์ŠคํŠธ์—์„œ ์ฃผ์š” ์กฐํ•ญ ์ถ”์ถœ
        
        Args:
            contract_text: ๊ณ„์•ฝ์„œ ์ „๋ฌธ
            
        Returns:
            ์ถ”์ถœ๋œ ์กฐํ•ญ๋“ค์„ ๋‹ด์€ ๋”•์…”๋„ˆ๋ฆฌ
        """
        prompt = self._build_extraction_prompt(contract_text)
        
        try:
            message = self.client.messages.create(
                model=self.model,
                max_tokens=4096,
                temperature=0,  # ์ผ๊ด€์„ฑ์„ ์œ„ํ•ด 0์œผ๋กœ ์„ค์ •
                messages=[
                    {"role": "user", "content": prompt}
                ]
            )
            
            # ์‘๋‹ต์—์„œ ํ…์ŠคํŠธ ์ถ”์ถœ
            response_text = message.content[0].text
            
            # JSON ํŒŒ์‹ฑ
            result = self._parse_response(response_text)
            
            return result
            
        except Exception as e:
            print(f"Claude API ํ˜ธ์ถœ ์ค‘ ์˜ค๋ฅ˜: {str(e)}")
            return {}
    
    def _build_extraction_prompt(self, contract_text: str) -> str:
        """๊ณ„์•ฝ์„œ ๋ถ„์„์„ ์œ„ํ•œ ํ”„๋กฌํ”„ํŠธ ์ƒ์„ฑ"""
        
        prompt = f"""๋‹น์‹ ์€ ๋ฒ•๋ฅ  ๋ฌธ์„œ ๋ถ„์„ ์ „๋ฌธ๊ฐ€์ž…๋‹ˆ๋‹ค. 
๋‹ค์Œ ๊ณ„์•ฝ์„œ์—์„œ ์ฃผ์š” ์กฐํ•ญ๋“ค์„ ์ถ”์ถœํ•˜์—ฌ ๊ตฌ์กฐํ™”๋œ JSON ํ˜•์‹์œผ๋กœ ๋ฐ˜ํ™˜ํ•ด์ฃผ์„ธ์š”.

์ถ”์ถœํ•ด์•ผ ํ•  ํ•ญ๋ชฉ:
1. ๊ณ„์•ฝ ๋‹น์‚ฌ์ž (parties): ๊ฐ‘, ์„ ๋“ฑ์˜ ๋‹น์‚ฌ์ž ์ •๋ณด
2. ๊ณ„์•ฝ ๋ชฉ์  (purpose): ๊ณ„์•ฝ์˜ ์ฃผ์š” ๋ชฉ์ 
3. ๊ณ„์•ฝ ๊ธฐ๊ฐ„ (duration): ์‹œ์ž‘์ผ, ์ข…๋ฃŒ์ผ, ๊ธฐ๊ฐ„
4. ๊ณ„์•ฝ ๊ธˆ์•ก (amount): ๊ณ„์•ฝ๊ธˆ, ์ค‘๋„๊ธˆ, ์ž”๊ธˆ ๋“ฑ
5. ์ง€๊ธ‰ ์กฐ๊ฑด (payment_terms): ์ง€๊ธ‰ ๋ฐฉ๋ฒ•, ์‹œ๊ธฐ
6. ์˜๋ฌด์‚ฌํ•ญ (obligations): ๊ฐ ๋‹น์‚ฌ์ž์˜ ์ฃผ์š” ์˜๋ฌด
7. ์œ„์•ฝ ์กฐ๊ฑด (penalty_clauses): ์œ„์•ฝ๊ธˆ, ์†ํ•ด๋ฐฐ์ƒ ์กฐ๊ฑด
8. ํ•ด์ง€ ์กฐ๊ฑด (termination_clauses): ๊ณ„์•ฝ ํ•ด์ง€ ์‚ฌ์œ  ๋ฐ ์ ˆ์ฐจ
9. ๋ถ„์Ÿ ํ•ด๊ฒฐ (dispute_resolution): ๊ด€ํ•  ๋ฒ•์›, ์ค‘์žฌ ์กฐํ•ญ
10. ํŠน์•ฝ ์‚ฌํ•ญ (special_provisions): ๊ธฐํƒ€ ํŠน๋ณ„ํ•œ ์•ฝ์ •

๊ณ„์•ฝ์„œ ๋‚ด์šฉ:
{contract_text}

์‘๋‹ต ํ˜•์‹ (๋ฐ˜๋“œ์‹œ ์œ ํšจํ•œ JSON์œผ๋กœ ๋ฐ˜ํ™˜):
{{
    "parties": {{
        "party_a": "๊ฐ‘ ๋‹น์‚ฌ์ž ์ •๋ณด",
        "party_b": "์„ ๋‹น์‚ฌ์ž ์ •๋ณด"
    }},
    "purpose": "๊ณ„์•ฝ ๋ชฉ์ ",
    "duration": {{
        "start_date": "YYYY-MM-DD",
        "end_date": "YYYY-MM-DD",
        "period": "๊ธฐ๊ฐ„ ์„ค๋ช…"
    }},
    "amount": {{
        "total": "์ด ๊ธˆ์•ก",
        "breakdown": ["๊ณ„์•ฝ๊ธˆ", "์ค‘๋„๊ธˆ", "์ž”๊ธˆ"]
    }},
    "payment_terms": "์ง€๊ธ‰ ์กฐ๊ฑด ์„ค๋ช…",
    "obligations": {{
        "party_a": ["์˜๋ฌด1", "์˜๋ฌด2"],
        "party_b": ["์˜๋ฌด1", "์˜๋ฌด2"]
    }},
    "penalty_clauses": "์œ„์•ฝ ์กฐ๊ฑด ์„ค๋ช…",
    "termination_clauses": "ํ•ด์ง€ ์กฐ๊ฑด ์„ค๋ช…",
    "dispute_resolution": "๋ถ„์Ÿ ํ•ด๊ฒฐ ๋ฐฉ๋ฒ•",
    "special_provisions": ["ํŠน์•ฝ1", "ํŠน์•ฝ2"]
}}

์ฃผ์˜์‚ฌํ•ญ:
- ๊ณ„์•ฝ์„œ์— ๋ช…์‹œ๋˜์ง€ ์•Š์€ ๋‚ด์šฉ์€ "๋ช…์‹œ๋˜์ง€ ์•Š์Œ"์œผ๋กœ ํ‘œ์‹œ
- ๋‚ ์งœ๋Š” YYYY-MM-DD ํ˜•์‹์œผ๋กœ ํ†ต์ผ
- ๊ธˆ์•ก์€ ์ˆซ์ž์™€ ๋‹จ์œ„๋ฅผ ๋ช…ํ™•ํžˆ ํ‘œ์‹œ
- ๋ชจํ˜ธํ•œ ํ‘œํ˜„์€ ์›๋ฌธ ๊ทธ๋Œ€๋กœ ์ธ์šฉ"""

        return prompt
    
    def _parse_response(self, response_text: str) -> Dict:
        """Claude ์‘๋‹ต์„ ํŒŒ์‹ฑํ•˜์—ฌ ๋”•์…”๋„ˆ๋ฆฌ๋กœ ๋ณ€ํ™˜"""
        try:
            # JSON ๋ถ€๋ถ„๋งŒ ์ถ”์ถœ (๋งˆํฌ๋‹ค์šด ์ฝ”๋“œ ๋ธ”๋ก ์ œ๊ฑฐ)
            if "```json" in response_text:
                json_start = response_text.find("```json") + 7
                json_end = response_text.find("```", json_start)
                json_text = response_text[json_start:json_end].strip()
            elif "```" in response_text:
                json_start = response_text.find("```") + 3
                json_end = response_text.find("```", json_start)
                json_text = response_text[json_start:json_end].strip()
            else:
                json_text = response_text.strip()
            
            # JSON ํŒŒ์‹ฑ
            result = json.loads(json_text)
            return result
            
        except json.JSONDecodeError as e:
            print(f"JSON ํŒŒ์‹ฑ ์˜ค๋ฅ˜: {str(e)}")
            print(f"์‘๋‹ต ํ…์ŠคํŠธ: {response_text[:500]}...")
            return {"error": "JSON ํŒŒ์‹ฑ ์‹คํŒจ", "raw_response": response_text}
    
    def validate_extraction(self, extracted_data: Dict) -> Dict:
        """์ถ”์ถœ๋œ ๋ฐ์ดํ„ฐ์˜ ์œ ํšจ์„ฑ ๊ฒ€์ฆ"""
        validation_result = {
            "is_valid": True,
            "warnings": [],
            "errors": []
        }
        
        # ํ•„์ˆ˜ ํ•„๋“œ ์ฒดํฌ
        required_fields = ["parties", "purpose", "duration"]
        for field in required_fields:
            if field not in extracted_data or not extracted_data[field]:
                validation_result["errors"].append(f"ํ•„์ˆ˜ ํ•„๋“œ ๋ˆ„๋ฝ: {field}")
                validation_result["is_valid"] = False
        
        # ๋‚ ์งœ ํ˜•์‹ ๊ฒ€์ฆ
        if "duration" in extracted_data:
            duration = extracted_data["duration"]
            if isinstance(duration, dict):
                for date_field in ["start_date", "end_date"]:
                    if date_field in duration:
                        date_value = duration[date_field]
                        if date_value != "๋ช…์‹œ๋˜์ง€ ์•Š์Œ":
                            import re
                            if not re.match(r'\d{4}-\d{2}-\d{2}', date_value):
                                validation_result["warnings"].append(
                                    f"๋‚ ์งœ ํ˜•์‹ ๋ถˆ์ผ์น˜: {date_field}"
                                )
        
        # ๊ธˆ์•ก ์ •๋ณด ๊ฒ€์ฆ
        if "amount" in extracted_data:
            amount = extracted_data["amount"]
            if isinstance(amount, dict) and "total" in amount:
                if amount["total"] == "๋ช…์‹œ๋˜์ง€ ์•Š์Œ":
                    validation_result["warnings"].append("๊ณ„์•ฝ ๊ธˆ์•ก์ด ๋ช…์‹œ๋˜์ง€ ์•Š์Œ")
        
        return validation_result
๐Ÿ’ก ํ”„๋กฌํ”„ํŠธ ์—”์ง€๋‹ˆ์–ด๋ง ํŒ ํ”„๋กฌํ”„ํŠธ ์„ค๊ณ„๊ฐ€ ๊ฒฐ๊ณผ์˜ 90%๋ฅผ ์ขŒ์šฐํ•ด! ์ข‹์€ ํ”„๋กฌํ”„ํŠธ์˜ ํŠน์ง•:
โ€ข ๋ช…ํ™•ํ•œ ์—ญํ•  ๋ถ€์—ฌ: "๋‹น์‹ ์€ ๋ฒ•๋ฅ  ๋ฌธ์„œ ๋ถ„์„ ์ „๋ฌธ๊ฐ€์ž…๋‹ˆ๋‹ค"
โ€ข ๊ตฌ์ฒด์ ์ธ ์ง€์‹œ์‚ฌํ•ญ: ์ถ”์ถœํ•  ํ•ญ๋ชฉ์„ ๋ช…ํ™•ํžˆ ๋‚˜์—ด
โ€ข ์ถœ๋ ฅ ํ˜•์‹ ์ง€์ •: JSON ์Šคํ‚ค๋งˆ๋ฅผ ์˜ˆ์‹œ๋กœ ์ œ๊ณต
โ€ข ์˜ˆ์™ธ ์ฒ˜๋ฆฌ ๊ทœ์น™: ์ •๋ณด๊ฐ€ ์—†์„ ๋•Œ ์–ด๋–ป๊ฒŒ ํ‘œ์‹œํ• ์ง€ ๋ช…์‹œ
โ€ข Temperature 0: ์ผ๊ด€์„ฑ ์žˆ๋Š” ๊ฒฐ๊ณผ๋ฅผ ์œ„ํ•ด ์ฐฝ์˜์„ฑ ์ตœ์†Œํ™”

๐Ÿš€ FastAPI๋กœ ์›น ์„œ๋น„์Šค ๋งŒ๋“ค๊ธฐ

์ด์ œ ๋งŒ๋“  ๊ธฐ๋Šฅ๋“ค์„ ์›น API๋กœ ์ œ๊ณตํ•ด๋ณด์ž! ๐ŸŒ
FastAPI๋ฅผ ์‚ฌ์šฉํ•˜๋ฉด ๋น ๋ฅด๊ณ  ์‰ฝ๊ฒŒ RESTful API๋ฅผ ๊ตฌ์ถ•ํ•  ์ˆ˜ ์žˆ์–ด.

๐ŸŒ 3. API ์„œ๋ฒ„ ๊ตฌํ˜„ (main.py)

from fastapi import FastAPI, File, UploadFile, HTTPException
from fastapi.responses import JSONResponse
from fastapi.middleware.cors import CORSMiddleware
import shutil
import os
from pathlib import Path
from typing import Optional
import logging

from document_parser import DocumentParser
from claude_client import ClaudeContractAnalyzer

# ๋กœ๊น… ์„ค์ •
logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(__name__)

# FastAPI ์•ฑ ์ƒ์„ฑ
app = FastAPI(
    title="๊ณ„์•ฝ์„œ ์ž๋™ ๋ถ„์„ API",
    description="Claude AI๋ฅผ ํ™œ์šฉํ•œ ๊ณ„์•ฝ์„œ ์ฃผ์š” ์กฐํ•ญ ์ž๋™ ์ถ”์ถœ ์‹œ์Šคํ…œ",
    version="1.0.0"
)

# CORS ์„ค์ • (ํ”„๋ก ํŠธ์—”๋“œ์—์„œ ์ ‘๊ทผ ๊ฐ€๋Šฅํ•˜๋„๋ก)
app.add_middleware(
    CORSMiddleware,
    allow_origins=["*"],  # ํ”„๋กœ๋•์…˜์—์„œ๋Š” ํŠน์ • ๋„๋ฉ”์ธ๋งŒ ํ—ˆ์šฉ
    allow_credentials=True,
    allow_methods=["*"],
    allow_headers=["*"],
)

# ์—…๋กœ๋“œ ๋””๋ ‰ํ† ๋ฆฌ ์„ค์ •
UPLOAD_DIR = Path("uploads")
UPLOAD_DIR.mkdir(exist_ok=True)

# ํด๋ž˜์Šค ์ธ์Šคํ„ด์Šค ์ƒ์„ฑ
parser = DocumentParser()
analyzer = ClaudeContractAnalyzer()

@app.get("/")
async def root():
    """API ๋ฃจํŠธ ์—”๋“œํฌ์ธํŠธ"""
    return {
        "message": "๊ณ„์•ฝ์„œ ์ž๋™ ๋ถ„์„ API์— ์˜ค์‹  ๊ฒƒ์„ ํ™˜์˜ํ•ฉ๋‹ˆ๋‹ค!",
        "endpoints": {
            "upload": "/api/analyze",
            "health": "/health"
        }
    }

@app.get("/health")
async def health_check():
    """์„œ๋ฒ„ ์ƒํƒœ ํ™•์ธ"""
    return {"status": "healthy", "service": "contract-analyzer"}

@app.post("/api/analyze")
async def analyze_contract(
    file: UploadFile = File(...),
    extract_tables: Optional[bool] = False
):
    """
    ๊ณ„์•ฝ์„œ ํŒŒ์ผ์„ ์—…๋กœ๋“œํ•˜๊ณ  ์ฃผ์š” ์กฐํ•ญ์„ ์ถ”์ถœ
    
    Args:
        file: ์—…๋กœ๋“œํ•  ๊ณ„์•ฝ์„œ ํŒŒ์ผ (PDF, DOCX, ์ด๋ฏธ์ง€)
        extract_tables: ํ‘œ ๋ฐ์ดํ„ฐ ์ถ”์ถœ ์—ฌ๋ถ€
        
    Returns:
        ์ถ”์ถœ๋œ ๊ณ„์•ฝ์„œ ์กฐํ•ญ ์ •๋ณด
    """
    
    # ํŒŒ์ผ ํ™•์žฅ์ž ๊ฒ€์ฆ
    file_extension = file.filename.split('.')[-1].lower()
    if file_extension not in parser.supported_formats:
        raise HTTPException(
            status_code=400,
            detail=f"์ง€์›ํ•˜์ง€ ์•Š๋Š” ํŒŒ์ผ ํ˜•์‹์ž…๋‹ˆ๋‹ค. ์ง€์› ํ˜•์‹: {', '.join(parser.supported_formats)}"
        )
    
    # ํŒŒ์ผ ํฌ๊ธฐ ๊ฒ€์ฆ (10MB ์ œํ•œ)
    file.file.seek(0, 2)  # ํŒŒ์ผ ๋์œผ๋กœ ์ด๋™
    file_size = file.file.tell()  # ํ˜„์žฌ ์œ„์น˜ = ํŒŒ์ผ ํฌ๊ธฐ
    file.file.seek(0)  # ๋‹ค์‹œ ์ฒ˜์Œ์œผ๋กœ
    
    if file_size > 10 * 1024 * 1024:  # 10MB
        raise HTTPException(
            status_code=400,
            detail="ํŒŒ์ผ ํฌ๊ธฐ๋Š” 10MB๋ฅผ ์ดˆ๊ณผํ•  ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค."
        )
    
    # ํŒŒ์ผ ์ €์žฅ
    file_path = UPLOAD_DIR / file.filename
    try:
        with open(file_path, "wb") as buffer:
            shutil.copyfileobj(file.file, buffer)
        
        logger.info(f"ํŒŒ์ผ ์—…๋กœ๋“œ ์™„๋ฃŒ: {file.filename}")
        
        # 1๋‹จ๊ณ„: ํ…์ŠคํŠธ ์ถ”์ถœ
        logger.info("ํ…์ŠคํŠธ ์ถ”์ถœ ์‹œ์ž‘...")
        raw_text = parser.extract_text(str(file_path))
        
        if not raw_text:
            raise HTTPException(
                status_code=500,
                detail="ํŒŒ์ผ์—์„œ ํ…์ŠคํŠธ๋ฅผ ์ถ”์ถœํ•  ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค."
            )
        
        # 2๋‹จ๊ณ„: ํ…์ŠคํŠธ ์ „์ฒ˜๋ฆฌ
        logger.info("ํ…์ŠคํŠธ ์ „์ฒ˜๋ฆฌ ์ค‘...")
        processed_text = parser.preprocess_text(raw_text)
        
        # 3๋‹จ๊ณ„: Claude๋กœ ์กฐํ•ญ ์ถ”์ถœ
        logger.info("AI ๋ถ„์„ ์‹œ์ž‘...")
        extracted_data = analyzer.extract_contract_clauses(processed_text)
        
        # 4๋‹จ๊ณ„: ๊ฒฐ๊ณผ ๊ฒ€์ฆ
        logger.info("๊ฒฐ๊ณผ ๊ฒ€์ฆ ์ค‘...")
        validation = analyzer.validate_extraction(extracted_data)
        
        # ์‘๋‹ต ๊ตฌ์„ฑ
        response = {
            "success": True,
            "filename": file.filename,
            "file_size": file_size,
            "extracted_data": extracted_data,
            "validation": validation,
            "metadata": {
                "text_length": len(processed_text),
                "model_used": analyzer.model
            }
        }
        
        logger.info("๋ถ„์„ ์™„๋ฃŒ!")
        return JSONResponse(content=response)
        
    except Exception as e:
        logger.error(f"๋ถ„์„ ์ค‘ ์˜ค๋ฅ˜ ๋ฐœ์ƒ: {str(e)}")
        raise HTTPException(
            status_code=500,
            detail=f"๋ถ„์„ ์ค‘ ์˜ค๋ฅ˜๊ฐ€ ๋ฐœ์ƒํ–ˆ์Šต๋‹ˆ๋‹ค: {str(e)}"
        )
    
    finally:
        # ์ž„์‹œ ํŒŒ์ผ ์‚ญ์ œ (์„ ํƒ์‚ฌํ•ญ)
        if file_path.exists():
            # file_path.unlink()  # ํŒŒ์ผ ๋ณด๊ด€ํ•˜๋ ค๋ฉด ์ฃผ์„ ์ฒ˜๋ฆฌ
            pass

@app.post("/api/batch-analyze")
async def batch_analyze_contracts(files: list[UploadFile] = File(...)):
    """
    ์—ฌ๋Ÿฌ ๊ณ„์•ฝ์„œ๋ฅผ ํ•œ ๋ฒˆ์— ๋ถ„์„
    
    Args:
        files: ์—…๋กœ๋“œํ•  ๊ณ„์•ฝ์„œ ํŒŒ์ผ ๋ฆฌ์ŠคํŠธ
        
    Returns:
        ๊ฐ ํŒŒ์ผ๋ณ„ ๋ถ„์„ ๊ฒฐ๊ณผ
    """
    results = []
    
    for file in files:
        try:
            # ๊ฐ ํŒŒ์ผ์— ๋Œ€ํ•ด analyze_contract ๋กœ์ง ์‹คํ–‰
            result = await analyze_contract(file)
            results.append({
                "filename": file.filename,
                "status": "success",
                "data": result
            })
        except Exception as e:
            results.append({
                "filename": file.filename,
                "status": "error",
                "error": str(e)
            })
    
    return JSONResponse(content={
        "total_files": len(files),
        "results": results
    })

if __name__ == "__main__":
    import uvicorn
    uvicorn.run(app, host="0.0.0.0", port=8000)
๐Ÿš€ ์„œ๋ฒ„ ์‹คํ–‰ ๋ฐฉ๋ฒ•

# ๊ฐœ๋ฐœ ๋ชจ๋“œ๋กœ ์‹คํ–‰ (์ž๋™ ๋ฆฌ๋กœ๋“œ)
uvicorn main:app --reload --host 0.0.0.0 --port 8000

# ํ”„๋กœ๋•์…˜ ๋ชจ๋“œ๋กœ ์‹คํ–‰
uvicorn main:app --host 0.0.0.0 --port 8000 --workers 4

# ์„œ๋ฒ„ ์‹คํ–‰ ํ›„ ์ ‘์†
# API ๋ฌธ์„œ: http://localhost:8000/docs
# ๋Œ€์ฒด ๋ฌธ์„œ: http://localhost:8000/redoc
๐ŸŽ‰ FastAPI์˜ ์žฅ์  โ€ข ์ž๋™ API ๋ฌธ์„œ: Swagger UI๊ฐ€ ์ž๋™์œผ๋กœ ์ƒ์„ฑ๋ผ์„œ ํ…Œ์ŠคํŠธ๊ฐ€ ํŽธํ•ด
โ€ข ํƒ€์ž… ํžŒํŒ…: Python์˜ ํƒ€์ž… ํžŒํŠธ๋ฅผ ํ™œ์šฉํ•ด์„œ ์ž๋™ ๊ฒ€์ฆ
โ€ข ๋น„๋™๊ธฐ ์ง€์›: async/await๋กœ ๋†’์€ ์„ฑ๋Šฅ ๊ตฌํ˜„
โ€ข ์˜์กด์„ฑ ์ฃผ์ž…: ์ฝ”๋“œ ์žฌ์‚ฌ์šฉ์„ฑ๊ณผ ํ…Œ์ŠคํŠธ ์šฉ์ด์„ฑ ํ–ฅ์ƒ
โ€ข ๋น ๋ฅธ ๊ฐœ๋ฐœ: ๋ณด์ผ๋Ÿฌํ”Œ๋ ˆ์ดํŠธ ์ฝ”๋“œ ์ตœ์†Œํ™”

๐ŸŽจ ํ”„๋ก ํŠธ์—”๋“œ ์ธํ„ฐํŽ˜์ด์Šค ๊ตฌ์ถ•

๋ฐฑ์—”๋“œ API๊ฐ€ ์ค€๋น„๋์œผ๋‹ˆ, ์ด์ œ ์‚ฌ์šฉ์ž๊ฐ€ ์‰ฝ๊ฒŒ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋Š” ์›น ์ธํ„ฐํŽ˜์ด์Šค๋ฅผ ๋งŒ๋“ค์–ด๋ณด์ž! ๐Ÿ–ฅ๏ธ
๊ฐ„๋‹จํ•œ HTML + JavaScript๋กœ๋„ ์ถฉ๋ถ„ํžˆ ๋ฉ‹์ง„ UI๋ฅผ ๋งŒ๋“ค ์ˆ˜ ์žˆ์–ด.

๐ŸŽจ 4. ์›น ์ธํ„ฐํŽ˜์ด์Šค (index.html)

<!DOCTYPE html>
<html lang="ko">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>๊ณ„์•ฝ์„œ ์ž๋™ ๋ถ„์„ ์‹œ์Šคํ…œ</title>
    <style>
        * { margin: 0; padding: 0; box-sizing: border-box; }
        body { font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif; background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); min-height: 100vh; padding: 20px; }
        .container { max-width: 900px; margin: 0 auto; background: white; border-radius: 20px; padding: 40px; box-shadow: 0 20px 60px rgba(0,0,0,0.3); }
        h1 { color: #667eea; text-align: center; margin-bottom: 30px; font-size: 2.5em; }
        .upload-area { border: 3px dashed #667eea; border-radius: 15px; padding: 60px 20px; text-align: center; cursor: pointer; transition: all 0.3s; margin-bottom: 30px; }
        .upload-area:hover { background: #f0f4ff; border-color: #764ba2; }
        .upload-area.dragover { background: #e0e7ff; border-color: #4c51bf; }
        .file-input { display: none; }
        .upload-icon { font-size: 4em; margin-bottom: 20px; }
        .upload-text { font-size: 1.2em; color: #666; }
        .file-info { background: #f0f4ff; padding: 15px; border-radius: 10px; margin-bottom: 20px; display: none; }
        .analyze-btn { background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); color: white; border: none; padding: 15px 40px; font-size: 1.1em; border-radius: 10px; cursor: pointer; width: 100%; transition: transform 0.2s; }
        .analyze-btn:hover { transform: translateY(-2px); box-shadow: 0 5px 15px rgba(102, 126, 234, 0.4); }
        .analyze-btn:disabled { opacity: 0.5; cursor: not-allowed; }
        .loading { display: none; text-align: center; margin: 20px 0; }
        .spinner { border: 4px solid #f3f3f3; border-top: 4px solid #667eea; border-radius: 50%; width: 50px; height: 50px; animation: spin 1s linear infinite; margin: 0 auto; }
        @keyframes spin { 0% { transform: rotate(0deg); } 100% { transform: rotate(360deg); } }
        .results { display: none; margin-top: 30px; }
        .result-section { background: #f9fafb; padding: 20px; border-radius: 10px; margin-bottom: 15px; border-left: 4px solid #667eea; }
        .result-title { font-size: 1.2em; font-weight: bold; color: #667eea; margin-bottom: 10px; }
        .result-content { color: #333; line-height: 1.6; }
        .error { background: #fee; border-left-color: #e53e3e; }
        .error .result-title { color: #e53e3e; }
    </style>
</head>
<body>
    <div class="container">
        <h1>๐Ÿ“„ ๊ณ„์•ฝ์„œ ์ž๋™ ๋ถ„์„ ์‹œ์Šคํ…œ</h1>
        
        <div class="upload-area" id="uploadArea">
            <div class="upload-icon">๐Ÿ“</div>
            <div class="upload-text">
                ํด๋ฆญํ•˜๊ฑฐ๋‚˜ ํŒŒ์ผ์„ ๋“œ๋ž˜๊ทธํ•˜์—ฌ ์—…๋กœ๋“œํ•˜์„ธ์š”<br>
                <small>(PDF, DOCX, ์ด๋ฏธ์ง€ ํŒŒ์ผ ์ง€์›)</small>
            </div>
            <input type="file" id="fileInput" class="file-input" accept=".pdf,.docx,.doc,.png,.jpg,.jpeg">
        </div>
        
        <div class="file-info" id="fileInfo"></div>
        
        <button class="analyze-btn" id="analyzeBtn" disabled>๋ถ„์„ ์‹œ์ž‘ ๐Ÿš€</button>
        
        <div class="loading" id="loading">
            <div class="spinner"></div>
            <p>AI๊ฐ€ ๊ณ„์•ฝ์„œ๋ฅผ ๋ถ„์„ํ•˜๊ณ  ์žˆ์Šต๋‹ˆ๋‹ค...</p>
        </div>
        
        <div class="results" id="results"></div>
    </div>

    <script>
        const uploadArea = document.getElementById('uploadArea');
        const fileInput = document.getElementById('fileInput');
        const fileInfo = document.getElementById('fileInfo');
        const analyzeBtn = document.getElementById('analyzeBtn');
        const loading = document.getElementById('loading');
        const results = document.getElementById('results');
        
        let selectedFile = null;
        
        // ํด๋ฆญ์œผ๋กœ ํŒŒ์ผ ์„ ํƒ
        uploadArea.addEventListener('click', () => fileInput.click());
        
        // ํŒŒ์ผ ์„ ํƒ ์ด๋ฒคํŠธ
        fileInput.addEventListener('change', (e) => {
            handleFile(e.target.files[0]);
        });
        
        // ๋“œ๋ž˜๊ทธ ์•ค ๋“œ๋กญ
        uploadArea.addEventListener('dragover', (e) => {
            e.preventDefault();
            uploadArea.classList.add('dragover');
        });
        
        uploadArea.addEventListener('dragleave', () => {
            uploadArea.classList.remove('dragover');
        });
        
        uploadArea.addEventListener('drop', (e) => {
            e.preventDefault();
            uploadArea.classList.remove('dragover');
            handleFile(e.dataTransfer.files[0]);
        });
        
        function handleFile(file) {
            if (!file) return;
            
            selectedFile = file;
            const fileSize = (file.size / 1024 / 1024).toFixed(2);
            
            fileInfo.innerHTML = `
                <strong>์„ ํƒ๋œ ํŒŒ์ผ:</strong> ${file.name}<br>
                <strong>ํฌ๊ธฐ:</strong> ${fileSize} MB<br>
                <strong>ํ˜•์‹:</strong> ${file.type || '์•Œ ์ˆ˜ ์—†์Œ'}
            `;
            fileInfo.style.display = 'block';
            analyzeBtn.disabled = false;
        }
        
        // ๋ถ„์„ ๋ฒ„ํŠผ ํด๋ฆญ
        analyzeBtn.addEventListener('click', async () => {
            if (!selectedFile) return;
            
            analyzeBtn.disabled = true;
            loading.style.display = 'block';
            results.style.display = 'none';
            
            const formData = new FormData();
            formData.append('file', selectedFile);
            
            try {
                const response = await fetch('http://localhost:8000/api/analyze', {
                    method: 'POST',
                    body: formData
                });
                
                const data = await response.json();
                
                if (data.success) {
                    displayResults(data.extracted_data);
                } else {
                    showError('๋ถ„์„์— ์‹คํŒจํ–ˆ์Šต๋‹ˆ๋‹ค.');
                }
            } catch (error) {
                showError('์„œ๋ฒ„ ์—ฐ๊ฒฐ์— ์‹คํŒจํ–ˆ์Šต๋‹ˆ๋‹ค: ' + error.message);
            } finally {
                loading.style.display = 'none';
                analyzeBtn.disabled = false;
            }
        });
        
        function displayResults(data) {
            results.innerHTML = '';
            
            // ๊ณ„์•ฝ ๋‹น์‚ฌ์ž
            if (data.parties) {
                addResultSection('๊ณ„์•ฝ ๋‹น์‚ฌ์ž', `
                    <strong>๊ฐ‘:</strong> ${data.parties.party_a || '๋ช…์‹œ๋˜์ง€ ์•Š์Œ'}<br>
                    <strong>์„:</strong> ${data.parties.party_b || '๋ช…์‹œ๋˜์ง€ ์•Š์Œ'}
                `);
            }
            
            // ๊ณ„์•ฝ ๋ชฉ์ 
            if (data.purpose) {
                addResultSection('๊ณ„์•ฝ ๋ชฉ์ ', data.purpose);
            }
            
            // ๊ณ„์•ฝ ๊ธฐ๊ฐ„
            if (data.duration) {
                const duration = data.duration;
                addResultSection('๊ณ„์•ฝ ๊ธฐ๊ฐ„', `
                    <strong>์‹œ์ž‘์ผ:</strong> ${duration.start_date || '๋ช…์‹œ๋˜์ง€ ์•Š์Œ'}<br>
                    <strong>์ข…๋ฃŒ์ผ:</strong> ${duration.end_date || '๋ช…์‹œ๋˜์ง€ ์•Š์Œ'}<br>
                    <strong>๊ธฐ๊ฐ„:</strong> ${duration.period || '๋ช…์‹œ๋˜์ง€ ์•Š์Œ'}
                `);
            }
            
            // ๊ณ„์•ฝ ๊ธˆ์•ก
            if (data.amount) {
                const amount = data.amount;
                let amountHtml = `<strong>์ด์•ก:</strong> ${amount.total || '๋ช…์‹œ๋˜์ง€ ์•Š์Œ'}`;
                if (amount.breakdown && amount.breakdown.length > 0) {
                    amountHtml += '<br><strong>์„ธ๋ถ€๋‚ด์—ญ:</strong><ul>';
                    amount.breakdown.forEach(item => {
                        amountHtml += `<li>${item}</li>`;
                    });
                    amountHtml += '</ul>';
                }
                addResultSection('๊ณ„์•ฝ ๊ธˆ์•ก', amountHtml);
            }
            
            // ์œ„์•ฝ ์กฐ๊ฑด
            if (data.penalty_clauses) {
                addResultSection('์œ„์•ฝ ์กฐ๊ฑด', data.penalty_clauses);
            }
            
            // ํ•ด์ง€ ์กฐ๊ฑด
            if (data.termination_clauses) {
                addResultSection('ํ•ด์ง€ ์กฐ๊ฑด', data.termination_clauses);
            }
            
            results.style.display = 'block';
        }
        
        function addResultSection(title, content) {
            const section = document.createElement('div');
            section.className = 'result-section';
            section.innerHTML = `
                <div class="result-title">${title}</div>
                <div class="result-content">${content}</div>
            `;
            results.appendChild(section);
        }
        
        function showError(message) {
            results.innerHTML = `
                <div class="result-section error">
                    <div class="result-title">์˜ค๋ฅ˜ ๋ฐœ์ƒ</div>
                    <div class="result-content">${message}</div>
                </div>
            `;
            results.style.display = 'block';
        }
    </script>
</body>
</html>
โš ๏ธ CORS ์ด์Šˆ ํ•ด๊ฒฐ ๋กœ์ปฌ์—์„œ HTML ํŒŒ์ผ์„ ์ง์ ‘ ์—ด๋ฉด CORS ์—๋Ÿฌ๊ฐ€ ๋ฐœ์ƒํ•  ์ˆ˜ ์žˆ์–ด.
ํ•ด๊ฒฐ ๋ฐฉ๋ฒ•:
1. ๊ฐ„๋‹จํ•œ HTTP ์„œ๋ฒ„ ์‹คํ–‰: python -m http.server 3000
2. FastAPI์— CORS ๋ฏธ๋“ค์›จ์–ด ์ถ”๊ฐ€ (์œ„ ์ฝ”๋“œ์— ์ด๋ฏธ ํฌํ•จ๋จ)
3. ๋ธŒ๋ผ์šฐ์ € ํ™•์žฅ ํ”„๋กœ๊ทธ๋žจ ์‚ฌ์šฉ (๊ฐœ๋ฐœ ์‹œ์—๋งŒ!)

๐Ÿ”ง ๊ณ ๊ธ‰ ๊ธฐ๋Šฅ ์ถ”๊ฐ€ํ•˜๊ธฐ

๊ธฐ๋ณธ ๊ธฐ๋Šฅ์ด ์™„์„ฑ๋์œผ๋‹ˆ, ์ด์ œ ์‹œ์Šคํ…œ์„ ๋” ๊ฐ•๋ ฅํ•˜๊ฒŒ ๋งŒ๋“ค์–ด๋ณด์ž! ๐Ÿ’ช
์‹ค๋ฌด์—์„œ ์œ ์šฉํ•œ ๊ณ ๊ธ‰ ๊ธฐ๋Šฅ๋“ค์„ ์ถ”๊ฐ€ํ•ด๋ณผ๊ฒŒ.

๐ŸŽฏ 1. ๊ณ„์•ฝ์„œ ๋น„๊ต ๊ธฐ๋Šฅ

์—ฌ๋Ÿฌ ๊ณ„์•ฝ์„œ๋ฅผ ๋น„๊ตํ•ด์„œ ์ฐจ์ด์ ์„ ์ฐพ์•„๋‚ด๋Š” ๊ธฐ๋Šฅ์ด์•ผ.
์˜ˆ๋ฅผ ๋“ค์–ด, ํ‘œ์ค€ ๊ณ„์•ฝ์„œ์™€ ์‹ค์ œ ๊ณ„์•ฝ์„œ๋ฅผ ๋น„๊ตํ•˜๊ฑฐ๋‚˜, ์—ฌ๋Ÿฌ ๊ณต๊ธ‰์—…์ฒด์˜ ๊ณ„์•ฝ ์กฐ๊ฑด์„ ๋น„๊ตํ•  ๋•Œ ์œ ์šฉํ•ด.

def compare_contracts(self, contract1_text: str, contract2_text: str) -> Dict:
    """๋‘ ๊ณ„์•ฝ์„œ๋ฅผ ๋น„๊ตํ•˜์—ฌ ์ฐจ์ด์  ๋ถ„์„"""
    
    prompt = f"""๋‹ค์Œ ๋‘ ๊ณ„์•ฝ์„œ๋ฅผ ๋น„๊ตํ•˜์—ฌ ์ฃผ์š” ์ฐจ์ด์ ์„ ๋ถ„์„ํ•ด์ฃผ์„ธ์š”.

๊ณ„์•ฝ์„œ A:
{contract1_text[:5000]}  # ํ† ํฐ ์ œํ•œ ๊ณ ๋ ค

๊ณ„์•ฝ์„œ B:
{contract2_text[:5000]}

๋‹ค์Œ ํ•ญ๋ชฉ๋“ค์— ๋Œ€ํ•ด ๋น„๊ต ๋ถ„์„ํ•ด์ฃผ์„ธ์š”:
1. ๊ณ„์•ฝ ๊ธˆ์•ก์˜ ์ฐจ์ด
2. ๊ณ„์•ฝ ๊ธฐ๊ฐ„์˜ ์ฐจ์ด
3. ์˜๋ฌด์‚ฌํ•ญ์˜ ์ฐจ์ด
4. ์œ„์•ฝ ์กฐ๊ฑด์˜ ์ฐจ์ด
5. ๊ธฐํƒ€ ์ค‘์š”ํ•œ ์ฐจ์ด์ 

JSON ํ˜•์‹์œผ๋กœ ๋ฐ˜ํ™˜:
{{
    "differences": [
        {{
            "category": "์นดํ…Œ๊ณ ๋ฆฌ",
            "contract_a": "๊ณ„์•ฝ์„œ A์˜ ๋‚ด์šฉ",
            "contract_b": "๊ณ„์•ฝ์„œ B์˜ ๋‚ด์šฉ",
            "significance": "high/medium/low"
        }}
    ],
    "summary": "์ „์ฒด ๋น„๊ต ์š”์•ฝ"
}}"""

    message = self.client.messages.create(
        model=self.model,
        max_tokens=4096,
        messages=[{"role": "user", "content": prompt}]
    )
    
    return self._parse_response(message.content[0].text)
๐Ÿ“Š 2. ๋ฆฌ์Šคํฌ ๋ถ„์„ ๊ธฐ๋Šฅ

๊ณ„์•ฝ์„œ์—์„œ ์ž ์žฌ์ ์ธ ๋ฆฌ์Šคํฌ๋ฅผ ์ž๋™์œผ๋กœ ์ฐพ์•„๋‚ด๋Š” ๊ธฐ๋Šฅ์ด์•ผ.
๋ถˆ๋ฆฌํ•œ ์กฐํ•ญ์ด๋‚˜ ๋ชจํ˜ธํ•œ ํ‘œํ˜„, ๋ฒ•์  ๋ฌธ์ œ ๊ฐ€๋Šฅ์„ฑ ๋“ฑ์„ ์ฒดํฌํ•ด์ค˜.

def analyze_risks(self, contract_text: str) -> Dict:
    """๊ณ„์•ฝ์„œ์˜ ์ž ์žฌ์  ๋ฆฌ์Šคํฌ ๋ถ„์„"""
    
    prompt = f"""๋‹ค์Œ ๊ณ„์•ฝ์„œ๋ฅผ ๋ฒ•๋ฅ  ์ „๋ฌธ๊ฐ€ ๊ด€์ ์—์„œ ๋ถ„์„ํ•˜์—ฌ ์ž ์žฌ์  ๋ฆฌ์Šคํฌ๋ฅผ ์ฐพ์•„์ฃผ์„ธ์š”.

๊ณ„์•ฝ์„œ ๋‚ด์šฉ:
{contract_text}

๋‹ค์Œ ๊ด€์ ์—์„œ ๋ฆฌ์Šคํฌ๋ฅผ ํ‰๊ฐ€ํ•ด์ฃผ์„ธ์š”:
1. ๋ถˆ๊ณต์ •ํ•œ ์กฐํ•ญ (์ผ๋ฐฉ์ ์œผ๋กœ ๋ถˆ๋ฆฌํ•œ ๋‚ด์šฉ)
2. ๋ชจํ˜ธํ•œ ํ‘œํ˜„ (ํ•ด์„์˜ ์—ฌ์ง€๊ฐ€ ์žˆ๋Š” ๋ถ€๋ถ„)
3. ๋ˆ„๋ฝ๋œ ์ค‘์š” ์กฐํ•ญ (์ผ๋ฐ˜์ ์œผ๋กœ ํฌํ•จ๋˜์–ด์•ผ ํ•˜๋Š”๋ฐ ์—†๋Š” ๊ฒƒ)
4. ๊ณผ๋„ํ•œ ์ฑ…์ž„ ๋ถ€๋‹ด
5. ๋ถˆ๋ช…ํ™•ํ•œ ํ•ด์ง€ ์กฐ๊ฑด
6. ๋ถ„์Ÿ ๋ฐœ์ƒ ๊ฐ€๋Šฅ์„ฑ

๊ฐ ๋ฆฌ์Šคํฌ์— ๋Œ€ํ•ด ์‹ฌ๊ฐ๋„(high/medium/low)์™€ ๊ฐœ์„  ์ œ์•ˆ์„ ํฌํ•จํ•ด์ฃผ์„ธ์š”.

JSON ํ˜•์‹:
{{
    "risks": [
        {{
            "category": "๋ฆฌ์Šคํฌ ์นดํ…Œ๊ณ ๋ฆฌ",
            "description": "๋ฆฌ์Šคํฌ ์„ค๋ช…",
            "severity": "high/medium/low",
            "location": "ํ•ด๋‹น ์กฐํ•ญ ์œ„์น˜",
            "recommendation": "๊ฐœ์„  ์ œ์•ˆ"
        }}
    ],
    "overall_risk_score": "1-10์ ",
    "summary": "์ „์ฒด ๋ฆฌ์Šคํฌ ํ‰๊ฐ€ ์š”์•ฝ"
}}"""

    message = self.client.messages.create(
        model=self.model,
        max_tokens=4096,
        temperature=0.3,  # ์•ฝ๊ฐ„์˜ ์ฐฝ์˜์„ฑ ํ—ˆ์šฉ
        messages=[{"role": "user", "content": prompt}]
    )
    
    return self._parse_response(message.content[0].text)
๐Ÿ“ 3. ๊ณ„์•ฝ์„œ ์š”์•ฝ ์ƒ์„ฑ

๊ธด ๊ณ„์•ฝ์„œ๋ฅผ ํ•œ ํŽ˜์ด์ง€๋กœ ์š”์•ฝํ•ด์ฃผ๋Š” ๊ธฐ๋Šฅ์ด์•ผ.
๋ฐ”์œ ์ž„์›๋“ค์ด๋‚˜ ๋น ๋ฅธ ๊ฒ€ํ† ๊ฐ€ ํ•„์š”ํ•  ๋•Œ ์ •๋ง ์œ ์šฉํ•ด.

def generate_summary(self, contract_text: str, summary_type: str = "executive") -> str:
    """
    ๊ณ„์•ฝ์„œ ์š”์•ฝ ์ƒ์„ฑ
    
    Args:
        contract_text: ๊ณ„์•ฝ์„œ ์ „๋ฌธ
        summary_type: "executive" (์ž„์›์šฉ), "technical" (์‹ค๋ฌด์ž์šฉ), "legal" (๋ฒ•๋ฌดํŒ€์šฉ)
    """
    
    summary_instructions = {
        "executive": "์ž„์›์ง„์ด ๋น ๋ฅด๊ฒŒ ์˜์‚ฌ๊ฒฐ์ •ํ•  ์ˆ˜ ์žˆ๋„๋ก ํ•ต์‹ฌ๋งŒ ๊ฐ„๋‹จ๋ช…๋ฃŒํ•˜๊ฒŒ",
        "technical": "์‹ค๋ฌด ๋‹ด๋‹น์ž๊ฐ€ ์—…๋ฌด ์ˆ˜ํ–‰์— ํ•„์š”ํ•œ ์„ธ๋ถ€์‚ฌํ•ญ ํฌํ•จ",
        "legal": "๋ฒ•๋ฌดํŒ€์ด ๊ฒ€ํ† ํ•  ๋ฒ•์  ์Ÿ์ ๊ณผ ๋ฆฌ์Šคํฌ ์ค‘์‹ฌ์œผ๋กœ"
    }
    
    instruction = summary_instructions.get(summary_type, summary_instructions["executive"])
    
    prompt = f"""๋‹ค์Œ ๊ณ„์•ฝ์„œ๋ฅผ {instruction} ์š”์•ฝํ•ด์ฃผ์„ธ์š”.

๊ณ„์•ฝ์„œ ๋‚ด์šฉ:
{contract_text}

์š”์•ฝ ํ˜•์‹:
1. ํ•œ ์ค„ ์š”์•ฝ (30์ž ์ด๋‚ด)
2. ํ•ต์‹ฌ ๋‚ด์šฉ (3-5๊ฐœ ๋ถˆ๋ฆฟ ํฌ์ธํŠธ)
3. ์ฃผ์š” ์ˆ˜์น˜ (๊ธˆ์•ก, ๊ธฐ๊ฐ„ ๋“ฑ)
4. ์ฃผ์˜์‚ฌํ•ญ (์žˆ๋‹ค๋ฉด)

๊ฐ„๊ฒฐํ•˜๊ณ  ๋ช…ํ™•ํ•˜๊ฒŒ ์ž‘์„ฑํ•ด์ฃผ์„ธ์š”."""

    message = self.client.messages.create(
        model=self.model,
        max_tokens=1024,
        messages=[{"role": "user", "content": prompt}]
    )
    
    return message.content[0].text
๐Ÿ’ผ ์‹ค๋ฌด ํ™œ์šฉ ํŒ 1. ํ…œํ”Œ๋ฆฟ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ๊ตฌ์ถ•:
์ž์ฃผ ์‚ฌ์šฉํ•˜๋Š” ๊ณ„์•ฝ์„œ ์œ ํ˜•๋ณ„๋กœ ์ถ”์ถœ ํ…œํ”Œ๋ฆฟ์„ ๋งŒ๋“ค์–ด๋‘๋ฉด ์ •ํ™•๋„๊ฐ€ ๋†’์•„์ ธ.
์˜ˆ: ๊ทผ๋กœ๊ณ„์•ฝ์„œ, ์ž„๋Œ€์ฐจ๊ณ„์•ฝ์„œ, ๊ณต๊ธ‰๊ณ„์•ฝ์„œ ๋“ฑ

2. ํžˆ์Šคํ† ๋ฆฌ ๊ด€๋ฆฌ:
๋ถ„์„ ๊ฒฐ๊ณผ๋ฅผ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์— ์ €์žฅํ•ด์„œ ๋‚˜์ค‘์— ๊ฒ€์ƒ‰ํ•˜๊ฑฐ๋‚˜ ํ†ต๊ณ„๋ฅผ ๋‚ผ ์ˆ˜ ์žˆ์–ด.
"์ง€๋‚œ 6๊ฐœ์›”๊ฐ„ ์šฐ๋ฆฌ ํšŒ์‚ฌ๊ฐ€ ์ฒด๊ฒฐํ•œ ๊ณ„์•ฝ์˜ ํ‰๊ท  ๊ธˆ์•ก์€?" ๊ฐ™์€ ์งˆ๋ฌธ์— ๋‹ตํ•  ์ˆ˜ ์žˆ์ง€.

3. ์•Œ๋ฆผ ์‹œ์Šคํ…œ:
๊ณ„์•ฝ ๋งŒ๋ฃŒ์ผ์ด ๋‹ค๊ฐ€์˜ค๊ฑฐ๋‚˜, ๊ฐฑ์‹  ์‹œ๊ธฐ๊ฐ€ ๋˜๋ฉด ์ž๋™์œผ๋กœ ์•Œ๋ฆผ์„ ๋ณด๋‚ด๋Š” ๊ธฐ๋Šฅ์„ ์ถ”๊ฐ€ํ•˜๋ฉด ์ข‹์•„.

4. ์Šน์ธ ์›Œํฌํ”Œ๋กœ์šฐ:
์ถ”์ถœ๋œ ์ •๋ณด๋ฅผ ๋‹ด๋‹น์ž๊ฐ€ ๊ฒ€ํ† ํ•˜๊ณ  ์Šน์ธํ•˜๋Š” ํ”„๋กœ์„ธ์Šค๋ฅผ ๋งŒ๋“ค๋ฉด ๋” ์•ˆ์ „ํ•ด.

๐Ÿ”’ ๋ณด์•ˆ ๋ฐ ๊ฐœ์ธ์ •๋ณด ๋ณดํ˜ธ

๊ณ„์•ฝ์„œ๋Š” ๋ฏผ๊ฐํ•œ ์ •๋ณด๊ฐ€ ๋งŽ์ด ํฌํ•จ๋œ ๋ฌธ์„œ์•ผ. ๋ณด์•ˆ์— ๊ฐ๋ณ„ํžˆ ์‹ ๊ฒฝ ์จ์•ผ ํ•ด! ๐Ÿ›ก๏ธ

๐Ÿšจ ํ•„์ˆ˜ ๋ณด์•ˆ ์กฐ์น˜ 1. ๋ฐ์ดํ„ฐ ์•”ํ˜ธํ™”
โ€ข ์ „์†ก ์ค‘: HTTPS/TLS ์‚ฌ์šฉ (Let's Encrypt๋กœ ๋ฌด๋ฃŒ SSL ์ธ์ฆ์„œ ๋ฐœ๊ธ‰)
โ€ข ์ €์žฅ ์‹œ: ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์•”ํ˜ธํ™”, ํŒŒ์ผ ์‹œ์Šคํ…œ ์•”ํ˜ธํ™”
โ€ข API ํ‚ค: ํ™˜๊ฒฝ๋ณ€์ˆ˜๋‚˜ ๋น„๋ฐ€ ๊ด€๋ฆฌ ์‹œ์Šคํ…œ(AWS Secrets Manager, HashiCorp Vault) ์‚ฌ์šฉ

2. ์ ‘๊ทผ ์ œ์–ด
โ€ข ์‚ฌ์šฉ์ž ์ธ์ฆ: JWT ํ† ํฐ ๊ธฐ๋ฐ˜ ์ธ์ฆ ๊ตฌํ˜„
โ€ข ๊ถŒํ•œ ๊ด€๋ฆฌ: RBAC(Role-Based Access Control) ์ ์šฉ
โ€ข IP ํ™”์ดํŠธ๋ฆฌ์ŠคํŠธ: ํŠน์ • IP์—์„œ๋งŒ ์ ‘๊ทผ ํ—ˆ์šฉ

3. ๋ฐ์ดํ„ฐ ๋ณด์กด ์ •์ฑ…
โ€ข ์—…๋กœ๋“œ๋œ ํŒŒ์ผ์€ ๋ถ„์„ ํ›„ ์ฆ‰์‹œ ์‚ญ์ œํ•˜๊ฑฐ๋‚˜ ์•”ํ˜ธํ™” ์ €์žฅ
โ€ข ๋กœ๊ทธ๋Š” ๊ฐœ์ธ์ •๋ณด๋ฅผ ์ œ์™ธํ•˜๊ณ  ๊ธฐ๋ก
โ€ข ์ •๊ธฐ์ ์ธ ๋ฐ์ดํ„ฐ ์‚ญ์ œ ์Šค์ผ€์ค„ ์šด์˜

4. Claude API ๋ณด์•ˆ
โ€ข API ํ‚ค ๋…ธ์ถœ ๋ฐฉ์ง€ (์ ˆ๋Œ€ ์ฝ”๋“œ์— ํ•˜๋“œ์ฝ”๋”ฉ ๊ธˆ์ง€!)
โ€ข Rate limiting ์„ค์ •์œผ๋กœ ๊ณผ๋„ํ•œ ์š”์ฒญ ๋ฐฉ์ง€
โ€ข ์—๋Ÿฌ ๋ฉ”์‹œ์ง€์— ๋ฏผ๊ฐ ์ •๋ณด ํฌํ•จ ๊ธˆ์ง€
๐Ÿ” ๋ณด์•ˆ ๊ฐ•ํ™” ์ฝ”๋“œ ์˜ˆ์‹œ

# ํŒŒ์ผ ์—…๋กœ๋“œ ๋ณด์•ˆ ๊ฒ€์ฆ
import hashlib
import magic  # python-magic ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ

def validate_file_security(file_path: str) -> bool:
    """ํŒŒ์ผ ๋ณด์•ˆ ๊ฒ€์ฆ"""
    
    # 1. ์‹ค์ œ ํŒŒ์ผ ํƒ€์ž… ํ™•์ธ (ํ™•์žฅ์ž ์†์ด๊ธฐ ๋ฐฉ์ง€)
    mime = magic.Magic(mime=True)
    file_type = mime.from_file(file_path)
    
    allowed_types = [
        'application/pdf',
        'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
        'image/png',
        'image/jpeg'
    ]
    
    if file_type not in allowed_types:
        logger.warning(f"ํ—ˆ์šฉ๋˜์ง€ ์•Š์€ ํŒŒ์ผ ํƒ€์ž…: {file_type}")
        return False
    
    # 2. ํŒŒ์ผ ํฌ๊ธฐ ๊ฒ€์ฆ
    file_size = os.path.getsize(file_path)
    if file_size > 10 * 1024 * 1024:  # 10MB
        logger.warning(f"ํŒŒ์ผ ํฌ๊ธฐ ์ดˆ๊ณผ: {file_size}")
        return False
    
    # 3. ์•…์„ฑ ์ฝ”๋“œ ์Šค์บ” (ClamAV ๋“ฑ ์‚ฌ์šฉ)
    # scan_result = scan_with_clamav(file_path)
    # if not scan_result.is_clean:
    #     return False
    
    return True

# JWT ์ธ์ฆ ๋ฏธ๋“ค์›จ์–ด
from fastapi import Depends, HTTPException, status
from fastapi.security import HTTPBearer, HTTPAuthorizationCredentials
import jwt

security = HTTPBearer()

def verify_token(credentials: HTTPAuthorizationCredentials = Depends(security)):
    """JWT ํ† ํฐ ๊ฒ€์ฆ"""
    try:
        token = credentials.credentials
        payload = jwt.decode(token, SECRET_KEY, algorithms=["HS256"])
        return payload
    except jwt.ExpiredSignatureError:
        raise HTTPException(
            status_code=status.HTTP_401_UNAUTHORIZED,
            detail="ํ† ํฐ์ด ๋งŒ๋ฃŒ๋˜์—ˆ์Šต๋‹ˆ๋‹ค"
        )
    except jwt.InvalidTokenError:
        raise HTTPException(
            status_code=status.HTTP_401_UNAUTHORIZED,
            detail="์œ ํšจํ•˜์ง€ ์•Š์€ ํ† ํฐ์ž…๋‹ˆ๋‹ค"
        )

# ๋ณดํ˜ธ๋œ ์—”๋“œํฌ์ธํŠธ
@app.post("/api/analyze")
async def analyze_contract(
    file: UploadFile = File(...),
    user: dict = Depends(verify_token)  # ์ธ์ฆ ํ•„์š”
):
    # ์‚ฌ์šฉ์ž ๊ถŒํ•œ ํ™•์ธ
    if "contract:analyze" not in user.get("permissions", []):
        raise HTTPException(
            status_code=status.HTTP_403_FORBIDDEN,
            detail="๊ถŒํ•œ์ด ์—†์Šต๋‹ˆ๋‹ค"
        )
    
    # ... ๋ถ„์„ ๋กœ์ง

๐Ÿ“ˆ ์„ฑ๋Šฅ ์ตœ์ ํ™” ์ „๋žต

์‹œ์Šคํ…œ์ด ๋งŽ์€ ์‚ฌ์šฉ์ž๋ฅผ ์ฒ˜๋ฆฌํ•˜๋ ค๋ฉด ์„ฑ๋Šฅ ์ตœ์ ํ™”๊ฐ€ ํ•„์ˆ˜์•ผ! โšก
ํŠนํžˆ Claude API ํ˜ธ์ถœ์€ ๋น„์šฉ์ด ๋ฐœ์ƒํ•˜๋‹ˆ๊นŒ ํšจ์œจ์ ์œผ๋กœ ์‚ฌ์šฉํ•ด์•ผ ํ•ด.

๐Ÿš€ ์ตœ์ ํ™” ๊ธฐ๋ฒ•

1. ์บ์‹ฑ ์ „๋žต ๐Ÿ’พ
๊ฐ™์€ ๊ณ„์•ฝ์„œ๋ฅผ ์—ฌ๋Ÿฌ ๋ฒˆ ๋ถ„์„ํ•˜๋Š” ๊ฑด ๋‚ญ๋น„์•ผ. ๊ฒฐ๊ณผ๋ฅผ ์บ์‹ฑํ•ด๋‘์ž!

import hashlib
import redis
import json

# Redis ํด๋ผ์ด์–ธํŠธ ์„ค์ •
redis_client = redis.Redis(host='localhost', port=6379, db=0)

def get_file_hash(file_content: bytes) -> str:
    """ํŒŒ์ผ ๋‚ด์šฉ์˜ ํ•ด์‹œ๊ฐ’ ์ƒ์„ฑ"""
    return hashlib.sha256(file_content).hexdigest()

def analyze_with_cache(file_content: bytes, file_name: str) -> Dict:
    """์บ์‹œ๋ฅผ ํ™œ์šฉํ•œ ๋ถ„์„"""
    
    # ํŒŒ์ผ ํ•ด์‹œ ์ƒ์„ฑ
    file_hash = get_file_hash(file_content)
    cache_key = f"contract_analysis:{file_hash}"
    
    # ์บ์‹œ ํ™•์ธ
    cached_result = redis_client.get(cache_key)
    if cached_result:
        logger.info(f"์บ์‹œ์—์„œ ๊ฒฐ๊ณผ ๋ฐ˜ํ™˜: {file_name}")
        return json.loads(cached_result)
    
    # ์บ์‹œ ๋ฏธ์Šค - ์‹ค์ œ ๋ถ„์„ ์ˆ˜ํ–‰
    logger.info(f"์ƒˆ๋กœ์šด ๋ถ„์„ ์ˆ˜ํ–‰: {file_name}")
    result = analyzer.extract_contract_clauses(file_content.decode())
    
    # ๊ฒฐ๊ณผ ์บ์‹ฑ (24์‹œ๊ฐ„ ์œ ์ง€)
    redis_client.setex(
        cache_key,
        86400,  # 24์‹œ๊ฐ„
        json.dumps(result)
    )
    
    return result
2. ๋ฐฐ์น˜ ์ฒ˜๋ฆฌ ๐Ÿ“ฆ
์—ฌ๋Ÿฌ ๊ณ„์•ฝ์„œ๋ฅผ ํ•œ ๋ฒˆ์— ์ฒ˜๋ฆฌํ•  ๋•Œ๋Š” ๋ณ‘๋ ฌ ์ฒ˜๋ฆฌ๋ฅผ ํ™œ์šฉํ•ด!

from concurrent.futures import ThreadPoolExecutor, as_completed
import asyncio

async def batch_analyze_async(files: List[UploadFile]) -> List[Dict]:
    """๋น„๋™๊ธฐ ๋ฐฐ์น˜ ๋ถ„์„"""
    
    async def analyze_single(file: UploadFile) -> Dict:
        try:
            content = await file.read()
            text = parser.extract_text_from_bytes(content)
            result = analyzer.extract_contract_clauses(text)
            return {
                "filename": file.filename,
                "status": "success",
                "data": result
            }
        except Exception as e:
            return {
                "filename": file.filename,
                "status": "error",
                "error": str(e)
            }
    
    # ๋™์‹œ์— ์ตœ๋Œ€ 5๊ฐœ๊นŒ์ง€ ์ฒ˜๋ฆฌ
    semaphore = asyncio.Semaphore(5)
    
    async def analyze_with_limit(file):
        async with semaphore:
            return await analyze_single(file)
    
    tasks = [analyze_with_limit(file) for file in files]
    results = await asyncio.gather(*tasks)
    
    return results
3. ํ…์ŠคํŠธ ์ฒญํ‚น ์ „๋žต โœ‚๏ธ
๊ณ„์•ฝ์„œ๊ฐ€ ๋„ˆ๋ฌด ๊ธธ๋ฉด ํ† ํฐ ์ œํ•œ์— ๊ฑธ๋ฆด ์ˆ˜ ์žˆ์–ด. ๋˜‘๋˜‘ํ•˜๊ฒŒ ๋‚˜๋ˆ„์ž!

def smart_chunk_text(text: str, max_tokens: int = 8000) -> List[str]:
    """์˜๋ฏธ ๋‹จ์œ„๋กœ ํ…์ŠคํŠธ ๋ถ„ํ• """
    
    # ์„น์…˜ ๊ตฌ๋ถ„์ž๋กœ ๋จผ์ € ๋ถ„ํ•  ์‹œ๋„
    section_markers = [
        "์ œ 1 ์กฐ", "์ œ 2 ์กฐ", "์ œ1์กฐ", "์ œ2์กฐ",
        "Article 1", "Article 2",
        "1.", "2.", "3."
    ]
    
    chunks = []
    current_chunk = ""
    
    paragraphs = text.split('\n\n')
    
    for para in paragraphs:
        # ํ˜„์žฌ ์ฒญํฌ์— ์ถ”๊ฐ€ํ–ˆ์„ ๋•Œ ํ† ํฐ ์ˆ˜ ์˜ˆ์ธก
        estimated_tokens = len(current_chunk + para) // 4  # ๋Œ€๋žต์ ์ธ ์ถ”์ •
        
        if estimated_tokens > max_tokens:
            if current_chunk:
                chunks.append(current_chunk.strip())
            current_chunk = para
        else:
            current_chunk += "\n\n" + para
    
    if current_chunk:
        chunks.append(current_chunk.strip())
    
    return chunks

def analyze_long_contract(text: str) -> Dict:
    """๊ธด ๊ณ„์•ฝ์„œ ๋ถ„์„ (์ฒญํ‚น ํ™œ์šฉ)"""
    
    chunks = smart_chunk_text(text)
    
    if len(chunks) == 1:
        # ํ•œ ๋ฒˆ์— ์ฒ˜๋ฆฌ ๊ฐ€๋Šฅ
        return analyzer.extract_contract_clauses(text)
    
    # ์—ฌ๋Ÿฌ ์ฒญํฌ๋กœ ๋‚˜๋ˆ ์„œ ์ฒ˜๋ฆฌ ํ›„ ๋ณ‘ํ•ฉ
    results = []
    for i, chunk in enumerate(chunks):
        logger.info(f"์ฒญํฌ {i+1}/{len(chunks)} ๋ถ„์„ ์ค‘...")
        result = analyzer.extract_contract_clauses(chunk)
        results.append(result)
    
    # ๊ฒฐ๊ณผ ๋ณ‘ํ•ฉ ๋กœ์ง
    merged_result = merge_analysis_results(results)
    return merged_result
4. ๋ชจ๋ธ ์„ ํƒ ์ „๋žต ๐ŸŽฏ
๋ชจ๋“  ์ž‘์—…์— Opus๋ฅผ ์“ธ ํ•„์š”๋Š” ์—†์–ด. ์ž‘์—…์— ๋งž๋Š” ๋ชจ๋ธ์„ ์„ ํƒํ•˜์ž!

class AdaptiveAnalyzer:
    """์ž‘์—… ๋ณต์žก๋„์— ๋”ฐ๋ผ ๋ชจ๋ธ์„ ์„ ํƒํ•˜๋Š” ๋ถ„์„๊ธฐ"""
    
    def __init__(self):
        self.models = {
            "simple": "claude-3-haiku-20240307",    # ๋น ๋ฅด๊ณ  ์ €๋ ด
            "standard": "claude-3-sonnet-20240229",  # ๊ท ํ˜•์žกํžŒ ์„ฑ๋Šฅ
            "complex": "claude-3-opus-20240229"      # ์ตœ๊ณ  ์„ฑ๋Šฅ
        }
    
    def estimate_complexity(self, text: str) -> str:
        """๊ณ„์•ฝ์„œ ๋ณต์žก๋„ ์ถ”์ •"""
        
        # ๊ฐ„๋‹จํ•œ ํœด๋ฆฌ์Šคํ‹ฑ
        word_count = len(text.split())
        
        # ๋ฒ•๋ฅ  ์šฉ์–ด ๋นˆ๋„ ์ฒดํฌ
        legal_terms = ["์†ํ•ด๋ฐฐ์ƒ", "์œ„์•ฝ๊ธˆ", "๋ถˆ๊ฐ€ํ•ญ๋ ฅ", "์ค‘์žฌ", "๊ด€ํ• "]
        legal_term_count = sum(text.count(term) for term in legal_terms)
        
        # ํ‘œ๋‚˜ ๋ณต์žกํ•œ ๊ตฌ์กฐ ์ฒดํฌ
        has_tables = "โ”Œ" in text or "โ”‚" in text or "\t" in text
        
        if word_count < 1000 and legal_term_count < 5:
            return "simple"
        elif word_count > 5000 or legal_term_count > 20 or has_tables:
            return "complex"
        else:
            return "standard"
    
    def analyze(self, text: str) -> Dict:
        """๋ณต์žก๋„์— ๋งž๋Š” ๋ชจ๋ธ๋กœ ๋ถ„์„"""
        
        complexity = self.estimate_complexity(text)
        model = self.models[complexity]
        
        logger.info(f"๋ณต์žก๋„: {complexity}, ์‚ฌ์šฉ ๋ชจ๋ธ: {model}")
        
        # ํ•ด๋‹น ๋ชจ๋ธ๋กœ ๋ถ„์„ ์ˆ˜ํ–‰
        analyzer = ClaudeContractAnalyzer()
        analyzer.model = model
        
        return analyzer.extract_contract_clauses(text)
๐Ÿ’ฐ ๋น„์šฉ ์ตœ์ ํ™” ํŒ Claude API๋Š” ํ† ํฐ ๊ธฐ๋ฐ˜ ๊ณผ๊ธˆ์ด์•ผ. ๋น„์šฉ์„ ์ค„์ด๋ ค๋ฉด:

โ€ข Haiku ์šฐ์„  ์‚ฌ์šฉ: ๊ฐ„๋‹จํ•œ ์ž‘์—…์€ Haiku๋กœ ์ถฉ๋ถ„ํ•ด (Opus ๋Œ€๋น„ 1/60 ๊ฐ€๊ฒฉ!)
โ€ข ํ”„๋กฌํ”„ํŠธ ์ตœ์ ํ™”: ๋ถˆํ•„์š”ํ•œ ์„ค๋ช… ์ œ๊ฑฐ, ๊ฐ„๊ฒฐํ•˜๊ฒŒ ์ž‘์„ฑ
โ€ข ์บ์‹ฑ ์ ๊ทน ํ™œ์šฉ: ๊ฐ™์€ ๋ฌธ์„œ ์žฌ๋ถ„์„ ๋ฐฉ์ง€
โ€ข ๋ฐฐ์น˜ ์ฒ˜๋ฆฌ: ์—ฌ๋Ÿฌ ๋ฌธ์„œ๋ฅผ ํ•œ ๋ฒˆ์— ์ฒ˜๋ฆฌํ•  ๋•Œ ํšจ์œจ์ 
โ€ข ๊ฒฐ๊ณผ ์žฌ์‚ฌ์šฉ: ํ•œ ๋ฒˆ ์ถ”์ถœํ•œ ์ •๋ณด๋Š” DB์— ์ €์žฅํ•ด์„œ ์žฌํ™œ์šฉ

๐Ÿงช ํ…Œ์ŠคํŠธ ๋ฐ ํ’ˆ์งˆ ๊ด€๋ฆฌ

AI ์‹œ์Šคํ…œ์€ ์˜ˆ์ธก ๋ถˆ๊ฐ€๋Šฅํ•œ ๋ถ€๋ถ„์ด ์žˆ์–ด์„œ ์ฒ ์ €ํ•œ ํ…Œ์ŠคํŠธ๊ฐ€ ์ค‘์š”ํ•ด! ๐Ÿ”ฌ
ํŠนํžˆ ๋ฒ•๋ฅ  ๋ฌธ์„œ ๊ฐ™์€ ์ค‘์š”ํ•œ ๋ฐ์ดํ„ฐ๋ฅผ ๋‹ค๋ฃฐ ๋•Œ๋Š” ๋”์šฑ ๊ทธ๋ž˜.

โœ… ํ…Œ์ŠคํŠธ ์ „๋žต

1. ๋‹จ์œ„ ํ…Œ์ŠคํŠธ (Unit Tests)
๊ฐ ํ•จ์ˆ˜๊ฐ€ ์ œ๋Œ€๋กœ ๋™์ž‘ํ•˜๋Š”์ง€ ํ™•์ธํ•ด.

import pytest
from document_parser import DocumentParser

def test_pdf_extraction():
    """PDF ํ…์ŠคํŠธ ์ถ”์ถœ ํ…Œ์ŠคํŠธ"""
    parser = DocumentParser()
    
    # ํ…Œ์ŠคํŠธ์šฉ PDF ํŒŒ์ผ
    test_file = "tests/samples/test_contract.pdf"
    text = parser.extract_text(test_file)
    
    assert text is not None
    assert len(text) > 100
    assert "๊ณ„์•ฝ" in text or "contract" in text.lower()

def test_text_preprocessing():
    """ํ…์ŠคํŠธ ์ „์ฒ˜๋ฆฌ ํ…Œ์ŠคํŠธ"""
    parser = DocumentParser()
    
    raw_text = "  ์ด๊ฒƒ์€    ํ…Œ์ŠคํŠธ   ์ž…๋‹ˆ๋‹ค.  \n\n  - 1 -  \n\n  Page 1  "
    processed = parser.preprocess_text(raw_text)
    
    assert "  " not in processed  # ์—ฐ์† ๊ณต๋ฐฑ ์ œ๊ฑฐ
    assert "- 1 -" not in processed  # ํŽ˜์ด์ง€ ๋ฒˆํ˜ธ ์ œ๊ฑฐ
    assert "Page 1" not in processed

def test_claude_api_connection():
    """Claude API ์—ฐ๊ฒฐ ํ…Œ์ŠคํŠธ"""
    analyzer = ClaudeContractAnalyzer()
    
    # ๊ฐ„๋‹จํ•œ ํ…Œ์ŠคํŠธ ํ…์ŠคํŠธ
    test_text = "๊ฐ‘๊ณผ ์„์€ 2024๋…„ 1์›” 1์ผ๋ถ€ํ„ฐ 1๋…„๊ฐ„ ๊ณ„์•ฝํ•œ๋‹ค."
    result = analyzer.extract_contract_clauses(test_text)
    
    assert result is not None
    assert "duration" in result
2. ํ†ตํ•ฉ ํ…Œ์ŠคํŠธ (Integration Tests)
์ „์ฒด ์‹œ์Šคํ…œ์ด ํ•จ๊ป˜ ์ž˜ ๋™์ž‘ํ•˜๋Š”์ง€ ํ™•์ธํ•ด.

from fastapi.testclient import TestClient
from main import app

client = TestClient(app)

def test_full_analysis_workflow():
    """์ „์ฒด ๋ถ„์„ ์›Œํฌํ”Œ๋กœ์šฐ ํ…Œ์ŠคํŠธ"""
    
    # ํ…Œ์ŠคํŠธ ํŒŒ์ผ ์—…๋กœ๋“œ
    with open("tests/samples/test_contract.pdf", "rb") as f:
        response = client.post(
            "/api/analyze",
            files={"file": ("test.pdf", f, "application/pdf")}
        )
    
    assert response.status_code == 200
    data = response.json()
    
    assert data["success"] is True
    assert "extracted_data" in data
    assert "parties" in data["extracted_data"]

def test_batch_processing():
    """๋ฐฐ์น˜ ์ฒ˜๋ฆฌ ํ…Œ์ŠคํŠธ"""
    
    files = [
        ("file", ("test1.pdf", open("tests/samples/test1.pdf", "rb"), "application/pdf")),
        ("file", ("test2.pdf", open("tests/samples/test2.pdf", "rb"), "application/pdf"))
    ]
    
    response = client.post("/api/batch-analyze", files=files)
    
    assert response.status_code == 200
    data = response.json()
    assert data["total_files"] == 2
3. ์ •ํ™•๋„ ํ…Œ์ŠคํŠธ (Accuracy Tests)
AI๊ฐ€ ์–ผ๋งˆ๋‚˜ ์ •ํ™•ํ•˜๊ฒŒ ์ถ”์ถœํ•˜๋Š”์ง€ ์ธก์ •ํ•ด.

def test_extraction_accuracy():
    """์ถ”์ถœ ์ •ํ™•๋„ ํ…Œ์ŠคํŠธ"""
    
    # ์ •๋‹ต์ด ์žˆ๋Š” ํ…Œ์ŠคํŠธ ๋ฐ์ดํ„ฐ์…‹
    test_cases = [
        {
            "file": "tests/samples/contract1.pdf",
            "expected": {
                "parties": {"party_a": "์ฃผ์‹ํšŒ์‚ฌ ABC", "party_b": "์ฃผ์‹ํšŒ์‚ฌ XYZ"},
                "amount": {"total": "1์–ต์›"},
                "duration": {"start_date": "2024-01-01", "end_date": "2024-12-31"}
            }
        },
        # ... ๋” ๋งŽ์€ ํ…Œ์ŠคํŠธ ์ผ€์ด์Šค
    ]
    
    correct_count = 0
    total_fields = 0
    
    for case in test_cases:
        text = parser.extract_text(case["file"])
        result = analyzer.extract_contract_clauses(text)
        
        # ๊ฐ ํ•„๋“œ ๋น„๊ต
        for field, expected_value in case["expected"].items():
            total_fields += 1
            if result.get(field) == expected_value:
                correct_count += 1
    
    accuracy = correct_count / total_fields
    print(f"์ •ํ™•๋„: {accuracy * 100:.2f}%")
    
    assert accuracy > 0.85  # 85% ์ด์ƒ ์ •ํ™•๋„ ์š”๊ตฌ
4. ์„ฑ๋Šฅ ํ…Œ์ŠคํŠธ (Performance Tests)
์‹œ์Šคํ…œ์ด ๋ถ€ํ•˜๋ฅผ ๊ฒฌ๋”œ ์ˆ˜ ์žˆ๋Š”์ง€ ํ™•์ธํ•ด.

import time
from locust import HttpUser, task, between

class ContractAnalysisUser(HttpUser):
    """๋ถ€ํ•˜ ํ…Œ์ŠคํŠธ์šฉ ์‚ฌ์šฉ์ž ์‹œ๋ฎฌ๋ ˆ์ด์…˜"""
    
    wait_time = between(1, 3)  # ์š”์ฒญ ๊ฐ„ 1-3์ดˆ ๋Œ€๊ธฐ
    
    @task
    def analyze_contract(self):
        """๊ณ„์•ฝ์„œ ๋ถ„์„ ์š”์ฒญ"""
        
        with open("tests/samples/test_contract.pdf", "rb") as f:
            files = {"file": ("test.pdf", f, "application/pdf")}
            
            start_time = time.time()
            response = self.client.post("/api/analyze", files=files)
            end_time = time.time()
            
            # ์‘๋‹ต ์‹œ๊ฐ„ ์ฒดํฌ
            response_time = end_time - start_time
            if response_time > 30:  # 30์ดˆ ์ด์ƒ ๊ฑธ๋ฆฌ๋ฉด ๊ฒฝ๊ณ 
                print(f"โš ๏ธ ๋А๋ฆฐ ์‘๋‹ต: {response_time:.2f}์ดˆ")

# ์‹คํ–‰: locust -f tests/load_test.py --host=http://localhost:8000
โš ๏ธ ํ…Œ์ŠคํŠธ ์‹œ ์ฃผ์˜์‚ฌํ•ญ โ€ข ์‹ค์ œ API ํ‚ค ์‚ฌ์šฉ ์ฃผ์˜: ํ…Œ์ŠคํŠธ ์ค‘ ๋งŽ์€ API ํ˜ธ์ถœ์ด ๋ฐœ์ƒํ•˜๋ฉด ๋น„์šฉ์ด ๋งŽ์ด ๋‚˜์˜ฌ ์ˆ˜ ์žˆ์–ด. ํ…Œ์ŠคํŠธ์šฉ API ํ‚ค๋ฅผ ๋ณ„๋„๋กœ ์‚ฌ์šฉํ•˜๊ฑฐ๋‚˜, ๋ชจํ‚น(mocking)์„ ํ™œ์šฉํ•ด.
โ€ข ํ…Œ์ŠคํŠธ ๋ฐ์ดํ„ฐ ๊ด€๋ฆฌ: ์‹ค์ œ ๊ณ„์•ฝ์„œ๋ฅผ ํ…Œ์ŠคํŠธ์— ์‚ฌ์šฉํ•˜๋ฉด ๊ฐœ์ธ์ •๋ณด ์œ ์ถœ ์œ„ํ—˜์ด ์žˆ์–ด. ์ต๋ช…ํ™”๋œ ์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ๋ฅผ ๋งŒ๋“ค์–ด์„œ ์‚ฌ์šฉํ•ด.
โ€ข CI/CD ํ†ตํ•ฉ: GitHub Actions๋‚˜ GitLab CI์— ํ…Œ์ŠคํŠธ๋ฅผ ํ†ตํ•ฉํ•ด์„œ ์ž๋™์œผ๋กœ ์‹คํ–‰๋˜๊ฒŒ ํ•ด.
โ€ข ์ •๊ธฐ์ ์ธ ์žฌํ…Œ์ŠคํŠธ: Claude ๋ชจ๋ธ์ด ์—…๋ฐ์ดํŠธ๋˜๋ฉด ๊ฒฐ๊ณผ๊ฐ€ ๋‹ฌ๋ผ์งˆ ์ˆ˜ ์žˆ์œผ๋‹ˆ ์ •๊ธฐ์ ์œผ๋กœ ์žฌํ…Œ์ŠคํŠธํ•ด.

๐Ÿš€ ๋ฐฐํฌ ๋ฐ ์šด์˜

๊ฐœ๋ฐœ์ด ๋๋‚ฌ์œผ๋ฉด ์ด์ œ ์‹ค์ œ ์„œ๋น„์Šค๋กœ ๋ฐฐํฌํ•ด์•ผ์ง€! โ˜๏ธ
ํด๋ผ์šฐ๋“œ ํ”Œ๋žซํผ์„ ํ™œ์šฉํ•˜๋ฉด ์‰ฝ๊ฒŒ ๋ฐฐํฌํ•˜๊ณ  ๊ด€๋ฆฌํ•  ์ˆ˜ ์žˆ์–ด.

โ˜๏ธ ๋ฐฐํฌ ์˜ต์…˜

1. Docker ์ปจํ…Œ์ด๋„ˆํ™” ๐Ÿณ
์–ด๋””์„œ๋“  ๋™์ผํ•˜๊ฒŒ ์‹คํ–‰๋˜๋„๋ก Docker๋กœ ํŒจํ‚ค์ง•ํ•˜์ž!

# Dockerfile
FROM python:3.11-slim

WORKDIR /app

# ์‹œ์Šคํ…œ ํŒจํ‚ค์ง€ ์„ค์น˜
RUN apt-get update && apt-get install -y \
    tesseract-ocr \
    tesseract-ocr-kor \
    && rm -rf /var/lib/apt/lists/*

# Python ํŒจํ‚ค์ง€ ์„ค์น˜
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ์ฝ”๋“œ ๋ณต์‚ฌ
COPY . .

# ํฌํŠธ ๋…ธ์ถœ
EXPOSE 8000

# ์‹คํ–‰ ๋ช…๋ น
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]
# docker-compose.yml
version: '3.8'

services:
  api:
    build: .
    ports:
      - "8000:8000"
    environment:
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
      - DATABASE_URL=postgresql://user:pass@db:5432/contracts
    depends_on:
      - db
      - redis
    volumes:
      - ./uploads:/app/uploads

  db:
    image: postgres:15
    environment:
      - POSTGRES_DB=contracts
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=pass
    volumes:
      - postgres_data:/var/lib/postgresql/data

  redis:
    image: redis:7-alpine
    ports:
      - "6379:6379"

volumes:
  postgres_data:
2. AWS ๋ฐฐํฌ (ECS/Fargate) โ˜๏ธ
์„œ๋ฒ„๋ฆฌ์Šค๋กœ ์‰ฝ๊ฒŒ ์Šค์ผ€์ผ๋งํ•  ์ˆ˜ ์žˆ์–ด!

# AWS ECS Task Definition (JSON)
{
  "family": "contract-analyzer",
  "networkMode": "awsvpc",
  "requiresCompatibilities": ["FARGATE"],
  "cpu": "1024",
  "memory": "2048",
  "containerDefinitions": [
    {
      "name": "api",
      "image": "your-ecr-repo/contract-analyzer:latest",
      "portMappings": [
        {
          "containerPort": 8000,
          "protocol": "tcp"
        }
      ],
      "environment": [
        {
          "name": "ANTHROPIC_API_KEY",
          "value": "your-api-key"
        }
      ],
      "logConfiguration": {
        "logDriver": "awslogs",
        "options": {
          "awslogs-group": "/ecs/contract-analyzer",
          "awslogs-region": "ap-northeast-2",
          "awslogs-stream-prefix": "ecs"
        }
      }
    }
  ]
}
3. Kubernetes ๋ฐฐํฌ โš“
๋Œ€๊ทœ๋ชจ ์šด์˜์ด ํ•„์š”ํ•˜๋ฉด K8s๋ฅผ ์‚ฌ์šฉํ•ด!

# kubernetes/deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: contract-analyzer
spec:
  replicas: 3
  selector:
    matchLabels:
      app: contract-analyzer
  template:
    metadata:
      labels:
        app: contract-analyzer
    spec:
      containers:
      - name: api
        image: your-registry/contract-analyzer:latest
        ports:
        - containerPort: 8000
        env:
        - name: ANTHROPIC_API_KEY
          valueFrom:
            secretKeyRef:
              name: api-secrets
              key: anthropic-key
        resources:
          requests:
            memory: "1Gi"
            cpu: "500m"
          limits:
            memory: "2Gi"
            cpu: "1000m"
---
apiVersion: v1
kind: Service
metadata:
  name: contract-analyzer-service
spec:
  type: LoadBalancer
  ports:
  - port: 80
    targetPort: 8000
  selector:
    app: contract-analyzer
๐Ÿ“Š ๋ชจ๋‹ˆํ„ฐ๋ง ๋ฐ ๋กœ๊น…

์šด์˜ ์ค‘์—๋Š” ์‹œ์Šคํ…œ ์ƒํƒœ๋ฅผ ๊ณ„์† ๋ชจ๋‹ˆํ„ฐ๋งํ•ด์•ผ ํ•ด!

# ๋กœ๊น… ์„ค์ • (logging_config.py)
import logging
from logging.handlers import RotatingFileHandler
import json

def setup_logging():
    """๊ตฌ์กฐํ™”๋œ ๋กœ๊น… ์„ค์ •"""
    
    # JSON ํฌ๋งทํ„ฐ
    class JsonFormatter(logging.Formatter):
        def format(self, record):
            log_data = {
                "timestamp": self.formatTime(record),
                "level": record.levelname,
                "message": record.getMessage(),
                "module": record.module,
                "function": record.funcName
            }
            
            if hasattr(record, 'user_id'):
                log_data['user_id'] = record.user_id
            
            if record.exc_info:
                log_data['exception'] = self.formatException(record.exc_info)
            
            return json.dumps(log_data, ensure_ascii=False)
    
    # ํŒŒ์ผ ํ•ธ๋“ค๋Ÿฌ (10MB๋งˆ๋‹ค ๋กœํ…Œ์ด์…˜)
    file_handler = RotatingFileHandler(
        'logs/app.log',
        maxBytes=10*1024*1024,
        backupCount=10
    )
    file_handler.setFormatter(JsonFormatter())
    
    # ์ฝ˜์†” ํ•ธ๋“ค๋Ÿฌ
    console_handler = logging.StreamHandler()
    console_handler.setFormatter(logging.Formatter(
        '%(asctime)s - %(name)s - %(levelname)s - %(message)s'
    ))
    
    # ๋ฃจํŠธ ๋กœ๊ฑฐ ์„ค์ •
    root_logger = logging.getLogger()
    root_logger.setLevel(logging.INFO)
    root_logger.addHandler(file_handler)
    root_logger.addHandler(console_handler)

# ๋ฉ”ํŠธ๋ฆญ ์ˆ˜์ง‘ (Prometheus)
from prometheus_client import Counter, Histogram, Gauge
import time

# ๋ฉ”ํŠธ๋ฆญ ์ •์˜
request_count = Counter('contract_analysis_requests_total', 'Total analysis requests')
request_duration = Histogram('contract_analysis_duration_seconds', 'Analysis duration')
active_analyses = Gauge('contract_analysis_active', 'Currently active analyses')
error_count = Counter('contract_analysis_errors_total', 'Total errors', ['error_type'])

@app.middleware("http")
async def metrics_middleware(request, call_next):
    """๋ฉ”ํŠธ๋ฆญ ์ˆ˜์ง‘ ๋ฏธ๋“ค์›จ์–ด"""
    
    if request.url.path == "/api/analyze":
        request_count.inc()
        active_analyses.inc()
        
        start_time = time.time()
        try:
            response = await call_next(request)
            return response
        except Exception as e:
            error_count.labels(error_type=type(e).__name__).inc()
            raise
        finally:
            duration = time.time() - start_time
            request_duration.observe(duration)
            active_analyses.dec()
    else:
        return await call_next(request)

# ํ—ฌ์Šค์ฒดํฌ ์—”๋“œํฌ์ธํŠธ
@app.get("/health")
async def health_check():
    """์‹œ์Šคํ…œ ์ƒํƒœ ํ™•์ธ"""
    
    health_status = {
        "status": "healthy",
        "timestamp": datetime.now().isoformat(),
        "checks": {}
    }
    
    # Claude API ์—ฐ๊ฒฐ ํ™•์ธ
    try:
        test_client = anthropic.Anthropic(api_key=os.getenv('ANTHROPIC_API_KEY'))
        # ๊ฐ„๋‹จํ•œ ํ…Œ์ŠคํŠธ ์š”์ฒญ
        health_status["checks"]["claude_api"] = "ok"
    except Exception as e:
        health_status["checks"]["claude_api"] = f"error: {str(e)}"
        health_status["status"] = "degraded"
    
    # ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์—ฐ๊ฒฐ ํ™•์ธ
    try:
        # DB ์ฟผ๋ฆฌ ํ…Œ์ŠคํŠธ
        health_status["checks"]["database"] = "ok"
    except Exception as e:
        health_status["checks"]["database"] = f"error: {str(e)}"
        health_status["status"] = "degraded"
    
    # Redis ์—ฐ๊ฒฐ ํ™•์ธ
    try:
        redis_client.ping()
        health_status["checks"]["redis"] = "ok"
    except Exception as e:
        health_status["checks"]["redis"] = f"error: {str(e)}"
        health_status["status"] = "degraded"
    
    return health_status
๐Ÿ”” ์•Œ๋ฆผ ์„ค์ • ์ค‘์š”ํ•œ ์ด๋ฒคํŠธ๊ฐ€ ๋ฐœ์ƒํ•˜๋ฉด ์ฆ‰์‹œ ์•Œ๋ฆผ์„ ๋ฐ›์„ ์ˆ˜ ์žˆ๊ฒŒ ์„ค์ •ํ•ด:

โ€ข Slack ํ†ตํ•ฉ: ์—๋Ÿฌ ๋ฐœ์ƒ ์‹œ Slack ์ฑ„๋„๋กœ ์•Œ๋ฆผ
โ€ข ์ด๋ฉ”์ผ ์•Œ๋ฆผ: ์‹œ์Šคํ…œ ๋‹ค์šดํƒ€์ž„์ด๋‚˜ ์‹ฌ๊ฐํ•œ ์˜ค๋ฅ˜ ๋ฐœ์ƒ ์‹œ
โ€ข PagerDuty: 24/7 ์˜จ์ฝœ ๋Œ€์‘์ด ํ•„์š”ํ•œ ๊ฒฝ์šฐ
โ€ข CloudWatch Alarms: AWS ๋ฆฌ์†Œ์Šค ๋ชจ๋‹ˆํ„ฐ๋ง ๋ฐ ์ž๋™ ์•Œ๋ฆผ

๐Ÿ’ก ์‹ค์ „ ํ™œ์šฉ ์‚ฌ๋ก€ ๋ฐ ํŒ

์ด๋ก ์€ ์ถฉ๋ถ„ํžˆ ๋ฐฐ์› ์œผ๋‹ˆ, ์ด์ œ ์‹ค์ œ๋กœ ์–ด๋–ป๊ฒŒ ํ™œ์šฉํ•˜๋Š”์ง€ ์•Œ์•„๋ณด์ž! ๐Ÿ’ผ
๋‹ค์–‘ํ•œ ์‚ฐ์—…๊ณผ ์ƒํ™ฉ์—์„œ ์ด ์‹œ์Šคํ…œ์„ ์–ด๋–ป๊ฒŒ ์ ์šฉํ•  ์ˆ˜ ์žˆ์„๊นŒ?

๐Ÿข ์‚ฐ์—…๋ณ„ ํ™œ์šฉ ์‚ฌ๋ก€

1. ๋ฒ•๋ฅ  ์„œ๋น„์Šค (๋กœํŽŒ, ๋ฒ•๋ฌด๋ฒ•์ธ) โš–๏ธ
โ€ข ์‹ ๊ทœ ์˜๋ขฐ์ธ ๊ณ„์•ฝ์„œ ์ดˆ๊ธฐ ๊ฒ€ํ†  ์ž๋™ํ™”
โ€ข ๊ณ„์•ฝ์„œ ์œ ํ˜•๋ณ„ ํ‘œ์ค€ ์กฐํ•ญ ์ค€์ˆ˜ ์—ฌ๋ถ€ ์ฒดํฌ
โ€ข ๊ณผ๊ฑฐ ์œ ์‚ฌ ๊ณ„์•ฝ์„œ์™€ ๋น„๊ต ๋ถ„์„
โ€ข ์†Œ์†ก ๊ด€๋ จ ๊ณ„์•ฝ์„œ ์ฆ๊ฑฐ ์ž๋ฃŒ ์ •๋ฆฌ

2. ๋ถ€๋™์‚ฐ (์ค‘๊ฐœ, ๊ฐœ๋ฐœ) ๐Ÿ˜๏ธ
โ€ข ์ž„๋Œ€์ฐจ ๊ณ„์•ฝ์„œ ํ•ต์‹ฌ ์กฐํ•ญ ์ฆ‰์‹œ ์ถ”์ถœ
โ€ข ๋งค๋งค ๊ณ„์•ฝ์„œ ํŠน์•ฝ์‚ฌํ•ญ ์ž๋™ ์ •๋ฆฌ
โ€ข ๋‹ค์ˆ˜์˜ ๋ถ„์–‘ ๊ณ„์•ฝ์„œ ์ผ๊ด„ ๋ถ„์„
โ€ข ๊ณ„์•ฝ ๊ฐฑ์‹  ์‹œ๊ธฐ ์ž๋™ ์•Œ๋ฆผ

3. ๊ธฐ์—… ๊ตฌ๋งค/์กฐ๋‹ฌ ๋ถ€์„œ ๐Ÿ“ฆ
โ€ข ๊ณต๊ธ‰์—…์ฒด ๊ณ„์•ฝ ์กฐ๊ฑด ๋น„๊ต ๋ถ„์„
โ€ข ๊ตฌ๋งค ๊ณ„์•ฝ์„œ ์Šน์ธ ์›Œํฌํ”Œ๋กœ์šฐ ์ž๋™ํ™”
โ€ข ๊ณ„์•ฝ ๊ธˆ์•ก ๋ฐ ๋‚ฉ๊ธฐ ์ผ์ • ์ถ”์ 
โ€ข ๊ณ„์•ฝ ์œ„๋ฐ˜ ์กฐํ•ญ ๋ชจ๋‹ˆํ„ฐ๋ง

4. HR/์ธ์‚ฌํŒ€ ๐Ÿ‘ฅ
โ€ข ๊ทผ๋กœ๊ณ„์•ฝ์„œ ํ•„์ˆ˜ ์กฐํ•ญ ๋ˆ„๋ฝ ์ฒดํฌ
โ€ข ํ‡ด์ง๊ธˆ, ์—ฐ์ฐจ ๋“ฑ ๋ณต๋ฆฌํ›„์ƒ ์กฐ๊ฑด ์ •๋ฆฌ
โ€ข ๋น„๋ฐ€์œ ์ง€๊ณ„์•ฝ(NDA) ์ž๋™ ๊ฒ€ํ† 
โ€ข ํ”„๋ฆฌ๋žœ์„œ/๊ณ„์•ฝ์ง ๊ณ„์•ฝ ๊ด€๋ฆฌ

5. ์Šคํƒ€ํŠธ์—…/๋ฒค์ฒ˜์บํ”ผํƒˆ ๐Ÿš€
โ€ข ํˆฌ์ž๊ณ„์•ฝ์„œ(Term Sheet) ํ•ต์‹ฌ ์กฐ๊ฑด ์ถ”์ถœ
โ€ข ์ฃผ์ฃผ๊ฐ„ ๊ณ„์•ฝ์„œ ๊ถŒ๋ฆฌ ์˜๋ฌด ์ •๋ฆฌ
โ€ข M&A ์‹ค์‚ฌ ์‹œ ๋‹ค์ˆ˜ ๊ณ„์•ฝ์„œ ์‹ ์† ๊ฒ€ํ† 
โ€ข ๋ผ์ด์„ ์Šค ๊ณ„์•ฝ ์กฐ๊ฑด ๋น„๊ต
๐ŸŽฏ ์žฌ๋Šฅ๋„ท ํ™œ์šฉ ํŒ ๊ณ„์•ฝ์„œ ์ž๋™์ถ”์ถœ ๋ด‡์„ ์ง์ ‘ ๊ตฌ์ถ•ํ•˜๊ธฐ ์–ด๋ ต๋‹ค๋ฉด, ์žฌ๋Šฅ๋„ท์—์„œ ์ „๋ฌธ๊ฐ€์˜ ๋„์›€์„ ๋ฐ›์•„๋ณด๋Š” ๊ฒƒ๋„ ์ข‹์€ ๋ฐฉ๋ฒ•์ด์•ผ!

์žฌ๋Šฅ๋„ท์—๋Š” AI ์ž๋™ํ™”, ํ”„๋กฌํ”„ํŠธ ์—”์ง€๋‹ˆ์–ด๋ง, ๋ฐฑ์—”๋“œ ๊ฐœ๋ฐœ ๋“ฑ ๋‹ค์–‘ํ•œ ๋ถ„์•ผ์˜ ์ „๋ฌธ๊ฐ€๋“ค์ด ์žˆ์–ด์„œ:
โ€ข ๋งž์ถคํ˜• ํ”„๋กฌํ”„ํŠธ ์„ค๊ณ„ ๋ฐ ์ตœ์ ํ™”
โ€ข ํŠน์ • ์‚ฐ์—…/์—…์ข…์— ํŠนํ™”๋œ ์ถ”์ถœ ๋กœ์ง ๊ฐœ๋ฐœ
โ€ข ๊ธฐ์กด ์‹œ์Šคํ…œ๊ณผ์˜ ์—ฐ๋™ ์ž‘์—…
โ€ข ์„ฑ๋Šฅ ํŠœ๋‹ ๋ฐ ๋น„์šฉ ์ตœ์ ํ™”

ํ˜ผ์ž ๊ณ ๋ฏผํ•˜์ง€ ๋ง๊ณ  ์ „๋ฌธ๊ฐ€์˜ ๋…ธํ•˜์šฐ๋ฅผ ํ™œ์šฉํ•ด๋ณด์ž! ๐Ÿค
๐Ÿ”ฅ ๊ณ ๊ธ‰ ํ™œ์šฉ ํŒ

1. ๊ณ„์•ฝ์„œ ํ…œํ”Œ๋ฆฟ ์ž๋™ ์ƒ์„ฑ
์ถ”์ถœํ•œ ์ •๋ณด๋ฅผ ๋ฐ”ํƒ•์œผ๋กœ ์—ญ์œผ๋กœ ๊ณ„์•ฝ์„œ ์ดˆ์•ˆ์„ ์ƒ์„ฑํ•  ์ˆ˜๋„ ์žˆ์–ด!

def generate_contract_draft(extracted_data: Dict, template_type: str) -> str:
    """์ถ”์ถœ๋œ ์ •๋ณด๋กœ ๊ณ„์•ฝ์„œ ์ดˆ์•ˆ ์ƒ์„ฑ"""
    
    prompt = f"""๋‹ค์Œ ์ •๋ณด๋ฅผ ๋ฐ”ํƒ•์œผ๋กœ {template_type} ๊ณ„์•ฝ์„œ ์ดˆ์•ˆ์„ ์ž‘์„ฑํ•ด์ฃผ์„ธ์š”.

๊ณ„์•ฝ ์ •๋ณด:
{json.dumps(extracted_data, ensure_ascii=False, indent=2)}

ํ•œ๊ตญ ๋ฒ•๋ฅ ์— ๋งž๋Š” ํ‘œ์ค€ ์–‘์‹์œผ๋กœ ์ž‘์„ฑํ•˜๋˜, ๋‹ค์Œ ์‚ฌํ•ญ์„ ํฌํ•จํ•ด์ฃผ์„ธ์š”:
- ๊ณ„์•ฝ ๋‹น์‚ฌ์ž ์ •๋ณด
- ๊ณ„์•ฝ์˜ ๋ชฉ์  ๋ฐ ๋ฒ”์œ„
- ๊ณ„์•ฝ ๊ธฐ๊ฐ„ ๋ฐ ๊ฐฑ์‹  ์กฐ๊ฑด
- ๋Œ€๊ธˆ ์ง€๊ธ‰ ์กฐ๊ฑด
- ๊ฐ ๋‹น์‚ฌ์ž์˜ ๊ถŒ๋ฆฌ์™€ ์˜๋ฌด
- ๊ณ„์•ฝ ํ•ด์ง€ ์กฐ๊ฑด
- ๋ถ„์Ÿ ํ•ด๊ฒฐ ๋ฐฉ๋ฒ•
- ๊ธฐํƒ€ ํ•„์š”ํ•œ ์กฐํ•ญ

์ „๋ฌธ์ ์ด๊ณ  ๋ช…ํ™•ํ•œ ๋ฒ•๋ฅ  ์šฉ์–ด๋ฅผ ์‚ฌ์šฉํ•ด์ฃผ์„ธ์š”."""

    message = client.messages.create(
        model="claude-3-opus-20240229",  # ๋ฌธ์„œ ์ƒ์„ฑ์€ Opus ์ถ”์ฒœ
        max_tokens=8000,
        messages=[{"role": "user", "content": prompt}]
    )
    
    return message.content[0].text
2. ๋‹ค๊ตญ์–ด ๊ณ„์•ฝ์„œ ์ง€์›
์˜๋ฌธ ๊ณ„์•ฝ์„œ๋„ ํ•œ๊ธ€๋กœ ๋ฒˆ์—ญํ•˜๋ฉด์„œ ๋™์‹œ์— ๋ถ„์„ํ•  ์ˆ˜ ์žˆ์–ด!

def analyze_multilingual_contract(text: str, source_lang: str = "auto") -> Dict:
    """๋‹ค๊ตญ์–ด ๊ณ„์•ฝ์„œ ๋ถ„์„ (๋ฒˆ์—ญ + ์ถ”์ถœ)"""
    
    prompt = f"""๋‹ค์Œ ๊ณ„์•ฝ์„œ๋ฅผ ๋ถ„์„ํ•ด์ฃผ์„ธ์š”. 
์›๋ฌธ์ด ํ•œ๊ตญ์–ด๊ฐ€ ์•„๋‹ˆ๋ผ๋ฉด ๋จผ์ € ํ•œ๊ตญ์–ด๋กœ ๋ฒˆ์—ญํ•œ ํ›„ ๋ถ„์„ํ•ด์ฃผ์„ธ์š”.

๊ณ„์•ฝ์„œ ์›๋ฌธ:
{text}

๋ถ„์„ ๊ฒฐ๊ณผ๋ฅผ ๋‹ค์Œ ํ˜•์‹์œผ๋กœ ๋ฐ˜ํ™˜:
{{
    "detected_language": "๊ฐ์ง€๋œ ์–ธ์–ด",
    "translation": "ํ•œ๊ตญ์–ด ๋ฒˆ์—ญ (ํ•„์š”ํ•œ ๊ฒฝ์šฐ)",
    "extracted_data": {{
        // ์ถ”์ถœ๋œ ๊ณ„์•ฝ ์ •๋ณด
    }}
}}"""

    # Claude๋Š” ๋‹ค๊ตญ์–ด๋ฅผ ์ž์—ฐ์Šค๋Ÿฝ๊ฒŒ ์ฒ˜๋ฆฌํ•  ์ˆ˜ ์žˆ์–ด
    message = client.messages.create(
        model="claude-3-sonnet-20240229",
        max_tokens=8000,
        messages=[{"role": "user", "content": prompt}]
    )
    
    return json.loads(message.content[0].text)
3. ๊ณ„์•ฝ์„œ ๋ฒ„์ „ ๋น„๊ต
๊ณ„์•ฝ์„œ๊ฐ€ ์ˆ˜์ •๋  ๋•Œ๋งˆ๋‹ค ๋ณ€๊ฒฝ์‚ฌํ•ญ์„ ์ž๋™์œผ๋กœ ์ถ”์ ํ•ด!

def track_contract_changes(original_text: str, revised_text: str) -> Dict:
    """๊ณ„์•ฝ์„œ ๋ฒ„์ „ ๊ฐ„ ๋ณ€๊ฒฝ์‚ฌํ•ญ ์ถ”์ """
    
    prompt = f"""๋‹ค์Œ ๋‘ ๋ฒ„์ „์˜ ๊ณ„์•ฝ์„œ๋ฅผ ๋น„๊ตํ•˜์—ฌ ๋ณ€๊ฒฝ์‚ฌํ•ญ์„ ์ƒ์„ธํžˆ ๋ถ„์„ํ•ด์ฃผ์„ธ์š”.

[์›๋ณธ ๋ฒ„์ „]
{original_text}

[์ˆ˜์ • ๋ฒ„์ „]
{revised_text}

๋‹ค์Œ ํ˜•์‹์œผ๋กœ ๋ณ€๊ฒฝ์‚ฌํ•ญ์„ ์ •๋ฆฌ:
{{
    "changes": [
        {{
            "section": "๋ณ€๊ฒฝ๋œ ์กฐํ•ญ",
            "change_type": "added/modified/deleted",
            "original": "์›๋ณธ ๋‚ด์šฉ",
            "revised": "์ˆ˜์ •๋œ ๋‚ด์šฉ",
            "impact": "๋ณ€๊ฒฝ์˜ ์˜ํ–ฅ๋„ (high/medium/low)",
            "explanation": "๋ณ€๊ฒฝ ์‚ฌํ•ญ ์„ค๋ช…"
        }}
    ],
    "summary": "์ „์ฒด ๋ณ€๊ฒฝ์‚ฌํ•ญ ์š”์•ฝ",
    "recommendation": "๊ฒ€ํ†  ๊ถŒ์žฅ์‚ฌํ•ญ"
}}"""

    message = client.messages.create(
        model="claude-3-opus-20240229",
        max_tokens=6000,
        messages=[{"role": "user", "content": prompt}]
    )
    
    return json.loads(message.content[0].text)
4. ๊ณ„์•ฝ์„œ Q&A ์ฑ—๋ด‡
๊ณ„์•ฝ์„œ ๋‚ด์šฉ์— ๋Œ€ํ•ด ์ž์—ฐ์–ด๋กœ ์งˆ๋ฌธํ•˜๊ณ  ๋‹ต๋ณ€๋ฐ›์„ ์ˆ˜ ์žˆ์–ด!

class ContractQABot:
    """๊ณ„์•ฝ์„œ ๋‚ด์šฉ ์งˆ์˜์‘๋‹ต ๋ด‡"""
    
    def __init__(self, contract_text: str):
        self.contract_text = contract_text
        self.conversation_history = []
    
    def ask(self, question: str) -> str:
        """๊ณ„์•ฝ์„œ์— ๋Œ€ํ•œ ์งˆ๋ฌธ"""
        
        # ๋Œ€ํ™” ์ปจํ…์ŠคํŠธ ๊ตฌ์„ฑ
        context = f"""๊ณ„์•ฝ์„œ ๋‚ด์šฉ:
{self.contract_text}

์œ„ ๊ณ„์•ฝ์„œ๋ฅผ ๋ฐ”ํƒ•์œผ๋กœ ์งˆ๋ฌธ์— ๋‹ต๋ณ€ํ•ด์ฃผ์„ธ์š”.
๋‹ต๋ณ€์€ ๊ณ„์•ฝ์„œ์— ๋ช…์‹œ๋œ ๋‚ด์šฉ์„ ๊ทผ๊ฑฐ๋กœ ํ•˜๋˜, ํ•ด๋‹น ์กฐํ•ญ์„ ์ธ์šฉํ•ด์ฃผ์„ธ์š”."""

        # ์ด์ „ ๋Œ€ํ™” ํฌํ•จ
        messages = [{"role": "user", "content": context}]
        
        for qa in self.conversation_history:
            messages.append({"role": "user", "content": qa["question"]})
            messages.append({"role": "assistant", "content": qa["answer"]})
        
        messages.append({"role": "user", "content": question})
        
        # Claude์—๊ฒŒ ์งˆ๋ฌธ
        response = client.messages.create(
            model="claude-3-sonnet-20240229",
            max_tokens=2000,
            messages=messages
        )
        
        answer = response.content[0].text
        
        # ๋Œ€ํ™” ๊ธฐ๋ก ์ €์žฅ
        self.conversation_history.append({
            "question": question,
            "answer": answer
        })
        
        return answer

# ์‚ฌ์šฉ ์˜ˆ์‹œ
bot = ContractQABot(contract_text)
answer1 = bot.ask("๊ณ„์•ฝ ๊ธฐ๊ฐ„์€ ์–ธ์ œ๊นŒ์ง€์ธ๊ฐ€์š”?")
answer2 = bot.ask("์ค‘๋„ ํ•ด์ง€๊ฐ€ ๊ฐ€๋Šฅํ•œ๊ฐ€์š”?")
answer3 = bot.ask("์œ„์•ฝ๊ธˆ์€ ์–ผ๋งˆ์ธ๊ฐ€์š”?")

๐ŸŽ“ ํ•™์Šต ๋ฆฌ์†Œ์Šค ๋ฐ ๋‹ค์Œ ๋‹จ๊ณ„

์—ฌ๊ธฐ๊นŒ์ง€ ์™”๋‹ค๋ฉด ์ด๋ฏธ ๊ณ„์•ฝ์„œ ์ž๋™์ถ”์ถœ ๋ด‡์˜ ํ•ต์‹ฌ์„ ๋‹ค ๋ฐฐ์šด ๊ฑฐ์•ผ! ๐ŸŽ‰
ํ•˜์ง€๋งŒ AI ๊ธฐ์ˆ ์€ ๊ณ„์† ๋ฐœ์ „ํ•˜๊ณ  ์žˆ์œผ๋‹ˆ, ์ง€์†์ ์ธ ํ•™์Šต์ด ์ค‘์š”ํ•ด.

๐Ÿ“š ์ถ”์ฒœ ํ•™์Šต ์ž๋ฃŒ

๊ณต์‹ ๋ฌธ์„œ ๐Ÿ“–
โ€ข Anthropic Claude ๊ณต์‹ ๋ฌธ์„œ: https://docs.anthropic.com
โ€ข FastAPI ๊ณต์‹ ๋ฌธ์„œ: https://fastapi.tiangolo.com
โ€ข LangChain ๋ฌธ์„œ: https://python.langchain.com

์˜จ๋ผ์ธ ๊ฐ•์˜ ๐ŸŽฅ
โ€ข "LLM์„ ํ™œ์šฉํ•œ ์‹ค์ „ AI ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ๊ฐœ๋ฐœ"
โ€ข "ํ”„๋กฌํ”„ํŠธ ์—”์ง€๋‹ˆ์–ด๋ง ๋งˆ์Šคํ„ฐ ํด๋ž˜์Šค"
โ€ข "FastAPI๋กœ ๋งŒ๋“œ๋Š” ํ”„๋กœ๋•์…˜ ๋ ˆ๋ฒจ API"

์ปค๋ฎค๋‹ˆํ‹ฐ ๐Ÿ‘ฅ
โ€ข Anthropic Discord ์ปค๋ฎค๋‹ˆํ‹ฐ
โ€ข Reddit r/LangChain, r/MachineLearning
โ€ข ํ•œ๊ตญ AI ๊ฐœ๋ฐœ์ž ๋ชจ์ž„

๋ธ”๋กœ๊ทธ ๋ฐ ์•„ํ‹ฐํด โœ๏ธ
โ€ข Anthropic ๊ณต์‹ ๋ธ”๋กœ๊ทธ
โ€ข Towards Data Science (Medium)
โ€ข AI ๊ด€๋ จ ๊ธฐ์ˆ  ๋ธ”๋กœ๊ทธ๋“ค
๐Ÿš€ ๋‹ค์Œ ๋‹จ๊ณ„๋กœ ๋‚˜์•„๊ฐ€๊ธฐ

1๋‹จ๊ณ„: ๊ธฐ๋ณธ ์‹œ์Šคํ…œ ์™„์„ฑ โœ…
โ€ข PDF/DOCX ํŒŒ์ผ์—์„œ ํ…์ŠคํŠธ ์ถ”์ถœ
โ€ข Claude API๋กœ ์ฃผ์š” ์กฐํ•ญ ์ถ”์ถœ
โ€ข ๊ฐ„๋‹จํ•œ ์›น ์ธํ„ฐํŽ˜์ด์Šค ๊ตฌ์ถ•

2๋‹จ๊ณ„: ๊ธฐ๋Šฅ ํ™•์žฅ ๐Ÿ”ง
โ€ข ๋‹ค์–‘ํ•œ ๊ณ„์•ฝ์„œ ์œ ํ˜• ์ง€์›
โ€ข ๋ฆฌ์Šคํฌ ๋ถ„์„ ๊ธฐ๋Šฅ ์ถ”๊ฐ€
โ€ข ๊ณ„์•ฝ์„œ ๋น„๊ต ๊ธฐ๋Šฅ ๊ตฌํ˜„
โ€ข ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์—ฐ๋™

3๋‹จ๊ณ„: ํ”„๋กœ๋•์…˜ ์ค€๋น„ ๐Ÿญ
โ€ข ๋ณด์•ˆ ๊ฐ•ํ™” (์ธ์ฆ, ์•”ํ˜ธํ™”)
โ€ข ์„ฑ๋Šฅ ์ตœ์ ํ™” (์บ์‹ฑ, ๋ฐฐ์น˜ ์ฒ˜๋ฆฌ)
โ€ข ๋ชจ๋‹ˆํ„ฐ๋ง ๋ฐ ๋กœ๊น… ์‹œ์Šคํ…œ
โ€ข ์ž๋™ํ™”๋œ ํ…Œ์ŠคํŠธ ๊ตฌ์ถ•

4๋‹จ๊ณ„: ๊ณ ๋„ํ™” ๐ŸŒŸ
โ€ข AI ์—์ด์ „ํŠธ๋กœ ๋ฐœ์ „ (์ž์œจ์  ์˜์‚ฌ๊ฒฐ์ •)
โ€ข ๋‹ค๋ฅธ ์‹œ์Šคํ…œ๊ณผ ํ†ตํ•ฉ (ERP, CRM)
โ€ข ๋ชจ๋ฐ”์ผ ์•ฑ ๊ฐœ๋ฐœ
โ€ข ์Œ์„ฑ ์ธํ„ฐํŽ˜์ด์Šค ์ถ”๊ฐ€

5๋‹จ๊ณ„: ๋น„์ฆˆ๋‹ˆ์Šคํ™” ๐Ÿ’ผ
โ€ข SaaS ์ œํ’ˆ์œผ๋กœ ์ถœ์‹œ
โ€ข API ์„œ๋น„์Šค ์ œ๊ณต
โ€ข ์‚ฐ์—…๋ณ„ ํŠนํ™” ๋ฒ„์ „ ๊ฐœ๋ฐœ
โ€ข ํŒŒํŠธ๋„ˆ์‹ญ ๋ฐ B2B ์˜์—…
๐ŸŽฏ ์„ฑ๊ณต์„ ์œ„ํ•œ ํ•ต์‹ฌ ํฌ์ธํŠธ 1. ์‚ฌ์šฉ์ž ํ”ผ๋“œ๋ฐฑ ์ค‘์‹œ: ์‹ค์ œ ์‚ฌ์šฉ์ž์˜ ์˜๊ฒฌ์„ ๋“ฃ๊ณ  ๊ฐœ์„ ํ•ด๋‚˜๊ฐ€๋Š” ๊ฒŒ ๊ฐ€์žฅ ์ค‘์š”ํ•ด.
2. ์ ์ง„์  ๊ฐœ์„ : ์ฒ˜์Œ๋ถ€ํ„ฐ ์™„๋ฒฝํ•  ์ˆœ ์—†์–ด. ์ž‘๊ฒŒ ์‹œ์ž‘ํ•ด์„œ ๊ณ„์† ๋ฐœ์ „์‹œ์ผœ.
3. ๋„๋ฉ”์ธ ์ง€์‹: ๋ฒ•๋ฅ , ๊ณ„์•ฝ ๊ด€๋ จ ์ „๋ฌธ ์ง€์‹์„ ์Œ“์œผ๋ฉด ๋” ์ข‹์€ ์‹œ์Šคํ…œ์„ ๋งŒ๋“ค ์ˆ˜ ์žˆ์–ด.
4. ๋น„์šฉ ๊ด€๋ฆฌ: Claude API ๋น„์šฉ์„ ํ•ญ์ƒ ๋ชจ๋‹ˆํ„ฐ๋งํ•˜๊ณ  ์ตœ์ ํ™”ํ•ด.
5. ๋ณด์•ˆ ์šฐ์„ : ๋ฏผ๊ฐํ•œ ์ •๋ณด๋ฅผ ๋‹ค๋ฃจ๋‹ˆ๊นŒ ๋ณด์•ˆ์€ ์ ˆ๋Œ€ ํƒ€ํ˜‘ํ•˜์ง€ ๋งˆ.
6. ๋ฌธ์„œํ™”: ์ฝ”๋“œ์™€ ์‹œ์Šคํ…œ์„ ์ž˜ ๋ฌธ์„œํ™”ํ•ด๋‘๋ฉด ๋‚˜์ค‘์— ์œ ์ง€๋ณด์ˆ˜๊ฐ€ ํ›จ์”ฌ ์‰ฌ์›Œ.
7. ์ปค๋ฎค๋‹ˆํ‹ฐ ํ™œ์šฉ: ํ˜ผ์ž ๊ณ ๋ฏผํ•˜์ง€ ๋ง๊ณ  ์ปค๋ฎค๋‹ˆํ‹ฐ์—์„œ ๋„์›€์„ ๊ตฌํ•ด.

๐ŸŽฌ ๋งˆ๋ฌด๋ฆฌํ•˜๋ฉฐ

์™€! ์—ฌ๊ธฐ๊นŒ์ง€ ์ •๋ง ๊ธด ์—ฌ์ •์ด์—ˆ์–ด. ๐ŸŽ‰
๊ณ„์•ฝ์„œ ์ž๋™์ถ”์ถœ ๋ด‡์„ ๋งŒ๋“œ๋Š” ์ „ ๊ณผ์ •์„ ํ•จ๊ป˜ ์‚ดํŽด๋ดค๋Š”๋ฐ, ์–ด๋•Œ? ์ƒ๊ฐ๋ณด๋‹ค ์–ด๋ ต์ง€ ์•Š์ง€? ๐Ÿ˜Š

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

๋ฌผ๋ก  ์ฒ˜์Œ๋ถ€ํ„ฐ ์™„๋ฒฝํ•œ ์‹œ์Šคํ…œ์„ ๋งŒ๋“ค ์ˆœ ์—†์–ด.
ํ•˜์ง€๋งŒ ์ด ๊ธ€์—์„œ ๋ฐฐ์šด ๋‚ด์šฉ์„ ๋ฐ”ํƒ•์œผ๋กœ ํ•˜๋‚˜์”ฉ ๊ตฌํ˜„ํ•ด๋‚˜๊ฐ€๋‹ค ๋ณด๋ฉด,
์–ด๋А์ƒˆ ์‹ค๋ฌด์—์„œ ์ •๋ง ์œ ์šฉํ•˜๊ฒŒ ์“ธ ์ˆ˜ ์žˆ๋Š” ๋„๊ตฌ๊ฐ€ ์™„์„ฑ๋  ๊ฑฐ์•ผ. ๐Ÿ’ช

ํŠนํžˆ ๋ฒ•๋ฌดํŒ€, ๊ตฌ๋งคํŒ€, HRํŒ€์ฒ˜๋Ÿผ ๊ณ„์•ฝ์„œ๋ฅผ ์ž์ฃผ ๋‹ค๋ฃจ๋Š” ๋ถ€์„œ์—์„œ๋Š”
์ด๋Ÿฐ ์ž๋™ํ™” ์‹œ์Šคํ…œ์ด ์ •๋ง ํฐ ๋„์›€์ด ๋  ๊ฑฐ์•ผ.
๋ฐ˜๋ณต์ ์ด๊ณ  ์ง€๋ฃจํ•œ ์ž‘์—…์—์„œ ํ•ด๋ฐฉ๋˜์–ด, ๋” ์ค‘์š”ํ•œ ์˜์‚ฌ๊ฒฐ์ •์— ์ง‘์ค‘ํ•  ์ˆ˜ ์žˆ๊ฒŒ ๋˜๋‹ˆ๊นŒ! ๐ŸŽฏ

ํ˜น์‹œ ๊ตฌํ˜„ํ•˜๋‹ค๊ฐ€ ๋ง‰ํžˆ๋Š” ๋ถ€๋ถ„์ด ์žˆ๊ฑฐ๋‚˜, ๋” ๊ณ ๊ธ‰ ๊ธฐ๋Šฅ์ด ํ•„์š”ํ•˜๋‹ค๋ฉด
์žฌ๋Šฅ๋„ท์—์„œ ์ „๋ฌธ๊ฐ€๋“ค์˜ ๋„์›€์„ ๋ฐ›์•„๋ณด๋Š” ๊ฒƒ๋„ ์ข‹์€ ๋ฐฉ๋ฒ•์ด์•ผ.
AI ์ž๋™ํ™” ๋ถ„์•ผ๋Š” ๋น ๋ฅด๊ฒŒ ๋ฐœ์ „ํ•˜๊ณ  ์žˆ์–ด์„œ, ์ตœ์‹  ํŠธ๋ Œ๋“œ๋ฅผ ์•„๋Š” ์ „๋ฌธ๊ฐ€์˜ ์กฐ์–ธ์ด ํฐ ๋„์›€์ด ๋  ๊ฑฐ์•ผ! ๐Ÿค

์ž, ์ด์ œ ๋‹น์‹  ์ฐจ๋ก€์•ผ!
์ด ๊ธ€์„ ์ฝ๊ธฐ๋งŒ ํ•˜์ง€ ๋ง๊ณ , ์ง์ ‘ ์ฝ”๋“œ๋ฅผ ์ž‘์„ฑํ•ด๋ณด๊ณ , ์‹คํ—˜ํ•ด๋ณด๊ณ , ์‹คํŒจ๋„ ํ•ด๋ณด๋ฉด์„œ
๋‚˜๋งŒ์˜ ๊ณ„์•ฝ์„œ ์ž๋™์ถ”์ถœ ๋ด‡์„ ๋งŒ๋“ค์–ด๋ด. ๐Ÿ’ป

์‹œ์ž‘์ด ๋ฐ˜์ด๋ผ๊ณ  ํ–ˆ์ž–์•„?
์ง€๊ธˆ ๋ฐ”๋กœ ํ„ฐ๋ฏธ๋„์„ ์—ด๊ณ  pip install anthropic๋ถ€ํ„ฐ ์ณ๋ณด์ž! ๐Ÿš€

ํ–‰์šด์„ ๋นŒ์–ด! ํ™”์ดํŒ…! ๐Ÿ’ชโœจ

๐ŸŽ‰ ์ถ•ํ•˜ํ•ฉ๋‹ˆ๋‹ค! ๐ŸŽ‰ ๊ณ„์•ฝ์„œ ์ž๋™์ถ”์ถœ ๋ด‡ ๊ตฌ์ถ• ์™„๋ฃŒ! ์ด์ œ ๋‹น์‹ ๋„ AI ์ž๋™ํ™” ์ „๋ฌธ๊ฐ€์ž…๋‹ˆ๋‹ค ๐Ÿ† โœ… ๐Ÿš€ Happy Coding! ๐Ÿ’ปโœจ
๋Œ“๊ธ€ ์ž‘์„ฑ

์ด ๊ธ€์— ๋Œ€ํ•œ ์—ฌ๋Ÿฌ๋ถ„์˜ ์ƒ๊ฐ์„ ๋“ค๋ ค์ฃผ์„ธ์š”

๋Œ“๊ธ€ 0
๋Œ“๊ธ€์„ ๋ถˆ๋Ÿฌ์˜ค๋Š” ์ค‘์ž…๋‹ˆ๋‹ค.

์•„์ง ๋Œ“๊ธ€์ด ์—†์Šต๋‹ˆ๋‹ค.