VMIS-interface/README.md

# VMIS-interface

시군구 시스템이 도로교통공단(차세대교통안전공단) Open API와 연계하여 자동차 기본사항 조회와 자동차 등록원부(갑) 조회 기능을 제공하는 Spring Boot 애플리케이션입니다. 모든 요청/응답은 공통 래퍼 `Envelope<T>` 형태를 사용하며, 기본사항 조회의 경우 요청과 응답(또는 오류)을 로그 테이블에 적재합니다.

최종 업데이트: 2025-11-05 14:00

---

## 개요
- 목적
  - 자동차 기본사항 조회
  - 자동차 등록원부(갑) 조회
  - 요청/응답 로그 적재(기본사항 조회 도메인)
- 주요 특징
  - `Envelope<T>` 공통 래퍼 구조 사용
  - 환경 프로파일 분리: `dev`, `prd`
  - GPKI 연계: 운영은 실서명(`RealGpkiService`), 개발은 `NoopGpkiService`

---

## 기술 스택
- 언어: Java 1.8
- HTTP 클라이언트: Apache HttpClient5
- 문서화: springdoc-openapi (Swagger UI)
- 로깅: Logback
- 빌드 도구: Gradle(Wrapper 포함)
- GPKI: JNI 라이브러리(`lib/libgpkiapi_jni_1.5.jar`)