본문으로 건너뛰기

Pack 1 — 대여금 회수 Product Spec

Phase 1 (0~18M) 의 첫 Pack · 대여금·공사대금·구상금·양수금·임대차보증금·약정금 6종 통합

항목내용
작성일2026-04-20
최종 갱신2026-04-21 (Phase 0 Week 3·4 엔지니어링 주요 항목 완료)
작성 근거ADR 0001 (Vision) · 0002 (AX·무료) · 0003 (채권 계산) · 0004 (로드맵·지표) · 0005 (서류 자동 생성) · 0006 (판례 DB·승소 판단)
위치Phase 1 (0~18M), 너홀로프로의 첫 실사용 Pack
예상 eng-dayPhase 0 (4주) 56 + Phase 1 (~12M) 155 = 총 211
Phase 0 진척도엔지니어링 ~95% — Chair-gated (보험·섭외·외부 자문·dogfood 시작) 잔여. 상세 체크리스트 · 사용자 가이드

1. Vision·Core Value 정렬​

Vision (ADR 0001):

법률사무소가 민사 회수 사건을 수임부터 입금까지, 기일과 시효를 놓치지 않고 완주한다. 사무소가 해온 방식은 AI 가 기억하여 다음 사건에 돌려준다.

Pack 1 은 이 Vision 의 첫 실현 범위. 민사 회수 중 대여금 계열 6종 을 엔진 재사용률 85%+ 로 통합.

Core Value (ADR 0001):

  • 사무소 일손은 절반
  • 기일·시효·서류 실수는 0건
  • 의뢰인은 자기 사건을 스스로 본다 (포털)
  • 사무소가 해온 방식은 AI 가 기억 (Accumulation)
  • 모든 축적은 감사 가능성·철회 가능성·격리성 전제

한 줄 Why (대상별, ADR 0002):

  • 변호사 메인: "민사 회수, 놓치지 않고 완주한다. 한 건 끝낼 때마다, 다음 사건이 쉬워진다."
  • 변호사 서브: "변호사는 법정에, 나머지는 너홀로."
  • 사무원 온보딩: "이번 사건이 다음 사건의 시작이 되도록."

2. 대상 (ICP)​

Ideal Customer Profile (ADR 0001 / ADR 0034):

  • 법률 사무소 (개업 · 부티크 · 법인)
  • 민사 송무 집중 (형사·행정·IP·회사 제외)

