Carries 359 template commits, tag v0.2.0 plus one documentation commit: the generator-built feature index with its app, bounded-context and feature declarations, the src/platform kernel and scale tooling, the 2026-09-24 src review fixes, and the 2026-09-25 maturity review round with its CHANGELOG [보안]/[계약] rows. 691 of the 824 template paths are applied, 85 of them merged with product changes; 127 are not carried. Product identity is unchanged: name, version 0.1.0, routes, design and the TechLog domain. Three decisions worth naming. TechLog stays composed directly, as the last two syncs recorded; its directory carries a NOT_INSTALLED marker that says so, and every installed-* composer takes the template's projection with TechLog added on top. The reference sample is no longer installed: the template now installs a feature only through feature-module.ts and context-routes.ts, which load the screens this product deleted, so its three operations, six schemas and one topic leave the registries, recorded as registry change evidence. And AppRouter mounts the platform and TechLog routes only; the template's bounded-context route gateway waits for a generator-installed feature. Required fixes: readSubject on the BFF session owner (without it every HTTP Studio session would close as integration-failed), zod through the facade in nine TechLog files, noUnusedLocals, and public/config.json written out to match the local profile. Derived baselines were recomputed after reproducing both sides' values: CI contract 101 commands / 106 references / 141 artifacts, gate shape c9adcf85; registry approval 2dc6c3a3; the runtime config schema baseline equals the schema at8210d48. Verified here: types, lint, architecture, adapter inventory, CI contract, i18n, design system, diagnostics, browser security, dev release manifest, TechLog contract and build pass; 220 component, 155 integration, 15 contract, 418 TechLog, 43 reference-feature, 18 recipe and 46 release-coherence tests pass, and 2381 of 2383 unit tests. Reproduced at8210d48first and unchanged: check:registries (byte-identical), test:runtime-schema, verify:documentation. Brought by the template and escalated rather than suppressed: check:request-fanout on TechLog's cursor pagination, check:remediation-ledger (fails upstream too), the shared-chunk hash test, and the registry-dependent sample removal and second-feature tests. Playwright suites were not run. Full record, the five open questions and the follow-ups in docs/operations/template-sync-2026-09-29.md. (cherry picked from commit b2170cf265dea45dc9cc05d3c61e627e97f31cdb)
303 lines
15 KiB
TypeScript
303 lines
15 KiB
TypeScript
// @vitest-environment jsdom
|
|
|
|
import { fireEvent, render as testingRender, screen, waitFor, within } from "@testing-library/react";
|
|
import userEvent from "@testing-library/user-event";
|
|
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 "../../helpers/studio-test-provider.tsx";
|
|
import { createManagementGatewayStub } from "../../helpers/management-gateway-stub.ts";
|
|
import { TestQueryProviders } from "../../helpers/query-providers.tsx";
|
|
import { DEFAULT_STUDIO_MOCK_NOW } from "../../../src/features/tech-log/adapters/mock/mock-studio-gateway.ts";
|
|
|
|
import { studioAssetGatewayFromApplication, studioGatewayFromApplication } from "../../helpers/studio-application-gateway-adapter.ts";
|
|
function render(ui: Parameters<typeof testingRender>[0]) {
|
|
return testingRender(ui, { wrapper: TestQueryProviders });
|
|
}
|
|
|
|
afterEach(() => vi.restoreAllMocks());
|
|
|
|
function renderEditor(
|
|
documentId: string,
|
|
gateway: StudioGateway = studioGatewayFromApplication(createTechLogFeatureInstalledInput(MOCK_STUDIO_INSTALL_CONTEXT).input.createStudioApplication()),
|
|
) {
|
|
// 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 = studioAssetGatewayFromApplication(
|
|
createTechLogFeatureInstalledInput(MOCK_STUDIO_INSTALL_CONTEXT)
|
|
.input.createStudioApplication(),
|
|
);
|
|
return render(
|
|
<MemoryRouter initialEntries={[`/studio/documents/${documentId}/edit`]}>
|
|
<StudioProvider now={() => new Date(DEFAULT_STUDIO_MOCK_NOW)}
|
|
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 ?? "",
|
|
);
|
|
}
|
|
|
|
function markdownSource(container: HTMLElement): HTMLTextAreaElement {
|
|
const source = container.querySelector<HTMLTextAreaElement>(".studio-markdown-source");
|
|
if (!source) throw new Error("single-surface Markdown source not found");
|
|
return source;
|
|
}
|
|
|
|
describe("TechLog Studio document editor", () => {
|
|
it("loads the Case as one document surface and owns dirty state without an editor preview mode", async () => {
|
|
const user = userEvent.setup();
|
|
const base = studioGatewayFromApplication(createTechLogFeatureInstalledInput(MOCK_STUDIO_INSTALL_CONTEXT).input.createStudioApplication());
|
|
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")).toHaveTextContent("Redis");
|
|
expect(screen.getByLabelText("Project")).toHaveTextContent("Backend Skeleton");
|
|
// The common metadata remains a compact property surface. Record-specific
|
|
// content is no longer represented as a stack of `.studio-field` form rows.
|
|
expect(labelsIn(view.container, ".studio-field")).toEqual([
|
|
"제목",
|
|
"요약",
|
|
"프로젝트",
|
|
"주제",
|
|
"URL 이름",
|
|
]);
|
|
expect(screen.getByLabelText("문제")).toHaveValue("저장 기술이 정책을 소유했습니다.");
|
|
expect(markdownSource(view.container)).toHaveValue(
|
|
"## 책임 경계\n\n정책과 명령을 분리합니다.",
|
|
);
|
|
expect(screen.getByLabelText("1번째 제목 2")).toHaveValue("책임 경계");
|
|
expect(screen.getByLabelText("2번째 텍스트")).toHaveValue("정책과 명령을 분리합니다.");
|
|
expect(screen.getByRole("status", { name: "편집 상태" })).toHaveTextContent("저장됨");
|
|
|
|
await user.clear(screen.getByLabelText("제목"));
|
|
await user.type(screen.getByLabelText("제목"), "편집한 Redis 경계");
|
|
expect(screen.getByRole("status", { name: "편집 상태" })).toHaveTextContent(
|
|
"저장되지 않음",
|
|
);
|
|
|
|
// Version/kind belong to the document identity, while the command bar has
|
|
// only the two real author actions. There is no edit/split/preview state.
|
|
expect(screen.getByLabelText("현재 문서")).toHaveTextContent("CASE·v4");
|
|
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("main", { name: "문서 편집" })).toBeVisible();
|
|
expect(screen.queryByRole("button", { name: "편집" })).not.toBeInTheDocument();
|
|
expect(screen.queryByRole("button", { name: "나란히" })).not.toBeInTheDocument();
|
|
expect(screen.queryByRole("button", { name: "미리보기" })).not.toBeInTheDocument();
|
|
expect(screen.queryByRole("region", { name: "즉시 미리보기" })).not.toBeInTheDocument();
|
|
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);
|
|
|
|
const questionStatus = await screen.findByRole("group", { name: "질문 상태" });
|
|
expect(within(questionStatus).getByRole("button", { name: "OPEN" })).toHaveAttribute("aria-pressed", "true");
|
|
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.click(within(questionStatus).getByRole("button", { name: "RESOLVED" }));
|
|
expect(screen.getByLabelText("해결 요약")).toHaveValue("");
|
|
expect(screen.getByLabelText("해결 근거")).toHaveTextContent("근거 선택");
|
|
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 = studioGatewayFromApplication(createTechLogFeatureInstalledInput(MOCK_STUDIO_INSTALL_CONTEXT).input.createStudioApplication());
|
|
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);
|
|
});
|
|
});
|