refactor(mindrecord): DTO 기본값·불필요 nullable 제거 — 누락 계약을 정상값으로 은폐하지 않는다

feature/mindrecord/data/src/main/kotlin/com/afternote/feature/mindrecord/data/dto/DailyQuestionDto.kt

@@ -12,16 +12,22 @@ data class DailyQuestionCreateRequestDto(
     @SerialName("content") val content: String,
     @SerialName("isDraft") val isDraft: Boolean,
     @SerialName("questionId") val questionId: Long,
-    @SerialName("imageUrl") val imageUrl: String? = null,
+    // 응답/요청 계약에 없는 필드라 타입은 nullable 로 두되 기본값은 두지 않는다.
+    // 매퍼가 항상 명시적으로 넘기므로 생략이 조용히 통과할 자리가 없다 (#789).
+    @SerialName("imageUrl") val imageUrl: String?,
 )
 
+/**
+ * `PATCH /daily-questions/{id}` 요청. 선택 필드라 nullable 은 유지하되 기본값은 두지 않는다 —
+ * 모든 생성 인자를 명시해야 "보내지 않음" 과 "명시적 null" 이 호출부 코드에서 구분된다 (#789).
+ */
 @Serializable
 data class DailyQuestionUpdateRequestDto(
-    @SerialName("content") val content: String? = null,
-    @SerialName("isDraft") val isDraft: Boolean? = null,
-    @SerialName("date") val date: String? = null,
-    @SerialName("questionId") val questionId: Long? = null,
-    @SerialName("imageUrl") val imageUrl: String? = null,
+    @SerialName("content") val content: String?,
+    @SerialName("isDraft") val isDraft: Boolean?,
+    @SerialName("date") val date: String?,
+    @SerialName("questionId") val questionId: Long?,
+    @SerialName("imageUrl") val imageUrl: String?,
 )
 
 @Serializable
@@ -35,12 +41,17 @@ data class DailyQuestionListItemDto(
     @SerialName("title") val title: String,
     @SerialName("content") val content: String,
     @SerialName("createdAt") val createdAt: String,
+    // Swagger `DailyQuestionListResponse` 응답 계약에 없는 필드 — 서버가 주기 시작하면 쓰이고,
+    // 아니면 계속 null. 계약에 없으므로 여기서만 기본값을 유지한다 (#789).
     @SerialName("imageUrl") val imageUrl: String? = null,
     // Swagger `DailyQuestionListResponse` 및 실서버 응답 모두 와이어 키는 `isDraft`.
     // 과거 QA logcat 에서 `draft` 로 관측된 적이 있어 대체 키도 함께 허용한다.
+    //
+    // 기본값 `false` 는 두지 않는다 — 서버가 항상 보내는 키라, 빠졌을 때 "임시저장 아님" 으로
+    // 접히면 임시저장 글이 목록에 그대로 노출된다. 계약 누락은 파싱 실패로 드러나야 한다 (#789).
     @SerialName("isDraft")
     @JsonNames("draft")
-    val isDraft: Boolean = false,
+    val isDraft: Boolean,
 )
 
 @Serializable
@@ -54,12 +65,15 @@ data class TodayDailyQuestionDto(
     @SerialName("day") val day: Int,
     @SerialName("content") val content: String,
     // Swagger `DailyQuestionTodayResponse` 및 실서버 응답 모두 `isAnswered`/`isDraft`.
-    // 종전 `answered`/`draft` 로 잡혀 있어 필수 필드 누락(MissingFieldException)으로
-    // getToday() 가 항상 실패했다 (#548). 과도기 대비로 구 키도 함께 받고 기본값을 둔다.
+    // 종전 DTO 가 `answered`/`draft` 로 잡혀 있어 필수 필드 누락(MissingFieldException)으로
+    // getToday() 가 항상 실패했다 (#548). 과도기 대비로 구 키는 계속 함께 받는다.
+    //
+    // 기본값은 두지 않는다 — 두 키 다 서버가 항상 보내므로, 기본값이 있으면 이번 같은 키
+    // 불일치가 다시 나도 "미답변·임시저장 아님" 인 정상 응답으로 조용히 통과한다 (#789).
     @SerialName("isAnswered")
     @JsonNames("answered")
-    val isAnswered: Boolean = false,
+    val isAnswered: Boolean,
     @SerialName("isDraft")
     @JsonNames("draft")
-    val isDraft: Boolean = false,
+    val isDraft: Boolean,
 )