주요 페르소나 (#001 참여자 기준):

  • 변호사: 사건 결재자·서명자, 전략·법정 집중
  • 사무원: 실사용자, 매일 문서 쌓는 사람, 신입 교육 현장 (#004 "사무원 챔피언" 전략)

제외 (Anti-Goal):

  • 대형 로펌 (6인+, Harvey·Clio 영역)
  • 민사 외 (형사·행정·가사 감정)
  • B2C 의뢰인 직접 (포털은 열람만)
  • 변호사 매칭·광고 (로톡 경로 금지)

3. 기능 범위​

Phase 0 (4주, 56 eng-day) — 착수 전 필수​

목표: 내부 변호사 3명 dogfood · 대여금 계산 정확도 99.5% · 엑셀 병행 이탈률 70%+

범위:

  • 단일 대여·복수 변제 + 법정충당 A방식 계산
  • 사건 상세 회수 탭의 debt 분기 신설 (인라인 편집 테이블) — 초기엔 별도 ?tab=debt-settlement 탭으로 ship 됐으나 ADR 0037 (2026-05-06) 로 회수 탭의 debt 분기로 흡수
  • 청구취지 결정론 템플릿 3종 (청구취지형·준비서면 계산표형·CSV)
  • 별지 계산서 PDF (법원 제출 형식)
  • CSV 파서 3개 은행 (국민·카카오뱅크·토스뱅크)
  • 스냅샷 불변 + engineVersion 태깅
  • features.infraHardening.debtSettlement 킬 스위치
  • 10 테스트 케이스 (윤년·법정이율 경계·복리/단리·안분·과납·지정충당)

AI 파이프라인 (ADR 0005):

  • AiProvider 인터페이스 + GeminiProvider (6 eng-day)
  • embeddingVersion Day 0 필드
  • assertTenantFilter 3중 방어 (유닛·CI·런타임)
  • 비식별화 4단 파이프라인 (정규식·Gemini NER·재식별 스캐너·수동 검토 큐)
  • 회로차단기 fail-closed (1·3단계)
  • Audit 로그 tenants/{tid}/auditLog/
  • Ko-LegalQA v0.1 100문제 CI 통합

데이터 소스 (ADR 0006 Amended 2026-04-20):

  • 국가법령정보 DRF API (법령·조문 RAG 단독)
  • 사무소 기억 RAG (Tier 1, 내부 자료)
  • 판례 본문 RAG 는 Phase 0 제외 (법고을 공식 협약 성사 후 Phase 1+ 도입)

Phase 1 (~12M, 155 eng-day) — Pack 1 전면​

  • 복수 대여·복수 변제 + 지연손해금 연 5%/12% 자동 (2019.6.1 경계 분기)
  • B방식 정식 도입 (잔액 정산) + 계속적 거래 약정 업로드 유도
  • 당사자특약 (합의충당) 토글 + 합의서 첨부
  • 시나리오 A/B (의뢰인 vs 상대방) — 전 사용자 무료
  • AI 적요 분류 (weight 1, settlementParse) — 거래내역 → 변제/이자/무관 3분류
  • 공탁 이벤트 타입 (민법 487조, 연 0.1% 보관금 이자)
  • 시효 중단 플래그 연동 (민법 168조 승인)
  • 은행 어댑터 확장 5개 (신한·하나·우리·농협·IBK) + 커스텀 템플릿
  • /legacy Phase 0~2 완성 (스캔 업로드·사무소 기억 참조 노출)

Go 조건: 사건 등록→소장 제출 평균 30% 단축

Phase 2 (= Phase 2a, 6주, ADR 0003) — 판결 후 재계산​

  • 판결 후 재계산 + 소촉법 12% 자동 분기
  • engineVersion 스냅샷이 판결 기준 재계산 이어받는 아키텍처
  • "판결 선고일" 필드 + 자동 변환 UI

Go 조건: 사건당 계산기 호출 중앙값 3회+ (소장·판결 직후·배당요구)

Phase 3 (= Phase 2b) — 집행·배당​

  • 집행·배당기일 재재계산
  • 전부명령·공탁소 출급 연계
  • 세무 신고용 정산서 PDF (의뢰인 재방문 트리거)
  • 어쏘→파트너 승인 워크플로우 (대형 로펌 수요, ICP 외지만 수용)

4. 주요 사용자 여정​

사건 접수 → 채권 계산 → 소장 작성 (Phase 0~1)​

  1. 사건 생성: 사무원이 의뢰인·채무자·사건 유형 (대여금) 입력
  2. 대여·변제 등록: 차용증 OCR·계좌 거래내역 CSV 업로드·수기 입력 병행
  3. 채권 계산 (자동): 법정충당 A방식 원금·이자·지연손해금 계산
  4. 청구취지 생성 (결정론 템플릿): 3종 프리셋 중 선택 → 클립보드 복사·PDF
  5. 소장 초안 AI 생성 (weight 1): 사무소 기억 + 공개 판례 RAG 참조
  6. 변호사 검토·서명: DocSignGate 인용 검증 3단 통과 후 외부 송출

판결 후 재계산 (Phase 2)​

  1. 판결 선고일 입력
  2. 판결원리금 + 소촉법 12% 자동 분기
  3. 새 스냅샷 생성 (기존 스냅샷 이어받기)
  4. 청구금액 확정 서류 생성

집행·회수 (Phase 3)​

  1. 재산명시·채무불이행자명부·재산조회
  2. 압류·추심·배당요구
  3. 배당기일 기준 재재계산
  4. 의뢰인 종소세 신고용 정산서

5. 핵심 기능 목록​

5.1 결정적 계산 엔진 (ADR 0003)​

  • 순수 TypeScript 함수 _lib/debt-settlement.ts (Firebase 의존 0)
  • 정수 원(KRW) 단위 · bigint · Math.floor(principal × rate × days / 365)
  • KST 일할 계산 (초일불산입·말일산입)
  • 법정이율 코드 상수 테이블 (lib/legal/statutory-rates.ts)
  • 민사 5% · 소촉법 12% (2019.6.1~) · 상사 6% · 이자제한법 20%
  • AI 호출 없음 (할루시네이션 금지)

5.2 사건 상세 회수 탭 (debt 분기)​

  • 사건 상세 탭 순서 (ADR 0037 후): overview | documents | evidence | hearings | recovery | messages | notes
  • 회수 탭은 recoveryType 으로 도메인별 분기 — "debt" 는 본 절 화면, 비-debt 13 종은 NonDebtRecoveryRouter (Pack 2~5)
  • 3뷰 토글: 요약카드 · 충당표 · 타임라인
  • 인라인 편집 테이블 + 키보드 네비 (Tab·Enter·Cmd+Enter)
  • 대여(+)·변제(-) 섹션 분리
  • 이자율 프리셋 드롭다운 + 수기 입력
  • 엑셀 CSV/TSV paste 파서
  • 시나리오 A/B 탭 스위처 (Phase 1)

5.3 청구취지 자동 생성 (결정론 템플릿)​

  • 3종 프리셋:
    1. 청구취지형 ("피고는 원고에게 금 OOO원 및 이에 대한 YYYY.MM.DD.부터...")
    2. 준비서면 계산표형 (마크다운 표)
    3. 엑셀 CSV 다운로드
  • 클립보드 복사 · 우측 근거 수식 토글
  • AI weight 0 (결정론)

5.4 별지 계산서 PDF​

  • 법원 제출 형식 (A4 세로)
  • 7열: 날짜·원금·이자·변제·잔액·비고·이자율 근거
  • 수기 메모 여백 + 검토 도장란 (P9 대형 로펌 요구 일부 수용)

5.5 스냅샷 시스템​

  • 불변 + 이름·기준일·법정/지정 충당 플래그 고정
  • engineVersion 태깅 (과거 재현 보장)
  • diff 요약 ("변제 2건 추가, 원금 330만원 감액")
  • 무제한 저장 (ADR 0002 전 기능 무료)

5.6 CSV 은행거래내역 파서 (ADR 0003)​

  • Phase 0: 국민·카카오뱅크·토스뱅크 3개 (점유율 우선)
  • Phase 1: 신한·하나·우리·농협·IBK 5개 추가 + 커스텀 템플릿 저장
  • 어댑터 인터페이스 parseBankStatement(format, content): { rows: TransactionRow[] }
  • 헤더 자동 감지 + 컬럼 매핑 미리보기
  • 적요 해석 규칙 기반 80% 커버 (Phase 0)
  • 적요 AI 분류 (weight 1, settlementParse) (Phase 1)
  • 중복 방지: (거래일 + 금액 + 적요) 해시

5.7 서류 자동 생성 (RAG, ADR 0005)​

Phase 1 부터:

  • 내용증명·지급명령·소장·답변서·준비서면 초안
  • RAG 컨텍스트 K 분배 (ADR 0006): 사무소 기억 3 + 공공 판례 5 + 법령 2
  • UI 뱃지 3종 분리 ("내 사무소 자료" · "대법원 판례" · "법령")
  • Hallucination 3단 방어: 사건번호 대법원 HEAD + 조문 국가법령정보 API + 변호사 체크리스트
  • Citation Precision 0.95+ hard gate
  • "AI 초안 · 변호사 검토 필수" 워터마크 고정
  • DocSignGate 변호사 서명 전 외부 송출 차단

5.8 사무소 기억 연동 (/legacy, ADR 0002)​

  • Pack 1 사건 종결 시 자동 축적
  • 새 사건에서 "비슷한 과거 기억" 참조
  • Pack 1 기능 내 referencedLegacyDocIds 표시
  • 3단계 점진 공개:
    • 0~49건: "사무소 기억 축적 중" 프로그레스 UI
    • 50건+ or 3개월+: 본격 활성화
    • 500건+: "성숙한 사무소 기억" 배지

5.9 세대 간 지식 이전 kill feature (ADR 0002 §6)​

  • 새 사건 조회 시 "이 사무소 과거 유사 사건 · 전략 요약 · 결과" 표시
  • case_history_metadata 필드 (caseType, outcome, handlers, strategies, year)
  • 퇴직자 기본 익명 ("전임 변호사"), 동의 옵션 시 이름 표시
  • 전 사용자 무료 (Pro 전용 아님)
  • Phase 2.5 (Phase 1 후반~Phase 2 초반)

5.10 승소 판단 — 결정론 통계만 (ADR 0006)​

  • 허용: 유사 판례 승소율 집계 ("10건 중 원고 승소 8건")
  • 금지: "승소 확률 65%" 수치·"소송 하지 마세요" 권유·의뢰인 직접 노출
  • 기능명 strategyReport 유지 · 마케팅 카피 "사건 전략 브리핑"
  • 수치 금지 린트 (apps/web/lib/ai/compliance-filter.ts)
  • ESLint 커스텀 룰 (predictWinProbability 함수명 차단)
  • 감사 로그 3년 보존

6. UX 원칙​

6.1 변호사 초안 수용 10 조건 (ADR 0005 P1 R1)​

  1. 판례 인용 100% 실재
  2. 법령 current 버전
  3. 청구취지 숫자 정확
  4. 당사자 표시 완전성
  5. 별지 계산서 xlsx 호환
  6. 사무소 문체 학습 (Phase 2+)
  7. 재판부 tendency 반영 (Phase 3+)
  8. 반대 가능성 언급
  9. 인용 출처 각주 토글
  10. word count 범위 준수

6.2 사무원 친화 (P14 "사무원 챔피언")​

  • 엑셀 체감 속도 (Tab·Enter·Cmd+Enter)
  • 사건번호·당사자명 copy-paste 최적화
  • 다이얼로그 왕복 3~5배 느림 → 인라인 편집 우선
  • 프로그레스 UI ("사무소 기억 축적 중")

6.3 비식별화 UI 이중 레이어 (P1 R1)​

  • 화면 원본 (변호사 시각 부담 감소)
  • 서버·학습 마스킹본 (자동 분리)
  • 수동 검토 큐: 사무소 변호사 직접 (사무원 금지 — 변호사법 제26조)

6.4 실수 0건 방어​

  • 사용자 수동 오버라이드 보존 (AI 재계산 시 플래그)
  • 원화 절사 재판부 관행 일치
  • features.infraHardening.debtSettlement 원격 1-click 롤백
  • 50건+ 실제 사건 테스트 선행

6.5 플랜 차별 없음 (ADR 0002)​

  • 시나리오 B·PDF·스냅샷·AI 적요 분류 모두 무료
  • assistLimit (ADR 0005): 사무소당 월 200 weight · 일 40 soft cap
  • Phase 0 3개월 후 실사용 데이터 기반 재조정

7. 기술 제약​

  • AI 스택: Firebase AI Logic (Gemini) 만 · 국산 소버린 AI 출시 시 전환 (ADR 0004)
  • 대체 provider (OpenAI·Anthropic) 금지 (memory project-ai-stack.md)
  • Vector Search 단일 인덱스 + restricts: tenantId 메타필터 (Pro tier 분리 금지)
  • 청킹 char/sentence 기반 (토크나이저 불일치 대비)
  • Cloud Run min=0 + 핵심 RAG 경로 min=1 warm pool
  • Firestore 분산 카운터 10 shard (Phase 1)
  • CMEK 전 tenant 일괄 (Phase 2+)

8. 지표·성공 기준​

8.1 Phase 0 Go/No-Go 관문​

  • 대여금 계산 정확도 99.5%
  • 내부 변호사 3명 dogfood 주 3회+
  • 엑셀 병행 이탈률 70%+
  • Ko-LegalQA Faithfulness 0.85+
  • Citation Precision 0.95+ hard gate
  • 비식별화 4단 End-to-End 작동
  • Audit 로그 완결성
  • assertTenantFilter CI 0건 우회

8.2 Phase 1 종료 지표 (18M)​

  • 활성 tenant 80개+
  • 월 케이스 생성 600건+
  • /legacy 재열람률 35%+
  • 사건 등록→소장 제출 평균 30% 단축
  • AI assist 12회+/case
  • Pack 1 이탈률 월 4% 미만

8.3 북극성 지표 (ADR 0004 §3)​

  • AX Level 3+ 사무소 비율 (L3 = 월 AI 50+·기억 20건+·Pack 1 완주 3건+)
  • Phase 1 말 L3 28% 목표
  • 조기 신호: WAO × Legacy Docs per Office
  • 구조 moat: ADF (사무소당 자산 밀도) · KHR (세대 간 지식 이전율)
  • 제품 품질: CCR (사건 완주율) 45%+
  • 투자 번역: Shadow ARR = L3 사무소 × 50만원

8.4 SLO (ADR 0005 §11)​

  • RAG p99 < 3초
  • 생성 p99 < 10초
  • error rate < 0.5%
  • refund rate < 3%
  • 일 AI 비용 예산 120% 즉시 alert

9. 제외 항목 (Anti-Goal)​

전 기능 무료 전제 (ADR 0002)​

  • 플랜 차별 (free/starter/pro 한도 차이) ❌
  • 기능 Pro 전용 락 ❌
  • PDF 출력 횟수 제한 ❌
  • 시나리오 B 유료 ❌

기능 Anti-Goal (ADR 0001·0002·0006)​

  • 민사 외 소송 관리 ❌
  • "법률 조언 AI" ❌ (승소 확률 수치·권유·단정·의뢰인 노출)
  • 의뢰인 B2C 매칭 ❌
  • 변호사 매칭·광고 ❌ (로톡 경로)
  • 집단소송 (Phase 4 최후) ❌ in Phase 0~3

Phase 1 제외​

  • 이혼·상속·부동산 (Phase 2)
  • 계약 분쟁 · 집행 자동화 심화 (Phase 3)
  • Tier 2 사무소 자산 AI 학습 (DPIA 후)
  • Tier 3 사무소 간 공동 학습 (1년 유예)

10. 로드맵·일정​

Phase기간주요 작업eng-day
Phase 04주파이프라인 기초·계산 엔진·CSV 3은행·Ko-LegalQA 100문제56
Phase 1~12MB방식·시나리오·공탁·시효·은행 5개 추가·사무소 기억 Phase 0~2155
Phase 2a6주판결 후 재계산·소촉법 분기3~4
Phase 3~?집행·배당·세무 정산서·승인 워크플로우-

Phase 0 착수 전 필수 (ADR 0005·0006 Amended 2026-04-20):

  • 사이버 배상책임보험 10억+ 가입
  • 수임약정서·DPA 법률자문 완료본 배포
  • AI·데이터 전문 변호사 자문 300만~700만 (2건 의견서: 공공누리·변호사법 §109)

11. 팀·리소스​

Phase 0 (4주, 56 eng-day):

  • 풀스택 엔지니어 1~2명
  • AI/ML 엔지니어 1명 (P12 + P17 역할)
  • 변호사 자문 1~2명 (Ko-LegalQA 작성·dogfood)
  • 법무 자문 외부 (5건 서면 의견서)

Phase 1 (12M, 155 eng-day):

  • 풀스택 2명 + ML 엔지니어 1명
  • 디자이너 1명 (사건 상세 UI·사무소 기억 UI)
  • 변호사 자문 (시니어 변호사 2~3명 dogfood)

12. 리스크·대응​

리스크영향대응
계산 오류 배포변호사 과실 배상 직결engineVersion 롤백·infraHardening 킬스위치·50건 실제 테스트
RAG hallucinationMata v. Avianca 재현실재성 3단 방어·Citation 0.95 hard
법고을 공식 협약 지연·불성사판례 본문 RAG 도입 지연조문·법령 RAG 단독으로 Phase 0~1 진행. 공공 판례 도입은 협약 진척도에 따라 재조정
비식별화 재식별 사고개인정보법 위반·집단소송k≥10 공공 한정·자동 스캐너·월 수동 검토
변호사법 §109 저촉법정형 7년 이하승소 수치 금지·코드·UX·포털 3중 차단·외부 의견서 면책
AI 호출 비용 폭주runway 단축5단 통제·assistLimit·warm pool
소버린 AI 전환 지연Gemini 의존어댑터 레이어 12M 완성·공공 fallback
콜드 스타트 누적UX 8~12초 치명핵심 경로 Cloud Run min=1

관련 문서​