고도화 기록

검증 결과 기반 개선 이력 문서 테스트 데이터 / 매칭 검증 / RAG 검증 / LangGraph 검증에서 발견한 문제를 어떤 이유로 어떻게 개선했는지 기록

이 문서의 목적

단순 수정 내역이 아니라, 프로젝트의 문제 해결 과정을 명확히 보여주는 핵심 기록입니다.

문제 발견 → 원인 분석 → 수정 내용 → 재검증 결과

이 흐름을 통해 프로젝트가 "가설 설정 → 검증 → 개선 → 재검증" 구조를 가진 결과물임을 증명합니다.

ID	영역	문제 내용	원인	수정 내용	재검증	남은 이슈
IMP-01	UI/UX	마이페이지 기간이 `ANNUAL` 코드로 노출됨	코드값 직접 렌더링	기간 라벨 한글 매핑 적용	✅ 완료	분기 설계 자체 재검토 필요
IMP-02	데이터 연동	정밀진단 총부채 초기값 누락	prepare 응답에 `total_debt` 없음	백엔드 snapshot + 프론트 폼 동기화	✅ 완료	다른 재무 필드도 점검 필요
IMP-03	매칭 엔진	체납 사업자가 추천 대상에 포함됨	제외 조건 처리 부족	체납을 1차 제외 조건으로 명확화 예정	🔄 예정	정책별 예외 처리 필요
IMP-04	매칭 엔진	여성기업 우대 반영 약함	우대 가중치 부족	여성기업 가점 상향 예정	🔄 예정	우대↔필수 조건 균형 조정 필요
IMP-05	RAG	제출 서류 검색이 불안정함	서류 정보가 문서 곳곳에 분산	서류 전용 섹션 구조화 예정	🔄 예정	문서 템플릿 통일 필요
IMP-06	LangGraph	추천 질문에 일반 설명형 답변이 나옴	질문 의도 분류 약함	추천형 질문 라우팅 규칙 강화 예정	🔄 예정	비교·시뮬레이션 질문 별도 처리 필요
IMP-07	LangGraph	"왜 추천됐는가" 설명이 약함	답변 포맷 미고정	근거 중심 템플릿 도입 예정	🔄 예정	RAG 근거와 매칭 근거 통합 필요

문제 마이페이지에서 매출 기간이 ANNUAL, QUARTERLY 같은 코드값 그대로 화면에 노출됨. 사용자가 보기에 의미를 알 수 없는 텍스트가 표시되는 UX 문제.

원인 프론트엔드가 API 응답값을 변환 없이 직접 렌더링하고 있었음.

수정 내용 기간 코드 → 한글 라벨 매핑 테이블을 적용해 ANNUAL → 연간, QUARTERLY → 분기 형태로 변환.

결과 ✅ 연간 / 분기 한글 노출 확인 완료 ⚠️ 분기 설계 자체는 별도 재검토 필요