PROJECT DOCUMENTATION

논의와 결정

결정 기록 · 미결 관리기준일 2026-09-19담당 장민석 · PM/아키텍트

아직 정하지 않은 것과 이미 결정한 이유를 함께 남깁니다.

확정한 사항

번호	결정	근거	날짜
DEC-001	팀명 localhost:daegu, 구성원 장민석·김충식·류준	팀 구성 안내	2026-09-15
DEC-002	소상공인·골목상권 디지털 금융 트랙	참가 방향 확인	2026-09-15
DEC-003	프로젝트 허브 구조로 Jekyll 초안 작성	브레인스토밍 이후 초안 요청	2026-09-15
DEC-004	서비스명 localhostdaegu, 방향은 예비 창업자를 위한 창업 금융 네비게이터 — 위험 진단 → 부족 자금 계산 → 금융상품 연결 → AI 리포트	실매출 데이터가 없어 매출 증빙 방향은 제외. 트랙 예시 중 청년창업·시드 금융 연결과 골목상권 AI 컨설팅을 함께 다룸 (OPEN-001·002 해소)	2026-09-15
DEC-005	AI 중심으로 구현하고 블록체인(리포트 해시 기록)은 여력 시 선택 항목	대회 주제는 AI 또는 블록체인. 확인한 공고문 원문에 두 기술을 동시에 구현해야 한다는 조건이 없음 (OPEN-006 해소)	2026-09-15
DEC-006	팀이 이전에 만든 서울 상권 서비스(Metabole) 코드를 옮겨 대구 기준으로 교체	수집·지도·AI 검색 구조가 이미 동작하고, 타 대회 출품 이력이 없는 자작 코드라 재사용 제약 없음	2026-09-15
DEC-007	점수·금액 같은 결론은 코드가 계산하고, AI는 해석 문단만 작성	AI가 숫자를 만들지 않게 하고, AI 호출이 실패해도 계산 결과를 유지	2026-09-15
DEC-008	뉴스 수집을 네이버 검색 API에서 구글 뉴스 RSS로 교체	네이버 키 문제. RSS는 키·호출 한도 없음	2026-09-16
DEC-009	AI 리포트 모델 gemini-3.8-flash, 검색 색인·질의 임베딩도 Gemini로 통일	팀 결정 “최신 정식 Flash 모델”. 색인 3,560건이 모두 Gemini 임베딩이라 질의도 같은 임베더여야 함 (OPEN-005 해소)	2026-09-17
DEC-010	금융상품은 조사한 실상품 12건(iM뱅크 3·대구신용보증재단 5·정책자금 4). 대구 전용이 아닌 중진공·소진공 상품 포함, 특정 구·군 한정 특례보증은 매칭 제외	자리표시자 대체. 구·군 한정 상품이 다른 동에 매칭되는 문제 방지	2026-09-17
DEC-011	기본 비교 연도는 마지막 완결 연도(현재 2025). 2026년은 “(집계 중)” 표시	2026년은 연중 자료라 연간 확정치가 아님. 지도·요약 카드 연도 불일치 해소	2026-09-18
DEC-012	충격 데이터를 서울 수도권 거리두기에서 대구 코로나 타임라인으로 교체, 항목마다 출처 표기	서울 원본이 그대로 남아 있었음. 리뷰에서 3건 원문 대조	2026-09-18
DEC-013	대구 언급이 없는 타 도시 뉴스를 백업 후 삭제하고 키워드에 “대구”를 붙임	“중구 상권” 등 5개 키워드가 광주·울산·대전 기사를 수집(587건 중 대구 언급 68건)	2026-09-18
DEC-014	시뮬레이터 대출금리 기본값을 한국은행 최신 중소기업 대출금리로 채움	실측 최신 금리 사용(조회 중·실패 시 4.5%). 사용자가 입력한 값은 덮어쓰지 않음	2026-09-18
DEC-015	기능 단위 풀스택 분담 — 장민석 팀장·PM/아키텍트, 김충식·류준이 기능별로 백엔드부터 프론트엔드까지 담당. 계약 먼저 → 기능 브랜치 → PR → 팀장 승인 → main	백엔드·프론트엔드 작업을 두 사람에게 고르게 나누고 팀장은 계약·리뷰·제출에 집중. 9/19 18:00 코드 프리즈 (OPEN-003 해소)	2026-09-18
DEC-016	마감 전 추가 공공데이터는 전통시장·나들가게만 여력 시 적재	5종 전체 적재 예상 3.5~4일. 온누리 가맹점·백년가게는 주소만 있고 도시철도 승하차는 역명 매칭이 필요해 마감 후로 미룸	2026-09-18
DEC-017	주 동선을 “계약 전 창업자금 사전상담”으로 전환 — 지도 선택 → 월세·투자비·자기자본 계산 → 조건 변경 비교 → iM뱅크 상담자료. 위험 진단은 보조 링크	계약 뒤에는 조건 변경에 비용이 든다. 재무 입력 없이 분석으로 가던 문제 해소 (OPEN-010 해소)	2026-09-18
DEC-018	9/19 18:00 코드 프리즈를 해제하고 계속 개발. 블록체인 앵커링은 범위에서 제외(상담자료 sha256 해시만 기록)	사용자 결정. 트랙 5.3 공식 예시에 블록체인 항목이 없음	2026-09-18
DEC-019	은행 후보는 iM뱅크 최우선, 원문에 취급 은행이 확인된 상품만 후보. 미확인 상품은 “차선 후보”로 분리 표시	확인하지 않은 것을 확인한 것처럼 쓰지 않기 위해. 12건 원문 대조 결과 direct 2·linked 3·unverified 7	2026-09-18
DEC-020	배포는 프론트엔드 Vercel, 백엔드 로컬 GPU 머신 + Cloudflare Tunnel, DB 로컬 Docker	기존 remakeday.com이 같은 구성으로 운영 중이라 재사용. 도메인 네임서버 이전 시간이 변수 (OPEN-007 해소)	2026-09-18
DEC-021	DB 스키마를 19 → 29테이블로 확장(금융상품·외부 데이터셋·지표·상담). 기존 컬럼 무변경	iM뱅크 전환 계획의 “테이블 추가 안 함” 중 DB 항목만 정정. 로그인·은행 API·채팅 서버는 여전히 추가 안 함	2026-09-18
DEC-023	카페 등 개업 30일 이내 종료 건은 폐업률·위험도 집계에 반영하지 않음	성내2동 2025년 카페 폐업 182건 중 137건이 30일 이내 종료 — 단기 영업 인허가로 보아 실제 폐업과 구분 (OPEN-008 해소). 9/19 집계 반영 완료	2026-09-19
DEC-024	위험 점수는 대구 행정동 간 상대 순위로 표현하고 실패 확률로 쓰지 않음	점수는 폐업·밀집·성장의 상대 지표 (OPEN-009 해소). 9/19 지도 상대 순위·해석 문구 반영 완료	2026-09-19
DEC-025	대구신용보증재단 보증 4건을 iM뱅크 상담 후보(linked)로 승격	재단 보증서 담보 대출은 특정 은행에 묶이지 않는 전 은행 취급 구조. 원문의 “시중은행” 표기는 제한이 아님 (OPEN-012 해소). 후보 3→7건	2026-09-19
DEC-026	운영은 Gemini 유지, 온라인·오프라인 임베딩 차원을 2560으로 통일(halfvec), 오프라인은 시연 대비 배선으로 두고 전환은 재색인 약 3분 + 환경변수 2개	로컬 qwen3-embedding:4b가 2560차원. pgvector HNSW는 vector 2000차원 상한이라 halfvec 사용. Gemini 2560 전량 재색인 완료 (OPEN-011 해소)	2026-09-19
DEC-022	오프라인 대체 모델은 임베딩 qwen3-embedding:4b(2560차원)·리포트 gemma4:12b. 기본 경로는 Gemini 유지, 자동 폴백 없음	같은 코퍼스·질문·프롬프트 평가에서 Gemini와 동급 이상(Top-1 0.762 대 0.700, 게이트 1.000 대 1.000). bge-m3는 정확도, exaone은 NC 라이선스로 제외. 임베딩+LLM 동주 11.6 GiB	2026-09-18
DEC-023	상담 후보에 자치구 필터를 적용해 달성군·북구 한정 상품을 해당 지역에 표시. 레거시 /matching은 계속 지역 한정 상품 제외	district_code FK 추가. 업종 목록 []로 지역 제외를 대신하던 방식 수정. DEC-010의 일괄 제외를 상담 경로에 한해 갱신	2026-09-18
DEC-024	화면 정본은 sessionStorage, 서버는 상담 세션·계획·노트·문서의 감사·재현용 기록. 세션과 노트는 교체로 갱신	선택안 변경에도 세션·노트가 계속 쌓이지 않게 함. 리포트는 입력값으로 다시 계산하며 저장 실패가 자료 생성을 막지 않음	2026-09-18
DEC-025	고립 테이블 interest_rate·funding_program은 근거 있는 예외로 유지하고 테스트로 감시	전국 금리에 지역 FK를 붙일 이유가 없고, 정책 공고의 안전한 지역 관계도 부족. 새 고립 테이블이나 해소된 예외 잔류는 테스트 실패	2026-09-18