feature/mindrecord/data/src/main/kotlin/com/afternote/feature/mindrecord/data/dto/DiaryDto.kt

@@ -25,8 +25,11 @@ data class DiaryCreateRequestDto(
     @SerialName("content") val content: String,
     @SerialName("isDraft") val isDraft: Boolean,
     @SerialName("todayMood") val todayMood: TodayMoodDto,
-    @SerialName("imageUrl") val imageUrl: String? = null,
-    @SerialName("receiverIds") val receiverIds: List<Long>? = null,
+    // 응답 계약에 없는 필드 — 타입만 nullable 로 두고 기본값은 두지 않는다 (#789).
+    @SerialName("imageUrl") val imageUrl: String?,
+    // 생성 API 에서 `null` 과 빈 목록은 모두 "수신자 없음" 으로 정규화되고, 작성 UI 는 항상
+    // 목록을 갖고 있다. 빈 목록을 그대로 보내면 되므로 nullable 로 낮추지 않는다 (#789).
+    @SerialName("receiverIds") val receiverIds: List<Long>,
 )
 
 @Serializable
@@ -36,23 +39,20 @@ data class DiaryUpdateRequestDto(
     @SerialName("isDraft") val isDraft: Boolean,
     @SerialName("todayMood") val todayMood: TodayMoodDto,
     @SerialName("date") val date: String,
-    @SerialName("imageUrl") val imageUrl: String? = null,
+    @SerialName("imageUrl") val imageUrl: String?,
 )
 
 /**
- * `/diary` 목록 항목 (Swagger `DiaryResponse` 실측, 2026-08-03).
+ * `/diary` 목록 항목 (Swagger `DiaryResponse`, 실서버 응답 실측 2026-08-23).
  *
- * 식별자를 뺀 나머지에 기본값을 두는 이유는 **실패의 폭**이다. 이 DTO 는 목록 원소라,
- * 필드 하나가 비어 `MissingFieldException` 이 나면 그 항목이 아니라 **그 달 목록 전체**가
- * 날아간다. 반면 값이 없을 때 잃는 것은 카드 한 장의 표시 요소뿐이다.
- *
- * `todayMood` 를 nullable 로 둔 것도 같은 맥락이다. non-null 이면 클라가 모르는 기분 값
- * 하나에 목록이 통째로 사라진다 (`coerceInputValues` 는 기본값이 있어야 동작한다).
- * 실제로 `emotion` 은 한글로 내려오는 중이다 (#591).
+ * 식별자를 뺀 나머지에도 기본값을 두지 않는다. 이 필드들은 서버가 항상 채워 보내는 값이라,
+ * 기본값이 있으면 응답 키 누락과 계약 변경이 파싱 실패가 아니라 **정상적인 빈 값**으로 바뀐다.
+ * 특히 `isDraft` 가 `false` 로 접히면 임시저장 일기가 목록에 노출되고, `date` 가 빈 문자열이
+ * 되면 캘린더에서 기록이 통째로 사라진다 (#789).
  *
  * (문서의 `required` 목록은 근거로 쓰지 않는다 — springdoc 은 `@Schema(requiredMode)` 가
  * 없으면 non-null 프로퍼티도 required 에 넣지 않아, 비어 있다는 사실이 서버가 그 필드를
- * 생략한다는 신호가 아니다. 응답 필드의 nullable 판단 기준 자체는 #676 소관.)
+ * 생략한다는 신호가 아니다. 판단은 실제 응답과 저장 컬럼 필수 여부를 기준으로 한다.)
  *
  * `id` 는 노션 명세("Diary 조회") 예시의 키다. Swagger 에는 없지만 두 문서가 갈려 있어
  * 대체 키로 함께 받는다 — 실제 응답에 `id` 가 없어 충돌하지 않는다.
@@ -62,30 +62,36 @@ data class DiaryListItemDto(
     @SerialName("diaryId")
     @JsonNames("id")
     val diaryId: Long,
-    @SerialName("title") val title: String = "",
-    @SerialName("content") val content: String = "",
+    @SerialName("title") val title: String,
+    @SerialName("content") val content: String,
     /**
      * 사용자가 고른 **일기의 날짜** (`format: date`, 예 `"2026-03-21"`).
      *
      * [createdAt] 과 **별개 필드**다 — 작성 화면의 날짜 선택 값이 여기 들어가고,
      * `createdAt` 은 레코드가 만들어진 시각이다. 캘린더에 찍어야 하는 쪽은 이 값이다.
      * 둘을 `@JsonNames` 로 한 프로퍼티에 묶으면 서버의 키 순서에 따라 값이 뒤바뀐다.
      */
