Reference 화면에 `supportingCases` 가 한글 라벨 없이 네 번 반복해서 나왔다. 라벨 표의 키가 계약이 실제로 주는 이름과 어긋나 있었기 때문이다 — `originCases`·`projectDecisions` 로 적혀 있었고 계약은 `supportingCases`· `relatedDecisions` 를 준다. 표에 없는 키는 그대로 화면에 나온다. Question 은 같은 결함을 이미 겪고 고친 자리다(주석에 남아 있다). 이번에는 표를 상수로 빼서 계약이 주는 이름 전부가 등록됐는지 확인할 수 있게 한다. 계약은 관계마다 요약도 함께 주는데 평탄화가 그것을 버렸다. 독자가 목록에서 보는 것이 제목뿐이라, 왜 이 기록이 걸려 있는지는 눌러 봐야 알 수 있었다. 요약을 흘려보내 제목 아래 두 줄로 보여 준다. 요약은 링크의 이름에서 뺀다 — 이름에 들어가면 관계 목록을 훑을 때 링크 하나하나가 문단이 되어 목록으로서 쓸모가 없어진다. `cardSummary` 를 domain 으로 옮긴다. 어댑터가 presentation 을 import 하는 것을 아키텍처 규칙이 막았고, 그 지적이 옳다 — 이 함수는 화면이 아니라 글을 다루는 규칙이다. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_011nAjrqNHGPNngN4aUbcyvJ
53 lines
1.8 KiB
TypeScript
53 lines
1.8 KiB
TypeScript
import { Link } from "react-router-dom";
|
|
|
|
export type PublicRelation = Readonly<{
|
|
/** 왜 걸려 있는지 — 관계 묶음의 사람이 읽는 이름. */
|
|
reason: string;
|
|
title: string;
|
|
path: string;
|
|
/** 대상 문서의 요약. 눌러 보지 않고도 무엇인지 알게 한다. */
|
|
summary?: string;
|
|
}>;
|
|
|
|
export function PublicDocumentRelations({
|
|
relations,
|
|
kicker = "Relations",
|
|
title = "이 기록과 연결된 맥락",
|
|
}: {
|
|
relations: ReadonlyArray<PublicRelation>;
|
|
kicker?: string;
|
|
title?: string;
|
|
}) {
|
|
if (relations.length === 0) return null;
|
|
|
|
return (
|
|
<section className="document-relations" aria-labelledby="relations-title">
|
|
<p className="section-kicker">{kicker}</p>
|
|
<h2 id="relations-title">{title}</h2>
|
|
<ul>
|
|
{relations.map((relation) => (
|
|
<li key={relation.path}>
|
|
<Link to={relation.path}>
|
|
<span>{relation.reason}</span>
|
|
<div>
|
|
<strong>{relation.title}</strong>
|
|
{/*
|
|
계약은 관계마다 요약을 함께 준다. 예전에는 그것을 버려서 목록에 제목만 남았고,
|
|
독자는 왜 이 기록이 걸려 있는지 눌러 봐야 알 수 있었다.
|
|
*/}
|
|
{/*
|
|
링크의 이름은 「관계 이름 + 제목」으로 둔다. 요약까지 이름에 들어가면 관계
|
|
목록을 훑을 때 링크 하나하나가 문단이 되어 목록으로서 쓸모가 없어진다.
|
|
요약은 눈으로 보는 보조 정보이고, 전문은 눌러 들어가면 있다.
|
|
*/}
|
|
{relation.summary ? <p aria-hidden="true">{relation.summary}</p> : null}
|
|
</div>
|
|
<span aria-hidden="true">↗</span>
|
|
</Link>
|
|
</li>
|
|
))}
|
|
</ul>
|
|
</section>
|
|
);
|
|
}
|