fix: 주제로 가는 링크가 실제로 주제 화면에 닿게 한다

문서 머리말의 주제 링크는 탐색 필터(`/explore?topic=…`)를 가리키고 있었다. 주제 화면이
주제 셋만 열어 두어 나머지가 404 였기 때문에 우회한 것인데, 그 하드코딩이 없어졌으므로
이제 곧장 주제 화면으로 간다.

축의 주소도 실제로 있는 자리로 맞춘다. `/topics/{주제}/{축}` 이라 적어 두었는데 그런
화면이 없다 — 축은 주제 화면 안의 한 줄이므로 그 줄에 앵커를 달고 그것을 가리킨다.

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 17:22:57 +09:00
co-authored by Claude Opus 5
parent 3510ec013f
commit 882800568f
11 changed files with 33 additions and 19 deletions
+6 -6
View File
@@ -38,28 +38,28 @@
},
"contractSet": {
"setAlgorithm": "CA_CONTRACT_SET_V1",
"setDigest": "sha256:05cc77985a814e457d1113758f2e6985196d5c66c069177de9e0ebdd1f4a40af",
"setDigest": "sha256:316028ca9b408cd5e943f1971792fbdb843392ea51ae415815fbbb8701d03909",
"packages": [
{
"packageId": "@tech-log/management-contract",
"version": "1.0.0",
"digest": "sha256:5452be2aa2ac4164c82db393ae94eb0b7dcfa27c34a26dcd73f26f9f1a8e8998",
"digest": "sha256:61f8360cfb2e638c5d8c5557434b564e39cea517464c33cedcd1c5bf39a58aa8",
"runtimeProtocolVersion": 1,
"sourceRevision": "0f4d2cd"
"sourceRevision": "71bab4c"
},
{
"packageId": "@tech-log/public-contract",
"version": "2.1.0",
"digest": "sha256:08b68601bd81c569926e7374a0c95711a5982da332e6edc6c811fe08d2fd19db",
"digest": "sha256:977edf6707dc41a92f58f0f42908864ab8a3c1991d08f5c598319d51dac65235",
"runtimeProtocolVersion": 1,
"sourceRevision": "0f4d2cd"
"sourceRevision": "71bab4c"
},
{
"packageId": "@tech-log/studio-contract",
"version": "3.1.0",
"digest": "sha256:d2bfbe0a12136f131ccb8c42f8868108ba8d0f0182b347f9b815316c343a970c",
"runtimeProtocolVersion": 1,
"sourceRevision": "0f4d2cd"
"sourceRevision": "71bab4c"
}
]
}
@@ -1,8 +1,8 @@
{
"packageId": "@tech-log/management-contract",
"version": "1.0.0",
"digest": "sha256:5452be2aa2ac4164c82db393ae94eb0b7dcfa27c34a26dcd73f26f9f1a8e8998",
"sourceRevision": "0f4d2cd",
"digest": "sha256:61f8360cfb2e638c5d8c5557434b564e39cea517464c33cedcd1c5bf39a58aa8",
"sourceRevision": "71bab4c",
"operationIds": [
"createCaseDraft",
"getCaseForEdit",
@@ -1520,7 +1520,7 @@ export interface components {
featuredCaseIds?: string[];
};
/** @description 주제 안의 접근/구조 하나. slug 는 그 주제 안에서만 유일하다 — 주소가
* `/topics/{topicSlug}/{variantSlug}` 이고, 다른 주제에서 같은 이름을 쓸 수 있어야 한다. */
* `/topics/{topicSlug}#{variantSlug}` 이고, 다른 주제에서 같은 이름을 쓸 수 있어야 한다. */
TopicVariantEdit: {
/** Format: uuid */
id?: string;
@@ -7024,7 +7024,7 @@ components:
- title
description: |-
주제 안의 접근/구조 하나. slug 는 그 주제 안에서만 유일하다 — 주소가
`/topics/{topicSlug}/{variantSlug}` 이고, 다른 주제에서 같은 이름을 쓸 수 있어야 한다.
`/topics/{topicSlug}#{variantSlug}` 이고, 다른 주제에서 같은 이름을 쓸 수 있어야 한다.
properties:
id:
type: string
@@ -1,8 +1,8 @@
{
"packageId": "@tech-log/public-contract",
"version": "2.1.0",
"digest": "sha256:08b68601bd81c569926e7374a0c95711a5982da332e6edc6c811fe08d2fd19db",
"sourceRevision": "0f4d2cd",
"digest": "sha256:977edf6707dc41a92f58f0f42908864ab8a3c1991d08f5c598319d51dac65235",
"sourceRevision": "71bab4c",
"operationIds": [
"getPublicSite",
"getPublicHome",
@@ -559,6 +559,9 @@ export interface components {
TopicVariantSummary: {
slug: string;
title: string;
/** @description 이 축이 주제 화면에서 사는 자리(`/topics/{주제}#{축}`). 축은 주제 화면 안의 한 줄이지
* 따로 선 화면이 아니다 — 자기 화면을 갖게 되면 그때 이 값이 바뀐다.
* */
path: string;
summary?: string;
/** @description 만들어 보고 무엇을 알게 됐는가. 비교표가 읽는 칸이다. */
@@ -1283,6 +1283,9 @@ components:
type: string
path:
type: string
description: |
이 축이 주제 화면에서 사는 자리(`/topics/{주제}#{축}`). 축은 주제 화면 안의 한 줄이지
따로 선 화면이 아니다 — 자기 화면을 갖게 되면 그때 이 값이 바뀐다.
summary:
type: string
conclusion:
@@ -2,7 +2,7 @@
"packageId": "@tech-log/studio-contract",
"version": "3.1.0",
"digest": "sha256:d2bfbe0a12136f131ccb8c42f8868108ba8d0f0182b347f9b815316c343a970c",
"sourceRevision": "0f4d2cd",
"sourceRevision": "71bab4c",
"operationIds": [
"getStudioSession",
"getStudioDashboard",
@@ -40,9 +40,12 @@ export function publicRenderModelBase(
topic: {
id: `topic-${record.topicSlug}`,
label: record.topic,
// 공개 문서의 머리말이 실제로 그리는 주제 링크는 이 값이다 — 위의 breadcrumb 과 같은
// 이유로 탐색 필터를 가리킨다. 둘 중 하나만 고치면 화면에서는 그대로 404 로 간다.
publicPath: `/explore?topic=${encodeURIComponent(record.topicSlug)}`,
/*
주제 화면으로 보낸다. 오래 탐색 필터(`/explore?topic=…`)를 가리켰던 것은 주제 화면이
주제 셋만 열어 두어 나머지가 404 였기 때문이다 — 그 목록이 없어졌으므로 이제 어떤
주제든 자기 화면이 있다.
*/
publicPath: `/topics/${encodeURIComponent(record.topicSlug)}`,
},
project: {
id: `project-${record.projectSlug}`,
@@ -49,7 +49,11 @@ export function TopicPage() {
<h2 id="topic-variants-title">{`${axisLabel}별로 무엇을 알게 됐나`}</h2>
<ul>
{topic.variants.map((variant) => (
<li key={variant.slug}>
/*
축의 주소(`/topics/{주제}#{축}`)가 실제로 가리키는 자리다. 다른 화면에서 이
축을 걸면 여기로 온다 — 앵커가 없으면 그 링크는 주제 화면 맨 위에 떨어진다.
*/
<li key={variant.slug} id={variant.slug}>
<a href={variant.path}>
<strong>{variant.title}</strong>
{/*
@@ -223,11 +223,12 @@ describe("TechLog canonical Public documents", () => {
/*
글자만 보고 있었더니 주제 링크가 어디로 가는지는 아무도 묻지 않았다. 그 링크는
`/topics/:slug` 를 가리켰고, 그 화면은 세 개의 주제를 하드코딩해 두고 있어 실제 주제는
무엇이든 404 였다 — 게시한 모든 문서가 죽은 링크를 하나씩 달고 있었다.
무엇이든 404 였다 — 게시한 모든 문서가 죽은 링크를 하나씩 달고 있었다. 그동안은 탐색
필터로 우회했는데, 하드코딩이 없어졌으므로 이제 주제 화면으로 곧장 간다.
*/
expect(within(breadcrumb).getByRole("link", { name: topic })).toHaveAttribute(
"href",
`/explore?topic=${topicSlugs[topic]}`,
`/topics/${topicSlugs[topic]}`,
);
/*