PROJECT DOCUMENTATION
1. Milestone & WBS
작업을 산출물과 완료 조건으로 나누고 공식 대회 일정에 맞춰 연결합니다.
9월 — 10월 마일스톤
WBS — 작업 분해 구조
9월 18일 기능 단위로 담당을 정했습니다. 아래 표는 처음 세운 작업 분해 구조이고, 실제 담당과 상태는 작업 현황에 기록합니다.
| 단계 | 작업 | 산출물 / 완료 조건 | 선행 조건 |
|---|---|---|---|
| 환경 구성 | 저장소·개발 환경·실행 방법 정리 | 팀원이 같은 안내로 실행 | 사용 스택 결정 |
| 타당성 검토 | 대상 사용자·데이터·실행 가능성 확인 | 대표 시나리오와 데이터 샘플 확보 | 사용자 문제 선정 |
| 개발 착수 | MVP와 우선순위 확정 | 필수·확장·제외 범위 합의 | 타당성 검토 |
| 요구사항 | 기능·품질 요구사항과 판정 조건 작성 | 요구사항 번호와 테스트 연결 | MVP 결정 |
| 상위 설계 | 모듈·AI·외부 API·인프라 흐름 작성 | 모듈별 입력·출력 설명 | 요구사항 정리 |
| 구현·상세 설계 | 핵심 시나리오 구현과 실제 구조 기록 | 코드와 문서의 동작 일치 | 상위 설계 |
| 테스트 | 단위·통합·성능·예외 검증 | 재현 가능한 결과와 결함 기록 | 실행 가능한 기능 |
| 추가 요구 | 피드백 반영 여부와 범위 변경 기록 | 영향·일정·재검증 범위 합의 | 변경 요청 |
| 검수·출품 | 설치·이전·데모·자료 확인 | 검수 기록과 제출본 정리 | 테스트 결과 |
작업 현황
-
WBS-001 · 핵심 사용자와 대표 시나리오 선정 — 완료 / 팀 공동. 완료 조건: 예비 창업자의 한 문장 질문(지역·업종·예산)에서 부족 자금과 금융상품까지 이어지는 대표 시나리오.
-
WBS-002 · MVP 범위 결정 — 완료 / 팀 공동. 완료 조건: 계약 전 창업자금 사전상담을 주 동선으로 확정. AI 중심, 블록체인 앵커링은 9/18 결정으로 범위 제외.
-
WBS-003 · 데이터 출처와 사용 조건 확인 — 완료 / 팀 공동. 완료 조건: 공공데이터 수집·정기 실행(인허가 161,115건 등). 센터 민간데이터는 미확보로 별도 작업.
-
WBS-004 · 모듈 흐름과 AI 연동 방식 확정 — 완료 / 팀 공동. 완료 조건: 계산은 코드, 해석은 AI(Gemini)가 맡는 섹션별 실시간 리포트 구조.
-
WBS-005 · 핵심 시나리오 프로토타입 구현 — 완료 / 팀 공동. 완료 조건: 실제 백엔드로 질문 → 지도·진단 → 시뮬레이션 → 결론 → AI 리포트 완주.
-
WBS-006 · 정상·오류 시나리오 검증 — 완료 / 팀 공동. 완료 조건: 9/19 밤 원본 로그: 백엔드 603 통과·1 건너뜀, 프론트엔드 226/46 files·타입 검사 통과. 운영 페르소나 10/10, 개선 후 로컬 10/10·마찰 0건.
-
WBS-008 · 백엔드 최종 리뷰와 main 병합 — 완료 / 팀 공동. 완료 조건: 3개 영역 리뷰 Critical 0, 수정 3그룹 재리뷰 통과 후 main 병합.
-
WBS-009 · API 계약·배포 구조 확정 — 완료 / 장민석. 완료 조건: 9/19 완료: 연도·재무·상담 API와 지표 분모 설명 반영. Vercel + Cloudflare Tunnel 첫 배포·운영 SSE 검증 완료(WBS-013·014).
-
WBS-010 · ① 기간 일치 — 완료 / 김충식. 완료 조건: 지도 선택 연도를 분석 요청 → 지표 카드·위험도까지 같은 기준으로 전달. 캐시 프록시에서 끊기던 결함은 모델 평가 하네스가 찾아 수정.
-
WBS-011 · ② AI 진행 표시 — 완료 / 김충식. 완료 조건: 9/19 완료: 입력 확인·지역 근거·자금 계산·상담 후보 정리 등 수행 작업으로 진행 안내. RAG·스코어 내부 용어 제거, 페르소나 후속 검증 반영.
-
WBS-012 · ③ 자금 점검 동선·계산 가정 표시 — 완료 / 류준. 완료 조건: 계약 전 창업자금 사전상담을 주 동선으로 전환(T1~T7). 계산 가정·미입력 항목을 확인 목록에 표시.
-
WBS-013 · ④ 데이터 신뢰 표시 — 완료 / 류준. 완료 조건: 폐업률·증감률 카드에 분모 설명, 30일 규칙 반영(DEC-023), 상대 순위 표기(DEC-024), 학원·부동산·어린이집 “폐업률(추정)” 라벨, 편의점 “담배소매인 기준” 표기.
-
WBS-014 · ⑤ localhostdaegu.cloud 배포 — 완료 / 김충식(BE) · 류준(FE). 완료 조건: 9/19 첫 배포: 네임서버 Cloudflare 이전, 백엔드 Cloudflare Tunnel(api.localhostdaegu.cloud), 프론트 Vercel(Git 연동 자동 배포). 9/20 팀 확인: 최신 변경 배포 갱신 완료.
-
WBS-015 · ⑦ 시연 자료 · 구현 화면으로 대체 — 완료 / 김충식(대본 장민석). 완료 조건: 9/20 팀 확인: 시연 영상은 구현 화면으로 대체. 최신 화면 8장과 사용 흐름 공개 완료.
-
WBS-007 · 제안요약서 작성과 접수 — 완료 / 장민석. 완료 조건: 9/20 팀 확인: 제안요약서 작성 및 대회 접수 완료.
-
WBS-016 · ⑥ 공공데이터 적재(여력 시) — 완료 / 류준. 완료 조건: 9/19 공공데이터 5종 적재·지도 패널 동네 특성 배지로 표시(WBS-026과 동일 작업).
-
WBS-017 · 대구 빅데이터활용센터 데이터 이용·반출 조건 확인 — 논의 중 / 미배정(마감 전 범위 밖). 완료 조건: 이용 신청·반출 심사·허용 집계 단위·서비스 공개 범위를 문서로 확인. 마감 전 확보를 전제하지 않음.
-
WBS-018 · 로그에 기록된 외부 API 키 재발급 — 완료 / 장민석(키 관리). 완료 조건: 9/19 밤 청년정책 API 키 재발급·교체, 단건 200·수집기 정상 종료 확인.
-
WBS-019 · 창업자금 사전상담 전환(T1~T7)과 상담 세션 서버 기록 — 완료 / 류준. 완료 조건: 자금 구성 분리·최초안/현재안 비교·미입력 구분·상담자료 Markdown/인쇄·세션/계획/노트/문서 기록·세션 갱신·자치구별 iM뱅크 우선 후보와 차선 후보.
-
WBS-020 · DB 스키마 19 → 29테이블과 ERD 문서 — 완료 / 장민석. 완료 조건: 금융상품·외부 데이터셋·지표·상담 4영역 추가, 기존 컬럼 무변경, 마이그레이션 왕복·alembic check 통과, 고립 테이블 2건 감시 테스트.
-
WBS-021 · 제출 문서 4종과 배포 가이드 — 완료 / 장민석(제출 문서·배포 구조) · 김충식(배포 가이드). 완료 조건: 배포 런북·제안요약서·시연 대본(수치 재검산)·참가신청서 개정안, Vercel + Cloudflare Tunnel 초보자용 가이드.
-
WBS-022 · 오프라인·온라인 가용성 모델 평가(임베딩·LLM) — 완료 / 김충식. 완료 조건: 로컬 3종·외부 6종 임베딩, 로컬 3종·외부 1종 LLM을 같은 조건으로 평가. 대체는 qwen3-embedding:4b@2560·gemma4:12b, 동주 11.6 GiB 확인.
-
WBS-023 · 평가셋 검수와 자동 폴백 설계(마감 후) — 예정 / 김충식. 완료 조건: 평가셋 80건을 미만료 공고로 재추출·검수(confirmed 승격), 외부 API 실패 시 자동 폴백 설계 여부. 2560 마이그레이션·재색인·provider 설정화는 9/19 완료(DEC-026).
-
WBS-024 · 단기 폐업(30일 이내 종료) 집계 제외 반영 — 완료 / 류준. 완료 조건: 9/19 반영: 개업 30일 이내 종료 제외. 2025년 개업 5,755→4,780·폐업 6,259→5,301, 폐업률 100% 초과 동 2→0.
-
WBS-025 · 위험 점수 상대 순위 표기 — 완료 / 장민석. 완료 조건: 9/19 반영: “상대 위험 높음/중간/낮음” + 142개 동 가운데 순위 표기, 실패 확률이 아님을 명시.
-
WBS-026 · 공공데이터 5종 행정동 지표 적재 — 완료 / 김충식. 완료 조건: 9/19 공공데이터 5종 적재 완료. 같은 날 지도 패널에 동네 특성 배지·도시철도 시간대별 승차 연결 완료(WBS-027).
-
WBS-027 · 미연결 데이터 화면 연결과 내부 화면 다듬기 — 완료 / 김충식. 완료 조건: 인구·동네 특성·지하철·충격 이벤트·R-ONE 월세 도우미 연결, 사전상담 2단·자금 그래프·금리 표, 지도 추이 차트, 동 이름 표기.
-
WBS-028 · 운영 사이트 페르소나 테스트 10명과 후속 개선 18건 — 완료 / 김충식. 완료 조건: 운영 주소에서 10/10 상담자료 도달, 결함 7건 발견 → 18건 수정 후 재실행 10/10·마찰 0건.
-
WBS-029 · SGIS 지오코딩과 지표 업종 11종 연결 — 완료 / 김충식. 완료 조건: 학원·부동산 좌표 채움, 인허가 좌표 없음 5,547건 중 3,232건 변환, 담배소매업 33,804건 적재로 편의점(담배소매인 기준)·어린이집 지표 연결 → 12,360행·11업종. 브이월드 저장 결과는 SGIS로 교체.
-
WBS-030 · 배포 갱신·구현 화면·9/20 접수 완료 — 완료 / 김충식(배포·구현 화면) · 장민석(접수). 완료 조건: 9/20 팀 확인: 최신 변경 배포 갱신, 시연 영상의 구현 화면 대체, 제안요약서 작성 및 접수 완료.
추가 요구사항 처리
변경 이유 → 영향받는 요구사항·모듈 → 일정 영향 → 채택 여부 → 재검증 시나리오를 기록합니다. 기존 요구사항을 수정한 경우 변경 이유를 논의와 결정에 연결합니다.
일정 관리 원칙
- 공식 일정과 팀 내부 계획을 구분합니다.
- 본선 이후 작업은 진출을 조건으로 계획합니다.
- 작업 완료는 파일 존재뿐 아니라 각 작업의 완료 조건을 기준으로 판단합니다.
- 진행 현황은 이 문서와 같은 작업 데이터를 표시합니다.