chore: 공휴일 API 관련 주석 추가

Author: HI-JIN2

app/src/main/java/com/eatssu/android/data/remote/dto/response/PublicHolidayApiResponse.kt

@@ -40,6 +40,10 @@ data class PublicHolidayApiResponse(
     )
 
     @OptIn(ExperimentalSerializationApi::class)
+    /**
+     * 공휴일 API는 item이 1개일 때는 Object, 여러 개일 때는 Array로 내려주는 케이스가 있어
+     * 역직렬화 시 항상 List 형태로 정규화한다.
+     */
     object PublicHolidayItemListSerializer : JsonTransformingSerializer<List<Item>>(
         ListSerializer(Item.serializer())
     ) {

app/src/main/java/com/eatssu/android/data/remote/repository/PublicHolidayRepositoryImpl.kt

@@ -23,6 +23,14 @@ class PublicHolidayRepositoryImpl @Inject constructor(
         const val PUBLIC_HOLIDAY_SERVICE_KEY_NAME: String = "PublicHolidayServiceKey"
     }
 
+    /**
+     * 외부 공휴일 API를 호출해 해당 [YearMonth]의 공휴일 목록을 조회한다.
+     *
+     *
+     * - `HOLIDAY_API_KEY`가 비어있으면 네트워크 호출 없이 빈 리스트를 반환한다.
+     * - 네트워크/파싱 실패 또는 비정상 resultCode인 경우 빈 리스트를 반환한다.
+     * - `isHoliday == "Y"`만 필터링하고, 날짜 기준으로 중복 제거 후 오름차순 정렬한다.
+     */
     override suspend fun getHolidays(yearMonth: YearMonth): List<PublicHoliday> {
         if (serviceKey.isBlank()) {
             Timber.w("HOLIDAY_API_KEY is blank; skipping public holiday fetch")

app/src/main/java/com/eatssu/android/data/remote/service/PublicHolidayService.kt

@@ -6,6 +6,15 @@ import retrofit2.http.Query
 
 interface PublicHolidayService {
 
+    /**
+     * data.go.kr 공휴일(OpenAPI) 호출용 API.
+     *
+     * - 엔드포인트: SpcdeInfoService/getRestDeInfo
+     * - ServiceKey는 이미 URL 인코딩된 값으로 전달한다(`encoded = true`).
+     * - solYear/solMonth는 양력 기준 연/월이다.
+     * - `_type=json`으로 JSON 응답을 받는다.
+     */
+
     @GET("B090041/openapi/service/SpcdeInfoService/getRestDeInfo")
     suspend fun getRestDeInfo(
         @Query(value = "ServiceKey", encoded = true) serviceKey: String,

app/src/main/java/com/eatssu/android/di/PublicHolidayModule.kt

@@ -18,8 +18,15 @@ import javax.inject.Singleton
 
 @Qualifier
 @Retention(AnnotationRetention.BINARY)
+/** 공휴일 API 전용 Retrofit 구분자. */
 annotation class PublicHolidayApi
 
+/**
+ * 공휴일 API 전용 Retrofit/Service 제공 모듈.
+ *
+ * - 인증 토큰이 필요 없는 외부 API이므로 `@NoToken` OkHttpClient를 사용한다.
+ * - 키는 `BuildConfig.HOLIDAY_API_KEY`로 주입되며, 비어있을 수 있다(로컬 환경 등).
+ */
 @Module
 @InstallIn(SingletonComponent::class)
 object PublicHolidayModule {