fix: 종류 이름을 화면마다 하나로 맞추고, 읽는 순서를 기록에서 만든다

홈 한 화면에 종류 이름이 아홉 개 떠 있었다. 최근 기록 목록은 `CASE`·`CONCEPT`·`OPEN
QUESTION`·`REFERENCE` 로, 바로 아래 「종류별로 읽기」는 「검증 기록」·「동작 원리」·
「적용 기준」·「열린 질문」으로 같은 넷을 불렀다. 독자는 둘이 같은 것이라는 단서를 어디서도
받지 못했다 — 이름을 바꾸기 전보다 나빠진 유일한 자리다. 목록도 공용 표에서 가져온다.

주제 허브의 「먼저 읽을 것」은 넷 다 열린 질문이었다. 서버가 주는 대표 값은 순서가 아니라
통 두 개(대표 Case · 열린 질문)이고 앞쪽이 비어 있어서, 아직 답이 없는 질문만 모아 놓고
「먼저 읽을 것」이라 부르고 있었다. 그리고 그 넷이 바로 아래 목록에 그대로 다시 나왔다.
이제 기록에서 순서를 만든다 — 원리 → 확인한 기록 → 기준 → 아직 모르는 것 — 그리고 위에
오른 편은 아래에서 뺀다.

개념은 목록 매퍼에서 통째로 버려지고 있었다. 서버는 보내고 필터에는 「동작 원리」가 있는데
결과가 0건이라, 독자에게는 기록이 없는 것으로 보였다. 손으로 나열한 종류 목록에 개념을
빠뜨리는 일이 이 저장소에서 반복됐고, 이번에는 계약에서 종류를 읽어 대조하는 가드를 둔다.

그 밖에: 질문 줄의 맥락이 「· 프로젝트」로 시작하던 것(계약에 주제가 없었다), 릴리스가
주 내비에서만 빠지고 홈 목록에는 남아 있던 것, 홈 목록이 화면의 절반을 차지하던 것,
값이 없는 「현재 목표」·「다음 작업」이 빈 칸으로 남던 것, 종류 배지 넷이 시각적으로 같던 것.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011nAjrqNHGPNngN4aUbcyvJ
This commit is contained in:
DongHyeonka
2026-09-01 18:36:52 +09:00
co-authored by Claude Opus 5
parent 88d841dc96
commit dc2fda7a5d
14 changed files with 301 additions and 75 deletions
@@ -221,11 +221,26 @@ export function baseOf(
* for free; it is a real extra request now, and the alternative — widening the
* list response — would send every body to render a title.
*/
/**
* 지식 목록이 싣는 종류. 계약의 `KnowledgeListItem.type` 과 같은 집합이어야 한다.
*
* <p>여기가 삼항이던 동안 개념은 어디에도 없어 `null` 로 버려졌다. 서버는 개념을 보내고 탐색
* 필터에는 「동작 원리」가 있는데 결과는 0건이었다 — 독자에게는 기록이 없는 것으로 보였다.
* 손으로 나열한 목록에 개념을 빠뜨리는 일이 이 저장소에서 반복됐고, 이 자리가 마지막이다.
*/
const KNOWLEDGE_LIST_KINDS: Record<string, PublicRecord["kind"]> = {
CASE: "CASE",
CONCEPT: "CONCEPT",
REFERENCE: "REFERENCE",
};
export function knowledgeListItemToRecord(item: Readonly<Record<string, unknown>>): PublicRecord | null {
const type = String(item.type ?? "");
const kind = KNOWLEDGE_LIST_KINDS[type];
if (!kind) return null;
const path = String(item.path ?? "");
const slug = path.split("/").filter(Boolean).pop() ?? "";
const base = baseOf(type === "REFERENCE" ? "REFERENCE" : "CASE", slug, {
const base = baseOf(kind, slug, {
title: item.title as string,
summary: (item.primarySummary as string) ?? "",
path,
@@ -248,6 +263,17 @@ export function knowledgeListItemToRecord(item: Readonly<Record<string, unknown>
sections: Object.freeze([]),
}) as CaseRecord;
}
if (type === "CONCEPT") {
return Object.freeze({
...base,
kind: "CONCEPT",
basisVersion: "",
// 목록 항목은 본문을 담지 않는다 — 본문은 상세 조회에서만 온다.
content: "",
bodyAssets: Object.freeze([]),
sections: Object.freeze([]),
}) as ConceptRecord;
}
if (type === "REFERENCE") {
return Object.freeze({
...base,
@@ -322,6 +348,8 @@ export function questionListItemToRecord(item: Readonly<Record<string, unknown>>
summary: (item.summary as string) ?? "",
path,
primaryProject: item.primaryProject as Summary,
// 계약이 이제 질문 목록에도 주제를 준다. 없던 동안 목록의 질문 줄만 「· 프로젝트」로 시작했다.
primaryTopic: item.primaryTopic as Summary,
publishedAt: item.updatedAt as string,
}),
kind: "QUESTION",