fix: 관계 요약이 화면까지 닿게 한다

라벨은 고쳤는데 요약이 여전히 비어 있었다. 값이 경계 세 곳을 지나며 사라진다:
평탄화가 담고(고침), 렌더 모델로 바꿀 때 버리고, 화면 목록으로 넘길 때 또
버렸다. 렌더 모델 계약(ResolvedRelation)에 담을 자리 자체가 없었고
additionalProperties: false 라 실을 수도 없었다.

계약에 summary 를 더하고(required 아님 — 이미 나가 있는 응답을 깨지 않는다)
세 경계를 모두 잇는다. Studio 미리보기도 같은 렌더 모델을 쓰므로 그쪽에서도
같은 요약이 보인다.

가드는 요약이 화면에 그려지는 것과, 그것이 링크 이름에는 들어가지 않는 것을
함께 본다 — 이름에 들어가면 관계 목록을 훑을 때 링크 하나가 문단이 된다.

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-08-31 11:10:15 +09:00
co-authored by Claude Opus 5
parent 642afa878c
commit a3ed23e073
9 changed files with 54 additions and 9 deletions
+38
View File
@@ -76,3 +76,41 @@ describe("릴리스 노트 목록 읽기", () => {
expect(markdownLines("1. 첫째\n2. 둘째")).toEqual(["첫째", "둘째"]);
});
});
/**
* 관계 목록의 요약. 계약은 관계마다 요약을 주는데 경계 세 곳(평탄화 → 렌더 모델 → 화면 목록)을
* 지나며 조용히 사라졌다. 독자가 목록에서 보는 것이 제목뿐이라, 왜 이 기록이 걸려 있는지는
* 눌러 봐야 알 수 있었다.
*/
describe("관계 목록", () => {
it("대상 요약을 제목 아래 보여 주되 링크 이름에는 넣지 않는다", async () => {
const { PublicDocumentRelations } = await import(
"../../src/features/tech-log/presentation/shared/public-render/public-document-relations.tsx"
);
const { MemoryRouter: Router } = await import("react-router-dom");
const { container, getByRole } = render(
<Router>
<PublicDocumentRelations
relations={[
{
reason: "이 기준의 근거가 된 기록",
title: "SPA에서 토큰을 직접 관리하면서 드러난 경계",
path: "/cases/spa-browser-credential-boundary",
summary: "SPA가 public OAuth client로 code를 직접 교환한다.",
},
]}
/>
</Router>,
);
expect(container.querySelector(".document-relations li p")).toHaveTextContent(
"SPA가 public OAuth client로 code를 직접 교환한다.",
);
/*
링크 이름에 요약이 들어가면 관계 목록을 훑을 때 링크 하나하나가 문단이 되어 목록으로서
쓸모가 없어진다 — 이름은 「관계 이름 + 제목」까지다.
*/
const link = getByRole("link", { name: /이 기준의 근거가 된 기록/ });
expect(link.getAttribute("aria-label")).toBeNull();
expect(link).not.toHaveAccessibleName(/code를 직접 교환/);
});
});