fix: 관계 목록이 사람이 읽는 이름과 요약을 보여 준다
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
This commit is contained in:
co-authored by
Claude Opus 5
parent
6429aee74e
commit
642afa878c
@@ -63,6 +63,32 @@ function problemCode(problem: unknown): string {
|
||||
return "PROBLEM";
|
||||
}
|
||||
|
||||
/*
|
||||
관계 묶음의 이름을 사람이 읽는 말로 바꾼다. 라벨이 없으면 계약의 키가 그대로 화면에 나온다 —
|
||||
실제로 Reference 화면에 `supportingCases` 가 한글 라벨 없이 네 번 반복해서 나왔다. 표의 키가
|
||||
계약이 실제로 주는 이름과 어긋나 있었기 때문이다(`originCases` 로 적혀 있었다).
|
||||
|
||||
키를 손으로 적는 자리이므로 계약이 주는 이름 전부가 여기 있는지 테스트가 확인한다.
|
||||
*/
|
||||
export const CASE_RELATION_LABELS = Object.freeze({
|
||||
originQuestion: "이 기록이 시작된 질문",
|
||||
projectDecisions: "이 기록이 뒷받침하는 결정",
|
||||
derivedReferences: "이 기록에서 정리된 기준",
|
||||
relatedCases: "관련 기록",
|
||||
});
|
||||
|
||||
export const REFERENCE_RELATION_LABELS = Object.freeze({
|
||||
supportingCases: "이 기준의 근거가 된 기록",
|
||||
relatedDecisions: "이 기준을 따르는 결정",
|
||||
relatedReferences: "함께 보는 기준",
|
||||
});
|
||||
|
||||
export const QUESTION_RELATION_LABELS = Object.freeze({
|
||||
resultCase: "이 질문에서 나온 기록",
|
||||
producedDecision: "이 질문이 이끈 결정",
|
||||
derivedReferences: "이 질문에서 정리된 기준",
|
||||
});
|
||||
|
||||
export function createHttpPublicContentGateway(
|
||||
deps: Readonly<{ operations: StudioOperationExecutor }>,
|
||||
): PublicContentQueries {
|
||||
@@ -160,12 +186,7 @@ export function createHttpPublicContentGateway(
|
||||
primaryTopic: body.primaryTopic as never,
|
||||
primaryProject: body.primaryProject as never,
|
||||
publishedAt: body.publishedAt as string,
|
||||
relations: flattenRelations(groups, {
|
||||
originQuestion: "이 기록이 시작된 질문",
|
||||
projectDecisions: "이 기록이 뒷받침하는 결정",
|
||||
derivedReferences: "이 기록에서 정리된 기준",
|
||||
relatedCases: "관련 기록",
|
||||
}),
|
||||
relations: flattenRelations(groups, CASE_RELATION_LABELS),
|
||||
}),
|
||||
kind: "CASE",
|
||||
problem: (body.problemSummary as string) ?? "",
|
||||
@@ -205,11 +226,7 @@ export function createHttpPublicContentGateway(
|
||||
primaryTopic: body.primaryTopic as never,
|
||||
primaryProject: body.primaryProject as never,
|
||||
publishedAt: body.publishedAt as string,
|
||||
relations: flattenRelations(groups, {
|
||||
originCases: "이 기준이 나온 기록",
|
||||
projectDecisions: "이 기준을 따르는 결정",
|
||||
relatedReferences: "관련 기준",
|
||||
}),
|
||||
relations: flattenRelations(groups, REFERENCE_RELATION_LABELS),
|
||||
}),
|
||||
kind: "REFERENCE",
|
||||
/*
|
||||
@@ -283,11 +300,7 @@ export function createHttpPublicContentGateway(
|
||||
producedDecision: groups.producedDecision,
|
||||
derivedReferences: groups.derivedReferences,
|
||||
},
|
||||
{
|
||||
resultCase: "이 질문에서 나온 기록",
|
||||
producedDecision: "이 질문이 이끈 결정",
|
||||
derivedReferences: "이 질문에서 정리된 기준",
|
||||
},
|
||||
QUESTION_RELATION_LABELS,
|
||||
),
|
||||
}),
|
||||
kind: "QUESTION",
|
||||
|
||||
@@ -10,6 +10,7 @@ import type {
|
||||
Release,
|
||||
SearchablePublicEntity,
|
||||
} from "../../application/ports/public-content-queries.ts";
|
||||
import { cardSummary } from "../../domain/content-format/card-summary.ts";
|
||||
|
||||
/**
|
||||
* The contract and the screens disagree about shape, on purpose.
|
||||
@@ -136,14 +137,23 @@ type Related = Readonly<{ type?: string; title?: string; summary?: string; path?
|
||||
export function flattenRelations(
|
||||
groups: Readonly<Record<string, Related | readonly Related[] | undefined>>,
|
||||
labels: Readonly<Record<string, string>>,
|
||||
): ReadonlyArray<{ reason: string; title: string; path: string }> {
|
||||
const flat: { reason: string; title: string; path: string }[] = [];
|
||||
): ReadonlyArray<{ reason: string; title: string; path: string; summary: string }> {
|
||||
const flat: { reason: string; title: string; path: string; summary: string }[] = [];
|
||||
for (const [group, value] of Object.entries(groups)) {
|
||||
if (!value) continue;
|
||||
const reason = labels[group] ?? group;
|
||||
for (const entry of Array.isArray(value) ? value : [value as Related]) {
|
||||
if (!entry?.path || !entry.title) continue;
|
||||
flat.push({ reason, title: entry.title, path: entry.path });
|
||||
/*
|
||||
계약은 관계마다 요약도 함께 준다. 예전에는 그것을 버려서, 독자가 링크 목록에서 보는 것이
|
||||
제목뿐이었다 — 왜 이 기록이 여기 걸려 있는지는 눌러 봐야 알 수 있었다.
|
||||
*/
|
||||
flat.push({
|
||||
reason,
|
||||
title: entry.title,
|
||||
path: entry.path,
|
||||
summary: cardSummary((entry as { summary?: string }).summary),
|
||||
});
|
||||
}
|
||||
}
|
||||
return Object.freeze(flat);
|
||||
@@ -161,7 +171,7 @@ export function baseOf(
|
||||
primaryTopic?: Summary;
|
||||
primaryProject?: Summary;
|
||||
publishedAt?: string | null;
|
||||
relations?: ReadonlyArray<{ reason: string; title: string; path: string }>;
|
||||
relations?: ReadonlyArray<{ reason: string; title: string; path: string; summary: string }>;
|
||||
}>,
|
||||
) {
|
||||
return {
|
||||
|
||||
@@ -8,6 +8,7 @@ export type QuestionStatus =
|
||||
|
||||
export type PublicRelation = {
|
||||
reason: string;
|
||||
summary: string;
|
||||
title: string;
|
||||
path: string;
|
||||
};
|
||||
@@ -298,16 +299,19 @@ export const publicRecords: ReadonlyArray<PublicRecord> = [
|
||||
relations: [
|
||||
{
|
||||
reason: "이 질문에서 시작됨",
|
||||
summary: "",
|
||||
title: "컬렉션 Fetch Join을 유지하면서 페이징할 수 있는가?",
|
||||
path: "/questions/collection-fetch-join-with-pagination",
|
||||
},
|
||||
{
|
||||
reason: "이 Case로 결정함",
|
||||
summary: "",
|
||||
title: "피드 목록은 부모 페이징과 연관 컬렉션 로딩을 분리합니다.",
|
||||
path: "/projects/backend-skeleton/decisions#feed-pagination-boundary",
|
||||
},
|
||||
{
|
||||
reason: "이 기준 문서로 정리됨",
|
||||
summary: "",
|
||||
title: "JPA 목록 조회에서 Fetch 전략을 선택하는 기준",
|
||||
path: "/references/jpa-list-fetch-strategy",
|
||||
},
|
||||
@@ -355,11 +359,13 @@ export const publicRecords: ReadonlyArray<PublicRecord> = [
|
||||
relations: [
|
||||
{
|
||||
reason: "이 프로젝트에 속함",
|
||||
summary: "",
|
||||
title: "Backend Skeleton",
|
||||
path: "/projects/backend-skeleton",
|
||||
},
|
||||
{
|
||||
reason: "이 결정과 연결됨",
|
||||
summary: "",
|
||||
title: "StoragePort와 Adapter의 책임을 분리합니다.",
|
||||
path: "/projects/backend-skeleton/decisions#storage-port-unification",
|
||||
},
|
||||
@@ -412,11 +418,13 @@ export const publicRecords: ReadonlyArray<PublicRecord> = [
|
||||
relations: [
|
||||
{
|
||||
reason: "이 질문의 검증 기준",
|
||||
summary: "",
|
||||
title: "oauth2-proxy가 전달한 토큰을 다시 검증해야 하는가?",
|
||||
path: "/questions/validate-edge-token-again",
|
||||
},
|
||||
{
|
||||
reason: "이 프로젝트에 속함",
|
||||
summary: "",
|
||||
title: "Auth Lab",
|
||||
path: "/projects/auth-lab",
|
||||
},
|
||||
@@ -469,11 +477,13 @@ export const publicRecords: ReadonlyArray<PublicRecord> = [
|
||||
relations: [
|
||||
{
|
||||
reason: "이 Case에서 측정함",
|
||||
summary: "",
|
||||
title: "컬렉션 Fetch Join과 페이징은 왜 충돌하는가",
|
||||
path: "/cases/collection-fetch-join-pagination",
|
||||
},
|
||||
{
|
||||
reason: "이 질문을 해결함",
|
||||
summary: "",
|
||||
title: "컬렉션 Fetch Join을 유지하면서 페이징할 수 있는가?",
|
||||
path: "/questions/collection-fetch-join-with-pagination",
|
||||
},
|
||||
@@ -524,11 +534,13 @@ export const publicRecords: ReadonlyArray<PublicRecord> = [
|
||||
relations: [
|
||||
{
|
||||
reason: "검증 기준",
|
||||
summary: "",
|
||||
title: "Authorization Code Flow에서 state와 nonce의 경계",
|
||||
path: "/references/state-and-nonce-boundary",
|
||||
},
|
||||
{
|
||||
reason: "이 프로젝트에서 추적함",
|
||||
summary: "",
|
||||
title: "Auth Lab 활동",
|
||||
path: "/projects/auth-lab/activity#edge-trust-boundary",
|
||||
},
|
||||
@@ -581,11 +593,13 @@ export const publicRecords: ReadonlyArray<PublicRecord> = [
|
||||
relations: [
|
||||
{
|
||||
reason: "이 Case로 해결됨",
|
||||
summary: "",
|
||||
title: "컬렉션 Fetch Join과 페이징은 왜 충돌하는가",
|
||||
path: "/cases/collection-fetch-join-pagination",
|
||||
},
|
||||
{
|
||||
reason: "적용 기준",
|
||||
summary: "",
|
||||
title: "JPA 목록 조회에서 Fetch 전략을 선택하는 기준",
|
||||
path: "/references/jpa-list-fetch-strategy",
|
||||
},
|
||||
|
||||
Reference in New Issue
Block a user