주제 탭 (H1 연장). 홈 탭에 주제를 전부 세우고 목록 아래 「다른 주제 N개 보기」
줄을 없앴다. 축이 둘 이상인 주제만 탭이 되던 규칙 때문에 여섯 중 둘만 올라오고
나머지 넷은 비교표를 다 읽어야 만나는 작은 글씨 한 줄로 갔다. 축은 주제가
자라면서 생기는 것이지 기록이 없다는 뜻이 아니다. 축이 없는 주제는 그 주제의
기록을 세우고, 기록이 없으면 그렇다고 분명히 말한다.
탭 하나가 패널 하나를 가리키게 고쳤다. 탭 전부가 같은 패널을 가리키면 고르지
않은 탭이 "내가 저 패널을 연다" 고 말하면서 패널은 다른 탭의 이름을 달게 된다.
H1. `/studio/documents` 와 `/studio/publications` 의 검색·필터·쪽수를 주소에
담는다. 담지 않던 동안 3쪽에서 문서를 열고 뒤로 오면 1쪽이었고 필터도 사라졌다.
공개 `/search` 는 처음부터 담고 있었다.
H4. 문서 종류 이름을 `document-kind-labels.ts` 하나로 모았다. 세 곳에 흩어져
있어서 같은 CASE 가 목록에서는 「검증 기록」, 새 문서에서는 「Case」, 검색에서는
또 다른 이름이었다.
H5. `project.stage` 가 화면에 `DESIGN` 으로 그대로 새어 나왔다. 같은 프로젝트를
Studio 는 「설계」로 불렀다 — 두 화면이 다른 말을 했다.
H6. 값이 없는데 라벨만 그려지던 자리를 막았다. 네 프로젝트 중 셋이 「현재 목표」
라벨만 있고 값이 비어 있었다.
M2. 대시보드의 숫자를 목록으로 가는 길로 만들고, 할 일이 없는 구역은 그리지
않는다. 공개 홈 설정 폼은 작업 목록 한가운데에서 뒤로 옮겼다.
M3. 작업본 목록에 프로젝트 필터와 정렬을 더했다. 공개 `/explore` 는 독자에게
셋을 주는데 61개를 관리하는 작성자에게는 둘뿐이었다.
M4. 게시 기록의 필터 제출 방식을 작업본 목록에 맞췄다 — 셀렉트는 즉시, 검색만
버튼이다.
M5. MOCK 시절 문구("세션이 끝나면 사라집니다")를 지웠다. 실서버에는 작업본이
남는다.
M7. `aria-current="page"` 가 현재 페이지가 아닌 링크에 붙었다. 정확히 일치할
때만 붙게 하고 구역 강조는 따로 계산한다.
M8. 홈의 첫 화면을 비교표로 바꿨다. 다른 데서 얻을 수 없는 유일한 것이 y≈600 에
묻혀 있었다.
`ListDocumentsQuery.kind` 가 손으로 적은 union 이라 개념과 환경 구성이 빠져
있었다 — 그 둘은 작업본 목록에서 걸러 볼 수가 없었다. 계약 타입으로 바꿨다.
M9 는 고치지 않는다. 「문제·결론이 11px 회색」이라는 지적이 지금 빌드에서
재현되지 않는다 — 실측은 17px `rgb(63,66,73)` 이고 본문이 18px 같은 색이다.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PTnWufiY9ATv57egkKKVAV
313 lines
11 KiB
TypeScript
313 lines
11 KiB
TypeScript
import { type FormEvent, useEffect, useMemo, useRef, useState } from "react";
|
|
import { useSearchParams } from "react-router-dom";
|
|
|
|
import {
|
|
isStudioGatewayError,
|
|
type StudioGatewayError,
|
|
} from "../../../application/ports/studio-gateway-error.ts";
|
|
import type { ListPublicationsQuery } from "../../../application/ports/studio-gateway.ts";
|
|
import type {
|
|
PublicationListItem,
|
|
PublicationPage,
|
|
} from "../../../contracts/studio/contract.ts";
|
|
import { createLocalId } from "../../../domain/studio/local-id.ts";
|
|
import { GuardedStudioLink } from "./guarded-studio-link.tsx";
|
|
import {
|
|
defaultPublicationFlowClasses,
|
|
type PublicationFlowClasses,
|
|
} from "./publication-flow-classes.ts";
|
|
import { UnpublishDialog } from "./unpublish-dialog.tsx";
|
|
import { useStudio } from "../use-studio.ts";
|
|
import { StudioPagination } from "./studio-pagination.tsx";
|
|
import { DOCUMENT_KIND_LABELS } from "../../shared/document-kind-labels.ts";
|
|
|
|
const eventLabels = {
|
|
PUBLISHED: "게시",
|
|
REPUBLISHED: "재게시",
|
|
UNPUBLISHED: "게시 취소",
|
|
} as const;
|
|
|
|
function dateTime(value: string) {
|
|
return new Intl.DateTimeFormat("ko-KR", {
|
|
dateStyle: "medium",
|
|
timeStyle: "short",
|
|
timeZone: "Asia/Seoul",
|
|
}).format(new Date(value));
|
|
}
|
|
|
|
function snapshotHref(item: PublicationListItem) {
|
|
if (
|
|
item.availableActions.includes("VIEW_SOURCE_SNAPSHOT") &&
|
|
item.event.sourcePublishedEventId
|
|
) {
|
|
return `/studio/publications/${item.event.sourcePublishedEventId}/preview`;
|
|
}
|
|
if (item.availableActions.includes("VIEW_SNAPSHOT")) {
|
|
return `/studio/publications/${item.event.publicationEventId}/preview`;
|
|
}
|
|
return null;
|
|
}
|
|
|
|
/** 이벤트 필터가 받는 값. 주소에서 온 문자열을 이 목록으로 좁힌다. */
|
|
const EVENT_TYPES = Object.freeze(["PUBLISHED", "REPUBLISHED", "UNPUBLISHED"] as const);
|
|
|
|
export function PublicationList({
|
|
classes: styles = defaultPublicationFlowClasses,
|
|
}: { classes?: PublicationFlowClasses } = {}) {
|
|
const studio = useStudio();
|
|
/*
|
|
작업본 목록과 같은 규칙으로 상태를 주소에 담는다. 담지 않던 동안 게시 기록에서 Snapshot 을
|
|
열고 뒤로 오면 필터도 쪽수도 처음으로 돌아갔다.
|
|
|
|
필터 제출 방식도 작업본 목록에 맞춘다 — 셀렉트는 즉시 적용, 검색어만 버튼이다. 두 화면이
|
|
다른 방식을 쓰던 동안(여기는 둘을 묶어 「적용」) 작성자는 화면마다 어느 쪽인지 기억해야 했다.
|
|
*/
|
|
const [searchParams, setSearchParams] = useSearchParams();
|
|
const q = searchParams.get("q") ?? "";
|
|
const eventType = EVENT_TYPES.find((item) => item === searchParams.get("event"));
|
|
const pageNumber = Math.max(1, Number(searchParams.get("page")) || 1);
|
|
const query = useMemo<ListPublicationsQuery>(
|
|
() => ({
|
|
...(q ? { q: q.slice(0, 100) } : {}),
|
|
...(eventType ? { type: eventType } : {}),
|
|
page: pageNumber,
|
|
limit: 20,
|
|
}),
|
|
[eventType, pageNumber, q],
|
|
);
|
|
const [queryDraft, setQueryDraft] = useState(q);
|
|
|
|
const go = (next: Readonly<{ q?: string; event?: string; page?: number }>) => {
|
|
const params = new URLSearchParams();
|
|
const merged = { q, event: eventType, page: pageNumber, ...next };
|
|
if (merged.q) params.set("q", merged.q);
|
|
if (merged.event) params.set("event", merged.event);
|
|
if (merged.page && merged.page > 1) params.set("page", String(merged.page));
|
|
setSearchParams(params);
|
|
};
|
|
const [reload, setReload] = useState(0);
|
|
const [state, setState] = useState<
|
|
| { status: "LOADING" }
|
|
| { status: "ERROR"; problem: StudioGatewayError | Error }
|
|
| { status: "READY"; page: PublicationPage }
|
|
>({ status: "LOADING" });
|
|
const [selected, setSelected] = useState<PublicationListItem | null>(null);
|
|
const [pending, setPending] = useState(false);
|
|
const [dialogError, setDialogError] = useState("");
|
|
const [announcement, setAnnouncement] = useState("");
|
|
const triggerRef = useRef<HTMLButtonElement | null>(null);
|
|
|
|
useEffect(() => {
|
|
const controller = new AbortController();
|
|
let current = true;
|
|
setState({ status: "LOADING" });
|
|
void studio.gateway.listPublications(query, {
|
|
signal: controller.signal,
|
|
}).then(
|
|
(page) => {
|
|
if (current) setState({ status: "READY", page });
|
|
},
|
|
(error: unknown) => {
|
|
if (!current || controller.signal.aborted) return;
|
|
setState({
|
|
status: "ERROR",
|
|
problem:
|
|
error instanceof Error
|
|
? error
|
|
: new Error("게시 기록을 불러오지 못했습니다."),
|
|
});
|
|
},
|
|
);
|
|
return () => {
|
|
current = false;
|
|
controller.abort();
|
|
};
|
|
}, [query, reload, studio.gateway]);
|
|
|
|
const applyFilter = (event: FormEvent) => {
|
|
event.preventDefault();
|
|
go({ q: queryDraft.trim().slice(0, 100), page: 1 });
|
|
};
|
|
|
|
const dismiss = () => {
|
|
setSelected(null);
|
|
setDialogError("");
|
|
queueMicrotask(() => triggerRef.current?.focus());
|
|
};
|
|
|
|
const confirmUnpublish = async () => {
|
|
if (
|
|
!selected ||
|
|
pending ||
|
|
!selected.availableActions.includes("UNPUBLISH")
|
|
) {
|
|
return;
|
|
}
|
|
setPending(true);
|
|
setDialogError("");
|
|
try {
|
|
const result = await studio.gateway.unpublishPublication(
|
|
selected.publication.publicationId,
|
|
{
|
|
expectedPublicationRevision:
|
|
selected.publication.publicationRevision,
|
|
},
|
|
{ idempotencyKey: createLocalId("studio-unpublish") },
|
|
);
|
|
setSelected(null);
|
|
setAnnouncement("게시를 취소했습니다.");
|
|
studio.setRequestAnnouncement("게시를 취소했습니다.");
|
|
setReload((value) => value + 1);
|
|
} catch (error) {
|
|
setDialogError(
|
|
isStudioGatewayError(error)
|
|
? error.problem.detail
|
|
: "게시를 취소하지 못했습니다.",
|
|
);
|
|
} finally {
|
|
setPending(false);
|
|
}
|
|
};
|
|
|
|
return (
|
|
<div className={styles.page}>
|
|
<header className={styles.heading}>
|
|
<p className={styles.eyebrow}>PUBLICATION EVENTS</p>
|
|
<h1>게시 기록</h1>
|
|
<p>
|
|
게시·재게시·게시 취소 이벤트와 각 시점의 Snapshot을 확인합니다.
|
|
</p>
|
|
</header>
|
|
|
|
<form className={styles.filters} onSubmit={applyFilter}>
|
|
<label>
|
|
<span>검색</span>
|
|
<input
|
|
value={queryDraft}
|
|
maxLength={100}
|
|
onChange={(event) => setQueryDraft(event.currentTarget.value)}
|
|
placeholder="제목 또는 요약"
|
|
/>
|
|
</label>
|
|
<button type="submit">검색</button>
|
|
<label>
|
|
<span>이벤트</span>
|
|
<select
|
|
value={eventType ?? ""}
|
|
onChange={(event) => go({ event: event.currentTarget.value, page: 1 })}
|
|
>
|
|
<option value="">전체</option>
|
|
<option value="PUBLISHED">게시</option>
|
|
<option value="REPUBLISHED">재게시</option>
|
|
<option value="UNPUBLISHED">게시 취소</option>
|
|
</select>
|
|
</label>
|
|
</form>
|
|
|
|
{announcement ? (
|
|
<p className={styles.success} role="status">
|
|
{announcement}
|
|
</p>
|
|
) : null}
|
|
{state.status === "LOADING" ? (
|
|
<p className={styles.loading} role="status">
|
|
게시 기록을 불러오는 중입니다.
|
|
</p>
|
|
) : null}
|
|
{state.status === "ERROR" ? (
|
|
<section className={styles.errorState} role="alert">
|
|
<h2>게시 기록을 불러오지 못했습니다</h2>
|
|
<p>
|
|
{isStudioGatewayError(state.problem)
|
|
? state.problem.problem.detail
|
|
: state.problem.message}
|
|
</p>
|
|
<button type="button" onClick={() => setReload((value) => value + 1)}>
|
|
다시 시도
|
|
</button>
|
|
</section>
|
|
) : null}
|
|
{state.status === "READY" && state.page.items.length === 0 ? (
|
|
<section className={styles.emptyState}>
|
|
<h2>조건에 맞는 게시 기록이 없습니다</h2>
|
|
<p>검색어 또는 이벤트 필터를 바꿔 보세요.</p>
|
|
</section>
|
|
) : null}
|
|
{state.status === "READY" && state.page.items.length > 0 ? (
|
|
<ol className={styles.historyList}>
|
|
{state.page.items.map((item) => {
|
|
const href = snapshotHref(item);
|
|
const source = item.availableActions.includes(
|
|
"VIEW_SOURCE_SNAPSHOT",
|
|
);
|
|
const canUnpublish = item.availableActions.includes("UNPUBLISH");
|
|
return (
|
|
<li key={item.event.publicationEventId}>
|
|
<article className={styles.historyRow}>
|
|
<p className={styles.eventType}>
|
|
{eventLabels[item.event.type]}
|
|
</p>
|
|
<div className={styles.eventMain}>
|
|
<p className={styles.kind}>
|
|
{DOCUMENT_KIND_LABELS[item.document.kind]} · v
|
|
{item.event.publishedVersion}
|
|
</p>
|
|
<h2>{item.document.title || "제목 없는 작업본"}</h2>
|
|
<p>
|
|
이벤트: {eventLabels[item.event.type]} · 현재 상태:{" "}
|
|
{item.publication.status === "PUBLISHED"
|
|
? "게시 중"
|
|
: "게시 취소"}
|
|
</p>
|
|
</div>
|
|
<time dateTime={item.event.occurredAt}>
|
|
{dateTime(item.event.occurredAt)}
|
|
</time>
|
|
<div className={styles.rowActions}>
|
|
{href ? (
|
|
<GuardedStudioLink href={href}>
|
|
{source ? "게시 취소 전 Snapshot 보기" : "Snapshot 보기"}
|
|
</GuardedStudioLink>
|
|
) : null}
|
|
{canUnpublish ? (
|
|
<button
|
|
type="button"
|
|
aria-label={`${item.document.title || "제목 없는 작업본"} 게시 취소`}
|
|
onClick={(event) => {
|
|
triggerRef.current = event.currentTarget;
|
|
setDialogError("");
|
|
setSelected(item);
|
|
}}
|
|
>
|
|
게시 취소
|
|
</button>
|
|
) : null}
|
|
</div>
|
|
</article>
|
|
</li>
|
|
);
|
|
})}
|
|
</ol>
|
|
) : null}
|
|
{state.status === "READY" ? (
|
|
<StudioPagination
|
|
page={state.page.page}
|
|
label="게시 기록 페이지"
|
|
onChange={(next) => go({ page: next })}
|
|
/>
|
|
) : null}
|
|
|
|
<UnpublishDialog
|
|
item={selected}
|
|
pending={pending}
|
|
error={dialogError}
|
|
onDismiss={dismiss}
|
|
onConfirm={() => {
|
|
void confirmUnpublish();
|
|
}}
|
|
classes={styles}
|
|
/>
|
|
</div>
|
|
);
|
|
}
|