-    @SerialName("date") val date: String? = null,
-    @SerialName("createdAt") val createdAt: String = "",
+    @SerialName("date") val date: String,
+    @SerialName("createdAt") val createdAt: String,
     // Swagger `DiaryResponse` 에 없는 필드 — 서버가 주기 시작하면 쓰이고, 아니면 계속 null.
     @SerialName("imageUrl") val imageUrl: String? = null,
-    @SerialName("todayMood") val todayMood: TodayMoodDto? = null,
+    // 저장 컬럼이 필수라 응답도 항상 채워진다. AI 가 매기는 `emotion` 과 달리 사용자가 직접
+    // 고른 값이고, 한글 값이 관측된 쪽도 `emotion` 이지 이 필드가 아니다 (#591, #789).
+    @SerialName("todayMood") val todayMood: TodayMoodDto,
     @SerialName("isDraft")
     @JsonNames("draft")
-    val isDraft: Boolean = false,
+    val isDraft: Boolean,
 )
 
 // `/diary` 응답의 `data` 는 객체 — `diaries` 외에 조회 대상 달의 비-임시 다이어리 수
 // (`monthDiaryCount`)와 최근 7일 최빈 기분(`weeklyDominantMood`)이 함께 내려옴.
 @Serializable
 data class DiaryListDto(
-    @SerialName("diaries") val diaries: List<DiaryListItemDto> = emptyList(),
-    @SerialName("monthDiaryCount") val monthDiaryCount: Int = 0,
-    @SerialName("weeklyDominantMood") val weeklyDominantMood: TodayMoodDto? = null,
+    @SerialName("diaries") val diaries: List<DiaryListItemDto>,
+    @SerialName("monthDiaryCount") val monthDiaryCount: Int,
+    // 그 주에 기록이 없으면 서버가 `null` 을 **명시적으로** 보낸다. 값이 없다는 뜻이 실제로
+    // 있으므로 nullable 은 유지하되, 키 자체는 계약이라 기본값은 두지 않는다 (#789).
+    @SerialName("weeklyDominantMood")
+    @Serializable(with = NullableTodayMoodSerializer::class)
+    val weeklyDominantMood: TodayMoodDto?,
 )

feature/mindrecord/data/src/main/kotlin/com/afternote/feature/mindrecord/data/dto/MindRecordDto.kt

@@ -6,7 +6,7 @@ import kotlinx.serialization.Serializable
 /** `GET /receiver-auth/daily-question` 응답 (`data`). */
 @Serializable
 data class ReceiverDailyQuestionListDto(
-    @SerialName("dailyQuestions") val dailyQuestions: List<ReceiverDailyQuestionItemDto> = emptyList(),
+    @SerialName("dailyQuestions") val dailyQuestions: List<ReceiverDailyQuestionItemDto>,
 )
 
 @Serializable
@@ -17,26 +17,32 @@ data class ReceiverDailyQuestionItemDto(
     @SerialName("content") val content: String,
     // "yyyy.MM.dd 요일" 형식.
     @SerialName("createdAt") val createdAt: String,
+    // Swagger `DailyQuestionListResponse` 계약에 없는 필드 — 기본값을 유지한다 (#789).
     @SerialName("imageUrl") val imageUrl: String? = null,
 )
 
 /** `GET /receiver-auth/diary` 응답 (`data`). */
 @Serializable
 data class ReceiverDiaryListDto(
-    @SerialName("diaries") val diaries: List<ReceiverDiaryItemDto> = emptyList(),
+    @SerialName("diaries") val diaries: List<ReceiverDiaryItemDto>,
 )
 
