feat: 개념(CONCEPT) 문서 종류 — 편집기·공개 화면·탐색

Kubernetes 내부 동작처럼 처음부터 풀어 읽어야 하는 글을 쓸 자리를 만든다. Reference 는
판단 기준을 빨리 찾는 글이라 규칙·적용·예외로 나뉘고, 그 틀에 개념을 넣으면 두 글이 서로를
망친다 — 기준을 찾으러 온 사람은 배경을 지나야 하고, 개념을 배우러 온 사람은 규칙에서
시작한다.

편집기는 Case 의 본문 칸과 Asset Picker 를 그대로 쓴다. 아키텍처 도식은 같은
`:::evidence` 로 들어오고, `##` 소제목이 목차가 된다. 개념이 따로 갖는 것은 기준 버전
하나다 — 개념이 낡는 방식은 날짜가 아니라 버전이다.

공개 렌더는 Case 와 본문·목차를 공유하되 머리말이 다르다. 문제도 결론도 검증 환경도 없고,
프로젝트 마디는 값이 있을 때만 그린다 — 개념은 프로젝트 없이 서는 유일한 종류다.

픽스처가 실제 결함을 하나 드러냈다. 프로젝트 없는 기록이 처음 생기자 `?project=` 빈 값이
"프로젝트가 없는 기록 전부" 를 뜻하게 됐다 — 고르지 않은 것이 고른 것이 되어 버린다. 빈
필터는 아무것도 고르지 않도록 고쳤다. 예전에는 빈 값에 걸릴 기록이 없어 저절로 맞았다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0189NzCryfeqDzS81EWidnBx
This commit is contained in:
DongHyeonka
2026-08-28 19:51:20 +09:00
co-authored by Claude Opus 5
parent 9ecc017f22
commit 048c1b2f68
27 changed files with 749 additions and 47 deletions
@@ -340,12 +340,14 @@ describe("TechLog explore discovery", () => {
expect(router.state.location.pathname).toBe("/explore");
expect(router.state.location.search).toBe("");
});
expect(screen.getByText("6개의 공개 기록")).toBeVisible();
expect(screen.getByText("7개의 공개 기록")).toBeVisible();
expect(
within(screen.getByRole("main"))
.getAllByRole("listitem")
.map((item) => within(item).getByRole("link").getAttribute("href")),
).toEqual([
// 게시 역순이다 — 개념이 가장 최근이라 맨 앞에 온다.
"/concepts/kubernetes-scheduling",
"/cases/collection-fetch-join-pagination",
"/references/jpa-list-fetch-strategy",
"/references/state-and-nonce-boundary",
@@ -550,7 +552,7 @@ describe("TechLog search discovery", () => {
expect(router.state.location.search).toBe("");
});
expect(await screen.findByRole("heading", { name: "전체 검색 결과" })).toBeVisible();
expect(screen.getByText("9개의 검색 결과")).toBeVisible();
expect(screen.getByText("10개의 검색 결과")).toBeVisible();
expect(screen.getByRole("searchbox", { name: "검색어" })).toHaveValue("");
});
@@ -356,7 +356,7 @@ describe("TechLog release and profile screens", () => {
// list opened with "Backend Architecture", which no record in the fixture
// actually carries — the profile was advertising a topic that did not
// exist, and nothing could have caught it while the list lived in the JSX.
).toEqual(["JPA", "Authentication", "Redis"]);
).toEqual(["JPA", "Authentication", "Kubernetes", "Redis"]);
expect(within(main).queryByText(/이메일|연락처|경력|소속|회사/)).not.toBeInTheDocument();
expect(container.querySelector('a[href^="mailto:"]')).toBeNull();
});
+4 -2
View File
@@ -103,7 +103,7 @@ test("searches public entities by title, summary, topic, and project without dup
);
const allPaths = searchPublicContent("").map((item) => item.path);
assert.equal(allPaths.length, 9);
assert.equal(allPaths.length, 10);
assert.equal(new Set(allPaths).size, allPaths.length);
});
@@ -139,7 +139,7 @@ test("derives project records, decisions, and activity from canonical relationsh
});
test("keeps the approved canonical corpus and grounded profile", () => {
assert.equal(publicRecords.length, 6);
assert.equal(publicRecords.length, 7);
assert.equal(projects.length, 2);
assert.equal(releases.length, 1);
assert.equal(profile.name, "동현");
@@ -153,6 +153,8 @@ test("keeps the approved canonical corpus and grounded profile", () => {
assert.deepEqual(
publicRecords.map((item) => item.path),
[
// 개념은 프로젝트 없이 서는 유일한 종류다 — 이 코퍼스에서 그 경우를 대표한다.
"/concepts/kubernetes-scheduling",
"/cases/collection-fetch-join-pagination",
"/cases/redis-adapter-ttl-boundary",
"/references/state-and-nonce-boundary",