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:
co-authored by
Claude Opus 5
parent
af5a6bbf23
commit
618a228eff
@@ -83,34 +83,52 @@ describe("릴리스 노트 목록 읽기", () => {
|
||||
* 눌러 봐야 알 수 있었다.
|
||||
*/
|
||||
describe("관계 목록", () => {
|
||||
it("대상 요약을 제목 아래 보여 주되 링크 이름에는 넣지 않는다", async () => {
|
||||
async function renderRelations(relation: Record<string, unknown>) {
|
||||
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(
|
||||
return render(
|
||||
<Router>
|
||||
<PublicDocumentRelations
|
||||
relations={[
|
||||
{
|
||||
reason: "이 기준의 근거가 된 기록",
|
||||
title: "SPA에서 토큰을 직접 관리하면서 드러난 경계",
|
||||
path: "/cases/spa-browser-credential-boundary",
|
||||
summary: "SPA가 public OAuth client로 code를 직접 교환한다.",
|
||||
},
|
||||
]}
|
||||
/>
|
||||
<PublicDocumentRelations relations={[relation as never]} />
|
||||
</Router>,
|
||||
);
|
||||
}
|
||||
|
||||
it("대상 요약을 제목 아래 보여 주되 링크 이름에는 넣지 않는다", async () => {
|
||||
const { container, getByRole } = await renderRelations({
|
||||
label: "적용 기준",
|
||||
title: "SPA에서 토큰을 직접 관리하면서 드러난 경계",
|
||||
path: "/cases/spa-browser-credential-boundary",
|
||||
summary: "SPA가 public OAuth client로 code를 직접 교환한다.",
|
||||
});
|
||||
expect(container.querySelector(".document-relations li p")).toHaveTextContent(
|
||||
"SPA가 public OAuth client로 code를 직접 교환한다.",
|
||||
);
|
||||
/*
|
||||
링크 이름에 요약이 들어가면 관계 목록을 훑을 때 링크 하나하나가 문단이 되어 목록으로서
|
||||
쓸모가 없어진다 — 이름은 「관계 이름 + 제목」까지다.
|
||||
쓸모가 없어진다 — 이름은 「묶음 이름 + 제목」까지다.
|
||||
*/
|
||||
const link = getByRole("link", { name: /이 기준의 근거가 된 기록/ });
|
||||
const link = getByRole("link", { name: /적용 기준/ });
|
||||
expect(link.getAttribute("aria-label")).toBeNull();
|
||||
expect(link).not.toHaveAccessibleName(/code를 직접 교환/);
|
||||
});
|
||||
|
||||
/*
|
||||
작성자가 관계마다 남긴 문장이 「다음에 무엇을 읽을지」의 답이다. 대상의 요약은 대상을
|
||||
설명할 뿐이라, 둘 다 있으면 작성자의 문장을 보인다. 이 문장은 오래 Studio 에만 있었고
|
||||
공개 화면에는 한 번도 나오지 않았다.
|
||||
*/
|
||||
it("작성자가 남긴 이유가 있으면 대상 요약 대신 그것을 보인다", async () => {
|
||||
const { container } = await renderRelations({
|
||||
label: "검증 기록",
|
||||
title: "SPA에서 토큰을 직접 관리하면서 드러난 경계",
|
||||
path: "/cases/spa-browser-credential-boundary",
|
||||
note: "이 기준이 왜 필요했는지를 이 기록이 보여 준다.",
|
||||
summary: "SPA가 public OAuth client로 code를 직접 교환한다.",
|
||||
});
|
||||
const description = container.querySelector(".document-relations li p");
|
||||
expect(description).toHaveTextContent("이 기준이 왜 필요했는지를 이 기록이 보여 준다.");
|
||||
expect(description).not.toHaveTextContent("code를 직접 교환");
|
||||
});
|
||||
});
|
||||
|
||||
Reference in New Issue
Block a user