Repository navigation
Home
OCR 워커가 만든 비식별 사본(시험용 가상 문서). 판단에 필요한 진단명·날짜는 남기고 사람을 식별하는 값만 가린다
AI 손해사정 플랫폼(팀 윤동주)의 AI 엔진 위키다. 사용자가 올린 진단서·보험증권을 읽고(OCR), 개인정보를 가리고, 약관·판례·분쟁조정사례를 검색해 보험금 리포트 초안을 만든다. 초안은 등록 손해사정사의 검수를 거쳐 사용자에게 간다. 이 레포(Python)는 OCR 워커·리포트 워커와 공용 RAG·가드레일 모듈, 약관 코퍼스 워커를 맡는다.
코드가 지금 어떻게 동작하는지는 모듈별 README와 docs/가 기준이다. 위키에는 코드를 읽어도 알 수 없는 것을 남긴다. 무엇이 문제였고, 무엇을 재고 비교했고, 그래서 무엇을 바꿨는지다. 쓰는 방법은 위키 작성 가이드에 있다. 백엔드 쪽 기록은 Backend 위키에 있다.
- 프로젝트 개요: 무엇을 만드는지, 백엔드와의 경계, 배포
- 구성과 설계 근거: OCR 워커 · 리포트 워커 · 약관 데이터와 검색 파이프라인
- 사례 기록 11편: 아래 목록
- 결정 로그 · 용어집
| 사례 | 시기 | 상태 | 한 줄 |
|---|---|---|---|
| surya만으로는 표 구조가 살아나지 않아 VLM 하이브리드로 보완 | 2026-08 | 해결 | 폰카 사진 신뢰도 0.78~0.86, VLM 2종 실측 비교 후 용도별 모델 분리 |
| VLM 응답이 200 OK로 조용히 잘리던 num_ctx 문제 | 2026-08 | 해결 | 지급결과서 전사가 "피" 한 글자에서 끊기던 문제 |
| 테스트는 초록불인데 아무도 안 읽는 값을 고치고 마스킹은 새고 있던 일 | 2026-08 | 해결 | 워커 간 엔티티 키 불일치와 관대한 테스트 페이크 |
| 사례 | 시기 | 상태 | 한 줄 |
|---|---|---|---|
| NER에 문서를 통째로 넣어 512토큰 뒤의 이름이 조용히 빠지던 문제 | 2026-06 ~ 07 | 해결 | 모델 입력 상한 뒤의 무음 PII 누락 |
| 검증되지 않은 비식별 사본으로 원본을 지우지 않도록 원본 삭제 게이트를 붙인 일 | 2026-06 ~ 08 | 해결 | 커버리지 95% + 재OCR, 저장 후 삭제, outbox 재시도 |
| PII 컬럼 암호화 전환 뒤 리포트 워커가 빈 컨텍스트로 리포트를 저장할 뻔한 일 | 2026-08 | 해결 | 바이트 단위로 쪼개진 bytea와 범용 예외 처리 |
| 사례 | 시기 | 상태 | 한 줄 |
|---|---|---|---|
| 지어낸 장해지급률이 검증을 통과하고 양팔 장해가 한 부위로 합쳐지던 문제 | 2026-07 ~ 08 | 해결 | "제12조"에도 매칭되던 지급률 검증, 좌팔+우팔 30%+30%=30% |
| 청구 단위 fan-in으로 무음 정지를 NEEDS_REUPLOAD 통지로 바꾼 일 | 2026-08 | 해결 | 문서마다 리포트, 대표 문서만 읽기, 조용히 멈춘 청구 |
| 사례 | 시기 | 상태 | 한 줄 |
|---|---|---|---|
| 유닛 테스트 209개를 통과했는데 OCR 결과가 한 건도 저장되지 않던 일 | 2026-08 | 해결 | 실문서 9건 중 0건 저장, 배포·인프라 경계의 네 가지 어긋남 |
| 스키마 미지정 마이그레이션이 워커마다 다른 스키마에 테이블을 만든 일 | 2026-08 | 해결 | 하루 세 번의 권한 장애 끝에 워커별 마이그레이션 |
| Notion 첨부를 전부 PDF로 라벨링하던 코퍼스 스테이징을 바로잡은 일 | 2026-07 ~ 08 | 해결 | 거짓 PDF 30건, 판정 일원화와 PDF 전용 정리 |