B1. 검증·미리보기 화면이 CSS 없이 배포됐다. `workflow.module.css` 를 import 하는 파일이 하나도 없었고, Vite 의 CSS Module 은 import 되어야 번들에 들어간다. 제목이 62px 가 아니라 16px 로 나왔고 미리보기의 링크 두 개가 공백 없이 붙었다. 규칙이 전부 `:global()` 이었으므로 모듈일 이유가 없다 — studio.css 로 옮겼다. B2. Asset 라이브러리에 스타일이 없고 진입 경로도 없었다. 네 클래스에 규칙이 하나도 없어 key·상태·사용 수가 공백 없이 이어 붙었다. 스무 개짜리 목록에 썸네일도 없어 무엇을 고르는지 눌러 봐야 알았다. 내비게이션에도 없어서 URL 을 직접 쳐야 닿았다 — "정리하는 화면" 에 정리하러 갈 길이 없었다. B3. 삭제에 확인이 없었다. 문서·주제·프로젝트·릴리즈·Asset 전부 한 번에 영구 삭제였고, 그 「삭제」가 행에서 시각적으로 가장 강한 요소였다(16px/600 빨강). 정작 그 행에서 해야 할 일인 「검증하기」는 13px/400 이었다. 확인 창을 하나 만들어 다섯 곳에 붙이고, 행의 우선순위를 되돌렸다. B4(일부). robots.txt 가 광고하던 sitemap 이 404 였다. 무엇이 게시됐는지는 서버만 알므로 정적 파일이 아니라 조회로 만든다(백엔드 커밋 참조). robots.txt 가 그 주소를 가리키게 했다. B5. 라우트 프리픽스 밖 URL 이 nginx 의 맨 `Not Found` 로 끝났다. 404 상태는 그대로 두고 — 크롤러에게 링크가 깨졌다고 말하는 것이 그것이다 — 본문만 앱을 주도록 `error_page 404 @not_found` 를 뒀다. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PTnWufiY9ATv57egkKKVAV
256 lines
11 KiB
TypeScript
256 lines
11 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, null],
|
|
["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, null],
|
|
["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);
|
|
});
|
|
});
|