Files
tech-log-frontend/tests/features/tech-log/preview-survives-missing-topic.test.ts
DongHyeonkaandClaude Opus 5 a66316e22d fix: 미리보기가 없는 주제 하나로 죽지 않고, 자료는 창에서 고른다
주제를 보관으로 내리거나 지우면 그 주제를 가리키던 작업본이 즉시 터졌다. 작성자는
「초안을 미리 볼 수 없습니다 / TOPIC catalog entry not found: cf1fe22a…」라는 UUID 만
보고, 무엇을 어디서 고쳐야 하는지 알 수 없었다 — 미리보기가 죽으면 고칠 화면까지 함께
죽는다. 이름 없는 자리로 대신해 문서를 그리고, 무엇이 잘못됐는지는 편집 폼의 그 칸이
말한다. 목록에 없는 값도 셀렉트에 임시 항목으로 남긴다: 남기지 않으면 「선택하지 않음」
으로 보여서, 고른 적 없는 주제 때문에 경고가 뜬다고 읽힌다.

편집 폼 아래에 고를 수 있는 자료가 전부 펼쳐져 있었다. 36개면 36줄이고 줄마다 파일
이름과 삭제 단추가 따라붙어 본문보다 자료 목록이 길었다 — 글을 쓰는 화면이 자료 관리
화면이 되어 있었다. 폼에는 지금 몇 개를 쓰는지와 넣는 단추만 두고, 고르는 일은 창
안에서 한다. 고르기 화면과 관리 화면은 같은 자료를 다루되 하는 일이 다르다.

Studio 위쪽은 네 가지 일만 보인다. 목적지 여섯에 구분선을 그어도 처음 들어온 사람은
여섯 중 어디부터 가야 하는지를 스스로 판단해야 했다 — 나뉘어 보이는 것과 적어 보이는
것은 다르다. 그 일 안의 화면은 일을 고른 뒤에 나타나고, 화면이 하나뿐인 일은 이름을
두 번 적지 않는다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015c8cBFUaVr7KLVUx6ujz7D
2026-09-16 01:23:49 +09:00

91 lines
2.9 KiB
TypeScript

import { describe, expect, it } from "vitest";
import type { components } from "../../../src/features/tech-log/contracts/studio/generated.ts";
import {
missingTopicIssue,
projectWorkingCopy,
} from "../../../src/features/tech-log/domain/content-format/project-public-render-model.ts";
type CatalogEntry = components["schemas"]["CatalogEntry"];
type WorkingCopyInput = components["schemas"]["WorkingCopyInput"];
const PROJECT: CatalogEntry = {
id: "22222222-2222-4222-8222-222222222222",
type: "PROJECT",
label: "가상화",
dependencyRevision: "project:1",
publicPath: "/projects/gasanghwa",
};
const TOPIC: CatalogEntry = {
id: "11111111-1111-4111-8111-111111111111",
type: "TOPIC",
label: "CPU 가상화",
dependencyRevision: "topic:1",
};
function draft(topicId: string | null): WorkingCopyInput {
return {
kind: "CONCEPT",
title: "제목",
slug: "slug",
summary: "요약",
topicId,
projectId: PROJECT.id,
variantIds: [],
relations: [],
basisVersion: "Linux 6.8",
bodyMarkdown: "## 제목\n\n본문\n",
} as WorkingCopyInput;
}
describe("미리보기는 없는 주제 하나 때문에 죽지 않는다", () => {
/*
주제를 보관으로 내리거나 지우면 그 주제를 가리키던 작업본이 즉시 터졌다 — 작성자는
「TOPIC catalog entry not found: cf1fe22a…」라는 UUID 만 보고, 무엇을 어디서 고쳐야
하는지 알 수 없었다. 미리보기가 죽으면 고칠 화면까지 함께 죽는다.
*/
it("목록에 없는 주제를 가리켜도 문서를 그린다", () => {
const model = projectWorkingCopy(
draft("cf1fe22a-af52-4d57-9833-559f537d924b"),
[TOPIC, PROJECT],
{ mode: "PREVIEW", publishedAt: null },
() => true,
);
expect(model.title).toBe("제목");
// 이름이 비면 화면은 주제 줄을 그리지 않는다 — 지어낸 이름을 넣는 것보다 낫다.
expect(model.topic.label).toBe("");
expect(model.project?.label).toBe("가상화");
});
it("주제를 아직 고르지 않아도 그린다", () => {
const model = projectWorkingCopy(
draft(null),
[TOPIC, PROJECT],
{ mode: "PREVIEW", publishedAt: null },
() => true,
);
expect(model.topic.label).toBe("");
});
it("고른 주제가 목록에 있으면 그대로 쓴다", () => {
const model = projectWorkingCopy(
draft(TOPIC.id),
[TOPIC, PROJECT],
{ mode: "PREVIEW", publishedAt: null },
() => true,
);
expect(model.topic.label).toBe("CPU 가상화");
});
/* 미리보기가 조용해진 만큼, 고칠 칸이 스스로 말해야 한다. */
it("없는 주제는 편집 칸이 말한다", () => {
expect(missingTopicIssue("cf1fe22a-af52-4d57-9833-559f537d924b", [TOPIC])).toContain(
"찾을 수 없습니다",
);
expect(missingTopicIssue(TOPIC.id, [TOPIC])).toBeNull();
expect(missingTopicIssue(null, [TOPIC])).toBeNull();
});
});