FundPilot

AI 기반 정책자금 추천 및 승인 가능성 사전 진단 웹 서비스입니다. 사용자가 기업 정보를 입력하면 중소벤처기업진흥공단 공공데이터 기반으로 정책자금 TOP 3, 승인가능성, 추천 근거, 리스크 요인, 신청 가이드를 제공합니다.

문서

문서	용도
docs/HANDOFF_FOR_AI_AGENTS.md	새 AI 에이전트 세션용 인수인계
docs/PROGRESS_REPORT.md	동료 공유용 진행상황 요약
docs/FundPilot_PRD.md	제품 요구사항
docs/agents/pm_architect/API_SPEC.md	API 계약
docs/agents/pm_architect/DATA_SCHEMA.md	DB 계약

실행 방법

깃허브 repo 끌어오기

처음 다운 받는 경우

git clone https://github.com/chan1945/FundPilot.git
cd FundPilot

다운은 받아놨는데 최신이 아닐때

cd /path/to/FundPilot
git pull origin main

1. 환경 변수 준비

cp .env.example .env

기본 포트:

Service	URL
Frontend	http://localhost:3000
Backend	http://localhost:8000
API Docs	http://localhost:8000/docs
PostgreSQL	localhost:5432

2. DB 마이그레이션

./scripts/migrate.sh

기존 개발 DB에 SQLAlchemy create_all로 만든 테이블이 있으면 Alembic 버전만 stamp head 처리합니다.

3. 데이터 적재

최소 seed 데이터:

./scripts/seed.sh

중소벤처기업진흥공단 공공데이터 CSV 정규화 및 DB 적재:

./scripts/load_public_data.sh

현재 활용하는 원천 데이터 위치:

/home/huichan/FundPilot/중소벤처기업진흥공단_공공데이터_2025년

주요 활용 파일:

• 정책자금 사업별 지원 현황(시설 운전)
• 정책자금 업종별 지원 현황
• 정책자금 업력별 지원현황
• 매출액 규모별 지원실적
• 정책자금 자금종류별 융자 현황
• 정책자금 융자제외 대상 업종

4. 전체 서비스 실행

./scripts/dev.sh -d

중지:

docker compose down

로그 확인:

docker compose logs -f backend
docker compose logs -f frontend

사용 흐름

1. http://localhost:3000/input 접속
2. 기업명, 업종, 매출액, 업력, 지역, 자금 용도 입력
3. 분석하기 클릭
4. 추천 결과 TOP 3 확인
5. 상세보기와 신청 가이드 확인

주요 API

Method	Endpoint	설명
POST	/api/v1/diagnosis	기업 진단 생성 및 추천 TOP 3 반환
GET	/api/v1/diagnosis/{diagnosis_id}	저장된 진단 결과 조회
GET	/api/v1/funds	정책자금 목록 조회
GET	/api/v1/funds/{fund_id}	정책자금 상세 조회
GET	/api/v1/funds/{fund_id}/guide	신청 가이드 조회

검증 명령

Backend 전체 테스트:

docker compose run --rm backend /bin/sh -lc "pip install --no-cache-dir -r requirements.txt >/dev/null && python -m pytest tests"

Frontend 타입 체크:

docker compose run --rm frontend /bin/sh -lc "npm install && npm run typecheck"

API smoke test:

curl http://localhost:8000/api/v1/funds

curl -X POST http://localhost:8000/api/v1/diagnosis \
  -H 'Content-Type: application/json' \
  -d '{
    "company_name": "주식회사 펀드파일럿",
    "industry": "제조업",
    "industry_code": "C",
    "annual_revenue": 3000000000,
    "business_age_years": 7,
    "region": "서울특별시",
    "fund_purpose": "시설자금"
  }'

면책 문구

본 결과는 공개된 정책자금 지원 현황과 입력 정보를 기반으로 한 사전 진단이며, 실제 정책자금 승인 여부를 보장하지 않습니다. 최종 신청 가능 여부는 중소벤처기업진흥공단의 최신 공고와 심사 기준을 확인해야 합니다.