feat: 축에 자기 화면을 준다

주제 화면의 네 줄(SPA·Mediator·BFF·Forward-Auth)은 링크인데 눌러도 아무 일이 없었다.
축의 주소를 주제 화면 안의 앵커로 잡아 두어서, 정작 주제 화면에서는 그 링크가 자기 자신을
가리켰다 — 주소만 바뀌고 화면은 그대로였다.

축에 화면을 준다. 결론을 먼저 두고 그 아래 그 축에 걸린 기록만 모은다. 목록 조회에
`variant` 필터를 더해 `record_variant` 로 거른다 — 축 slug 는 주제 안에서만 유일하므로
주제까지 함께 맞춘다.

정적 어댑터는 축으로 거르면 빈 목록을 준다. 축은 사람이 Studio 에서 거는 값이라 픽스처가
지어낼 수 없고, 없는 것을 있는 척하면 이 어댑터로 그린 화면이 서버로 바꿨을 때 달라진다.

`RecordFilters` 가 포트와 정적 어댑터에 따로 있어, 포트에 필터가 늘어도 이쪽은 모르는
상태가 됐다 — 메서드 매개변수가 bivariant 라 `satisfies` 가 잡지 못한다. 하나로 합친다.

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 20:36:53 +09:00
co-authored by Claude Opus 5
parent 344dadb17a
commit 67a549173d
20 changed files with 161 additions and 26 deletions
@@ -2,7 +2,7 @@
"packageId": "@tech-log/management-contract",
"version": "1.0.0",
"digest": "sha256:61f8360cfb2e638c5d8c5557434b564e39cea517464c33cedcd1c5bf39a58aa8",
"sourceRevision": "a58ad30",
"sourceRevision": "b93d62a",
"operationIds": [
"createCaseDraft",
"getCaseForEdit",
@@ -1,8 +1,8 @@
{
"packageId": "@tech-log/public-contract",
"version": "2.1.0",
"digest": "sha256:a964914040740a1223c33b5aeaf7724a8a0c78d91063bf3f1b7d7594c314a395",
"sourceRevision": "a58ad30",
"digest": "sha256:10b922715a4149f2dcf4d5925fb1d3e3e820a6d14d9e4a91d7a325027684280d",
"sourceRevision": "b93d62a",
"operationIds": [
"getPublicSite",
"getPublicHome",
@@ -564,8 +564,9 @@ export interface components {
TopicVariantSummary: {
slug: string;
title: string;
/** @description 이 축이 주제 화면에서 사는 자리(`/topics/{주제}#{축}`). 축은 주제 화면 안의 한 줄이지
* 따로 선 화면이 아니다 — 자기 화면을 갖게 되면 그때 이 값이 바뀐다.
/** @description 이 축의 공개 주소(`/topics/{주제}/{축}`). 그 축에 걸린 기록만 모아 보여 준다.
* 한동안 주제 화면 안의 앵커였는데, 주제 화면에서는 그 링크가 자기 자신을 가리켜
* 눌러도 아무 일이 없었다.
* */
path: string;
summary?: string;
@@ -1108,6 +1109,10 @@ export interface operations {
query?: {
type?: "CASE" | "REFERENCE" | "CONCEPT";
topic?: string;
/** @description 주제 안의 축 slug. 그 축에 걸린 기록만 남긴다. `topic` 과 함께 준다 — 축 slug 는
* 주제 안에서만 유일하다.
* */
variant?: string;
project?: string;
tag?: string;
year?: number;
@@ -1155,6 +1160,10 @@ export interface operations {
query?: {
status?: "OPEN" | "INVESTIGATING" | "PAUSED" | "RESOLVED";
topic?: string;
/** @description 주제 안의 축 slug. 그 축에 걸린 기록만 남긴다. `topic` 과 함께 준다 — 축 slug 는
* 주제 안에서만 유일하다.
* */
variant?: string;
project?: string;
tag?: string;
sort?: "UPDATED_DESC" | "OPENED_DESC" | "RESOLVED_DESC";
@@ -119,6 +119,13 @@ paths:
in: query
schema:
type: string
- name: variant
in: query
description: |
주제 안의 축 slug. 그 축에 걸린 기록만 남긴다. `topic` 과 함께 준다 — 축 slug 는
주제 안에서만 유일하다.
schema:
type: string
- name: project
in: query
schema:
@@ -200,6 +207,13 @@ paths:
in: query
schema:
type: string
- name: variant
in: query
description: |
주제 안의 축 slug. 그 축에 걸린 기록만 남긴다. `topic` 과 함께 준다 — 축 slug 는
주제 안에서만 유일하다.
schema:
type: string
- name: project
in: query
schema:
@@ -1291,8 +1305,9 @@ components:
path:
type: string
description: |
이 축이 주제 화면에서 사는 자리(`/topics/{주제}#{축}`). 축은 주제 화면 안의 한 줄이지
따로 선 화면이 아니다 — 자기 화면을 갖게 되면 그때 이 값이 바뀐다.
이 축의 공개 주소(`/topics/{주제}/{축}`). 그 축에 걸린 기록만 모아 보여 준다.
한동안 주제 화면 안의 앵커였는데, 주제 화면에서는 그 링크가 자기 자신을 가리켜
눌러도 아무 일이 없었다.
summary:
type: string
conclusion:
@@ -2,7 +2,7 @@
"packageId": "@tech-log/studio-contract",
"version": "3.1.0",
"digest": "sha256:d2bfbe0a12136f131ccb8c42f8868108ba8d0f0182b347f9b815316c343a970c",
"sourceRevision": "a58ad30",
"sourceRevision": "b93d62a",
"operationIds": [
"getStudioSession",
"getStudioDashboard",
@@ -98,6 +98,7 @@ const HTTP_CONTRACTS = Object.freeze([
const value = input as unknown as Readonly<{
type?: string;
topic?: string;
variant?: string;
project?: string;
page?: number;
size?: number;
@@ -108,6 +109,7 @@ const HTTP_CONTRACTS = Object.freeze([
const value = input as unknown as Readonly<{
status?: string;
topic?: string;
variant?: string;
project?: string;
page?: number;
size?: number;
@@ -30,6 +30,7 @@ const TECH_LOG_ROUTE_SPECS = [
defineSpec({ routeId: "TECH_LOG_CONCEPT", path: "/concepts/:slug", layoutGroup: "PUBLIC", paramsSchema: "TechLogSlugParams", searchSchema: null, title: "개념", navigationLabel: null, navigationOrder: null }),
defineSpec({ routeId: "TECH_LOG_QUESTION", path: "/questions/:slug", layoutGroup: "PUBLIC", paramsSchema: "TechLogSlugParams", searchSchema: null, title: "Open Question", navigationLabel: null, navigationOrder: null }),
defineSpec({ routeId: "TECH_LOG_TOPIC", path: "/topics/:slug", layoutGroup: "PUBLIC", paramsSchema: "TechLogSlugParams", searchSchema: null, title: "Topic", navigationLabel: null, navigationOrder: null }),
defineSpec({ routeId: "TECH_LOG_TOPIC_VARIANT", path: "/topics/:slug/:variant", layoutGroup: "PUBLIC", paramsSchema: "TechLogTopicVariantParams", searchSchema: null, title: "Topic", navigationLabel: null, navigationOrder: null }),
defineSpec({ routeId: "TECH_LOG_PROJECTS", path: "/projects", layoutGroup: "PUBLIC", paramsSchema: null, searchSchema: null, title: "프로젝트", navigationLabel: "프로젝트", navigationOrder: 20 }),
defineSpec({ routeId: "TECH_LOG_PROJECT", path: "/projects/:slug", layoutGroup: "PUBLIC", paramsSchema: "TechLogSlugParams", searchSchema: null, title: "프로젝트", navigationLabel: null, navigationOrder: null }),
defineSpec({ routeId: "TECH_LOG_PROJECT_RECORDS", path: "/projects/:slug/records", layoutGroup: "PUBLIC", paramsSchema: "TechLogSlugParams", searchSchema: null, title: "프로젝트 기록", navigationLabel: null, navigationOrder: null }),