diff --git a/src/features/tech-log/presentation/shared/document-kind-labels.ts b/src/features/tech-log/presentation/shared/document-kind-labels.ts
index fe348a9..e1b1804 100644
--- a/src/features/tech-log/presentation/shared/document-kind-labels.ts
+++ b/src/features/tech-log/presentation/shared/document-kind-labels.ts
@@ -9,17 +9,20 @@ type RecordKind = components["schemas"]["RecordKind"];
* 담아 둔 방식의 이름이지 읽는 사람의 말이 아니다 — 종류 이름이 스스로 설명하면 "어떤 맥락으로
* 읽을까요?" 같은 범례가 따로 필요 없다.
*
+ * 다만 계약의 kind 자체는 그대로 둔다. 여기서 바꾸는 것은 화면에 보이는 이름뿐이다 —
+ * `CASE` 와 `CONCEPT` 는 데이터 모델에서 서로 다른 것을 뜻하고, 독자가 얻는 것도 다르다.
+ *
*
표가 화면마다 복사되어 있던 시절에는 같은 `QUESTION` 이 화면마다 네 가지 이름으로 나왔다.
*
*
한 곳에 두면 다음에 종류가 늘어날 때도 한 번만 고친다. 종류를 더하면 이 표가 비어 있는 것을
* 타입이 잡는다 — `Record` 이므로 빠진 종류가 있으면 컴파일되지 않는다.
*/
export const DOCUMENT_KIND_LABELS: Record = {
- CASE: "직접 해보니",
- REFERENCE: "다음에 쓸 기준",
- QUESTION: "아직 모르는 것",
- CONCEPT: "어떻게 동작하나",
- PROJECT_DECISION: "이렇게 하기로",
+ CASE: "검증 기록",
+ CONCEPT: "동작 원리",
+ REFERENCE: "적용 기준",
+ PROJECT_DECISION: "설계 결정",
+ QUESTION: "열린 질문",
};
/**
diff --git a/tests/features/tech-log/public-discovery-screens.test.tsx b/tests/features/tech-log/public-discovery-screens.test.tsx
index 5f2bf10..fa6d5db 100644
--- a/tests/features/tech-log/public-discovery-screens.test.tsx
+++ b/tests/features/tech-log/public-discovery-screens.test.tsx
@@ -179,10 +179,10 @@ describe("TechLog home discovery", () => {
프로젝트는 종류가 아니라 그릇이므로 이 목록에서 뺐다 — 주 내비가 이미 데려간다.
*/
expect(
- screen.getByRole("link", { name: /무엇을 해보고 무엇을 확인했는지.*직접 해보니/ }),
+ screen.getByRole("link", { name: /무엇을 해보고 무엇을 확인했는지.*검증 기록/ }),
).toHaveAttribute("href", "/explore/cases");
expect(
- screen.getByRole("link", { name: /아직 답하지 못한 것과 다음 검증.*아직 모르는 것/ }),
+ screen.getByRole("link", { name: /아직 답하지 못한 것과 다음 검증.*열린 질문/ }),
).toHaveAttribute("href", "/explore/questions");
});
@@ -383,7 +383,7 @@ describe("TechLog explore discovery", () => {
);
expect(
- screen.getByRole("heading", { level: 1, name: "아직 모르는 것" }),
+ screen.getByRole("heading", { level: 1, name: "열린 질문" }),
).toBeVisible();
expect(
screen.getByText("확인한 사실과 미지수, 다음 검증을 공개적으로 추적합니다."),
diff --git a/tests/features/tech-log/public-document-screens.test.tsx b/tests/features/tech-log/public-document-screens.test.tsx
index 72a7ae4..090cfa5 100644
--- a/tests/features/tech-log/public-document-screens.test.tsx
+++ b/tests/features/tech-log/public-document-screens.test.tsx
@@ -124,7 +124,7 @@ describe("TechLog canonical Public documents", () => {
routeId: "TECH_LOG_CASE" as const,
path: "/cases/collection-fetch-join-pagination",
title: "컬렉션 Fetch Join과 페이징은 왜 충돌하는가",
- kind: "직접 해보니",
+ kind: "검증 기록",
topic: "JPA",
project: "Backend Skeleton",
published: "2026.08.11",
@@ -139,7 +139,7 @@ describe("TechLog canonical Public documents", () => {
routeId: "TECH_LOG_CASE" as const,
path: "/cases/redis-adapter-ttl-boundary",
title: "Redis Adapter가 도메인 TTL 정책을 소유하지 않는 이유",
- kind: "직접 해보니",
+ kind: "검증 기록",
topic: "Redis",
project: "Backend Skeleton",
published: "2026.08.07",
@@ -153,7 +153,7 @@ describe("TechLog canonical Public documents", () => {
routeId: "TECH_LOG_REFERENCE" as const,
path: "/references/state-and-nonce-boundary",
title: "Authorization Code Flow에서 state와 nonce의 경계",
- kind: "다음에 쓸 기준",
+ kind: "적용 기준",
topic: "Authentication",
project: "Auth Lab",
published: "2026.08.09",
@@ -167,7 +167,7 @@ describe("TechLog canonical Public documents", () => {
routeId: "TECH_LOG_REFERENCE" as const,
path: "/references/jpa-list-fetch-strategy",
title: "JPA 목록 조회에서 Fetch 전략을 선택하는 기준",
- kind: "다음에 쓸 기준",
+ kind: "적용 기준",
topic: "JPA",
project: "Backend Skeleton",
published: "2026.08.10",
@@ -181,7 +181,7 @@ describe("TechLog canonical Public documents", () => {
routeId: "TECH_LOG_QUESTION" as const,
path: "/questions/validate-edge-token-again",
title: "oauth2-proxy가 전달한 토큰을 다시 검증해야 하는가?",
- kind: "아직 모르는 것",
+ kind: "열린 질문",
topic: "Authentication",
project: "Auth Lab",
published: "2026.08.08",
@@ -195,7 +195,7 @@ describe("TechLog canonical Public documents", () => {
routeId: "TECH_LOG_QUESTION" as const,
path: "/questions/collection-fetch-join-with-pagination",
title: "컬렉션 Fetch Join을 유지하면서 페이징할 수 있는가?",
- kind: "아직 모르는 것",
+ kind: "열린 질문",
topic: "JPA",
project: "Backend Skeleton",
published: "2026.08.05",
@@ -234,7 +234,7 @@ describe("TechLog canonical Public documents", () => {
Case 는 한 배치를 쓴다. 예전에는 픽스처 문서 하나만 `.case-meta` 를 받고 나머지 Case 는
`.public-document-header dl` 로 떨어졌으므로 여기도 경로로 갈랐다. 이제 유형으로 가른다.
*/
- if (kind === "직접 해보니") {
+ if (kind === "검증 기록") {
expect(container.querySelector(".case-meta")).toHaveTextContent(`게시 ${published}`);
} else {
const metadata = container.querySelector(".public-document-header dl");
diff --git a/tests/features/tech-log/studio-decision-authoring.test.tsx b/tests/features/tech-log/studio-decision-authoring.test.tsx
index c15061f..cb47ce9 100644
--- a/tests/features/tech-log/studio-decision-authoring.test.tsx
+++ b/tests/features/tech-log/studio-decision-authoring.test.tsx
@@ -164,7 +164,7 @@ describe("TechLog Studio project decision authoring", () => {
FIXTURE_IDS.fetchJoinCase,
);
expect(screen.getByRole("complementary", { name: "작업 상태" }))
- .toHaveTextContent("종류이렇게 하기로");
+ .toHaveTextContent("종류설계 결정");
const preview = screen.getByRole("region", { name: "즉시 미리보기" });
expect(
diff --git a/tests/features/tech-log/studio-editor-smoke.test.tsx b/tests/features/tech-log/studio-editor-smoke.test.tsx
index a3927f8..29a1b1d 100644
--- a/tests/features/tech-log/studio-editor-smoke.test.tsx
+++ b/tests/features/tech-log/studio-editor-smoke.test.tsx
@@ -109,7 +109,7 @@ describe("TechLog Studio document editor", () => {
가지 표기까지 났다.
*/
expect(screen.getByRole("complementary", { name: "작업 상태" })).toHaveTextContent(
- "저장 버전4종류직접 해보니",
+ "저장 버전4종류검증 기록",
);
// 작성자가 밟는 단계는 저장과 게시 둘뿐이다. 예전에는 검증 → 미리보기 → 게시 세 화면을
// 차례로 거쳐야 했는데, 그 셋은 백엔드가 게시 요청에 요구하는 값을 만들기 위한 것이지