시스템 아키텍처
질문에서 검증된 답변까지 — Lawmadi OS의 기술 구조
4단계 하이브리드 파이프라인
모든 법률 질의는 4단계 파이프라인을 거쳐 검증된 답변으로 전달됩니다. 각 단계는 독립적으로 실패 감지·복구가 가능하며, 검증 실패 시 답변을 차단하는 Fail-Closed 정책을 적용합니다.
Stage 0+1 — 분류 + RAG 검색 (병렬)
NLU 의도 분석으로 60명 중 최적 리더를 배정하고, 동시에 Vertex AI Search와 법령 캐시에서 관련 법조문·판례를 검색합니다. 3계층 라우팅(인사 → 비법률 → 법률)으로 질의를 분류합니다.
Stage 1.5~1.7 — 법령 보강
배정된 리더의 핵심 법률을 주입(LAW_BOOST)하고, 위임 조문·시행령 서식을 3단 비교로 연결합니다. DRF API에서 실제 조문 전문을 프리패치하여 정확도를 극대화합니다.
Stage 3 — Claude 실시간 스트리밍 분석
리더 페르소나와 RAG 컨텍스트를 기반으로 Claude Sonnet 5가 실시간 SSE 스트리밍으로 답변을 생성합니다. 5단계 프레임워크(공감 → 진단 → 행동계획 → 안전장치 → 마무리)로 구조화된 법률 분석을 제공합니다.
Stage 4 — DRF 전수 검증 (Fail-Closed)
답변에 인용된 모든 법조문·판례·헌재결정을 국가법령정보센터(law.go.kr) DRF API에서 실시간으로 교차 검증합니다. 미검증 비율 0.1% 이상이면 답변을 차단하고, 검증 후 수정된 텍스트를 실시간 교체합니다.
8계층 처리 아키텍처
Lawmadi OS는 운영체제처럼 8개 계층으로 설계되어, 각 계층이 독립적 역할을 수행합니다.
SSOT 데이터 소스
모든 답변은 대한민국 공식 법령 데이터베이스(Single Source of Truth)에 근거합니다. 자체 추론이나 생성은 금지됩니다.
현행법령
법률·시행령·시행규칙 전문
대법원 판례
대법원·고등법원 판례 전문
헌재 결정례
헌법재판소 결정례
행정규칙 · 자치법규
훈령·예규·고시·조례
법령해석례
법제처 법령해석 사례
조약 · 법령용어
국제조약 및 법률 용어사전
기술 스택
AI 엔진
Claude Sonnet 5 — 실시간 SSE 스트리밍, 429 지수 백오프
RAG 검색
Vertex AI Search — 검증 자산 48,955건 색인, 추출형 답변
백엔드
FastAPI + Uvicorn — Python 비동기 처리, Cloud Run (서울)
에이전트 인터페이스
MCP(19개 도구) · A2A 에이전트 카드 · OAuth 2.0(PKCE·클라이언트 자가등록) — 셋 다 같은 인증·한도·과금 게이트를 지나므로 우회 과금 경로가 없습니다
데이터베이스
Cloud SQL PostgreSQL 17 — 법령 캐시, 감사 로그, 세션 관리
프론트엔드
Firebase Hosting — 한국어/영어 정적 페이지, PWA 지원
CI/CD
GitHub Actions 5단계 — 테스트 → 스테이징 → 프로덕션 → 프론트엔드 → 알림
6대 헌법 원칙
Lawmadi OS의 모든 답변은 6가지 헌법 원칙에 의해 통제됩니다. 이 원칙은 코드 레벨에서 강제되며 예외 없이 적용됩니다.
SSOT_FACT_ONLY
모든 답변은 국가법령정보센터 실시간 데이터에 근거
ZERO_INFERENCE
검증된 데이터 외 법률·판례를 생성하거나 추론하지 않음
FAIL_CLOSED
검증 실패 시 답변 생성 중단, 보안 경고 출력
IDENTITY
불법 행위 권장 및 증거 인멸 정보 제공 금지
TIMELINE_RULE
행위시법 우선, 신법 경과조치 필수 대조
SOURCE_TRANSPARENCY
인용 법령에 법령ID + 시행일자 필수 포함