주제 탭 (H1 연장). 홈 탭에 주제를 전부 세우고 목록 아래 「다른 주제 N개 보기」
줄을 없앴다. 축이 둘 이상인 주제만 탭이 되던 규칙 때문에 여섯 중 둘만 올라오고
나머지 넷은 비교표를 다 읽어야 만나는 작은 글씨 한 줄로 갔다. 축은 주제가
자라면서 생기는 것이지 기록이 없다는 뜻이 아니다. 축이 없는 주제는 그 주제의
기록을 세우고, 기록이 없으면 그렇다고 분명히 말한다.
탭 하나가 패널 하나를 가리키게 고쳤다. 탭 전부가 같은 패널을 가리키면 고르지
않은 탭이 "내가 저 패널을 연다" 고 말하면서 패널은 다른 탭의 이름을 달게 된다.
H1. `/studio/documents` 와 `/studio/publications` 의 검색·필터·쪽수를 주소에
담는다. 담지 않던 동안 3쪽에서 문서를 열고 뒤로 오면 1쪽이었고 필터도 사라졌다.
공개 `/search` 는 처음부터 담고 있었다.
H4. 문서 종류 이름을 `document-kind-labels.ts` 하나로 모았다. 세 곳에 흩어져
있어서 같은 CASE 가 목록에서는 「검증 기록」, 새 문서에서는 「Case」, 검색에서는
또 다른 이름이었다.
H5. `project.stage` 가 화면에 `DESIGN` 으로 그대로 새어 나왔다. 같은 프로젝트를
Studio 는 「설계」로 불렀다 — 두 화면이 다른 말을 했다.
H6. 값이 없는데 라벨만 그려지던 자리를 막았다. 네 프로젝트 중 셋이 「현재 목표」
라벨만 있고 값이 비어 있었다.
M2. 대시보드의 숫자를 목록으로 가는 길로 만들고, 할 일이 없는 구역은 그리지
않는다. 공개 홈 설정 폼은 작업 목록 한가운데에서 뒤로 옮겼다.
M3. 작업본 목록에 프로젝트 필터와 정렬을 더했다. 공개 `/explore` 는 독자에게
셋을 주는데 61개를 관리하는 작성자에게는 둘뿐이었다.
M4. 게시 기록의 필터 제출 방식을 작업본 목록에 맞췄다 — 셀렉트는 즉시, 검색만
버튼이다.
M5. MOCK 시절 문구("세션이 끝나면 사라집니다")를 지웠다. 실서버에는 작업본이
남는다.
M7. `aria-current="page"` 가 현재 페이지가 아닌 링크에 붙었다. 정확히 일치할
때만 붙게 하고 구역 강조는 따로 계산한다.
M8. 홈의 첫 화면을 비교표로 바꿨다. 다른 데서 얻을 수 없는 유일한 것이 y≈600 에
묻혀 있었다.
`ListDocumentsQuery.kind` 가 손으로 적은 union 이라 개념과 환경 구성이 빠져
있었다 — 그 둘은 작업본 목록에서 걸러 볼 수가 없었다. 계약 타입으로 바꿨다.
M9 는 고치지 않는다. 「문제·결론이 11px 회색」이라는 지적이 지금 빌드에서
재현되지 않는다 — 실측은 17px `rgb(63,66,73)` 이고 본문이 18px 같은 색이다.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PTnWufiY9ATv57egkKKVAV
173 lines
8.2 KiB
TypeScript
173 lines
8.2 KiB
TypeScript
// @vitest-environment jsdom
|
|
|
|
import { fireEvent, render, screen, waitFor } from "@testing-library/react";
|
|
import userEvent from "@testing-library/user-event";
|
|
import type { ReactNode } from "react";
|
|
import { MemoryRouter, useLocation, useNavigate } 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 type { StudioGateway } from "../../../src/features/tech-log/application/ports/studio-gateway.ts";
|
|
import type { DocumentPage } from "../../../src/features/tech-log/contracts/studio/contract.ts";
|
|
import { DocumentList } from "../../../src/features/tech-log/presentation/studio/components/document-list.tsx";
|
|
import { NewDocumentForm } from "../../../src/features/tech-log/presentation/studio/components/new-document-form.tsx";
|
|
import { StudioDashboard } from "../../../src/features/tech-log/presentation/studio/components/studio-dashboard.tsx";
|
|
import { StudioProvider } from "../../../src/features/tech-log/presentation/studio/studio-provider.tsx";
|
|
import { ApplicationProvider } from "../../../src/presentation/providers/application-provider.tsx";
|
|
import { createTestApplication } from "../../helpers/create-test-application.ts";
|
|
import { createManagementGatewayStub } from "../../helpers/management-gateway-stub.ts";
|
|
|
|
afterEach(() => vi.restoreAllMocks());
|
|
|
|
function LocationProbe() {
|
|
return <output aria-label="현재 경로">{useLocation().pathname}</output>;
|
|
}
|
|
|
|
function RouterStudioProvider({
|
|
children,
|
|
gateway,
|
|
}: Readonly<{ children: ReactNode; gateway: StudioGateway }>) {
|
|
const navigate = useNavigate();
|
|
return (
|
|
<StudioProvider
|
|
createManagementGateway={createManagementGatewayStub}
|
|
createGateway={() => gateway}
|
|
navigate={(href) => {
|
|
void navigate(href);
|
|
}}
|
|
>
|
|
{children}
|
|
</StudioProvider>
|
|
);
|
|
}
|
|
|
|
function renderScreen(children: ReactNode, gateway: StudioGateway) {
|
|
const input = createTechLogFeatureInstalledInput(MOCK_STUDIO_INSTALL_CONTEXT).input;
|
|
return render(
|
|
<ApplicationProvider
|
|
application={createTestApplication({
|
|
featureInputs: { "tech-log": { ...input, createStudioGateway: () => gateway } },
|
|
})}
|
|
>
|
|
<MemoryRouter initialEntries={["/studio"]}>
|
|
<RouterStudioProvider gateway={gateway}>{children}</RouterStudioProvider>
|
|
</MemoryRouter>
|
|
</ApplicationProvider>,
|
|
);
|
|
}
|
|
|
|
describe("TechLog Studio index screens", () => {
|
|
it("shows the source dashboard totals, workflow sections, status links, and sample rows", async () => {
|
|
const gateway = createTechLogFeatureInstalledInput(MOCK_STUDIO_INSTALL_CONTEXT).input.createStudioGateway();
|
|
|
|
const { container } = renderScreen(<StudioDashboard />, gateway);
|
|
|
|
const summary = await screen.findByLabelText("Studio 요약");
|
|
expect(summary).toHaveTextContent("전체 작업본7");
|
|
expect(summary).toHaveTextContent("검증할 기록5");
|
|
expect(summary).toHaveTextContent("게시 준비0");
|
|
expect(summary).toHaveTextContent("게시 기록4");
|
|
expect(screen.getByRole("heading", { level: 1, name: "작업 흐름" })).toBeVisible();
|
|
expect(
|
|
Array.from(container.querySelectorAll(".studio-section-title a"), (link) => [
|
|
link.textContent,
|
|
link.getAttribute("href"),
|
|
]),
|
|
/*
|
|
할 일이 있는 구역만 그린다. 픽스처에서 「게시 준비」는 0건이므로 그 구역은 없다 — 예전에는
|
|
세 구역이 각각 ~150px 를 쓰면서 "없습니다" 를 말했고, 대시보드의 절반이 할 일이 없다는
|
|
말이었다.
|
|
*/
|
|
).toEqual([
|
|
["전체 보기", "/studio/documents"],
|
|
["게시 기록 보기", "/studio/publications"],
|
|
]);
|
|
expect(screen.getAllByText("컬렉션 Fetch Join과 페이징은 왜 충돌하는가").length).toBeGreaterThan(0);
|
|
});
|
|
|
|
it("searches and filters documents and renders the source empty state", async () => {
|
|
const gateway = createTechLogFeatureInstalledInput(MOCK_STUDIO_INSTALL_CONTEXT).input.createStudioGateway();
|
|
renderScreen(<DocumentList />, gateway);
|
|
|
|
expect(await screen.findByText("7개 중 7개 표시 중")).toBeVisible();
|
|
fireEvent.change(screen.getByLabelText("검색"), { target: { value: "Fetch Join" } });
|
|
fireEvent.submit(screen.getByRole("search"));
|
|
expect(await screen.findByText("1개 중 1개 표시 중")).toBeVisible();
|
|
expect(screen.getByText("컬렉션 Fetch Join과 페이징은 왜 충돌하는가")).toBeVisible();
|
|
|
|
fireEvent.change(screen.getByLabelText("종류"), { target: { value: "QUESTION" } });
|
|
expect(await screen.findByText("0개 중 0개 표시 중")).toBeVisible();
|
|
expect(screen.getByRole("heading", { level: 2, name: "조건에 맞는 작업본이 없습니다" })).toBeVisible();
|
|
});
|
|
|
|
it("cancels an obsolete list request and moves between numbered pages", async () => {
|
|
const base = createTechLogFeatureInstalledInput(MOCK_STUDIO_INSTALL_CONTEXT).input.createStudioGateway();
|
|
const all = await base.listDocuments({ limit: 20 });
|
|
let obsoleteSignal: AbortSignal | undefined;
|
|
const meta = (number: number) => ({
|
|
number, size: 20, totalElements: 2, totalPages: 2,
|
|
hasPrevious: number > 1, hasNext: number < 2,
|
|
});
|
|
const firstPage: DocumentPage = { items: all.items.slice(0, 1), nextCursor: null, page: meta(1) };
|
|
const secondPage: DocumentPage = { items: all.items.slice(1, 2), nextCursor: null, page: meta(2) };
|
|
const listDocuments = vi.fn<StudioGateway["listDocuments"]>()
|
|
.mockImplementationOnce((_query, { signal } = {}) => {
|
|
obsoleteSignal = signal;
|
|
return new Promise(() => {});
|
|
})
|
|
.mockResolvedValueOnce(firstPage)
|
|
.mockResolvedValueOnce(secondPage);
|
|
const gateway = { ...base, listDocuments } satisfies StudioGateway;
|
|
renderScreen(<DocumentList />, gateway);
|
|
|
|
fireEvent.change(screen.getByLabelText("종류"), { target: { value: "CASE" } });
|
|
await waitFor(() => expect(obsoleteSignal?.aborted).toBe(true));
|
|
expect(await screen.findByText("2개 중 1개 표시 중")).toBeVisible();
|
|
|
|
// 번호로 옮긴다 — 예전에는 「다음」 하나뿐이라 2쪽에서 1쪽으로 돌아올 방법이 없었다.
|
|
await userEvent.click(screen.getByRole("button", { name: "2 페이지" }));
|
|
await waitFor(() => expect(listDocuments).toHaveBeenCalledTimes(3));
|
|
expect(screen.getByText(secondPage.items[0]!.title)).toBeVisible();
|
|
expect(screen.getByRole("button", { name: "1 페이지" })).toBeEnabled();
|
|
expect(screen.getByRole("button", { name: "이전 페이지" })).toBeEnabled();
|
|
});
|
|
|
|
it("shows a retry action after a list failure and recovers", async () => {
|
|
const user = userEvent.setup();
|
|
const base = createTechLogFeatureInstalledInput(MOCK_STUDIO_INSTALL_CONTEXT).input.createStudioGateway();
|
|
const recovered = await base.listDocuments({ limit: 20 });
|
|
const gateway = {
|
|
...base,
|
|
listDocuments: vi.fn<StudioGateway["listDocuments"]>()
|
|
.mockRejectedValueOnce(new Error("offline"))
|
|
.mockResolvedValueOnce(recovered),
|
|
} satisfies StudioGateway;
|
|
renderScreen(<DocumentList />, gateway);
|
|
|
|
expect(await screen.findByRole("alert")).toHaveTextContent("작업본을 불러오지 못했습니다.");
|
|
await user.click(screen.getByRole("button", { name: "다시 시도" }));
|
|
|
|
expect(await screen.findByText("7개 중 7개 표시 중")).toBeVisible();
|
|
expect(gateway.listDocuments).toHaveBeenCalledTimes(2);
|
|
});
|
|
|
|
it("creates the selected Question in the same session and redirects to its editor", async () => {
|
|
const user = userEvent.setup();
|
|
const gateway = createTechLogFeatureInstalledInput(MOCK_STUDIO_INSTALL_CONTEXT).input.createStudioGateway();
|
|
renderScreen(
|
|
<>
|
|
<NewDocumentForm />
|
|
<LocationProbe />
|
|
</>,
|
|
gateway,
|
|
);
|
|
|
|
await user.click(screen.getByRole("radio", { name: /열린 질문/ }));
|
|
await user.click(screen.getByRole("button", { name: "작업본 만들기" }));
|
|
|
|
await waitFor(() => expect(screen.getByLabelText("현재 경로")).toHaveTextContent(/^\/studio\/documents\/[0-9a-f-]+\/edit$/));
|
|
expect((await gateway.listDocuments({ kind: "QUESTION" })).items).toHaveLength(2);
|
|
});
|
|
});
|