최종 프로젝트 단계별 문서 정리와 새 가이드 배포
This commit is contained in:
1 parent
5e43df2378
commit
c49fe35f3a
10 files changed
+492
No files matched your search
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
@@ -0,0 +1,188 @@
|
||||
<!DOCTYPE html>
|
||||
<html lang="ko"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
||||
<title>API 설계 문서 작성법</title>
|
||||
<style>
|
||||
*{box-sizing:border-box;margin:0;padding:0}
|
||||
html,body{background:#060d18;color:#F1F5F9;font-family:"Noto Sans KR","Noto Sans CJK KR","Apple SD Gothic Neo","Malgun Gothic",sans-serif}
|
||||
.stage{width:1280px;transform-origin:0 0;margin:0 auto}
|
||||
.slide{position:relative;width:1280px;height:720px;background:#0F1B2D;overflow:hidden;margin:0 0 24px}
|
||||
.r,.t{position:absolute}
|
||||
.t{display:flex;flex-direction:column;line-height:1.38;white-space:pre-wrap;word-break:keep-all;overflow-wrap:anywhere;font-weight:400}
|
||||
.t.m{font-family:"D2Coding","Consolas","Menlo","DejaVu Sans Mono","Noto Sans KR","Noto Sans CJK KR",monospace;line-height:1.36;word-break:normal}
|
||||
.t.ul .li{padding-left:1.2em;text-indent:-1.2em;margin-bottom:var(--gap,12px)}
|
||||
.t.ul .li::before{content:"•";display:inline-block;width:1.2em;text-indent:0;color:#2DD4BF}
|
||||
.bar{position:fixed;right:14px;bottom:10px;font-size:12px;color:#A8B8CC;background:rgba(6,13,24,.8);padding:4px 10px;border-radius:12px;z-index:9}
|
||||
body.present{overflow:hidden}
|
||||
body.present .slide{display:none;margin:0}
|
||||
body.present .slide.on{display:block}
|
||||
@page{size:1280px 720px;margin:0}
|
||||
@media print{html,body{background:#0F1B2D}.bar{display:none}.stage{transform:none!important;margin:0!important}
|
||||
.slide,body.present .slide{display:block;margin:0;break-after:page;break-inside:avoid}
|
||||
*{-webkit-print-color-adjust:exact;print-color-adjust:exact}}
|
||||
</style></head><body>
|
||||
<main class="stage">
|
||||
<section class="slide"><h1 class="t" style="left:57.599999999999994px;top:211.20000000000002px;width:1056px;height:115.19999999999999px;font-size:64px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>API 설계 문서 작성법</span></h1><div class="t" style="left:57.599999999999994px;top:336px;width:1056px;height:48px;font-size:29.333333333333332px;color:#2DD4BF;text-align:left;justify-content:center;"><span>최종 프로젝트 STEP 2 · REST API 및 Function Calling 명세서</span></div><div class="t" style="left:57.599999999999994px;top:398.40000000000003px;width:1056px;height:38.400000000000006px;font-size:20px;color:#A8B8CC;text-align:left;justify-content:center;"><span>AI 애플리케이션 개발 과정 · 최종 프로젝트 산출물 가이드</span></div><div class="r" style="left:57.599999999999994px;top:537.5999999999999px;width:285.888px;height:48px;background:#1A2B45;border-radius:24px"></div><div class="t m" style="left:57.599999999999994px;top:537.5999999999999px;width:285.888px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>GET /api/v1/incidents</span></div><div class="r" style="left:367.488px;top:537.5999999999999px;width:376.51199999999994px;height:48px;background:#1A2B45;border-radius:24px"></div><div class="t m" style="left:367.488px;top:537.5999999999999px;width:376.51199999999994px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>POST /incidents/{id}/recovery</span></div><div class="r" style="left:768px;top:537.5999999999999px;width:183.93599999999998px;height:48px;background:#1A2B45;border-radius:24px"></div><div class="t m" style="left:768px;top:537.5999999999999px;width:183.93599999999998px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>202 Accepted</span></div><div class="r" style="left:975.936px;top:537.5999999999999px;width:217.92000000000002px;height:48px;background:#1A2B45;border-radius:24px"></div><div class="t m" style="left:975.936px;top:537.5999999999999px;width:217.92000000000002px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>restart_service</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>API 설계 문서는 팀의 계약서다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · API 설계 문서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>2</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>코드를 쓰기 전에, 무엇을 주고받을지 합의해 두는 문서</span></div><div class="r" style="left:57.599999999999994px;top:206.39999999999998px;width:369.05600000000004px;height:316.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>프런트 ↔ 백엔드</span></div><div class="t" style="left:86.39999999999999px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>따로 개발해도 맞물린다</span></div><div class="t" style="left:86.39999999999999px;top:326.4px;width:311.456px;height:168px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>화면이 어떤 주소로 무엇을 보내고 무엇을 받는지 미리 정한다. 서로 기다리지 않고 동시에 개발할 수 있다.</span></div><div class="r" style="left:455.456px;top:206.39999999999998px;width:369.05600000000004px;height:316.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:484.256px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>에이전트 ↔ 도구</span></div><div class="t" style="left:484.256px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>Function Calling의 기준</span></div><div class="t" style="left:484.256px;top:326.4px;width:311.456px;height:168px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>LLM이 호출할 Tool의 이름, 입력, 실패 코드를 정한다. 에이전트 설계가 이 명세 위에 올라간다.</span></div><div class="r" style="left:853.3120000000001px;top:206.39999999999998px;width:369.05600000000004px;height:316.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:882.1120000000001px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>설계 ↔ 검증</span></div><div class="t" style="left:882.1120000000001px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>테스트의 근거</span></div><div class="t" style="left:882.1120000000001px;top:326.4px;width:311.456px;height:168px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>평가는 문서가 있는지가 아니라 설계·구현·검증이 이어지는지를 본다. 명세가 곧 테스트 케이스가 된다.</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>STEP 2에서 이 문서가 놓이는 자리</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · API 설계 문서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>3</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>앞 단계의 요구사항을 받아, 뒤 단계의 구현과 검증에 기준을 넘겨준다</span></div><div class="r" style="left:57.599999999999994px;top:240px;width:200.69760000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:72px;top:268.79999999999995px;width:171.8976px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>기획서</span></div><div class="t" style="left:72px;top:331.20000000000005px;width:171.8976px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>기능 요구사항
|
||||
FR-01 …</span></div><div class="t" style="left:258.29760000000005px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:298.61760000000004px;top:240px;width:200.69760000000002px;height:220.79999999999998px;background:#0F766E;border-radius:9.600000000000001px"></div><div class="t" style="left:313.0176px;top:268.79999999999995px;width:171.8976px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>API 설계 문서</span></div><div class="t" style="left:313.0176px;top:331.20000000000005px;width:171.8976px;height:86.4px;font-size:18.666666666666668px;color:#F1F5F9;text-align:center;justify-content:flex-start;"><span>오늘 다루는
|
||||
산출물</span></div><div class="t" style="left:499.3152px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:539.6351999999999px;top:240px;width:200.69760000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:554.0352px;top:268.79999999999995px;width:171.8976px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>DB 스키마 설계서</span></div><div class="t" style="left:554.0352px;top:331.20000000000005px;width:171.8976px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>STEP 2의
|
||||
짝 산출물</span></div><div class="t" style="left:740.3328px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:780.6528000000001px;top:240px;width:200.69760000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:795.0528px;top:268.79999999999995px;width:171.8976px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>에이전트 설계</span></div><div class="t" style="left:795.0528px;top:331.20000000000005px;width:171.8976px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>Tool 정의를
|
||||
가져다 쓴다</span></div><div class="t" style="left:981.3504px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:1021.6704px;top:240px;width:200.69760000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:1036.0704px;top:268.79999999999995px;width:171.8976px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>통합 테스트</span></div><div class="t" style="left:1036.0704px;top:331.20000000000005px;width:171.8976px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>명세대로
|
||||
동작하는지 확인</span></div><div class="r" style="left:57.599999999999994px;top:513.5999999999999px;width:1164.768px;height:71.03999999999999px;background:#0A1322;border-radius:7.68px"></div><div class="t" style="left:86.39999999999999px;top:513.5999999999999px;width:1107.1680000000001px;height:71.03999999999999px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>API 설계 문서와 DB 스키마 설계서는 STEP 2의 필수 산출물이다. 두 문서는 같은 식별자와 필드명을 써야 한다.</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>문서에 들어가는 여섯 가지</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · API 설계 문서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>4</span></div><div class="r" style="left:57.599999999999994px;top:168px;width:369.05600000000004px;height:225.60000000000002px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:196.79999999999998px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>01</span></div><div class="t" style="left:86.39999999999999px;top:235.2px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>인증 방식</span></div><div class="t" style="left:86.39999999999999px;top:288px;width:311.456px;height:76.79999999999998px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>토큰 발급·전달·검증 방법과 401·403 조건</span></div><div class="r" style="left:455.456px;top:168px;width:369.05600000000004px;height:225.60000000000002px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:484.256px;top:196.79999999999998px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>02</span></div><div class="t" style="left:484.256px;top:235.2px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>API 목록</span></div><div class="t" style="left:484.256px;top:288px;width:311.456px;height:76.79999999999998px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>메서드·경로·인증·설명을 한눈에 보는 표</span></div><div class="r" style="left:853.3120000000001px;top:168px;width:369.05600000000004px;height:225.60000000000002px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:882.1120000000001px;top:196.79999999999998px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>03</span></div><div class="t" style="left:882.1120000000001px;top:235.2px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>엔드포인트 상세 명세</span></div><div class="t" style="left:882.1120000000001px;top:288px;width:311.456px;height:76.79999999999998px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>요청·응답·오류를 예시값과 함께</span></div><div class="r" style="left:57.599999999999994px;top:422.40000000000003px;width:369.05600000000004px;height:225.60000000000002px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:451.20000000000005px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>04</span></div><div class="t" style="left:86.39999999999999px;top:489.6px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>입력 검증 규칙</span></div><div class="t" style="left:86.39999999999999px;top:542.4000000000001px;width:311.456px;height:76.79999999999998px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>허용 값·길이·필수 조건을 Pydantic 모델로</span></div><div class="r" style="left:455.456px;top:422.40000000000003px;width:369.05600000000004px;height:225.60000000000002px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:484.256px;top:451.20000000000005px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>05</span></div><div class="t" style="left:484.256px;top:489.6px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>Tool 정의</span></div><div class="t" style="left:484.256px;top:542.4000000000001px;width:311.456px;height:76.79999999999998px;font-size:20Line truncated
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>REST는 자원을 주소로, 행위를 메서드로 나타낸다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · API 설계 문서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>5</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>RESTful API는 이 약속을 지켜서 만든 API다. 주소만 봐도 무엇을 다루는지 알 수 있다</span></div><div class="r" style="left:57.599999999999994px;top:206.39999999999998px;width:369.05600000000004px;height:412.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>자원 (Resource)</span></div><div class="t" style="left:86.39999999999999px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>다루는 대상에 주소를 준다</span></div><div class="t" style="left:86.39999999999999px;top:326.4px;width:311.456px;height:96px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>장애, 복구 작업처럼 서비스가 다루는 대상 하나하나가 고유한 주소(URL)를 갖는다.</span></div><div class="r" style="left:86.39999999999999px;top:509.76px;width:311.456px;height:80.64000000000001px;background:#0A1322;border-radius:5.76px"></div><div class="t m" style="left:103.67999999999998px;top:509.76px;width:276.896px;height:80.64000000000001px;font-size:16px;color:#2DD4BF;text-align:left;justify-content:center;"><span>/incidents
|
||||
/incidents/inc-001</span></div><div class="r" style="left:455.456px;top:206.39999999999998px;width:369.05600000000004px;height:412.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:484.256px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>행위 (Method)</span></div><div class="t" style="left:484.256px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>할 일은 메서드로 말한다</span></div><div class="t" style="left:484.256px;top:326.4px;width:311.456px;height:96px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>같은 주소에 메서드만 바꿔 조회, 생성, 수정, 삭제를 구분한다.</span></div><div class="r" style="left:484.256px;top:509.76px;width:311.456px;height:80.64000000000001px;background:#0A1322;border-radius:5.76px"></div><div class="t m" style="left:501.53599999999994px;top:509.76px;width:276.896px;height:80.64000000000001px;font-size:16px;color:#2DD4BF;text-align:left;justify-content:center;"><span>GET · POST
|
||||
PATCH · DELETE</span></div><div class="r" style="left:853.3120000000001px;top:206.39999999999998px;width:369.05600000000004px;height:412.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:882.1120000000001px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>표현 (Representation)</span></div><div class="t" style="left:882.1120000000001px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>내용은 JSON에 담는다</span></div><div class="t" style="left:882.1120000000001px;top:326.4px;width:311.456px;height:96px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>자원의 현재 상태를 JSON 문서로 표현해 요청과 응답에 싣는다.</span></div><div class="r" style="left:882.1120000000001px;top:509.76px;width:311.456px;height:80.64000000000001px;background:#0A1322;border-radius:5.76px"></div><div class="t m" style="left:899.392px;top:509.76px;width:276.896px;height:80.64000000000001px;font-size:16px;color:#2DD4BF;text-align:left;justify-content:center;"><span>{"id": "inc-001",
|
||||
"status": "open"}</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>REST가 지키는 세 가지 원칙</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · API 설계 문서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>6</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>원칙을 지키면 처음 보는 API도 예측할 수 있고, 서버를 여러 대로 늘리기 쉽다</span></div><div class="r" style="left:57.599999999999994px;top:206.39999999999998px;width:369.05600000000004px;height:316.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>원칙 1</span></div><div class="t" style="left:86.39999999999999px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>클라이언트와 서버의 분리</span></div><div class="t" style="left:86.39999999999999px;top:326.4px;width:311.456px;height:168px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>화면은 API 규격만 알면 된다. 서버 내부가 바뀌어도 규격이 같으면 화면은 그대로 동작한다.</span></div><div class="r" style="left:455.456px;top:206.39999999999998px;width:369.05600000000004px;height:316.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:484.256px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>원칙 2</span></div><div class="t" style="left:484.256px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>무상태 (Stateless)</span></div><div class="t" style="left:484.256px;top:326.4px;width:311.456px;height:168px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>서버는 앞선 요청을 기억하지 않는다. 그래서 요청마다 토큰과 필요한 ID를 모두 실어 보낸다.</span></div><div class="r" style="left:853.3120000000001px;top:206.39999999999998px;width:369.05600000000004px;height:316.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:882.1120000000001px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>원칙 3</span></div><div class="t" style="left:882.1120000000001px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>일관된 인터페이스</span></div><div class="t" style="left:882.1120000000001px;top:326.4px;width:311.456px;height:168px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>모든 자원에 같은 주소 규칙, 같은 메서드 의미, 같은 오류 형식을 쓴다.</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>HTTP 요청과 응답은 세 부분으로 읽는다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · API 설계 문서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>7</span></div><div class="t ul" style="left:57.599999999999994px;top:172.8px;width:412.79999999999995px;height:441.59999999999997px;font-size:21.333333333333332px;color:#CBD5E1;text-align:left;justify-content:flex-start;--gap:18.666666666666668px;"><div class="li">시작줄: 요청은 메서드와 경로, 응답은 상태 코드</div><div class="li">헤더: 인증 토큰, 본문 형식 같은 부가 정보</div><div class="li">본문: 주고받는 데이터(JSON). GET 요청에는 보통 본문이 없다.</div><div class="li">API 설계 문서는 이 세 부분을 엔드포인트마다 적는 것이다.</div></div><div class="r" style="left:508.79999999999995px;top:168px;width:713.5680000000001px;height:401.28px;background:#0A1322;border-radius:9.600000000000001px"></div><div class="t m" style="left:537.5999999999999px;top:179.52px;width:655.9680000000001px;height:28.799999999999997px;font-size:16px;color:#A8B8CC;text-align:left;justify-content:center;"><span>요청과 응답의 구조</span></div><div class="t m" style="left:537.5999999999999px;top:216px;width:655.9680000000001px;height:343.67999999999995px;font-size:17.333333333333332px;color:#F1F5F9;text-align:left;justify-content:flex-start;"><span># 요청 ① 시작줄
|
||||
POST /api/v1/incidents/inc-001/recovery HTTP/1.1
|
||||
# 요청 ② 헤더
|
||||
Authorization: Bearer <JWT>
|
||||
Content-Type: application/json
|
||||
# 요청 ③ 본문
|
||||
{"action": "restart", "approval_id": "apr-001"}
|
||||
|
||||
# 응답 ① 시작줄
|
||||
HTTP/1.1 202 Accepted
|
||||
# 응답 ② 헤더
|
||||
Content-Type: application/json
|
||||
# 응답 ③ 본문
|
||||
{"job_id": "job-001", "status": "queued"}</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>메서드마다 의미와 성질이 정해져 있다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · API 설계 문서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>8</span></div><div class="r" style="left:57.599999999999994px;top:168px;width:1164.768px;height:48px;background:#22375A;border-radius:0px"></div><div class="t" style="left:78.72px;top:168px;width:120.82752000000002px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>메서드</span></div><div class="t" style="left:241.78752000000003px;top:168px;width:260.59968000000003px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>하는 일</span></div><div class="t" style="left:544.6272px;top:168px;width:167.41824000000003px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>안전 (조회만)</span></div><div class="t" style="left:754.28544px;top:168px;width:190.71360000000004px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>멱등</span></div><div class="t" style="left:987.2390400000002px;top:168px;width:214.00896000000006px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>성공 코드</span></div><div class="r" style="left:57.599999999999994px;top:216px;width:1164.768px;height:48px;background:#1A2B45;border-radius:0px"></div><div class="t m" style="left:78.72px;top:216px;width:120.82752000000002px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>GET</span></div><div class="t" style="left:241.78752000000003px;top:216px;width:260.59968000000003px;height:48px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>조회</span></div><div class="t" style="left:544.6272px;top:216px;width:167.41824000000003px;height:48px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>예</span></div><div class="t" style="left:754.28544px;top:216px;width:190.71360000000004px;height:48px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>예</span></div><div class="t" style="left:987.2390400000002px;top:216px;width:214.00896000000006px;height:48px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>200</span></div><div class="r" style="left:57.599999999999994px;top:264px;width:1164.768px;height:48px;background:#15233A;border-radius:0px"></div><div class="t m" style="left:78.72px;top:264px;width:120.82752000000002px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>POST</span></div><div class="t" style="left:241.78752000000003px;top:264px;width:260.59968000000003px;height:48px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>생성, 실행 요청</span></div><div class="t" style="left:544.6272px;top:264px;width:167.41824000000003px;height:48px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>아니오</span></div><div class="t" style="left:754.28544px;top:264px;width:190.71360000000004px;height:48px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>아니오</span></div><div class="t" style="left:987.2390400000002px;top:264px;width:214.00896000000006px;height:48px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>201 / 202</span></div><div class="r" style="left:57.599999999999994px;top:312px;width:1164.768px;height:48px;background:#1A2B45;border-radius:0px"></div><div class="t m" style="left:78.72px;top:312px;width:120.82752000000002px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>PUT</span></div><div class="t" style="left:241.78752000000003px;top:312px;width:260.59968000000003px;height:48px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>전체 교체</span></div><div class="t" style="left:544.6272px;top:312px;width:167.41824000000003px;height:48px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>Line truncated
|
||||
POST는 멱등이 아니므로, 복구 요청이 두 번 들어와도 한 번만 실행되게 하는 장치(중복 방지 키, 409 응답)를 설계에 넣는다.</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>상태 코드는 첫 자리로 읽는다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · API 설계 문서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>9</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>누구 쪽 문제인지가 첫 자리에 담겨 있다. 무조건 200으로 응답하고 본문에 오류를 넣지 않는다</span></div><div class="r" style="left:57.599999999999994px;top:206.39999999999998px;width:369.05600000000004px;height:412.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>2xx</span></div><div class="t" style="left:86.39999999999999px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>성공</span></div><div class="t" style="left:86.39999999999999px;top:326.4px;width:311.456px;height:96px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>요청을 정상 처리했다. 조회, 생성, 접수, 삭제에 따라 코드를 구분한다.</span></div><div class="r" style="left:86.39999999999999px;top:457.91999999999996px;width:311.456px;height:132.48000000000002px;background:#0A1322;border-radius:5.76px"></div><div class="t m" style="left:103.67999999999998px;top:457.91999999999996px;width:276.896px;height:132.48000000000002px;font-size:16px;color:#2DD4BF;text-align:left;justify-content:center;"><span>200 OK
|
||||
201 Created
|
||||
202 Accepted
|
||||
204 No Content</span></div><div class="r" style="left:455.456px;top:206.39999999999998px;width:369.05600000000004px;height:412.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:484.256px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>4xx</span></div><div class="t" style="left:484.256px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>요청 쪽 문제</span></div><div class="t" style="left:484.256px;top:326.4px;width:311.456px;height:96px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>보낸 쪽이 고쳐야 한다. 값, 인증, 권한, 대상, 충돌 중 무엇이 문제인지 알려준다.</span></div><div class="r" style="left:484.256px;top:483.8399999999999px;width:311.456px;height:106.56px;background:#0A1322;border-radius:5.76px"></div><div class="t m" style="left:501.53599999999994px;top:483.8399999999999px;width:276.896px;height:106.56px;font-size:16px;color:#2DD4BF;text-align:left;justify-content:center;"><span>400 · 422 잘못된 값
|
||||
401 인증 · 403 권한
|
||||
404 없음 · 409 충돌</span></div><div class="r" style="left:853.3120000000001px;top:206.39999999999998px;width:369.05600000000004px;height:412.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:882.1120000000001px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>5xx</span></div><div class="t" style="left:882.1120000000001px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>서버 쪽 문제</span></div><div class="t" style="left:882.1120000000001px;top:326.4px;width:311.456px;height:96px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>서버가 고쳐야 한다. 내부 오류 내용은 응답에 노출하지 않고 로그에 남긴다.</span></div><div class="r" style="left:882.1120000000001px;top:509.76px;width:311.456px;height:80.64000000000001px;background:#0A1322;border-radius:5.76px"></div><div class="t m" style="left:899.392px;top:509.76px;width:276.896px;height:80.64000000000001px;font-size:16px;color:#2DD4BF;text-align:left;justify-content:center;"><span>500 Internal Server Error
|
||||
503 Service Unavailable</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>RESTful하지 않은 주소를 고쳐 쓴다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · API 설계 문서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>10</span></div><div class="r" style="left:57.599999999999994px;top:168px;width:1164.768px;height:48px;background:#22375A;border-radius:0px"></div><div class="t" style="left:78.72px;top:168px;width:330.48576px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>이렇게 쓰지 않는다</span></div><div class="t" style="left:451.44576px;top:168px;width:307.1904px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>이렇게 쓴다</span></div><div class="t" style="left:800.87616px;top:168px;width:400.37184px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>이유</span></div><div class="r" style="left:57.599999999999994px;top:216px;width:1164.768px;height:48px;background:#1A2B45;border-radius:0px"></div><div class="t m" style="left:78.72px;top:216px;width:330.48576px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>GET /getIncidents</span></div><div class="t m" style="left:451.44576px;top:216px;width:307.1904px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>GET /incidents</span></div><div class="t" style="left:800.87616px;top:216px;width:400.37184px;height:48px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>동사는 메서드가 이미 말하고 있다</span></div><div class="r" style="left:57.599999999999994px;top:264px;width:1164.768px;height:48px;background:#15233A;border-radius:0px"></div><div class="t m" style="left:78.72px;top:264px;width:330.48576px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>GET /incident/list</span></div><div class="t m" style="left:451.44576px;top:264px;width:307.1904px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>GET /incidents</span></div><div class="t" style="left:800.87616px;top:264px;width:400.37184px;height:48px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>목록은 복수형 명사 하나로 충분하다</span></div><div class="r" style="left:57.599999999999994px;top:312px;width:1164.768px;height:48px;background:#1A2B45;border-radius:0px"></div><div class="t m" style="left:78.72px;top:312px;width:330.48576px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>POST /deleteIncident?id=1</span></div><div class="t m" style="left:451.44576px;top:312px;width:307.1904px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>DELETE /incidents/1</span></div><div class="t" style="left:800.87616px;top:312px;width:400.37184px;height:48px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>대상은 경로에, 행위는 메서드에 둔다</span></div><div class="r" style="left:57.599999999999994px;top:360px;width:1164.768px;height:48px;background:#15233A;border-radius:0px"></div><div class="t m" style="left:78.72px;top:360px;width:330.48576px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>GET /incidents/1/delete</span></div><div class="t m" style="left:451.44576px;top:360px;width:307.1904px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>DELETE /incidents/1</span></div><div class="t" style="left:800.87616px;top:360px;width:400.37184px;height:48px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>GET은 조회만 한다. 데이터를 바꾸지 않는다</span></div><div class="r" style="left:57.599999999999994px;top:408px;width:1164.768px;height:48px;background:#1A2B45;border-radius:0px"></div><div class="t m" style="left:78.72px;top:408px;width:330.48576px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>/Recovery_Jobs</span></div><div class="t m" style="left:451.44576px;top:408px;width:307.1904px;height:48px;Line truncated
|
||||
이때는 POST와 하위 경로(/incidents/{id}/diagnose)로 표현하는 것이 실무 관례다.</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>목록 조회는 필터·정렬·페이지를 쿼리로 받는다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · API 설계 문서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>11</span></div><div class="t ul" style="left:57.599999999999994px;top:172.8px;width:412.79999999999995px;height:441.59999999999997px;font-size:21.333333333333332px;color:#CBD5E1;text-align:left;justify-content:flex-start;--gap:18.666666666666668px;"><div class="li">경로는 자원을 가리키고, 조건은 ? 뒤 쿼리 파라미터로 붙인다.</div><div class="li">요구사항 FR-01의 "상태·발생시간·자산명으로 필터링"이 곧 쿼리 파라미터 목록이다.</div><div class="li">응답에는 목록과 함께 전체 건수, 현재 페이지를 담는다.</div><div class="li">파라미터 이름과 기본값은 팀에서 정해 문서에 적는다.</div></div><div class="r" style="left:508.79999999999995px;top:168px;width:713.5680000000001px;height:401.28px;background:#0A1322;border-radius:9.600000000000001px"></div><div class="t m" style="left:537.5999999999999px;top:179.52px;width:655.9680000000001px;height:28.799999999999997px;font-size:16px;color:#A8B8CC;text-align:left;justify-content:center;"><span>GET /api/v1/incidents (형식 예시)</span></div><div class="t m" style="left:537.5999999999999px;top:216px;width:655.9680000000001px;height:343.67999999999995px;font-size:17.333333333333332px;color:#F1F5F9;text-align:left;justify-content:flex-start;"><span>GET /api/v1/incidents?status=open&asset=svc-api-01
|
||||
&sort=-created_at&page=1&size=20
|
||||
Authorization: Bearer <JWT>
|
||||
|
||||
HTTP/1.1 200 OK
|
||||
{
|
||||
"items": [
|
||||
{"id": "inc-001", "status": "open",
|
||||
"asset": "svc-api-01"}
|
||||
],
|
||||
"total": 37,
|
||||
"page": 1,
|
||||
"size": 20
|
||||
}</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>요구사항에서 API를 뽑아낸다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · API 설계 문서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>12</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>요구사항 한 줄마다 "무엇을, 어떻게 하는가"를 물으면 엔드포인트가 나온다</span></div><div class="r" style="left:57.599999999999994px;top:206.39999999999998px;width:1164.768px;height:48px;background:#22375A;border-radius:0px"></div><div class="t" style="left:78.72px;top:206.39999999999998px;width:237.30432000000002px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>요구사항</span></div><div class="t" style="left:358.26432000000005px;top:206.39999999999998px;width:190.71360000000004px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>다루는 대상</span></div><div class="t" style="left:591.21792px;top:206.39999999999998px;width:109.17984000000001px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>행위</span></div><div class="t" style="left:742.63776px;top:206.39999999999998px;width:458.61024px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>엔드포인트</span></div><div class="r" style="left:57.599999999999994px;top:254.39999999999998px;width:1164.768px;height:59.519999999999996px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:254.39999999999998px;width:237.30432000000002px;height:59.519999999999996px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>FR-01 장애 목록 조회</span></div><div class="t" style="left:358.26432000000005px;top:254.39999999999998px;width:190.71360000000004px;height:59.519999999999996px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>incidents</span></div><div class="t" style="left:591.21792px;top:254.39999999999998px;width:109.17984000000001px;height:59.519999999999996px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>조회</span></div><div class="t m" style="left:742.63776px;top:254.39999999999998px;width:458.61024px;height:59.519999999999996px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>GET /api/v1/incidents</span></div><div class="r" style="left:57.599999999999994px;top:313.92px;width:1164.768px;height:59.519999999999996px;background:#15233A;border-radius:0px"></div><div class="t" style="left:78.72px;top:313.92px;width:237.30432000000002px;height:59.519999999999996px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>FR-02 AI 원인 진단</span></div><div class="t" style="left:358.26432000000005px;top:313.92px;width:190.71360000000004px;height:59.519999999999996px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>incidents의 진단</span></div><div class="t" style="left:591.21792px;top:313.92px;width:109.17984000000001px;height:59.519999999999996px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>실행 요청</span></div><div class="t m" style="left:742.63776px;top:313.92px;width:458.61024px;height:59.519999999999996px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>POST /api/v1/incidents/{id}/diagnose</span></div><div class="r" style="left:57.599999999999994px;top:373.44px;width:1164.768px;height:59.519999999999996px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:373.44px;width:237.30432000000002px;height:59.519999999999996px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>FR-03 복구 작업 승인</span></div><div class="t" style="left:358.26432000000005px;top:373.44px;width:190.71360000000004px;height:59.519999999999996px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>incidents의 복구</spanLine truncated
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>주소와 메서드를 정하는 규칙</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · API 설계 문서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>13</span></div><div class="r" style="left:57.599999999999994px;top:168px;width:567.984px;height:225.60000000000002px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:196.79999999999998px;width:510.384px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>주소는 명사, 복수형으로</span></div><div class="t" style="left:86.39999999999999px;top:249.59999999999997px;width:510.384px;height:38.400000000000006px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>동사는 주소에 넣지 않고 메서드에 담는다.</span></div><div class="r" style="left:86.39999999999999px;top:310.0799999999999px;width:510.384px;height:54.720000000000006px;background:#0A1322;border-radius:5.76px"></div><div class="t m" style="left:103.67999999999998px;top:310.0799999999999px;width:475.824px;height:54.720000000000006px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>/incidents /recovery-jobs</span></div><div class="r" style="left:654.384px;top:168px;width:567.984px;height:225.60000000000002px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:683.184px;top:196.79999999999998px;width:510.384px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>메서드가 곧 행위다</span></div><div class="t" style="left:683.184px;top:249.59999999999997px;width:510.384px;height:38.400000000000006px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>GET 조회, POST 생성·실행, PATCH 수정, DELETE 삭제</span></div><div class="r" style="left:683.184px;top:310.0799999999999px;width:510.384px;height:54.720000000000006px;background:#0A1322;border-radius:5.76px"></div><div class="t m" style="left:700.4639999999999px;top:310.0799999999999px;width:475.824px;height:54.720000000000006px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>GET · POST · PATCH · DELETE</span></div><div class="r" style="left:57.599999999999994px;top:422.40000000000003px;width:567.984px;height:225.60000000000002px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:451.20000000000005px;width:510.384px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>버전을 앞에 붙인다</span></div><div class="t" style="left:86.39999999999999px;top:504px;width:510.384px;height:38.400000000000006px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>나중에 규격을 바꿔도 기존 화면이 깨지지 않는다.</span></div><div class="r" style="left:86.39999999999999px;top:564.48px;width:510.384px;height:54.720000000000006px;background:#0A1322;border-radius:5.76px"></div><div class="t m" style="left:103.67999999999998px;top:564.48px;width:475.824px;height:54.720000000000006px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>/api/v1/…</span></div><div class="r" style="left:654.384px;top:422.40000000000003px;width:567.984px;height:225.60000000000002px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:683.184px;top:451.20000000000005px;width:510.384px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>포함 관계는 경로로 표현한다</span></div><div class="t" style="left:683.184px;top:504px;width:510.384px;height:38.400000000000006px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>특정 장애에 대한 복구 요청은 그 장애 아래에 둔다.</span></div><div class="r" style="left:683.184px;top:564.48px;width:510.384px;height:54.720000000000006px;background:#0A1322;border-radius:5.76px"></div><div class="t m" style="left:700.4639999999999px;top:564.48px;width:475.824px;height:54.720000000000006px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>/incidents/{id}/recovery</span></div></seLine truncated
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>인증 방식은 네 줄로 적는다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · API 설계 문서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>14</span></div><div class="r" style="left:57.599999999999994px;top:168px;width:1164.768px;height:48px;background:#22375A;border-radius:0px"></div><div class="t" style="left:78.72px;top:168px;width:97.53216000000002px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>항목</span></div><div class="t" style="left:218.49216000000004px;top:168px;width:342.13344px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>적을 내용</span></div><div class="t" style="left:602.8656000000001px;top:168px;width:598.3824000000001px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>예시</span></div><div class="r" style="left:57.599999999999994px;top:216px;width:1164.768px;height:76.80000000000001px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:216px;width:97.53216000000002px;height:76.80000000000001px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>인증</span></div><div class="t" style="left:218.49216000000004px;top:216px;width:342.13344px;height:76.80000000000001px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>토큰을 어디서 발급받는가</span></div><div class="t" style="left:602.8656000000001px;top:216px;width:598.3824000000001px;height:76.80000000000001px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>Supabase Auth 로그인 → JWT Access Token 발급</span></div><div class="r" style="left:57.599999999999994px;top:292.79999999999995px;width:1164.768px;height:76.80000000000001px;background:#15233A;border-radius:0px"></div><div class="t" style="left:78.72px;top:292.79999999999995px;width:97.53216000000002px;height:76.80000000000001px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>전달</span></div><div class="t" style="left:218.49216000000004px;top:292.79999999999995px;width:342.13344px;height:76.80000000000001px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>요청에 토큰을 어떻게 싣는가</span></div><div class="t" style="left:602.8656000000001px;top:292.79999999999995px;width:598.3824000000001px;height:76.80000000000001px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>Authorization: Bearer <access_token></span></div><div class="r" style="left:57.599999999999994px;top:369.59999999999997px;width:1164.768px;height:76.80000000000001px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:369.59999999999997px;width:97.53216000000002px;height:76.80000000000001px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>검증</span></div><div class="t" style="left:218.49216000000004px;top:369.59999999999997px;width:342.13344px;height:76.80000000000001px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>서버가 무엇을 확인하는가</span></div><div class="t" style="left:602.8656000000001px;top:369.59999999999997px;width:598.3824000000001px;height:76.80000000000001px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>서명·만료·역할 (복구 실행은 operator/admin만 허용)</span></div><div class="r" style="left:57.599999999999994px;top:446.4px;width:1164.768px;height:76.80000000000001px;background:#15233A;border-radius:0px"></div><div class="t" style="left:78.72px;top:446.4px;width:97.53216000000002px;height:76.80000000000001px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>오류</span></div><div class="t" style="left:218.49216000000004px;top:446.4px;width:342.13344px;height:76.80000000000001px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>실패하면 무엇을 돌려주는가</span></div><div class="t" style="left:602.8656000000001px;top:446.4px;width:598.3824000000001px;heigLine truncated
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>API 목록 표로 전체를 한 장에 담는다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · API 설계 문서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>15</span></div><div class="r" style="left:57.599999999999994px;top:168px;width:1164.768px;height:48px;background:#22375A;border-radius:0px"></div><div class="t" style="left:78.72px;top:168px;width:74.23680000000003px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>메서드</span></div><div class="t" style="left:195.19680000000005px;top:168px;width:388.72416px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>경로</span></div><div class="t" style="left:626.1609599999999px;top:168px;width:132.4752px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>인증</span></div><div class="t" style="left:800.87616px;top:168px;width:214.00896000000006px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>설명</span></div><div class="t" style="left:1057.1251200000002px;top:168px;width:144.12288px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>관련 요구사항</span></div><div class="r" style="left:57.599999999999994px;top:216px;width:1164.768px;height:76.80000000000001px;background:#1A2B45;border-radius:0px"></div><div class="t m" style="left:78.72px;top:216px;width:74.23680000000003px;height:76.80000000000001px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>GET</span></div><div class="t m" style="left:195.19680000000005px;top:216px;width:388.72416px;height:76.80000000000001px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>/api/v1/incidents</span></div><div class="t" style="left:626.1609599999999px;top:216px;width:132.4752px;height:76.80000000000001px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>JWT</span></div><div class="t" style="left:800.87616px;top:216px;width:214.00896000000006px;height:76.80000000000001px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>장애 목록 조회</span></div><div class="t" style="left:1057.1251200000002px;top:216px;width:144.12288px;height:76.80000000000001px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>FR-01</span></div><div class="r" style="left:57.599999999999994px;top:292.79999999999995px;width:1164.768px;height:76.80000000000001px;background:#15233A;border-radius:0px"></div><div class="t m" style="left:78.72px;top:292.79999999999995px;width:74.23680000000003px;height:76.80000000000001px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>POST</span></div><div class="t m" style="left:195.19680000000005px;top:292.79999999999995px;width:388.72416px;height:76.80000000000001px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>/api/v1/incidents/{id}/diagnose</span></div><div class="t" style="left:626.1609599999999px;top:292.79999999999995px;width:132.4752px;height:76.80000000000001px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>JWT</span></div><div class="t" style="left:800.87616px;top:292.79999999999995px;width:214.00896000000006px;height:76.80000000000001px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>AI 진단 실행</span></div><div class="t" style="left:1057.1251200000002px;top:292.79999999999995px;width:144.12288px;height:76.80000000000001px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>FR-02</span></div><div class="r" style="left:57.599999999999994px;top:369.59999999999997px;width:1164.768px;height:76.80000000000001px;background:#1A2B45;border-radius:0px"></div><div class="t m" style="left:78.72px;top:369.59999999999997px;width:74.23680000000003px;height:76.80000000000001px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>POST</span></div><div class="t m" style="left:195.19680000000005px;top:369.59999999999997px;width:388.72416px;Line truncated
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>상세 명세는 여덟 칸을 채운다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · API 설계 문서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>16</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>핵심 엔드포인트마다 표 하나. 빈칸이 남아 있으면 설계가 아직 끝나지 않은 것이다</span></div><div class="r" style="left:57.599999999999994px;top:206.39999999999998px;width:269.592px;height:206.39999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:235.2px;width:211.99200000000002px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>1</span></div><div class="t" style="left:86.39999999999999px;top:273.59999999999997px;width:211.99200000000002px;height:40.32px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>호출 목적</span></div><div class="t" style="left:86.39999999999999px;top:326.4px;width:211.99200000000002px;height:57.60000000000005px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>누가, 언제, 왜 부르는가</span></div><div class="r" style="left:355.992px;top:206.39999999999998px;width:269.592px;height:206.39999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:384.79200000000003px;top:235.2px;width:211.99200000000002px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>2</span></div><div class="t" style="left:384.79200000000003px;top:273.59999999999997px;width:211.99200000000002px;height:40.32px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>요청 헤더</span></div><div class="t" style="left:384.79200000000003px;top:326.4px;width:211.99200000000002px;height:57.60000000000005px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>Authorization, X-Request-ID 등</span></div><div class="r" style="left:654.384px;top:206.39999999999998px;width:269.592px;height:206.39999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:683.184px;top:235.2px;width:211.99200000000002px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>3</span></div><div class="t" style="left:683.184px;top:273.59999999999997px;width:211.99200000000002px;height:40.32px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>경로·쿼리</span></div><div class="t" style="left:683.184px;top:326.4px;width:211.99200000000002px;height:57.60000000000005px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>이름, 타입, 필수 여부, 기본값</span></div><div class="r" style="left:952.776px;top:206.39999999999998px;width:269.592px;height:206.39999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:981.576px;top:235.2px;width:211.99200000000002px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>4</span></div><div class="t" style="left:981.576px;top:273.59999999999997px;width:211.99200000000002px;height:40.32px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>요청 본문</span></div><div class="t" style="left:981.576px;top:326.4px;width:211.99200000000002px;height:57.60000000000005px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>실제 값이 들어간 JSON</span></div><div class="r" style="left:57.599999999999994px;top:441.59999999999997px;width:269.592px;height:206.39999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:470.4px;width:211.99200000000002px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>5</span></div><div class="t" style="left:86.39999999999999px;top:508.79999999999995px;width:211.992Line truncated
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>예시: 복구 요청 API의 요청과 응답</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · API 설계 문서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>17</span></div><div class="t ul" style="left:57.599999999999994px;top:172.8px;width:412.79999999999995px;height:441.59999999999997px;font-size:21.333333333333332px;color:#CBD5E1;text-align:left;justify-content:flex-start;--gap:18.666666666666668px;"><div class="li">202는 "접수했고 처리 중"이라는 뜻이다. 오래 걸리는 작업에 쓴다.</div><div class="li">응답의 job_id로 진행 상태를 따로 조회한다.</div><div class="li">예시값은 다른 산출물과 같은 ID를 쓴다. (inc-001, apr-001, req-001)</div></div><div class="r" style="left:508.79999999999995px;top:168px;width:713.5680000000001px;height:471.84000000000003px;background:#0A1322;border-radius:9.600000000000001px"></div><div class="t m" style="left:537.5999999999999px;top:179.52px;width:655.9680000000001px;height:28.799999999999997px;font-size:16px;color:#A8B8CC;text-align:left;justify-content:center;"><span>POST /api/v1/incidents/{incident_id}/recovery</span></div><div class="t m" style="left:537.5999999999999px;top:216px;width:655.9680000000001px;height:414.24px;font-size:17.333333333333332px;color:#F1F5F9;text-align:left;justify-content:flex-start;"><span>POST /api/v1/incidents/inc-001/recovery
|
||||
Authorization: Bearer <JWT>
|
||||
Content-Type: application/json
|
||||
X-Request-ID: req-001
|
||||
|
||||
{
|
||||
"action": "restart",
|
||||
"target_id": "svc-api-01",
|
||||
"approval_id": "apr-001"
|
||||
}
|
||||
|
||||
HTTP 202
|
||||
{
|
||||
"job_id": "job-001",
|
||||
"status": "queued",
|
||||
"incident_id": "inc-001"
|
||||
}</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>오류 응답도 설계의 일부다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · API 설계 문서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>18</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>정상 응답만 적은 문서는 절반짜리다. 실패 조건과 오류 코드를 표로 만든다</span></div><div class="r" style="left:57.599999999999994px;top:206.39999999999998px;width:1164.768px;height:48px;background:#22375A;border-radius:0px"></div><div class="t" style="left:78.72px;top:206.39999999999998px;width:144.12288px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>상태 코드</span></div><div class="t" style="left:265.08288000000005px;top:206.39999999999998px;width:493.55328000000003px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>발생 조건</span></div><div class="t" style="left:800.87616px;top:206.39999999999998px;width:400.37184px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>오류 코드(예시)</span></div><div class="r" style="left:57.599999999999994px;top:254.39999999999998px;width:1164.768px;height:48px;background:#1A2B45;border-radius:0px"></div><div class="t m" style="left:78.72px;top:254.39999999999998px;width:144.12288px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>400</span></div><div class="t" style="left:265.08288000000005px;top:254.39999999999998px;width:493.55328000000003px;height:48px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>허용되지 않는 값</span></div><div class="t m" style="left:800.87616px;top:254.39999999999998px;width:400.37184px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>INVALID_ACTION</span></div><div class="r" style="left:57.599999999999994px;top:302.4px;width:1164.768px;height:48px;background:#15233A;border-radius:0px"></div><div class="t m" style="left:78.72px;top:302.4px;width:144.12288px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>401</span></div><div class="t" style="left:265.08288000000005px;top:302.4px;width:493.55328000000003px;height:48px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>토큰 누락·만료</span></div><div class="t m" style="left:800.87616px;top:302.4px;width:400.37184px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>UNAUTHORIZED</span></div><div class="r" style="left:57.599999999999994px;top:350.4px;width:1164.768px;height:48px;background:#1A2B45;border-radius:0px"></div><div class="t m" style="left:78.72px;top:350.4px;width:144.12288px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>403</span></div><div class="t" style="left:265.08288000000005px;top:350.4px;width:493.55328000000003px;height:48px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>권한 또는 승인 없음</span></div><div class="t m" style="left:800.87616px;top:350.4px;width:400.37184px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>APPROVAL_REQUIRED</span></div><div class="r" style="left:57.599999999999994px;top:398.40000000000003px;width:1164.768px;height:48px;background:#15233A;border-radius:0px"></div><div class="t m" style="left:78.72px;top:398.40000000000003px;width:144.12288px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>404</span></div><div class="t" style="left:265.08288000000005px;top:398.40000000000003px;width:493.55328000000003px;height:48px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>장애 ID 없음</span></div><div class="t m" style="left:800.87616px;top:398.40000000000003px;width:400.37184px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>INCIDENT_NOT_FOUND</span></div><div cLine truncated
|
||||
FastAPI는 입력 검증 실패를 기본 422로 돌려준다. 400과 422 중 무엇을 쓸지 팀에서 정해 문서에 적는다.</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>입력 검증은 Pydantic 모델로 적는다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · API 설계 문서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>19</span></div><div class="t ul" style="left:57.599999999999994px;top:172.8px;width:412.79999999999995px;height:441.59999999999997px;font-size:21.333333333333332px;color:#CBD5E1;text-align:left;justify-content:flex-start;--gap:18.666666666666668px;"><div class="li">Literal: 허용하는 값의 목록</div><div class="li">Field: 길이와 범위 제한</div><div class="li">model_validator: 여러 필드가 얽힌 조건. 위험한 작업이면 승인 ID가 필수</div><div class="li">문서의 검증 규칙과 코드의 모델은 같아야 한다.</div></div><div class="r" style="left:508.79999999999995px;top:168px;width:713.5680000000001px;height:424.79999999999995px;background:#0A1322;border-radius:9.600000000000001px"></div><div class="t m" style="left:537.5999999999999px;top:179.52px;width:655.9680000000001px;height:28.799999999999997px;font-size:16px;color:#A8B8CC;text-align:left;justify-content:center;"><span>schemas.py</span></div><div class="t m" style="left:537.5999999999999px;top:216px;width:655.9680000000001px;height:367.2px;font-size:17.333333333333332px;color:#F1F5F9;text-align:left;justify-content:flex-start;"><span>from typing import Literal
|
||||
from pydantic import BaseModel, Field, model_validator
|
||||
|
||||
RISKY = {"restart"}
|
||||
|
||||
class RecoveryRequest(BaseModel):
|
||||
action: Literal["restart", "reconnect", "fallback"]
|
||||
target_id: str = Field(min_length=1, max_length=64)
|
||||
approval_id: str | None = None
|
||||
|
||||
@model_validator(mode="after")
|
||||
def need_approval(self):
|
||||
if self.action in RISKY and not self.approval_id:
|
||||
raise ValueError("APPROVAL_REQUIRED")
|
||||
return self</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>REST API와 Tool은 호출하는 주체가 다르다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · API 설계 문서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>20</span></div><div class="r" style="left:57.599999999999994px;top:168px;width:1164.768px;height:48px;background:#22375A;border-radius:0px"></div><div class="t" style="left:78.72px;top:168px;width:190.71360000000004px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>구분</span></div><div class="t" style="left:311.6736000000001px;top:168px;width:400.37184px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>REST API</span></div><div class="t" style="left:754.28544px;top:168px;width:446.96255999999994px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>Tool (Function Calling)</span></div><div class="r" style="left:57.599999999999994px;top:216px;width:1164.768px;height:76.80000000000001px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:216px;width:190.71360000000004px;height:76.80000000000001px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>호출 주체</span></div><div class="t" style="left:311.6736000000001px;top:216px;width:400.37184px;height:76.80000000000001px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>화면(프런트엔드), 외부 시스템</span></div><div class="t" style="left:754.28544px;top:216px;width:446.96255999999994px;height:76.80000000000001px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>에이전트(LLM)</span></div><div class="r" style="left:57.599999999999994px;top:292.79999999999995px;width:1164.768px;height:76.80000000000001px;background:#15233A;border-radius:0px"></div><div class="t" style="left:78.72px;top:292.79999999999995px;width:190.71360000000004px;height:76.80000000000001px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>호출 방법</span></div><div class="t" style="left:311.6736000000001px;top:292.79999999999995px;width:400.37184px;height:76.80000000000001px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>HTTP 메서드 + 경로</span></div><div class="t" style="left:754.28544px;top:292.79999999999995px;width:446.96255999999994px;height:76.80000000000001px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>Tool 이름 + JSON 인자</span></div><div class="r" style="left:57.599999999999994px;top:369.59999999999997px;width:1164.768px;height:76.80000000000001px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:369.59999999999997px;width:190.71360000000004px;height:76.80000000000001px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>권한 확인</span></div><div class="t" style="left:311.6736000000001px;top:369.59999999999997px;width:400.37184px;height:76.80000000000001px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>JWT에 담긴 사용자 역할</span></div><div class="t" style="left:754.28544px;top:369.59999999999997px;width:446.96255999999994px;height:76.80000000000001px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>에이전트별 허용 Tool 목록</span></div><div class="r" style="left:57.599999999999994px;top:446.4px;width:1164.768px;height:76.80000000000001px;background:#15233A;border-radius:0px"></div><div class="t" style="left:78.72px;top:446.4px;width:190.71360000000004px;height:76.80000000000001px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>문서에 적는 것</span></div><div class="t" style="left:311.6736000000001px;top:446.4px;width:400.37184px;height:76.80000000000001px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>요청·응답·상태 코드</span></div><div class="t" style="left:754.28544px;top:446.4px;width:446.96255999999994px;height:76.80000000000001px;font-size:18.666666666666668px;color:#CBD5E1;text-align:lLine truncated
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>Tool 정의는 에이전트가 읽는 명세다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · API 설계 문서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>21</span></div><div class="t ul" style="left:57.599999999999994px;top:172.8px;width:412.79999999999995px;height:441.59999999999997px;font-size:21.333333333333332px;color:#CBD5E1;text-align:left;justify-content:flex-start;--gap:18.666666666666668px;"><div class="li">이름은 동사_명사: restart_service</div><div class="li">호출 주체와 권한: RecoveryAgent, recovery.execute</div><div class="li">실행 조건: 운영자 승인을 확인한 뒤</div><div class="li">출력과 실패 코드: job_id, status / TOOL_TIMEOUT, TARGET_NOT_FOUND, APPROVAL_REQUIRED</div><div class="li">description은 LLM이 언제 쓸지 판단하는 근거다. 구체적으로 쓴다.</div></div><div class="r" style="left:508.79999999999995px;top:168px;width:713.5680000000001px;height:377.76px;background:#0A1322;border-radius:9.600000000000001px"></div><div class="t m" style="left:537.5999999999999px;top:179.52px;width:655.9680000000001px;height:28.799999999999997px;font-size:16px;color:#A8B8CC;text-align:left;justify-content:center;"><span>Tool 입력 스키마</span></div><div class="t m" style="left:537.5999999999999px;top:216px;width:655.9680000000001px;height:320.15999999999997px;font-size:17.333333333333332px;color:#F1F5F9;text-align:left;justify-content:flex-start;"><span>{
|
||||
"name": "restart_service",
|
||||
"description": "승인된 대상 서비스를 재시작한다",
|
||||
"parameters": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"target_id": {"type": "string"},
|
||||
"approval_id": {"type": "string"},
|
||||
"request_id": {"type": "string"}
|
||||
},
|
||||
"required": ["target_id", "approval_id", "request_id"]
|
||||
}
|
||||
}</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>Tool 호출 흐름을 한 줄로 그린다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · API 설계 문서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>22</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>요청 하나가 어떤 순서로 에이전트와 Tool을 거치는지 문서에 남긴다</span></div><div class="r" style="left:57.599999999999994px;top:240px;width:160.52800000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:72px;top:268.79999999999995px;width:131.728px;height:48px;font-size:21.333333333333332px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>API 요청</span></div><div class="t" style="left:72px;top:331.20000000000005px;width:131.728px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>인증과
|
||||
입력 검증</span></div><div class="t" style="left:218.128px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:258.44800000000004px;top:240px;width:160.52800000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:272.848px;top:268.79999999999995px;width:131.728px;height:48px;font-size:21.333333333333332px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>Supervisor</span></div><div class="t" style="left:272.848px;top:331.20000000000005px;width:131.728px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>작업 분배</span></div><div class="t" style="left:418.976px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:459.29600000000005px;top:240px;width:160.52800000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:473.696px;top:268.79999999999995px;width:131.728px;height:76.80000000000001px;font-size:21.333333333333332px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>Diagnosis
|
||||
Agent</span></div><div class="t" style="left:473.696px;top:355.20000000000005px;width:131.728px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>원인 진단</span></div><div class="t" style="left:619.8240000000001px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:660.144px;top:240px;width:160.52800000000002px;height:220.79999999999998px;background:#0F766E;border-radius:9.600000000000001px"></div><div class="t" style="left:674.5440000000001px;top:268.79999999999995px;width:131.728px;height:48px;font-size:21.333333333333332px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>승인 확인</span></div><div class="t m" style="left:674.5440000000001px;top:331.20000000000005px;width:131.728px;height:86.4px;font-size:18.666666666666668px;color:#F1F5F9;text-align:center;justify-content:flex-start;"><span>approval_id
|
||||
검사</span></div><div class="t" style="left:820.672px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:860.9920000000001px;top:240px;width:160.52800000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:875.392px;top:268.79999999999995px;width:131.728px;height:76.80000000000001px;font-size:21.333333333333332px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>Recovery
|
||||
Agent</span></div><div class="t" style="left:875.392px;top:355.20000000000005px;width:131.728px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>복구 Tool
|
||||
호출</span></div><div class="t" style="left:1021.5200000000002px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:1061.8400000000001px;top:240px;width:160.52800000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:1076.2400000000002px;top:268.79999999999995px;width:131.728px;height:76.80000000000001px;font-size:21.333333333333332px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>Verification
|
||||
Agent</span></div><div class="t" style="left:1076.2400000000002px;top:355.20000000000005px;width:131.728px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>정상화 확인,
|
||||
상태 기록</span></div><div class="r" style="left:57.599999999999994px;top:513.5999999999999px;width:1164.768px;height:71.03999999999999px;background:#0A1322;border-radius:7.68px"></div><div class="t" style="left:86.39999999999999px;top:513.5999999999999px;width:1107.1680000000001px;height:71.03999999999999px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>API의 X-Request-ID와 Tool의 request_id를 같은 값으로 이어 두면, 로그에서 요청 전체를 한 번에 추적할 수 있다.</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>오래 걸리는 작업은 접수와 조회로 나눈다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · API 설계 문서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>23</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>에이전트 실행은 몇 초에서 몇 분이 걸린다. 응답을 붙잡고 기다리게 하지 않는다</span></div><div class="r" style="left:57.599999999999994px;top:206.39999999999998px;width:369.05600000000004px;height:412.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>① 접수</span></div><div class="t" style="left:86.39999999999999px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>바로 202를 돌려준다</span></div><div class="t" style="left:86.39999999999999px;top:326.4px;width:311.456px;height:96px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>작업을 대기열에 넣고 job_id를 즉시 반환한다.</span></div><div class="r" style="left:86.39999999999999px;top:509.76px;width:311.456px;height:80.64000000000001px;background:#0A1322;border-radius:5.76px"></div><div class="t m" style="left:103.67999999999998px;top:509.76px;width:276.896px;height:80.64000000000001px;font-size:16px;color:#2DD4BF;text-align:left;justify-content:center;"><span>POST …/recovery
|
||||
→ 202 {"job_id": "job-001"}</span></div><div class="r" style="left:455.456px;top:206.39999999999998px;width:369.05600000000004px;height:412.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:484.256px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>② 조회</span></div><div class="t" style="left:484.256px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>상태를 따로 묻는다</span></div><div class="t" style="left:484.256px;top:326.4px;width:311.456px;height:96px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>가능한 상태 값의 목록을 문서에 적어 둔다.</span></div><div class="r" style="left:484.256px;top:509.76px;width:311.456px;height:80.64000000000001px;background:#0A1322;border-radius:5.76px"></div><div class="t m" style="left:501.53599999999994px;top:509.76px;width:276.896px;height:80.64000000000001px;font-size:16px;color:#2DD4BF;text-align:left;justify-content:center;"><span>GET /recovery-jobs/{id}
|
||||
→ {"status": "queued"}</span></div><div class="r" style="left:853.3120000000001px;top:206.39999999999998px;width:369.05600000000004px;height:412.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:882.1120000000001px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>③ 스트리밍</span></div><div class="t" style="left:882.1120000000001px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>진행 상황을 흘려보낸다</span></div><div class="t" style="left:882.1120000000001px;top:326.4px;width:311.456px;height:96px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>STEP 5의 실시간 화면에서 쓴다. 이벤트 종류를 명세한다.</span></div><div class="r" style="left:882.1120000000001px;top:509.76px;width:311.456px;height:80.64000000000001px;background:#0A1322;border-radius:5.76px"></div><div class="t m" style="left:899.392px;top:509.76px;width:276.896px;height:80.64000000000001px;font-size:16px;color:#2DD4BF;text-align:left;justify-content:center;"><span>POST /api/v1/chat/stream
|
||||
→ text/event-stream</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>다른 산출물과 같은 이름을 쓴다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · API 설계 문서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>24</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>문서마다 이름이 다르면 설계·구현·검증의 연결을 보여줄 수 없다</span></div><div class="r" style="left:57.599999999999994px;top:206.39999999999998px;width:567.984px;height:206.39999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:235.2px;width:510.384px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>기획서</span></div><div class="t" style="left:86.39999999999999px;top:273.59999999999997px;width:510.384px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>요구사항 ID를 연결한다</span></div><div class="t" style="left:86.39999999999999px;top:326.4px;width:510.384px;height:57.60000000000005px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>API마다 FR-01 같은 요구사항 번호를 붙인다.</span></div><div class="r" style="left:654.384px;top:206.39999999999998px;width:567.984px;height:206.39999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:683.184px;top:235.2px;width:510.384px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>DB 스키마 설계서</span></div><div class="t" style="left:683.184px;top:273.59999999999997px;width:510.384px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>필드명과 컬럼명을 맞춘다</span></div><div class="t" style="left:683.184px;top:326.4px;width:510.384px;height:57.60000000000005px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>incident_id, approval_id를 두 문서에서 똑같이 쓴다.</span></div><div class="r" style="left:57.599999999999994px;top:441.59999999999997px;width:567.984px;height:206.39999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:470.4px;width:510.384px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>AI 보안 가드레일 문서</span></div><div class="t" style="left:86.39999999999999px;top:508.79999999999995px;width:510.384px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>권한 규칙이 일치한다</span></div><div class="t" style="left:86.39999999999999px;top:561.5999999999999px;width:510.384px;height:57.60000000000005px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>역할별·Tool별 권한표와 인증 규칙이 서로 같아야 한다.</span></div><div class="r" style="left:654.384px;top:441.59999999999997px;width:567.984px;height:206.39999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:683.184px;top:470.4px;width:510.384px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>통합 테스트 결과서</span></div><div class="t" style="left:683.184px;top:508.79999999999995px;width:510.384px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>오류 표가 테스트가 된다</span></div><div class="t" style="left:683.184px;top:561.5999999999999px;width:510.384px;height:57.60000000000005px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>"승인 없는 요청 → 403" 한 줄이 테스트 케이스 하나다.</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>자주 나오는 실수와 고치는 법</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · API 설계 문서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>25</span></div><div class="r" style="left:57.599999999999994px;top:168px;width:1164.768px;height:48px;background:#22375A;border-radius:0px"></div><div class="t" style="left:78.72px;top:168px;width:540.144px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>실수</span></div><div class="t" style="left:661.104px;top:168px;width:540.144px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>이렇게 고친다</span></div><div class="r" style="left:57.599999999999994px;top:216px;width:1164.768px;height:74.88px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:216px;width:540.144px;height:74.88px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>같은 API인데 문서 안에서 경로나 필드명이 다르다
|
||||
(/recover 와 /recovery, action 과 strategy)</span></div><div class="t" style="left:661.104px;top:216px;width:540.144px;height:74.88px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>API 목록 표를 기준으로 삼고 상세 명세를 거기에 맞춘다</span></div><div class="r" style="left:57.599999999999994px;top:290.88px;width:1164.768px;height:74.88px;background:#15233A;border-radius:0px"></div><div class="t" style="left:78.72px;top:290.88px;width:540.144px;height:74.88px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>정상 응답만 적었다</span></div><div class="t" style="left:661.104px;top:290.88px;width:540.144px;height:74.88px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>상태 코드별 오류 표를 추가한다</span></div><div class="r" style="left:57.599999999999994px;top:365.76000000000005px;width:1164.768px;height:74.88px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:365.76000000000005px;width:540.144px;height:74.88px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>"문자열", "숫자"만 있고 예시값이 없다</span></div><div class="t" style="left:661.104px;top:365.76000000000005px;width:540.144px;height:74.88px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>실제 값이 들어간 JSON을 넣는다</span></div><div class="r" style="left:57.599999999999994px;top:440.6400000000001px;width:1164.768px;height:74.88px;background:#15233A;border-radius:0px"></div><div class="t" style="left:78.72px;top:440.6400000000001px;width:540.144px;height:74.88px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>Tool에 실패 코드와 실행 조건이 없다</span></div><div class="t" style="left:661.104px;top:440.6400000000001px;width:540.144px;height:74.88px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>실패했을 때 에이전트가 할 행동까지 적는다</span></div><div class="r" style="left:57.599999999999994px;top:515.5200000000001px;width:1164.768px;height:74.88px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:515.5200000000001px;width:540.144px;height:74.88px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>구현하면서 문서와 코드가 달라졌다</span></div><div class="t" style="left:661.104px;top:515.5200000000001px;width:540.144px;height:74.88px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>FastAPI의 /docs 화면과 대조하고 문서 버전을 올린다</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>팀 주제로 바꿔 쓴다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · API 설계 문서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>26</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>샘플의 '장애·복구'를 우리 서비스의 대상과 행위로 바꾼다. 아래는 형태만 보여주는 예시다</span></div><div class="r" style="left:57.599999999999994px;top:206.39999999999998px;width:369.05600000000004px;height:412.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>묶음배달 오토힐링</span></div><div class="t" style="left:86.39999999999999px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>대상: 배달, 장애</span></div><div class="t" style="left:86.39999999999999px;top:326.4px;width:311.456px;height:96px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>복구 요청과 상태 조회 구조를 그대로 쓸 수 있다.</span></div><div class="r" style="left:86.39999999999999px;top:483.8399999999999px;width:311.456px;height:106.56px;background:#0A1322;border-radius:5.76px"></div><div class="t m" style="left:103.67999999999998px;top:483.8399999999999px;width:276.896px;height:106.56px;font-size:16px;color:#2DD4BF;text-align:left;justify-content:center;"><span>GET /deliveries
|
||||
POST /incidents/{id}/heal
|
||||
Tool: reassign_rider</span></div><div class="r" style="left:455.456px;top:206.39999999999998px;width:369.05600000000004px;height:412.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:484.256px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>축제 안심 관광 비서</span></div><div class="t" style="left:484.256px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>대상: 행사, 혼잡도</span></div><div class="t" style="left:484.256px;top:326.4px;width:311.456px;height:96px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>외부 공공 API를 부르는 Tool의 실패 코드가 핵심이다.</span></div><div class="r" style="left:484.256px;top:483.8399999999999px;width:311.456px;height:106.56px;background:#0A1322;border-radius:5.76px"></div><div class="t m" style="left:501.53599999999994px;top:483.8399999999999px;width:276.896px;height:106.56px;font-size:16px;color:#2DD4BF;text-align:left;justify-content:center;"><span>GET /events/{id}/congestion
|
||||
POST /chat/stream
|
||||
Tool: get_crowd_level</span></div><div class="r" style="left:853.3120000000001px;top:206.39999999999998px;width:369.05600000000004px;height:412.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:882.1120000000001px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>자전거 상담·코스 추천</span></div><div class="t" style="left:882.1120000000001px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>대상: 코스, 상담</span></div><div class="t" style="left:882.1120000000001px;top:326.4px;width:311.456px;height:96px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>검색 조건을 쿼리 파라미터로 명세한다.</span></div><div class="r" style="left:882.1120000000001px;top:483.8399999999999px;width:311.456px;height:106.56px;background:#0A1322;border-radius:5.76px"></div><div class="t m" style="left:899.392px;top:483.8399999999999px;width:276.896px;height:106.56px;font-size:16px;color:#2DD4BF;text-align:left;justify-content:center;"><span>GET /courses?region=…
|
||||
POST /consultations
|
||||
Tool: search_safety_info</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>제출 전 체크리스트</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · API 설계 문서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>27</span></div><div class="r" style="left:57.599999999999994px;top:168px;width:570.384px;height:91.19999999999999px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="r" style="left:86.39999999999999px;top:199.20000000000002px;width:28.799999999999997px;height:28.799999999999997px;background:#1A2B45;border:1.6px solid #2DD4BF;border-radius:3.84px"></div><div class="t" style="left:139.2px;top:168px;width:464.784px;height:91.19999999999999px;font-size:20px;color:#F1F5F9;text-align:left;justify-content:center;"><span>모든 API가 목록 표에 있고 요구사항 ID와 연결된다</span></div><div class="r" style="left:57.599999999999994px;top:283.20000000000005px;width:570.384px;height:91.19999999999999px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="r" style="left:86.39999999999999px;top:314.40000000000003px;width:28.799999999999997px;height:28.799999999999997px;background:#1A2B45;border:1.6px solid #2DD4BF;border-radius:3.84px"></div><div class="t" style="left:139.2px;top:283.20000000000005px;width:464.784px;height:91.19999999999999px;font-size:20px;color:#F1F5F9;text-align:left;justify-content:center;"><span>인증 방식과 401·403 조건이 적혀 있다</span></div><div class="r" style="left:57.599999999999994px;top:398.40000000000003px;width:570.384px;height:91.19999999999999px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="r" style="left:86.39999999999999px;top:429.59999999999997px;width:28.799999999999997px;height:28.799999999999997px;background:#1A2B45;border:1.6px solid #2DD4BF;border-radius:3.84px"></div><div class="t" style="left:139.2px;top:398.40000000000003px;width:464.784px;height:91.19999999999999px;font-size:20px;color:#F1F5F9;text-align:left;justify-content:center;"><span>핵심 엔드포인트의 상세 명세 여덟 칸이 모두 채워졌다</span></div><div class="r" style="left:57.599999999999994px;top:513.5999999999999px;width:570.384px;height:91.19999999999999px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="r" style="left:86.39999999999999px;top:544.8px;width:28.799999999999997px;height:28.799999999999997px;background:#1A2B45;border:1.6px solid #2DD4BF;border-radius:3.84px"></div><div class="t" style="left:139.2px;top:513.5999999999999px;width:464.784px;height:91.19999999999999px;font-size:20px;color:#F1F5F9;text-align:left;justify-content:center;"><span>요청과 응답에 실제 값이 든 JSON 예시가 있다</span></div><div class="r" style="left:651.984px;top:168px;width:570.384px;height:91.19999999999999px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="r" style="left:680.784px;top:199.20000000000002px;width:28.799999999999997px;height:28.799999999999997px;background:#1A2B45;border:1.6px solid #2DD4BF;border-radius:3.84px"></div><div class="t" style="left:733.584px;top:168px;width:464.784px;height:91.19999999999999px;font-size:20px;color:#F1F5F9;text-align:left;justify-content:center;"><span>상태 코드별 오류 조건과 오류 코드 표가 있다</span></div><div class="r" style="left:651.984px;top:283.20000000000005px;width:570.384px;height:91.19999999999999px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="r" style="left:680.784px;top:314.40000000000003px;width:28.799999999999997px;height:28.799999999999997px;background:#1A2B45;border:1.6px solid #2DD4BF;border-radius:3.84px"></div><div class="t" style="left:733.584px;top:283.20000000000005px;width:464.784px;height:91.19999999999999px;font-size:20px;color:#F1F5F9;text-align:left;justify-content:center;"><span>검증 규칙이 Pydantic 모델과 일치한다</span></div><div class="r" style="left:651.984px;top:398.40000000000003px;width:570.384px;height:91.19999999999999px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="r" style="left:680.784px;top:429.59999999999997px;width:28.799999999999997px;height:28.799999999999997px;background:#1A2B45;border:1.6px solid #2DD4BF;border-radius:3.84px"></div><div class="t" style="left:733.584px;top:398.40000000000003px;width:464.784px;height:91.19999999999999px;font-size:20px;color:#F1F5F9;text-align:left;justify-content:center;"><span>Tool마다 입력 스키마·출력·실패 코드·실행 조건이 있다</span></Line truncated
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>오늘 팀에서 할 일</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · API 설계 문서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>28</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>완벽한 문서보다 합의된 초안이 먼저다. 구현하면서 버전을 올린다</span></div><div class="r" style="left:57.599999999999994px;top:240px;width:260.952px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:72px;top:268.79999999999995px;width:232.15200000000004px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>① API 목록 표</span></div><div class="t" style="left:72px;top:331.20000000000005px;width:232.15200000000004px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>요구사항 전체를
|
||||
표 한 장으로</span></div><div class="t" style="left:318.552px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:358.872px;top:240px;width:260.952px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:373.27200000000005px;top:268.79999999999995px;width:232.15200000000004px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>② 상세 명세 1개</span></div><div class="t" style="left:373.27200000000005px;top:331.20000000000005px;width:232.15200000000004px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>핵심 엔드포인트의
|
||||
여덟 칸 채우기</span></div><div class="t" style="left:619.8240000000001px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:660.144px;top:240px;width:260.952px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:674.5440000000001px;top:268.79999999999995px;width:232.15200000000004px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>③ Tool 정의 1개</span></div><div class="t" style="left:674.5440000000001px;top:331.20000000000005px;width:232.15200000000004px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>입력 스키마와
|
||||
실패 코드까지</span></div><div class="t" style="left:921.0960000000001px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:961.4160000000002px;top:240px;width:260.952px;height:220.79999999999998px;background:#0F766E;border-radius:9.600000000000001px"></div><div class="t" style="left:975.8160000000001px;top:268.79999999999995px;width:232.15200000000004px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>④ 팀 리뷰</span></div><div class="t" style="left:975.8160000000001px;top:331.20000000000005px;width:232.15200000000004px;height:86.4px;font-size:18.666666666666668px;color:#F1F5F9;text-align:center;justify-content:flex-start;"><span>프런트·백엔드·AI
|
||||
담당이 함께 읽기</span></div><div class="r" style="left:57.599999999999994px;top:513.5999999999999px;width:1164.768px;height:71.03999999999999px;background:#0A1322;border-radius:7.68px"></div><div class="t" style="left:86.39999999999999px;top:513.5999999999999px;width:1107.1680000000001px;height:71.03999999999999px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>문서 머리말에 문서 버전과 작성 상태를 적는다. 예: 문서 버전 v0.1 | 작성 상태: 초안</span></div></section>
|
||||
</main>
|
||||
<div class="bar" id="bar"></div>
|
||||
<script>
|
||||
(function(){
|
||||
var stage=document.querySelector('.stage'),slides=[].slice.call(document.querySelectorAll('.slide')),i=0,present=true,bar=document.getElementById('bar');
|
||||
function fit(){
|
||||
var s=present?Math.min(innerWidth/1280,innerHeight/720):Math.min(1,(innerWidth-32)/1280);
|
||||
stage.style.transform='scale('+s+')';
|
||||
stage.style.marginLeft=Math.max(0,(innerWidth-1280*s)/2)+'px';
|
||||
stage.style.marginTop=present?Math.max(0,(innerHeight-720*s)/2)+'px':'16px';
|
||||
stage.style.height=present?'720px':'';
|
||||
}
|
||||
function show(){
|
||||
document.body.classList.toggle('present',present);
|
||||
slides.forEach(function(el,k){el.classList.toggle('on',k===i)});
|
||||
bar.textContent=present?(i+1)+' / '+slides.length+' · ←/→ 이동 · O 전체 보기 · F 전체 화면':'O 발표 보기 · 인쇄(Ctrl/⌘+P)로 PDF 저장';
|
||||
fit(); if(!present) slides[i].scrollIntoView();
|
||||
}
|
||||
function go(d){i=Math.max(0,Math.min(slides.length-1,i+d));show()}
|
||||
addEventListener('keydown',function(e){
|
||||
if(['ArrowRight','PageDown',' ','Enter'].indexOf(e.key)>=0){e.preventDefault();go(1)}
|
||||
else if(['ArrowLeft','PageUp','Backspace'].indexOf(e.key)>=0){e.preventDefault();go(-1)}
|
||||
else if(e.key==='Home'){i=0;show()} else if(e.key==='End'){i=slides.length-1;show()}
|
||||
else if(e.key==='o'||e.key==='O'){present=!present;show()}
|
||||
else if(e.key==='f'||e.key==='F'){document.fullscreenElement?document.exitFullscreen():document.documentElement.requestFullscreen()}
|
||||
});
|
||||
stage.addEventListener('click',function(e){if(present)go(e.clientX<innerWidth/3?-1:1)});
|
||||
addEventListener('resize',fit); show();
|
||||
})();
|
||||
</script>
|
||||
</body></html>
|
||||
Binary file not shown.
@@ -0,0 +1,148 @@
|
||||
<!DOCTYPE html>
|
||||
<html lang="ko"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
||||
<title>DB 스키마 설계서 작성법</title>
|
||||
<style>
|
||||
*{box-sizing:border-box;margin:0;padding:0}
|
||||
html,body{background:#060d18;color:#F1F5F9;font-family:"Noto Sans KR","Noto Sans CJK KR","Apple SD Gothic Neo","Malgun Gothic",sans-serif}
|
||||
.stage{width:1280px;transform-origin:0 0;margin:0 auto}
|
||||
.slide{position:relative;width:1280px;height:720px;background:#0F1B2D;overflow:hidden;margin:0 0 24px}
|
||||
.r,.t{position:absolute}
|
||||
.t{display:flex;flex-direction:column;line-height:1.38;white-space:pre-wrap;word-break:keep-all;overflow-wrap:anywhere;font-weight:400}
|
||||
.t.m{font-family:"D2Coding","Consolas","Menlo","DejaVu Sans Mono","Noto Sans KR","Noto Sans CJK KR",monospace;line-height:1.36;word-break:normal}
|
||||
.t.ul .li{padding-left:1.2em;text-indent:-1.2em;margin-bottom:var(--gap,12px)}
|
||||
.t.ul .li::before{content:"•";display:inline-block;width:1.2em;text-indent:0;color:#2DD4BF}
|
||||
.bar{position:fixed;right:14px;bottom:10px;font-size:12px;color:#A8B8CC;background:rgba(6,13,24,.8);padding:4px 10px;border-radius:12px;z-index:9}
|
||||
body.present{overflow:hidden}
|
||||
body.present .slide{display:none;margin:0}
|
||||
body.present .slide.on{display:block}
|
||||
@page{size:1280px 720px;margin:0}
|
||||
@media print{html,body{background:#0F1B2D}.bar{display:none}.stage{transform:none!important;margin:0!important}
|
||||
.slide,body.present .slide{display:block;margin:0;break-after:page;break-inside:avoid}
|
||||
*{-webkit-print-color-adjust:exact;print-color-adjust:exact}}
|
||||
</style></head><body>
|
||||
<main class="stage">
|
||||
<section class="slide"><h1 class="t" style="left:57.599999999999994px;top:211.20000000000002px;width:1056px;height:115.19999999999999px;font-size:64px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>DB 스키마 설계서 작성법</span></h1><div class="t" style="left:57.599999999999994px;top:336px;width:1056px;height:48px;font-size:29.333333333333332px;color:#2DD4BF;text-align:left;justify-content:center;"><span>최종 프로젝트 STEP 2 · PostgreSQL(Supabase) · pgvector · Redis</span></div><div class="t" style="left:57.599999999999994px;top:398.40000000000003px;width:1056px;height:38.400000000000006px;font-size:20px;color:#A8B8CC;text-align:left;justify-content:center;"><span>AI 애플리케이션 개발 과정 · 최종 프로젝트 산출물 가이드</span></div><div class="r" style="left:57.599999999999994px;top:537.5999999999999px;width:263.23199999999997px;height:48px;background:#1A2B45;border-radius:24px"></div><div class="t m" style="left:57.599999999999994px;top:537.5999999999999px;width:263.23199999999997px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>users 1:N incidents</span></div><div class="r" style="left:344.832px;top:537.5999999999999px;width:172.608px;height:48px;background:#1A2B45;border-radius:24px"></div><div class="t m" style="left:344.832px;top:537.5999999999999px;width:172.608px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>PRIMARY KEY</span></div><div class="r" style="left:541.44px;top:537.5999999999999px;width:183.93599999999998px;height:48px;background:#1A2B45;border-radius:24px"></div><div class="t m" style="left:541.44px;top:537.5999999999999px;width:183.93599999999998px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>VECTOR(1536)</span></div><div class="r" style="left:749.3760000000001px;top:537.5999999999999px;width:251.90399999999997px;height:48px;background:#1A2B45;border-radius:24px"></div><div class="t m" style="left:749.3760000000001px;top:537.5999999999999px;width:251.90399999999997px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>ROW LEVEL SECURITY</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>DB 스키마 설계서는 데이터의 설계도다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · DB 스키마 설계서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>2</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>API 설계 문서가 '주고받는 것'의 약속이라면, 이 문서는 '저장하는 것'의 약속이다</span></div><div class="r" style="left:57.599999999999994px;top:206.39999999999998px;width:369.05600000000004px;height:316.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>무엇을</span></div><div class="t" style="left:86.39999999999999px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>저장할 데이터를 정한다</span></div><div class="t" style="left:86.39999999999999px;top:326.4px;width:311.456px;height:168px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>테이블과 컬럼, 타입, 제약을 정한다. API가 주고받는 필드가 어디에 저장되는지 보인다.</span></div><div class="r" style="left:455.456px;top:206.39999999999998px;width:369.05600000000004px;height:316.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:484.256px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>어떻게</span></div><div class="t" style="left:484.256px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>테이블을 잇는다</span></div><div class="t" style="left:484.256px;top:326.4px;width:311.456px;height:168px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>기본키와 외래키로 관계를 정한다. 잘못된 데이터가 들어오지 못하게 DB가 막아 준다.</span></div><div class="r" style="left:853.3120000000001px;top:206.39999999999998px;width:369.05600000000004px;height:316.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:882.1120000000001px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>누가</span></div><div class="t" style="left:882.1120000000001px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>볼 수 있는 사람을 정한다</span></div><div class="t" style="left:882.1120000000001px;top:326.4px;width:311.456px;height:168px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>RLS 정책으로 역할별 조회·수정 권한을 정한다. 보안 가드레일 문서의 근거가 된다.</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>API 설계 문서에서 이어지는 자리</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · DB 스키마 설계서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>3</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>두 문서는 STEP 2의 짝 산출물이다. 나란히 놓고 함께 쓴다</span></div><div class="r" style="left:57.599999999999994px;top:240px;width:200.69760000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:72px;top:268.79999999999995px;width:171.8976px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>기획서</span></div><div class="t" style="left:72px;top:331.20000000000005px;width:171.8976px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>기능 요구사항
|
||||
FR-01 …</span></div><div class="t" style="left:258.29760000000005px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:298.61760000000004px;top:240px;width:200.69760000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:313.0176px;top:268.79999999999995px;width:171.8976px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>API 설계 문서</span></div><div class="t" style="left:313.0176px;top:331.20000000000005px;width:171.8976px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>지난 시간에
|
||||
다룬 산출물</span></div><div class="t" style="left:499.3152px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:539.6351999999999px;top:240px;width:200.69760000000002px;height:220.79999999999998px;background:#0F766E;border-radius:9.600000000000001px"></div><div class="t" style="left:554.0352px;top:268.79999999999995px;width:171.8976px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>DB 스키마 설계서</span></div><div class="t" style="left:554.0352px;top:331.20000000000005px;width:171.8976px;height:86.4px;font-size:18.666666666666668px;color:#F1F5F9;text-align:center;justify-content:flex-start;"><span>오늘 다루는
|
||||
산출물</span></div><div class="t" style="left:740.3328px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:780.6528000000001px;top:240px;width:200.69760000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:795.0528px;top:268.79999999999995px;width:171.8976px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>에이전트 설계</span></div><div class="t" style="left:795.0528px;top:331.20000000000005px;width:171.8976px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>메모리와
|
||||
체크포인트 저장</span></div><div class="t" style="left:981.3504px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:1021.6704px;top:240px;width:200.69760000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:1036.0704px;top:268.79999999999995px;width:171.8976px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>통합 테스트</span></div><div class="t" style="left:1036.0704px;top:331.20000000000005px;width:171.8976px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>권한과 데이터
|
||||
정합성 확인</span></div><div class="r" style="left:57.599999999999994px;top:513.5999999999999px;width:1164.768px;height:71.03999999999999px;background:#0A1322;border-radius:7.68px"></div><div class="t" style="left:86.39999999999999px;top:513.5999999999999px;width:1107.1680000000001px;height:71.03999999999999px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>API 요청과 응답의 필드가 테이블의 컬럼이 된다. 필드명과 컬럼명, ID 형식을 두 문서에서 똑같이 쓴다.</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>문서에 들어가는 여섯 가지</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · DB 스키마 설계서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>4</span></div><div class="r" style="left:57.599999999999994px;top:168px;width:369.05600000000004px;height:225.60000000000002px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:196.79999999999998px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>01</span></div><div class="t" style="left:86.39999999999999px;top:235.2px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>ERD와 관계 명세</span></div><div class="t" style="left:86.39999999999999px;top:288px;width:311.456px;height:76.79999999999998px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>테이블 사이의 관계를 그림과 표로</span></div><div class="r" style="left:455.456px;top:168px;width:369.05600000000004px;height:225.60000000000002px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:484.256px;top:196.79999999999998px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>02</span></div><div class="t" style="left:484.256px;top:235.2px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>엔터티 정의</span></div><div class="t" style="left:484.256px;top:288px;width:311.456px;height:76.79999999999998px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>컬럼마다 타입·제약·의미</span></div><div class="r" style="left:853.3120000000001px;top:168px;width:369.05600000000004px;height:225.60000000000002px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:882.1120000000001px;top:196.79999999999998px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>03</span></div><div class="t" style="left:882.1120000000001px;top:235.2px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>pgvector 스키마</span></div><div class="t" style="left:882.1120000000001px;top:288px;width:311.456px;height:76.79999999999998px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>문서·청크 테이블과 벡터 인덱스</span></div><div class="r" style="left:57.599999999999994px;top:422.40000000000003px;width:369.05600000000004px;height:225.60000000000002px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:451.20000000000005px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>04</span></div><div class="t" style="left:86.39999999999999px;top:489.6px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>RLS 정책</span></div><div class="t" style="left:86.39999999999999px;top:542.4000000000001px;width:311.456px;height:76.79999999999998px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>역할별 조회·등록·수정·삭제 권한</span></div><div class="r" style="left:455.456px;top:422.40000000000003px;width:369.05600000000004px;height:225.60000000000002px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:484.256px;top:451.20000000000005px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>05</span></div><div class="t" style="left:484.256px;top:489.6px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>세션·캐시 설계</span></div><div class="t" style="left:484.256px;top:542.4000000000001px;width:311.456px;height:76.79999999999998px;font-size:20px;color:#CBD5E1;text-align:left;Line truncated
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>테이블은 행과 열로 된 표다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · DB 스키마 설계서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>5</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>엑셀 시트와 비슷하지만, 열마다 타입과 규칙이 정해져 있다는 점이 다르다</span></div><div class="r" style="left:57.599999999999994px;top:206.39999999999998px;width:369.05600000000004px;height:412.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>테이블 (엔터티)</span></div><div class="t" style="left:86.39999999999999px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>대상 하나에 표 하나</span></div><div class="t" style="left:86.39999999999999px;top:326.4px;width:311.456px;height:96px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>사용자, 장애, 복구 작업처럼 서비스가 다루는 대상의 종류마다 테이블을 하나씩 만든다.</span></div><div class="r" style="left:86.39999999999999px;top:483.8399999999999px;width:311.456px;height:106.56px;background:#0A1322;border-radius:5.76px"></div><div class="t m" style="left:103.67999999999998px;top:483.8399999999999px;width:276.896px;height:106.56px;font-size:16px;color:#2DD4BF;text-align:left;justify-content:center;"><span>users
|
||||
incidents
|
||||
recovery_jobs</span></div><div class="r" style="left:455.456px;top:206.39999999999998px;width:369.05600000000004px;height:412.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:484.256px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>컬럼 (열)</span></div><div class="t" style="left:484.256px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>속성과 타입, 제약</span></div><div class="t" style="left:484.256px;top:326.4px;width:311.456px;height:96px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>대상이 갖는 속성이다. 어떤 타입의 값이 들어가는지, 비워도 되는지를 함께 정한다.</span></div><div class="r" style="left:484.256px;top:535.68px;width:311.456px;height:54.720000000000006px;background:#0A1322;border-radius:5.76px"></div><div class="t m" style="left:501.53599999999994px;top:535.68px;width:276.896px;height:54.720000000000006px;font-size:16px;color:#2DD4BF;text-align:left;justify-content:center;"><span>status TEXT NOT NULL</span></div><div class="r" style="left:853.3120000000001px;top:206.39999999999998px;width:369.05600000000004px;height:412.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:882.1120000000001px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>행 (레코드)</span></div><div class="t" style="left:882.1120000000001px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>실제 데이터 한 건</span></div><div class="t" style="left:882.1120000000001px;top:326.4px;width:311.456px;height:96px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>장애 한 건, 사용자 한 명이 행 하나다. API 응답의 JSON 객체 하나에 해당한다.</span></div><div class="r" style="left:882.1120000000001px;top:535.68px;width:311.456px;height:54.720000000000006px;background:#0A1322;border-radius:5.76px"></div><div class="t m" style="left:899.392px;top:535.68px;width:276.896px;height:54.720000000000006px;font-size:16px;color:#2DD4BF;text-align:left;justify-content:center;"><span>inc-001 | detected</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>키와 제약이 데이터를 지킨다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · DB 스키마 설계서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>6</span></div><div class="r" style="left:57.599999999999994px;top:168px;width:1164.768px;height:48px;background:#22375A;border-radius:0px"></div><div class="t" style="left:78.72px;top:168px;width:190.71360000000004px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>용어</span></div><div class="t" style="left:311.6736000000001px;top:168px;width:400.37184px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>뜻</span></div><div class="t" style="left:754.28544px;top:168px;width:446.96255999999994px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>예시</span></div><div class="r" style="left:57.599999999999994px;top:216px;width:1164.768px;height:67.19999999999999px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:216px;width:190.71360000000004px;height:67.19999999999999px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>기본키 (PK)</span></div><div class="t" style="left:311.6736000000001px;top:216px;width:400.37184px;height:67.19999999999999px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>행 하나를 유일하게 가리키는 컬럼</span></div><div class="t m" style="left:754.28544px;top:216px;width:446.96255999999994px;height:67.19999999999999px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>incidents.id</span></div><div class="r" style="left:57.599999999999994px;top:283.20000000000005px;width:1164.768px;height:67.19999999999999px;background:#15233A;border-radius:0px"></div><div class="t" style="left:78.72px;top:283.20000000000005px;width:190.71360000000004px;height:67.19999999999999px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>외래키 (FK)</span></div><div class="t" style="left:311.6736000000001px;top:283.20000000000005px;width:400.37184px;height:67.19999999999999px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>다른 테이블의 기본키를 가리키는 컬럼</span></div><div class="t m" style="left:754.28544px;top:283.20000000000005px;width:446.96255999999994px;height:67.19999999999999px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>recovery_jobs.incident_id → incidents.id</span></div><div class="r" style="left:57.599999999999994px;top:350.40000000000003px;width:1164.768px;height:67.19999999999999px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:350.40000000000003px;width:190.71360000000004px;height:67.19999999999999px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>UNIQUE</span></div><div class="t" style="left:311.6736000000001px;top:350.40000000000003px;width:400.37184px;height:67.19999999999999px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>같은 값이 두 번 들어갈 수 없다</span></div><div class="t m" style="left:754.28544px;top:350.40000000000003px;width:446.96255999999994px;height:67.19999999999999px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>users.email</span></div><div class="r" style="left:57.599999999999994px;top:417.6px;width:1164.768px;height:67.19999999999999px;background:#15233A;border-radius:0px"></div><div class="t" style="left:78.72px;top:417.6px;width:190.71360000000004px;height:67.19999999999999px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>NOT NULL</span></div><div class="t" style="left:311.6736000000001px;top:417.6px;width:400.37184px;height:67.19999999999999px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>값을 비워 둘 수 없다</span></div><div class="t m" style="left:754.28544px;top:417.6px;width:446.96255999999994px;height:67.19999999999999px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;juLine truncated
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>테이블 사이의 관계는 세 종류다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · DB 스키마 설계서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>7</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>ERD를 그리기 전에, 두 테이블이 몇 대 몇으로 짝지어지는지 먼저 말로 적어 본다</span></div><div class="r" style="left:57.599999999999994px;top:206.39999999999998px;width:369.05600000000004px;height:412.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>1 : N</span></div><div class="t" style="left:86.39999999999999px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>가장 흔한 관계</span></div><div class="t" style="left:86.39999999999999px;top:326.4px;width:311.456px;height:96px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>사용자 한 명이 장애 여러 건을 등록한다. 외래키는 N 쪽 테이블에 둔다.</span></div><div class="r" style="left:86.39999999999999px;top:509.76px;width:311.456px;height:80.64000000000001px;background:#0A1322;border-radius:5.76px"></div><div class="t m" style="left:103.67999999999998px;top:509.76px;width:276.896px;height:80.64000000000001px;font-size:16px;color:#2DD4BF;text-align:left;justify-content:center;"><span>incidents.created_by
|
||||
→ users.id</span></div><div class="r" style="left:455.456px;top:206.39999999999998px;width:369.05600000000004px;height:412.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:484.256px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>N : M</span></div><div class="t" style="left:484.256px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>중간 테이블로 푼다</span></div><div class="t" style="left:484.256px;top:326.4px;width:311.456px;height:96px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>장애 하나에 태그 여러 개, 태그 하나에 장애 여러 건. 둘을 잇는 테이블을 따로 만든다.</span></div><div class="r" style="left:484.256px;top:509.76px;width:311.456px;height:80.64000000000001px;background:#0A1322;border-radius:5.76px"></div><div class="t m" style="left:501.53599999999994px;top:509.76px;width:276.896px;height:80.64000000000001px;font-size:16px;color:#2DD4BF;text-align:left;justify-content:center;"><span>incident_tags
|
||||
(incident_id, tag_id)</span></div><div class="r" style="left:853.3120000000001px;top:206.39999999999998px;width:369.05600000000004px;height:412.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:882.1120000000001px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>1 : 1</span></div><div class="t" style="left:882.1120000000001px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>드물게 쓴다</span></div><div class="t" style="left:882.1120000000001px;top:326.4px;width:311.456px;height:96px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>사용자와 프로필처럼 하나씩 짝지어진다. 한 테이블로 합칠 수 있는지 먼저 본다.</span></div><div class="r" style="left:882.1120000000001px;top:509.76px;width:311.456px;height:80.64000000000001px;background:#0A1322;border-radius:5.76px"></div><div class="t m" style="left:899.392px;top:509.76px;width:276.896px;height:80.64000000000001px;font-size:16px;color:#2DD4BF;text-align:left;justify-content:center;"><span>profiles.user_id
|
||||
→ users.id (UNIQUE)</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>자주 쓰는 타입 여섯 가지</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · DB 스키마 설계서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>8</span></div><div class="r" style="left:57.599999999999994px;top:168px;width:1164.768px;height:48px;background:#22375A;border-radius:0px"></div><div class="t" style="left:78.72px;top:168px;width:190.71360000000004px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>타입</span></div><div class="t" style="left:311.6736000000001px;top:168px;width:446.96255999999994px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>쓰는 곳</span></div><div class="t" style="left:800.87616px;top:168px;width:400.37184px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>예시</span></div><div class="r" style="left:57.599999999999994px;top:216px;width:1164.768px;height:48px;background:#1A2B45;border-radius:0px"></div><div class="t m" style="left:78.72px;top:216px;width:190.71360000000004px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>UUID</span></div><div class="t" style="left:311.6736000000001px;top:216px;width:446.96255999999994px;height:48px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>사용자, 문서 등의 식별자</span></div><div class="t m" style="left:800.87616px;top:216px;width:400.37184px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>users.id</span></div><div class="r" style="left:57.599999999999994px;top:264px;width:1164.768px;height:48px;background:#15233A;border-radius:0px"></div><div class="t m" style="left:78.72px;top:264px;width:190.71360000000004px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>TEXT</span></div><div class="t" style="left:311.6736000000001px;top:264px;width:446.96255999999994px;height:48px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>문자열. 이름, 상태, 본문</span></div><div class="t m" style="left:800.87616px;top:264px;width:400.37184px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>incidents.status</span></div><div class="r" style="left:57.599999999999994px;top:312px;width:1164.768px;height:48px;background:#1A2B45;border-radius:0px"></div><div class="t m" style="left:78.72px;top:312px;width:190.71360000000004px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>INT</span></div><div class="t" style="left:311.6736000000001px;top:312px;width:446.96255999999994px;height:48px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>개수, 순번</span></div><div class="t m" style="left:800.87616px;top:312px;width:400.37184px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>document_chunks.chunk_index</span></div><div class="r" style="left:57.599999999999994px;top:360px;width:1164.768px;height:48px;background:#15233A;border-radius:0px"></div><div class="t m" style="left:78.72px;top:360px;width:190.71360000000004px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>TIMESTAMPTZ</span></div><div class="t" style="left:311.6736000000001px;top:360px;width:446.96255999999994px;height:48px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>시각 (시간대 포함)</span></div><div class="t m" style="left:800.87616px;top:360px;width:400.37184px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>created_at</span></div><div class="r" style="left:57.599999999999994px;top:408px;width:1164.768px;height:48px;background:#1A2B45;border-radius:0px"></div><div class="t m" style="left:78.72px;top:408px;width:190.71360000000004px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>JSONB</span></div><div class="t" style="left:311.6736000000001px;top:408px;width:446.96255999999994px;height:48px;font-size:18.666666666666668px;color:#CBD5ELine truncated
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>API의 필드에서 테이블을 뽑아낸다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · DB 스키마 설계서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>9</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>API 설계 문서의 요청·응답 JSON을 펼쳐 놓고, 필드마다 저장할 곳을 정한다</span></div><div class="r" style="left:57.599999999999994px;top:206.39999999999998px;width:1164.768px;height:48px;background:#22375A;border-radius:0px"></div><div class="t" style="left:78.72px;top:206.39999999999998px;width:260.59968000000003px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>API 필드</span></div><div class="t" style="left:381.55968000000007px;top:206.39999999999998px;width:400.37184px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>테이블.컬럼 (예시)</span></div><div class="t" style="left:824.1715200000001px;top:206.39999999999998px;width:377.07648000000006px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>비고</span></div><div class="r" style="left:57.599999999999994px;top:254.39999999999998px;width:1164.768px;height:53.760000000000005px;background:#1A2B45;border-radius:0px"></div><div class="t m" style="left:78.72px;top:254.39999999999998px;width:260.59968000000003px;height:53.760000000000005px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>incident_id</span></div><div class="t m" style="left:381.55968000000007px;top:254.39999999999998px;width:400.37184px;height:53.760000000000005px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>incidents.id</span></div><div class="t" style="left:824.1715200000001px;top:254.39999999999998px;width:377.07648000000006px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>경로 파라미터가 곧 기본키</span></div><div class="r" style="left:57.599999999999994px;top:308.15999999999997px;width:1164.768px;height:53.760000000000005px;background:#15233A;border-radius:0px"></div><div class="t m" style="left:78.72px;top:308.15999999999997px;width:260.59968000000003px;height:53.760000000000005px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>action, target_id</span></div><div class="t m" style="left:381.55968000000007px;top:308.15999999999997px;width:400.37184px;height:53.760000000000005px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>recovery_jobs.action, target_id</span></div><div class="t" style="left:824.1715200000001px;top:308.15999999999997px;width:377.07648000000006px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>요청 본문을 그대로 기록</span></div><div class="r" style="left:57.599999999999994px;top:361.92px;width:1164.768px;height:53.760000000000005px;background:#1A2B45;border-radius:0px"></div><div class="t m" style="left:78.72px;top:361.92px;width:260.59968000000003px;height:53.760000000000005px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>approval_id</span></div><div class="t m" style="left:381.55968000000007px;top:361.92px;width:400.37184px;height:53.760000000000005px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>recovery_jobs.approval_id</span></div><div class="t" style="left:824.1715200000001px;top:361.92px;width:377.07648000000006px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>NOT NULL. 승인 없이는 저장 불가</span></div><div class="r" style="left:57.599999999999994px;top:415.68px;width:1164.768px;height:53.760000000000005px;background:#15233A;border-radius:0px"></div><div class="t m" style="left:78.72px;top:415.68px;width:260.59968000000003px;height:53.760000000000005px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>job_id, status</span></div><div class="t m" Line truncated
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>ERD는 테이블을 상자로, 관계를 선으로 그린다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · DB 스키마 설계서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>10</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>화살표 하나가 1:N 관계 하나다. 상자 안에는 키 컬럼을 반드시 적는다</span></div><div class="r" style="left:57.599999999999994px;top:240px;width:361.37600000000003px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:72px;top:268.79999999999995px;width:332.576px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>users</span></div><div class="t m" style="left:72px;top:331.20000000000005px;width:332.576px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>id PK
|
||||
email UNIQUE</span></div><div class="t" style="left:418.976px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:459.29600000000005px;top:240px;width:361.37600000000003px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:473.696px;top:268.79999999999995px;width:332.576px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>incidents</span></div><div class="t m" style="left:473.696px;top:331.20000000000005px;width:332.576px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>id PK
|
||||
created_by FK
|
||||
status</span></div><div class="t" style="left:820.672px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:860.9920000000001px;top:240px;width:361.37600000000003px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:875.392px;top:268.79999999999995px;width:332.576px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>recovery_jobs</span></div><div class="t m" style="left:875.392px;top:331.20000000000005px;width:332.576px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>id PK
|
||||
incident_id FK
|
||||
approval_id</span></div><div class="r" style="left:57.599999999999994px;top:513.5999999999999px;width:1164.768px;height:71.03999999999999px;background:#0A1322;border-radius:7.68px"></div><div class="t" style="left:86.39999999999999px;top:513.5999999999999px;width:1107.1680000000001px;height:71.03999999999999px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>그림은 Mermaid erDiagram이나 ERD 도구로 그려서 붙인다. 손으로 그린 그림보다 수정과 버전 관리가 쉽다.</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>관계 명세 표로 그림을 글로 확인한다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · DB 스키마 설계서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>11</span></div><div class="r" style="left:57.599999999999994px;top:168px;width:1164.768px;height:48px;background:#22375A;border-radius:0px"></div><div class="t" style="left:78.72px;top:168px;width:190.71360000000004px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>부모 테이블</span></div><div class="t" style="left:311.6736000000001px;top:168px;width:97.53216000000002px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>관계</span></div><div class="t" style="left:451.44576000000006px;top:168px;width:237.30432000000002px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>자식 테이블</span></div><div class="t" style="left:730.9900800000001px;top:168px;width:470.25792px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>연결 키</span></div><div class="r" style="left:57.599999999999994px;top:216px;width:1164.768px;height:67.19999999999999px;background:#1A2B45;border-radius:0px"></div><div class="t m" style="left:78.72px;top:216px;width:190.71360000000004px;height:67.19999999999999px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>users</span></div><div class="t" style="left:311.6736000000001px;top:216px;width:97.53216000000002px;height:67.19999999999999px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>1 : N</span></div><div class="t m" style="left:451.44576000000006px;top:216px;width:237.30432000000002px;height:67.19999999999999px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>incidents</span></div><div class="t m" style="left:730.9900800000001px;top:216px;width:470.25792px;height:67.19999999999999px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>incidents.created_by → users.id</span></div><div class="r" style="left:57.599999999999994px;top:283.20000000000005px;width:1164.768px;height:67.19999999999999px;background:#15233A;border-radius:0px"></div><div class="t m" style="left:78.72px;top:283.20000000000005px;width:190.71360000000004px;height:67.19999999999999px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>incidents</span></div><div class="t" style="left:311.6736000000001px;top:283.20000000000005px;width:97.53216000000002px;height:67.19999999999999px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>1 : N</span></div><div class="t m" style="left:451.44576000000006px;top:283.20000000000005px;width:237.30432000000002px;height:67.19999999999999px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>recovery_jobs</span></div><div class="t m" style="left:730.9900800000001px;top:283.20000000000005px;width:470.25792px;height:67.19999999999999px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>recovery_jobs.incident_id → incidents.id</span></div><div class="r" style="left:57.599999999999994px;top:350.40000000000003px;width:1164.768px;height:67.19999999999999px;background:#1A2B45;border-radius:0px"></div><div class="t m" style="left:78.72px;top:350.40000000000003px;width:190.71360000000004px;height:67.19999999999999px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>documents</span></div><div class="t" style="left:311.6736000000001px;top:350.40000000000003px;width:97.53216000000002px;height:67.19999999999999px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>1 : N</span></div><div class="t m" style="left:451.44576000000006px;top:350.40000000000003px;width:237.30432000000002px;height:67.19999999999999px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>document_chunks</span></div><div class="t m" style="left:730.9900800000001px;top:350.40000000000003px;width:470.25792px;height:67.19999999999999px;font-size:18.666666666666668px;color:#2DD4BLine truncated
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>엔터티 정의는 컬럼마다 네 칸을 채운다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · DB 스키마 설계서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>12</span></div><div class="r" style="left:57.599999999999994px;top:168px;width:1164.768px;height:48px;background:#22375A;border-radius:0px"></div><div class="t" style="left:78.72px;top:168px;width:190.71360000000004px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>테이블</span></div><div class="t" style="left:311.6736000000001px;top:168px;width:190.71360000000004px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>컬럼</span></div><div class="t" style="left:544.6272px;top:168px;width:307.1904px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>타입 / 제약</span></div><div class="t" style="left:894.0576000000001px;top:168px;width:307.1904px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>의미</span></div><div class="r" style="left:57.599999999999994px;top:216px;width:1164.768px;height:48px;background:#1A2B45;border-radius:0px"></div><div class="t m" style="left:78.72px;top:216px;width:190.71360000000004px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>users</span></div><div class="t m" style="left:311.6736000000001px;top:216px;width:190.71360000000004px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>id</span></div><div class="t m" style="left:544.6272px;top:216px;width:307.1904px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>UUID / PK</span></div><div class="t" style="left:894.0576000000001px;top:216px;width:307.1904px;height:48px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>사용자 ID</span></div><div class="r" style="left:57.599999999999994px;top:264px;width:1164.768px;height:48px;background:#15233A;border-radius:0px"></div><div class="t m" style="left:78.72px;top:264px;width:190.71360000000004px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>users</span></div><div class="t m" style="left:311.6736000000001px;top:264px;width:190.71360000000004px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>email</span></div><div class="t m" style="left:544.6272px;top:264px;width:307.1904px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>TEXT / UNIQUE</span></div><div class="t" style="left:894.0576000000001px;top:264px;width:307.1904px;height:48px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>로그인 이메일</span></div><div class="r" style="left:57.599999999999994px;top:312px;width:1164.768px;height:48px;background:#1A2B45;border-radius:0px"></div><div class="t m" style="left:78.72px;top:312px;width:190.71360000000004px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>incidents</span></div><div class="t m" style="left:311.6736000000001px;top:312px;width:190.71360000000004px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>id</span></div><div class="t m" style="left:544.6272px;top:312px;width:307.1904px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>TEXT / PK</span></div><div class="t" style="left:894.0576000000001px;top:312px;width:307.1904px;height:48px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>장애 ID</span></div><div class="r" style="left:57.599999999999994px;top:360px;width:1164.768px;height:48px;background:#15233A;border-radius:0px"></div><div class="t m" style="left:78.72px;top:360px;width:190.71360000000004px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>incidents</span></div><div class="t m" style="left:311.6736000000001px;top:360px;width:190.71360000000004px;height:48px;font-size:18.66666666666Line truncated
|
||||
모든 테이블에 created_at TIMESTAMPTZ를 둔다.</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>설계서의 표는 그대로 SQL이 된다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · DB 스키마 설계서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>13</span></div><div class="t ul" style="left:57.599999999999994px;top:172.8px;width:412.79999999999995px;height:441.59999999999997px;font-size:21.333333333333332px;color:#CBD5E1;text-align:left;justify-content:flex-start;--gap:18.666666666666668px;"><div class="li">엔터티 정의 표의 한 행이 SQL의 한 줄이다.</div><div class="li">REFERENCES가 외래키다.</div><div class="li">DEFAULT now()로 생성 시각을 자동 기록한다.</div><div class="li">문서에 싣는 SQL은 Supabase SQL Editor에서 실제로 실행해 본 것만 넣는다.</div></div><div class="r" style="left:508.79999999999995px;top:168px;width:713.5680000000001px;height:424.79999999999995px;background:#0A1322;border-radius:9.600000000000001px"></div><div class="t m" style="left:537.5999999999999px;top:179.52px;width:655.9680000000001px;height:28.799999999999997px;font-size:16px;color:#A8B8CC;text-align:left;justify-content:center;"><span>schema.sql</span></div><div class="t m" style="left:537.5999999999999px;top:216px;width:655.9680000000001px;height:367.2px;font-size:17.333333333333332px;color:#F1F5F9;text-align:left;justify-content:flex-start;"><span>CREATE TABLE incidents (
|
||||
id TEXT PRIMARY KEY,
|
||||
created_by UUID NOT NULL REFERENCES users(id),
|
||||
status TEXT NOT NULL DEFAULT 'detected',
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT now()
|
||||
);
|
||||
|
||||
CREATE TABLE recovery_jobs (
|
||||
id TEXT PRIMARY KEY,
|
||||
incident_id TEXT NOT NULL REFERENCES incidents(id),
|
||||
action TEXT NOT NULL,
|
||||
approval_id TEXT NOT NULL,
|
||||
status TEXT NOT NULL DEFAULT 'queued',
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT now()
|
||||
);</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>pgvector는 문서와 청크를 나눠 저장한다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · DB 스키마 설계서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>14</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>RAG에 쓰는 지식 문서는 원문 정보와, 잘게 자른 조각(청크)의 벡터로 나뉜다</span></div><div class="r" style="left:57.599999999999994px;top:206.39999999999998px;width:369.05600000000004px;height:412.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>documents</span></div><div class="t" style="left:86.39999999999999px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>원문의 정보</span></div><div class="t" style="left:86.39999999999999px;top:326.4px;width:311.456px;height:96px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>제목, 출처, 부가 정보를 저장한다. 청크가 어느 문서에서 나왔는지 추적하는 기준이다.</span></div><div class="r" style="left:86.39999999999999px;top:509.76px;width:311.456px;height:80.64000000000001px;background:#0A1322;border-radius:5.76px"></div><div class="t m" style="left:103.67999999999998px;top:509.76px;width:276.896px;height:80.64000000000001px;font-size:16px;color:#2DD4BF;text-align:left;justify-content:center;"><span>documents
|
||||
(title, source_uri)</span></div><div class="r" style="left:455.456px;top:206.39999999999998px;width:369.05600000000004px;height:412.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:484.256px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>document_chunks</span></div><div class="t" style="left:484.256px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>조각과 벡터</span></div><div class="t" style="left:484.256px;top:326.4px;width:311.456px;height:96px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>잘라 낸 본문과 임베딩 벡터, 문서 안에서의 순번을 저장한다. 검색은 이 테이블에서 일어난다.</span></div><div class="r" style="left:484.256px;top:509.76px;width:311.456px;height:80.64000000000001px;background:#0A1322;border-radius:5.76px"></div><div class="t m" style="left:501.53599999999994px;top:509.76px;width:276.896px;height:80.64000000000001px;font-size:16px;color:#2DD4BF;text-align:left;justify-content:center;"><span>document_chunks
|
||||
(content, embedding)</span></div><div class="r" style="left:853.3120000000001px;top:206.39999999999998px;width:369.05600000000004px;height:412.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:882.1120000000001px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>모델 정보</span></div><div class="t" style="left:882.1120000000001px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>어떤 모델로 만들었나</span></div><div class="t" style="left:882.1120000000001px;top:326.4px;width:311.456px;height:96px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>모델을 바꾸면 벡터의 차원과 의미가 달라진다. 기존 벡터와 섞어 쓸 수 없으므로 기록해 둔다.</span></div><div class="r" style="left:882.1120000000001px;top:509.76px;width:311.456px;height:80.64000000000001px;background:#0A1322;border-radius:5.76px"></div><div class="t m" style="left:899.392px;top:509.76px;width:276.896px;height:80.64000000000001px;font-size:16px;color:#2DD4BF;text-align:left;justify-content:center;"><span>embedding_model
|
||||
embedding_version</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>벡터 컬럼과 인덱스를 명세한다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · DB 스키마 설계서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>15</span></div><div class="t ul" style="left:57.599999999999994px;top:172.8px;width:412.79999999999995px;height:441.59999999999997px;font-size:21.333333333333332px;color:#CBD5E1;text-align:left;justify-content:flex-start;--gap:18.666666666666668px;"><div class="li">VECTOR(n)의 n은 임베딩 모델의 출력 차원과 같아야 한다.</div><div class="li">인덱스의 연산자(vector_cosine_ops)와 검색식의 연산자(<=>)를 맞춘다.</div><div class="li">UNIQUE (document_id, chunk_index)로 같은 조각이 두 번 적재되지 않게 한다.</div></div><div class="r" style="left:508.79999999999995px;top:168px;width:713.5680000000001px;height:448.32px;background:#0A1322;border-radius:9.600000000000001px"></div><div class="t m" style="left:537.5999999999999px;top:179.52px;width:655.9680000000001px;height:28.799999999999997px;font-size:16px;color:#A8B8CC;text-align:left;justify-content:center;"><span>pgvector 스키마</span></div><div class="t m" style="left:537.5999999999999px;top:216px;width:655.9680000000001px;height:390.72px;font-size:17.333333333333332px;color:#F1F5F9;text-align:left;justify-content:flex-start;"><span>CREATE TABLE document_chunks (
|
||||
id UUID PRIMARY KEY,
|
||||
document_id UUID NOT NULL REFERENCES documents(id),
|
||||
chunk_index INT NOT NULL,
|
||||
content TEXT NOT NULL,
|
||||
embedding VECTOR(1536),
|
||||
UNIQUE (document_id, chunk_index)
|
||||
);
|
||||
|
||||
CREATE INDEX idx_chunks_embedding
|
||||
ON document_chunks
|
||||
USING hnsw (embedding vector_cosine_ops);
|
||||
|
||||
-- 검색: 코사인 거리가 가까운 순서로 5건
|
||||
SELECT content FROM document_chunks
|
||||
ORDER BY embedding <=> :query_vec LIMIT 5;</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>RLS 정책은 역할과 명령의 표로 적는다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · DB 스키마 설계서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>16</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>RLS(Row Level Security)는 행 단위 권한이다. 같은 테이블이라도 사용자마다 보이는 행이 다르다</span></div><div class="r" style="left:57.599999999999994px;top:206.39999999999998px;width:1164.768px;height:48px;background:#22375A;border-radius:0px"></div><div class="t" style="left:78.72px;top:206.39999999999998px;width:190.71360000000004px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>테이블</span></div><div class="t" style="left:311.6736000000001px;top:206.39999999999998px;width:260.59968000000003px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>SELECT</span></div><div class="t" style="left:614.5132800000001px;top:206.39999999999998px;width:190.71360000000004px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>INSERT</span></div><div class="t" style="left:847.4668800000002px;top:206.39999999999998px;width:155.77056000000005px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>UPDATE</span></div><div class="t" style="left:1045.4774400000001px;top:206.39999999999998px;width:155.77056000000005px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>DELETE</span></div><div class="r" style="left:57.599999999999994px;top:254.39999999999998px;width:1164.768px;height:59.519999999999996px;background:#1A2B45;border-radius:0px"></div><div class="t m" style="left:78.72px;top:254.39999999999998px;width:190.71360000000004px;height:59.519999999999996px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>incidents</span></div><div class="t" style="left:311.6736000000001px;top:254.39999999999998px;width:260.59968000000003px;height:59.519999999999996px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>viewer는 본인 것, 운영자는 전체</span></div><div class="t" style="left:614.5132800000001px;top:254.39999999999998px;width:190.71360000000004px;height:59.519999999999996px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>operator / admin</span></div><div class="t" style="left:847.4668800000002px;top:254.39999999999998px;width:155.77056000000005px;height:59.519999999999996px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>operator / admin</span></div><div class="t" style="left:1045.4774400000001px;top:254.39999999999998px;width:155.77056000000005px;height:59.519999999999996px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>admin</span></div><div class="r" style="left:57.599999999999994px;top:313.92px;width:1164.768px;height:59.519999999999996px;background:#15233A;border-radius:0px"></div><div class="t m" style="left:78.72px;top:313.92px;width:190.71360000000004px;height:59.519999999999996px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>recovery_jobs</span></div><div class="t" style="left:311.6736000000001px;top:313.92px;width:260.59968000000003px;height:59.519999999999996px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>operator / admin</span></div><div class="t" style="left:614.5132800000001px;top:313.92px;width:190.71360000000004px;height:59.519999999999996px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>복구 서비스 전용</span></div><div class="t" style="left:847.4668800000002px;top:313.92px;width:155.77056000000005px;height:59.519999999999996px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>복구 서비스 전용</span></div><div class="t" style="left:1045.4774400000001px;top:313.92px;width:155.77056000000005px;height:59Line truncated
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>RLS 표는 정책 SQL로 옮긴다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · DB 스키마 설계서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>17</span></div><div class="t ul" style="left:57.599999999999994px;top:172.8px;width:412.79999999999995px;height:441.59999999999997px;font-size:21.333333333333332px;color:#CBD5E1;text-align:left;justify-content:flex-start;--gap:18.666666666666668px;"><div class="li">RLS를 켜면 정책에 없는 접근은 모두 거부된다.</div><div class="li">auth.uid()는 요청에 실린 JWT의 사용자 ID다.</div><div class="li">service_role 키는 RLS를 건너뛴다. 서버에만 두고 브라우저에 노출하지 않는다.</div><div class="li">다른 사용자의 토큰으로 조회해 0건이 나오는지 테스트한다.</div></div><div class="r" style="left:508.79999999999995px;top:168px;width:713.5680000000001px;height:377.76px;background:#0A1322;border-radius:9.600000000000001px"></div><div class="t m" style="left:537.5999999999999px;top:179.52px;width:655.9680000000001px;height:28.799999999999997px;font-size:16px;color:#A8B8CC;text-align:left;justify-content:center;"><span>Supabase RLS (형식 예시)</span></div><div class="t m" style="left:537.5999999999999px;top:216px;width:655.9680000000001px;height:320.15999999999997px;font-size:17.333333333333332px;color:#F1F5F9;text-align:left;justify-content:flex-start;"><span>ALTER TABLE incidents ENABLE ROW LEVEL SECURITY;
|
||||
|
||||
-- 본인이 등록한 장애만 조회
|
||||
CREATE POLICY incidents_select_own
|
||||
ON incidents FOR SELECT
|
||||
TO authenticated
|
||||
USING (created_by = auth.uid());
|
||||
|
||||
-- 자기 이름으로만 등록
|
||||
CREATE POLICY incidents_insert_own
|
||||
ON incidents FOR INSERT
|
||||
TO authenticated
|
||||
WITH CHECK (created_by = auth.uid());</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>JWT와 Redis 세션의 수명주기를 적는다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · DB 스키마 설계서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>18</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>PostgreSQL 밖에 저장하는 데이터도 스키마다. 키 이름 규칙과 만료 시간을 문서에 남긴다</span></div><div class="r" style="left:57.599999999999994px;top:240px;width:200.69760000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:72px;top:268.79999999999995px;width:171.8976px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>① 발급</span></div><div class="t" style="left:72px;top:331.20000000000005px;width:171.8976px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>Supabase Auth가
|
||||
JWT 발급</span></div><div class="t" style="left:258.29760000000005px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:298.61760000000004px;top:240px;width:200.69760000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:313.0176px;top:268.79999999999995px;width:171.8976px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>② 검증</span></div><div class="t" style="left:313.0176px;top:331.20000000000005px;width:171.8976px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>서명·만료·역할
|
||||
확인</span></div><div class="t" style="left:499.3152px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:539.6351999999999px;top:240px;width:200.69760000000002px;height:220.79999999999998px;background:#0F766E;border-radius:9.600000000000001px"></div><div class="t" style="left:554.0352px;top:268.79999999999995px;width:171.8976px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>③ 저장</span></div><div class="t m" style="left:554.0352px;top:331.20000000000005px;width:171.8976px;height:86.4px;font-size:18.666666666666668px;color:#F1F5F9;text-align:center;justify-content:flex-start;"><span>session:{id}
|
||||
TTL 30분</span></div><div class="t" style="left:740.3328px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:780.6528000000001px;top:240px;width:200.69760000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:795.0528px;top:268.79999999999995px;width:171.8976px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>④ 갱신</span></div><div class="t" style="left:795.0528px;top:331.20000000000005px;width:171.8976px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>요청마다 TTL
|
||||
갱신 정책 적용</span></div><div class="t" style="left:981.3504px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:1021.6704px;top:240px;width:200.69760000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:1036.0704px;top:268.79999999999995px;width:171.8976px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>⑤ 폐기</span></div><div class="t" style="left:1036.0704px;top:331.20000000000005px;width:171.8976px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>로그아웃·만료 시
|
||||
세션 삭제</span></div><div class="r" style="left:57.599999999999994px;top:513.5999999999999px;width:1164.768px;height:71.03999999999999px;background:#0A1322;border-radius:7.68px"></div><div class="t" style="left:86.39999999999999px;top:513.5999999999999px;width:1107.1680000000001px;height:71.03999999999999px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>JWT의 만료 시간과 Redis의 TTL은 서로 다른 값이다. 둘 다 적고, 어느 쪽이 먼저 끝나면 어떻게 되는지도 적는다.</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>인덱스는 자주 쓰는 조회에서 출발한다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · DB 스키마 설계서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>19</span></div><div class="r" style="left:57.599999999999994px;top:168px;width:567.984px;height:225.60000000000002px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:196.79999999999998px;width:510.384px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>API 목록의 GET부터 본다</span></div><div class="t" style="left:86.39999999999999px;top:249.59999999999997px;width:510.384px;height:38.400000000000006px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>어떤 조건으로 찾고 정렬하는가.</span></div><div class="r" style="left:86.39999999999999px;top:310.0799999999999px;width:510.384px;height:54.720000000000006px;background:#0A1322;border-radius:5.76px"></div><div class="t m" style="left:103.67999999999998px;top:310.0799999999999px;width:475.824px;height:54.720000000000006px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>GET /incidents?status=open</span></div><div class="r" style="left:654.384px;top:168px;width:567.984px;height:225.60000000000002px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:683.184px;top:196.79999999999998px;width:510.384px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>조건과 정렬을 묶어 만든다</span></div><div class="t" style="left:683.184px;top:249.59999999999997px;width:510.384px;height:38.400000000000006px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>필터 컬럼 먼저, 정렬 컬럼 다음.</span></div><div class="r" style="left:683.184px;top:310.0799999999999px;width:510.384px;height:54.720000000000006px;background:#0A1322;border-radius:5.76px"></div><div class="t m" style="left:700.4639999999999px;top:310.0799999999999px;width:475.824px;height:54.720000000000006px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>INDEX incidents (status, created_at DESC)</span></div><div class="r" style="left:57.599999999999994px;top:422.40000000000003px;width:567.984px;height:225.60000000000002px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:451.20000000000005px;width:510.384px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>실행 계획으로 확인한다</span></div><div class="t" style="left:86.39999999999999px;top:504px;width:510.384px;height:38.400000000000006px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>인덱스 전후 결과를 문서에 싣는다.</span></div><div class="r" style="left:86.39999999999999px;top:564.48px;width:510.384px;height:54.720000000000006px;background:#0A1322;border-radius:5.76px"></div><div class="t m" style="left:103.67999999999998px;top:564.48px;width:475.824px;height:54.720000000000006px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>EXPLAIN ANALYZE SELECT …</span></div><div class="r" style="left:654.384px;top:422.40000000000003px;width:567.984px;height:225.60000000000002px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:683.184px;top:451.20000000000005px;width:510.384px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>벡터 인덱스는 짝을 맞춘다</span></div><div class="t" style="left:683.184px;top:504px;width:510.384px;height:38.400000000000006px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>차원, 연산자, 검색식이 같아야 한다.</span></div><div class="r" style="left:683.184px;top:564.48px;width:510.384px;height:54.720000000000006px;background:#0A1322;border-radius:5.76px"></div><div class="t m" style="left:700.4639999999999px;top:564.48px;width:475.824px;height:54.720000000000006px;font-size:18.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>vector_cosine_ops ↔ <=></span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>다른 산출물과 같은 이름을 쓴다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · DB 스키마 설계서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>20</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>DB 스키마는 거의 모든 산출물이 참조한다. 이름이 어긋나면 전체가 어긋난다</span></div><div class="r" style="left:57.599999999999994px;top:206.39999999999998px;width:567.984px;height:206.39999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:235.2px;width:510.384px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>API 설계 문서</span></div><div class="t" style="left:86.39999999999999px;top:273.59999999999997px;width:510.384px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>필드명과 컬럼명을 맞춘다</span></div><div class="t" style="left:86.39999999999999px;top:326.4px;width:510.384px;height:57.60000000000005px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>incident_id, approval_id와 ID 형식을 똑같이 쓴다.</span></div><div class="r" style="left:654.384px;top:206.39999999999998px;width:567.984px;height:206.39999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:683.184px;top:235.2px;width:510.384px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>에이전트 설계서</span></div><div class="t" style="left:683.184px;top:273.59999999999997px;width:510.384px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>메모리가 저장되는 곳</span></div><div class="t" style="left:683.184px;top:326.4px;width:510.384px;height:57.60000000000005px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>체크포인트와 장기 메모리(pgvector)의 테이블을 밝힌다.</span></div><div class="r" style="left:57.599999999999994px;top:441.59999999999997px;width:567.984px;height:206.39999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:470.4px;width:510.384px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>AI 보안 가드레일 문서</span></div><div class="t" style="left:86.39999999999999px;top:508.79999999999995px;width:510.384px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>RLS 표가 권한표다</span></div><div class="t" style="left:86.39999999999999px;top:561.5999999999999px;width:510.384px;height:57.60000000000005px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>역할별 권한이 두 문서에서 같아야 한다.</span></div><div class="r" style="left:654.384px;top:441.59999999999997px;width:567.984px;height:206.39999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:683.184px;top:470.4px;width:510.384px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>통합 테스트 결과서</span></div><div class="t" style="left:683.184px;top:508.79999999999995px;width:510.384px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>차단되는지 확인한다</span></div><div class="t" style="left:683.184px;top:561.5999999999999px;width:510.384px;height:57.60000000000005px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>권한 없는 조회가 막히는 것이 테스트 케이스다.</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>자주 나오는 실수와 고치는 법</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · DB 스키마 설계서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>21</span></div><div class="r" style="left:57.599999999999994px;top:168px;width:1164.768px;height:48px;background:#22375A;border-radius:0px"></div><div class="t" style="left:78.72px;top:168px;width:540.144px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>실수</span></div><div class="t" style="left:661.104px;top:168px;width:540.144px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>이렇게 고친다</span></div><div class="r" style="left:57.599999999999994px;top:216px;width:1164.768px;height:74.88px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:216px;width:540.144px;height:74.88px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>같은 컬럼이 문서 안에서 이름이 다르다
|
||||
(created_by 와 owner_id)</span></div><div class="t" style="left:661.104px;top:216px;width:540.144px;height:74.88px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>엔터티 정의 표를 기준으로 삼아 ERD와 관계 표를 맞춘다</span></div><div class="r" style="left:57.599999999999994px;top:290.88px;width:1164.768px;height:74.88px;background:#15233A;border-radius:0px"></div><div class="t" style="left:78.72px;top:290.88px;width:540.144px;height:74.88px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>ID 형식이 API 문서와 다르다
|
||||
(UUID라고 적고 예시는 inc-001)</span></div><div class="t" style="left:661.104px;top:290.88px;width:540.144px;height:74.88px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>형식을 하나로 정하고 두 문서를 함께 고친다</span></div><div class="r" style="left:57.599999999999994px;top:365.76000000000005px;width:1164.768px;height:74.88px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:365.76000000000005px;width:540.144px;height:74.88px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>ERD 그림만 있고 제약이 없다</span></div><div class="t" style="left:661.104px;top:365.76000000000005px;width:540.144px;height:74.88px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>PK·FK·NOT NULL·UNIQUE를 컬럼마다 적는다</span></div><div class="r" style="left:57.599999999999994px;top:440.6400000000001px;width:1164.768px;height:74.88px;background:#15233A;border-radius:0px"></div><div class="t" style="left:78.72px;top:440.6400000000001px;width:540.144px;height:74.88px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>임베딩 모델의 차원과 VECTOR(n)이 다르다</span></div><div class="t" style="left:661.104px;top:440.6400000000001px;width:540.144px;height:74.88px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>모델 이름과 차원을 컬럼 옆에 함께 기록한다</span></div><div class="r" style="left:57.599999999999994px;top:515.5200000000001px;width:1164.768px;height:74.88px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:515.5200000000001px;width:540.144px;height:74.88px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>RLS를 켜지 않고 service_role로만 접근한다</span></div><div class="t" style="left:661.104px;top:515.5200000000001px;width:540.144px;height:74.88px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>테이블마다 RLS 표를 만들고 차단 테스트를 남긴다</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>제출 전 체크리스트</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · DB 스키마 설계서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>22</span></div><div class="r" style="left:57.599999999999994px;top:168px;width:570.384px;height:91.19999999999999px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="r" style="left:86.39999999999999px;top:199.20000000000002px;width:28.799999999999997px;height:28.799999999999997px;background:#1A2B45;border:1.6px solid #2DD4BF;border-radius:3.84px"></div><div class="t" style="left:139.2px;top:168px;width:464.784px;height:91.19999999999999px;font-size:20px;color:#F1F5F9;text-align:left;justify-content:center;"><span>ERD 그림과 관계 명세 표가 서로 일치한다</span></div><div class="r" style="left:57.599999999999994px;top:283.20000000000005px;width:570.384px;height:91.19999999999999px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="r" style="left:86.39999999999999px;top:314.40000000000003px;width:28.799999999999997px;height:28.799999999999997px;background:#1A2B45;border:1.6px solid #2DD4BF;border-radius:3.84px"></div><div class="t" style="left:139.2px;top:283.20000000000005px;width:464.784px;height:91.19999999999999px;font-size:20px;color:#F1F5F9;text-align:left;justify-content:center;"><span>모든 컬럼에 타입·제약·의미가 적혀 있다</span></div><div class="r" style="left:57.599999999999994px;top:398.40000000000003px;width:570.384px;height:91.19999999999999px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="r" style="left:86.39999999999999px;top:429.59999999999997px;width:28.799999999999997px;height:28.799999999999997px;background:#1A2B45;border:1.6px solid #2DD4BF;border-radius:3.84px"></div><div class="t" style="left:139.2px;top:398.40000000000003px;width:464.784px;height:91.19999999999999px;font-size:20px;color:#F1F5F9;text-align:left;justify-content:center;"><span>모든 테이블에 기본키와 created_at이 있다</span></div><div class="r" style="left:57.599999999999994px;top:513.5999999999999px;width:570.384px;height:91.19999999999999px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="r" style="left:86.39999999999999px;top:544.8px;width:28.799999999999997px;height:28.799999999999997px;background:#1A2B45;border:1.6px solid #2DD4BF;border-radius:3.84px"></div><div class="t" style="left:139.2px;top:513.5999999999999px;width:464.784px;height:91.19999999999999px;font-size:20px;color:#F1F5F9;text-align:left;justify-content:center;"><span>API 설계 문서와 필드명·ID 형식이 같다</span></div><div class="r" style="left:651.984px;top:168px;width:570.384px;height:91.19999999999999px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="r" style="left:680.784px;top:199.20000000000002px;width:28.799999999999997px;height:28.799999999999997px;background:#1A2B45;border:1.6px solid #2DD4BF;border-radius:3.84px"></div><div class="t" style="left:733.584px;top:168px;width:464.784px;height:91.19999999999999px;font-size:20px;color:#F1F5F9;text-align:left;justify-content:center;"><span>벡터 차원, 인덱스 연산자, 임베딩 모델이 적혀 있다</span></div><div class="r" style="left:651.984px;top:283.20000000000005px;width:570.384px;height:91.19999999999999px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="r" style="left:680.784px;top:314.40000000000003px;width:28.799999999999997px;height:28.799999999999997px;background:#1A2B45;border:1.6px solid #2DD4BF;border-radius:3.84px"></div><div class="t" style="left:733.584px;top:283.20000000000005px;width:464.784px;height:91.19999999999999px;font-size:20px;color:#F1F5F9;text-align:left;justify-content:center;"><span>테이블마다 역할별 RLS 표가 있다</span></div><div class="r" style="left:651.984px;top:398.40000000000003px;width:570.384px;height:91.19999999999999px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="r" style="left:680.784px;top:429.59999999999997px;width:28.799999999999997px;height:28.799999999999997px;background:#1A2B45;border:1.6px solid #2DD4BF;border-radius:3.84px"></div><div class="t" style="left:733.584px;top:398.40000000000003px;width:464.784px;height:91.19999999999999px;font-size:20px;color:#F1F5F9;text-align:left;justify-content:center;"><span>Redis 키 이름 규칙과 TTL이 적혀 있다</span></div><div class="r" style="left:651.984px;top:513.5999Line truncated
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>오늘 팀에서 할 일</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · DB 스키마 설계서 작성법</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>23</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>API 설계 문서를 옆에 펼쳐 놓고 시작한다</span></div><div class="r" style="left:57.599999999999994px;top:240px;width:260.952px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:72px;top:268.79999999999995px;width:232.15200000000004px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>① 테이블 목록</span></div><div class="t" style="left:72px;top:331.20000000000005px;width:232.15200000000004px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>API 필드에서
|
||||
저장할 대상 뽑기</span></div><div class="t" style="left:318.552px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:358.872px;top:240px;width:260.952px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:373.27200000000005px;top:268.79999999999995px;width:232.15200000000004px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>② ERD와 관계 표</span></div><div class="t" style="left:373.27200000000005px;top:331.20000000000005px;width:232.15200000000004px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>키 컬럼과
|
||||
1:N 관계 그리기</span></div><div class="t" style="left:619.8240000000001px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:660.144px;top:240px;width:260.952px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:674.5440000000001px;top:268.79999999999995px;width:232.15200000000004px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>③ 엔터티 정의</span></div><div class="t" style="left:674.5440000000001px;top:331.20000000000005px;width:232.15200000000004px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>핵심 테이블의
|
||||
SQL 실행까지</span></div><div class="t" style="left:921.0960000000001px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:961.4160000000002px;top:240px;width:260.952px;height:220.79999999999998px;background:#0F766E;border-radius:9.600000000000001px"></div><div class="t" style="left:975.8160000000001px;top:268.79999999999995px;width:232.15200000000004px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>④ RLS 표 초안</span></div><div class="t" style="left:975.8160000000001px;top:331.20000000000005px;width:232.15200000000004px;height:86.4px;font-size:18.666666666666668px;color:#F1F5F9;text-align:center;justify-content:flex-start;"><span>역할별 권한을
|
||||
팀이 함께 정하기</span></div><div class="r" style="left:57.599999999999994px;top:513.5999999999999px;width:1164.768px;height:71.03999999999999px;background:#0A1322;border-radius:7.68px"></div><div class="t" style="left:86.39999999999999px;top:513.5999999999999px;width:1107.1680000000001px;height:71.03999999999999px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>문서 머리말에 문서 버전과 작성 상태를 적는다. 예: 문서 버전 v0.1 | 작성 상태: 초안</span></div></section>
|
||||
</main>
|
||||
<div class="bar" id="bar"></div>
|
||||
<script>
|
||||
(function(){
|
||||
var stage=document.querySelector('.stage'),slides=[].slice.call(document.querySelectorAll('.slide')),i=0,present=true,bar=document.getElementById('bar');
|
||||
function fit(){
|
||||
var s=present?Math.min(innerWidth/1280,innerHeight/720):Math.min(1,(innerWidth-32)/1280);
|
||||
stage.style.transform='scale('+s+')';
|
||||
stage.style.marginLeft=Math.max(0,(innerWidth-1280*s)/2)+'px';
|
||||
stage.style.marginTop=present?Math.max(0,(innerHeight-720*s)/2)+'px':'16px';
|
||||
stage.style.height=present?'720px':'';
|
||||
}
|
||||
function show(){
|
||||
document.body.classList.toggle('present',present);
|
||||
slides.forEach(function(el,k){el.classList.toggle('on',k===i)});
|
||||
bar.textContent=present?(i+1)+' / '+slides.length+' · ←/→ 이동 · O 전체 보기 · F 전체 화면':'O 발표 보기 · 인쇄(Ctrl/⌘+P)로 PDF 저장';
|
||||
fit(); if(!present) slides[i].scrollIntoView();
|
||||
}
|
||||
function go(d){i=Math.max(0,Math.min(slides.length-1,i+d));show()}
|
||||
addEventListener('keydown',function(e){
|
||||
if(['ArrowRight','PageDown',' ','Enter'].indexOf(e.key)>=0){e.preventDefault();go(1)}
|
||||
else if(['ArrowLeft','PageUp','Backspace'].indexOf(e.key)>=0){e.preventDefault();go(-1)}
|
||||
else if(e.key==='Home'){i=0;show()} else if(e.key==='End'){i=slides.length-1;show()}
|
||||
else if(e.key==='o'||e.key==='O'){present=!present;show()}
|
||||
else if(e.key==='f'||e.key==='F'){document.fullscreenElement?document.exitFullscreen():document.documentElement.requestFullscreen()}
|
||||
});
|
||||
stage.addEventListener('click',function(e){if(present)go(e.clientX<innerWidth/3?-1:1)});
|
||||
addEventListener('resize',fit); show();
|
||||
})();
|
||||
</script>
|
||||
</body></html>
|
||||
Binary file not shown.
@@ -0,0 +1,156 @@
|
||||
<!DOCTYPE html>
|
||||
<html lang="ko"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
||||
<title>멀티 에이전트와 Auto-Healing 적용 가이드</title>
|
||||
<style>
|
||||
*{box-sizing:border-box;margin:0;padding:0}
|
||||
html,body{background:#060d18;color:#F1F5F9;font-family:"Noto Sans KR","Noto Sans CJK KR","Apple SD Gothic Neo","Malgun Gothic",sans-serif}
|
||||
.stage{width:1280px;transform-origin:0 0;margin:0 auto}
|
||||
.slide{position:relative;width:1280px;height:720px;background:#0F1B2D;overflow:hidden;margin:0 0 24px}
|
||||
.r,.t{position:absolute}
|
||||
.t{display:flex;flex-direction:column;line-height:1.38;white-space:pre-wrap;word-break:keep-all;overflow-wrap:anywhere;font-weight:400}
|
||||
.t.m{font-family:"D2Coding","Consolas","Menlo","DejaVu Sans Mono","Noto Sans KR","Noto Sans CJK KR",monospace;line-height:1.36;word-break:normal}
|
||||
.t.ul .li{padding-left:1.2em;text-indent:-1.2em;margin-bottom:var(--gap,12px)}
|
||||
.t.ul .li::before{content:"•";display:inline-block;width:1.2em;text-indent:0;color:#2DD4BF}
|
||||
.bar{position:fixed;right:14px;bottom:10px;font-size:12px;color:#A8B8CC;background:rgba(6,13,24,.8);padding:4px 10px;border-radius:12px;z-index:9}
|
||||
body.present{overflow:hidden}
|
||||
body.present .slide{display:none;margin:0}
|
||||
body.present .slide.on{display:block}
|
||||
@page{size:1280px 720px;margin:0}
|
||||
@media print{html,body{background:#0F1B2D}.bar{display:none}.stage{transform:none!important;margin:0!important}
|
||||
.slide,body.present .slide{display:block;margin:0;break-after:page;break-inside:avoid}
|
||||
*{-webkit-print-color-adjust:exact;print-color-adjust:exact}}
|
||||
</style></head><body>
|
||||
<main class="stage">
|
||||
<section class="slide"><h1 class="t" style="left:57.599999999999994px;top:211.20000000000002px;width:1056px;height:115.19999999999999px;font-size:64px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>멀티 에이전트와 Auto-Healing</span></h1><div class="t" style="left:57.599999999999994px;top:336px;width:1056px;height:48px;font-size:29.333333333333332px;color:#2DD4BF;text-align:left;justify-content:center;"><span>최종 프로젝트 적용 가이드 · 앞 과정에서 배운 것을 팀 서비스에 연결하기</span></div><div class="t" style="left:57.599999999999994px;top:398.40000000000003px;width:1056px;height:38.400000000000006px;font-size:20px;color:#A8B8CC;text-align:left;justify-content:center;"><span>AI 애플리케이션 개발 과정 · 최종 프로젝트 가이드</span></div><div class="r" style="left:57.599999999999994px;top:537.5999999999999px;width:297.216px;height:48px;background:#1A2B45;border-radius:24px"></div><div class="t m" style="left:57.599999999999994px;top:537.5999999999999px;width:297.216px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>Role · Tool · Contract</span></div><div class="r" style="left:378.81600000000003px;top:537.5999999999999px;width:149.952px;height:48px;background:#1A2B45;border-radius:24px"></div><div class="t m" style="left:378.81600000000003px;top:537.5999999999999px;width:149.952px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>max_steps</span></div><div class="r" style="left:552.768px;top:537.5999999999999px;width:229.248px;height:48px;background:#1A2B45;border-radius:24px"></div><div class="t m" style="left:552.768px;top:537.5999999999999px;width:229.248px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>retry → fallback</span></div><div class="r" style="left:806.0160000000001px;top:537.5999999999999px;width:183.93599999999998px;height:48px;background:#1A2B45;border-radius:24px"></div><div class="t m" style="left:806.0160000000001px;top:537.5999999999999px;width:183.93599999999998px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>incident log</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>세 개념은 서로 다른 질문에 답한다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · 멀티 에이전트와 Auto-Healing 적용 가이드</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>2</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>에이전트를 여러 개 만든다고 복구가 생기지 않고, 복구를 하려고 꼭 에이전트가 필요한 것도 아니다</span></div><div class="r" style="left:57.599999999999994px;top:206.39999999999998px;width:369.05600000000004px;height:316.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>멀티 에이전트</span></div><div class="t" style="left:86.39999999999999px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>누가 어떤 순서로?</span></div><div class="t" style="left:86.39999999999999px;top:326.4px;width:311.456px;height:168px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>역할, Tool 권한, 입출력 계약이 서로 다른 에이전트가 정해진 순서로 일을 나눈다.</span></div><div class="r" style="left:455.456px;top:206.39999999999998px;width:369.05600000000004px;height:316.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:484.256px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>자기 성찰</span></div><div class="t" style="left:484.256px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>답이 맞나?</span></div><div class="t" style="left:484.256px;top:326.4px;width:311.456px;height:168px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>응답은 왔지만 내용이 기준에 못 미칠 때, 평가하고 고쳐서 다시 낸다.</span></div><div class="r" style="left:853.3120000000001px;top:206.39999999999998px;width:369.05600000000004px;height:316.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:882.1120000000001px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>Auto-Healing</span></div><div class="t" style="left:882.1120000000001px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>시스템이 돌아가나?</span></div><div class="t" style="left:882.1120000000001px;top:326.4px;width:311.456px;height:168px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>호출이나 서비스가 고장 났을 때, 감지하고 복구한 뒤 정상인지 확인한다.</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>자주 하는 오해 네 가지</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · 멀티 에이전트와 Auto-Healing 적용 가이드</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>3</span></div><div class="r" style="left:57.599999999999994px;top:168px;width:1164.768px;height:48px;background:#22375A;border-radius:0px"></div><div class="t" style="left:78.72px;top:168px;width:446.96255999999994px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>오해</span></div><div class="t" style="left:567.92256px;top:168px;width:633.32544px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>실제</span></div><div class="r" style="left:57.599999999999994px;top:216px;width:1164.768px;height:76.80000000000001px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:216px;width:446.96255999999994px;height:76.80000000000001px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>프롬프트를 여러 번 호출하면 멀티 에이전트다</span></div><div class="t" style="left:567.92256px;top:216px;width:633.32544px;height:76.80000000000001px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>역할·권한·계약이 같다면 함수를 여러 번 부른 다단계 체인이다</span></div><div class="r" style="left:57.599999999999994px;top:292.79999999999995px;width:1164.768px;height:76.80000000000001px;background:#15233A;border-radius:0px"></div><div class="t" style="left:78.72px;top:292.79999999999995px;width:446.96255999999994px;height:76.80000000000001px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>LangGraph를 쓰면 멀티 에이전트다</span></div><div class="t" style="left:567.92256px;top:292.79999999999995px;width:633.32544px;height:76.80000000000001px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>프레임워크가 아니라 구조가 기준이다. 역할, 상태, 전이를 실제로 연결해야 한다</span></div><div class="r" style="left:57.599999999999994px;top:369.59999999999997px;width:1164.768px;height:76.80000000000001px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:369.59999999999997px;width:446.96255999999994px;height:76.80000000000001px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>재시도를 붙이면 Auto-Healing이다</span></div><div class="t" style="left:567.92256px;top:369.59999999999997px;width:633.32544px;height:76.80000000000001px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>재시도는 복구 수단 하나다. 감지, 분류, 검증, 기록이 이어져야 한다</span></div><div class="r" style="left:57.599999999999994px;top:446.4px;width:1164.768px;height:76.80000000000001px;background:#15233A;border-radius:0px"></div><div class="t" style="left:78.72px;top:446.4px;width:446.96255999999994px;height:76.80000000000001px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>LLM에게 "다시 해 봐"라고 하면 복구된다</span></div><div class="t" style="left:567.92256px;top:446.4px;width:633.32544px;height:76.80000000000001px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>합격 기준은 코드가 검사하고, 복구 순서는 미리 정해 둔다</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>개념마다 대응하는 산출물이 있다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · 멀티 에이전트와 Auto-Healing 적용 가이드</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>4</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>STEP 3과 STEP 4의 문서는 아래 질문에 대한 팀의 답을 적는 것이다</span></div><div class="r" style="left:57.599999999999994px;top:240px;width:200.69760000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:72px;top:268.79999999999995px;width:171.8976px;height:76.80000000000001px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>상태 전이
|
||||
그래프 설계서</span></div><div class="t" style="left:72px;top:355.20000000000005px;width:171.8976px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>STEP 3
|
||||
누가 어떤 순서로</span></div><div class="t" style="left:258.29760000000005px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:298.61760000000004px;top:240px;width:200.69760000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:313.0176px;top:268.79999999999995px;width:171.8976px;height:76.80000000000001px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>자기 성찰
|
||||
테스트 결과서</span></div><div class="t" style="left:313.0176px;top:355.20000000000005px;width:171.8976px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>STEP 3
|
||||
답이 맞나</span></div><div class="t" style="left:499.3152px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:539.6351999999999px;top:240px;width:200.69760000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:554.0352px;top:268.79999999999995px;width:171.8976px;height:76.80000000000001px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>협업 아키텍처
|
||||
설계서</span></div><div class="t" style="left:554.0352px;top:355.20000000000005px;width:171.8976px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>STEP 4
|
||||
역할과 인계</span></div><div class="t" style="left:740.3328px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:780.6528000000001px;top:240px;width:200.69760000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:795.0528px;top:268.79999999999995px;width:171.8976px;height:76.80000000000001px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>보안 가드레일
|
||||
설계 문서</span></div><div class="t" style="left:795.0528px;top:355.20000000000005px;width:171.8976px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>STEP 4
|
||||
해도 되는 일인가</span></div><div class="t" style="left:981.3504px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:1021.6704px;top:240px;width:200.69760000000002px;height:220.79999999999998px;background:#0F766E;border-radius:9.600000000000001px"></div><div class="t" style="left:1036.0704px;top:268.79999999999995px;width:171.8976px;height:76.80000000000001px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>Auto-Healing
|
||||
구현 결과서</span></div><div class="t" style="left:1036.0704px;top:355.20000000000005px;width:171.8976px;height:86.4px;font-size:18.666666666666668px;color:#F1F5F9;text-align:center;justify-content:flex-start;"><span>STEP 4
|
||||
시스템이 돌아가나</span></div><div class="r" style="left:57.599999999999994px;top:513.5999999999999px;width:1164.768px;height:71.03999999999999px;background:#0A1322;border-radius:7.68px"></div><div class="t" style="left:86.39999999999999px;top:513.5999999999999px;width:1107.1680000000001px;height:71.03999999999999px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>평가는 문서가 있는지가 아니라 설계·구현·검증이 이어지는지를 본다. 같은 실행 ID와 같은 이름으로 문서를 잇는다.</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>에이전트, 도구, 오케스트레이터를 구분한다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · 멀티 에이전트와 Auto-Healing 적용 가이드</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>5</span></div><div class="r" style="left:57.599999999999994px;top:168px;width:1164.768px;height:48px;background:#22375A;border-radius:0px"></div><div class="t" style="left:78.72px;top:168px;width:190.71360000000004px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>구성 요소</span></div><div class="t" style="left:311.6736000000001px;top:168px;width:446.96255999999994px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>하는 일</span></div><div class="t" style="left:800.87616px;top:168px;width:400.37184px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>예</span></div><div class="r" style="left:57.599999999999994px;top:216px;width:1164.768px;height:53.760000000000005px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:216px;width:190.71360000000004px;height:53.760000000000005px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>모델</span></div><div class="t" style="left:311.6736000000001px;top:216px;width:446.96255999999994px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>판단과 생성에 쓰는 엔진</span></div><div class="t" style="left:800.87616px;top:216px;width:400.37184px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>여러 역할이 같은 모델을 써도 된다</span></div><div class="r" style="left:57.599999999999994px;top:269.76px;width:1164.768px;height:53.760000000000005px;background:#15233A;border-radius:0px"></div><div class="t" style="left:78.72px;top:269.76px;width:190.71360000000004px;height:53.760000000000005px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>에이전트</span></div><div class="t" style="left:311.6736000000001px;top:269.76px;width:446.96255999999994px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>맡은 역할에 따라 판단하고 결과를 만든다</span></div><div class="t" style="left:800.87616px;top:269.76px;width:400.37184px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>요청 분석, 초안 작성, 근거 검토</span></div><div class="r" style="left:57.599999999999994px;top:323.52px;width:1164.768px;height:53.760000000000005px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:323.52px;width:190.71360000000004px;height:53.760000000000005px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>도구 · API</span></div><div class="t" style="left:311.6736000000001px;top:323.52px;width:446.96255999999994px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>정해진 입력으로 작업을 실행한다</span></div><div class="t" style="left:800.87616px;top:323.52px;width:400.37184px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>DB 조회, 문서 검색, 예약 저장</span></div><div class="r" style="left:57.599999999999994px;top:377.28000000000003px;width:1164.768px;height:53.760000000000005px;background:#15233A;border-radius:0px"></div><div class="t" style="left:78.72px;top:377.28000000000003px;width:190.71360000000004px;height:53.760000000000005px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>오케스트레이터</span></div><div class="t" style="left:311.6736000000001px;top:377.28000000000003px;width:446.96255999999994px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>순서, 상태, 전이, 상한을 통제한다</span></div><div class="t" style="left:800.87616px;top:377.28000000000003px;width:40Line truncated
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>에이전트를 나눠도 되는 네 가지 이유</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · 멀티 에이전트와 Auto-Healing 적용 가이드</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>6</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>이 중 하나로 설명되지 않으면 나누지 않는다. 에이전트가 늘면 비용, 지연, 오류 경로도 늘어난다</span></div><div class="r" style="left:57.599999999999994px;top:206.39999999999998px;width:567.984px;height:206.39999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:235.2px;width:510.384px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>권한</span></div><div class="t" style="left:86.39999999999999px;top:273.59999999999997px;width:510.384px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>Tool 권한이 다르다</span></div><div class="t" style="left:86.39999999999999px;top:326.4px;width:510.384px;height:57.60000000000005px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>조회만 하는 역할과 실행하는 역할을 나누면, 진단 담당이 복구를 실행할 수 없다.</span></div><div class="r" style="left:654.384px;top:206.39999999999998px;width:567.984px;height:206.39999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:683.184px;top:235.2px;width:510.384px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>병렬</span></div><div class="t" style="left:683.184px;top:273.59999999999997px;width:510.384px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>동시에 할 수 있다</span></div><div class="t" style="left:683.184px;top:326.4px;width:510.384px;height:57.60000000000005px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>서로 독립인 조회를 동시에 실행하고 결과를 합친다.</span></div><div class="r" style="left:57.599999999999994px;top:441.59999999999997px;width:567.984px;height:206.39999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:470.4px;width:510.384px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>검증</span></div><div class="t" style="left:86.39999999999999px;top:508.79999999999995px;width:510.384px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>생성과 검증을 분리한다</span></div><div class="t" style="left:86.39999999999999px;top:561.5999999999999px;width:510.384px;height:57.60000000000005px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>글을 쓴 역할이 자기 글을 평가하지 않게 한다.</span></div><div class="r" style="left:654.384px;top:441.59999999999997px;width:567.984px;height:206.39999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:683.184px;top:470.4px;width:510.384px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>추적</span></div><div class="t" style="left:683.184px;top:508.79999999999995px;width:510.384px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>책임을 추적해야 한다</span></div><div class="t" style="left:683.184px;top:561.5999999999999px;width:510.384px;height:57.60000000000005px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>누가 무엇을 넘겼는지 기록으로 남겨야 하는 업무다.</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>에이전트마다 네 가지를 정한다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · 멀티 에이전트와 Auto-Healing 적용 가이드</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>7</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>협업 아키텍처 설계서의 역할 표가 이 네 칸으로 이루어진다</span></div><div class="r" style="left:57.599999999999994px;top:206.39999999999998px;width:567.984px;height:206.39999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:235.2px;width:510.384px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>01</span></div><div class="t" style="left:86.39999999999999px;top:273.59999999999997px;width:510.384px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>역할</span></div><div class="t" style="left:86.39999999999999px;top:326.4px;width:510.384px;height:57.60000000000005px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>무엇을 하는지와 함께, 무엇을 하지 않는지를 적는다.</span></div><div class="r" style="left:654.384px;top:206.39999999999998px;width:567.984px;height:206.39999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:683.184px;top:235.2px;width:510.384px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>02</span></div><div class="t" style="left:683.184px;top:273.59999999999997px;width:510.384px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>입출력 계약</span></div><div class="t" style="left:683.184px;top:326.4px;width:510.384px;height:57.60000000000005px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>Pydantic 스키마로 정한다. 검증을 통과한 결과만 다음 역할로 넘긴다.</span></div><div class="r" style="left:57.599999999999994px;top:441.59999999999997px;width:567.984px;height:206.39999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:470.4px;width:510.384px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>03</span></div><div class="t" style="left:86.39999999999999px;top:508.79999999999995px;width:510.384px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>Tool 권한</span></div><div class="t" style="left:86.39999999999999px;top:561.5999999999999px;width:510.384px;height:57.60000000000005px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>역할마다 허용 Tool 목록을 둔다. 목록 밖의 호출은 코드가 거부한다.</span></div><div class="r" style="left:654.384px;top:441.59999999999997px;width:567.984px;height:206.39999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:683.184px;top:470.4px;width:510.384px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>04</span></div><div class="t" style="left:683.184px;top:508.79999999999995px;width:510.384px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>종료 조건</span></div><div class="t" style="left:683.184px;top:561.5999999999999px;width:510.384px;height:57.60000000000005px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>최대 단계 수, 통과 조건, 실패했을 때의 행동을 정한다.</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>역할 카드와 계약을 코드로 적는다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · 멀티 에이전트와 Auto-Healing 적용 가이드</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>8</span></div><div class="t ul" style="left:57.599999999999994px;top:172.8px;width:412.79999999999995px;height:441.59999999999997px;font-size:21.333333333333332px;color:#CBD5E1;text-align:left;justify-content:flex-start;--gap:18.666666666666668px;"><div class="li">non_goals를 적어야 역할이 겹치지 않는다.</div><div class="li">allowed_tools 밖의 Tool은 호출할 수 없다.</div><div class="li">근거가 없는 답은 계약에서 걸러진다.</div><div class="li">앞 호출이 끝난 것과, 다음 역할이 쓸 결과가 준비된 것은 다르다.</div></div><div class="r" style="left:508.79999999999995px;top:168px;width:713.5680000000001px;height:471.84000000000003px;background:#0A1322;border-radius:9.600000000000001px"></div><div class="t m" style="left:537.5999999999999px;top:179.52px;width:655.9680000000001px;height:28.799999999999997px;font-size:16px;color:#A8B8CC;text-align:left;justify-content:center;"><span>agents.py (형식 예시)</span></div><div class="t m" style="left:537.5999999999999px;top:216px;width:655.9680000000001px;height:414.24px;font-size:17.333333333333332px;color:#F1F5F9;text-align:left;justify-content:flex-start;"><span>from pydantic import BaseModel, Field
|
||||
|
||||
class DraftResult(BaseModel):
|
||||
answer: str = Field(min_length=1)
|
||||
evidence_ids: list[str] = Field(min_length=1)
|
||||
|
||||
WRITER = {
|
||||
"role": "초안 작성",
|
||||
"non_goals": ["품질 평가", "외부 시스템 변경"],
|
||||
"allowed_tools": frozenset({"search_docs"}),
|
||||
"output": DraftResult,
|
||||
"max_steps": 3,
|
||||
}
|
||||
|
||||
def handoff(raw: dict) -> DraftResult:
|
||||
# 계약을 통과한 결과만 다음 역할로 넘긴다
|
||||
return DraftResult.model_validate(raw)</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>다섯 가지 협업 패턴에서 고른다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · 멀티 에이전트와 Auto-Healing 적용 가이드</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>9</span></div><div class="r" style="left:57.599999999999994px;top:168px;width:1164.768px;height:48px;background:#22375A;border-radius:0px"></div><div class="t" style="left:78.72px;top:168px;width:237.30432000000002px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>패턴</span></div><div class="t" style="left:358.26432000000005px;top:168px;width:446.96255999999994px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>언제 쓰나</span></div><div class="t" style="left:847.4668800000001px;top:168px;width:353.78112000000004px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>예</span></div><div class="r" style="left:57.599999999999994px;top:216px;width:1164.768px;height:53.760000000000005px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:216px;width:237.30432000000002px;height:53.760000000000005px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>Sequential</span></div><div class="t" style="left:358.26432000000005px;top:216px;width:446.96255999999994px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>앞 결과가 다음 역할의 입력일 때</span></div><div class="t" style="left:847.4668800000001px;top:216px;width:353.78112000000004px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>분석 → 작성 → 검토</span></div><div class="r" style="left:57.599999999999994px;top:269.76px;width:1164.768px;height:53.760000000000005px;background:#15233A;border-radius:0px"></div><div class="t" style="left:78.72px;top:269.76px;width:237.30432000000002px;height:53.760000000000005px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>Parallel + Join</span></div><div class="t" style="left:358.26432000000005px;top:269.76px;width:446.96255999999994px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>독립인 조회를 동시에 하고 합칠 때</span></div><div class="t" style="left:847.4668800000001px;top:269.76px;width:353.78112000000004px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>날씨·장소·예산 → 일정</span></div><div class="r" style="left:57.599999999999994px;top:323.52px;width:1164.768px;height:53.760000000000005px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:323.52px;width:237.30432000000002px;height:53.760000000000005px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>Router</span></div><div class="t" style="left:358.26432000000005px;top:323.52px;width:446.96255999999994px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>요청 종류에 따라 한 곳으로 보낼 때</span></div><div class="t" style="left:847.4668800000001px;top:323.52px;width:353.78112000000004px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>조회 / 위험 작업 / 일반 질문</span></div><div class="r" style="left:57.599999999999994px;top:377.28000000000003px;width:1164.768px;height:53.760000000000005px;background:#15233A;border-radius:0px"></div><div class="t" style="left:78.72px;top:377.28000000000003px;width:237.30432000000002px;height:53.760000000000005px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>Supervisor–Worker</span></div><div class="t" style="left:358.26432000000005px;top:377.28000000000003px;width:446.96255999999994px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>관리자가 나누고 결과를 보며 다시 지시할 때</span></div><div class="t" style="left:847.4Line truncated
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>일부만 실패했을 때의 정책을 미리 정한다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · 멀티 에이전트와 Auto-Healing 적용 가이드</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>10</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>정책은 LLM이 즉석에서 정하지 않는다. 업무 요구사항으로 문서에 적어 둔다</span></div><div class="r" style="left:57.599999999999994px;top:206.39999999999998px;width:369.05600000000004px;height:316.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>Fail Fast</span></div><div class="t" style="left:86.39999999999999px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>하나라도 실패하면 중단</span></div><div class="t" style="left:86.39999999999999px;top:326.4px;width:311.456px;height:168px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>모든 결과가 있어야 의미가 있는 업무에 쓴다. 결제, 예약 확정이 그렇다.</span></div><div class="r" style="left:455.456px;top:206.39999999999998px;width:369.05600000000004px;height:316.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:484.256px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>Best Effort</span></div><div class="t" style="left:484.256px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>성공한 것으로 계속</span></div><div class="t" style="left:484.256px;top:326.4px;width:311.456px;height:168px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>일부가 빠져도 쓸모가 있을 때 쓴다. 빠진 정보는 결과에 표시한다.</span></div><div class="r" style="left:853.3120000000001px;top:206.39999999999998px;width:369.05600000000004px;height:316.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:882.1120000000001px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>Required / Optional</span></div><div class="t" style="left:882.1120000000001px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>필수만 성공하면 계속</span></div><div class="t" style="left:882.1120000000001px;top:326.4px;width:311.456px;height:168px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>역할마다 필수 여부를 정한다. 선택 결과 없이 진행한 것은 복구가 아니다.</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>자기 성찰은 생성과 평가를 분리한 루프다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · 멀티 에이전트와 Auto-Healing 적용 가이드</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>11</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>Writer가 쓰고, Evaluator가 기준별로 평가하고, Reviser가 피드백을 반영한다</span></div><div class="r" style="left:57.599999999999994px;top:240px;width:200.69760000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:72px;top:268.79999999999995px;width:171.8976px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>Writer</span></div><div class="t" style="left:72px;top:331.20000000000005px;width:171.8976px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>초안 생성</span></div><div class="t" style="left:258.29760000000005px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:298.61760000000004px;top:240px;width:200.69760000000002px;height:220.79999999999998px;background:#0F766E;border-radius:9.600000000000001px"></div><div class="t" style="left:313.0176px;top:268.79999999999995px;width:171.8976px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>Evaluator</span></div><div class="t" style="left:313.0176px;top:331.20000000000005px;width:171.8976px;height:86.4px;font-size:18.666666666666668px;color:#F1F5F9;text-align:center;justify-content:flex-start;"><span>기준별 평가,
|
||||
피드백 작성</span></div><div class="t" style="left:499.3152px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:539.6351999999999px;top:240px;width:200.69760000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:554.0352px;top:268.79999999999995px;width:171.8976px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>Reviser</span></div><div class="t" style="left:554.0352px;top:331.20000000000005px;width:171.8976px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>피드백을
|
||||
반영해 수정</span></div><div class="t" style="left:740.3328px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:780.6528000000001px;top:240px;width:200.69760000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:795.0528px;top:268.79999999999995px;width:171.8976px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>재평가</span></div><div class="t" style="left:795.0528px;top:331.20000000000005px;width:171.8976px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>통과하면
|
||||
바로 종료</span></div><div class="t" style="left:981.3504px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:1021.6704px;top:240px;width:200.69760000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:1036.0704px;top:268.79999999999995px;width:171.8976px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>상한 도달</span></div><div class="t" style="left:1036.0704px;top:331.20000000000005px;width:171.8976px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>failed로 종료,
|
||||
사람 검토</span></div><div class="r" style="left:57.599999999999994px;top:513.5999999999999px;width:1164.768px;height:71.03999999999999px;background:#0A1322;border-radius:7.68px"></div><div class="t" style="left:86.39999999999999px;top:513.5999999999999px;width:1107.1680000000001px;height:71.03999999999999px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>끝까지 통과하지 못하면 실패로 끝낸다. 통과하지 못한 결과를 성공인 것처럼 내보내지 않는다.</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>자기 성찰 루프의 네 가지 규칙</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · 멀티 에이전트와 Auto-Healing 적용 가이드</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>12</span></div><div class="r" style="left:57.599999999999994px;top:168px;width:567.984px;height:225.60000000000002px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:196.79999999999998px;width:510.384px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>기준</span></div><div class="t" style="left:86.39999999999999px;top:235.2px;width:510.384px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>평가 기준을 먼저 정한다</span></div><div class="t" style="left:86.39999999999999px;top:288px;width:510.384px;height:76.79999999999998px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>평균 점수 하나가 아니라, 어떤 기준에서 떨어졌는지 이름이 남게 한다.</span></div><div class="r" style="left:654.384px;top:168px;width:567.984px;height:225.60000000000002px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:683.184px;top:196.79999999999998px;width:510.384px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>검사</span></div><div class="t" style="left:683.184px;top:235.2px;width:510.384px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>검사할 수 있는 것은 코드로</span></div><div class="t" style="left:683.184px;top:288px;width:510.384px;height:76.79999999999998px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>스키마, 근거 유무, 금지 표현은 Python이 확인한다. LLM 평가는 그다음이다.</span></div><div class="r" style="left:57.599999999999994px;top:422.40000000000003px;width:567.984px;height:225.60000000000002px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:451.20000000000005px;width:510.384px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>피드백</span></div><div class="t" style="left:86.39999999999999px;top:489.6px;width:510.384px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>피드백은 구체적으로</span></div><div class="t" style="left:86.39999999999999px;top:542.4000000000001px;width:510.384px;height:76.79999999999998px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>어느 부분이 왜 틀렸는지를 Reviser에게 넘긴다. "다시 해 봐"는 피드백이 아니다.</span></div><div class="r" style="left:654.384px;top:422.40000000000003px;width:567.984px;height:225.60000000000002px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:683.184px;top:451.20000000000005px;width:510.384px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>상한</span></div><div class="t" style="left:683.184px;top:489.6px;width:510.384px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>반복 횟수를 코드로 제한</span></div><div class="t" style="left:683.184px;top:542.4000000000001px;width:510.384px;height:76.79999999999998px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>최대 횟수를 상수로 둔다. 끝나는 조건이 없는 루프는 버그다.</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>자기 성찰 테스트 결과서에 남길 것</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · 멀티 에이전트와 Auto-Healing 적용 가이드</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>13</span></div><div class="r" style="left:57.599999999999994px;top:168px;width:1164.768px;height:48px;background:#22375A;border-radius:0px"></div><div class="t" style="left:78.72px;top:168px;width:237.30432000000002px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>항목</span></div><div class="t" style="left:358.26432000000005px;top:168px;width:842.98368px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>내용</span></div><div class="r" style="left:57.599999999999994px;top:216px;width:1164.768px;height:53.760000000000005px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:216px;width:237.30432000000002px;height:53.760000000000005px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>평가 기준</span></div><div class="t" style="left:358.26432000000005px;top:216px;width:842.98368px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>기준의 이름과 합격 조건</span></div><div class="r" style="left:57.599999999999994px;top:269.76px;width:1164.768px;height:53.760000000000005px;background:#15233A;border-radius:0px"></div><div class="t" style="left:78.72px;top:269.76px;width:237.30432000000002px;height:53.760000000000005px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>시나리오</span></div><div class="t" style="left:358.26432000000005px;top:269.76px;width:842.98368px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>정상, 근거 누락, 잘못된 Tool 선택처럼 서로 다른 경우</span></div><div class="r" style="left:57.599999999999994px;top:323.52px;width:1164.768px;height:53.760000000000005px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:323.52px;width:237.30432000000002px;height:53.760000000000005px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>라운드별 기록</span></div><div class="t" style="left:358.26432000000005px;top:323.52px;width:842.98368px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>초기 응답 → 평가와 피드백 → 수정 → 최종 판정</span></div><div class="r" style="left:57.599999999999994px;top:377.28000000000003px;width:1164.768px;height:53.760000000000005px;background:#15233A;border-radius:0px"></div><div class="t" style="left:78.72px;top:377.28000000000003px;width:237.30432000000002px;height:53.760000000000005px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>종료 사유</span></div><div class="t" style="left:358.26432000000005px;top:377.28000000000003px;width:842.98368px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>통과, 상한 도달, 치명 오류 중 무엇으로 끝났나</span></div><div class="r" style="left:57.599999999999994px;top:431.04px;width:1164.768px;height:53.760000000000005px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:431.04px;width:237.30432000000002px;height:53.760000000000005px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>비용</span></div><div class="t" style="left:358.26432000000005px;top:431.04px;width:842.98368px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>반복 횟수, 토큰 사용량, 소요 시간</span></div><div class="r" style="left:57.599999999999994px;top:513.6px;width:1164.768px;height:71.03999999999999px;background:#0A1322;border-radius:7.68px"></div><div class="t" style="left:86.39999999999999px;top:513.6px;width:1107.1680000000001px;height:71.03999999999999px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>실행 로그나 추Line truncated
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>Auto-Healing은 여섯 단계의 운영 흐름이다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · 멀티 에이전트와 Auto-Healing 적용 가이드</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>14</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>장애를 마법처럼 해결하는 기능이 아니다. 감지하고, 전략을 고르고, 결과를 확인하는 흐름이다</span></div><div class="r" style="left:57.599999999999994px;top:240px;width:160.52800000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:72px;top:268.79999999999995px;width:131.728px;height:48px;font-size:21.333333333333332px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>① 감지</span></div><div class="t" style="left:72px;top:331.20000000000005px;width:131.728px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>timeout, 5xx,
|
||||
빈 응답</span></div><div class="t" style="left:218.128px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:258.44800000000004px;top:240px;width:160.52800000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:272.848px;top:268.79999999999995px;width:131.728px;height:48px;font-size:21.333333333333332px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>② 분류</span></div><div class="t" style="left:272.848px;top:331.20000000000005px;width:131.728px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>장애 유형
|
||||
판단</span></div><div class="t" style="left:418.976px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:459.29600000000005px;top:240px;width:160.52800000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:473.696px;top:268.79999999999995px;width:131.728px;height:48px;font-size:21.333333333333332px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>③ 전략 선택</span></div><div class="t" style="left:473.696px;top:331.20000000000005px;width:131.728px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>재시도, 대체,
|
||||
차단, 이관</span></div><div class="t" style="left:619.8240000000001px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:660.144px;top:240px;width:160.52800000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:674.5440000000001px;top:268.79999999999995px;width:131.728px;height:48px;font-size:21.333333333333332px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>④ 실행</span></div><div class="t" style="left:674.5440000000001px;top:331.20000000000005px;width:131.728px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>허용된 조치만
|
||||
제한적으로</span></div><div class="t" style="left:820.672px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:860.9920000000001px;top:240px;width:160.52800000000002px;height:220.79999999999998px;background:#0F766E;border-radius:9.600000000000001px"></div><div class="t" style="left:875.392px;top:268.79999999999995px;width:131.728px;height:48px;font-size:21.333333333333332px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>⑤ 검증</span></div><div class="t" style="left:875.392px;top:331.20000000000005px;width:131.728px;height:86.4px;font-size:18.666666666666668px;color:#F1F5F9;text-align:center;justify-content:flex-start;"><span>정상인지
|
||||
다시 확인</span></div><div class="t" style="left:1021.5200000000002px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:1061.8400000000001px;top:240px;width:160.52800000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:1076.2400000000002px;top:268.79999999999995px;width:131.728px;height:48px;font-size:21.333333333333332px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>⑥ 기록</span></div><div class="t" style="left:1076.2400000000002px;top:331.20000000000005px;width:131.728px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>전 과정을
|
||||
로그로</span></div><div class="r" style="left:57.599999999999994px;top:513.5999999999999px;width:1164.768px;height:71.03999999999999px;background:#0A1322;border-radius:7.68px"></div><div class="t" style="left:86.39999999999999px;top:513.5999999999999px;width:1107.1680000000001px;height:71.03999999999999px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>검증에 실패하면 다음 전략으로 넘어가거나 사람에게 넘긴다. 복구 후 검증이 없으면 복구했다고 말할 수 없다.</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>분류가 먼저다: 모든 오류를 재시도하지 않는다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · 멀티 에이전트와 Auto-Healing 적용 가이드</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>15</span></div><div class="r" style="left:57.599999999999994px;top:168px;width:1164.768px;height:48px;background:#22375A;border-radius:0px"></div><div class="t" style="left:78.72px;top:168px;width:307.1904px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>오류</span></div><div class="t" style="left:428.15039999999993px;top:168px;width:307.1904px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>다음 행동</span></div><div class="t" style="left:777.5808px;top:168px;width:423.6672000000001px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>이유</span></div><div class="r" style="left:57.599999999999994px;top:216px;width:1164.768px;height:53.760000000000005px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:216px;width:307.1904px;height:53.760000000000005px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>Timeout, 429, 5xx</span></div><div class="t" style="left:428.15039999999993px;top:216px;width:307.1904px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>재시도 후 대체 경로</span></div><div class="t" style="left:777.5808px;top:216px;width:423.6672000000001px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>일시적 오류다</span></div><div class="r" style="left:57.599999999999994px;top:269.76px;width:1164.768px;height:53.760000000000005px;background:#15233A;border-radius:0px"></div><div class="t" style="left:78.72px;top:269.76px;width:307.1904px;height:53.760000000000005px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>401 인증 실패</span></div><div class="t" style="left:428.15039999999993px;top:269.76px;width:307.1904px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>즉시 중단</span></div><div class="t" style="left:777.5808px;top:269.76px;width:423.6672000000001px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>다시 해도 안 된다. 키와 설정을 확인한다</span></div><div class="r" style="left:57.599999999999994px;top:323.52px;width:1164.768px;height:53.760000000000005px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:323.52px;width:307.1904px;height:53.760000000000005px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>입력 누락</span></div><div class="t" style="left:428.15039999999993px;top:323.52px;width:307.1904px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>재계획, 추가 질문</span></div><div class="t" style="left:777.5808px;top:323.52px;width:423.6672000000001px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>입력이나 계획이 잘못됐다</span></div><div class="r" style="left:57.599999999999994px;top:377.28000000000003px;width:1164.768px;height:53.760000000000005px;background:#15233A;border-radius:0px"></div><div class="t" style="left:78.72px;top:377.28000000000003px;width:307.1904px;height:53.760000000000005px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>권한 위반, Prompt Injection</span></div><div class="t" style="left:428.15039999999993px;top:377.28000000000003px;width:307.1904px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>차단</span></div><div class="t" style="left:777.5808px;top:377.28000000000003px;width:423.6672000000001px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>재시도는 정책을 반복Line truncated
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>복구는 정해진 순서로 한 계단씩 내려간다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · 멀티 에이전트와 Auto-Healing 적용 가이드</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>16</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>어떤 순서로 무엇을 시도할지는 장애가 나기 전에 정해 둔다</span></div><div class="r" style="left:57.599999999999994px;top:240px;width:260.952px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:72px;top:268.79999999999995px;width:232.15200000000004px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>① 재시도</span></div><div class="t" style="left:72px;top:331.20000000000005px;width:232.15200000000004px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>같은 작업을
|
||||
기다렸다 다시</span></div><div class="t" style="left:318.552px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:358.872px;top:240px;width:260.952px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:373.27200000000005px;top:268.79999999999995px;width:232.15200000000004px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>② 제공자 전환</span></div><div class="t" style="left:373.27200000000005px;top:331.20000000000005px;width:232.15200000000004px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>다른 LLM
|
||||
제공자로</span></div><div class="t" style="left:619.8240000000001px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:660.144px;top:240px;width:260.952px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:674.5440000000001px;top:268.79999999999995px;width:232.15200000000004px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>③ 대체 응답</span></div><div class="t" style="left:674.5440000000001px;top:331.20000000000005px;width:232.15200000000004px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>캐시, 규칙,
|
||||
검증된 템플릿</span></div><div class="t" style="left:921.0960000000001px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:961.4160000000002px;top:240px;width:260.952px;height:220.79999999999998px;background:#0F766E;border-radius:9.600000000000001px"></div><div class="t" style="left:975.8160000000001px;top:268.79999999999995px;width:232.15200000000004px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>④ 사람 이관</span></div><div class="t" style="left:975.8160000000001px;top:331.20000000000005px;width:232.15200000000004px;height:86.4px;font-size:18.666666666666668px;color:#F1F5F9;text-align:center;justify-content:flex-start;"><span>실패를 기록하고
|
||||
검토 요청</span></div><div class="r" style="left:57.599999999999994px;top:513.5999999999999px;width:1164.768px;height:71.03999999999999px;background:#0A1322;border-radius:7.68px"></div><div class="t" style="left:86.39999999999999px;top:513.5999999999999px;width:1107.1680000000001px;height:71.03999999999999px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>대체 응답을 썼으면 화면과 로그에 그렇게 표시한다. 정상 생성인 것처럼 보이게 하지 않는다.</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>복구 계단을 코드로 적는다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · 멀티 에이전트와 Auto-Healing 적용 가이드</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>17</span></div><div class="t ul" style="left:57.599999999999994px;top:172.8px;width:412.79999999999995px;height:441.59999999999997px;font-size:21.333333333333332px;color:#CBD5E1;text-align:left;justify-content:flex-start;--gap:18.666666666666668px;"><div class="li">일시적 오류만 재시도한다. 다른 예외는 그대로 올라가 중단되거나 차단된다.</div><div class="li">횟수와 대기 시간에 상한을 둔다.</div><div class="li">어느 경로로 응답했는지 함께 돌려줘 화면에 표시한다.</div><div class="li">모든 시도를 로그에 남긴다.</div></div><div class="r" style="left:508.79999999999995px;top:168px;width:713.5680000000001px;height:471.84000000000003px;background:#0A1322;border-radius:9.600000000000001px"></div><div class="t m" style="left:537.5999999999999px;top:179.52px;width:655.9680000000001px;height:28.799999999999997px;font-size:16px;color:#A8B8CC;text-align:left;justify-content:center;"><span>healing.py (형식 예시)</span></div><div class="t m" style="left:537.5999999999999px;top:216px;width:655.9680000000001px;height:414.24px;font-size:17.333333333333332px;color:#F1F5F9;text-align:left;justify-content:flex-start;"><span>import time
|
||||
|
||||
class Transient(Exception):
|
||||
"""timeout, 429, 5xx 같은 일시적 오류"""
|
||||
|
||||
def call_with_healing(providers, template, log, wait=0.5):
|
||||
for name, call in providers: # primary, secondary
|
||||
for attempt in range(1, 4): # 최대 3회
|
||||
try:
|
||||
result = call()
|
||||
log.append((name, attempt, "ok"))
|
||||
return result, name
|
||||
except Transient:
|
||||
log.append((name, attempt, "transient"))
|
||||
time.sleep(wait * 2 ** (attempt - 1))
|
||||
log.append(("template", 1, "fallback"))
|
||||
return template, "template"</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>무엇을 복구하는지 대상을 구분한다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · 멀티 에이전트와 Auto-Healing 적용 가이드</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>18</span></div><div class="r" style="left:57.599999999999994px;top:168px;width:1164.768px;height:48px;background:#22375A;border-radius:0px"></div><div class="t" style="left:78.72px;top:168px;width:190.71360000000004px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>복구 대상</span></div><div class="t" style="left:311.6736000000001px;top:168px;width:423.6672000000001px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>예</span></div><div class="t" style="left:777.5808000000002px;top:168px;width:423.6672000000001px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>복구 후 확인할 것</span></div><div class="r" style="left:57.599999999999994px;top:216px;width:1164.768px;height:59.519999999999996px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:216px;width:190.71360000000004px;height:59.519999999999996px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>LLM · 도구 호출</span></div><div class="t" style="left:311.6736000000001px;top:216px;width:423.6672000000001px;height:59.519999999999996px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>타임아웃 재시도, 제공자 전환</span></div><div class="t" style="left:777.5808000000002px;top:216px;width:423.6672000000001px;height:59.519999999999996px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>계약, 근거, 업무 조건</span></div><div class="r" style="left:57.599999999999994px;top:275.52px;width:1164.768px;height:59.519999999999996px;background:#15233A;border-radius:0px"></div><div class="t" style="left:78.72px;top:275.52px;width:190.71360000000004px;height:59.519999999999996px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>작업 흐름</span></div><div class="t" style="left:311.6736000000001px;top:275.52px;width:423.6672000000001px;height:59.519999999999996px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>실패한 단계만 재실행, 저장된 상태에서 재개</span></div><div class="t" style="left:777.5808000000002px;top:275.52px;width:423.6672000000001px;height:59.519999999999996px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>성공 결과 보존, 중복 실행 방지</span></div><div class="r" style="left:57.599999999999994px;top:335.04px;width:1164.768px;height:59.519999999999996px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:335.04px;width:190.71360000000004px;height:59.519999999999996px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>서비스 · 인프라</span></div><div class="t" style="left:311.6736000000001px;top:335.04px;width:423.6672000000001px;height:59.519999999999996px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>컨테이너 재시작, 트래픽 차단</span></div><div class="t" style="left:777.5808000000002px;top:335.04px;width:423.6672000000001px;height:59.519999999999996px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>Health와 실제 요청 처리</span></div><div class="r" style="left:57.599999999999994px;top:423.36px;width:1164.768px;height:103.68px;background:#0A1322;border-radius:7.68px"></div><div class="t" style="left:86.39999999999999px;top:423.36px;width:1107.1680000000001px;height:103.68px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>모든 팀이 서버 재시작을 만들 필요는 없다. 팀 서비스에서 실제로 일어날 실패를 고른다.
|
||||
화면이 다시 연결된 것(SSE 재연결)은 화면의 복구다. 뒤에서 실패한 작업까지 복구된 것은 아니다.</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>위험한 작업은 자동으로 다시 실행하지 않는다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · 멀티 에이전트와 Auto-Healing 적용 가이드</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>19</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>결제, 삭제, 재시작, 알림 발송처럼 되돌리기 어려운 작업에 적용한다</span></div><div class="r" style="left:57.599999999999994px;top:206.39999999999998px;width:369.05600000000004px;height:316.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>승인</span></div><div class="t" style="left:86.39999999999999px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>사람이 먼저 승인한다</span></div><div class="t" style="left:86.39999999999999px;top:326.4px;width:311.456px;height:168px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>에이전트가 혼자 복구하지 않는다. 승인 ID가 없으면 실행이 거부되게 만든다.</span></div><div class="r" style="left:455.456px;top:206.39999999999998px;width:369.05600000000004px;height:316.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:484.256px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>중복 방지</span></div><div class="t" style="left:484.256px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>이미 처리됐을 수 있다</span></div><div class="t" style="left:484.256px;top:326.4px;width:311.456px;height:168px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>응답이 끊겼어도 첫 요청은 처리됐을 수 있다. 다시 저장하기 전에 중복을 확인한다.</span></div><div class="r" style="left:853.3120000000001px;top:206.39999999999998px;width:369.05600000000004px;height:316.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:882.1120000000001px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>시뮬레이션</span></div><div class="t" style="left:882.1120000000001px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>모의 실행부터 시작한다</span></div><div class="t" style="left:882.1120000000001px;top:326.4px;width:311.456px;height:168px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>처음에는 실제 재시작 대신 전략 선택까지만 실행한다. 모의 실행임을 결과에 밝힌다.</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>기록이 곧 증빙이다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · 멀티 에이전트와 Auto-Healing 적용 가이드</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>20</span></div><div class="t ul" style="left:57.599999999999994px;top:172.8px;width:412.79999999999995px;height:441.59999999999997px;font-size:21.333333333333332px;color:#CBD5E1;text-align:left;justify-content:flex-start;--gap:18.666666666666668px;"><div class="li">복구에 성공했어도 장애가 있었다는 사실을 남긴다.</div><div class="li">같은 실행 ID로 감지부터 검증까지 이어 볼 수 있게 한다.</div><div class="li">대체 경로를 썼는지 표시한다.</div><div class="li">API Key, 비밀번호, 불필요한 개인정보는 기록하지 않는다.</div></div><div class="r" style="left:508.79999999999995px;top:168px;width:713.5680000000001px;height:307.20000000000005px;background:#0A1322;border-radius:9.600000000000001px"></div><div class="t m" style="left:537.5999999999999px;top:179.52px;width:655.9680000000001px;height:28.799999999999997px;font-size:16px;color:#A8B8CC;text-align:left;justify-content:center;"><span>incident 기록 (형식 예시)</span></div><div class="t m" style="left:537.5999999999999px;top:216px;width:655.9680000000001px;height:249.60000000000002px;font-size:17.333333333333332px;color:#F1F5F9;text-align:left;justify-content:flex-start;"><span>{
|
||||
"incident_id": "inc-001",
|
||||
"detected_failure": "api_timeout",
|
||||
"selected_strategy": "retry_with_backoff",
|
||||
"retry_count": 1,
|
||||
"fallback_used": false,
|
||||
"recovery_status": "success",
|
||||
"validation_result": "health_check_passed",
|
||||
"duration_ms": 8200
|
||||
}</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>복구율은 장애를 주입해서 숫자로 보인다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · 멀티 에이전트와 Auto-Healing 적용 가이드</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>21</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>Auto-Healing 구현 결과서의 핵심은 재현할 수 있는 실험과 그 결과다</span></div><div class="r" style="left:57.599999999999994px;top:206.39999999999998px;width:369.05600000000004px;height:412.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:86.39999999999999px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>① 주입</span></div><div class="t" style="left:86.39999999999999px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>일부러 고장 낸다</span></div><div class="t" style="left:86.39999999999999px;top:326.4px;width:311.456px;height:264px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>장애 유형마다 여러 건씩 주입한다. Mock 오류, 429 유발, 잘못된 입력을 쓴다.</span></div><div class="r" style="left:455.456px;top:206.39999999999998px;width:369.05600000000004px;height:412.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:484.256px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>② 측정</span></div><div class="t" style="left:484.256px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>검증 통과만 센다</span></div><div class="t" style="left:484.256px;top:326.4px;width:311.456px;height:96px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>감지 시간과 복구 시간도 함께 잰다.</span></div><div class="r" style="left:484.256px;top:509.76px;width:311.456px;height:80.64000000000001px;background:#0A1322;border-radius:5.76px"></div><div class="t m" style="left:501.53599999999994px;top:509.76px;width:276.896px;height:80.64000000000001px;font-size:16px;color:#2DD4BF;text-align:left;justify-content:center;"><span>복구율 = 검증 통과 건수
|
||||
÷ 자동 복구 대상 건수</span></div><div class="r" style="left:853.3120000000001px;top:206.39999999999998px;width:369.05600000000004px;height:412.79999999999995px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:882.1120000000001px;top:235.2px;width:311.456px;height:28.799999999999997px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>③ 구분</span></div><div class="t" style="left:882.1120000000001px;top:273.59999999999997px;width:311.456px;height:40.32px;font-size:26.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>섞어서 세지 않는다</span></div><div class="t" style="left:882.1120000000001px;top:326.4px;width:311.456px;height:264px;font-size:20px;color:#CBD5E1;text-align:left;justify-content:flex-start;"><span>정상 복구, 대체 응답, 사람 이관을 따로 적는다. 복구 실패 시나리오도 하나 이상 넣는다.</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>세 루프가 한 요청 안에서 만난다</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · 멀티 에이전트와 Auto-Healing 적용 가이드</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>22</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>요청 하나가 지나가는 길에 가드레일, 오케스트레이션, 자기 성찰이 차례로 놓인다</span></div><div class="r" style="left:57.599999999999994px;top:240px;width:200.69760000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:72px;top:268.79999999999995px;width:171.8976px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>가드레일</span></div><div class="t" style="left:72px;top:331.20000000000005px;width:171.8976px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>입력 검증,
|
||||
위반이면 차단</span></div><div class="t" style="left:258.29760000000005px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:298.61760000000004px;top:240px;width:200.69760000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:313.0176px;top:268.79999999999995px;width:171.8976px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>Orchestrator</span></div><div class="t" style="left:313.0176px;top:331.20000000000005px;width:171.8976px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>순서와 전이
|
||||
통제</span></div><div class="t" style="left:499.3152px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:539.6351999999999px;top:240px;width:200.69760000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:554.0352px;top:268.79999999999995px;width:171.8976px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>Agents</span></div><div class="t" style="left:554.0352px;top:331.20000000000005px;width:171.8976px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>역할별 실행,
|
||||
계약 검증</span></div><div class="t" style="left:740.3328px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:780.6528000000001px;top:240px;width:200.69760000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:795.0528px;top:268.79999999999995px;width:171.8976px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>Evaluator</span></div><div class="t" style="left:795.0528px;top:331.20000000000005px;width:171.8976px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>품질 미달이면
|
||||
수정 루프</span></div><div class="t" style="left:981.3504px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:1021.6704px;top:240px;width:200.69760000000002px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:1036.0704px;top:268.79999999999995px;width:171.8976px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>응답</span></div><div class="t" style="left:1036.0704px;top:331.20000000000005px;width:171.8976px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>경로와 근거를
|
||||
함께 표시</span></div><div class="r" style="left:57.599999999999994px;top:513.5999999999999px;width:1164.768px;height:71.03999999999999px;background:#0A1322;border-radius:7.68px"></div><div class="t" style="left:86.39999999999999px;top:513.5999999999999px;width:1107.1680000000001px;height:71.03999999999999px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>어느 단계에서든 호출이 실패하면 Auto-Healing이 분류, 복구, 검증, 기록을 맡는다. 복구하지 못하면 사람에게 넘긴다.</span></div></section>
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>업무 유형별 적용 예시</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · 멀티 에이전트와 Auto-Healing 적용 가이드</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>23</span></div><div class="r" style="left:57.599999999999994px;top:168px;width:1164.768px;height:48px;background:#22375A;border-radius:0px"></div><div class="t" style="left:78.72px;top:168px;width:155.77056000000005px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>업무</span></div><div class="t" style="left:276.7305600000001px;top:168px;width:283.89504000000005px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>역할 분담</span></div><div class="t" style="left:602.8656000000001px;top:168px;width:248.95200000000003px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>품질 개선</span></div><div class="t" style="left:894.0576000000002px;top:168px;width:307.1904px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>장애 복구</span></div><div class="r" style="left:57.599999999999994px;top:216px;width:1164.768px;height:59.519999999999996px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:216px;width:155.77056000000005px;height:59.519999999999996px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>리서치 보고서</span></div><div class="t" style="left:276.7305600000001px;top:216px;width:283.89504000000005px;height:59.519999999999996px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>계획 → 근거 수집 → 작성·검토</span></div><div class="t" style="left:602.8656000000001px;top:216px;width:248.95200000000003px;height:59.519999999999996px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>근거 없는 주장을 수정</span></div><div class="t" style="left:894.0576000000002px;top:216px;width:307.1904px;height:59.519999999999996px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>검색 실패 시 재시도, 다른 출처</span></div><div class="r" style="left:57.599999999999994px;top:275.52px;width:1164.768px;height:59.519999999999996px;background:#15233A;border-radius:0px"></div><div class="t" style="left:78.72px;top:275.52px;width:155.77056000000005px;height:59.519999999999996px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>상담·예약 지원</span></div><div class="t" style="left:276.7305600000001px;top:275.52px;width:283.89504000000005px;height:59.519999999999996px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>분류 → 규정 검토 → 예약안</span></div><div class="t" style="left:602.8656000000001px;top:275.52px;width:248.95200000000003px;height:59.519999999999996px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>규정·시간 위반을 수정</span></div><div class="t" style="left:894.0576000000002px;top:275.52px;width:307.1904px;height:59.519999999999996px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>조회는 재시도, 저장은 중복 확인</span></div><div class="r" style="left:57.599999999999994px;top:335.04px;width:1164.768px;height:59.519999999999996px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:335.04px;width:155.77056000000005px;height:59.519999999999996px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>장애 대응</span></div><div class="t" style="left:276.7305600000001px;top:335.04px;width:283.89504000000005px;height:59.519999999999996px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>증상 분석 → 조치 계획 → 검증</span></div><div class="t" style="left:602.8656000000001px;top:335.04px;width:248.95200000000003px;height:59.519999999999996px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>위험·롤백 누락을 수정</span></div><div class="t" style="leftLine truncated
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>시연에서 보여 줄 다섯 장면</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · 멀티 에이전트와 Auto-Healing 적용 가이드</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>24</span></div><div class="r" style="left:57.599999999999994px;top:168px;width:1164.768px;height:48px;background:#22375A;border-radius:0px"></div><div class="t" style="left:78.72px;top:168px;width:190.71360000000004px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>장면</span></div><div class="t" style="left:311.6736000000001px;top:168px;width:889.5744000000002px;height:48px;font-size:18.666666666666668px;color:#2DD4BF;font-weight:700;text-align:left;justify-content:center;"><span>보여 줄 것</span></div><div class="r" style="left:57.599999999999994px;top:216px;width:1164.768px;height:53.760000000000005px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:216px;width:190.71360000000004px;height:53.760000000000005px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>정상 흐름</span></div><div class="t" style="left:311.6736000000001px;top:216px;width:889.5744000000002px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>누가 어떤 입력을 받아 무엇을 다음 역할에 넘겼는가</span></div><div class="r" style="left:57.599999999999994px;top:269.76px;width:1164.768px;height:53.760000000000005px;background:#15233A;border-radius:0px"></div><div class="t" style="left:78.72px;top:269.76px;width:190.71360000000004px;height:53.760000000000005px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>내용 오류</span></div><div class="t" style="left:311.6736000000001px;top:269.76px;width:889.5744000000002px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>검토가 무엇을 지적했고, 어떻게 수정하고 다시 평가했는가</span></div><div class="r" style="left:57.599999999999994px;top:323.52px;width:1164.768px;height:53.760000000000005px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:323.52px;width:190.71360000000004px;height:53.760000000000005px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>복구 성공</span></div><div class="t" style="left:311.6736000000001px;top:323.52px;width:889.5744000000002px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>장애 주입 → 감지 → 조치 → 재검증 → 종료를 같은 실행 ID로</span></div><div class="r" style="left:57.599999999999994px;top:377.28000000000003px;width:1164.768px;height:53.760000000000005px;background:#15233A;border-radius:0px"></div><div class="t" style="left:78.72px;top:377.28000000000003px;width:190.71360000000004px;height:53.760000000000005px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>복구 실패</span></div><div class="t" style="left:311.6736000000001px;top:377.28000000000003px;width:889.5744000000002px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>상한을 넘으면 반복하지 않고 실패와 사람 이관으로 끝나는가</span></div><div class="r" style="left:57.599999999999994px;top:431.04px;width:1164.768px;height:53.760000000000005px;background:#1A2B45;border-radius:0px"></div><div class="t" style="left:78.72px;top:431.04px;width:190.71360000000004px;height:53.760000000000005px;font-size:18.666666666666668px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>위험 경계</span></div><div class="t" style="left:311.6736000000001px;top:431.04px;width:889.5744000000002px;height:53.760000000000005px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>권한 부족이나 근거 누락을 성공으로 우회하지 않는가</span></div><div class="r" style="left:57.599999999999994px;top:513.6px;width:1164.768px;height:71.03999999999999px;background:#0A1322;border-radius:7.68px"></div><div class="t" style="left:86.39999999999999px;top:513.6px;width:1107.168000Line truncated
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>적용 점검표</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · 멀티 에이전트와 Auto-Healing 적용 가이드</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>25</span></div><div class="r" style="left:57.599999999999994px;top:168px;width:570.384px;height:91.19999999999999px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="r" style="left:86.39999999999999px;top:199.20000000000002px;width:28.799999999999997px;height:28.799999999999997px;background:#1A2B45;border:1.6px solid #2DD4BF;border-radius:3.84px"></div><div class="t" style="left:139.2px;top:168px;width:464.784px;height:91.19999999999999px;font-size:20px;color:#F1F5F9;text-align:left;justify-content:center;"><span>에이전트마다 역할·하지 않는 일·허용 Tool·입출력 스키마가 있다</span></div><div class="r" style="left:57.599999999999994px;top:283.20000000000005px;width:570.384px;height:91.19999999999999px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="r" style="left:86.39999999999999px;top:314.40000000000003px;width:28.799999999999997px;height:28.799999999999997px;background:#1A2B45;border:1.6px solid #2DD4BF;border-radius:3.84px"></div><div class="t" style="left:139.2px;top:283.20000000000005px;width:464.784px;height:91.19999999999999px;font-size:20px;color:#F1F5F9;text-align:left;justify-content:center;"><span>에이전트를 나눈 이유를 권한·병렬·검증·추적으로 설명할 수 있다</span></div><div class="r" style="left:57.599999999999994px;top:398.40000000000003px;width:570.384px;height:91.19999999999999px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="r" style="left:86.39999999999999px;top:429.59999999999997px;width:28.799999999999997px;height:28.799999999999997px;background:#1A2B45;border:1.6px solid #2DD4BF;border-radius:3.84px"></div><div class="t" style="left:139.2px;top:398.40000000000003px;width:464.784px;height:91.19999999999999px;font-size:20px;color:#F1F5F9;text-align:left;justify-content:center;"><span>실행 순서와 종료 조건이 코드나 그래프에 있다</span></div><div class="r" style="left:57.599999999999994px;top:513.5999999999999px;width:570.384px;height:91.19999999999999px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="r" style="left:86.39999999999999px;top:544.8px;width:28.799999999999997px;height:28.799999999999997px;background:#1A2B45;border:1.6px solid #2DD4BF;border-radius:3.84px"></div><div class="t" style="left:139.2px;top:513.5999999999999px;width:464.784px;height:91.19999999999999px;font-size:20px;color:#F1F5F9;text-align:left;justify-content:center;"><span>자기 성찰에 평가 기준·최대 횟수·실패 처리가 있다</span></div><div class="r" style="left:651.984px;top:168px;width:570.384px;height:91.19999999999999px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="r" style="left:680.784px;top:199.20000000000002px;width:28.799999999999997px;height:28.799999999999997px;background:#1A2B45;border:1.6px solid #2DD4BF;border-radius:3.84px"></div><div class="t" style="left:733.584px;top:168px;width:464.784px;height:91.19999999999999px;font-size:20px;color:#F1F5F9;text-align:left;justify-content:center;"><span>장애 유형표 → 전략 → 검증 → 기록이 이어져 있다</span></div><div class="r" style="left:651.984px;top:283.20000000000005px;width:570.384px;height:91.19999999999999px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="r" style="left:680.784px;top:314.40000000000003px;width:28.799999999999997px;height:28.799999999999997px;background:#1A2B45;border:1.6px solid #2DD4BF;border-radius:3.84px"></div><div class="t" style="left:733.584px;top:283.20000000000005px;width:464.784px;height:91.19999999999999px;font-size:20px;color:#F1F5F9;text-align:left;justify-content:center;"><span>401·권한 위반·Prompt Injection은 재시도하지 않는다</span></div><div class="r" style="left:651.984px;top:398.40000000000003px;width:570.384px;height:91.19999999999999px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="r" style="left:680.784px;top:429.59999999999997px;width:28.799999999999997px;height:28.799999999999997px;background:#1A2B45;border:1.6px solid #2DD4BF;border-radius:3.84px"></div><div class="t" style="left:733.584px;top:398.40000000000003px;width:464.784px;height:91.19999999999999px;font-size:20px;color:#F1F5F9;text-align:left;justify-conLine truncated
|
||||
<section class="slide"><h2 class="t" style="left:57.599999999999994px;top:43.2px;width:1164.768px;height:86.4px;font-size:42.666666666666664px;color:#F1F5F9;font-weight:700;text-align:left;justify-content:center;"><span>지금 팀에서 할 일</span></h2><div class="t" style="left:57.599999999999994px;top:672px;width:576px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:left;justify-content:center;"><span>최종 프로젝트 · 멀티 에이전트와 Auto-Healing 적용 가이드</span></div><div class="t" style="left:1145.568px;top:672px;width:76.80000000000001px;height:28.799999999999997px;font-size:13.333333333333334px;color:#A8B8CC;text-align:right;justify-content:center;"><span>26</span></div><div class="t" style="left:57.599999999999994px;top:134.39999999999998px;width:1164.768px;height:43.2px;font-size:22.666666666666668px;color:#2DD4BF;text-align:left;justify-content:center;"><span>넓게 벌이지 말고, 흐름 하나와 실패 하나를 끝까지 연결한다</span></div><div class="r" style="left:57.599999999999994px;top:240px;width:260.952px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:72px;top:268.79999999999995px;width:232.15200000000004px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>① 핵심 흐름 하나</span></div><div class="t" style="left:72px;top:331.20000000000005px;width:232.15200000000004px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>사용자 시나리오
|
||||
하나 고르기</span></div><div class="t" style="left:318.552px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:358.872px;top:240px;width:260.952px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:373.27200000000005px;top:268.79999999999995px;width:232.15200000000004px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>② 역할 표</span></div><div class="t" style="left:373.27200000000005px;top:331.20000000000005px;width:232.15200000000004px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>책임, 입출력,
|
||||
Tool, 종료 조건</span></div><div class="t" style="left:619.8240000000001px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:660.144px;top:240px;width:260.952px;height:220.79999999999998px;background:#1A2B45;border-radius:9.600000000000001px"></div><div class="t" style="left:674.5440000000001px;top:268.79999999999995px;width:232.15200000000004px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>③ 실패 하나</span></div><div class="t" style="left:674.5440000000001px;top:331.20000000000005px;width:232.15200000000004px;height:86.4px;font-size:18.666666666666668px;color:#CBD5E1;text-align:center;justify-content:flex-start;"><span>실제로 일어날
|
||||
장애를 끝까지</span></div><div class="t" style="left:921.0960000000001px;top:240px;width:40.32px;height:220.79999999999998px;font-size:26.666666666666668px;color:#2DD4BF;text-align:center;justify-content:center;"><span>→</span></div><div class="r" style="left:961.4160000000002px;top:240px;width:260.952px;height:220.79999999999998px;background:#0F766E;border-radius:9.600000000000001px"></div><div class="t" style="left:975.8160000000001px;top:268.79999999999995px;width:232.15200000000004px;height:48px;font-size:24px;color:#F1F5F9;font-weight:700;text-align:center;justify-content:center;"><span>④ 주입과 기록</span></div><div class="t" style="left:975.8160000000001px;top:331.20000000000005px;width:232.15200000000004px;height:86.4px;font-size:18.666666666666668px;color:#F1F5F9;text-align:center;justify-content:flex-start;"><span>일부러 고장 내고
|
||||
로그로 증빙</span></div><div class="r" style="left:57.599999999999994px;top:513.5999999999999px;width:1164.768px;height:71.03999999999999px;background:#0A1322;border-radius:7.68px"></div><div class="t" style="left:86.39999999999999px;top:513.5999999999999px;width:1107.1680000000001px;height:71.03999999999999px;font-size:18.666666666666668px;color:#CBD5E1;text-align:left;justify-content:center;"><span>앞 과정에서 실습한 제공자 전환, 평가·수정 루프, 계약 검증 코드를 다시 실행해 보고 팀 서비스에 맞게 결합한다.</span></div></section>
|
||||
</main>
|
||||
<div class="bar" id="bar"></div>
|
||||
<script>
|
||||
(function(){
|
||||
var stage=document.querySelector('.stage'),slides=[].slice.call(document.querySelectorAll('.slide')),i=0,present=true,bar=document.getElementById('bar');
|
||||
function fit(){
|
||||
var s=present?Math.min(innerWidth/1280,innerHeight/720):Math.min(1,(innerWidth-32)/1280);
|
||||
stage.style.transform='scale('+s+')';
|
||||
stage.style.marginLeft=Math.max(0,(innerWidth-1280*s)/2)+'px';
|
||||
stage.style.marginTop=present?Math.max(0,(innerHeight-720*s)/2)+'px':'16px';
|
||||
stage.style.height=present?'720px':'';
|
||||
}
|
||||
function show(){
|
||||
document.body.classList.toggle('present',present);
|
||||
slides.forEach(function(el,k){el.classList.toggle('on',k===i)});
|
||||
bar.textContent=present?(i+1)+' / '+slides.length+' · ←/→ 이동 · O 전체 보기 · F 전체 화면':'O 발표 보기 · 인쇄(Ctrl/⌘+P)로 PDF 저장';
|
||||
fit(); if(!present) slides[i].scrollIntoView();
|
||||
}
|
||||
function go(d){i=Math.max(0,Math.min(slides.length-1,i+d));show()}
|
||||
addEventListener('keydown',function(e){
|
||||
if(['ArrowRight','PageDown',' ','Enter'].indexOf(e.key)>=0){e.preventDefault();go(1)}
|
||||
else if(['ArrowLeft','PageUp','Backspace'].indexOf(e.key)>=0){e.preventDefault();go(-1)}
|
||||
else if(e.key==='Home'){i=0;show()} else if(e.key==='End'){i=slides.length-1;show()}
|
||||
else if(e.key==='o'||e.key==='O'){present=!present;show()}
|
||||
else if(e.key==='f'||e.key==='F'){document.fullscreenElement?document.exitFullscreen():document.documentElement.requestFullscreen()}
|
||||
});
|
||||
stage.addEventListener('click',function(e){if(present)go(e.clientX<innerWidth/3?-1:1)});
|
||||
addEventListener('resize',fit); show();
|
||||
})();
|
||||
</script>
|
||||
</body></html>
|
||||
Binary file not shown.
Reference in new issue
Block a user