feat: 문서 종류를 독자의 말로 바꾸고 미해결을 눈에 띄게 한다

이 저장소의 종류 이름은 글을 담아 둔 방식의 이름이었다 — Case, Reference,
Open Question. 독자는 그 말을 배우고 나서야 목록을 읽을 수 있었고, 정작
뜻풀이는 홈 바닥(2,000px 아래)에 있었다. 이름이 하는 일을 말하게 한다:

  Case → 직접 해보니        Reference → 다음에 쓸 기준
  Question → 아직 모르는 것  Concept → 어떻게 동작하나
  Decision → 이렇게 하기로

이름이 스스로 설명하므로 홈 바닥의 뜻풀이 섹션은 종류별 입구로 바꾼다.
그 목록에 손으로 적어 둔 `OpenQuestion` 은 사이트 어디에도 없는 여섯 번째
표기였다. 탐색 필터·Case/개념 breadcrumb·종류별 화면 제목도 각자 이름을
적고 있었다 — 전부 공용 표를 쓰게 한다.

목록의 종류 표시는 다섯이 같은 회색 11px 이라 스캔되지 않았다. 색을 다섯
칠하는 대신 지식의 상태 셋(확인함·정리함·미해결)으로 가르고 미해결만
강조한다. 이 기록에서 가장 정직한 신호인데 가장 안 보였다.

mono 글꼴과 대문자 변환도 걷어낸다 — 이름이 한국어 문구가 되었고, mono 는
한글을 갖지 않아 낱말 사이만 벌어진다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011nAjrqNHGPNngN4aUbcyvJ
This commit is contained in:
DongHyeonka
2026-09-01 15:19:47 +09:00
co-authored by Claude Opus 5
parent 2b042829cf
commit a6413d0301
11 changed files with 101 additions and 46 deletions
@@ -173,12 +173,17 @@ describe("TechLog home discovery", () => {
"Redis Adapter가 도메인 TTL 정책을 소유하지 않는 이유",
"TechLog Public·Studio 경계를 확정했습니다",
]);
/*
종류별 입구. 예전에는 이 자리가 낱말 뜻풀이였고 이름이 `Case`·`OpenQuestion` 같은
저장소의 말이었다. 이름이 하는 일을 말하도록 바뀌었으므로 설명도 함께 바뀐다.
프로젝트는 종류가 아니라 그릇이므로 이 목록에서 뺐다 — 주 내비가 이미 데려간다.
*/
expect(
screen.getByRole("link", { name: /문제를 따라가며 검증 과정을 읽습니다.*Case/ }),
screen.getByRole("link", { name: /무엇을 해보고 무엇을 확인했는지.*직접 해보니/ }),
).toHaveAttribute("href", "/explore/cases");
expect(
screen.getByRole("link", { name: /여러 기록을 하나의 시스템 맥락에서 연결합니다.*Project/ }),
).toHaveAttribute("href", "/projects");
screen.getByRole("link", { name: /아직 답하지 못한 것과 다음 검증.*아직 모르는 것/ }),
).toHaveAttribute("href", "/explore/questions");
});
it("moves linked tabs with arrows, Home, and End while synchronizing the URL", async () => {
@@ -378,7 +383,7 @@ describe("TechLog explore discovery", () => {
);
expect(
screen.getByRole("heading", { level: 1, name: "Open Question" }),
screen.getByRole("heading", { level: 1, name: "아직 모르는 것" }),
).toBeVisible();
expect(
screen.getByText("확인한 사실과 미지수, 다음 검증을 공개적으로 추적합니다."),
@@ -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: "Case",
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: "Case",
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: "Reference",
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: "Reference",
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: "Open Question",
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: "Open Question",
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 === "Case") {
if (kind === "직접 해보니") {
expect(container.querySelector(".case-meta")).toHaveTextContent(`게시 ${published}`);
} else {
const metadata = container.querySelector(".public-document-header dl");
@@ -164,7 +164,7 @@ describe("TechLog Studio project decision authoring", () => {
FIXTURE_IDS.fetchJoinCase,
);
expect(screen.getByRole("complementary", { name: "작업 상태" }))
.toHaveTextContent("종류Decision");
.toHaveTextContent("종류이렇게 하기로");
const preview = screen.getByRole("region", { name: "즉시 미리보기" });
expect(
@@ -105,11 +105,11 @@ describe("TechLog Studio document editor", () => {
);
/*
종류 이름은 모든 화면이 같은 표를 본다. 예전에는 화면마다 표를 복사해 두어 같은 문서가
편집기에서 "CASE", 목록에서 "Case", 공개 화면에서 "Case" 로 갈렸다 — QUESTION 은 네
편집기에서 "CASE", 목록에서 "Case" 로 갈렸다 — QUESTION 은 네
가지 표기까지 났다.
*/
expect(screen.getByRole("complementary", { name: "작업 상태" })).toHaveTextContent(
"저장 버전4종류Case",
"저장 버전4종류직접 해보니",
);
// 작성자가 밟는 단계는 저장과 게시 둘뿐이다. 예전에는 검증 → 미리보기 → 게시 세 화면을
// 차례로 거쳐야 했는데, 그 셋은 백엔드가 게시 요청에 요구하는 값을 만들기 위한 것이지