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
This commit is contained in:
DongHyeonka
2026-09-16 01:23:49 +09:00
co-authored by Claude Opus 5
parent 623a58942f
commit a66316e22d
12 changed files with 367 additions and 56 deletions
@@ -115,6 +115,16 @@ function catalogEntry(
return entry ?? null;
}
/**
* 목록에 없는 대상의 자리.
*
* <p>계약의 `DisplayTarget` 은 비울 수 없다. 이름을 비워 두면 화면은 그 줄을 그리지 않는다 —
* 지어낸 이름을 넣는 것보다 낫다. 지어내면 작성자는 멀쩡한 줄을 보고 아무 문제가 없다고 읽는다.
*/
function placeholderTarget(): CatalogEntry {
return { id: "", type: "TOPIC", label: "", dependencyRevision: "missing" };
}
function displayTarget(
entry: CatalogEntry,
): components["schemas"]["DisplayTarget"] {
@@ -232,9 +242,20 @@ export function projectWorkingCopy(
context: ProjectionContext,
supportsEvidenceKey: SupportsEvidenceKey,
): AuthoringRenderModel {
const topic = catalogEntry(catalog, input.topicId, "TOPIC", true);
const project = catalogEntry(catalog, input.projectId, "PROJECT", false);
if (!topic) fail("TOPIC catalog entry is required");
/*
주제와 프로젝트가 목록에 없다고 미리보기를 통째로 버리지 않는다.
주제를 보관으로 내리거나 지우면 그 주제를 가리키던 작업본이 즉시 이 자리에서 터졌다 —
작성자는 「초안을 미리 볼 수 없습니다 / TOPIC catalog entry not found: cf1fe22a…」라는
UUID 만 보고, 무엇을 고쳐야 하는지도 어디서 고쳐야 하는지도 알 수 없었다. 미리보기가
죽으면 고칠 화면까지 함께 죽는다.
이름 없는 자리로 대신한다. 맥락 덩어리는 이름이 빈 주제를 그리지 않으므로 화면은 조용히
주제 줄만 빠지고, 무엇이 잘못됐는지는 편집 폼의 그 칸이 말한다(`missingTopicIssue`).
*/
const topic =
catalogEntry(catalog, input.topicId, "TOPIC", false, false) ?? placeholderTarget();
const project = catalogEntry(catalog, input.projectId, "PROJECT", false, false);
if (input.kind === "PROJECT_DECISION" && !project) {
fail("Decision 은 프로젝트에 속합니다. 기본 정보에서 프로젝트를 골라 주세요.");
}
@@ -395,3 +416,23 @@ export function projectWorkingCopy(
};
}
}
/**
* 고른 주제가 목록에 없다면 그 사실을 한 문장으로.
*
* <p>미리보기는 이제 이 경우에 죽지 않고 주제 줄만 비운다. 그러면 작성자에게는 아무 일도 없었던
* 것처럼 보이므로, 고쳐야 할 칸이 스스로 말해야 한다.
*/
export function missingTopicIssue(
topicId: string | null,
catalog: ReadonlyArray<CatalogEntry>,
): string | null {
if (!topicId) return null;
const found = catalog.some(
(entry) => entry.id === topicId && entry.type === "TOPIC",
);
return found
? null
: "고른 주제를 목록에서 찾을 수 없습니다. 보관됐거나 지워진 주제입니다 — 다시 골라 주세요.";
}
@@ -0,0 +1,108 @@
import { useEffect, useRef, useState } from "react";
import type { StudioAssetGateway } from "../../../application/ports/studio-asset-gateway.ts";
import type { Asset } from "../../../contracts/studio/contract.ts";
import { AssetPicker } from "./asset-picker.tsx";
/** 본문이 그림을 가리키는 방법. 이 수를 세면 "지금 몇 개를 쓰는가" 가 나온다. */
const EVIDENCE_DIRECTIVE = /^:::evidence\b/gmu;
export function countBodyAssets(bodyMarkdown: string): number {
return bodyMarkdown.match(EVIDENCE_DIRECTIVE)?.length ?? 0;
}
/**
* 자료는 고르러 들어가는 것이지 폼에 펼쳐 두는 것이 아니다.
*
* <p>편집 폼 아래에 고를 수 있는 자료가 전부 펼쳐져 있었다. 36개면 36줄이고, 줄마다 파일 이름과
* 삭제 단추가 따라붙어 본문보다 자료 목록이 길었다 — 좁은 화면에서는 그 덩어리가 여러 줄로
* 깨지면서 삭제 단추만 따로 떨어지기도 했다. 글을 쓰는 화면이 자료 관리 화면이 되어 있었다.
*
* <p>폼에는 지금 몇 개를 쓰는지와 넣는 단추만 둔다. 고르는 일은 창 안에서 한다 — 검색과 목록은
* 그대로 쓰되 글의 흐름을 막지 않는다.
*
* <p>관리(이름·대체 텍스트·사용처·삭제)는 Asset 화면이 맡는다. 같은 자료를 두 화면이 다루되
* 하는 일이 다르다: 여기는 글에 넣기, 저기는 관리하기.
*/
export function AssetPickerDialog({
gateway,
usedCount,
onInsert,
onAssetsObserved,
}: {
gateway: StudioAssetGateway;
/** 본문이 지금 가리키는 자료 수. */
usedCount: number;
onInsert(directive: string): void;
onAssetsObserved?(assets: readonly Asset[]): void;
}) {
const [open, setOpen] = useState(false);
const dialogRef = useRef<HTMLDialogElement>(null);
const triggerRef = useRef<HTMLButtonElement>(null);
useEffect(() => {
const dialog = dialogRef.current;
if (!dialog) return;
/*
`showModal` 이 없는 환경이 있다(jsdom 이 그렇다). 없으면 창을 그냥 보이는 상태로 둔다 —
고르지 못하게 막는 것보다 낫다.
*/
if (open) {
if (typeof dialog.showModal === "function") dialog.showModal();
else dialog.setAttribute("open", "");
} else if (dialog.open) {
if (typeof dialog.close === "function") dialog.close();
else dialog.removeAttribute("open");
}
}, [open]);
const close = () => {
setOpen(false);
// 닫고 나면 초점이 갈 곳이 있어야 한다. 열었던 단추로 돌려준다.
queueMicrotask(() => triggerRef.current?.focus());
};
return (
<div className="studio-asset-slot">
<p className="studio-asset-slot__count">
{usedCount > 0 ? `본문에서 자료 ${usedCount}개를 씁니다` : "본문에 넣은 자료가 없습니다"}
</p>
<button
ref={triggerRef}
className="studio-secondary-button"
type="button"
onClick={() => setOpen(true)}
>
본문에 자료 넣기
</button>
<dialog
ref={dialogRef}
className="studio-asset-dialog"
aria-label="본문에 넣을 자료 고르기"
onClose={() => setOpen(false)}
onCancel={close}
>
{/* 창을 그릴 때만 목록을 부른다 — 열지 않은 창이 매번 자료를 받아 올 이유가 없다. */}
{open ? (
<div className="studio-asset-dialog__body">
<header>
<h2>본문에 넣을 자료</h2>
<button type="button" onClick={close}>
닫기
</button>
</header>
<AssetPicker
gateway={gateway}
onAssetsObserved={onAssetsObserved}
onInsert={(directive) => {
onInsert(directive);
close();
}}
/>
</div>
) : null}
</dialog>
</div>
);
}
@@ -3,7 +3,8 @@ import { useRef, useState } from "react";
import type { components } from "../../../contracts/studio/generated.ts";
import type { Asset, AssetKind } from "../../../contracts/studio/contract.ts";
import { useStudioAssetGateway } from "../use-studio.ts";
import { AssetPicker, buildEvidenceDirective } from "./asset-picker.tsx";
import { buildEvidenceDirective } from "./asset-picker.tsx";
import { AssetPickerDialog, countBodyAssets } from "./asset-picker-dialog.tsx";
import { AssetUploadDialog } from "./asset-upload-dialog.tsx";
import { MarkdownToolbar } from "./markdown-toolbar.tsx";
import { FieldNotice, type FieldIssue } from "./field-issues.tsx";
@@ -122,7 +123,7 @@ export function CaseFields({
Asset 업로드
</button>
</div>
<AssetPicker gateway={assetGateway} onAssetsObserved={onAssetsObserved} onInsert={insertDirective} />
<AssetPickerDialog gateway={assetGateway} usedCount={countBodyAssets(draft.bodyMarkdown)} onAssetsObserved={onAssetsObserved} onInsert={insertDirective} />
</div>
{uploadOpen ? (
<AssetUploadDialog
@@ -1,6 +1,7 @@
import type { components } from "../../../contracts/studio/generated.ts";
import type { WorkingCopyInput } from "../../../contracts/studio/contract.ts";
import { FieldNotice, type FieldIssue } from "./field-issues.tsx";
import { missingTopicIssue } from "../../../domain/content-format/project-public-render-model.ts";
import type { TopicVariantEdit } from "../../../contracts/management/contract.ts";
import { RelationEditor } from "./relation-editor.tsx";
@@ -49,6 +50,8 @@ export function CommonDocumentFields({
issues: readonly FieldIssue[];
onUpdate(patch: Partial<WorkingCopyInput>): void;
}) {
const missingTopic = missingTopicIssue(draft.topicId ?? null, topics);
return (
<section className="studio-editor-section" aria-labelledby="studio-common-fields-title">
<div className="studio-editor-section-heading"><p className="studio-eyebrow">DOCUMENT</p><h2 id="studio-common-fields-title">기본 정보</h2></div>
@@ -61,7 +64,15 @@ export function CommonDocumentFields({
남은 자리는 그 옆에 따로 보여 준다.
*/}
<div className="studio-field studio-field--wide"><label htmlFor="studio-field-summary">요약</label><textarea id="studio-field-summary" value={draft.summary} maxLength={SUMMARY_MAX} onChange={(event) => onUpdate({ summary: event.currentTarget.value })} /><span className="studio-char-count" aria-hidden="true" data-full={draft.summary.length >= SUMMARY_MAX ? "" : undefined}>목록 카드에는 약 {SUMMARY_CARD_PREVIEW}자까지 보입니다 · {draft.summary.length} / {SUMMARY_MAX}</span><FieldNotice issues={issues} path="/summary" /></div>
<label className="studio-field"><span>Topic</span><select value={draft.topicId ?? ""} onChange={(event) => onUpdate({ topicId: event.currentTarget.value || null })}><option value="">선택하지 않음</option>{topics.map((entry) => <option key={entry.id} value={entry.id}>{entry.label}</option>)}</select><FieldNotice issues={issues} path="/topicId" /></label>
{/*
고른 주제가 목록에 없을 수 있다 — 보관으로 내렸거나 지워진 주제다. 예전에는 그 상태가
미리보기를 통째로 죽여 UUID 만 보여 줬다. 지금은 미리보기가 살아 있으므로, 무엇이
잘못됐는지는 이 칸이 말해야 한다.
없는 값을 셀렉트에 임시 항목으로 남겨 둔다. 남기지 않으면 셀렉트가 「선택하지 않음」으로
보여서, 작성자는 고른 적 없는 주제 때문에 경고가 뜬다고 읽는다.
*/}
<label className="studio-field"><span>Topic</span><select value={draft.topicId ?? ""} onChange={(event) => onUpdate({ topicId: event.currentTarget.value || null })}><option value="">선택하지 않음</option>{missingTopic && draft.topicId ? <option value={draft.topicId}>목록에 없는 주제</option> : null}{topics.map((entry) => <option key={entry.id} value={entry.id}>{entry.label}</option>)}</select>{missingTopic ? <p className="studio-field-error" role="alert">{missingTopic}</p> : null}<FieldNotice issues={issues} path="/topicId" /></label>
<label className="studio-field"><span>Project</span><select value={draft.projectId ?? ""} onChange={(event) => onUpdate({ projectId: event.currentTarget.value || null })}><option value="">미지정</option>{projects.map((entry) => <option key={entry.id} value={entry.id}>{entry.label}</option>)}</select><FieldNotice issues={issues} path="/projectId" /></label>
</div>
{/*
@@ -3,7 +3,8 @@ import { useRef, useState } from "react";
import type { components } from "../../../contracts/studio/generated.ts";
import type { Asset, AssetKind } from "../../../contracts/studio/contract.ts";
import { useStudioAssetGateway } from "../use-studio.ts";
import { AssetPicker, buildEvidenceDirective } from "./asset-picker.tsx";
import { buildEvidenceDirective } from "./asset-picker.tsx";
import { AssetPickerDialog, countBodyAssets } from "./asset-picker-dialog.tsx";
import { AssetUploadDialog } from "./asset-upload-dialog.tsx";
import { MarkdownToolbar } from "./markdown-toolbar.tsx";
import { FieldNotice, type FieldIssue } from "./field-issues.tsx";
@@ -111,7 +112,7 @@ export function ConceptFields({
Asset 업로드
</button>
</div>
<AssetPicker gateway={assetGateway} onAssetsObserved={onAssetsObserved} onInsert={insertDirective} />
<AssetPickerDialog gateway={assetGateway} usedCount={countBodyAssets(draft.bodyMarkdown)} onAssetsObserved={onAssetsObserved} onInsert={insertDirective} />
</div>
{uploadOpen ? (
<AssetUploadDialog
@@ -3,7 +3,8 @@ import { useRef, useState } from "react";
import type { components } from "../../../contracts/studio/generated.ts";
import type { Asset, AssetKind } from "../../../contracts/studio/contract.ts";
import { useStudioAssetGateway } from "../use-studio.ts";
import { AssetPicker, buildEvidenceDirective } from "./asset-picker.tsx";
import { buildEvidenceDirective } from "./asset-picker.tsx";
import { AssetPickerDialog, countBodyAssets } from "./asset-picker-dialog.tsx";
import { AssetUploadDialog } from "./asset-upload-dialog.tsx";
import { MarkdownToolbar } from "./markdown-toolbar.tsx";
import { FieldNotice, type FieldIssue } from "./field-issues.tsx";
@@ -178,7 +179,7 @@ export function SetupFields({
Asset 업로드
</button>
</div>
<AssetPicker gateway={assetGateway} onAssetsObserved={onAssetsObserved} onInsert={insertDirective} />
<AssetPickerDialog gateway={assetGateway} usedCount={countBodyAssets(draft.bodyMarkdown)} onAssetsObserved={onAssetsObserved} onInsert={insertDirective} />
</div>
{uploadOpen ? (
<AssetUploadDialog
@@ -24,14 +24,18 @@ const activeRules: Readonly<Record<string, (path: string) => boolean>> =
/**
* 어느 일에 속한 화면인가.
*
* <p>여섯 자리가 같은 무게로 늘어서 있었다. 「작업본」과 「릴리즈」가 같은 크기로 나란하면
* 어디부터 봐야 하는지를 화면이 말해 주지 않는다 — 정보 구조가 평평해 보이는 것이 그 때문이다.
* <p>목적지 여섯이 같은 무게로 늘어서 있었다. 묶음 이름으로 구분선을 그어 봤지만, 처음 들어온
* 사람은 여전히 여섯 중 어디부터 가야 하는지를 스스로 판단해야 했다 — 나뉘어 보이는 것과 적어
* 보이는 것은 다르다.
*
* <p>글을 쓰는 일, 구조를 손보는 일, 자료를 관리하는 일, 내보내는 일 넷으로 묶는다. 계약이
* 이름과 순서를 갖고 있으므로 여기서는 묶음만 정한다 — `Record<…>` 라 계약에 탐색 항목이
* 늘면 컴파일러가 빈 자리를 잡는다.
* <p>위에는 네 가지 일만 둔다. 그 안의 화면은 그 일을 고른 뒤에 나타난다. 「자료」처럼 화면이
* 하나뿐인 일은 두 번 적지 않는다 — 묶음 이름과 그 안의 유일한 항목이 같은 말이면 목록만 길어진다.
*
* <p>`Record<…>` 라 계약에 탐색 항목이 늘면 컴파일러가 빈 자리를 잡는다.
*/
const GROUP_OF: Record<string, "작업" | "구조" | "자료" | "게시"> = {
type StudioGroup = "작업" | "구조" | "자료" | "게시";
const GROUP_OF: Record<string, StudioGroup> = {
TECH_LOG_STUDIO_DOCUMENTS: "작업",
TECH_LOG_STUDIO_DOCUMENT_NEW: "작업",
TECH_LOG_STUDIO_TAXONOMY: "구조",
@@ -40,40 +44,67 @@ const GROUP_OF: Record<string, "작업" | "구조" | "자료" | "게시"> = {
TECH_LOG_STUDIO_RELEASES: "게시",
};
const GROUP_ORDER = ["작업", "구조", "자료", "게시"] as const;
const GROUP_ORDER: ReadonlyArray<StudioGroup> = ["작업", "구조", "자료", "게시"];
/** 그 일을 고르면 먼저 열리는 화면. */
const GROUP_HOME: Record<StudioGroup, string> = {
작업: "/studio/documents",
구조: "/studio/taxonomy",
자료: "/studio/assets",
게시: "/studio/publications",
};
const navigation = techLogNavigation("STUDIO").map((entry) => ({
routeId: entry.routeId,
href: entry.path,
label: entry.label,
group: GROUP_OF[entry.routeId] ?? "작업",
active: activeRules[entry.routeId] ?? ((path: string) => path === entry.path),
}));
/** 지금 보고 있는 일. 어느 화면에도 걸리지 않으면(대시보드 등) 「작업」으로 둔다. */
function currentGroup(path: string): StudioGroup {
const match = navigation.find((item) => item.active(path));
return match?.group ?? "작업";
}
function StudioNavigation({
currentPath,
label,
}: Readonly<{ currentPath: string; label: string }>) {
const here = currentGroup(currentPath);
const inGroup = navigation.filter((item) => item.group === here);
return (
<nav aria-label={label}>
{GROUP_ORDER.map((group) => {
const items = navigation.filter((item) => item.group === group);
if (items.length === 0) return null;
return (
<span className="studio-nav-group" key={group}>
<span className="studio-nav-group-label">{group}</span>
{items.map((item) => (
<GuardedStudioLink
key={item.href}
href={item.href}
aria-current={item.active(currentPath) ? "page" : undefined}
>
{item.label}
</GuardedStudioLink>
))}
</span>
);
})}
<span className="studio-nav-group studio-nav-group--tail">
<span className="studio-nav-groups">
{GROUP_ORDER.map((group) => (
<GuardedStudioLink
key={group}
href={GROUP_HOME[group]}
aria-current={group === here ? "true" : undefined}
>
{group}
</GuardedStudioLink>
))}
</span>
{/*
그 일 안에 화면이 둘 이상일 때만 아래 줄을 그린다. 하나뿐이면 위의 이름이 곧 그 화면이라
같은 말이 두 번 나온다.
*/}
{inGroup.length > 1 ? (
<span className="studio-nav-children">
{inGroup.map((item) => (
<GuardedStudioLink
key={item.href}
href={item.href}
aria-current={item.active(currentPath) ? "page" : undefined}
>
{item.label}
</GuardedStudioLink>
))}
</span>
) : null}
<span className="studio-nav-tail">
<a href="/">공개 사이트 보기</a>
<StudioSessionAction />
</span>
@@ -298,3 +298,16 @@
.studio-app .studio-relation-filter { display: grid; gap: 5px; margin-bottom: 18px; }
.studio-app .studio-relation-filter > span { color: var(--muted); font-size: 12px; font-weight: 640; }
.studio-app .studio-relation-filter > small { color: var(--faint); font-size: 12px; }
/* 칸 수준의 오류 — 미리보기를 죽이는 대신 고칠 자리에서 말한다 */
.studio-app .studio-field-error { margin: 6px 0 0; color: #a13b31; font-size: 13px; line-height: 1.5; }
/* 자료는 고르러 들어가는 것이지 폼에 펼쳐 두는 것이 아니다 */
.studio-app .studio-asset-slot { display: flex; flex-wrap: wrap; gap: 10px 18px; align-items: center; }
.studio-app .studio-asset-slot__count { margin: 0; color: var(--muted); font-size: 14px; }
.studio-app .studio-asset-dialog { position: fixed; inset: 0; margin: auto; max-height: calc(100dvh - 40px); overflow: auto; width: min(680px, calc(100% - 40px)); padding: 0; border: 1px solid var(--line-strong); border-radius: 8px; background: var(--paper); color: var(--ink); }
.studio-app .studio-asset-dialog::backdrop { background: rgb(23 24 27 / 38%); }
.studio-app .studio-asset-dialog__body { padding: 24px 26px 28px; }
.studio-app .studio-asset-dialog__body > header { display: flex; align-items: baseline; justify-content: space-between; gap: 20px; padding-bottom: 16px; border-bottom: 1px solid var(--line); }
.studio-app .studio-asset-dialog__body > header h2 { margin: 0; font-size: 19px; font-weight: 650; }
.studio-app .studio-asset-dialog__body > header button { min-height: 40px; padding-inline: 2px; border: 0; background: none; color: var(--muted); font-weight: 600; }
@@ -441,16 +441,23 @@
탐색을 넷으로 묶는다 — 글을 쓰는 일, 구조를 손보는 일, 자료를 관리하는 일, 내보내는 일.
여섯 자리가 같은 무게로 늘어서 있으면 어디부터 봐야 하는지를 화면이 말해 주지 않는다.
*/
.studio-app .studio-nav-group { display: inline-flex; align-items: center; gap: 15px; }
.studio-app .studio-nav-group + .studio-nav-group { padding-left: 26px; border-left: 1px solid var(--line); }
.studio-app .studio-nav-group-label { color: var(--faint); font-size: 11px; font-weight: 650; letter-spacing: 0.07em; text-transform: uppercase; }
.studio-app .studio-nav-groups { display: inline-flex; align-items: center; gap: 22px; }
.studio-app .studio-nav-groups a { font-size: 15px; }
.studio-app .studio-nav-groups a[aria-current] { color: var(--ink); font-weight: 680; }
/* 고른 일 안의 화면들. 위의 네 이름보다 한 단 작게 두어 층이 보이게 한다. */
.studio-app .studio-nav-children { display: inline-flex; align-items: center; gap: 16px; padding-left: 22px; margin-left: 22px; border-left: 1px solid var(--line); }
.studio-app .studio-nav-children a { font-size: 13px; }
.studio-app .studio-nav-tail { display: inline-flex; align-items: center; gap: 16px; margin-left: auto; padding-left: 22px; }
.studio-app .studio-nav-tail a { font-size: 13px; }
.studio-app .studio-desktop-navigation nav,
.studio-app .studio-mobile-navigation nav { gap: 0; }
.studio-app .studio-mobile-navigation nav { gap: 0; width: 100%; }
@media (max-width: 899px) {
.studio-app .studio-mobile-navigation nav { flex-direction: column; align-items: flex-start; gap: 6px; }
.studio-app .studio-nav-group { width: 100%; flex-wrap: wrap; }
.studio-app .studio-nav-group + .studio-nav-group { padding-left: 0; padding-top: 10px; border-left: 0; border-top: 1px solid var(--line); }
.studio-app .studio-mobile-navigation nav { flex-direction: column; align-items: flex-start; gap: 10px; }
.studio-app .studio-nav-groups,
.studio-app .studio-nav-children,
.studio-app .studio-nav-tail { width: 100%; flex-wrap: wrap; margin-left: 0; padding-left: 0; border-left: 0; }
.studio-app .studio-nav-children { padding-top: 8px; border-top: 1px solid var(--line); }
}
/* 이어서 하기 — 보고보다 다음 한 걸음이 먼저다 */
@@ -448,6 +448,11 @@ test("inserts the directive at the saved cursor position and the live preview re
textarea.focus();
textarea.setSelectionRange(cursor, cursor);
/*
자료는 이제 폼에 펼쳐지지 않고 창 안에서 고른다 — 36개가 본문 아래에 전부 늘어서 있으면
글을 쓰는 화면이 자료 관리 화면이 된다. 고르기 전에 창을 연다.
*/
await user.click(await screen.findByRole("button", { name: "본문에 자료 넣기" }));
await user.click(await screen.findByRole("button", { name: /cursor-test-diagram/ }));
const expectedDirective = buildEvidenceDirective({
@@ -1810,12 +1815,20 @@ test("a Picker search never drops an already-inserted asset out of Instant Previ
);
await screen.findByLabelText("본문 Markdown");
/*
자료는 이제 폼에 펼쳐지지 않고 창 안에서 고른다 — 36개가 본문 아래에 전부 늘어서 있으면
글을 쓰는 화면이 자료 관리 화면이 된다. 고르기 전에 창을 연다.
*/
await user.click(await screen.findByRole("button", { name: "본문에 자료 넣기" }));
await user.click(await screen.findByRole("button", { name: /inserted-diagram/ }));
const body = (screen.getByLabelText("본문 Markdown") as HTMLTextAreaElement).value;
assert.ok(body.includes('key="inserted-diagram"'), body);
// Now search for something that excludes the asset just inserted. The Picker
// must narrow; the preview must not.
//
// 넣고 나면 창이 닫힌다 — 넣은 뒤 목록 앞에 남아 있을 이유가 없다. 다시 연다.
await user.click(await screen.findByRole("button", { name: "본문에 자료 넣기" }));
await user.type(screen.getByLabelText("Asset 검색"), "other");
await user.click(screen.getByRole("button", { name: "검색" }));
const picker = screen.getByRole("group", { name: "본문에 Asset 삽입" });
@@ -0,0 +1,90 @@
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();
});
});
@@ -92,25 +92,19 @@ describe("TechLog Studio shell", () => {
(link) => [link.textContent, link.getAttribute("href")],
),
/*
탐색은 넷으로 묶인다 — 글을 쓰는 일, 구조를 손보는 일, 자료를 관리하는 일, 내보내는 일.
여섯 자리가 같은 무게로 늘어서 있으면 어디부터 봐야 하는지를 화면이 말해 주지 않는다.
항목과 주소는 계약이 정하고 여기서는 묶음 순서만 바뀐다.
위에는 네 가지 일만 둔다. 목적지 여섯이 같은 무게로 늘어서 있으면, 묶음 이름으로 선을
그어도 처음 들어온 사람은 여섯 중 어디부터 가야 하는지를 스스로 판단해야 한다.
그 일 안의 화면은 일을 고른 뒤에 나타난다 — 여기서는 「작업」에 있으므로 작업본과 새 문서다.
*/
).toEqual([
["작업", "/studio/documents"],
["구조", "/studio/taxonomy"],
["자료", "/studio/assets"],
["게시", "/studio/publications"],
["작업본", "/studio/documents"],
["새 문서", "/studio/documents/new"],
["주제·프로젝트", "/studio/taxonomy"],
["Asset", "/studio/assets"],
["게시 기록", "/studio/publications"],
["릴리즈", "/studio/releases"],
["공개 사이트 보기", "/"],
]);
expect(
Array.from(
container.querySelectorAll(".studio-desktop-navigation .studio-nav-group-label"),
(label) => label.textContent,
),
).toEqual(["작업", "구조", "자료", "게시"]);
expect(screen.getByRole("link", { name: "공개 사이트 보기" })).toHaveAttribute("href", "/");
expect(screen.queryByText(/로그인|sign in/i)).not.toBeInTheDocument();