프로그램 실행하는 법

1. node.js를 다운로드 받고 설치한다. 개발자가 테스트한 환경은 v22.12.0(LTS) 버전이다. 다른 버전이라도 왠만하면 작동할 것이다.
2. 아래 secrets.json 파일 만들기 내용을 반드시 읽고, 데이터베이스 접속 정보와 OpenAPI 키 정보를 입력한다.
3. 터미널/CMD에서 npm install을 실행한다.
4. DB가 올바르게 준비됐다면, 터미널/CMD에서 node index.js [시작년월(YYYYMM)] [종료년월(YYYYMM)]을 실행한다.
   • 어떤 내용이 DB에 입력되는지 알고 싶다면 /config/config.js 파일의 mapping을 참고해보세요. 이해하기 쉽게 만들지는 못했지만요.
5. 이제 프로그램이 알아서 API에서 제공하는 데이터를 읽어들여 DB 테이블에 입력해준다.

secrets.json 파일 만들기

1. /config 디렉토리에 있는 secrets-example.json 파일을 복사해서 같은 디렉토리에 secrets.json 파일을 만든다.
2. secrets.json 파일의 내용을 채운다.
   1. Oracle 데이터베이스 계정 정보를 입력한다.
   2. API 키 가져오기
      1. 법정동코드 (regionCd): API 키 신청 링크
      2. 단독/다가구 (dandok): API 키 신청 링크
      3. 연립 다세대 (yeonlip): API 키 신청 링크
      4. 오피스텔 (officeHotel): API 키 신청 링크

index.js 실행시 DB 관련 안내

직접 테이블을 작성하기 귀찮다면, JachuiPlan 프로젝트의 Spring boot 서버를 한 번 실행해주면 JPA가 알아서 테이블을 생성해준다.

1. 기존 REGIONCD 테이블은 모든 내용을 DELETE하고 새로 INSERT된다.
2. 단독/다가구, 연립다세대, 오피스텔 실거래 데이터가 들어가있는 기존 내용은 삭제되지 않는다. 일간 API 호출 한도로 인해 여러번 나눠서 데이터를 입력해야 하기 때문에 기존 데이터를 남기고 며칠에 나눠 실행하는 방향으로 진행하고 있기 때문이다. 테이블이 없다면 미리 만들어줘야 한다. 테이블 구조는 ERDCloud에 작성되어 있음. ERD Cloud 링크