+/**
+ * 수신자용 일기 항목. 발신자 목록과 **같은 `DiaryResponse` 계약**을 쓰므로
+ * nullability 와 기본값도 [DiaryListItemDto] 와 동일하게 맞춘다 (#789).
+ */
 @Serializable
 data class ReceiverDiaryItemDto(
     @SerialName("diaryId") val diaryId: Long,
     @SerialName("title") val title: String,
     @SerialName("content") val content: String,
-    @SerialName("isDraft") val isDraft: Boolean = false,
+    @SerialName("isDraft") val isDraft: Boolean,
+    // 응답 계약에 없는 필드 — 기본값을 유지한다.
     @SerialName("imageUrl") val imageUrl: String? = null,
-    @SerialName("todayMood") val todayMood: TodayMoodDto? = null,
+    @SerialName("todayMood") val todayMood: TodayMoodDto,
     // 작성일 (yyyy-MM-dd).
-    @SerialName("date") val date: String = "",
+    @SerialName("date") val date: String,
     // "yyyy.MM.dd 요일" 형식.
-    @SerialName("createdAt") val createdAt: String = "",
-    @SerialName("updatedAt") val updatedAt: String = "",
+    @SerialName("createdAt") val createdAt: String,
+    @SerialName("updatedAt") val updatedAt: String,
 )

feature/mindrecord/data/src/main/kotlin/com/afternote/feature/mindrecord/data/dto/NullableTodayMoodSerializer.kt

@@ -0,0 +1,42 @@
+package com.afternote.feature.mindrecord.data.dto
+
+import kotlinx.serialization.KSerializer
+import kotlinx.serialization.descriptors.PrimitiveKind
+import kotlinx.serialization.descriptors.PrimitiveSerialDescriptor
+import kotlinx.serialization.descriptors.SerialDescriptor
+import kotlinx.serialization.descriptors.nullable
+import kotlinx.serialization.encoding.Decoder
+import kotlinx.serialization.encoding.Encoder
+
+/**
+ * 값 자체가 조건부인 **nullable 기분 필드** 전용 직렬화기.
+ *
+ * `coerceInputValues` 는 생성자 기본값이 있어야 동작한다. #789 로 기본값을 걷어내면서
+ * 이 필드들도 함께 엄격해졌는데, 그 결과 "키 누락" 뿐 아니라 "클라가 모르는 **값**" 까지
+ * 파싱 실패가 됐다. 두 상황은 성격이 다르다.
+ *
+ * - 키 누락 → 계약이 바뀐 것. 실패해야 드러난다.
+ * - 모르는 값 → 서버가 기분 종류를 늘렸거나 표기가 바뀐 것. 그 주/그 달 목록 전체를
+ *   날릴 일이 아니라 이모지 한 칸만 비우면 된다 (#591 에서 감정 값이 한글로 관측된 전례).
+ *
+ * 그래서 키의 존재는 계약으로 두고(`= null` 기본값 없음), 값만 관대하게 접는다.
+ */
+object NullableTodayMoodSerializer : KSerializer<TodayMoodDto?> {
+    override val descriptor: SerialDescriptor =
+        PrimitiveSerialDescriptor("com.afternote.mindrecord.NullableTodayMood", PrimitiveKind.STRING).nullable
+
+    override fun deserialize(decoder: Decoder): TodayMoodDto? {
+        if (!decoder.decodeNotNullMark()) {
+            return decoder.decodeNull()
+        }
+        val raw = decoder.decodeString()
+        return TodayMoodDto.entries.firstOrNull { it.name == raw }
+    }
+
+    override fun serialize(
+        encoder: Encoder,
+        value: TodayMoodDto?,
+    ) {
+        if (value == null) encoder.encodeNull() else encoder.encodeString(value.name)
+    }
+}

feature/mindrecord/data/src/main/kotlin/com/afternote/feature/mindrecord/data/dto/WeeklyReportDto.kt

@@ -3,15 +3,19 @@ package com.afternote.feature.mindrecord.data.dto
 import kotlinx.serialization.SerialName
 import kotlinx.serialization.Serializable
 
