@ihabdevteam/core 0.258.0 → 0.259.0

package/CHANGELOG.md

@@ -7,6 +7,39 @@ All notable changes to this project will be documented in this file.
 > 적은 글이라, 지금 이름으로 고쳐 놓으면 그 시절에 그 이름으로 받은 사람이
 > 제 이야기를 못 찾는다.
 
+## 0.259.0
+
+### 스텝 payload 에 **때 둘을 얹는다** — `withStepTimes` (말귀 요청 (68) 후속)
+
+0.258.0 으로 `TrainingItemResult` 에 두 칸을 열었더니 **앱이 직접 찍을 길이 없었다.** 앱의
+`buildResults` 는 판이 끝난 뒤 `answersByPage` 를 한 번 받을 뿐이고, 답은 **코어 스텝이** 쓴다.
+답·쪽 바뀜 콜백이 props 에 없고 `registerOnNext` 는 '다음' 누른 때라 **답한 때가 아니다**.
+쪽 마운트로 `shownAt` 은 흉내 낼 수 있어도 `answeredAt` 은 지어낸 때가 된다.
+
+이제 코어가 **스텝의 때**를 얹는다. 쪽↔문항 대응은 그대로 앱의 `buildResults` 가 한다 —
+**스텝의 때는 그 스텝의 사실**이라, (68) 때 안 하기로 한 *"쪽 때를 문항 때라 적는"* 거짓이
+안 생긴다(그건 "쪽을 넘긴 간격" 이 됐을 것이다).
+
+- **`answeredAt` 은 payload 의 `__ts`** — 스텝이 고른 **바로 그 순간**이다. 저장이 끝난 뒤 다시
+  재면 답이 state 에 앉는 데 걸린 시간이 섞인다. 말귀가 잰 0.049초가 그런 값이었다.
+- **`shownAt` 은 스텝이 설 때 미리 적어 둔 것** — 답이 놓이는 순간에는 이미 사람이 다 고른
+  뒤라 보인 때를 모른다. `쪽\0스텝` 하나당 한 번만 적고 **다시 와도 안 고친다**(다시 듣기
+  노력이 반응 시간에 들어가는 쪽이 실제에 가깝다). `0 ~ 지금` 을 다 적는다 — 한 쪽에 스텝이
+  여럿 서는 꼴(듣기 → 고르기)에서 앞 스텝의 때가 영영 비지 않게.
+- **이미 들어 있는 때는 안 덮는다.** 스텝이 제 때를 찍어 보냈으면 그쪽이 더 정확하다.
+  글자로 온 것은 꼴도 안 고친다(`+09:00` 이 `Z` 로 바뀌면 어느 시계였는지 지워진다).
+- **객체가 아닌 payload 는 그대로 둔다** — 없던 칸을 지어 붙이지 않는다.
+
+얹는 자리는 **한 길목**이다(`setScenarioAnswer`) — 네 손잡이(시나리오·아이 × 바뀜·끝남)가
+모두 그리로 지나므로 화면마다 따로 찍을 까닭이 없다.
+
+> **셈을 조각 밖으로 뺐다**(`withStepTimes`, 공개). 조각 안에 두면 *"소스에 그 글자가 있나"*
+> 로밖에 못 묻는데 **그런 시험은 셈이 틀려도 초록이다** — 오늘 여러 번 밟은 자리라, 처음에
+> 쓴 소스 검사 시험을 버리고 실제 값으로 재는 쪽으로 다시 썼다.
+>
+> 코어가 **짓는** 때는 `Z` 다. epoch 하나라 지킬 지역 시계가 없다 — 앱이 *글자로* 보낸 때를
+> 안 고치는 것(`utils/trainingItemResults` 의 `때`)과는 다른 자리다.
+
 ## 0.258.0
 
 ### 문항마다 **언제 보였고 언제 답했나** — `TrainingItemResult` (말귀 요청 (68))