import { RegisteredNotFoundRoute, useRouteInput, } from "../../../../../presentation/routes/route-input.tsx"; import { PublicDocumentRelations } from "../../shared/public-render/public-document-relations.tsx"; import { ProseText } from "../../shared/public-render/prose-text.tsx"; import type { PublicRecord, RecordKind, } from "../../../application/ports/public-content-queries.ts"; import { DOCUMENT_KIND_LABELS } from "../../shared/document-kind-labels.ts"; import { PublicRecordList } from "../components/public-record-list.tsx"; import { usePublicContent } from "../use-public-content.tsx"; /** * 읽는 순서. * *

서버가 주는 대표 기록(`featuredCases`/`featuredReference`)은 작성자가 주제마다 손으로 * 골라 두는 값이라 대부분 비어 있다. 비어 있으면 열린 질문만 남아, 아직 답이 없는 질문 넷을 * 모아 두고 「먼저 읽을 것」이라 부르게 된다 — 처음 온 사람에게 가장 나쁜 첫 화면이다. * *

그래서 기록 자체에서 순서를 만든다. 원리를 먼저 알고, 그것을 확인한 기록을 보고, 거기서 * 나온 기준을 읽고, 아직 답하지 못한 것을 마지막에 본다. * *

서버의 대표 값을 쓰지 않는 이유는 그것이 순서가 아니라 통 두 개(대표 Case · 열린 질문)라 * 서다. 통을 이어 붙이면 기준이 통째로 빠지고, 채워져 있는 쪽이 질문뿐일 때는 질문만 남는다. */ const READING_ORDER: ReadonlyArray = ["CONCEPT", "CASE", "REFERENCE", "QUESTION"]; /** 한 종류에서 앞의 몇 편까지. 넘으면 순서가 아니라 목록이 된다. */ const PER_KIND = 2; function firstReads(records: ReadonlyArray) { return READING_ORDER.flatMap((kind) => records .filter((record) => record.kind === kind) .slice(0, PER_KIND) .map((record) => ({ label: DOCUMENT_KIND_LABELS[record.kind], title: record.title, path: record.path, summary: record.summary, })), ); } /** * 주제 한 편. * *

이 화면은 오래 주제 셋(`jpa`, `authentication`, `redis`)을 코드에 적어 두고 그 셋만 열었다. * 제목과 설명까지 코드에 있었고, 새 주제를 만들면 화면이 그대로 404 로 갔다 — 계약에는 처음부터 * `/topics/{slug}` 가 있었지만 아무도 부르지 않았다. 손으로 나열한 목록에 새 것을 빠뜨리는 일이 * 이 저장소에서 반복됐고, 여기서는 목록 자체를 없앤다. * *

주제가 답하는 질문(논지)과, 그 질문에 대해 실제로 만들어 본 답들(축)이 이 화면의 뼈대다. * 축이 없는 주제도 있으므로 — 축을 쓸지는 주제마다 다르다 — 비면 그 자리를 그리지 않는다. */ export function TopicPage() { const { params } = useRouteInput<"TECH_LOG_TOPIC">(); const slug = typeof params.slug === "string" ? params.slug : ""; const view = usePublicContent(["tech-log", "topic", slug], async (queries) => ({ topic: await queries.getTopicDetail(slug), records: await queries.listRecords({ topic: slug }), })); if (!view.ready) return view.fallback; const { topic, records } = view.data; if (!topic) return ; const axisLabel = topic.variantLabel.trim() || "접근"; const readingOrder = firstReads(records); const readingPaths = new Set(readingOrder.map((entry) => entry.path)); const rest = records.filter((record) => !readingPaths.has(record.path)); return (

Topic

{topic.name}

{/* 논지가 있으면 그것이 이 주제의 첫 문장이다. 설명은 목록에서 주제를 가려내는 한 줄이고, 논지는 이 주제가 무엇에 답하는지를 말한다 — 둘 다 있으면 논지를 보인다. */}
{topic.variants.length > 0 ? (

{axisLabel}

{`${axisLabel}별로 무엇을 알게 됐나`}

{/* 오른쪽 숫자를 더해도 아래 목록의 개수와 맞지 않는다. 한 기록이 여러 축에 걸릴 수 있고, 어느 축에도 걸리지 않은 기록은 공통이기 때문이다 — 그 규칙을 화면이 말하지 않으면 독자는 빠진 기록이 있다고 읽는다. */}

{`한 기록이 여러 ${axisLabel}에 걸릴 수 있고, 어디에도 걸리지 않은 기록은 이 주제의 공통 기록입니다.`}

) : null} {/* 먼저 읽을 것에 오른 편은 여기서 뺀다. 예전에는 같은 네 편이 위아래로 두 번 나왔다 — 「먼저 읽을 것」이 목록의 앞부분을 복사한 것처럼 보이면 순서를 정해 준 뜻이 없어진다. */}

나머지 기록

{`${rest.length}개`}

); }