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
This commit is contained in:
DongHyeonka
2026-08-31 09:01:03 +09:00
co-authored by Claude Opus 5
parent ca1fc92e6d
commit 82e992d066
15 changed files with 211 additions and 121 deletions
@@ -175,43 +175,49 @@ describe("TechLog Studio document editor", () => {
const user = userEvent.setup();
renderEditor(FIXTURE_IDS.stateNonceReference);
expect(await screen.findByLabelText("목적")).toHaveValue(
/*
에디터 라벨이 공개 화면의 절 제목과 같아졌으므로(작성자가 매핑을 외우지 않도록), 미리보기의
`<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("판단 기준 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(
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(
expect(screen.getByLabelText("판단 기준 1 제목")).toHaveValue(
"nonce는 Token을 연결합니다",
);
await user.click(
within(
screen.getByLabelText("규칙 1 제목").closest(".studio-ordered-item") as HTMLElement,
screen.getByLabelText("판단 기준 1 제목").closest(".studio-ordered-item") as HTMLElement,
).getByRole("button", { name: "삭제" }),
);
expect(screen.getByLabelText("규칙 1 제목")).toHaveValue("state는 요청을 연결합니다");
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(
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("두 번째 적용 조건");
expect(screen.getByLabelText("적용할 때 1")).toHaveValue("두 번째 적용 조건");
await user.click(
within(
screen.getByLabelText("적용 조건 1").closest(".studio-ordered-item") as HTMLElement,
screen.getByLabelText("적용할 때 1").closest(".studio-ordered-item") as HTMLElement,
).getByRole("button", { name: "삭제" }),
);
expect(screen.getByLabelText("적용 조건 1")).toHaveValue("Code Flow를 구성할 때");
expect(screen.getByLabelText("적용할 때 1")).toHaveValue("Code Flow를 구성할 때");
expect(screen.getByRole("status", { name: "편집 상태" })).toHaveTextContent(
"저장되지 않음",
);
@@ -222,14 +228,14 @@ describe("TechLog Studio document editor", () => {
renderEditor(FIXTURE_IDS.edgeTokenQuestion);
expect(await screen.findByLabelText("질문 상태")).toHaveValue("OPEN");
expect(screen.getByLabelText("미지수 1")).toHaveValue("신뢰 헤더 위조 가능성");
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: "확인한 사실 추가" }));
await user.type(screen.getByLabelText("확인한 사실 1"), "Edge가 서명을 검증합니다");
await user.click(screen.getByRole("button", { name: "선택지 추가" }));
expect(screen.getByLabelText("선택지 1 제목")).toHaveValue("");
expect(screen.getByLabelText("선택지 1 설명")).toHaveValue("");
@@ -252,15 +258,17 @@ describe("TechLog Studio document editor", () => {
중간에서 말없이 입력을 멈췄고, 쓰는 사람에게는 키보드가 고장 난 것처럼 보였다.
*/
expect(summary).toHaveAttribute("maxlength", "2000");
// 목록 카드는 요약을 세 줄에서 자른다 — 작성자에게 그 경계를 알린다.
expect(screen.getByText(/목록 카드에는 약 90자까지 보입니다/u)).toBeInTheDocument();
fireEvent.change(summary, { target: { value: "가".repeat(412) } });
expect(screen.getByText("412 / 2000")).toBeInTheDocument();
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")).toBeInTheDocument();
expect(screen.getByText(/2000 \/ 2000/u)).toBeInTheDocument();
// 한계에 닿았을 때만 알린다 — 글자마다 읽어 주면 받아쓰기가 된다.
expect(screen.getByText(/2000자까지 모두 썼습니다/)).toBeInTheDocument();