Files
tech-log-frontend/tests/support/browser/tech-log-fixtures.ts
T
DongHyeonka 500dbc6217 test(e2e): Studio 화면 시험은 데모 세션으로 로그인한 뒤 본다
5e2b1a5(08-20)부터 로그인하지 않은 방문자는 Studio 경로에서 로그인
화면만 받는다. e2e 빌드는 local profile(AUTH_MODE demo)이고, 데모
세션은 로그아웃 상태로 시작해 메모리에만 있다. 그런데 Studio 시험은
로그인하지 않고 들어간다. 그래서
- 편집기·접근성 시험은 로그인 화면에서 「저장」 버튼이나 「요약」 칸을
  기다리다 떨어지고,
- 경로별 axe 검사(accessibility.spec)와 visual 시험은 Studio 경로 12개에서
  Studio 화면 대신 로그인 화면을 검사하고 있었다.

tech-log-fixtures.ts에 gotoTechLogStudio를 둔다. gotoTechLog 뒤에
작성자가 쓰는 「로그인 시작」 버튼을 누르고, 로그인한 세션만 받는
Studio 머리말이 뜰 때까지 기다린다. Studio 경로를 여는 e2e·접근성·visual
시험이 이것을 쓴다.

버린 대안: 앱의 세션을 시험에서 직접 authenticated로 바꾸기. 로그인
버튼과 관문 동작을 건너뛰게 되고, 앱 내부에 시험용 구멍이 필요하다.

위험: 이 변경으로 Studio 화면을 실제로 검사하게 되면서, 로그인 화면에
가려져 있던 결함이 드러난다. MOCK Studio에서도 관리 기능(주제·프로젝트·
릴리즈)이 실제 HTTP(/api/v1/studio/session)로 나가 연결이 거부된다
(create-tech-log-feature-input.ts의 createManagementGateway에 MOCK 분기가
없다). 그 결함은 이 PR 밖이다. 그동안 Studio 편집기·대시보드 시험은
그 이유로 실패한다.

검증: Studio 경로에서 로그인 뒤 Studio 머리말과 주 탐색이 뜨는 것을
error-context 스냅숏으로 확인했다. 남은 실패는 모두 위 HTTP 요청이다.
2026-11-12 15:03:16 +09:00

168 lines
7.8 KiB
TypeScript

