6. 요구사항정의서

개발개요

계약 전에 동×업종의 창업 경고와 근거를 확인하는 서비스입니다. 서울 427개 동을 다루며 UI 선택 14업종 중 12업종에 판정을 제공합니다. 기간은 개발 일정의 확인 사항을 따릅니다.

주요 기능

창업 조건 입력 → 최신 경고 지도 → 근거·해당 시 대안 → 설명 리포트 → 지원 정보·자금 준비. 서비스 흐름

기술 요구사항

FastAPI·PostgreSQL·pgvector·Next.js를 사용합니다. 판정과 자금 계산은 결정론 코드, 리포트는 사실 선수집·검색·LLM 설명으로 구분합니다. 계정·접속 기록이 존재하므로 개인정보 미수집으로 설명하지 않습니다. 시스템 아키텍처

요구사항 #1 (고객요구 사항) — 창업 경고와 근거 확인

예비 창업자가 계약 전에 후보 조합의 불리한 신호를 확인할 수 있어야 합니다.

업종별 최신 판정 단계구분도와 산출일을 제공합니다.
비추천·조건부·경고 없음·보류를 구별하며 정보 부족을 안전으로 표시하지 않습니다.
선택 동의 신호 수치·출처와 최근 2년 폐업 점포를 확인합니다.
제외 업종은 이유를 안내합니다. clear에서는 대안을 조회하지 않고 다른 상태도 후보가 있을 때만 제시합니다.

요구사항 #2 (고객요구 사항) — 판정의 이유를 읽는 리포트

선택한 조합에 대해 근거와 해석 한계를 읽을 수 있어야 합니다.

판정·이유·유사 사례·조건·대안·지원사업의 6개 절을 제공합니다.
사실을 먼저 수집하고 화면 자료와 LLM에 같은 입력을 전달합니다.
SSE로 진행 상황과 설명을 전달하며 일부 자료 실패는 항목별로 표시합니다.
유사 사례는 서울 전체 범위임을 밝히고 사건의 인과 효과로 쓰지 않습니다.

요구사항 #3 (고객요구 사항) — 지원·자금 준비

계약 전 필요한 비용과 상담 질문을 정리할 수 있어야 합니다.

리포트가 완료되고 지역에 관한 사실이 있을 때 지원 공고·공식 상담 창구로 연결합니다.
동·업종이 있을 때 자금 계획으로 이어지며 참고값의 출처·가정을 확인합니다.
준비자금·자기자본 외 조달 필요액·손익분기 매출을 계산합니다.
입력을 바꾸면 지난 결과임을 표시하고 재계산 전 상담 준비를 막습니다.

요구사항 #4 (고객요구 사항) — 검색 임베딩 모델 평가

리포트가 쓰는 검색 모델을 왜 골랐는지 같은 조건의 측정값으로 확인할 수 있어야 합니다.

로컬 모델(bge-m3, Qwen3-Embedding)과 외부 API 모델(gemini-embedding-001, gemini-embedding-2)을 같은 문서·같은 질문으로 비교해 로컬용과 API용을 하나씩 고릅니다.
차원별로 측정합니다. bge-m3 1024, Qwen3 1536·2560, Gemini 두 모델은 각각 1024·1536·2560입니다.
정확도(top-1·MRR·nDCG@10)와 질의 지연(p50·p95)·VRAM·비용을 함께 기록합니다. 기존 평가셋은 상한에 가까워 어려운 질문 묶음을 따로 집계합니다.
채택 모델과 탈락 사유를 남기며, 평가가 끝나기 전에는 현재 검색 모델을 유지합니다.

평가 결과는 모델 평가에 모았습니다. 임베딩(10/4)은 bge-m3@1024를 채택했고, 같은 방식으로 이어 잰 LLM 평가(10/5)에서는 리포트·관문 모두 엄격 게이트를 통과한 로컬 모델이 없었습니다. 리포트 해석은 10/6 외부 API 비교(116건)를 거쳐 gemini-3.8-flash 일반 모드를 1차로, claude-opus-5-5 → gemma4:12b를 폴백으로 쓰고, 의도 관문은 10/7 같은 날 비교(3.8 일반 98.8% 대 2.5-flash 95.0%)를 거쳐 gemini-3.8-flash 일반 모드로 바꿨습니다(v0.88.0).

검증 기준과 기존 측정 기록은 검증 결과와 원문 근거, 예외 조건은 시나리오 테스트에서 확인합니다.