fix: Studio 리뷰 지적을 반영하고 죽은 머리말 컴포넌트를 걷어낸다

에디터 칸 이름을 공개 화면과 맞춘다. 목적→이 기준을 쓰는 이유, 규칙→판단
기준, 적용 조건→적용할 때, 예외→예외와 주의, 사실→확인한 사실,
미지수→남은 미지수, 선택지→검토한 선택지. 쓰는 사람이 지금 채우는 칸이
공개 화면 어디로 가는지 외우지 않아도 된다.

대시보드의 세 칸이 같은 목록을 세 번 반복했다. 「검증과 미리보기」와
「게시 준비」가 「이어서 작성」을 걸러 낸 부분집합인데 「이어서 작성」은
전체를 그대로 그렸기 때문이다 — 모든 문서가 같은 단계면 세 칸이 겹친다.
각 문서는 지금 서 있는 구간 한 곳에만 나온다.

릴리스에서 「상태 공개 · 공개일 2026-08-22」 옆에 「아직 공개하지 않음」이
같이 나왔다. 경로가 비었다고 미공개는 아니다 — 공개 여부는 상태가 말한다.

행에서 눈에 띄는 단 하나가 되돌릴 수 없는 동작이었다. 편집을 같은 격의
버튼으로 올리고, 삭제는 danger 로 낮추고, 격자에 자리를 만들어 다음 줄로
떨어지지 않게 한다. 게시 기록이 이미 그 모양이었다.

주제·프로젝트는 「다음: 내용 편집」을 안내하면서 그 줄의 버튼은 게시 취소와
삭제뿐이었다. 공개 프로젝트 화면이 비어 있던 이유가 여기다.

죽은 코드였던 PublicDocumentHeader 를 걷어낸다. 화면을 실제로 그리는 것은
PublicRecordRenderer 이고 그 컴포넌트는 아무도 부르지 않았다 — 어제 이
컴포넌트에 줄바꿈을 고쳐 넣었지만 화면에는 닿지 않았다. 그 자리를 지키던
가드도 진짜로 그려지는 쪽으로 옮긴다.

