B1. 검증·미리보기 화면이 CSS 없이 배포됐다. `workflow.module.css` 를 import 하는 파일이 하나도 없었고, Vite 의 CSS Module 은 import 되어야 번들에 들어간다. 제목이 62px 가 아니라 16px 로 나왔고 미리보기의 링크 두 개가 공백 없이 붙었다. 규칙이 전부 `:global()` 이었으므로 모듈일 이유가 없다 — studio.css 로 옮겼다. B2. Asset 라이브러리에 스타일이 없고 진입 경로도 없었다. 네 클래스에 규칙이 하나도 없어 key·상태·사용 수가 공백 없이 이어 붙었다. 스무 개짜리 목록에 썸네일도 없어 무엇을 고르는지 눌러 봐야 알았다. 내비게이션에도 없어서 URL 을 직접 쳐야 닿았다 — "정리하는 화면" 에 정리하러 갈 길이 없었다. B3. 삭제에 확인이 없었다. 문서·주제·프로젝트·릴리즈·Asset 전부 한 번에 영구 삭제였고, 그 「삭제」가 행에서 시각적으로 가장 강한 요소였다(16px/600 빨강). 정작 그 행에서 해야 할 일인 「검증하기」는 13px/400 이었다. 확인 창을 하나 만들어 다섯 곳에 붙이고, 행의 우선순위를 되돌렸다. B4(일부). robots.txt 가 광고하던 sitemap 이 404 였다. 무엇이 게시됐는지는 서버만 알므로 정적 파일이 아니라 조회로 만든다(백엔드 커밋 참조). robots.txt 가 그 주소를 가리키게 했다. B5. 라우트 프리픽스 밖 URL 이 nginx 의 맨 `Not Found` 로 끝났다. 404 상태는 그대로 두고 — 크롤러에게 링크가 깨졌다고 말하는 것이 그것이다 — 본문만 앱을 주도록 `error_page 404 @not_found` 를 뒀다. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PTnWufiY9ATv57egkKKVAV
277 lines
10 KiB
TypeScript
277 lines
10 KiB
TypeScript
import { useCallback, useEffect, useState, type FormEvent } from "react";
|
|
import { DestructiveConfirmDialog } from "./destructive-confirm-dialog.tsx";
|
|
|
|
import type {
|
|
ReleaseEditResponse,
|
|
ReleaseIndexItem,
|
|
ReleaseUpdateRequest,
|
|
} from "../../../contracts/management/contract.ts";
|
|
import { managementFailureMessage } from "../../../application/ports/management-gateway-error.ts";
|
|
import { GuardedStudioLink } from "./guarded-studio-link.tsx";
|
|
import { useStudio } from "../use-studio.ts";
|
|
|
|
/**
|
|
* 릴리즈 작성.
|
|
*
|
|
* <p>공개 사이트에 변경 기록 화면과 푸터 링크가 있는데 둘 다 비어 있었다 — 읽기는 처음부터
|
|
* 있었고 쓰는 곳이 없었다. 그래서 이 화면의 범위는 목록·작성·발행이다.
|
|
*
|
|
* <p>본문이 마크다운 여섯 칸으로 나뉜 것은 계약의 모양이자 릴리즈 노트의 성격이다. 한 칸짜리
|
|
* 자유 서술이었다면 "검증을 안 썼다"를 아무도 알아채지 못한다.
|
|
*
|
|
* <p>새 CSS 를 만들지 않는다 — 문서 편집기가 쓰는 field 클래스와 작업본 목록의 행 클래스를 그대로
|
|
* 재사용하므로 Studio 의 나머지와 같은 간격·타이포·색을 따른다.
|
|
*/
|
|
|
|
/** 백엔드 {@code UpdateReleaseUseCase.CHANGE_TYPES} 와 같은 집합이다. */
|
|
const CHANGE_TYPES = [
|
|
{ value: "FEATURE", label: "기능" },
|
|
{ value: "FIX", label: "수정" },
|
|
{ value: "REFACTOR", label: "구조" },
|
|
{ value: "DOCS", label: "문서" },
|
|
{ value: "INFRA", label: "인프라" },
|
|
{ value: "BREAKING", label: "호환 깨짐" },
|
|
] as const;
|
|
|
|
const SECTIONS = [
|
|
{ key: "reasonMarkdown", label: "왜 바꿨나" },
|
|
{ key: "changesMarkdown", label: "무엇을 바꿨나" },
|
|
{ key: "userImpactMarkdown", label: "사용자에게 달라지는 것" },
|
|
{ key: "implementationImpactMarkdown", label: "구현에 남는 것" },
|
|
{ key: "verificationMarkdown", label: "어떻게 검증했나" },
|
|
{ key: "knownLimitationsMarkdown", label: "아직 못 한 것" },
|
|
] as const;
|
|
|
|
type Draft = Readonly<{
|
|
expectedVersion: number;
|
|
versionLabel: string;
|
|
title: string;
|
|
summary: string;
|
|
releasedOn: string;
|
|
changeTypes: readonly string[];
|
|
reasonMarkdown: string;
|
|
changesMarkdown: string;
|
|
userImpactMarkdown: string;
|
|
implementationImpactMarkdown: string;
|
|
verificationMarkdown: string;
|
|
knownLimitationsMarkdown: string;
|
|
}>;
|
|
|
|
function toDraft(release: ReleaseEditResponse): Draft {
|
|
return {
|
|
expectedVersion: release.version,
|
|
versionLabel: release.versionLabel,
|
|
title: release.title,
|
|
summary: release.summary ?? "",
|
|
releasedOn: release.releasedOn ?? "",
|
|
changeTypes: release.changeTypes ?? [],
|
|
reasonMarkdown: release.reasonMarkdown ?? "",
|
|
changesMarkdown: release.changesMarkdown ?? "",
|
|
userImpactMarkdown: release.userImpactMarkdown ?? "",
|
|
implementationImpactMarkdown: release.implementationImpactMarkdown ?? "",
|
|
verificationMarkdown: release.verificationMarkdown ?? "",
|
|
knownLimitationsMarkdown: release.knownLimitationsMarkdown ?? "",
|
|
};
|
|
}
|
|
|
|
const STATUS_LABELS: Readonly<Record<string, string>> = {
|
|
DRAFT: "작성 중",
|
|
PUBLISHED: "공개",
|
|
ARCHIVED: "보관",
|
|
};
|
|
|
|
export function ReleaseManager() {
|
|
const { managementGateway, setRequestAnnouncement } = useStudio();
|
|
const [releases, setReleases] = useState<ReleaseIndexItem[] | null>(null);
|
|
const [loading, setLoading] = useState(true);
|
|
const [error, setError] = useState("");
|
|
const [pending, setPending] = useState(false);
|
|
/* 릴리즈는 공개 사이트에 남는 기록이다. 지우기 전에 무엇이 지워지는지 이름으로 보여 준다. */
|
|
const [pendingDelete, setPendingDelete] = useState<ReleaseIndexItem | null>(null);
|
|
const [generation, setGeneration] = useState(0);
|
|
const [newTitle, setNewTitle] = useState("");
|
|
/* 방금 만든 릴리즈를 목록에서 짚어 준다 — 목록이 길면 어느 것이 새것인지 알기 어렵다. */
|
|
const [createdId, setCreatedId] = useState<string | null>(null);
|
|
|
|
const reload = useCallback(() => setGeneration((value) => value + 1), []);
|
|
|
|
useEffect(() => {
|
|
let cancelled = false;
|
|
setLoading(true);
|
|
setError("");
|
|
void managementGateway.listReleases(0, 50).then(
|
|
(page) => {
|
|
if (cancelled) return;
|
|
setReleases(page.items ?? []);
|
|
setLoading(false);
|
|
},
|
|
() => {
|
|
if (cancelled) return;
|
|
setError("릴리즈를 불러오지 못했습니다.");
|
|
setLoading(false);
|
|
},
|
|
);
|
|
return () => {
|
|
cancelled = true;
|
|
};
|
|
}, [managementGateway, generation]);
|
|
|
|
const submitNew = async (event: FormEvent) => {
|
|
event.preventDefault();
|
|
if (pending) return;
|
|
const title = newTitle.trim();
|
|
if (!title) {
|
|
setError("릴리즈 제목을 입력해 주세요.");
|
|
return;
|
|
}
|
|
setPending(true);
|
|
setError("");
|
|
try {
|
|
const created = await managementGateway.createRelease(title);
|
|
setNewTitle("");
|
|
setRequestAnnouncement(
|
|
`릴리즈 ${title} 초안을 만들었습니다. 목록에서 편집을 눌러 내용을 채웁니다.`,
|
|
);
|
|
setCreatedId(created.id);
|
|
reload();
|
|
} catch (error) {
|
|
setError(managementFailureMessage(error, "릴리즈를 만들지 못했습니다."));
|
|
} finally {
|
|
setPending(false);
|
|
}
|
|
};
|
|
|
|
const remove = async (release: ReleaseIndexItem) => {
|
|
if (pending) return;
|
|
setPending(true);
|
|
setError("");
|
|
try {
|
|
await managementGateway.deleteRelease(release.id, release.version);
|
|
setRequestAnnouncement(`릴리즈 ${release.versionLabel} 을(를) 삭제했습니다.`);
|
|
setPendingDelete(null);
|
|
reload();
|
|
} catch (error) {
|
|
setError(managementFailureMessage(error, "삭제하지 못했습니다."));
|
|
} finally {
|
|
setPending(false);
|
|
}
|
|
};
|
|
|
|
return (
|
|
<div className="studio-page studio-documents-page">
|
|
<header className="studio-page-top">
|
|
<div className="studio-page-heading">
|
|
<p className="studio-eyebrow">RELEASES</p>
|
|
<h1>릴리즈</h1>
|
|
<p>무엇을 왜 바꿨는지 버전으로 묶어 공개 변경 기록에 남깁니다.</p>
|
|
</div>
|
|
</header>
|
|
|
|
<section className="studio-document-tools" aria-label="릴리즈 만들기">
|
|
<form onSubmit={submitNew}>
|
|
<label htmlFor="release-new-title">새 릴리즈</label>
|
|
<div>
|
|
<input
|
|
id="release-new-title"
|
|
type="text"
|
|
value={newTitle}
|
|
placeholder="릴리즈 제목"
|
|
onChange={(event) => setNewTitle(event.target.value)}
|
|
/>
|
|
<button type="submit" disabled={pending}>
|
|
추가
|
|
</button>
|
|
</div>
|
|
</form>
|
|
</section>
|
|
|
|
{error ? (
|
|
<p className="studio-screen-error" role="alert">
|
|
{error}
|
|
</p>
|
|
) : null}
|
|
|
|
{loading ? (
|
|
<p className="studio-empty-inline">불러오는 중입니다.</p>
|
|
) : (releases?.length ?? 0) === 0 ? (
|
|
<p className="studio-empty-inline">아직 릴리즈가 없습니다.</p>
|
|
) : (
|
|
<section aria-label="릴리즈 목록">
|
|
<p className="studio-result-count">{releases?.length}개의 릴리즈</p>
|
|
<div className="studio-document-list">
|
|
{(releases ?? []).map((release) => (
|
|
<article
|
|
key={release.id}
|
|
className="studio-document-row"
|
|
aria-current={createdId === release.id ? "true" : undefined}
|
|
>
|
|
{/*
|
|
첫 칸의 유형 라벨은 목록 격자의 첫 열이다. 빠뜨리면 제목이 그 자리로 당겨져
|
|
작업본·주제 목록과 줄이 맞지 않는다.
|
|
*/}
|
|
<p className="studio-row-label">RELEASE</p>
|
|
<div className="studio-document-title">
|
|
<h2>{release.title}</h2>
|
|
{/*
|
|
경로가 비었다고 미공개는 아니다. 예전에는 한 줄 안에서 「상태 공개 · 공개일
|
|
2026-08-22」 옆에 「아직 공개하지 않음」 이 같이 나왔다 — 공개 사이트에는
|
|
실제로 올라가 있었으므로 뒤쪽이 틀렸다. 공개 여부는 아래 「상태」가 말한다.
|
|
*/}
|
|
{release.publication.canonicalPath ? (
|
|
<p>{release.publication.canonicalPath}</p>
|
|
) : null}
|
|
</div>
|
|
<dl>
|
|
<div>
|
|
<dt>버전</dt>
|
|
<dd>{release.versionLabel}</dd>
|
|
</div>
|
|
<div>
|
|
<dt>상태</dt>
|
|
<dd>{STATUS_LABELS[release.workflowStatus] ?? release.workflowStatus}</dd>
|
|
</div>
|
|
<div>
|
|
<dt>공개일</dt>
|
|
<dd>{release.releasedOn || "미정"}</dd>
|
|
</div>
|
|
</dl>
|
|
<div className="studio-row-actions">
|
|
<GuardedStudioLink
|
|
className="studio-secondary-button"
|
|
href={`/studio/releases/${release.id}`}
|
|
>
|
|
편집
|
|
</GuardedStudioLink>
|
|
<button
|
|
className="studio-secondary-button studio-danger-button"
|
|
type="button"
|
|
disabled={pending}
|
|
onClick={() => {
|
|
setError("");
|
|
setPendingDelete(release);
|
|
}}
|
|
>
|
|
삭제
|
|
</button>
|
|
</div>
|
|
</article>
|
|
))}
|
|
</div>
|
|
</section>
|
|
)}
|
|
<DestructiveConfirmDialog
|
|
open={pendingDelete !== null}
|
|
pending={pending}
|
|
title="릴리즈를 삭제합니다"
|
|
targetName={pendingDelete?.versionLabel ?? ""}
|
|
description="공개 사이트의 릴리즈 목록에서도 사라집니다."
|
|
error={error}
|
|
onCancel={() => setPendingDelete(null)}
|
|
onConfirm={() => {
|
|
if (pendingDelete) void remove(pendingDelete);
|
|
}}
|
|
/>
|
|
</div>
|
|
);
|
|
}
|