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}개`}
);
}