feat: 완료 조건에서 빠져 있던 일곱 가지
지난 보고에서 P0·P1 단위로만 세고 리뷰 §26 완료 조건 대비로는 세지 않았다. 세어 보니 일곱이 빠져 있었다. 편집기에 맥락 패널이 없었다. 읽는 쪽은 맥락을 잃지 않게 해 놓고 쓰는 쪽은 잃게 두고 있었다 — 작성자는 지금 쓰는 글이 어느 프로젝트의 어느 주제에 속하고 무엇과 이어져 있는지를 기본 정보 칸까지 거슬러 올라가야만 볼 수 있었다. 대체 텍스트를 고칠 자리가 없었다. 업로드할 때 한 번 적고 끝이라 잘못 적은 것을 알아도 고칠 수 없었는데, 그 글은 그림을 못 보는 사람에게는 그림 자체다. 설명(caption)은 같은 그림을 기록마다 다르게 설명할 수 있으므로 자료가 아니라 본문이 갖는다. 자료를 종류와 쓰임으로 거른다. 종류는 계약이 주는 필터라 서버가 거르고, 쓰임은 계약에 없어 받아 온 목록에서 거른다 — 다음 쪽까지 세지 못한다는 사실을 화면에 적는다. 없는 필터를 있는 척하는 것이 가장 나쁘다. 작업본 목록에 「다음 할 일」 필터를 둔다. 작성자가 목록에서 실제로 묻는 것이 그것이다. 주제·관계 없음·자료 없음은 `DocumentSummary` 에 값이 없어 아직 못 한다. 레일에 앞뒤 단계를 붙인다. 맥락은 "어디에 속하는가"까지고, 길은 "어디에서 와서 어디로 가는가"다. 홈의 사슬에는 각 단계의 요약 첫 문장을 붙인다 — 무엇이 이어지는지만 적으면 목록이고, 왜 이어지는지를 적어야 길이 된다. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015c8cBFUaVr7KLVUx6ujz7D
This commit is contained in:
co-authored by
Claude Opus 5
parent
f6f0c64284
commit
72691f2ffe
@@ -57,13 +57,29 @@ export function HomeInvestigationPath({ entries }: { entries: ReadonlyArray<Late
|
||||
{/* 기록마다 어느 주제에 속하는지 함께 적는다 — 하나의 조사가 여러 주제를 오간다는 것이
|
||||
이 사슬이 보여 주려는 것이다. */}
|
||||
<ul className="home-path-records">
|
||||
{path.map((record) => (
|
||||
{path.map((record, index) => (
|
||||
<li key={record.path}>
|
||||
<span>{[record.typeLabel, record.topic].filter(Boolean).join(" · ")}</span>
|
||||
<Link to={record.path}>{record.title}</Link>
|
||||
<div>
|
||||
<Link to={record.path}>{record.title}</Link>
|
||||
{/*
|
||||
무엇이 이어지는지만 적으면 목록이고, 왜 이어지는지를 적어야 길이 된다. 요약의
|
||||
첫 문장을 쓴다 — 작성자가 이 줄을 위해 따로 쓸 것을 만들지 않는다.
|
||||
*/}
|
||||
{record.summary.trim() ? <p>{firstSentence(record.summary)}</p> : null}
|
||||
</div>
|
||||
{index < path.length - 1 ? <span aria-hidden="true" className="home-path-arrow">↓</span> : null}
|
||||
</li>
|
||||
))}
|
||||
</ul>
|
||||
</section>
|
||||
);
|
||||
}
|
||||
|
||||
|
||||
/** 요약의 첫 문장. 한 줄이면 충분하고, 문단째 넣으면 길이 다시 목록이 된다. */
|
||||
function firstSentence(summary: string): string {
|
||||
const line = summary.split(/\n+/u)[0]?.trim() ?? "";
|
||||
const stop = line.search(/[.。]\s|다\s/u);
|
||||
return stop > 0 ? line.slice(0, stop + 1) : line;
|
||||
}
|
||||
|
||||
@@ -1,6 +1,7 @@
|
||||
import { Link } from "react-router-dom";
|
||||
|
||||
import type { components } from "../../../contracts/studio/generated.ts";
|
||||
import { resolvesToPublicRoute } from "../../../domain/navigation/public-path.ts";
|
||||
import { DOCUMENT_KIND_LABELS } from "../document-kind-labels.ts";
|
||||
|
||||
type PublicRenderModelBase = components["schemas"]["PublicRenderModelBase"];
|
||||
@@ -17,7 +18,14 @@ type PublicRenderModelBase = components["schemas"]["PublicRenderModelBase"];
|
||||
*/
|
||||
export function RailContext({ model }: { model: PublicRenderModelBase }) {
|
||||
const topic = model.topic.label ? model.topic : null;
|
||||
if (!model.project && !topic) return null;
|
||||
const reachable = [...model.relations]
|
||||
.filter((relation) => resolvesToPublicRoute(relation.publicPath ?? ""))
|
||||
.sort((left, right) => left.order - right.order);
|
||||
const path = [
|
||||
reachable[0] ? { ...reachable[0], mark: "다음" } : null,
|
||||
reachable.length > 1 ? { ...reachable.at(-1)!, mark: "앞" } : null,
|
||||
].filter((step) => step !== null);
|
||||
if (!model.project && !topic && path.length === 0) return null;
|
||||
|
||||
return (
|
||||
<nav className="rail-context" aria-label="지금 위치">
|
||||
@@ -37,6 +45,23 @@ export function RailContext({ model }: { model: PublicRenderModelBase }) {
|
||||
</span>
|
||||
) : null}
|
||||
<span className="rail-context-kind">{DOCUMENT_KIND_LABELS[model.kind]}</span>
|
||||
{/*
|
||||
앞뒤 단계. 맥락은 "어디에 속하는가"까지고, 길은 "어디에서 와서 어디로 가는가"다. 둘을
|
||||
같이 두어야 본문을 읽는 동안에도 사슬이 끊기지 않는다.
|
||||
|
||||
순서는 작성자가 관계에 매긴 것을 그대로 쓴다. 지금 기록의 자리를 따로 저장하지 않으므로
|
||||
첫 관계를 다음으로, 마지막을 앞으로 읽는다 — 관계가 하나면 다음만 있다.
|
||||
*/}
|
||||
{path.length > 0 ? (
|
||||
<span className="rail-path">
|
||||
{path.map((step) => (
|
||||
<Link key={step.id} to={step.publicPath ?? ""}>
|
||||
<em>{step.mark}</em>
|
||||
{step.title}
|
||||
</Link>
|
||||
))}
|
||||
</span>
|
||||
) : null}
|
||||
</nav>
|
||||
);
|
||||
}
|
||||
|
||||
@@ -2,6 +2,8 @@ import { useEffect, useId, useRef, useState, type FormEvent } from "react";
|
||||
import { DestructiveConfirmDialog } from "./destructive-confirm-dialog.tsx";
|
||||
|
||||
import type { Asset, AssetDetail } from "../../../contracts/studio/contract.ts";
|
||||
|
||||
type AssetKind = Asset["kind"];
|
||||
import type { StudioAssetGateway } from "../../../application/ports/studio-asset-gateway.ts";
|
||||
import { isStudioGatewayError } from "../../../application/ports/studio-gateway-error.ts";
|
||||
import { createLocalId } from "../../../domain/studio/local-id.ts";
|
||||
@@ -60,6 +62,13 @@ export function AssetLibrary(props: Readonly<{ gateway: StudioAssetGateway }>) {
|
||||
// request per deliberate search, never a trailing one after the user stops.
|
||||
const [searchDraft, setSearchDraft] = useState("");
|
||||
const [q, setQ] = useState("");
|
||||
/*
|
||||
종류는 서버가 걸러 준다(`kind`). 쓰임 여부는 계약에 없는 조건이라 받아 온 목록에서 거른다 —
|
||||
다음 쪽에 있는 것까지 세지는 못하므로 그 사실을 화면에 적는다. 없는 필터를 있는 척하는 것이
|
||||
가장 나쁘다.
|
||||
*/
|
||||
const [kindFilter, setKindFilter] = useState<AssetKind | "">("");
|
||||
const [usageFilter, setUsageFilter] = useState<"" | "USED" | "UNUSED">("");
|
||||
const [nextCursor, setNextCursor] = useState<string | null>(null);
|
||||
const [morePending, setMorePending] = useState(false);
|
||||
const [selected, setSelected] = useState<AssetDetail | null>(null);
|
||||
@@ -88,7 +97,7 @@ export function AssetLibrary(props: Readonly<{ gateway: StudioAssetGateway }>) {
|
||||
setListStatus("LOADING");
|
||||
props.gateway
|
||||
.listAssets(
|
||||
{ ...(q ? { q } : {}), limit: PAGE_SIZE },
|
||||
{ ...(q ? { q } : {}), ...(kindFilter ? { kind: kindFilter } : {}), limit: PAGE_SIZE },
|
||||
{ signal: controller.signal },
|
||||
)
|
||||
.then((page) => {
|
||||
@@ -108,7 +117,7 @@ export function AssetLibrary(props: Readonly<{ gateway: StudioAssetGateway }>) {
|
||||
active = false;
|
||||
controller.abort();
|
||||
};
|
||||
}, [props.gateway, q]);
|
||||
}, [props.gateway, q, kindFilter]);
|
||||
|
||||
// A freshly opened detail panel should take focus so keyboard and screen
|
||||
// reader users land on it without hunting; re-rendering the same asset
|
||||
@@ -162,6 +171,7 @@ export function AssetLibrary(props: Readonly<{ gateway: StudioAssetGateway }>) {
|
||||
try {
|
||||
const page = await props.gateway.listAssets({
|
||||
...(q ? { q } : {}),
|
||||
...(kindFilter ? { kind: kindFilter } : {}),
|
||||
cursor,
|
||||
limit: PAGE_SIZE,
|
||||
});
|
||||
@@ -252,6 +262,52 @@ export function AssetLibrary(props: Readonly<{ gateway: StudioAssetGateway }>) {
|
||||
}
|
||||
}
|
||||
|
||||
const [altDraft, setAltDraft] = useState("");
|
||||
const [decorativeDraft, setDecorativeDraft] = useState(false);
|
||||
|
||||
/* 상세를 열 때마다 그 자료의 값으로 칸을 맞춘다 — 앞서 보던 자료의 글이 남아 있으면 안 된다. */
|
||||
useEffect(() => {
|
||||
setAltDraft(selected?.asset.altText ?? "");
|
||||
setDecorativeDraft(selected?.asset.decorative ?? false);
|
||||
}, [selected?.asset.id, selected?.asset.altText, selected?.asset.decorative]);
|
||||
|
||||
const saveAltText = async () => {
|
||||
const detail = selected;
|
||||
if (!detail || pending) return;
|
||||
setPending(true);
|
||||
setNotice("");
|
||||
try {
|
||||
const updated = await props.gateway.updateAssetMetadata(
|
||||
detail.asset.id,
|
||||
{
|
||||
expectedVersion: detail.asset.version,
|
||||
altText: altDraft.trim() ? altDraft : null,
|
||||
decorative: decorativeDraft,
|
||||
},
|
||||
{ idempotencyKey: createLocalId("studio-asset-alt") },
|
||||
);
|
||||
setAssets((current) =>
|
||||
current.map((item) => (item.id === updated.id ? updated : item)),
|
||||
);
|
||||
setSelected({ ...detail, asset: updated });
|
||||
setNotice("대체 텍스트를 저장했습니다.");
|
||||
} catch (error) {
|
||||
setNotice(
|
||||
isStudioGatewayError(error) ? error.problem.detail : "저장하지 못했습니다.",
|
||||
);
|
||||
} finally {
|
||||
setPending(false);
|
||||
}
|
||||
};
|
||||
|
||||
const visibleAssets = assets.filter((asset) =>
|
||||
usageFilter === "USED"
|
||||
? asset.usageCount > 0
|
||||
: usageFilter === "UNUSED"
|
||||
? asset.usageCount === 0
|
||||
: true,
|
||||
);
|
||||
|
||||
return (
|
||||
<div className="studio-page studio-assets-page">
|
||||
<header className="studio-page-heading">
|
||||
@@ -277,6 +333,40 @@ export function AssetLibrary(props: Readonly<{ gateway: StudioAssetGateway }>) {
|
||||
<button type="submit">검색</button>
|
||||
</div>
|
||||
</form>
|
||||
{/*
|
||||
종류는 서버가 걸러 준다. 쓰임 여부는 계약에 없어 받아 온 목록에서 거르므로, 다음 쪽에
|
||||
있는 것까지 세지 못한다는 사실을 함께 적는다 — 없는 필터를 있는 척하지 않는다.
|
||||
*/}
|
||||
<div className="studio-asset-filters">
|
||||
<label>
|
||||
<span>종류</span>
|
||||
<select
|
||||
value={kindFilter}
|
||||
onChange={(event) => setKindFilter(event.currentTarget.value as AssetKind | "")}
|
||||
>
|
||||
<option value="">전체</option>
|
||||
<option value="IMAGE">이미지</option>
|
||||
<option value="DIAGRAM">도식</option>
|
||||
<option value="ATTACHMENT">첨부</option>
|
||||
</select>
|
||||
</label>
|
||||
<label>
|
||||
<span>쓰임</span>
|
||||
<select
|
||||
value={usageFilter}
|
||||
onChange={(event) =>
|
||||
setUsageFilter(event.currentTarget.value as "" | "USED" | "UNUSED")
|
||||
}
|
||||
>
|
||||
<option value="">전체</option>
|
||||
<option value="USED">쓰이는 것</option>
|
||||
<option value="UNUSED">쓰이지 않는 것</option>
|
||||
</select>
|
||||
</label>
|
||||
{usageFilter ? (
|
||||
<small>불러온 목록 안에서만 거릅니다.</small>
|
||||
) : null}
|
||||
</div>
|
||||
</section>
|
||||
|
||||
{/*
|
||||
@@ -318,9 +408,9 @@ export function AssetLibrary(props: Readonly<{ gateway: StudioAssetGateway }>) {
|
||||
</section>
|
||||
) : null}
|
||||
|
||||
{assets.length > 0 ? (
|
||||
{visibleAssets.length > 0 ? (
|
||||
<ul className="asset-library-list">
|
||||
{assets.map((asset) => (
|
||||
{visibleAssets.map((asset) => (
|
||||
<li key={asset.id}>
|
||||
{/*
|
||||
key 만 있던 동안 이 목록은 "무엇을 고르는지" 를 말해 주지 못했다. Asset 이 스무
|
||||
@@ -409,10 +499,44 @@ export function AssetLibrary(props: Readonly<{ gateway: StudioAssetGateway }>) {
|
||||
<div><dt>파일</dt><dd>{assetFacts(selected.asset)}</dd></div>
|
||||
{/* 본문이 가리키는 불변 식별자. 사람이 기억하는 이름이 아니라 복사해 쓰는 값이다. */}
|
||||
<div><dt>Key</dt><dd><code>{selected.asset.assetKey}</code></dd></div>
|
||||
{selected.asset.altText ? (
|
||||
<div><dt>대체 텍스트</dt><dd>{selected.asset.altText}</dd></div>
|
||||
) : null}
|
||||
</dl>
|
||||
{/*
|
||||
대체 텍스트는 이 자료의 성질이므로 여기서 고친다. 예전에는 업로드할 때 한 번 적고
|
||||
끝이라, 나중에 잘못 적은 것을 알아도 고칠 자리가 없었다 — 그 글은 그림을 못 보는
|
||||
사람에게는 그림 자체다.
|
||||
|
||||
설명(caption)은 여기 없다. 같은 그림을 다른 기록에서 다른 말로 설명할 수 있어서
|
||||
자료가 아니라 본문이 갖는 값이다(`:::evidence caption=…`).
|
||||
*/}
|
||||
<form
|
||||
className="asset-detail-alt"
|
||||
onSubmit={(event) => {
|
||||
event.preventDefault();
|
||||
void saveAltText();
|
||||
}}
|
||||
>
|
||||
<label htmlFor="asset-alt-text">대체 텍스트</label>
|
||||
<textarea
|
||||
id="asset-alt-text"
|
||||
rows={2}
|
||||
maxLength={1000}
|
||||
value={altDraft}
|
||||
disabled={pending}
|
||||
onChange={(event) => setAltDraft(event.currentTarget.value)}
|
||||
/>
|
||||
<label className="asset-detail-decorative">
|
||||
<input
|
||||
type="checkbox"
|
||||
checked={decorativeDraft}
|
||||
disabled={pending}
|
||||
onChange={(event) => setDecorativeDraft(event.currentTarget.checked)}
|
||||
/>
|
||||
<span>장식용입니다 (읽어 줄 내용이 없음)</span>
|
||||
</label>
|
||||
<button className="studio-secondary-button" type="submit" disabled={pending}>
|
||||
대체 텍스트 저장
|
||||
</button>
|
||||
</form>
|
||||
{/*
|
||||
바꾸거나 지우기 전에 어디에 쓰이는지 전부 보여야 한다. 숫자만으로는 무엇이 깨질지
|
||||
알 수 없다.
|
||||
|
||||
@@ -2,6 +2,7 @@ import { useState } from "react";
|
||||
|
||||
import type { components } from "../../../contracts/studio/generated.ts";
|
||||
import { usePreviewScrollSync } from "./use-preview-scroll-sync.ts";
|
||||
import { EditorContextPanel } from "./editor-context-panel.tsx";
|
||||
import { EditorSectionToc } from "./editor-section-toc.tsx";
|
||||
import type { Asset } from "../../../contracts/studio/contract.ts";
|
||||
import type { TopicVariantEdit } from "../../../contracts/management/contract.ts";
|
||||
@@ -109,6 +110,11 @@ export function DocumentEditor({
|
||||
7,540px 짜리 폼에 섹션으로 이동할 수단이 하나도 없었다. 공개 상세 화면이 이미
|
||||
sticky 목차를 갖고 있고, 같은 일을 여기서 한다.
|
||||
*/}
|
||||
{/*
|
||||
읽는 쪽은 맥락을 잃지 않게 해 놓고 쓰는 쪽은 잃게 두고 있었다. 지금 쓰는 글이 어느
|
||||
프로젝트의 어느 주제에 속하고 무엇과 이어져 있는지를 폼 위쪽에 세운다.
|
||||
*/}
|
||||
<EditorContextPanel draft={controller.draft} catalog={catalog} />
|
||||
<EditorSectionToc containerId="studio-editor-workspace" />
|
||||
<CommonDocumentFields draft={controller.draft} topics={topics} projects={projects} relations={relations} variants={variants} issues={issues} onUpdate={controller.update} />
|
||||
{controller.draft.kind === "CASE"
|
||||
|
||||
@@ -32,6 +32,22 @@ const STUDIO_KIND_ORDER: Record<RecordKind, number> = {
|
||||
/** 정렬 선택지. 계약의 `ListDocumentsQuery.sort` 와 같은 집합이다. */
|
||||
const SORTS = Object.freeze(["UPDATED_DESC", "UPDATED_ASC", "TITLE_ASC"] as const);
|
||||
|
||||
/*
|
||||
다음 할 일로 거른다. 계약이 이미 주는 필터이고(`nextAction`), 작성자가 목록에서 실제로 묻는
|
||||
것이 이것이다 — "검증해야 하는 게 뭐지", "게시할 수 있는 게 뭐지".
|
||||
|
||||
주제·관계 없음·자료 없음으로 거르는 것은 아직 못 한다. `DocumentSummary` 에 그 값들이 없어
|
||||
화면에서 만들 수 없다.
|
||||
*/
|
||||
const NEXT_ACTIONS = Object.freeze([
|
||||
"CONTINUE_EDITING",
|
||||
"VALIDATE",
|
||||
"FIX_VALIDATION",
|
||||
"CREATE_PREVIEW",
|
||||
"PUBLISH",
|
||||
"NONE",
|
||||
] as const);
|
||||
|
||||
const PUBLICATION_STATUSES = Object.freeze([
|
||||
"NEVER_PUBLISHED",
|
||||
"PUBLISHED",
|
||||
@@ -80,6 +96,7 @@ export function DocumentList() {
|
||||
const status = PUBLICATION_STATUSES.find((item) => item === searchParams.get("status"));
|
||||
const projectId = searchParams.get("project") ?? "";
|
||||
const sort = SORTS.find((item) => item === searchParams.get("sort")) ?? "UPDATED_DESC";
|
||||
const nextAction = NEXT_ACTIONS.find((item) => item === searchParams.get("next"));
|
||||
const pageNumber = Math.max(1, Number(searchParams.get("page")) || 1);
|
||||
const [searchDraft, setSearchDraft] = useState(q);
|
||||
const [projects, setProjects] = useState<CatalogPage["items"]>([]);
|
||||
@@ -95,17 +112,28 @@ export function DocumentList() {
|
||||
status?: string;
|
||||
project?: string;
|
||||
sort?: string;
|
||||
next?: string;
|
||||
page?: number;
|
||||
}>,
|
||||
) => {
|
||||
const params = new URLSearchParams();
|
||||
const merged = { q, kind, status, project: projectId, sort, page: pageNumber, ...next };
|
||||
const merged = {
|
||||
q,
|
||||
kind,
|
||||
status,
|
||||
project: projectId,
|
||||
sort,
|
||||
next: nextAction,
|
||||
page: pageNumber,
|
||||
...next,
|
||||
};
|
||||
if (merged.q) params.set("q", merged.q);
|
||||
if (merged.kind) params.set("kind", merged.kind);
|
||||
if (merged.status) params.set("status", merged.status);
|
||||
if (merged.project) params.set("project", merged.project);
|
||||
// 기본 정렬은 주소에 적지 않는다 — 아무것도 더 말해 주지 않으면서 주소만 길어진다.
|
||||
if (merged.sort && merged.sort !== "UPDATED_DESC") params.set("sort", merged.sort);
|
||||
if (merged.next) params.set("next", merged.next);
|
||||
if (merged.page && merged.page > 1) params.set("page", String(merged.page));
|
||||
setSearchParams(params);
|
||||
};
|
||||
@@ -201,6 +229,7 @@ export function DocumentList() {
|
||||
...(kind ? { kind } : {}),
|
||||
...(status ? { publicationStatus: status } : {}),
|
||||
...(projectId ? { projectId } : {}),
|
||||
...(nextAction ? { nextAction } : {}),
|
||||
sort,
|
||||
page: pageNumber,
|
||||
limit: 20,
|
||||
@@ -219,7 +248,7 @@ export function DocumentList() {
|
||||
},
|
||||
);
|
||||
return () => controller.abort();
|
||||
}, [gateway, kind, pageNumber, projectId, q, retryGeneration, sort, status]);
|
||||
}, [gateway, kind, nextAction, pageNumber, projectId, q, retryGeneration, sort, status]);
|
||||
|
||||
const changeFilter = (next: {
|
||||
kind?: ListDocumentsQuery["kind"];
|
||||
@@ -324,6 +353,24 @@ export function DocumentList() {
|
||||
))}
|
||||
</select>
|
||||
</label>
|
||||
{/*
|
||||
작성자가 목록에서 실제로 묻는 것 — "검증해야 하는 게 뭐지", "게시할 수 있는 게 뭐지".
|
||||
계약이 이미 주는 필터라 서버가 거른다.
|
||||
*/}
|
||||
<label>
|
||||
다음 할 일
|
||||
<select
|
||||
value={nextAction ?? ""}
|
||||
onChange={(event) => go({ next: event.target.value, page: 1 })}
|
||||
>
|
||||
<option value="">전체</option>
|
||||
{NEXT_ACTIONS.map((action) => (
|
||||
<option key={action} value={action}>
|
||||
{NEXT_ACTION_LABELS[action]}
|
||||
</option>
|
||||
))}
|
||||
</select>
|
||||
</label>
|
||||
<label>
|
||||
정렬
|
||||
<select value={sort} onChange={(event) => go({ sort: event.target.value, page: 1 })}>
|
||||
|
||||
@@ -0,0 +1,94 @@
|
||||
import type { components } from "../../../contracts/studio/generated.ts";
|
||||
import type { WorkingCopyInput } from "../../../contracts/studio/contract.ts";
|
||||
import { DOCUMENT_KIND_LABELS } from "../../shared/document-kind-labels.ts";
|
||||
|
||||
type CatalogEntry = components["schemas"]["CatalogEntry"];
|
||||
|
||||
/** 관계 대상의 종류 이름. 프로젝트만 표에 없다 — 기록이 아니라 묶음이기 때문이다. */
|
||||
function kindLabel(kind: CatalogEntry["kind"]): string {
|
||||
if (!kind) return "기록";
|
||||
return kind === "PROJECT" ? "프로젝트" : DOCUMENT_KIND_LABELS[kind];
|
||||
}
|
||||
|
||||
/**
|
||||
* 쓰는 동안에도 이 기록이 어느 조사의 어디쯤인지.
|
||||
*
|
||||
* <p>공개 화면에는 맥락 덩어리를 세웠는데 편집기에는 없었다. 작성자는 7,540px 짜리 폼을
|
||||
* 내려가면서 지금 쓰는 글이 어느 프로젝트의 어느 주제에 속하는지, 무엇과 이어져 있는지를
|
||||
* 기본 정보 칸까지 거슬러 올라가야만 볼 수 있었다 — 읽는 쪽은 맥락을 잃지 않게 해 놓고 쓰는
|
||||
* 쪽은 잃게 두고 있었다.
|
||||
*
|
||||
* <p>이름은 목록에서 찾아 붙인다. 초안이 들고 있는 것은 id 뿐이라 그것만으로는 화면에 쓸 말이
|
||||
* 없다. 목록에 없으면 그 사실을 적는다 — 보관됐거나 지워진 대상이고, 비워 두면 작성자는
|
||||
* 아무것도 고르지 않은 것으로 읽는다.
|
||||
*/
|
||||
export function EditorContextPanel({
|
||||
draft,
|
||||
catalog,
|
||||
}: {
|
||||
draft: WorkingCopyInput;
|
||||
catalog: ReadonlyArray<CatalogEntry>;
|
||||
}) {
|
||||
const find = (id: string | null | undefined, type: CatalogEntry["type"]) =>
|
||||
id ? catalog.find((entry) => entry.id === id && entry.type === type) : undefined;
|
||||
|
||||
const topic = find(draft.topicId, "TOPIC");
|
||||
const project = find(draft.projectId, "PROJECT");
|
||||
const related = draft.relations
|
||||
.map((relation) => ({
|
||||
relation,
|
||||
target: relation.targetId
|
||||
? catalog.find((entry) => entry.id === relation.targetId)
|
||||
: undefined,
|
||||
}))
|
||||
.filter((entry) => entry.relation.targetId);
|
||||
|
||||
const label = (
|
||||
id: string | null | undefined,
|
||||
entry: CatalogEntry | undefined,
|
||||
empty: string,
|
||||
) => {
|
||||
if (!id) return <span className="studio-context-empty">{empty}</span>;
|
||||
if (!entry) return <span className="studio-context-missing">목록에 없는 대상</span>;
|
||||
return <span>{entry.label}</span>;
|
||||
};
|
||||
|
||||
return (
|
||||
<aside className="studio-editor-context" aria-label="이 기록의 맥락">
|
||||
<p className="studio-eyebrow">맥락</p>
|
||||
<dl>
|
||||
<div>
|
||||
<dt>프로젝트</dt>
|
||||
<dd>{label(draft.projectId, project, "고르지 않음")}</dd>
|
||||
</div>
|
||||
<div>
|
||||
<dt>주제</dt>
|
||||
<dd>{label(draft.topicId, topic, "고르지 않음")}</dd>
|
||||
</div>
|
||||
<div>
|
||||
<dt>종류</dt>
|
||||
<dd>{DOCUMENT_KIND_LABELS[draft.kind]}</dd>
|
||||
</div>
|
||||
</dl>
|
||||
<p className="studio-context-relations-title">
|
||||
{related.length > 0 ? `이어지는 기록 ${related.length}` : "이어지는 기록 없음"}
|
||||
</p>
|
||||
{related.length > 0 ? (
|
||||
<ul>
|
||||
{related.map(({ relation, target }) => (
|
||||
<li key={relation.id ?? relation.targetId ?? ""}>
|
||||
{target ? (
|
||||
<>
|
||||
<span>{kindLabel(target.kind)}</span>
|
||||
<strong>{target.label}</strong>
|
||||
</>
|
||||
) : (
|
||||
<strong className="studio-context-missing">목록에 없는 기록</strong>
|
||||
)}
|
||||
</li>
|
||||
))}
|
||||
</ul>
|
||||
) : null}
|
||||
</aside>
|
||||
);
|
||||
}
|
||||
@@ -3651,8 +3651,22 @@ textarea.studio-control { min-height: 118px; resize: vertical; line-height: 1.65
|
||||
display: grid;
|
||||
/* 종류와 주제를 함께 적으므로 첫 칸이 넓어야 한다. */
|
||||
grid-template-columns: 190px minmax(0, 1fr);
|
||||
gap: 16px;
|
||||
padding-block: 7px;
|
||||
gap: 4px 16px;
|
||||
padding-block: 9px;
|
||||
}
|
||||
|
||||
.home-path-records li > div > p {
|
||||
margin: 4px 0 0;
|
||||
color: var(--muted);
|
||||
font-size: 13px;
|
||||
line-height: 1.6;
|
||||
}
|
||||
|
||||
/* 단계 사이의 화살표. 마지막 뒤에는 그리지 않는다. */
|
||||
.home-path-arrow {
|
||||
grid-column: 2;
|
||||
color: var(--line-strong);
|
||||
font-size: 12px;
|
||||
}
|
||||
|
||||
.home-path-records span {
|
||||
@@ -4080,3 +4094,33 @@ summary {
|
||||
font-size: 17px;
|
||||
line-height: 1.7;
|
||||
}
|
||||
|
||||
/* 레일의 길 — 어디에서 와서 어디로 가는가 */
|
||||
|
||||
.rail-path {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
gap: 7px;
|
||||
margin-top: 14px;
|
||||
padding-top: 13px;
|
||||
border-top: 1px solid var(--line);
|
||||
}
|
||||
|
||||
.rail-path a {
|
||||
display: block;
|
||||
color: var(--ink-soft);
|
||||
font-size: 12.5px;
|
||||
line-height: 1.45;
|
||||
}
|
||||
|
||||
.rail-path em {
|
||||
display: block;
|
||||
color: var(--faint);
|
||||
font-size: 11px;
|
||||
font-style: normal;
|
||||
font-weight: 640;
|
||||
}
|
||||
|
||||
.rail-path a:hover {
|
||||
color: var(--signal);
|
||||
}
|
||||
|
||||
@@ -311,3 +311,17 @@
|
||||
.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; }
|
||||
|
||||
/* 쓰는 동안에도 이 기록이 어느 조사의 어디쯤인지 */
|
||||
.studio-app .studio-editor-context { margin: 22px 0 6px; padding: 16px 0 18px 17px; border-left: 2px solid var(--line-strong); }
|
||||
.studio-app .studio-editor-context dl { display: flex; flex-wrap: wrap; gap: 8px 30px; margin: 10px 0 0; }
|
||||
.studio-app .studio-editor-context dl > div { display: flex; gap: 9px; align-items: baseline; }
|
||||
.studio-app .studio-editor-context dt { color: var(--faint); font-size: 12px; font-weight: 620; }
|
||||
.studio-app .studio-editor-context dd { margin: 0; color: var(--ink); font-size: 14px; font-weight: 600; }
|
||||
.studio-app .studio-context-empty { color: var(--faint); font-weight: 500; }
|
||||
.studio-app .studio-context-missing { color: #a13b31; }
|
||||
.studio-app .studio-context-relations-title { margin: 15px 0 0; color: var(--faint); font-size: 12px; font-weight: 620; }
|
||||
.studio-app .studio-editor-context ul { margin: 8px 0 0; padding: 0; list-style: none; }
|
||||
.studio-app .studio-editor-context ul li { display: grid; grid-template-columns: 84px minmax(0, 1fr); gap: 12px; padding-block: 4px; }
|
||||
.studio-app .studio-editor-context ul span { color: var(--faint); font-size: 12px; line-height: 1.7; }
|
||||
.studio-app .studio-editor-context ul strong { color: var(--ink-soft); font-size: 14px; font-weight: 500; line-height: 1.55; }
|
||||
|
||||
@@ -524,3 +524,17 @@
|
||||
.studio-app .studio-structure-empty { margin: 10px 0 0; color: var(--faint); font-size: 13px; }
|
||||
.studio-app .studio-structure-orphans { margin-top: 34px; }
|
||||
.studio-app .studio-structure-orphans h2 { margin: 0 0 12px; font-size: 13px; font-weight: 650; color: var(--muted); }
|
||||
|
||||
/* Asset 필터 */
|
||||
.studio-app .studio-asset-filters { display: flex; flex-wrap: wrap; gap: 10px 22px; align-items: flex-end; margin-top: 16px; }
|
||||
.studio-app .studio-asset-filters label { display: grid; gap: 5px; }
|
||||
.studio-app .studio-asset-filters span { color: var(--muted); font-size: 12px; font-weight: 640; }
|
||||
.studio-app .studio-asset-filters select { min-height: 40px; padding-inline: 10px; border: 1px solid var(--line-strong); border-radius: 5px; background: var(--paper); color: var(--ink); font: inherit; }
|
||||
.studio-app .studio-asset-filters small { color: var(--faint); font-size: 12px; padding-bottom: 11px; }
|
||||
|
||||
/* 대체 텍스트 — 그림을 못 보는 사람에게는 그 글이 그림 자체다 */
|
||||
.studio-app .asset-detail-alt { display: grid; gap: 8px; margin-top: 22px; max-width: 520px; }
|
||||
.studio-app .asset-detail-alt > label:first-child { color: var(--muted); font-size: 12px; font-weight: 640; }
|
||||
.studio-app .asset-detail-alt textarea { min-height: 62px; padding: 10px 12px; border: 1px solid var(--line-strong); border-radius: 5px; background: var(--paper); color: var(--ink); font: inherit; resize: vertical; }
|
||||
.studio-app .asset-detail-decorative { display: flex; gap: 9px; align-items: center; color: var(--muted); font-size: 13px; }
|
||||
.studio-app .asset-detail-alt button { justify-self: start; }
|
||||
|
||||
@@ -75,6 +75,8 @@ export const TECH_LOG_ROUTE_CODECS = Object.freeze({
|
||||
*/
|
||||
project: optionalString,
|
||||
sort: optionalString,
|
||||
/* 다음 할 일. 검증이 필요한 것과 게시 준비가 끝난 것을 걸러 보는 자리다. */
|
||||
next: optionalString,
|
||||
page: optionalString,
|
||||
})
|
||||
.strip(),
|
||||
|
||||
Reference in New Issue
Block a user