fix: 관계의 묶음 이름과 작성자가 쓴 문장을 갈라 놓는다

관계 한 줄에 세 가지가 뭉쳐 있었다. 대상이 어떤 종류인지, 작성자가 왜 걸었는지,
대상이 무엇인지 — 셋 다 `reason` 한 칸을 지나느라 경로마다 다른 것이 같은 자리에
나왔다. 렌더 모델 경로에서는 작성자의 문장이 묶음 이름 자리에 눌려 한 줄짜리 라벨인
척했고, 공개 조회 경로에서는 묶음 이름이 그 자리를 차지하고 작성자의 문장은 아예
버려졌다. 「다음에 무엇을 읽을지」의 답이 그 문장인데 공개 화면에 한 번도 나오지 않았다.

이제 셋이 각자의 칸을 갖는다. `label` 은 대상의 종류, `note` 는 작성자가 쓴 문장,
`summary` 는 대상의 요약이다. 설명 자리에는 문장이 있으면 문장을, 없으면 요약을
보인다 — 요약은 대상을 설명하고 문장은 왜 지금 이것을 읽어야 하는지를 설명한다.

공개 주소로 종류를 되짚던 삼항 사슬도 표로 바꾼다. `/concepts/` 가 어디에도 없어서
개념으로 가는 관계가 전부 `PROJECT` 로 떨어지고 있었다 — 손으로 나열한 목록에 새
종류를 빠뜨리는 일이 이 저장소에서만 다섯 번째다.

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 16:48:11 +09:00
co-authored by Claude Opus 5
parent af5a6bbf23
commit 618a228eff
22 changed files with 698 additions and 76 deletions
@@ -16,7 +16,6 @@ describe("TechLog navigation derivation", () => {
).toEqual([
["탐색", "/explore"],
["프로젝트", "/projects"],
["변경 기록", "/releases"],
["프로필", "/profile"],
]);
});
@@ -113,7 +113,7 @@ function caseModel(
targetKind: "REFERENCE",
title: "연결된 기준",
publicPath: "/references/linked",
reason: "판단 기준",
reason: "이 기록의 결론이 그대로 이 기준이 되었다.",
order: 1,
},
],
@@ -380,11 +380,17 @@ describe("shared Public record renderer", () => {
expect(screen.getByText("목차 · 강조 강함 코드")).toBeVisible();
expect(screen.getByRole("link", { name: "강조 강함 코드 바로가기" })).toBeVisible();
/*
관계 항목이 제목만 있던 시절에는 라벨과 제목이 붙어 한 이름이었다. 지금은 제목과 요약을
관계 항목이 제목만 있던 시절에는 라벨과 제목이 붙어 한 이름이었다. 지금은 제목과 설명을
묶는 상자가 하나 더 있어 그 사이에 공백이 생긴다 — 이름의 구성은 그대로다.
묶음 이름은 대상의 종류에서 온다. 예전에는 작성자가 쓴 문장이 이 자리에 눌려 들어가
한 줄짜리 라벨인 척했고, 그래서 문장은 문장대로 잘려 보이고 종류는 어디에도 없었다.
*/
const relation = screen.getByRole("link", { name: /판단 기준\s*연결된 기준/ });
const relation = screen.getByRole("link", { name: /적용 기준\s*연결된 기준/ });
expect(relation).toHaveAttribute("href", "/references/linked");
// 작성자가 남긴 문장은 이름이 아니라 설명 자리에 온다.
expect(relation).not.toHaveAccessibleName(/그대로 이 기준이/);
expect(relation.querySelector("p")).toHaveTextContent("그대로 이 기준이 되었다");
expect(relation.parentElement?.parentElement?.previousElementSibling).toHaveTextContent(
"이 기록의 연결",
);
@@ -103,7 +103,6 @@ describe("TechLog Public shell", () => {
const expectedNavigation = [
["탐색", "/explore"],
["프로젝트", "/projects"],
["변경 기록", "/releases"],
["프로필", "/profile"],
];
expect(
@@ -147,7 +147,6 @@ describe("TechLog route boundary contract", () => {
).toEqual([
["TECH_LOG_EXPLORE", "PUBLIC", "탐색", 10],
["TECH_LOG_PROJECTS", "PUBLIC", "프로젝트", 20],
["TECH_LOG_RELEASES", "PUBLIC", "변경 기록", 30],
["TECH_LOG_PROFILE", "PUBLIC", "프로필", 40],
["TECH_LOG_STUDIO_DOCUMENTS", "STUDIO", "작업본", 10],
["TECH_LOG_STUDIO_DOCUMENT_NEW", "STUDIO", "새 문서", 30],