refactor: 화면에서 내려간 것들의 잔해를 지운다

앞 커밋이 홈의 「종류별로 읽기」와 주제의 묶음 상태, 머리말의 종류 링크를
내렸다. 그것들만 쓰던 것이 남아 있었다.

- `explorePath` 와 그것만 부르던 `EXPLORE_KIND_PATHS`: 종류 링크가 사라지며
  호출부가 없어졌다. eslint 는 안 잡는다
- `record-state-summary.tsx` 와 `.record-state*` 63줄: 주제 화면이 더는
  부르지 않는다
- `.explore-section`·`.explore-heading`·`.explore-list` 82줄: 홈의 그 구역
  전용이었다
- `.topic-knowledge-heading`·`.topic-open-heading`: 규칙이 하나도 없는 이름
  이다. 모양은 `.public-result-heading > div` 가 낸다

주석 셋이 코드와 어긋나 있었다. 지금 코드대로 고친다.

- `topic-page.tsx`: 「흐름에 오른 편은 여기서 뺀다」고 적혀 있었지만 이제
  빼지 않는다. 흐름과 이 목록이 답하는 질문이 달라졌다는 것을 적는다
- `globals.css`: `.section-heading-row h2` 를 쓰는 곳에서 「종류별로 읽기」를
  지우고 지금 쓰는 두 곳을 적는다