import type { Page } from "@playwright/test";
export const TECH_LOG_FIXED_TIME = "2026-08-14T01:00:00.000Z";
export const TECH_LOG_CANONICAL_ROUTES = [
{ routeId: "TECH_LOG_HOME", path: "/", layout: "PUBLIC" },
{ routeId: "TECH_LOG_EXPLORE", path: "/explore", layout: "PUBLIC" },
{ routeId: "TECH_LOG_EXPLORE_KIND", path: "/explore/cases", layout: "PUBLIC" },
{ routeId: "TECH_LOG_CASE", path: "/cases/collection-fetch-join-pagination", layout: "PUBLIC" },
{ routeId: "TECH_LOG_REFERENCE", path: "/references/state-and-nonce-boundary", layout: "PUBLIC" },
{ routeId: "TECH_LOG_QUESTION", path: "/questions/validate-edge-token-again", layout: "PUBLIC" },
{ routeId: "TECH_LOG_TOPIC", path: "/topics/jpa", layout: "PUBLIC" },
{ routeId: "TECH_LOG_PROJECTS", path: "/projects", layout: "PUBLIC" },
{ routeId: "TECH_LOG_PROJECT", path: "/projects/backend-skeleton", layout: "PUBLIC" },
{ routeId: "TECH_LOG_PROJECT_RECORDS", path: "/projects/backend-skeleton/records", layout: "PUBLIC" },
{ routeId: "TECH_LOG_PROJECT_DECISIONS", path: "/projects/backend-skeleton/decisions", layout: "PUBLIC" },
{ routeId: "TECH_LOG_PROJECT_ACTIVITY", path: "/projects/backend-skeleton/activity", layout: "PUBLIC" },
{ routeId: "TECH_LOG_RELEASES", path: "/releases", layout: "PUBLIC" },
{ routeId: "TECH_LOG_RELEASE", path: "/releases/0.1.0", layout: "PUBLIC" },
{ routeId: "TECH_LOG_PROFILE", path: "/profile", layout: "PUBLIC" },
{ routeId: "TECH_LOG_SEARCH", path: "/search?q=JPA", layout: "PUBLIC" },
{ routeId: "TECH_LOG_STUDIO_HOME", path: "/studio", layout: "STUDIO" },
{ routeId: "TECH_LOG_STUDIO_DOCUMENTS", path: "/studio/documents", layout: "STUDIO" },
{ routeId: "TECH_LOG_STUDIO_DOCUMENT_NEW", path: "/studio/documents/new", layout: "STUDIO" },
{ routeId: "TECH_LOG_STUDIO_DOCUMENT_EDIT", path: "/studio/documents/11111111-1111-4111-8111-111111111111/edit", layout: "STUDIO" },
{ routeId: "TECH_LOG_STUDIO_DOCUMENT_VALIDATION", path: "/studio/documents/11111111-1111-4111-8111-111111111113/validation", layout: "STUDIO" },
{ routeId: "TECH_LOG_STUDIO_DOCUMENT_PREVIEW", path: "/studio/documents/11111111-1111-4111-8111-111111111111/preview", layout: "STUDIO" },
{ routeId: "TECH_LOG_STUDIO_DOCUMENT_PUBLISH", path: "/studio/documents/11111111-1111-4111-8111-111111111113/publish", layout: "STUDIO" },
{ routeId: "TECH_LOG_STUDIO_PUBLICATIONS", path: "/studio/publications", layout: "STUDIO" },
{ routeId: "TECH_LOG_STUDIO_PUBLICATION_PREVIEW", path: "/studio/publications/66666666-6666-4666-8666-666666666661/preview", layout: "STUDIO" },
{ routeId: "TECH_LOG_STUDIO_ASSETS", path: "/studio/assets", layout: "STUDIO" },
{ routeId: "TECH_LOG_STUDIO_NOT_FOUND", path: "/studio/unknown-screen", layout: "STUDIO" },
{ routeId: "NOT_FOUND", path: "/unknown-public-screen", layout: "PUBLIC" },
] as const;
export const TECH_LOG_PUBLIC_FIXTURE_PATHS = [
"/cases/collection-fetch-join-pagination",
"/cases/redis-adapter-ttl-boundary",
"/references/state-and-nonce-boundary",
"/references/jpa-list-fetch-strategy",
"/questions/validate-edge-token-again",
"/questions/collection-fetch-join-with-pagination",
"/topics/jpa",
"/topics/redis",
"/topics/authentication",
"/projects/backend-skeleton",
"/projects/backend-skeleton/records",
"/projects/backend-skeleton/decisions",
"/projects/backend-skeleton/activity",
"/projects/auth-lab",
"/projects/auth-lab/records",
"/projects/auth-lab/decisions",
"/projects/auth-lab/activity",
"/releases/0.1.0",
] as const;
export const TECH_LOG_UNKNOWN_PUBLIC_PATHS = [
["explore-kind", "/explore/unknown-kind"],
["case", "/cases/not-registered"],
["reference", "/references/not-registered"],
["question", "/questions/not-registered"],
["topic", "/topics/not-registered"],
["project", "/projects/missing-project"],
["project-records", "/projects/missing-project/records"],
["project-decisions", "/projects/missing-project/decisions"],
["project-activity", "/projects/missing-project/activity"],
["release", "/releases/9.9.9"],
] as const;
export const TECH_LOG_STUDIO_STATE_PATHS = [
["dashboard", "/studio"],
["document-list", "/studio/documents"],
["new-document", "/studio/documents/new"],
["case-editor", "/studio/documents/11111111-1111-4111-8111-111111111111/edit"],
["reference-editor", "/studio/documents/11111111-1111-4111-8111-111111111113/edit"],
["question-editor", "/studio/documents/11111111-1111-4111-8111-111111111114/edit"],
["conflict-editor", "/studio/documents/11111111-1111-4111-8111-111111111115/edit"],
["valid-validation", "/studio/documents/11111111-1111-4111-8111-111111111113/validation"],
["invalid-validation", "/studio/documents/11111111-1111-4111-8111-111111111114/validation"],
["current-preview", "/studio/documents/11111111-1111-4111-8111-111111111111/preview"],
["missing-preview", "/studio/documents/11111111-1111-4111-8111-111111111113/preview"],
["expired-preview", "/studio/documents/11111111-1111-4111-8111-111111111117/preview"],
["publish-ready", "/studio/documents/11111111-1111-4111-8111-111111111113/publish"],
["publish-blocked", "/studio/documents/11111111-1111-4111-8111-111111111114/publish"],
["publications", "/studio/publications"],
["asset-library", "/studio/assets"],
["publication-snapshot", "/studio/publications/66666666-6666-4666-8666-666666666661/preview"],
["missing-document", "/studio/documents/99999999-9999-4999-8999-999999999999/edit"],
["missing-publication", "/studio/publications/99999999-9999-4999-8999-999999999999/preview"],
["unknown-studio-route", "/studio/unknown-screen"],
] as const;
export const TECH_LOG_BREAKPOINT_WIDTHS = [
1180,
1179,
1050,
1024,
980,
900,
820,
768,
767,
420,
390,
375,
] as const;
export async function prepareTechLogPage(page: Page) {
await page.clock.setFixedTime(new Date(TECH_LOG_FIXED_TIME));
await page.emulateMedia({ colorScheme: "light", reducedMotion: "reduce" });
}
export async function settleTechLogPage(page: Page) {
await page.evaluate(async () => {
await document.fonts.ready;
});
await page.addStyleTag({
content: `
*, *::before, *::after {
animation-delay: 0s !important;
animation-duration: 0s !important;
caret-color: transparent !important;
transition-delay: 0s !important;
transition-duration: 0s !important;
}
`,
});
}
export async function gotoTechLog(page: Page, path: string) {
await prepareTechLogPage(page);
const response = await page.goto(path, { waitUntil: "networkidle" });
await page.locator("body").waitFor({ state: "visible" });
if (response?.headers()["content-type"]?.startsWith("text/html")) {
await page.locator("html[data-build-id][data-release-id]").waitFor();
await page.locator(".site-frame, .studio-app").waitFor();
}
await settleTechLogPage(page);
}
/**
* 5e2b1a5 (08-20). A signed-out visitor gets only the sign-in surface on a
* Studio route. The e2e build is the local profile (`AUTH_MODE: "demo"`), whose
* session starts signed out and lives in memory, so every page load starts
* signed out again. This signs in with the button a writer uses and waits for
* the Studio chrome that only a signed-in session gets.
*/
export async function signInToStudio(page: Page) {
const gate = page.locator('[data-surface="authentication-required"]');
await gate.getByRole("button", { name: "로그인 시작" }).click();
await page.locator("header.studio-header").waitFor();
await gate.waitFor({ state: "detached" });
await page.waitForLoadState("networkidle");
}
/** `gotoTechLog` for a Studio route, signed in. */
export async function gotoTechLogStudio(page: Page, path: string) {
await gotoTechLog(page, path);
await signInToStudio(page);
}
export async function horizontalOverflow(page: Page) {
return page.evaluate(() => ({
clientWidth: document.documentElement.clientWidth,
scrollWidth: document.documentElement.scrollWidth,
}));
}