1. 기능 개요

• 날씨 데이터 관리 기능은 사용자의 위치 정보를 기반으로 기상청 단기예보(OpenAPI)를 호출하여 날씨 데이터를 수집·저장·제공하는 기능입니다.
• 온디맨드 조회와 주기적 배치 작업을 통해 데이터를 관리하며, 날씨 변화 감지 시 알림 기능과 연계됩니다.
• 날씨 데이터는 의상 추천, OOTD 피드 등록, 알림 등 서비스의 핵심 기능과 직접적으로 연결됩니다.

주요 역할

1. 위치 기반 좌표 변환
   • 위경도 데이터를 기상청 예보용 좌표(X, Y)로 변환 (GridCoordConverter)
   • 카카오 로컬 API를 통해 행정구역명(locationNames)을 조회하여 사용자의 실제 위치 정보 제공
2. 날씨 데이터 수집
   • 온디맨드 조회: 사용자가 특정 위치에서 날씨를 요청하면, DB에 데이터가 없을 경우 기상청 API를 호출하여 실시간 데이터를 조회
   • 배치 수집: Spring Batch를 활용하여 주기적으로 사용자 프로필 위치 기반의 데이터를 수집·저장
3. 데이터 처리 및 가공
   • 기상청 API의 원시 응답(FcstItem)을 예보 시간 단위(fcstDate + fcstTime)로 그룹화
   • WeatherForecast 및 하위 엔티티(온도, 습도, 강수, 풍속 등)로 변환하여 영속화
   • 전일 대비 변화량(기온, 습도)을 계산하여 DTO에 반영
4. 데이터 제공
   • /api/weathers/location: 위경도 기반 위치 정보 변환 API
   • /api/weathers: 위치 기반 날씨 조회 API
   • 응답 데이터는 WeatherDto 및 WeatherSummaryDto 형태로 제공
5. 날씨 변화 감지 및 알림 연동
   • 배치 수집 데이터와 비교하여 급격한 기온 변화 등을 감지
   • 변화 감지 시 NotificationService를 통해 사용자에게 SSE 기반 알림을 전송

2. API 목록

3. 기능별 상세 설계

📌 3.1 엔티티 및 저장 구조

• WeatherLocation
  • 위도, 경도, 기상청 격자 좌표(X, Y), 행정구역명(locationNames)을 가짐
  • @OneToMany(mappedBy = "location")로 여러 WeatherForecast를 가질 수 있음
• WeatherForecast
  • 중심 엔티티. 예보 발표 시각(forecastedAt), 실제 예보 시각(forecastAt), 하늘 상태(SkyStatus) 등을 포함
  • @ManyToOne으로 WeatherLocation에 속함
  • 하위 세부 엔티티(WeatherTemperature, WeatherHumidity, WeatherPrecipitation, WeatherWindSpeed)와 1:1 관계
  • 유니크 제약조건: (weather_location_id, forecast_at, forecasted_at)
• WeatherTemperature / WeatherHumidity / WeatherPrecipitation / WeatherWindSpeed
  • 모두 WeatherForecast와 공유 PK(@MapsId) 구조
  • Forecast가 생성되면 함께 저장되고, Forecast 삭제 시 같이 제거됨(CascadeType.ALL)
  • 각 엔티티는 해당 속성(기온, 습도, 강수, 풍속)을 세부적으로 저장
  • 강수 형태(PrecipitationType)와 풍속 강도(WindStrength)는 Enum으로 관리
• 설계 특징
  • 위치(Location) 1 : N 예보(Forecast) : 1 세부 속성들 구조
  • 예보는 WeatherForecast를 중심으로 하고, 각 속성은 공유 PK로 Forecast에 종속
  • 이렇게 함으로써 데이터 무결성을 보장하고, 한 예보 단위가 필요한 모든 속성을 명확히 묶어 관리할 수 있음

📌 3.2 DTO / Mapper 설계

📡 (1) DTO 설계

• WeatherDto
  • 예보 상세 API 응답용
  • 필드: id, forecastedAt, forecastAt, location, skyStatus, precipitation, humidity, temperature, windSpeed
• WeatherSummaryDto
  • 피드/추천 등에서 간단한 요약 정보 제공용
  • 필드: weatherId, skyStatus, precipitation, temperature