Glossary

용어집

dev a9974a0 (2026-10-12) 기준

위키와 코드에 나오는 도메인 용어, 상태값, 기술 용어를 모았다. 용어마다 코드에서 쓰는 이름을 함께 적어 위키 용어로 코드를 찾아갈 수 있게 했다. 용어와 코드 이름이 다르면 코드 이름이 맞다. 백엔드 쪽 용어(검수, 제안, 사건번호 등)는 Backend 위키의 용어집에 있다. 각 절 안은 한글 용어를 가나다순으로, 그 뒤에 영문 용어를 알파벳순으로 놓았다.

도메인 용어

용어	뜻	코드 이름
가입 특약	사용자가 가입한 보험의 담보 목록과 가입금액. 백엔드 테이블에 봉투 암호화돼 있다	user_insurances.coverages, subscribed_coverages
누락 가능 특약	가입했지만 청구하지 않은 것으로 보이는 특약. 리포트의 주요 산출물	applicable_coverages
문서 유형	업로드 문서의 분류. 필수는 보험증권·진단서	DocType (POLICY, DIAGNOSIS, HOSPITALIZATION_CERT, MEDICAL_RECEIPT, OTHER 등)
보험금 추정 범위	확정 금액 대신 제시하는 범위. 하한=정액 특약 합계, 상한=하한+후유장해	estimated_range (min, max)
장해분류표	후유장해 부위·등급·지급률을 정한 표. 약관 별표 또는 금융감독원 표준표(개정판 3개)	schedule_chunks
장해지급률	장해 항목의 지급 비율. 검증을 통과한 것만 규칙으로 합산한다	combine_disability_rate
청구	한 사고에 대해 사용자가 올린 문서 묶음. OCR 결과를 모아 리포트를 만드는 단위	claim_id
한시장해	영구가 아닌 장해. 존속기간 5년 이상이면 지급률의 20%만 인정	disability_rules.py
후유장해 미확정	치료 중이라 장해를 확정할 수 없는 상태. 0%가 아니라 재평가 대상으로 안내	disability_pending_reeval
KCD 코드	한국표준질병·사인분류 코드. 진단서에서 추출해 보험금 산정에 쓴다	entities.icd

상태값

용어	뜻	코드 이름
OCR 품질	문서가 자동 처리를 믿을 만한가. needs_reupload면 리포트를 만들지 않는다	ReportJob.ocr_quality (ok, needs_reupload), ocr_results.ocr_quality
원본 삭제 상태	이미지 마스킹 검증 뒤 S3 원본 삭제의 outbox 상태	ocr_results.original_delete_status (pending, deleted, not_eligible, exhausted)
청구 진행 상태	청구 fan-in 판정 결과. blocked도 이제 재업로드 통지를 발행한다	ai.claim_readiness.status (pending, blocked, published)
코퍼스 문서 상태	약관 문서의 우선순위 큐 상태. claim하면 in_progress	corpus_file.status (pending, in_progress, done, failed, archived)
코퍼스 파트 상태	문서에 딸린 첨부 하나의 스테이징 상태	corpus_file_part.status (pending, uploaded, failed)
리포트 상태(워커가 쓰는 값)	리포트 워커가 core.reports에 남기는 상태. 새 값은 백엔드가 먼저 배포해야 한다	reports.status (BLOCKED, NEEDS_REUPLOAD)

기술 용어

용어	뜻	코드 이름
결정적 실패	다시 해도 결과가 같은 실패(파일 손상 등). 재전달하지 않고 즉시 종결해 실패 저널에 남긴다	NonRetryableError
검은블록 마스킹	PII 줄의 bbox에 검은 사각형을 그린 비식별 이미지 사본. 손해사정사 열람용	masked/{job_id}/page-N.png
라인 마스킹	줄 단위로 마스킹한 텍스트. 페이지 스팬을 라인 로컬 오프셋으로 잘라 쓴다	masked_lines, line_local_spans()
리딩오더	bbox (y0, x0) 기준의 시각적 위→아래 순서. surya 검출 순서와 다를 수 있다	reading_order()
실패 저널	OCR 작업의 일시·확정 실패 기록. 백엔드가 SELECT만 한다	ai.ocr_job_failures
원본 삭제 게이트	bbox 커버리지 ≥ 95%와 재OCR 잔류 검사를 모두 통과해야 원본 삭제를 허용하는 판정	ocr_worker/masking/image_verify.py
잔류 검사	마스킹 뒤 고민감 PII가 남았는지 정규식으로 다시 보는 검사. 실패하면 저장하지 않는다(fail-closed)	assert_no_residual, MaskingError
텍스트 마스킹	PII를 [이름]·[주민번호] 같은 토큰으로 바꾼 문자열. LLM 입력이 된다	masked_text
하이브리드 VLM	표 문서나 저신뢰도 페이지만 VLM으로 다시 읽어 surya 결과를 보완하는 경로	transcribe_table()
fan-in	청구의 모든 문서가 종결될 때까지 기다렸다가 리포트 생성을 한 번만 발행하는 것	_judge_claim, ai.claim_readiness
grounding	VLM에게 PII의 위치(0~1000 정규화 bbox)를 묻는 것	ground_pii(), VLM_GROUNDING_MODEL
groundedness	VLM 응답 토큰이 surya 원문 토큰과 겹치는 비율. 낮으면 환각으로 보고 버린다	_MIN_GROUNDED_OVERLAP (0.3)
poison 메시지	계속 실패하는 메시지. 수신 횟수 상한을 넘으면 명시적으로 삭제하고 로그로 알린다	sqs_max_receive_count (5)
RRF	여러 검색 결과의 순위를 Σ 1/(k + rank)로 합치는 방법	src/rag/fusion.py (RRF_K=60)
self-grant	테이블 소유 role이 자기 테이블의 SELECT를 다른 role에 내주는 것. 마이그레이션에 넣어 기동마다 재적용된다	migrations/ai/007, 008, 011
SKIP LOCKED claim	잠긴 행을 건너뛰고 다음 행을 잡아 여러 워커가 같은 일을 하지 않게 하는 PG 큐 패턴	corpus_worker/repository.py