diff --git a/src/features/tech-log/presentation/public/components/explore-filter-form.tsx b/src/features/tech-log/presentation/public/components/explore-filter-form.tsx index 11df860..f8b2ae2 100644 --- a/src/features/tech-log/presentation/public/components/explore-filter-form.tsx +++ b/src/features/tech-log/presentation/public/components/explore-filter-form.tsx @@ -2,6 +2,14 @@ import { Link, useNavigate } from "react-router-dom"; import type { RecordKind } from "../../../application/ports/public-content-queries.ts"; import { usePublicContent } from "../use-public-content.tsx"; +import { DOCUMENT_KIND_LABELS } from "../../shared/document-kind-labels.ts"; + +/* + 탐색이 거를 수 있는 종류. 이름은 공용 표에서 가져온다 — 예전에는 이 목록만 「개념」이라 + 적어 두어 배지·머리말과 어긋났고, 같은 문서가 화면마다 다른 이름으로 보였다. + 결정은 프로젝트 안에서만 읽히므로 여기 없다. +*/ +const EXPLORE_KINDS = ["CASE", "REFERENCE", "QUESTION", "CONCEPT"] as const; export function ExploreFilterForm({ action, @@ -94,7 +102,7 @@ export function ExploreFilterForm({ onSubmit={submit} > {showType ? ( - + ) : null} diff --git a/src/features/tech-log/presentation/public/components/public-record-list.tsx b/src/features/tech-log/presentation/public/components/public-record-list.tsx index d1d4e2e..431f5b5 100644 --- a/src/features/tech-log/presentation/public/components/public-record-list.tsx +++ b/src/features/tech-log/presentation/public/components/public-record-list.tsx @@ -1,7 +1,10 @@ import { Link } from "react-router-dom"; import type { PublicRecord } from "../../../application/ports/public-content-queries.ts"; -import { DOCUMENT_KIND_LABELS } from "../../shared/document-kind-labels.ts"; +import { + DOCUMENT_KIND_LABELS, + DOCUMENT_KIND_STATES, +} from "../../shared/document-kind-labels.ts"; import { cardSummary } from "../../../domain/content-format/card-summary.ts"; export function PublicRecordList({ @@ -20,7 +23,14 @@ export function PublicRecordList({ {records.map((record) => (
  • - {DOCUMENT_KIND_LABELS[record.kind]} + {/* + 다섯 종류가 같은 회색 11px 로 나오면 목록이 스캔되지 않는다. 색을 다섯 개 칠하는 + 대신 지식의 상태 셋으로만 가른다 — 그중 「아직 모르는 것」만 강조한다. 이 기록에서 + 가장 정직한 신호인데 지금까지 가장 안 보였다. + */} + + {DOCUMENT_KIND_LABELS[record.kind]} +
    {record.title}

    {cardSummary(record.summary)}

    diff --git a/src/features/tech-log/presentation/public/pages/explore-kind-page.tsx b/src/features/tech-log/presentation/public/pages/explore-kind-page.tsx index accc137..22710f0 100644 --- a/src/features/tech-log/presentation/public/pages/explore-kind-page.tsx +++ b/src/features/tech-log/presentation/public/pages/explore-kind-page.tsx @@ -7,12 +7,13 @@ import { import { ExploreFilterForm } from "../components/explore-filter-form.tsx"; import { PublicRecordList } from "../components/public-record-list.tsx"; import { usePublicContent } from "../use-public-content.tsx"; +import { DOCUMENT_KIND_LABELS } from "../../shared/document-kind-labels.ts"; 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: "개념의 내부 동작과 아키텍처를 처음부터 풀어 씁니다." }, + cases: { kind: "CASE", title: DOCUMENT_KIND_LABELS.CASE, description: "문제를 재현하고 관찰한 값에서 설계 결론까지 따라갑니다." }, + references: { kind: "REFERENCE", title: DOCUMENT_KIND_LABELS.REFERENCE, description: "다시 확인할 수 있는 기술 기준과 적용 범위를 정리합니다." }, + questions: { kind: "QUESTION", title: DOCUMENT_KIND_LABELS.QUESTION, description: "확인한 사실과 미지수, 다음 검증을 공개적으로 추적합니다." }, + concepts: { kind: "CONCEPT", title: DOCUMENT_KIND_LABELS.CONCEPT, description: "개념의 내부 동작과 아키텍처를 처음부터 풀어 씁니다." }, } as const; function optionalString(value: unknown): string | undefined { diff --git a/src/features/tech-log/presentation/public/pages/home-page.tsx b/src/features/tech-log/presentation/public/pages/home-page.tsx index c4a3f5d..61f89bb 100644 --- a/src/features/tech-log/presentation/public/pages/home-page.tsx +++ b/src/features/tech-log/presentation/public/pages/home-page.tsx @@ -11,28 +11,32 @@ import { LatestIndex, type LatestEntry, } from "../components/latest-index.tsx"; +import { DOCUMENT_KIND_LABELS } from "../../shared/document-kind-labels.ts"; +/* + 종류별 입구. 예전에는 여기가 "이 낱말은 이런 뜻입니다" 하는 범례였고, 그 낱말을 쓰는 목록은 + 2,000px 위에 있었다 — 배우기 한참 전에 먼저 쓰는 셈이었다. 이름 자체가 하는 일을 말하도록 + 바꾼 뒤로는 뜻풀이가 필요 없으므로, 설명 대신 그 종류에서 무엇을 얻는지를 적는다. + + 라벨은 공용 표에서 가져온다. 여기 손으로 적어 두었을 때 `OpenQuestion` 이라는, 사이트 + 어디에도 없는 여섯 번째 표기가 생겨 있었다. +*/ const exploreEntries = [ { - label: "Case", - description: "문제를 따라가며 검증 과정을 읽습니다", + kind: "CASE", + description: "무엇을 해보고 무엇을 확인했는지", path: "/explore/cases", }, { - label: "Reference", - description: "다시 찾을 수 있는 기술 기준을 확인합니다", + kind: "REFERENCE", + description: "다음에 같은 판단을 할 때 볼 것", path: "/explore/references", }, { - label: "OpenQuestion", - description: "아직 끝나지 않은 판단과 다음 검증을 봅니다", + kind: "QUESTION", + description: "아직 답하지 못한 것과 다음 검증", path: "/explore/questions", }, - { - label: "Project", - description: "여러 기록을 하나의 시스템 맥락에서 연결합니다", - path: "/projects", - }, ] as const; function optionalString(value: unknown): string | undefined { @@ -177,15 +181,15 @@ export function HomePage() {

    Explore

    -

    어떤 맥락으로 읽을까요?

    +

    종류별로 읽기