해당 코드는 패스트 캠퍼스 강의에서 사용된다.
강의 각 챕터 별 완성 코드는 링크에서
commit으로 기록 된다.
외부 API(카카오 주소 검색 API)와 공공 데이터(약국 현황 정보)를 활용함으로써 혼자 개발하고 마무리 되는 프로젝트가 아닌 실제 서비스 가능한 수준의 프로젝트를 경험 해본다.
추천된 약국의 길 안내는 카카오 지도 및 로드뷰 바로가기 URL로 제공 된다.
해당 강의를 모두 수강 하게 되면 강의에서 사용 하는 약국 도메인이 아닌 자신 만의 추천 서비스 구현이
가능해 질 것이며, 카카오 키워드 장소 검색 api를
이용하여 약국 외에 편의점, 지하철역, 음식점 등 다른 도메인으로 적용 가능함을 확인할 수 있다.
즉, 다른 도메인의 데이터 또는 api가 존재한다면 자신만의 추천 서비스를 구현 해볼 수 있다.
- 약국 찾기 서비스 요구사항
-
약국 현황 데이터(공공 데이터)를 관리하고 있다 라고 가정하고, 약국 현황 데이터는 위도 경도의 위치 정보 데이터를 가지고 있다.
-
해당 서비스로 주소 정보를 입력하여 요청하면 위치 기준에서 가까운 약국 3 곳을 추출 한다.
-
주소는 도로명 주소 또는 지번을 입력하여 요청 받는다.
- 정확한 주소를 입력 받기 위해 Kakao 우편번호 서비스 사용
-
주소는 정확한 상세 주소(동, 호수)를 제외한 주소 정보를 이용하여 추천 한다.
- ex) 서울 성북구 종암로 10길
-
입력 받은 주소를 위도, 경도로 변환 하여 기존 약국 데이터와 비교 및 가까운 약국을 찾는다.
- 지구는 평면이 아니기 때문에, 구면에서 두 점 사이의 최단 거리 구하는 공식이 필요
- 두 위 경도 좌표 사이의 거리를 haversine formula로 계산
- 지구가 완전한 구형이 아니 므로 아주 조금의 오차가 있다.
-
입력한 주소 정보에서 정해진 반경(10km) 내에 있는 약국만 추천 한다.
-
추출한 약국 데이터는 길안내 URL 및 로드뷰 URL로 제공 한다.
-
길안내 URL은 고객에게 제공 되기 때문에 가독성을 위해 shorten url로 제공 한다.
-
shorten url에 사용 되는 key값은 인코딩하여 제공 한다.
- ex) http://localhost:8080/dir/nqxtX
- base62를 통한 인코딩
-
shorten url의 유효 기간은 30일로 제한 한다.
-
- Spring Data JPA를 이용한 CRUD 메서드 구현하기
- Spock를 이용한 테스트 코드 작성하기
- Testcontainers를 이용하여 독립 테스트 환경 구축하기
- 카카오 주소검색 API 연동하여 주소를 위도, 경도로 변환하기
- 추천 결과를 카카오 지도 URL로 연동하여 제공하기
- 공공 데이터를 활용하여 개발하기 (약국 현황 데이터)
- Handlebars를 이용한 간단한 View 만들기
- 도커를 사용하여 다중 컨테이너 애플리케이션 만들기
- 애플리케이션을 클라우드 서비스에 배포하기
- Spring retry를 이용한 재처리 구현하기 (카카오 API의 네트워크 오류 등에 대한 재처리)
- base62를 이용한 shorten url 개발하기 (길안내 URL)
- redis를 이용하여 성능 최적화하기
- JDK 11
- Spring Boot 2.6.7
- Spring Data JPA
- Gradle
- Handlebars
- Lombok
- Github
- Docker
- AWS EC2
- Redis
- MariaDB
- Spock
- Testcontainers
