@ihabdevteam/core 0.257.0 → 0.258.0

package/CHANGELOG.md

@@ -7,6 +7,41 @@ All notable changes to this project will be documented in this file.
 > 적은 글이라, 지금 이름으로 고쳐 놓으면 그 시절에 그 이름으로 받은 사람이
 > 제 이야기를 못 찾는다.
 
+## 0.258.0
+
+### 문항마다 **언제 보였고 언제 답했나** — `TrainingItemResult` (말귀 요청 (68))
+
+반응 시간을 잴 길이 없었다. 앱은 판이 끝날 때 문항을 한꺼번에 적으므로 행의 `answered_at` 은
+**"적은 때"** 다 — 말귀 실측(19행): 한 판 안 두 문항의 차가 중앙값 **0.049초**, 최대 0.216초.
+**푼 간격이 아니라 줄을 쓴 간격**이다. 정답률이 같아도 빨라지면 듣는 노력이 줄었다는 근거가
+되는데, 그 근거를 만들 수가 없었다.
+
+```ts
+shownAt: string | null      // 보이거나 들리기 시작한 때(ISO 8601). 소리 문항이면 재생 시작
+answeredAt: string | null   // 답을 고른(확정한) 때. 안 골랐으면 null
+```
+
+**코어가 할 일은 "버리지 않는 것" 이었다.** 문항 배열은 앱의 `buildResults` 가 짓고
+`TrainingPagePopup` 이 그걸 `toItemResults` 에 넘기는데, **`toItemResults` 는 제가 아는 칸만
+베껴 쓴다.** 그래서 화면이 때를 찍어 넣어도 여기서 **조용히 떨어졌다.** 찍는 것은 화면의
+몫이다 — 한 쪽이 곧 한 문항도 아니라(쪽 하나에 문항이 여럿 설 수 있다) 코어가 대신 못 찍는다.
+
+**글자로 온 때는 고쳐 쓰지 않는다.** `new Date(s).toISOString()` 로 다시 쓰면 `+09:00` 이 `Z` 로
+바뀌어 **앱이 가리킨 시계가 무엇이었는지 지워진다.** 이 저장소는 날짜를 KST 하나로 읽기로 해
+두었고(`utils/date.ts` 머리글) 그 판단은 "어느 날인가" 를 지키려는 것이다 — 읽히는지만 보고
+그대로 둔다. `Date`·숫자(epoch)로 오면 그때는 쓸 글자가 없으니 ISO 로 짓는다.
+
+칸 이름은 **camelCase 와 snake_case 둘 다** 본다(`shown_at`) — 화면이 서버 꼴을 그대로 들고
+있는 자리가 있다. **이름이 하나라고 믿었다가 조용히 떨어뜨리는 것**이 이 청의 뿌리다.
+
+> 못 읽는 값(빈 글자·`어제`·`NaN`·객체)은 `null` 이다 — **없는 때를 지어내지 않는다.**
+> 깨진 때가 섞이면 반응 시간 셈이 통째로 거짓이 된다.
+>
+> **지금 쓰는 화면은 기록이 전과 똑같다** — 안 찍으면 두 칸이 `null` 이고 나머지는 그대로다.
+>
+> 꼴 전체를 빠짐없이 적던 시험(`toEqual`)이 함께 울었다 — 그대로 둔다. 기록은 치료 자료라
+> **무엇이 남는지가 분명해야 하고**, 칸이 조용히 느는 것을 거기서 잡는다.
+
 ## 0.257.0
 
 > **이 판은 그 사이 main 에 쌓인 "미배포" 와 PR #10 도 함께 싣는다** — 아래 ★ 두 꼭지와