- `home-page.tsx`: 종류 이름이 아홉 개 뜨던 이야기는 역사로 남기되, 그
  구역이 지금은 없다는 것과 표를 계속 쓰는 이유를 적는다

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Cfj8mZ9QmT3MEKonzM5xPj
This commit is contained in:
DongHyeonka
2026-09-16 21:52:47 +09:00
co-authored by Claude Opus 5
parent 99c05c567d
commit b297d659f5
6 changed files with 19 additions and 258 deletions
@@ -1,81 +0,0 @@
import type {
PublicRecord,
RecordKind,
} from "../../../application/ports/public-content-queries.ts";
import { DOCUMENT_KIND_LABELS } from "../../shared/document-kind-labels.ts";
/**
* 세는 순서. 원리를 먼저 알고, 그것을 확인하고, 거기서 기준이 나오고, 재현할 환경이 따르고,
* 아직 답하지 못한 것이 마지막이다 — 읽는 순서와 같게 둔다.
*
* <p>`Record<RecordKind, …>` 라 종류가 늘면 컴파일러가 빈 자리를 잡는다. 손으로 나열한 목록에
* 새 종류를 빠뜨리는 일이 이 저장소에서 반복됐고, 여기서 빠지면 그 종류의 기록은 세어지지도
* 「아직 없는 것」에 적히지도 않아 화면이 조용히 거짓말을 한다.
*/
const COUNT_ORDER: Record<RecordKind, number> = {
CONCEPT: 1,
CASE: 2,
REFERENCE: 3,
SETUP: 4,
QUESTION: 5,
};
const KINDS: ReadonlyArray<RecordKind> = Object.freeze(
(Object.keys(COUNT_ORDER) as RecordKind[]).sort(
(left, right) => COUNT_ORDER[left] - COUNT_ORDER[right],
),
);
/**
* 이 묶음이 지금 어디까지 왔는지.
*
* <p>주제 화면은 기록이 하나뿐일 때 거의 빈 화면이 됐다. 제목과 한 줄, 그리고 목록 한 줄. 그
* 상태에서는 "아직 아무것도 없는 곳"과 "이제 막 시작한 조사"가 구분되지 않는다 — 둘 다 빈
* 화면으로 보인다.
*
* <p>그래서 무엇이 있고 무엇이 아직 없는지를 함께 적는다. 「아직 없는 것」이 이 화면에서 가장
* 쓸모 있는 줄이다. 조사가 어디까지 왔는지를 그 한 줄이 말한다.
*
* <p>세는 대상은 화면 아래 목록과 같은 배열이다. 다른 곳에서 가져오면 위의 숫자와 아래의 개수가
* 어긋나고, 독자는 빠진 기록이 있다고 읽는다.
*/
export function RecordStateSummary({
records,
headingId,
}: {
records: ReadonlyArray<PublicRecord>;
headingId: string;
}) {
const counts = new Map<RecordKind, number>();
for (const record of records) {
counts.set(record.kind, (counts.get(record.kind) ?? 0) + 1);
}
const present = KINDS.filter((kind) => (counts.get(kind) ?? 0) > 0);
const missing = KINDS.filter((kind) => (counts.get(kind) ?? 0) === 0);
return (
<section className="record-state" aria-labelledby={headingId}>
<p className="section-kicker">State</p>
<h2 id={headingId}>지금까지</h2>
{present.length > 0 ? (
<dl className="record-state-counts">
{present.map((kind) => (
<div key={kind}>
<dt>{DOCUMENT_KIND_LABELS[kind]}</dt>
<dd>{counts.get(kind)}</dd>
</div>
))}
</dl>
) : (
<p className="record-state-empty">아직 공개된 기록이 없습니다.</p>
)}
{missing.length > 0 ? (
<p className="record-state-missing">
<span>아직 없는 것</span>
{missing.map((kind) => DOCUMENT_KIND_LABELS[kind]).join(" · ")}
</p>
) : null}
</section>
);
}
@@ -34,9 +34,10 @@ function optionalString(value: unknown): string | undefined {
* 최근 기록 한 줄이 다는 이름. * 최근 기록 한 줄이 다는 이름.
* *
* <p>이 표가 영문 대문자를 그대로 흘려보내던 동안 홈 한 화면에 종류 이름이 아홉 개 떠 있었다 — * <p>이 표가 영문 대문자를 그대로 흘려보내던 동안 홈 한 화면에 종류 이름이 아홉 개 떠 있었다 —
* 목록에는 `CASE`·`CONCEPT`·`OPEN QUESTION`·`REFERENCE`, 바로 아래 「종류별로 읽기」에는 * 목록에는 `CASE`·`CONCEPT`·`OPEN QUESTION`·`REFERENCE`, 그때 아래에 있던 「종류별로 읽기」에는
* 「검증 기록」·「동작 원리」·「적용 기준」·「열린 질문」. 독자는 둘이 같은 것이라는 단서를 * 「검증 기록」·「동작 원리」·「적용 기준」·「열린 질문」. 독자는 둘이 같은 것이라는 단서를
* 어디서도 받지 못했다. 이름을 바꾸기 전보다 나빠진 유일한 자리였다. * 어디서도 받지 못했다. 그 구역은 주 내비와 겹쳐 내렸고 목록만 남았지만, 이름을 표에서
* 가져오는 이유는 그대로다 — 같은 종류가 두 이름으로 나가는 자리를 다시 만들지 않는다.
* *
* <p>기록의 네 종류는 공용 표에서 가져온다. 프로젝트 활동만 여기 따로 적는다 — 기록이 아니라 * <p>기록의 네 종류는 공용 표에서 가져온다. 프로젝트 활동만 여기 따로 적는다 — 기록이 아니라
* 프로젝트에서 일어난 일이라 `RecordKind` 에 없다. * 프로젝트에서 일어난 일이라 `RecordKind` 에 없다.
@@ -191,8 +192,6 @@ export function HomePage() {
entries={requestedState === "latest-empty" ? [] : latestEntries} entries={requestedState === "latest-empty" ? [] : latestEntries}
status={requestedState === "latest-error" ? "error" : "ready"} status={requestedState === "latest-error" ? "error" : "ready"}
/> />
</main> </main>
); );
} }
@@ -138,10 +138,18 @@ export function TopicPage() {
) : null} ) : null}
{/* {/*
흐름에 오른 편은 여기서 뺀다. 예전에는 같은 네 편이 위아래로 두 번 나왔다 — 순서를 원리·기준·절차는 위 흐름에도 나오고 여기에도 나온다. 한때는 흐름에 오른 편을 여기서
정해 준 자리가 목록의 앞부분을 복사한 것처럼 보이면 순서를 정해 준 뜻이 없어진다. 뺐는데, 그때 이 목록은 「흐름에 못 든 나머지」라는 뜻이었다. 지금 둘은 답하는 질문이
다르다 — 흐름은 몇 번째 생각이었나를, 이 목록은 이 주제가 무엇을 정리해 두었나를
말한다. 그래서 같은 편이 두 자리에 서는 것이 복사가 아니다.
검증 기록과 질문은 여기 오지 않는다. 앞의 것은 흐름이, 뒤의 것은 아래 「아직 답하지
못한 질문」이 맡는다.
흐름이 서지 않는 주제(두 칸이 못 되는 주제)만 예외로 질문 아닌 기록을 전부 받는다.
그러지 않으면 기록이 하나뿐인 주제에서 그 하나가 어디에도 안 남는다.
*/} */}
<div className="public-result-heading topic-knowledge-heading"> <div className="public-result-heading">
<div> <div>
<p className="section-kicker">Knowledge</p> <p className="section-kicker">Knowledge</p>
<h2>정리된 개념과 기준</h2> <h2>정리된 개념과 기준</h2>
@@ -159,7 +167,7 @@ export function TopicPage() {
*/} */}
{open.length > 0 ? ( {open.length > 0 ? (
<> <>
<div className="public-result-heading topic-open-heading"> <div className="public-result-heading">
<div> <div>
<p className="section-kicker">Open</p> <p className="section-kicker">Open</p>
<h2>아직 답하지 못한 질문</h2> <h2>아직 답하지 못한 질문</h2>
@@ -42,22 +42,3 @@ export const DOCUMENT_KIND_STATES: Record<RecordKind, "CONFIRMED" | "SETTLED" |
/* 셋업은 확인한 것도 열린 것도 아니다 — 절차를 정리해 둔 것이다. */ /* 셋업은 확인한 것도 열린 것도 아니다 — 절차를 정리해 둔 것이다. */
SETUP: "SETTLED", SETUP: "SETTLED",
}; };
/**
* 종류별 목록으로 가는 주소.
*
* <p>이 대응이 세 화면에 흩어져 있었고 셋 다 개념을 빠뜨렸다 — 홈의 「종류별로 읽기」에는 개념이
* 아예 없었고, 문서 머리말의 종류 링크는 삼항의 마지막 else 를 타 개념 문서에서 `/projects` 로
* 갔다. `/explore/concepts` 는 처음부터 열려 있었는데 그리로 가는 길이 없었다.
*
* <p>결정은 프로젝트 안에서만 읽히므로 자기 목록이 없다. 그 자리를 `/projects` 로 두는 것은
* 빠뜨린 것이 아니라 그렇게 정한 것이고, 표에 적혀 있으니 다음 사람이 구분할 수 있다.
*/
export const EXPLORE_KIND_PATHS: Record<RecordKind, string> = {
CASE: "/explore/cases",
CONCEPT: "/explore/concepts",
REFERENCE: "/explore/references",
QUESTION: "/explore/questions",
PROJECT_DECISION: "/projects",
SETUP: "/explore/setups",
};
@@ -15,7 +15,7 @@ import {
PublicDocumentRelations, PublicDocumentRelations,
type PublicRelation, type PublicRelation,
} from "./public-document-relations.tsx"; } from "./public-document-relations.tsx";
import { DOCUMENT_KIND_LABELS, EXPLORE_KIND_PATHS } from "../document-kind-labels.ts"; import { DOCUMENT_KIND_LABELS } from "../document-kind-labels.ts";
import { useDocumentMetadata } from "../use-document-metadata.ts"; import { useDocumentMetadata } from "../use-document-metadata.ts";
type PublicRenderModel = components["schemas"]["PublicRenderModel"]; type PublicRenderModel = components["schemas"]["PublicRenderModel"];
@@ -53,10 +53,6 @@ function publishedLabel(
return resolvePublishedLabel(model.publicPath) ?? "게시 전"; return resolvePublishedLabel(model.publicPath) ?? "게시 전";
} }
function explorePath(kind: PublicRenderModelBase["kind"]) {
return EXPLORE_KIND_PATHS[kind];
}
function TargetLink({ function TargetLink({
target, target,
}: { }: {
@@ -653,8 +653,7 @@ a {
font-size: 13px; font-size: 13px;
} }
.latest-section, .latest-section {
.explore-section {
padding-top: 128px; padding-top: 128px;
} }
@@ -679,7 +678,6 @@ a {
} }
.latest-list, .latest-list,
.explore-list,
.document-relations ul { .document-relations ul {
margin: 0; margin: 0;
padding: 0; padding: 0;
@@ -795,57 +793,6 @@ a {
.latest-state--error p { margin: 0; } .latest-state--error p { margin: 0; }
.explore-section {
padding-bottom: 140px;
}
.explore-heading {
padding-bottom: 27px;
}
.explore-list {
border-top: 1px solid var(--line-strong);
}
.explore-list li {
border-bottom: 1px solid var(--line);
}
.explore-list li > a {
display: grid;
min-height: 76px;
grid-template-columns: minmax(0, 1fr) 150px 22px;
gap: 24px;
align-items: center;
color: var(--ink-soft);
font-size: 17px;
letter-spacing: -0.015em;
}
.explore-list strong {
color: var(--ink);
font-size: 14px;
font-weight: 620;
}
.explore-list li > a > span:last-child {
color: var(--faint);
opacity: 0;
transform: translateX(-4px);
transition:
opacity 120ms ease,
transform 120ms ease;
}
.explore-list li > a:hover {
color: var(--signal);
}
.explore-list li > a:hover > span:last-child {
opacity: 1;
transform: translateX(0);
}
.site-footer { .site-footer {
border-top: 1px solid var(--line); border-top: 1px solid var(--line);
} }
@@ -1835,8 +1782,7 @@ dialog::backdrop {
margin-top: 27px; margin-top: 27px;
} }
.latest-section, .latest-section {
.explore-section {
padding-top: 92px; padding-top: 92px;
} }
@@ -1891,31 +1837,6 @@ dialog::backdrop {
transform: none; transform: none;
} }
.explore-section {
padding-bottom: 100px;
}
.explore-list li > a {
min-height: 88px;
grid-template-columns: minmax(0, 1fr) 18px;
gap: 15px;
padding: 14px 0;
font-size: 16px;
line-height: 1.55;
}
.explore-list strong {
grid-row: 2;
font-size: 12px;
}
.explore-list li > a > span:last-child {
grid-row: 1 / span 2;
grid-column: 2;
opacity: 1;
transform: none;
}
.footer-inner { .footer-inner {
min-height: 204px; min-height: 204px;
flex-direction: column; flex-direction: column;
@@ -2573,7 +2494,7 @@ dialog::backdrop {
.public-document-body h2, .public-document-body h2,
.reference-purpose h2, .reference-purpose h2,
/* /*
구역 제목은 한 급이다. 정본은 `.section-heading-row h2` 이고(최근 기록·종류별로 읽기가 쓴다), 구역 제목은 한 급이다. 정본은 `.section-heading-row h2` 이고(홈의 프로젝트·최근 기록이 쓴다),
그 안에 들어가지 않는 두 구역이 크기만 각자 적어 두어 굵기를 아무도 정하지 않았다. 그래서 그 안에 들어가지 않는 두 구역이 크기만 각자 적어 두어 굵기를 아무도 정하지 않았다. 그래서
400 으로 떨어져, 같은 화면에서 「구조별로 알게 된 것」만 형제 구역보다 작고 가늘게 나왔다 — 400 으로 떨어져, 같은 화면에서 「구조별로 알게 된 것」만 형제 구역보다 작고 가늘게 나왔다 —
디자인이 빠진 것처럼 보인 자리다. 값을 정본과 맞춘다. 디자인이 빠진 것처럼 보인 자리다. 값을 정본과 맞춘다.
@@ -3138,69 +3059,6 @@ textarea.studio-control { min-height: 118px; resize: vertical; line-height: 1.65
} }
} }
/* 묶음의 상태 — 무엇이 있고 무엇이 아직 없는가 */
.record-state {
padding-block: 26px 30px;
border-bottom: 1px solid var(--line);
}
.record-state h2 {
margin: 6px 0 0;
font-size: 21px;
font-weight: 640;
letter-spacing: -0.024em;
}
.record-state-counts {
display: flex;
flex-wrap: wrap;
gap: 12px 34px;
margin: 17px 0 0;
}
.record-state-counts > div {
display: flex;
gap: 9px;
align-items: baseline;
}
.record-state-counts dt {
color: var(--muted);
font-size: 13px;
font-weight: 600;
}
.record-state-counts dd {
margin: 0;
color: var(--ink);
font-family: "IBM Plex Mono", monospace;
font-size: 17px;
font-weight: 620;
}
/*
이 줄이 이 구역에서 가장 쓸모 있다. 조사가 어디까지 왔는지를 「아직 없는 것」이 말한다 —
그래서 있는 것들보다 흐리게 두되 지우지는 않는다.
*/
.record-state-missing {
margin: 15px 0 0;
color: var(--muted);
font-size: 13px;
}
.record-state-missing > span {
margin-right: 10px;
color: var(--faint);
font-weight: 640;
}
.record-state-empty {
margin: 15px 0 0;
color: var(--muted);
font-size: 15px;
}
/* 결정이 없는 프로젝트. 빈 종이 대신 조사의 상태를 말한다. */ /* 결정이 없는 프로젝트. 빈 종이 대신 조사의 상태를 말한다. */
.project-empty-decisions { .project-empty-decisions {