이 표는 결정 이력을 보존합니다. 현재 범위는 사전상담 전환(DEC-017), 코드 프리즈 해제·블록체인 제외(DEC-018), 지역별 상담 후보(DEC-023)를 따릅니다. 이전 결정의 선택 항목·프리즈·지역 상품 일괄 제외를 현재 상태로 해석하지 않습니다.

기능별 담당은 팀 소개, 작업 상태는 진행 현황에서 확인할 수 있습니다.

미결 항목

번호	질문	결정에 필요한 정보	담당
OPEN-004	대구 빅데이터활용센터의 카드 소비·생활인구 데이터를 쓸 수 있을까?	센터 방문이 필요해 본선 진출 시 9/28 멘토링 당일 방문해 이용 신청·허용 집계 단위·공개 범위를 확인한다. 마감 전 확보는 전제하지 않음	팀(9/28 방문)
OPEN-013	북구 청년창업 특례보증(youth-1)의 2026년 재공고가 있는가?	현재 근거는 2025년 공고. 지역 조건을 맞춰도 올해 시행 여부는 별도 확인 필요	미배정

결정 기록 형식

질문 → 선택지 → 결정 → 이유 → 영향받는 요구사항·문서 → 확인 방법으로 기록합니다. 회의나 개발 기록에서 결정이 나온 경우 관련 문서도 함께 갱신합니다.