import { useEffect, useState, type FormEvent } from "react"; import type { ListDocumentsQuery } from "../../../application/ports/studio-gateway.ts"; import type { DocumentPage } from "../../../contracts/studio/contract.ts"; import type { components } from "../../../contracts/studio/generated.ts"; import { managementFailureMessage } from "../../../application/ports/management-gateway-error.ts"; import { useStudio } from "../use-studio.ts"; import { GuardedStudioLink } from "./guarded-studio-link.tsx"; import { StudioPagination } from "./studio-pagination.tsx"; import { DOCUMENT_KIND_LABELS } from "../../shared/document-kind-labels.ts"; type RecordKind = components["schemas"]["RecordKind"]; /* 작업본 목록이 거를 수 있는 종류. 손으로 나열하지 않고 `Record` 에서 뽑는다 — 종류가 늘면 컴파일러가 빈 자리를 잡는다. */ const STUDIO_KIND_ORDER: Record = { CASE: 1, CONCEPT: 2, REFERENCE: 3, QUESTION: 4, PROJECT_DECISION: 5, }; const STUDIO_KINDS: ReadonlyArray = Object.freeze( (Object.keys(STUDIO_KIND_ORDER) as RecordKind[]).sort( (left, right) => STUDIO_KIND_ORDER[left] - STUDIO_KIND_ORDER[right], ), ); const publicationLabel = { NEVER_PUBLISHED: "게시 전", PUBLISHED: "게시 중", UNPUBLISHED: "게시 취소", } as const; const nextLabel = { CONTINUE_EDITING: "작성 계속", VALIDATE: "검증하기", FIX_VALIDATION: "오류 수정", CREATE_PREVIEW: "미리보기", PUBLISH: "게시하기", NONE: "완료", } as const; /** * 다음 단계는 이름만 있고 갈 곳이 없었다. 작성자는 편집 → 검증 → 미리보기 → 게시를 순서대로 * 밟아야만 게시 화면에 닿을 수 있었고, 그 경로 어디에도 "게시" 라는 말이 먼저 보이지 않아 * 게시하는 방법을 알기 어려웠다. 서버가 이미 다음 할 일을 알려 주므로, 그 말을 그대로 링크로 * 만든다. */ const nextHref = { CONTINUE_EDITING: "edit", VALIDATE: "validation", FIX_VALIDATION: "edit", CREATE_PREVIEW: "preview", PUBLISH: "publish", NONE: "", } as const; function isAbortError(error: unknown): boolean { return error instanceof DOMException && error.name === "AbortError"; } export function DocumentList() { const { gateway, managementGateway, setRequestAnnouncement } = useStudio(); const [deletingId, setDeletingId] = useState(null); const [deleteError, setDeleteError] = useState(""); const [searchDraft, setSearchDraft] = useState(""); const [q, setQ] = useState(""); const [kind, setKind] = useState(); const [status, setStatus] = useState(); const [pageNumber, setPageNumber] = useState(1); const [page, setPage] = useState(null); const [loading, setLoading] = useState(true); const [error, setError] = useState(""); const [retryGeneration, setRetryGeneration] = useState(0); /** * 목록 행에는 version 이 없다 (계약의 `DocumentSummary`). 삭제는 expectedVersion 을 요구하므로 * 지우기 직전에 작업본을 한 번 읽어 그 시점의 version 을 쓴다 — 목록을 띄워 둔 채 다른 곳에서 * 수정된 경우 여기서 409 로 걸리는 편이, 목록이 기억하던 낡은 version 으로 지우는 것보다 낫다. */ const removeDocument = async (item: DocumentPage["items"][number]) => { if (deletingId !== null) return; setDeletingId(item.id); setDeleteError(""); try { const detail = await gateway.getDocument(item.id); if (item.kind === "PROJECT_DECISION") { // Decision 은 프로젝트에 속하고 경로가 둘을 요구한다. 목록 행이 프로젝트를 들고 있지 // 않으면 지울 주소를 만들 수 없다 — 그때는 프로젝트를 먼저 지정해야 한다. if (!item.project) { setDeleteError("프로젝트에 속하지 않은 결정은 여기서 지울 수 없습니다. 먼저 프로젝트를 지정해 주세요."); return; } await managementGateway.deleteDecision( item.project.id, item.id, detail.document.version, ); } else { /* 예전에는 여기서 `as "CASE" | "REFERENCE" | "QUESTION"` 으로 종류를 좁혔다. 개념이 더해졌을 때 그 캐스팅이 개념을 가렸고, 게이트웨이의 마지막 else 가 질문 삭제를 부르는 바람에 「질문을 찾을 수 없습니다」가 났다. 캐스팅을 걷어내면 새 종류가 생길 때 타입이 여기서 막는다. */ await managementGateway.deleteDocument( item.kind, item.id, detail.document.version, ); } setRequestAnnouncement(`작업본 ${item.title || "제목 없음"} 을(를) 삭제했습니다.`); // 다시 불러오지 않고 이 행만 지운다. 목록은 커서 페이지네이션이라 재조회하면 다음 // 항목이 빈 자리를 즉시 채우고, 개수도 20 그대로다 — 작성자에게는 삭제가 아무 일도 // 하지 않은 것처럼 보인다. 삭제가 성공한 뒤의 화면은 그 행이 없는 화면이 맞다. setPage((current) => current ? { ...current, items: current.items.filter((row) => row.id !== item.id) } : current, ); } catch (error) { // 서버는 무엇이 막았는지 정확히 알고 그것을 보내 준다. 예전에는 그 문구를 버리고 추측 셋을 // 늘어놓아, 버전 충돌도 "사용 중" 으로 읽혔다. setDeleteError(managementFailureMessage(error, "삭제하지 못했습니다.")); } finally { setDeletingId(null); } }; useEffect(() => { const controller = new AbortController(); setLoading(true); setError(""); void gateway .listDocuments( { ...(q ? { q } : {}), ...(kind ? { kind } : {}), ...(status ? { publicationStatus: status } : {}), page: pageNumber, limit: 20, }, { signal: controller.signal }, ) .then( (value) => { setPage(value); setLoading(false); }, (reason: unknown) => { if (isAbortError(reason)) return; setError("작업본을 불러오지 못했습니다."); setLoading(false); }, ); return () => controller.abort(); }, [gateway, kind, pageNumber, q, retryGeneration, status]); const changeFilter = (next: { kind?: ListDocumentsQuery["kind"]; status?: ListDocumentsQuery["publicationStatus"]; }) => { if ("kind" in next) setKind(next.kind); if ("status" in next) setStatus(next.status); // 3쪽에 있던 채로 필터를 좁히면 결과가 그보다 적어 빈 화면이 나온다. setPageNumber(1); }; const submitSearch = (event: FormEvent) => { event.preventDefault(); setQ(searchDraft.trim()); setPageNumber(1); }; return (

WORKING COPIES

작업본

세션에 있는 검증 기록·동작 원리·적용 기준·열린 질문·설계 결정을 찾고 다음 작업으로 이동합니다.

새 문서
setSearchDraft(event.target.value)} />
{loading ? (

작업본을 불러오는 중입니다.

) : null} {error ? ( <>

{error}

) : null} {page && !loading && !error ? ( <> {/* 이 숫자는 전체가 아니라 이 페이지에 실린 수다. 예전 문구는 그것을 전체처럼 읽히게 해서, 28건 중 20건이 보이는 동안 무엇을 지워도 "20개" 가 그대로였다. */}

{page.page.totalElements}개 중 {page.items.length}개 표시 중 {page.page.totalPages > 1 ? ( {" "} · {page.page.number} / {page.page.totalPages} 쪽 ) : null}

{deleteError ? (

{deleteError}

) : null} {page.items.length ? (
{page.items.map((item) => (

{DOCUMENT_KIND_LABELS[item.kind]}

{item.title || "제목 없는 작업본"}

{item.project?.label ?? "프로젝트 미지정"}

상태
{publicationLabel[item.publicationStatus]}
다음
{nextHref[item.nextAction] ? ( {nextLabel[item.nextAction]} ) : ( nextLabel[item.nextAction] )}
수정
{/* 편집은 제목 링크였고 삭제만 버튼이라, 행에서 눈에 띄는 단 하나가 되돌릴 수 없는 동작이었다. 편집을 같은 격의 버튼으로 올리고 삭제는 그 옆에 둔다. */}
편집
))}
) : (

조건에 맞는 작업본이 없습니다

검색어 또는 필터를 바꾸거나 새 문서를 만드세요.

새 문서 만들기
)} ) : null}
); }