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
@@ -1,8 +1,8 @@
{
"packageId": "@tech-log/public-contract",
"version": "2.1.0",
"digest": "sha256:afe415880eb5d6289ae10abf493333c97270c323c16a7245a466d4db4466e630",
"sourceRevision": "fa67a64",
"digest": "sha256:92c15205d373bd7048d9596e75b211c30198bb4fb3339e1d7f92a2acabe75440",
"sourceRevision": "ca1bbfe",
"operationIds": [
"getPublicSite",
"getPublicHome",
@@ -418,6 +418,12 @@ export interface components {
type: "CASE" | "REFERENCE" | "QUESTION" | "CONCEPT" | "PROJECT" | "PROJECT_DECISION" | "RELEASE";
title: string;
summary?: string;
/** @description 작성자가 남긴, 왜 이 기록이 걸려 있는지. Studio 에 이미 저장돼 있으나 공개 응답에
* 자리가 없어 독자는 볼 수 없었다 — 「다음에 무엇을 읽을지」의 답이 이 문장이다. */
reason?: string;
/** @description 낮을수록 먼저. 상세 화면은 앞의 한둘만 펴 두고 나머지는 접는다 — 균등한 넷은
* 선택이 아니라 부담이다. */
priority?: number;
path: string;
};
ContactLink: {
@@ -539,13 +545,26 @@ export interface components {
slug: string;
description: string;
scope?: string;
thesis?: string;
variantLabel?: string;
};
/** @description 주제 안의 접근/구조. 표시 순서대로 온다. 비어 있으면 이 주제는 축을 쓰지 않는다. */
variants?: components["schemas"]["TopicVariantSummary"][];
featuredReference?: components["schemas"]["RelatedEntry"];
featuredCases: components["schemas"]["RelatedEntry"][];
activeQuestions: components["schemas"]["RelatedEntry"][];
relatedProjects: components["schemas"]["RelatedEntry"][];
latestRecords: components["schemas"]["LatestEntry"][];
};
TopicVariantSummary: {
slug: string;
title: string;
path: string;
summary?: string;
/** @description 만들어 보고 무엇을 알게 됐는가. 비교표가 읽는 칸이다. */
conclusion?: string;
recordCount?: number;
};
CaseDetailResponse: {
canonicalPath: string;
/** @default true */
@@ -910,6 +910,17 @@ components:
type: string
summary:
type: string
reason:
type: string
description: |-
작성자가 남긴, 왜 이 기록이 걸려 있는지. Studio 에 이미 저장돼 있으나 공개 응답에
자리가 없어 독자는 볼 수 없었다 — 「다음에 무엇을 읽을지」의 답이 이 문장이다.
priority:
type: integer
minimum: 0
description: |-
낮을수록 먼저. 상세 화면은 앞의 한둘만 펴 두고 나머지는 접는다 — 균등한 넷은
선택이 아니라 부담이다.
path:
type: string
ContactLink:
@@ -1231,6 +1242,16 @@ components:
type: string
scope:
type: string
thesis:
type: string
variantLabel:
type: string
variants:
type: array
description: |-
주제 안의 접근/구조. 표시 순서대로 온다. 비어 있으면 이 주제는 축을 쓰지 않는다.
items:
$ref: '#/components/schemas/TopicVariantSummary'
featuredReference:
$ref: '#/components/schemas/RelatedEntry'
featuredCases:
@@ -1249,6 +1270,27 @@ components:
type: array
items:
$ref: '#/components/schemas/LatestEntry'
TopicVariantSummary:
type: object
required:
- slug
- title
- path
properties:
slug:
type: string
title:
type: string
path:
type: string
summary:
type: string
conclusion:
type: string
description: 만들어 보고 무엇을 알게 됐는가. 비교표가 읽는 칸이다.
recordCount:
type: integer
minimum: 0
CaseDetailResponse:
type: object
required: