Files
tech-log-frontend/tests/features/tech-log/studio-editor-smoke.test.tsx
T
DongHyeonkaandClaude Opus 5 82e992d066 fix: Studio 리뷰 지적을 반영하고 죽은 머리말 컴포넌트를 걷어낸다
에디터 칸 이름을 공개 화면과 맞춘다. 목적→이 기준을 쓰는 이유, 규칙→판단
기준, 적용 조건→적용할 때, 예외→예외와 주의, 사실→확인한 사실,
미지수→남은 미지수, 선택지→검토한 선택지. 쓰는 사람이 지금 채우는 칸이
공개 화면 어디로 가는지 외우지 않아도 된다.

대시보드의 세 칸이 같은 목록을 세 번 반복했다. 「검증과 미리보기」와
「게시 준비」가 「이어서 작성」을 걸러 낸 부분집합인데 「이어서 작성」은
전체를 그대로 그렸기 때문이다 — 모든 문서가 같은 단계면 세 칸이 겹친다.
각 문서는 지금 서 있는 구간 한 곳에만 나온다.

릴리스에서 「상태 공개 · 공개일 2026-08-22」 옆에 「아직 공개하지 않음」이
같이 나왔다. 경로가 비었다고 미공개는 아니다 — 공개 여부는 상태가 말한다.

행에서 눈에 띄는 단 하나가 되돌릴 수 없는 동작이었다. 편집을 같은 격의
버튼으로 올리고, 삭제는 danger 로 낮추고, 격자에 자리를 만들어 다음 줄로
떨어지지 않게 한다. 게시 기록이 이미 그 모양이었다.

주제·프로젝트는 「다음: 내용 편집」을 안내하면서 그 줄의 버튼은 게시 취소와
삭제뿐이었다. 공개 프로젝트 화면이 비어 있던 이유가 여기다.

죽은 코드였던 PublicDocumentHeader 를 걷어낸다. 화면을 실제로 그리는 것은
PublicRecordRenderer 이고 그 컴포넌트는 아무도 부르지 않았다 — 어제 이
컴포넌트에 줄바꿈을 고쳐 넣었지만 화면에는 닿지 않았다. 그 자리를 지키던
가드도 진짜로 그려지는 쪽으로 옮긴다.

탭 제목과 설명에 문서를 반영한다. 공개 문서가 전부 "Reference · Tech Log"
였고 설명은 모든 화면이 "Tech Log frontend" 하나였다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011nAjrqNHGPNngN4aUbcyvJ
2026-08-31 09:01:03 +09:00

304 lines
15 KiB
TypeScript

// @vitest-environment jsdom
import { fireEvent, render, screen, waitFor, within } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
import type { ReactNode } from "react";
import { MemoryRouter } from "react-router-dom";
import { afterEach, describe, expect, it, vi } from "vitest";
import { createTechLogFeatureInstalledInput } from "../../../src/features/tech-log/adapters/create-tech-log-feature-input.ts";
import { MOCK_STUDIO_INSTALL_CONTEXT } from "../../helpers/studio-install-context.ts";
import { FIXTURE_IDS } from "../../../src/features/tech-log/adapters/mock/fixtures.ts";
import type { StudioGateway } from "../../../src/features/tech-log/application/ports/studio-gateway.ts";
import { DocumentEditorScreen } from "../../../src/features/tech-log/presentation/studio/components/document-editor-screen.tsx";
import { StudioProvider } from "../../../src/features/tech-log/presentation/studio/studio-provider.tsx";
import { createManagementGatewayStub } from "../../helpers/management-gateway-stub.ts";
afterEach(() => vi.restoreAllMocks());
function renderEditor(
documentId: string,
gateway: StudioGateway = createTechLogFeatureInstalledInput(MOCK_STUDIO_INSTALL_CONTEXT).input.createStudioGateway(),
) {
// CASE editors mount the Asset Picker (Task 10), which uses the throwing
// `useStudioAssetGateway()` accessor -- a test harness that renders it must
// supply `createAssetGateway`, the same as `StudioShell` always does.
const assetGateway = createTechLogFeatureInstalledInput(MOCK_STUDIO_INSTALL_CONTEXT)
.input.createStudioAssetGateway();
return render(
<MemoryRouter initialEntries={[`/studio/documents/${documentId}/edit`]}>
<StudioProvider
createManagementGateway={createManagementGatewayStub} createGateway={() => gateway} createAssetGateway={() => assetGateway}>
<DocumentEditorScreen documentId={documentId} />
</StudioProvider>
</MemoryRouter>,
);
}
function labelsIn(container: HTMLElement, selector: string): string[] {
return Array.from(
container.querySelectorAll<HTMLElement>(selector),
// 칸 이름은 보통 `<label><span>이름</span>` 이지만, 요약처럼 label 을 htmlFor 로 잇는
// 칸도 있다 — 두 모양 다 같은 이름 목록에 실려야 순서를 볼 수 있다.
(field) => field.querySelector(":scope > span, :scope > label")?.textContent ?? "",
);
}
describe("TechLog Studio document editor", () => {
it("loads the Case controls in source order, owns dirty state, and renders an instant local preview", async () => {
const user = userEvent.setup();
const base = createTechLogFeatureInstalledInput(MOCK_STUDIO_INSTALL_CONTEXT).input.createStudioGateway();
const calls = { save: 0, validate: 0, preview: 0, publish: 0 };
const gateway = {
...base,
saveDocument(...args: Parameters<StudioGateway["saveDocument"]>) {
calls.save += 1;
return base.saveDocument(...args);
},
validateDocument(...args: Parameters<StudioGateway["validateDocument"]>) {
calls.validate += 1;
return base.validateDocument(...args);
},
createPreview(...args: Parameters<StudioGateway["createPreview"]>) {
calls.preview += 1;
return base.createPreview(...args);
},
publishDocument(...args: Parameters<StudioGateway["publishDocument"]>) {
calls.publish += 1;
return base.publishDocument(...args);
},
} satisfies StudioGateway;
const view = renderEditor(FIXTURE_IDS.redisAdapterCase, gateway);
expect(await screen.findByLabelText("제목")).toHaveValue(
"Redis Adapter가 도메인 TTL 정책을 소유하지 않는 이유",
);
expect(screen.getByLabelText("slug")).toHaveValue("redis-adapter-ttl-boundary");
expect(screen.getByLabelText("요약")).toHaveValue(
"만료 정책과 명령 실행 책임을 분리했습니다.",
);
expect(screen.getByLabelText("Topic")).toHaveValue(FIXTURE_IDS.topicRedis);
expect(screen.getByLabelText("Project")).toHaveValue(FIXTURE_IDS.projectBackend);
expect(labelsIn(view.container, ".studio-field")).toEqual([
"제목",
"slug",
"요약",
"Topic",
"Project",
"문제",
"결론",
"검증 환경",
"재현 조건",
"마지막 검증일",
"본문 Markdown",
]);
expect(screen.getByLabelText("문제")).toHaveValue("저장 기술이 정책을 소유했습니다.");
expect(screen.getByLabelText("본문 Markdown")).toHaveValue(
"## 책임 경계\n\n정책과 명령을 분리합니다.",
);
expect(screen.getByRole("status", { name: "편집 상태" })).toHaveTextContent("저장됨");
await user.clear(screen.getByLabelText("제목"));
await user.type(screen.getByLabelText("제목"), "편집한 Redis 경계");
expect(screen.getByRole("status", { name: "편집 상태" })).toHaveTextContent(
"저장되지 않음",
);
/*
종류 이름은 모든 화면이 같은 표를 본다. 예전에는 화면마다 표를 복사해 두어 같은 문서가
편집기에서 "CASE", 목록에서 "Case", 공개 화면에서 "Case" 로 갈렸다 — QUESTION 은 네
가지 표기까지 났다.
*/
expect(screen.getByRole("complementary", { name: "작업 상태" })).toHaveTextContent(
"저장 버전4종류Case",
);
// 작성자가 밟는 단계는 저장과 게시 둘뿐이다. 예전에는 검증 → 미리보기 → 게시 세 화면을
// 차례로 거쳐야 했는데, 그 셋은 백엔드가 게시 요청에 요구하는 값을 만들기 위한 것이지
// 작성자에게 물어볼 것이 아니었다 — 지금은 게시 버튼 뒤에서 잇달아 부른다.
const rail = screen.getByRole("complementary", { name: "작업 상태" });
expect(within(rail).getAllByRole("button").map((button) => button.textContent)).toEqual([
"저장",
"게시",
]);
expect(within(rail).queryAllByRole("link")).toHaveLength(0);
// 편집과 미리보기는 한 화면에 함께 있다. 탭이었을 때는 고친 결과를 보려면 편집하던 자리를
// 화면에서 치워야 했고, 돌아오면 스크롤 위치도 잃었다 — 그 왕복이 없어야 한다는 것이
// 이 화면의 요구다. 아무것도 누르지 않은 채로 둘 다 보이는지 묻는다.
expect(screen.getByRole("region", { name: "문서 편집" })).toBeVisible();
expect(
within(screen.getByRole("region", { name: "즉시 미리보기" })).getByRole(
"heading",
{ level: 1, name: "편집한 Redis 경계" },
),
).toBeVisible();
expect(screen.queryByRole("tab", { name: "즉시 미리보기" })).toBeNull();
expect(screen.getByLabelText("제목")).toHaveValue("편집한 Redis 경계");
expect(calls).toEqual({ save: 0, validate: 0, preview: 0, publish: 0 });
});
it("adds, reorders, and removes relations with source accessibility names", async () => {
const user = userEvent.setup();
renderEditor(FIXTURE_IDS.redisAdapterCase);
await screen.findByLabelText("제목");
await user.click(screen.getByRole("button", { name: "관계 추가" }));
await user.click(screen.getByRole("button", { name: "관계 추가" }));
await user.selectOptions(
screen.getByLabelText("관계 1 대상"),
FIXTURE_IDS.fetchJoinCase,
);
await user.type(screen.getByLabelText("관계 1 이유"), "첫 번째 근거");
await user.selectOptions(
screen.getByLabelText("관계 2 대상"),
FIXTURE_IDS.stateNonceReference,
);
await user.type(screen.getByLabelText("관계 2 이유"), "두 번째 근거");
const relationRows = screen.getAllByLabelText(/관계 \d 대상/).map((select) =>
select.closest(".studio-relation-item") as HTMLElement,
);
await user.click(within(relationRows[1]!).getByRole("button", { name: "위로" }));
expect(screen.getByLabelText("관계 1 대상")).toHaveValue(
FIXTURE_IDS.stateNonceReference,
);
expect(screen.getByLabelText("관계 1 이유")).toHaveValue("두 번째 근거");
const firstRow = screen.getByLabelText("관계 1 대상").closest(
".studio-relation-item",
) as HTMLElement;
await user.click(within(firstRow).getByRole("button", { name: "삭제" }));
expect(screen.getByLabelText("관계 1 대상")).toHaveValue(FIXTURE_IDS.fetchJoinCase);
expect(screen.queryByLabelText("관계 2 대상")).not.toBeInTheDocument();
});
it("preserves Reference loaded values and ordered rule/text-list behavior", async () => {
const user = userEvent.setup();
renderEditor(FIXTURE_IDS.stateNonceReference);
/*
에디터 라벨이 공개 화면의 절 제목과 같아졌으므로(작성자가 매핑을 외우지 않도록), 미리보기의
`<section aria-labelledby>` 와 이름이 겹친다. 여기서 보려는 것은 입력 칸이다.
*/
expect(
await screen.findByRole("textbox", { name: "이 기준을 쓰는 이유" }),
).toHaveValue(
"각 검증값의 책임을 다시 찾는 기준입니다.",
);
expect(screen.getByLabelText("판단 기준 1 제목")).toHaveValue("state는 요청을 연결합니다");
expect(screen.getByLabelText("적용할 때 1")).toHaveValue("Code Flow를 구성할 때");
expect(screen.getByLabelText("마지막 검증일")).toHaveValue("2026-08-13");
expect(screen.getByText("아직 입력한 항목이 없습니다.")).toBeVisible();
await user.click(screen.getByRole("button", { name: "판단 기준 추가" }));
await user.type(screen.getByLabelText("판단 기준 2 제목"), "nonce는 Token을 연결합니다");
const secondRule = screen.getByLabelText("판단 기준 2 제목").closest(
".studio-ordered-item",
) as HTMLElement;
await user.click(within(secondRule).getByRole("button", { name: "위로" }));
expect(screen.getByLabelText("판단 기준 1 제목")).toHaveValue(
"nonce는 Token을 연결합니다",
);
await user.click(
within(
screen.getByLabelText("판단 기준 1 제목").closest(".studio-ordered-item") as HTMLElement,
).getByRole("button", { name: "삭제" }),
);
expect(screen.getByLabelText("판단 기준 1 제목")).toHaveValue("state는 요청을 연결합니다");
await user.click(screen.getByRole("button", { name: "적용할 때 추가" }));
await user.type(screen.getByLabelText("적용할 때 2"), "두 번째 적용 조건");
const secondApplyWhen = screen.getByLabelText("적용할 때 2").closest(
".studio-ordered-item",
) as HTMLElement;
await user.click(within(secondApplyWhen).getByRole("button", { name: "위로" }));
expect(screen.getByLabelText("적용할 때 1")).toHaveValue("두 번째 적용 조건");
await user.click(
within(
screen.getByLabelText("적용할 때 1").closest(".studio-ordered-item") as HTMLElement,
).getByRole("button", { name: "삭제" }),
);
expect(screen.getByLabelText("적용할 때 1")).toHaveValue("Code Flow를 구성할 때");
expect(screen.getByRole("status", { name: "편집 상태" })).toHaveTextContent(
"저장되지 않음",
);
});
it("preserves Question field differences, list controls, and conditional resolution fields", async () => {
const user = userEvent.setup();
renderEditor(FIXTURE_IDS.edgeTokenQuestion);
expect(await screen.findByLabelText("질문 상태")).toHaveValue("OPEN");
expect(screen.getByLabelText("남은 미지수 1")).toHaveValue("신뢰 헤더 위조 가능성");
expect(screen.getByRole("textbox", { name: "다음 검증" })).toHaveValue(
"위협 모델을 비교합니다.",
);
expect(screen.queryByLabelText("해결 요약")).not.toBeInTheDocument();
await user.click(screen.getByRole("button", { name: "확인한 사실 추가" }));
await user.type(screen.getByLabelText("확인한 사실 1"), "Edge가 서명을 검증합니다");
await user.click(screen.getByRole("button", { name: "선택지 추가" }));
expect(screen.getByLabelText("선택지 1 제목")).toHaveValue("");
expect(screen.getByLabelText("선택지 1 설명")).toHaveValue("");
await user.selectOptions(screen.getByLabelText("질문 상태"), "RESOLVED");
expect(screen.getByLabelText("해결 요약")).toHaveValue("");
expect(screen.getByLabelText("해결 근거")).toHaveValue("");
expect(screen.getByLabelText("근거 링크 문구")).toHaveValue("");
expect(screen.getByRole("status", { name: "편집 상태" })).toHaveTextContent(
"저장되지 않음",
);
});
it("shows how much of the summary limit is left and keeps that limit at the contract's", async () => {
renderEditor(FIXTURE_IDS.edgeTokenQuestion);
const summary = await screen.findByLabelText("요약");
/*
계약 WorkingCopyInputBase.summary 와 같은 값이어야 한다. 300 이던 시절 이 칸은 문장
중간에서 말없이 입력을 멈췄고, 쓰는 사람에게는 키보드가 고장 난 것처럼 보였다.
*/
expect(summary).toHaveAttribute("maxlength", "2000");
// 목록 카드는 요약을 세 줄에서 자른다 — 작성자에게 그 경계를 알린다.
expect(screen.getByText(/목록 카드에는 약 90자까지 보입니다/u)).toBeInTheDocument();
fireEvent.change(summary, { target: { value: "가".repeat(412) } });
expect(screen.getByText(/412 \/ 2000/u)).toBeInTheDocument();
expect(
screen.queryByText(/2000자까지 모두 썼습니다/),
).not.toBeInTheDocument();
fireEvent.change(summary, { target: { value: "가".repeat(2000) } });
expect(screen.getByText(/2000 \/ 2000/u)).toBeInTheDocument();
// 한계에 닿았을 때만 알린다 — 글자마다 읽어 주면 받아쓰기가 된다.
expect(screen.getByText(/2000자까지 모두 썼습니다/)).toBeInTheDocument();
// 글자 수는 칸의 이름에 섞이지 않아야 한다. 섞이면 이름이 타자마다 바뀐다.
expect(screen.getByLabelText("요약")).toBe(summary);
});
it("renders source not-found and retry surfaces for document loading", async () => {
const unknown = renderEditor("aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa");
expect(
await screen.findByRole("heading", { name: "Studio 화면을 찾을 수 없습니다" }),
).toBeVisible();
expect(screen.getByRole("link", { name: "작업본으로 돌아가기" })).toHaveAttribute(
"href",
"/studio/documents",
);
unknown.unmount();
const base = createTechLogFeatureInstalledInput(MOCK_STUDIO_INSTALL_CONTEXT).input.createStudioGateway();
const getDocument = vi
.fn<StudioGateway["getDocument"]>()
.mockRejectedValueOnce(new Error("offline"))
.mockImplementation((id, options) => base.getDocument(id, options));
renderEditor(FIXTURE_IDS.redisAdapterCase, { ...base, getDocument });
expect(await screen.findByRole("alert")).toHaveTextContent(
"문서를 불러오지 못했습니다offline",
);
fireEvent.click(screen.getByRole("button", { name: "다시 시도" }));
await waitFor(() => expect(screen.getByLabelText("제목")).toBeVisible());
expect(getDocument).toHaveBeenCalledTimes(2);
});
});