카드 선결제 에이전트 PoC

챗봇 WAS(Java Spring Boot)와 사내 LLM(gpt-oss-120b) 사이에서 에이전틱 처리를 담당하는 Python LangGraph 서비스의 설계 문서입니다.

문서	내용	이런 질문에 답합니다
00 · 프로젝트 개요	배경과 범위	"이걸 왜 하는 거지?"
01 · 아키텍처 설계서	시스템 구성과 동작 흐름	"어떻게 동작하지?"
02 · 의사결정 기록 ★	ADR 9건 — 결정과 근거	"왜 이렇게 설계했지?"
03 · 인터페이스 명세	WAS ↔ 에이전트 API 계약	"뭘 주고받지?"
04 · 미확정 사항	열린 질문 추적	"뭐가 안 정해졌지?"
05 · 개발 계획서	구현 방법과 순서	"어떻게 만들지?"
06 · 기능과 한계	할 수 있는 것·경계·확장성 (부록)	"어디까지 되는 거지?"
07 · 리스크 개선 하드닝	레드팀 결과·위험 레지스터·완화 로드맵	"대고객에 안전한가?"
08 · 테스트 시나리오	배포 전 QA 카탈로그 (사용자 메시지 기반)	"무엇을 테스트하지?"
09 · 평가 케이스셋 ★	확률적 AI 검증 방법론 + 케이스 카탈로그(113건)	"AI를 어떻게 테스트하지?"
10 · 폐쇄망 반입 가이드	반입 항목·패키징·오프라인 설치 절차서	"사내로 어떻게 가져가지?"

처음 읽는 분은 00 → 01 → 02 순서를 권장합니다. 개발에 참여한다면 03과 05를 반드시 읽어주세요.

설계를 코드로 옮겨간 과정은 개발 실습서에 장별로 기록됩니다 — 빈 폴더에서 시작해 따라 하면 같은 결과물이 나오는 것을 목표로 하며, 개발 Step이 진행될 때마다 장이 추가됩니다.

이 사이트에 대해

저장소의 docs/*.md를 MkDocs Material로 빌드한 정적 사이트입니다. 문서 수정 후 저장소 루트의 ./deploy-docs.sh로 재배포합니다.