docs(funding): accept ADR 0006 on automating funding candidates

[jhjh0512]

Closes #5

변경 내용

docs/decisions/0006-funding-discovery-automation.md에 ADR 0006(Accepted, Owner: jhjh0512)을 추가했다. 자금 후보를 두 갈래로 나누고, 정책자금 후보는 자동으로 올리고 내리며, 지원사업은 자동으로 찾는다는 결정이다. 2026-09-28에 실제 API 응답과 출처별 robots.txt·약관을 확인한 결과를 반영했다(e71981a).

• 지원사업(지원금·공간·프로그램): 자동으로 승격하지 않는다.
  • 기업마당 API로 새 공고를 찾아 추가 확인으로 올리고, 강등만 자동으로 한다. 현재 후보는 사람이 확인해야 된다([작업] 자금 카탈로그 원문 확보와 운영 상품 검수 (#5 결정 후) #13).
  • K-Startup 공고 API는 쓰지 않는다. 승격 규칙을 그대로 적용하면 서울 예비 창업자 후보가 116건 나오는데, 대부분 음식점 창업과 무관했다.
• 정책자금(대출·보증): v1 크롤링 출처는 소진공 정책자금 사이트(ols.semas.or.kr) 하나다.
  • "정책자금 한눈에 보기" 표와 공지 상세 HTML에서 값을 뽑는다. 공지 목록 JSON은 상세 페이지를 찾는 데만 읽는다.
  • robots.txt가 없고, 약관에 자동 수집 금지 조항이 없다. 담당자가 출처 표시 조건으로 수집을 허용했다.
  • 서울시 육성자금은 조건이 HWP 첨부에만 있어 사람이 관리한다. 새 공고와 변경공고를 찾는 일만 기업마당으로 자동화한다.
  • 소상공인24 내부 JSON API와, robots.txt가 막는 사이트는 쓰지 않는다.
• 크롤링 규칙:
  • 로그인 없는 공개 페이지만, 하루 한 번, 요청 사이 1초 이상 간격을 둔다.
  • 차단되면 그 출처를 멈추고 우회하지 않는다.
  • 첨부(PDF·HWP) 해석과 AI는 쓰지 않는다.
• 현재 후보로 자동으로 올리는 조건(정책자금): 신청기간, 사업 단계, 지역, 제외 신호 없음, 차단 목록에 없음, 출처의 마지막 성공 동기화가 3일 이내.
  • 업종·용도·연령이 확인되지 않은 상품도 막지 않고 "신청 전 확인"으로 표시한다.
• 상환 계산 가능으로 자동으로 올리는 조건: 단일 고정 금리, 전체 기간, 거치, 상환방식이 공고 본문에 모두 숫자로 적혀 있을 때만.
  • 소진공 표는 상환방식이 없고 금리가 대부분 기준금리 연동이라, 표만으로는 0건이다.
• 자동으로 내리는 경우: 신청 종료일이 지남, 조기 마감을 포함한 접수 마감, 제외 신호, 3일 넘게 동기화 실패.
  • 한 출처가 실패해도 다른 출처에는 영향이 없다.
• 스위치: 정책자금 자동 승격과 상환 계산 자동 승격을 각각 끌 수 있다. 첫 4주 표본 점검과 중단 조건을 둔다.
• 코드·스키마 변경은 없다. ADR 9절의 문서·설정 변경은 각 동작을 구현하는 PR에서 한다(AGENTS.md §7).

검증

• 문서만 바꿨다. git diff --check가 통과했고, 새 파일에는 상대 링크가 없다.
• 출처 확인: 2026-09-28에 K-Startup·기업마당 API의 실제 응답과, 크롤링 후보 사이트의 robots.txt·약관을 확인해 ADR Context에 기록했다.

위험·후속

• 데이터 계약 변경: 구현 PR에서 AGENTS.md §3의 8번을 바꾼다. 업종·용도 UNKNOWN의 처리가 바뀐다(feat(funding): keep unknown industry and purpose as pre-application checks #36). 함께 고칠 문서는 docs/PRODUCT.md, docs/domains/funding.md, docs/DEVELOPMENT.md다(ADR 9절).
• 판정 빈틈: ADR Context에 적은 신청 종료일 문제는 #34로 이미 고쳐 병합했다.
• 예비 창업자에게 주는 효과는 작다: 소진공 대출은 모두 사업자등록 이후 대상이고, 지원사업은 사람이 확인해야 현재 후보가 된다.
• 후속:
  1. 신청 종료일 판정 수정 (fix(funding): treat products past their application end date as closed #34)
  2. 업종·용도 판정 규칙 변경 (feat(funding): keep unknown industry and purpose as pre-application checks #36, 이 PR 위에 쌓음)
  3. 소진공 정책자금 크롤러와 funding:sync
  4. 기업마당 공고 탐색
  5. 후보 화면을 두 갈래로 나누기
  • 정기 실행 위치는 #15에서 정한다.
  • [작업] 자금 카탈로그 원문 확보와 운영 상품 검수 (#5 결정 후) #13(카탈로그 수동 검수)은 지원사업과 서울시 육성자금을 맡는 쪽으로 범위가 바뀐다.
• 알려진 한계:
  • 크롤링 대상의 구조가 바뀌면 파서가 깨지고, 그 출처의 후보는 3일 뒤 빠진다.
  • 변동금리 상품의 상환 계산은 계산 계약을 바꾸는 별도 ADR이 필요하다.

🤖 Generated with Claude Code

https://claude.ai/code/session_015LCE4DgT5qdHP8y8V5qtbL