feat: 개념의 공개 라우트와 탐색 유형을 설치한다

앞선 커밋은 렌더러와 편집기까지만 붙였다. 화면을 열어 보니 탐색의 유형 선택지에 개념이 없고
`/concepts/:slug` 라우트도 없었다 — 라벨 표만 고치고 실제 선택지와 라우트를 빠뜨렸다.

라우트를 하나 더하자 이 저장소가 라우트 수를 고정해 둔 자리가 전부 울렸다. 라우트 계약,
런타임 등록, 메시지 카탈로그, nginx 서빙 패턴, 코드 분할 청크, 그리고 CI 게이트의 수동
접근성 증거까지 — 라우트마다 증거 문서를 하나씩 갖는 규칙이라 `TECH_LOG_CONCEPT.md` 를
다른 라우트와 같은 `pending-manual-review` 상태로 만들었다. 사람이 서명할 자리는 비워 둔다.

게이트 형상 해시는 규칙대로 다시 계산했다 — 옛 `gates.json` 에서 이전 상수 fb138e7c… 를
먼저 재현해 계산 방법이 맞는지 확인한 뒤 새 파일을 해싱했다.

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 20:17:58 +09:00
co-authored by Claude Opus 5
parent 048c1b2f68
commit 071405a6bb
14 changed files with 168 additions and 10 deletions
@@ -0,0 +1,81 @@
import type { ConceptRecord } from "../../../application/ports/public-content-queries.ts";
import {
parseCaseContent,
type CaseAuthoringBlock,
} from "../../../domain/content-format/parse-case-content.ts";
import { resolveCaseEvidenceAssets } from "../../../domain/content-format/project-public-render-model.ts";
import { PublicRecordRenderer } from "../../shared/public-render/public-record-renderer.tsx";
import { publicRenderModelBase } from "./public-document-header.tsx";
/**
* 개념의 본문은 Case 와 같은 파서를 탄다 — `##` 소제목이 목차가 되고 `:::evidence` 가 도식을
* 끌어온다. 아키텍처를 설명하는 글에 그림이 붙는 길이 그것뿐이다.
*
* <p>본문이 지원하지 않는 문법을 담고 있으면 화면 전체를 잃는 대신 빈 블록으로 돌아간다.
* 읽는 사람에게는 덜 정확한 화면이 빈 화면보다 낫다 — Case 가 쓰는 것과 같은 판단이다.
*/
function conceptBodyBlocks(record: ConceptRecord): CaseAuthoringBlock[] {
if (!record.content.trim()) return [];
try {
return parseCaseContent(record.content);
} catch {
return [];
}
}
export function ConceptDocumentPage({ record }: { record: ConceptRecord }) {
/*
본문은 evidence 를 key 로만 가리키고 `/media/{assetId}` 는 UUID 로만 서빙하므로, 계약이 함께
준 `bodyAssets` 로 key 를 주소로 바꾼다. 대응이 없는 key 는 그 블록을 지운다 — 해석기가
던지면 문서 전체가 사라지고, 남겨 두면 주소 없는 그림 자리가 남는다.
*/
const assetsByKey = new Map(
record.bodyAssets.map((asset) => [asset.assetKey, asset]),
);
const blocks = conceptBodyBlocks(record).filter(
(block) => block.type !== "EVIDENCE_FIGURE" || assetsByKey.has(block.key),
);
const model = resolveCaseEvidenceAssets(
{
...publicRenderModelBase(record),
kind: "CONCEPT",
basisVersion: record.basisVersion,
bodyBlocks: blocks,
},
(key) => {
const asset = assetsByKey.get(key);
// 위에서 이미 걸렀다 — 여기 닿으면 필터와 해석기가 어긋난 것이다.
if (!asset) throw new Error(`concept evidence asset not found: ${key}`);
return {
assetId: asset.assetId,
assetKey: asset.assetKey,
mediaType: asset.contentType,
publicPath: asset.url,
width: asset.width,
height: asset.height,
decorative: asset.decorative,
};
},
);
return (
<PublicRecordRenderer
model={model}
resolveEvidenceAsset={(key) => {
const asset = assetsByKey.get(key);
if (!asset) throw new Error(`concept evidence asset not found: ${key}`);
return {
src: asset.url,
width: asset.width ?? 0,
height: asset.height ?? 0,
triggerLabel: `${asset.altText || asset.assetKey} 크게 보기`,
dialogLabel: asset.altText || asset.assetKey,
};
}}
resolvePublishedLabel={(path) =>
path === record.path ? record.publishedLabel : undefined
}
/>
);
}
@@ -94,7 +94,7 @@ export function ExploreFilterForm({
onSubmit={submit}
>
{showType ? (
<label><span>유형</span><select name="type" defaultValue={kind ?? ""}><option value="">전체</option><option value="CASE">Case</option><option value="REFERENCE">Reference</option><option value="QUESTION">Open Question</option></select></label>
<label><span>유형</span><select name="type" defaultValue={kind ?? ""}><option value="">전체</option><option value="CASE">Case</option><option value="REFERENCE">Reference</option><option value="QUESTION">Open Question</option><option value="CONCEPT">개념</option></select></label>
) : null}
<label><span>주제</span><select name="topic" defaultValue={selectedTopic ?? ""}><option value="">전체</option>{topics.map((item) => <option value={item.slug} key={item.slug}>{item.name}</option>)}</select></label>
<label><span>프로젝트</span><select name="project" defaultValue={selectedProject ?? ""}><option value="">전체</option>{projects.map((item) => <option value={item.slug} key={item.slug}>{item.title}</option>)}</select></label>
@@ -0,0 +1,29 @@
import {
RegisteredNotFoundRoute,
useRouteInput,
} from "../../../../../presentation/routes/route-input.tsx";
import { ConceptDocumentPage } from "../components/concept-document-page.tsx";
import { usePublicContent } from "../use-public-content.tsx";
function optionalString(value: unknown): string | undefined {
return typeof value === "string" ? value : undefined;
}
export function ConceptPage() {
const { params } = useRouteInput<"TECH_LOG_CONCEPT">();
const slug = optionalString(params.slug);
const view = usePublicContent(
["tech-log", "concept", slug],
async (queries) => ({
record: slug ? await queries.getRecord("CONCEPT", slug) : undefined,
}),
);
if (!view.ready) return view.fallback;
const { record } = view.data;
return record ? (
<ConceptDocumentPage record={record} />
) : (
<RegisteredNotFoundRoute />
);
}
@@ -12,6 +12,7 @@ const kinds = {
cases: { kind: "CASE", title: "Case", description: "문제를 재현하고 관찰한 값에서 설계 결론까지 따라갑니다." },
references: { kind: "REFERENCE", title: "Reference", description: "다시 확인할 수 있는 기술 기준과 적용 범위를 정리합니다." },
questions: { kind: "QUESTION", title: "Open Question", description: "확인한 사실과 미지수, 다음 검증을 공개적으로 추적합니다." },
concepts: { kind: "CONCEPT", title: "개념", description: "개념의 내부 동작과 아키텍처를 처음부터 풀어 씁니다." },
} as const;
function optionalString(value: unknown): string | undefined {
@@ -19,7 +20,12 @@ function optionalString(value: unknown): string | undefined {
}
function getKindConfig(value: string | undefined) {
if (value === "cases" || value === "references" || value === "questions") {
if (
value === "cases" ||
value === "references" ||
value === "questions" ||
value === "concepts"
) {
return kinds[value];
}
return undefined;
@@ -68,6 +68,13 @@ export const TECH_LOG_ROUTE_RUNTIME = Object.freeze({
"ReferencePage",
),
),
TECH_LOG_CONCEPT: runtime(
"TECH_LOG_CONCEPT",
routeModule(
() => import("./public/pages/concept-page.tsx"),
"ConceptPage",
),
),
TECH_LOG_QUESTION: runtime(
"TECH_LOG_QUESTION",
routeModule(