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"; /** * 릴리즈 작성. * *

공개 사이트에 변경 기록 화면과 푸터 링크가 있는데 둘 다 비어 있었다 — 읽기는 처음부터 * 있었고 쓰는 곳이 없었다. 그래서 이 화면의 범위는 목록·작성·발행이다. * *

본문이 마크다운 여섯 칸으로 나뉜 것은 계약의 모양이자 릴리즈 노트의 성격이다. 한 칸짜리 * 자유 서술이었다면 "검증을 안 썼다"를 아무도 알아채지 못한다. * *

새 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> = { DRAFT: "작성 중", PUBLISHED: "공개", ARCHIVED: "보관", }; export function ReleaseManager() { const { managementGateway, setRequestAnnouncement } = useStudio(); const [releases, setReleases] = useState(null); const [loading, setLoading] = useState(true); const [error, setError] = useState(""); const [pending, setPending] = useState(false); /* 릴리즈는 공개 사이트에 남는 기록이다. 지우기 전에 무엇이 지워지는지 이름으로 보여 준다. */ const [pendingDelete, setPendingDelete] = useState(null); const [generation, setGeneration] = useState(0); const [newTitle, setNewTitle] = useState(""); /* 방금 만든 릴리즈를 목록에서 짚어 준다 — 목록이 길면 어느 것이 새것인지 알기 어렵다. */ const [createdId, setCreatedId] = useState(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 (

RELEASES

릴리즈

무엇을 왜 바꿨는지 버전으로 묶어 공개 변경 기록에 남깁니다.

setNewTitle(event.target.value)} />
{error ? (

{error}

) : null} {loading ? (

불러오는 중입니다.

) : (releases?.length ?? 0) === 0 ? (

아직 릴리즈가 없습니다.

) : (

{releases?.length}개의 릴리즈

{(releases ?? []).map((release) => (
{/* 첫 칸의 유형 라벨은 목록 격자의 첫 열이다. 빠뜨리면 제목이 그 자리로 당겨져 작업본·주제 목록과 줄이 맞지 않는다. */}

RELEASE

{release.title}

{/* 경로가 비었다고 미공개는 아니다. 예전에는 한 줄 안에서 「상태 공개 · 공개일 2026-08-22」 옆에 「아직 공개하지 않음」 이 같이 나왔다 — 공개 사이트에는 실제로 올라가 있었으므로 뒤쪽이 틀렸다. 공개 여부는 아래 「상태」가 말한다. */} {release.publication.canonicalPath ? (

{release.publication.canonicalPath}

) : null}
버전
{release.versionLabel}
상태
{STATUS_LABELS[release.workflowStatus] ?? release.workflowStatus}
공개일
{release.releasedOn || "미정"}
편집
))}
)} setPendingDelete(null)} onConfirm={() => { if (pendingDelete) void remove(pendingDelete); }} />
); }