탭 제목과 설명에 문서를 반영한다. 공개 문서가 전부 "Reference · Tech Log"
였고 설명은 모든 화면이 "Tech Log frontend" 하나였다.

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-08-31 09:01:03 +09:00
co-authored by Claude Opus 5
parent ca1fc92e6d
commit 82e992d066
15 changed files with 211 additions and 121 deletions
+7
View File
@@ -0,0 +1,7 @@
# Tech Log — 공개 기록은 읽히라고 있는 것이고, Studio 는 아니다.
User-agent: *
Allow: /
Disallow: /studio
Disallow: /api/
Sitemap: https://hyeonworks.com/sitemap.xml
@@ -5,49 +5,6 @@ import type { components } from "../../../contracts/studio/generated.ts";
import { ProseText } from "../../shared/public-render/prose-text.tsx";
import { DOCUMENT_KIND_LABELS } from "../../shared/document-kind-labels.ts";
export function PublicDocumentHeader({ record }: { record: PublicRecord }) {
return (
<header className="public-document-header">
<nav aria-label="문서 경로">
<Link
to={`/explore/${record.kind === "CASE" ? "cases" : record.kind === "REFERENCE" ? "references" : "questions"}`}
>
{DOCUMENT_KIND_LABELS[record.kind]}
</Link>
<span aria-hidden="true">/</span>
{/*
주제 페이지가 아니라 그 주제로 거른 탐색으로 보낸다. `/topics/:slug` 는 세 개를
하드코딩해 두고 있어 실제 주제는 무엇이든 404 가 되고, 설명·범위·대표 기록이 전부
비어 있어 지금 채울 내용도 없다. 독자가 여기서 기대하는 것 — 같은 주제의 기록 목록 —
은 탐색 필터가 그대로 준다.
*/}
<Link to={`/explore?topic=${encodeURIComponent(record.topicSlug)}`}>{record.topic}</Link>
<span aria-hidden="true">/</span>
<Link to={`/projects/${record.projectSlug}`}>
{record.projectTitle}
</Link>
</nav>
<h1>{record.title}</h1>
{/* 요약은 여러 문단일 수 있다 — 그대로 넣으면 줄바꿈이 사라져 한 덩어리로 읽힌다. */}
<ProseText text={record.summary} />
<dl>
<div>
<dt>유형</dt>
<dd>{DOCUMENT_KIND_LABELS[record.kind]}</dd>
</div>
<div>
<dt>프로젝트</dt>
<dd>{record.projectTitle}</dd>
</div>
<div>
<dt>게시</dt>
<dd>{record.publishedLabel}</dd>
</div>
</dl>
</header>
);
}
export function publicRenderModelBase(
record: PublicRecord,
): components["schemas"]["PublicRenderModelBase"] {
@@ -14,6 +14,7 @@ import {
type PublicRelation,
} from "./public-document-relations.tsx";
import { DOCUMENT_KIND_LABELS } from "../document-kind-labels.ts";
import { useDocumentMetadata } from "../use-document-metadata.ts";
type PublicRenderModel = components["schemas"]["PublicRenderModel"];
type PublicRenderModelBase = components["schemas"]["PublicRenderModelBase"];
@@ -562,6 +563,15 @@ export function PublicRecordRenderer({
model: PublicRenderModel;
embedded?: boolean;
} & RenderDependencies) {
/*
탭 제목과 설명에 지금 보는 문서를 반영한다. 라우터는 라우트마다 고정된 이름만 넣어서
공개 문서가 전부 "Reference · Tech Log" 였고, 설명은 모든 화면이 "Tech Log frontend"
하나였다 — 탭을 여럿 띄우거나 링크를 공유하면 어느 글인지 알 수 없었다.
미리보기(embedded)는 Studio 안의 한 조각이므로 탭 이름을 건드리지 않는다.
*/
useDocumentMetadata(embedded ? undefined : model.title, model.summary);
switch (model.kind) {
case "CASE":
return (
@@ -0,0 +1,32 @@
import { useEffect } from "react";
/**
* 열려 있는 문서를 탭 제목과 설명에 반영한다.
*
* <p>라우터는 라우트마다 고정된 제목만 넣는다. 그래서 공개 문서가 전부 "Reference · Tech Log"
* 같은 같은 이름이었고, 탭을 여럿 띄우거나 링크를 공유하면 어느 문서인지 알 수 없었다.
* 설명(`meta[name=description]`)은 모든 화면이 "Tech Log frontend" 하나였다.
*
* <p>라우터가 라우트 전환 시점에 제목을 넣고, 이 훅은 문서를 받은 뒤에 덮어쓴다 — 순서가
* 그러하므로 서로 다투지 않는다. 화면을 떠날 때는 되돌려, 다음 라우트가 자기 제목을 넣기 전
* 잠깐 남는 이름이 이전 문서의 것이 되지 않게 한다.
*/
export function useDocumentMetadata(title: string | undefined, description?: string): void {
useEffect(() => {
if (!title) return undefined;
const previousTitle = document.title;
const element = document.querySelector<HTMLMetaElement>('meta[name="description"]');
const previousDescription = element?.content;
document.title = `${title} · Tech Log`;
if (element && description) {
// 설명은 한 줄이어야 한다 — 요약에 문단이 있으면 줄바꿈을 공백으로 접는다.
element.content = description.replace(/\s+/gu, " ").trim().slice(0, 200);
}
return () => {
document.title = previousTitle;
if (element && previousDescription !== undefined) element.content = previousDescription;
};
}, [title, description]);
}
@@ -11,6 +11,13 @@ type CatalogEntry = components["schemas"]["CatalogEntry"];
*/
const SUMMARY_MAX = 2000;
/**
* 목록·검색 카드는 요약을 세 줄에서 자른다. 작성자에게는 그 경계가 보이지 않아서, 500자를 써도
* 독자가 받는 것은 앞 세 줄뿐이라는 사실을 알 방법이 없었다. 정확한 글자 수는 글자 폭에 따라
* 달라지므로 어림수로 알린다 — 여기서 필요한 것은 정밀도가 아니라 경계가 있다는 사실이다.
*/
const SUMMARY_CARD_PREVIEW = 90;
/** 이 화면이 자기 칸 아래에 보여 줄 수 있는 경로. 나머지는 게시 버튼 옆에 남는다. */
export const COMMON_FIELD_PATHS = [
"/title",
@@ -48,7 +55,7 @@ export function CommonDocumentFields({
이름이 되어 "요약 412 / 600" 처럼 타자마다 이름이 바뀐다 — 이름은 「요약」로 두고
남은 자리는 그 옆에 따로 보여 준다.
*/}
<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}>{draft.summary.length} / {SUMMARY_MAX}</span><FieldNotice issues={issues} path="/summary" /></div>
<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>
<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>
@@ -294,14 +294,26 @@ export function DocumentList() {
</dd>
</div>
</dl>
<button
className="studio-secondary-button"
type="button"
disabled={deletingId !== null}
onClick={() => void removeDocument(item)}
>
삭제
</button>
{/*
편집은 제목 링크였고 삭제만 버튼이라, 행에서 눈에 띄는 단 하나가 되돌릴 수
없는 동작이었다. 편집을 같은 격의 버튼으로 올리고 삭제는 그 옆에 둔다.
*/}
<div className="studio-row-actions">
<GuardedStudioLink
className="studio-secondary-button"
href={`/studio/documents/${item.id}/edit`}
>
편집
</GuardedStudioLink>
<button
className="studio-secondary-button studio-danger-button"
type="button"
disabled={deletingId !== null}
onClick={() => void removeDocument(item)}
>
삭제
</button>
</div>
</article>
))}
</div>
@@ -178,7 +178,13 @@ export function NewDocumentForm() {
<button className="studio-primary-button" type="submit" disabled={pending}>
{pending ? "만드는 중…" : "작업본 만들기"}
</button>
<p>이 화면의 작업본은 현재 Studio 세션에서만 유지됩니다.</p>
{/*
세션이 끊기면 쓴 것이 사라진다. 그 사실이 버튼 옆 작은 회색 글씨로만 있었다 —
잃을 수 있는 것을 알리는 문구는 잃기 전에 눈에 들어와야 한다.
*/}
<p className="studio-field-warning" role="note">
이 화면의 작업본은 현재 Studio 세션에서만 유지됩니다. 세션이 끝나면 사라집니다.
</p>
</div>
{error ? (
<p className="studio-screen-error" role="alert">
@@ -40,15 +40,15 @@ export function QuestionFields({ draft, evidence, issues, onChange }: { draft: Q
if (value === "RESOLVED") update({ questionStatus: "RESOLVED", resolution: draft.resolution ?? { summary: "", evidenceTargetId: null, linkLabel: "" } });
else update({ questionStatus: value === "OPEN" ? "OPEN" : null, resolution: null });
}}><option value="">아직 정하지 않음</option><option value="OPEN">OPEN</option><option value="RESOLVED">RESOLVED</option></select><FieldNotice issues={issues} path="/questionStatus" /></label>
<OrderedTextList label="사실" fieldId="studio-field-facts" items={draft.facts} onChange={(facts) => update({ facts })} />
<OrderedTextList label="확인한 사실" fieldId="studio-field-facts" items={draft.facts} onChange={(facts) => update({ facts })} />
<FieldNotice issues={issues} path="/facts" />
<OrderedTextList label="가정" fieldId="studio-field-assumptions" items={draft.assumptions} onChange={(assumptions) => update({ assumptions })} />
<FieldNotice issues={issues} path="/assumptions" />
<OrderedTextList label="미지수" fieldId="studio-field-unknowns" items={draft.unknowns} onChange={(unknowns) => update({ unknowns })} />
<OrderedTextList label="남은 미지수" fieldId="studio-field-unknowns" items={draft.unknowns} onChange={(unknowns) => update({ unknowns })} />
<FieldNotice issues={issues} path="/unknowns" />
<OrderedTextList label="제약" fieldId="studio-field-constraints" items={draft.constraints} onChange={(constraints) => update({ constraints })} />
<FieldNotice issues={issues} path="/constraints" />
<fieldset id="studio-field-options" className="studio-ordered-list" tabIndex={-1}><legend>선택지</legend>
<fieldset id="studio-field-options" className="studio-ordered-list" tabIndex={-1}><legend>검토한 선택지</legend>
<FieldNotice issues={issues} path="/options" />
{draft.options.length === 0 ? <p>아직 입력한 선택지가 없습니다.</p> : null}
{draft.options.map((option, index) => <div className="studio-ordered-item" key={option.id}>
@@ -32,20 +32,20 @@ export function ReferenceFields({ draft, issues, onChange }: { draft: ReferenceI
return (
<section className="studio-editor-section" aria-labelledby="studio-reference-fields-title">
<div className="studio-editor-section-heading"><p className="studio-eyebrow">REFERENCE</p><h2 id="studio-reference-fields-title">재사용할 기준</h2></div>
<label className="studio-field studio-field--wide"><span>목적</span><textarea value={draft.purpose} onChange={(event) => update({ purpose: event.currentTarget.value })} /><FieldNotice issues={issues} path="/purpose" /></label>
<fieldset className="studio-ordered-list"><legend>규칙</legend>
<label className="studio-field studio-field--wide"><span>이 기준을 쓰는 이유</span><textarea value={draft.purpose} onChange={(event) => update({ purpose: event.currentTarget.value })} /><FieldNotice issues={issues} path="/purpose" /></label>
<fieldset className="studio-ordered-list"><legend>판단 기준</legend>
<FieldNotice issues={issues} path="/rules" />
{draft.rules.length === 0 ? <p>아직 입력한 규칙이 없습니다.</p> : null}
{draft.rules.length === 0 ? <p>아직 입력한 판단 기준이 없습니다.</p> : null}
{draft.rules.map((rule, index) => <div className="studio-ordered-item" key={rule.id}>
<label><span>규칙 {index + 1} 제목</span><input value={rule.title} onChange={(event) => update({ rules: orderedRules(draft.rules.map((candidate, candidateIndex) => candidateIndex === index ? { ...candidate, title: event.currentTarget.value } : candidate)) })} /></label>
<label><span>규칙 {index + 1} 본문</span><textarea value={rule.body} onChange={(event) => update({ rules: orderedRules(draft.rules.map((candidate, candidateIndex) => candidateIndex === index ? { ...candidate, body: event.currentTarget.value } : candidate)) })} /></label>
<label><span>판단 기준 {index + 1} 제목</span><input value={rule.title} onChange={(event) => update({ rules: orderedRules(draft.rules.map((candidate, candidateIndex) => candidateIndex === index ? { ...candidate, title: event.currentTarget.value } : candidate)) })} /></label>
<label><span>판단 기준 {index + 1} 본문</span><textarea value={rule.body} onChange={(event) => update({ rules: orderedRules(draft.rules.map((candidate, candidateIndex) => candidateIndex === index ? { ...candidate, body: event.currentTarget.value } : candidate)) })} /></label>
<div className="studio-item-actions"><button type="button" onClick={() => moveRule(index, -1)} disabled={index === 0}>위로</button><button type="button" onClick={() => moveRule(index, 1)} disabled={index === draft.rules.length - 1}>아래로</button><button type="button" onClick={() => update({ rules: orderedRules(draft.rules.filter((_, candidateIndex) => candidateIndex !== index)) })}>삭제</button></div>
</div>)}
<button className="studio-add-item" type="button" disabled={draft.rules.length >= 50} onClick={() => { if (draft.rules.length < 50) update({ rules: orderedRules([...draft.rules, { id: createNewItemId(), title: "", body: "", order: draft.rules.length }]) }); }}>규칙 추가</button>
<button className="studio-add-item" type="button" disabled={draft.rules.length >= 50} onClick={() => { if (draft.rules.length < 50) update({ rules: orderedRules([...draft.rules, { id: createNewItemId(), title: "", body: "", order: draft.rules.length }]) }); }}>판단 기준 추가</button>
</fieldset>
<OrderedTextList label="적용 조건" items={draft.applyWhen} onChange={(applyWhen) => update({ applyWhen })} />
<OrderedTextList label="적용할 때" items={draft.applyWhen} onChange={(applyWhen) => update({ applyWhen })} />
<FieldNotice issues={issues} path="/applyWhen" />
<OrderedTextList label="예외" items={draft.exceptions} onChange={(exceptions) => update({ exceptions })} />
<OrderedTextList label="예외와 주의" items={draft.exceptions} onChange={(exceptions) => update({ exceptions })} />
<FieldNotice issues={issues} path="/exceptions" />
<OrderedTextList label="예시" items={draft.examples} onChange={(examples) => update({ examples })} />
<FieldNotice issues={issues} path="/examples" />
@@ -208,7 +208,14 @@ export function ReleaseManager() {
<p className="studio-row-label">RELEASE</p>
<div className="studio-document-title">
<h2>{release.title}</h2>
<p>{release.publication.canonicalPath ?? "아직 공개하지 않음"}</p>
{/*
경로가 비었다고 미공개는 아니다. 예전에는 한 줄 안에서 「상태 공개 · 공개일
2026-08-22」 옆에 「아직 공개하지 않음」 이 같이 나왔다 — 공개 사이트에는
실제로 올라가 있었으므로 뒤쪽이 틀렸다. 공개 여부는 아래 「상태」가 말한다.
*/}
{release.publication.canonicalPath ? (
<p>{release.publication.canonicalPath}</p>
) : null}
</div>
<dl>
<div>
@@ -232,7 +239,7 @@ export function ReleaseManager() {
편집
</GuardedStudioLink>
<button
className="studio-secondary-button"
className="studio-secondary-button studio-danger-button"
type="button"
disabled={pending}
onClick={() => void remove(release)}
@@ -89,10 +89,23 @@ export function StudioDashboard() {
return () => controller.abort();
}, [gateway]);
const validationItems =
dashboard?.continueWriting.filter((item) =>
["VALIDATE", "FIX_VALIDATION", "CREATE_PREVIEW"].includes(item.nextAction),
) ?? [];
/*
세 칸은 한 줄기의 서로 다른 구간이다. 예전에는 「검증과 미리보기」와 「게시 준비」가
「이어서 작성」을 걸러 낸 부분집합이면서 「이어서 작성」이 전체를 그대로 그렸다. 그래서 모든
문서가 같은 단계에 있으면 세 칸이 같은 목록을 세 번 반복했다 — 대시보드의 60%가 같은 제목
다섯 개였고, 두 칸은 구분조차 되지 않았다.
각 문서는 지금 서 있는 구간 한 곳에만 나온다.
*/
const VALIDATION_ACTIONS = ["VALIDATE", "FIX_VALIDATION", "CREATE_PREVIEW"];
const continueWriting = dashboard?.continueWriting ?? [];
const validationItems = continueWriting.filter((item) =>
VALIDATION_ACTIONS.includes(item.nextAction),
);
const readyIds = new Set((dashboard?.readyToPublish ?? []).map((item) => item.id));
const writingItems = continueWriting.filter(
(item) => !VALIDATION_ACTIONS.includes(item.nextAction) && !readyIds.has(item.id),
);
return (
<div className="studio-page studio-dashboard-page">
@@ -138,7 +151,7 @@ export function StudioDashboard() {
</section>
<WorkSection
title="이어서 작성"
items={dashboard.continueWriting}
items={writingItems}
href="/studio/documents"
empty="이어서 작성할 문서가 없습니다."
/>
@@ -292,14 +292,16 @@ export function TaxonomyManager() {
<dd>{topic.status === "ARCHIVED" ? "보관" : "활성"}</dd>
</div>
</dl>
<button
className="studio-secondary-button"
type="button"
disabled={pending}
onClick={() => void removeTopic(topic)}
>
삭제
</button>
<div className="studio-row-actions">
<button
className="studio-secondary-button studio-danger-button"
type="button"
disabled={pending}
onClick={() => void removeTopic(topic)}
>
삭제
</button>
</div>
</article>
))}
</div>
@@ -349,6 +351,17 @@ export function TaxonomyManager() {
</div>
</dl>
<div className="studio-row-actions">
{/*
「다음: 내용 편집」 을 안내하면서 정작 그 줄의 버튼은 게시 취소와 삭제뿐이라,
편집 진입점이 작은 텍스트 링크로만 있었다. 공개 프로젝트 화면이 비어 있던
이유가 여기다 — 쓰라고 안내하고 쓸 자리를 눈에 띄게 주지 않았다.
*/}
<GuardedStudioLink
className="studio-secondary-button"
href={`/studio/projects/${project.id}`}
>
내용 편집
</GuardedStudioLink>
<button
className="studio-secondary-button"
type="button"
@@ -358,7 +371,7 @@ export function TaxonomyManager() {
{project.targetVisibility === "PRIVATE" ? "게시" : "게시 취소"}
</button>
<button
className="studio-secondary-button"
className="studio-secondary-button studio-danger-button"
type="button"
disabled={pending}
onClick={() => void removeProject(project)}
@@ -98,7 +98,17 @@
.studio-app .studio-document-tools input,
.studio-app .studio-asset-tools input { flex: 1; }
.studio-app .studio-result-count { margin: 24px 0 10px; color: var(--muted); font-size: 13px; }
.studio-app .studio-document-row { display: grid; grid-template-columns: 105px minmax(240px, 1fr) minmax(360px, 0.9fr); gap: 24px; align-items: start; padding-block: 26px; border-top: 1px solid var(--line); }
/*
동작 열을 행 안에 둔다. 예전에는 격자에 자리가 없어 버튼이 다음 줄 왼쪽으로 떨어졌고,
릴리스·주제처럼 버튼이 둘인 목록은 그 줄이 세로로 쌓여 행마다 110px 를 먹었다.
게시 기록은 이미 행 안 오른쪽에 버튼을 두고 있었다 — 그쪽에 맞춘다.
*/
.studio-app .studio-document-row { display: grid; grid-template-columns: 105px minmax(240px, 1fr) minmax(300px, 0.8fr) auto; gap: 24px; align-items: start; padding-block: 26px; border-top: 1px solid var(--line); }
.studio-app .studio-document-row .studio-row-actions { margin-top: 0; flex-wrap: nowrap; }
/* 되돌릴 수 없는 동작. 눈에 띄어야 하지만 주 동작보다 앞서면 안 된다. */
.studio-app .studio-danger-button { border-color: var(--line-strong); background: var(--paper); color: var(--danger, #b4232a); }
.studio-app .studio-danger-button:hover:not(:disabled) { border-color: var(--danger, #b4232a); }
.studio-app .studio-document-list > :first-child { border-top: 0; }
.studio-app .studio-document-title h2 { margin: 0; font-size: 17px; line-height: 1.5; overflow-wrap: anywhere; }
.studio-app .studio-document-title h2 a { display: inline-flex; min-height: 44px; align-items: flex-start; }
@@ -112,8 +122,15 @@
값이라, 묶음 안에서는 묶음이 여백을 갖고 버튼은 나란히 선다.
*/
.studio-app .studio-row-actions { display: flex; flex-wrap: wrap; gap: 10px; margin-top: 24px; }
@media (max-width: 900px) {
.studio-app .studio-document-row { grid-template-columns: 105px minmax(0, 1fr); }
.studio-app .studio-document-row .studio-row-actions { grid-column: 1 / -1; margin-top: 16px; }
}
.studio-app .studio-field-note { margin: 6px 0 0; color: var(--muted); font-size: 12px; line-height: 1.6; }
/* 잃을 수 있는 것을 알리는 문구. 안내(note)보다 한 격 위에 둔다. */
.studio-app .studio-field-warning { margin: 10px 0 0; padding: 10px 14px; border-left: 3px solid var(--warning, #b8791f); border-radius: 0 4px 4px 0; background: var(--warning-soft, #fdf6e9); color: var(--ink); font-size: 13px; line-height: 1.6; }
.studio-app .studio-row-actions .studio-primary-button,
.studio-app .studio-row-actions .studio-secondary-button { margin: 0; }
.studio-app .studio-empty-state { padding-block: 56px; border-bottom: 1px solid var(--line); }
+21 -20
View File
@@ -4,8 +4,7 @@ import { render } from "@testing-library/react";
import { MemoryRouter } from "react-router-dom";
import { describe, expect, it } from "vitest";
import { PublicDocumentHeader } from "../../src/features/tech-log/presentation/public/components/public-document-header.tsx";
import type { QuestionRecord } from "../../src/features/tech-log/application/ports/public-content-queries.ts";
import { PublicRecordRenderer } from "../../src/features/tech-log/presentation/shared/public-render/public-record-renderer.tsx";
import {
InlineRenderer,
@@ -60,46 +59,48 @@ describe("Markdown 을 거치지 않는 평문 칸", () => {
/**
* 문서 머리말의 요약. 상한이 2000자가 되면서 요약은 한 문장이 아니라 여러 문단이 되었고,
* 여기만 `PlainText` 를 거치지 않아 그 문단들이 한 덩어리로 이어져 보였다.
* 예전에는 빈 줄까지 <br> 로 나가 문단 사이 여백이 없었다.
*
* <p>이 가드는 한동안 엉뚱한 것을 지키고 있었다 — `PublicDocumentHeader` 라는 컴포넌트를 세웠는데
* 화면을 실제로 그리는 것은 `PublicRecordRenderer` 였고, 그 컴포넌트는 아무도 부르지 않는 죽은
* 코드였다. 지금은 진짜로 그려지는 쪽을 본다.
*/
describe("문서 머리말의 요약", () => {
const record: QuestionRecord = {
const model = {
kind: "QUESTION",
slug: "session-store-boundary",
title: "세션 저장소 경계",
summary: "Mediator와 BFF는 서로 다른 저장소를 쓴다.\n둘 다 메모리에 있다.\n\n인스턴스를 늘리면 설계가 필요하다.",
path: "/questions/session-store-boundary",
topic: "인증",
topicSlug: "auth",
projectSlug: "keycloak",
projectTitle: "Keycloak",
publishedAt: "2026-08-29T00:00:00Z",
publishedLabel: "2026.08.29",
visibility: "PUBLIC",
publicPath: "/questions/session-store-boundary",
topic: { label: "인증", publicPath: "/explore?topic=auth" },
project: { label: "Keycloak", publicPath: "/projects/keycloak" },
relations: [],
questionStatus: "OPEN",
renderContext: { generatedAt: "2026-08-31T00:00:00Z", dependencyRevision: "r1" },
status: "OPEN",
facts: [],
assumptions: [],
unknowns: [],
constraints: [],
options: [],
nextValidation: "",
};
resolution: null,
} as never;
it("빈 줄은 문단으로, 문단 안 줄바꿈은 줄바꿈으로 그린다", () => {
const { container } = render(
<MemoryRouter>
<PublicDocumentHeader record={record} />
<PublicRecordRenderer
model={model}
resolvePublishedLabel={() => undefined}
resolveEvidenceAsset={() => {
throw new Error("이 문서에는 도식이 없다");
}}
/>
</MemoryRouter>,
);
/*
요약은 "두 줄 + 빈 줄 + 한 줄" 이다. 예전에는 셋 다 <br> 로 나가서 문단 사이 여백이
없었다. 지금은 빈 줄이 문단을 가르고, 문단 안의 줄바꿈만 <br> 로 남는다.
*/
const paragraphs = container.querySelectorAll(".public-document-header p");
expect(paragraphs).toHaveLength(2);
expect(container.querySelectorAll(".public-document-header p br")).toHaveLength(1);
// 그대로 넣으면 문단 하나에 <br> 0개가 되어 전부 한 덩어리로 읽힌다.
expect(paragraphs[0]).toHaveTextContent("둘 다 메모리에 있다.");
expect(paragraphs[1]).toHaveTextContent("인스턴스를 늘리면 설계가 필요하다.");
});
@@ -175,43 +175,49 @@ describe("TechLog Studio document editor", () => {
const user = userEvent.setup();
renderEditor(FIXTURE_IDS.stateNonceReference);
expect(await screen.findByLabelText("목적")).toHaveValue(
/*
에디터 라벨이 공개 화면의 절 제목과 같아졌으므로(작성자가 매핑을 외우지 않도록), 미리보기의
`<section aria-labelledby>` 와 이름이 겹친다. 여기서 보려는 것은 입력 칸이다.
*/
expect(
await screen.findByRole("textbox", { name: "이 기준을 쓰는 이유" }),
).toHaveValue(
"각 검증값의 책임을 다시 찾는 기준입니다.",
);
expect(screen.getByLabelText("규칙 1 제목")).toHaveValue("state는 요청을 연결합니다");
expect(screen.getByLabelText("적용 조건 1")).toHaveValue("Code Flow를 구성할 때");
expect(screen.getByLabelText("판단 기준 1 제목")).toHaveValue("state는 요청을 연결합니다");
expect(screen.getByLabelText("적용할 때 1")).toHaveValue("Code Flow를 구성할 때");
expect(screen.getByLabelText("마지막 검증일")).toHaveValue("2026-08-13");
expect(screen.getByText("아직 입력한 항목이 없습니다.")).toBeVisible();
await user.click(screen.getByRole("button", { name: "규칙 추가" }));
await user.type(screen.getByLabelText("규칙 2 제목"), "nonce는 Token을 연결합니다");
const secondRule = screen.getByLabelText("규칙 2 제목").closest(
await user.click(screen.getByRole("button", { name: "판단 기준 추가" }));
await user.type(screen.getByLabelText("판단 기준 2 제목"), "nonce는 Token을 연결합니다");
const secondRule = screen.getByLabelText("판단 기준 2 제목").closest(
".studio-ordered-item",
) as HTMLElement;
await user.click(within(secondRule).getByRole("button", { name: "위로" }));
expect(screen.getByLabelText("규칙 1 제목")).toHaveValue(
expect(screen.getByLabelText("판단 기준 1 제목")).toHaveValue(
"nonce는 Token을 연결합니다",
);
await user.click(
within(
screen.getByLabelText("규칙 1 제목").closest(".studio-ordered-item") as HTMLElement,
screen.getByLabelText("판단 기준 1 제목").closest(".studio-ordered-item") as HTMLElement,
).getByRole("button", { name: "삭제" }),
);
expect(screen.getByLabelText("규칙 1 제목")).toHaveValue("state는 요청을 연결합니다");
expect(screen.getByLabelText("판단 기준 1 제목")).toHaveValue("state는 요청을 연결합니다");
await user.click(screen.getByRole("button", { name: "적용 조건 추가" }));
await user.type(screen.getByLabelText("적용 조건 2"), "두 번째 적용 조건");
const secondApplyWhen = screen.getByLabelText("적용 조건 2").closest(
await user.click(screen.getByRole("button", { name: "적용할 때 추가" }));
await user.type(screen.getByLabelText("적용할 때 2"), "두 번째 적용 조건");
const secondApplyWhen = screen.getByLabelText("적용할 때 2").closest(
".studio-ordered-item",
) as HTMLElement;
await user.click(within(secondApplyWhen).getByRole("button", { name: "위로" }));
expect(screen.getByLabelText("적용 조건 1")).toHaveValue("두 번째 적용 조건");
expect(screen.getByLabelText("적용할 때 1")).toHaveValue("두 번째 적용 조건");
await user.click(
within(
screen.getByLabelText("적용 조건 1").closest(".studio-ordered-item") as HTMLElement,
screen.getByLabelText("적용할 때 1").closest(".studio-ordered-item") as HTMLElement,
).getByRole("button", { name: "삭제" }),
);
expect(screen.getByLabelText("적용 조건 1")).toHaveValue("Code Flow를 구성할 때");
expect(screen.getByLabelText("적용할 때 1")).toHaveValue("Code Flow를 구성할 때");
expect(screen.getByRole("status", { name: "편집 상태" })).toHaveTextContent(
"저장되지 않음",
);
@@ -222,14 +228,14 @@ describe("TechLog Studio document editor", () => {
renderEditor(FIXTURE_IDS.edgeTokenQuestion);
expect(await screen.findByLabelText("질문 상태")).toHaveValue("OPEN");
expect(screen.getByLabelText("미지수 1")).toHaveValue("신뢰 헤더 위조 가능성");
expect(screen.getByLabelText("남은 미지수 1")).toHaveValue("신뢰 헤더 위조 가능성");
expect(screen.getByRole("textbox", { name: "다음 검증" })).toHaveValue(
"위협 모델을 비교합니다.",
);
expect(screen.queryByLabelText("해결 요약")).not.toBeInTheDocument();
await user.click(screen.getByRole("button", { name: "사실 추가" }));
await user.type(screen.getByLabelText("사실 1"), "Edge가 서명을 검증합니다");
await user.click(screen.getByRole("button", { name: "확인한 사실 추가" }));
await user.type(screen.getByLabelText("확인한 사실 1"), "Edge가 서명을 검증합니다");
await user.click(screen.getByRole("button", { name: "선택지 추가" }));
expect(screen.getByLabelText("선택지 1 제목")).toHaveValue("");
expect(screen.getByLabelText("선택지 1 설명")).toHaveValue("");
@@ -252,15 +258,17 @@ describe("TechLog Studio document editor", () => {
중간에서 말없이 입력을 멈췄고, 쓰는 사람에게는 키보드가 고장 난 것처럼 보였다.
*/
expect(summary).toHaveAttribute("maxlength", "2000");
// 목록 카드는 요약을 세 줄에서 자른다 — 작성자에게 그 경계를 알린다.
expect(screen.getByText(/목록 카드에는 약 90자까지 보입니다/u)).toBeInTheDocument();
fireEvent.change(summary, { target: { value: "가".repeat(412) } });
expect(screen.getByText("412 / 2000")).toBeInTheDocument();
expect(screen.getByText(/412 \/ 2000/u)).toBeInTheDocument();
expect(
screen.queryByText(/2000자까지 모두 썼습니다/),
).not.toBeInTheDocument();
fireEvent.change(summary, { target: { value: "가".repeat(2000) } });
expect(screen.getByText("2000 / 2000")).toBeInTheDocument();
expect(screen.getByText(/2000 \/ 2000/u)).toBeInTheDocument();
// 한계에 닿았을 때만 알린다 — 글자마다 읽어 주면 받아쓰기가 된다.
expect(screen.getByText(/2000자까지 모두 썼습니다/)).toBeInTheDocument();