Files
tech-log-frontend/tests/features/tech-log/route-contract.test.ts
T
DongHyeonkaandClaude Opus 5 b9e29369ee fix: UX 리뷰의 남은 항목을 반영한다
주제 탭 (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
2026-09-09 17:15:04 +09:00

256 lines
12 KiB
TypeScript

import { describe, expect, it } from "vitest";
import {
TECH_LOG_ROUTE_REGISTRY,
TECH_LOG_ROUTE_RUNTIME_CONTRACT,
} from "../../../src/features/tech-log/contracts/tech-log-route-contract.ts";
import { TECH_LOG_MESSAGE_CATALOGS } from "../../../src/features/tech-log/contracts/tech-log-message-catalog.ts";
import { TECH_LOG_ROUTE_CODECS } from "../../../src/features/tech-log/presentation/tech-log-route-codecs.ts";
import { ROUTE_REGISTRY } from "../../../src/features/installed-feature-contracts.ts";
import { ROUTE_RUNTIME } from "../../../src/features/installed-feature-runtimes.tsx";
import { buildRouteUrlFromContract } from "../../../src/presentation/routes/route-codecs.ts";
import { PLATFORM_ROUTE_CODECS } from "../../../src/presentation/routes/platform-route-codecs.ts";
const expectedRoutes = [
["TECH_LOG_HOME", "/", "PUBLIC", null, "TechLogHomeSearch"],
["TECH_LOG_EXPLORE", "/explore", "PUBLIC", null, "TechLogExploreSearch"],
["TECH_LOG_EXPLORE_KIND", "/explore/:kind", "PUBLIC", "TechLogExploreKindParams", "TechLogExploreKindSearch"],
["TECH_LOG_CASE", "/cases/:slug", "PUBLIC", "TechLogSlugParams", "TechLogCaseStateSearch"],
["TECH_LOG_REFERENCE", "/references/:slug", "PUBLIC", "TechLogSlugParams", null],
["TECH_LOG_CONCEPT", "/concepts/:slug", "PUBLIC", "TechLogSlugParams", null],
["TECH_LOG_SETUP", "/setups/:slug", "PUBLIC", "TechLogSlugParams", null],
["TECH_LOG_QUESTION", "/questions/:slug", "PUBLIC", "TechLogSlugParams", null],
["TECH_LOG_TOPICS", "/topics", "PUBLIC", null, null],
["TECH_LOG_TOPIC", "/topics/:slug", "PUBLIC", "TechLogSlugParams", null],
[
"TECH_LOG_TOPIC_VARIANT",
"/topics/:slug/:variant",
"PUBLIC",
"TechLogTopicVariantParams",
null,
],
["TECH_LOG_PROJECTS", "/projects", "PUBLIC", null, null],
["TECH_LOG_PROJECT", "/projects/:slug", "PUBLIC", "TechLogSlugParams", null],
["TECH_LOG_PROJECT_RECORDS", "/projects/:slug/records", "PUBLIC", "TechLogSlugParams", null],
["TECH_LOG_PROJECT_DECISIONS", "/projects/:slug/decisions", "PUBLIC", "TechLogSlugParams", null],
["TECH_LOG_PROJECT_ACTIVITY", "/projects/:slug/activity", "PUBLIC", "TechLogSlugParams", null],
["TECH_LOG_RELEASES", "/releases", "PUBLIC", null, null],
["TECH_LOG_RELEASE", "/releases/:version", "PUBLIC", "TechLogVersionParams", null],
["TECH_LOG_PROFILE", "/profile", "PUBLIC", null, null],
["TECH_LOG_SEARCH", "/search", "PUBLIC", null, "TechLogSearchQuery"],
["TECH_LOG_STUDIO_HOME", "/studio", "STUDIO", null, null],
["TECH_LOG_STUDIO_DOCUMENTS", "/studio/documents", "STUDIO", null, "TechLogStudioDocumentsSearch"],
["TECH_LOG_STUDIO_DOCUMENT_NEW", "/studio/documents/new", "STUDIO", null, null],
["TECH_LOG_STUDIO_DOCUMENT_EDIT", "/studio/documents/:id/edit", "STUDIO", "TechLogDocumentIdParams", null],
["TECH_LOG_STUDIO_DOCUMENT_VALIDATION", "/studio/documents/:id/validation", "STUDIO", "TechLogDocumentIdParams", null],
["TECH_LOG_STUDIO_DOCUMENT_PREVIEW", "/studio/documents/:id/preview", "STUDIO", "TechLogDocumentIdParams", null],
["TECH_LOG_STUDIO_DOCUMENT_PUBLISH", "/studio/documents/:id/publish", "STUDIO", "TechLogDocumentIdParams", null],
["TECH_LOG_STUDIO_PUBLICATIONS", "/studio/publications", "STUDIO", null, "TechLogStudioPublicationsSearch"],
["TECH_LOG_STUDIO_PUBLICATION_PREVIEW", "/studio/publications/:publicationEventId/preview", "STUDIO", "TechLogPublicationEventIdParams", null],
["TECH_LOG_STUDIO_ASSETS", "/studio/assets", "STUDIO", null, null],
["TECH_LOG_STUDIO_TAXONOMY", "/studio/taxonomy", "STUDIO", null, null],
["TECH_LOG_STUDIO_PROJECT_EDIT", "/studio/projects/:id", "STUDIO", "TechLogDocumentIdParams", null],
["TECH_LOG_STUDIO_TOPIC_EDIT", "/studio/topics/:id", "STUDIO", "TechLogDocumentIdParams", null],
["TECH_LOG_STUDIO_RELEASES", "/studio/releases", "STUDIO", null, null],
["TECH_LOG_STUDIO_RELEASE_EDIT", "/studio/releases/:id", "STUDIO", "TechLogDocumentIdParams", null],
["TECH_LOG_STUDIO_NOT_FOUND", "/studio/*", "STUDIO", "TechLogStudioSplat", null],
["NOT_FOUND", "*", "PUBLIC", "NotFoundSplat", null],
] as const;
const expectedTitles = {
TECH_LOG_HOME: "TechLog",
TECH_LOG_EXPLORE: "탐색",
TECH_LOG_EXPLORE_KIND: "유형별 탐색",
TECH_LOG_CASE: "Case",
TECH_LOG_CONCEPT: "개념",
TECH_LOG_SETUP: "환경 구성",
TECH_LOG_REFERENCE: "Reference",
TECH_LOG_QUESTION: "Open Question",
TECH_LOG_TOPICS: "주제",
TECH_LOG_TOPIC: "Topic",
TECH_LOG_TOPIC_VARIANT: "Topic",
TECH_LOG_PROJECTS: "프로젝트",
TECH_LOG_PROJECT: "프로젝트",
TECH_LOG_PROJECT_RECORDS: "프로젝트 기록",
TECH_LOG_PROJECT_DECISIONS: "프로젝트 결정",
TECH_LOG_PROJECT_ACTIVITY: "프로젝트 활동",
TECH_LOG_RELEASES: "변경 기록",
TECH_LOG_RELEASE: "변경 기록",
TECH_LOG_PROFILE: "프로필",
TECH_LOG_SEARCH: "검색",
TECH_LOG_STUDIO_HOME: "TechLog Studio",
TECH_LOG_STUDIO_DOCUMENTS: "작업본",
TECH_LOG_STUDIO_DOCUMENT_NEW: "새 문서",
TECH_LOG_STUDIO_DOCUMENT_EDIT: "문서 편집",
TECH_LOG_STUDIO_DOCUMENT_VALIDATION: "문서 검증",
TECH_LOG_STUDIO_DOCUMENT_PREVIEW: "Public Preview",
TECH_LOG_STUDIO_DOCUMENT_PUBLISH: "게시",
TECH_LOG_STUDIO_PUBLICATIONS: "게시 기록",
TECH_LOG_STUDIO_PUBLICATION_PREVIEW: "게시 Snapshot",
TECH_LOG_STUDIO_ASSETS: "Asset",
TECH_LOG_STUDIO_TAXONOMY: "주제와 프로젝트",
TECH_LOG_STUDIO_PROJECT_EDIT: "프로젝트 편집",
TECH_LOG_STUDIO_TOPIC_EDIT: "주제 편집",
TECH_LOG_STUDIO_RELEASES: "릴리즈",
TECH_LOG_STUDIO_RELEASE_EDIT: "릴리즈 편집",
TECH_LOG_STUDIO_NOT_FOUND: "Studio 화면을 찾을 수 없습니다",
NOT_FOUND: "페이지를 찾을 수 없습니다.",
} as const;
describe("TechLog route boundary contract", () => {
it("freezes the standalone 35-route inventory before runtime installation", () => {
expect(
Object.values(TECH_LOG_ROUTE_REGISTRY).map((definition) => [
definition.routeId,
definition.path,
definition.layoutGroup,
definition.paramsSchema,
definition.searchSchema,
]),
).toEqual(expectedRoutes);
expect(
Object.values(TECH_LOG_ROUTE_REGISTRY).map((definition) => [
definition.routeId,
definition.access,
definition.chunkId,
]),
).toEqual(
// Studio is the authenticated surface, Public is not. Derived here from
// the frozen inventory's own layoutGroup column rather than restated per
// route, so a Studio route added without a gate fails this table too —
// every TechLog route used to be registered "public", which made the
// router's access decision a no-op for Studio.
expectedRoutes.map(([routeId, , layoutGroup]) => [
routeId,
layoutGroup === "STUDIO" ? "session-required" : "public",
routeId === "NOT_FOUND"
? "route-not-found"
: `route-${routeId.toLowerCase().replaceAll("_", "-")}`,
]),
);
});
it("keeps runtime module and codec bindings aligned with every dormant route", () => {
expect(Object.keys(TECH_LOG_ROUTE_RUNTIME_CONTRACT)).toEqual(
expectedRoutes.map(([routeId]) => routeId),
);
for (const [routeId, , , paramsSchema, searchSchema] of expectedRoutes) {
expect(TECH_LOG_ROUTE_RUNTIME_CONTRACT[routeId]).toEqual({
routeId,
moduleId:
routeId === "NOT_FOUND"
? "route-not-found"
: `route-${routeId.toLowerCase().replaceAll("_", "-")}`,
paramsCodec: paramsSchema ?? "none",
searchCodec: searchSchema ?? "none",
});
}
});
it("preserves source navigation labels and the complete route message catalog", () => {
expect(
Object.values(TECH_LOG_ROUTE_REGISTRY)
.filter((definition) => definition.navigationLabel !== null)
.map(({ routeId, layoutGroup, navigationLabel, navigationOrder }) => [
routeId,
layoutGroup,
navigationLabel,
navigationOrder,
]),
).toEqual([
["TECH_LOG_EXPLORE", "PUBLIC", "탐색", 10],
["TECH_LOG_TOPICS", "PUBLIC", "주제", 15],
["TECH_LOG_PROJECTS", "PUBLIC", "프로젝트", 20],
["TECH_LOG_PROFILE", "PUBLIC", "프로필", 40],
["TECH_LOG_STUDIO_DOCUMENTS", "STUDIO", "작업본", 10],
["TECH_LOG_STUDIO_DOCUMENT_NEW", "STUDIO", "새 문서", 30],
["TECH_LOG_STUDIO_PUBLICATIONS", "STUDIO", "게시 기록", 20],
["TECH_LOG_STUDIO_ASSETS", "STUDIO", "Asset", 45],
["TECH_LOG_STUDIO_TAXONOMY", "STUDIO", "주제·프로젝트", 40],
["TECH_LOG_STUDIO_RELEASES", "STUDIO", "릴리즈", 50],
]);
for (const locale of ["ko-KR", "en-US"] as const) {
const catalog: Readonly<Record<string, string>> =
TECH_LOG_MESSAGE_CATALOGS[locale];
expect(Object.keys(catalog)).toHaveLength(74);
for (const [routeId, title] of Object.entries(expectedTitles)) {
expect(catalog[`route.${routeId}.title`]).toBe(title);
expect(catalog[`route.${routeId}.navigation`]).toBe(title);
}
}
});
it("normalizes source search semantics and rejects empty path parameters", () => {
expect(
TECH_LOG_ROUTE_CODECS.TechLogExploreSearch.parse({
type: ["CASE", "REFERENCE"],
topic: [" JPA ", "Redis"],
project: " tech-log ",
unknown: "drop-me",
}),
).toEqual({ type: "CASE", topic: "JPA", project: "tech-log" });
expect(
TECH_LOG_ROUTE_CODECS.TechLogHomeSearch.parse({
focus: ["architecture", "delivery"],
state: ["latest-empty", "site-error"],
}),
).toEqual({ focus: "architecture", state: "latest-empty" });
expect(
TECH_LOG_ROUTE_CODECS.TechLogSearchQuery.parse({ q: [" gateway ", "ignored"] }),
).toEqual({ q: "gateway" });
expect(
TECH_LOG_ROUTE_CODECS.TechLogSlugParams.safeParse({ slug: "" }).success,
).toBe(false);
expect(
TECH_LOG_ROUTE_CODECS.TechLogDocumentIdParams.safeParse({ id: "" }).success,
).toBe(false);
});
it("builds canonical TechLog URLs with non-empty string codecs", () => {
const route = TECH_LOG_ROUTE_REGISTRY.TECH_LOG_STUDIO_PUBLICATION_PREVIEW;
const runtime =
TECH_LOG_ROUTE_RUNTIME_CONTRACT.TECH_LOG_STUDIO_PUBLICATION_PREVIEW;
expect(
buildRouteUrlFromContract(route, runtime, {
...PLATFORM_ROUTE_CODECS,
...TECH_LOG_ROUTE_CODECS,
}, {
params: { publicationEventId: "event/01" },
}),
).toBe("/studio/publications/event%2F01/preview");
expect(() =>
buildRouteUrlFromContract(route, runtime, {
...PLATFORM_ROUTE_CODECS,
...TECH_LOG_ROUTE_CODECS,
}, {
params: { publicationEventId: "" },
}),
).toThrow();
});
/*
Asset 화면은 오래 내비게이션 밖에 있었다. 화면 설명은 "사용하지 않는 Asset 을 정리합니다"
인데 거기 갈 방법이 URL 직접 입력뿐이었다 — 정리하라고 만든 화면에 정리하러 갈 길이 없었다.
*/
it("registers the studio asset library in primary navigation", () => {
const route = TECH_LOG_ROUTE_REGISTRY.TECH_LOG_STUDIO_ASSETS;
expect(route).toBeTruthy();
expect(route.path).toBe("/studio/assets");
expect(route.layoutGroup).toBe("STUDIO");
expect(route.navigationLabel).toBe("Asset");
expect(route.navigationOrder).toBe(45);
});
it("atomically installs the complete TechLog route and runtime inventories", () => {
expect(Object.keys(ROUTE_REGISTRY)).toEqual(
expectedRoutes.map(([routeId]) => routeId),
);
expect(Object.keys(ROUTE_RUNTIME)).toEqual(Object.keys(ROUTE_REGISTRY));
expect(ROUTE_REGISTRY).toEqual(TECH_LOG_ROUTE_REGISTRY);
});
});