+/**
+ * `GET /mind-record` 응답 (`data`). 카운트·요약·목록 어느 것도 기본값을 두지 않는다 —
+ * 수치가 `0` 으로, 목록이 빈 목록으로 접히면 잘못된 주간 리포트가 정상 화면으로 보인다 (#789).
+ */
 @Serializable
 data class WeeklyReportDto(
-    @SerialName("dailyQuestionAmount") val dailyQuestionAmount: Int = 0,
-    @SerialName("diaryAmount") val diaryAmount: Int = 0,
-    @SerialName("summaryText") val summaryText: String = "",
-    @SerialName("week") val week: List<WeeklyReportDayDto> = emptyList(),
+    @SerialName("dailyQuestionAmount") val dailyQuestionAmount: Int,
+    @SerialName("diaryAmount") val diaryAmount: Int,
+    @SerialName("summaryText") val summaryText: String,
+    @SerialName("week") val week: List<WeeklyReportDayDto>,
     // 서버 JSON 키가 kebab-case (`daily-question`).
-    @SerialName("daily-question") val dailyQuestions: List<WeeklyReportDailyQuestionDto> = emptyList(),
-    @SerialName("emotions") val emotions: List<WeeklyReportEmotionDto> = emptyList(),
+    @SerialName("daily-question") val dailyQuestions: List<WeeklyReportDailyQuestionDto>,
+    @SerialName("emotions") val emotions: List<WeeklyReportEmotionDto>,
 )
 
 /**
@@ -25,28 +29,31 @@ data class WeeklyReportDto(
  * 종전 DTO 는 존재하지 않는 `isDiary` 키를 읽어 항상 기본값 `false` 가 됐고, 그래서 모든
  * 일기가 non-diary 로 접혀 캘린더 점과 기록일수에서 빠졌다.
  *
- * 세 필드는 명세가 required 로 선언한 값이라 기본값을 두지 않는다 — 빠지면 실패해야
- * 계약 누락이 드러난다. 다만 [type] 은 `enum` 대신 `String` 으로 받는다. 서버가 종류를
- * 하나 더 추가해도(현재 3종) 그 주 전체가 죽지 않고 매퍼에서 "일기 아님" 으로 접히면
- * 되기 때문이다 — 값 집합은 닫혀 있지 않지만 키의 존재는 계약이다.
+ * 네 필드 모두 기본값을 두지 않는다 — 빠지면 실패해야 계약 누락이 드러난다. [emotion] 은
+ * 값 자체가 조건부라 nullable 은 유지하지만, 서버가 키는 명시적으로 보내므로 기본값은
+ * 없다 (#789). 다만 [type] 은 `enum` 대신 `String` 으로 받는다. 서버가 종류를 하나 더
+ * 추가해도(현재 3종) 그 주 전체가 죽지 않고 매퍼에서 "일기 아님" 으로 접히면 되기
+ * 때문이다 — 값 집합은 닫혀 있지 않지만 키의 존재는 계약이다.
  */
 @Serializable
 data class WeeklyReportDayDto(
     @SerialName("diaryId") val diaryId: Long,
     @SerialName("day") val day: Int,
     @SerialName("type") val type: String,
-    @SerialName("emotion") val emotion: TodayMoodDto? = null,
+    @SerialName("emotion")
+    @Serializable(with = NullableTodayMoodSerializer::class)
+    val emotion: TodayMoodDto?,
 )
 
 @Serializable
 data class WeeklyReportDailyQuestionDto(
-    @SerialName("title") val title: String = "",
-    @SerialName("content") val content: String = "",
-    @SerialName("date") val date: String = "",
+    @SerialName("title") val title: String,
+    @SerialName("content") val content: String,
+    @SerialName("date") val date: String,
 )
 
 @Serializable
 data class WeeklyReportEmotionDto(
-    @SerialName("keyword") val keyword: String = "",
-    @SerialName("percentage") val percentage: Int = 0,
+    @SerialName("keyword") val keyword: String,
+    @SerialName("percentage") val percentage: Int,
 )

feature/mindrecord/data/src/main/kotlin/com/afternote/feature/mindrecord/data/mapper/DiaryMapper.kt

@@ -18,7 +18,7 @@ fun DiaryListItemDto.toDomain(): Diary =
         content = content,
         date = date,
         createdAt = createdAt,
-        todayMood = todayMood?.toDomain(),
+        todayMood = todayMood.toDomain(),
         imageUrl = imageUrl,
         isDraft = isDraft,
     )