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:
co-authored by
Claude Opus 5
parent
048c1b2f68
commit
071405a6bb
@@ -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(
|
||||
|
||||
Reference in New Issue
Block a user