From 3510ec013f43218dc00eb42f9a00987ab21fd45c Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Tue, 1 Sep 2026 17:19:32 +0900 Subject: [PATCH] =?UTF-8?q?feat:=20=ED=94=84=EB=A1=9C=EC=A0=9D=ED=8A=B8=20?= =?UTF-8?q?=ED=99=94=EB=A9=B4=EC=9D=B4=20=EC=96=B4=EB=94=94=EC=84=9C?= =?UTF-8?q?=EB=B6=80=ED=84=B0=20=EC=9D=BD=EC=9D=84=EC=A7=80=EB=A5=BC=20?= =?UTF-8?q?=EB=A7=90=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 숫자 셋(기록 12 · 결정 4 · 활동 9)은 이 프로젝트가 얼마나 큰지는 말해도 어디서부터 읽어야 하는지는 말하지 않는다. 세는 자리를 처음 몇 편으로 바꾸고, 숫자는 각 목록으로 가는 줄에 남긴다. 「주요 주제」는 글자 목록이었다. 매퍼가 이름만 남기고 slug 를 버려서 그 주제로 갈 수가 없었는데, 계약은 처음부터 둘 다 주고 있었다. 논지 자리의 제목도 고친다 — 「프로젝트가 지키는 기준」이 아니라 이 프로젝트가 밝힌 것이고, 여러 문단으로 쓸 수 있으므로 산문으로 그린다. Co-Authored-By: Claude Opus 5 (1M context) Claude-Session: https://claude.ai/code/session_011nAjrqNHGPNngN4aUbcyvJ --- .../http/http-public-content-gateway.ts | 6 +-- .../tech-log/adapters/static/content.ts | 2 +- .../adapters/static/public-content.ts | 17 ++++++-- .../tech-log/adapters/static/public-query.ts | 5 ++- .../ports/public-content-queries.ts | 6 ++- .../public/pages/project-overview-page.tsx | 41 +++++++++++++++---- 6 files changed, 58 insertions(+), 19 deletions(-) diff --git a/src/features/tech-log/adapters/http/http-public-content-gateway.ts b/src/features/tech-log/adapters/http/http-public-content-gateway.ts index 73c5504..6b5acbd 100644 --- a/src/features/tech-log/adapters/http/http-public-content-gateway.ts +++ b/src/features/tech-log/adapters/http/http-public-content-gateway.ts @@ -400,9 +400,9 @@ export function createHttpPublicContentGateway( currentGoal: String(body.currentObjective ?? ""), nextStep: String(body.nextStep ?? ""), topics: Object.freeze( - ((body.topics as readonly Readonly<{ name?: string }>[] | undefined) ?? []) - .map((topic) => topic.name ?? "") - .filter((name) => name.length > 0), + ((body.topics as readonly Readonly<{ name?: string; slug?: string }>[] | undefined) ?? []) + .map((topic) => Object.freeze({ name: topic.name ?? "", slug: topic.slug ?? "" })) + .filter((topic) => topic.name.length > 0), ), decisions: Object.freeze(decisions), activity: Object.freeze(activity), diff --git a/src/features/tech-log/adapters/static/content.ts b/src/features/tech-log/adapters/static/content.ts index 6923308..845ad26 100644 --- a/src/features/tech-log/adapters/static/content.ts +++ b/src/features/tech-log/adapters/static/content.ts @@ -39,7 +39,7 @@ const projectTimeline: ReadonlyArray = projects.flatMap((project) = summary: activity.summary, date: activity.date, dateTime: activity.dateTime, - topic: record?.topic ?? project.topics[0], + topic: record?.topic ?? project.topics[0]?.name ?? "", project: project.title, path: activity.path, }; diff --git a/src/features/tech-log/adapters/static/public-content.ts b/src/features/tech-log/adapters/static/public-content.ts index 605c00d..eda7293 100644 --- a/src/features/tech-log/adapters/static/public-content.ts +++ b/src/features/tech-log/adapters/static/public-content.ts @@ -159,7 +159,7 @@ export type Project = { stage: "DESIGN" | "VALIDATION"; currentGoal: string; nextStep: string; - topics: ReadonlyArray; + topics: ReadonlyArray<{ name: string; slug: string }>; decisions: ReadonlyArray; activity: ReadonlyArray; }; @@ -182,6 +182,7 @@ export type Profile = { introduction: string; principles: ReadonlyArray<{ title: string; description: string }>; currentProjectSlugs: ReadonlyArray; + /** 프로필의 주제는 이름만이다 — 관심사를 적는 자리이고, 주제 화면으로 가는 목록이 아니다. */ topics: ReadonlyArray; email?: string; }; @@ -653,7 +654,12 @@ export const projects: ReadonlyArray = [ stage: "DESIGN", currentGoal: "Filesystem과 Object Storage를 하나의 StoragePort로 통합", nextStep: "MinIO Adapter와 공통 계약 테스트 연결", - topics: ["Backend Architecture", "JPA", "Redis", "Storage"], + topics: [ + { name: "Backend Architecture", slug: "backend-architecture" }, + { name: "JPA", slug: "jpa" }, + { name: "Redis", slug: "redis" }, + { name: "Storage", slug: "storage" }, + ], decisions: [ { id: "storage-port-unification", @@ -749,7 +755,12 @@ export const projects: ReadonlyArray = [ stage: "VALIDATION", currentGoal: "oauth2-proxy 뒤의 Spring 신뢰 경계 결정", nextStep: "JWT 재검증안과 신뢰 헤더안의 위협 모델 비교", - topics: ["Authentication", "OAuth 2.0", "OIDC", "Keycloak"], + topics: [ + { name: "Authentication", slug: "authentication" }, + { name: "OAuth 2.0", slug: "oauth-20" }, + { name: "OIDC", slug: "oidc" }, + { name: "Keycloak", slug: "keycloak" }, + ], decisions: [ { id: "browser-secret-boundary", diff --git a/src/features/tech-log/adapters/static/public-query.ts b/src/features/tech-log/adapters/static/public-query.ts index 26ce04e..7e67a45 100644 --- a/src/features/tech-log/adapters/static/public-query.ts +++ b/src/features/tech-log/adapters/static/public-query.ts @@ -202,7 +202,7 @@ export function getLatestEntries(): LatestRecordEntry[] { summary: activity.summary, path: activity.path, publishedAt: activity.dateTime, - topic: record?.topic ?? project.topics[0] ?? "", + topic: record?.topic ?? project.topics[0]?.name ?? "", project: project.title, }; }), @@ -285,7 +285,8 @@ function projectSearchEntity(project: Project): SearchablePublicEntity { title: project.title, summary: project.summary, path: `/projects/${project.slug}`, - topics: project.topics, + // 검색 항목의 주제는 이름만 쓴다 — 검색어와 맞춰 보는 자리다. + topics: project.topics.map((topic) => topic.name), project: project.title, }; } diff --git a/src/features/tech-log/application/ports/public-content-queries.ts b/src/features/tech-log/application/ports/public-content-queries.ts index 3bc7761..f9aca89 100644 --- a/src/features/tech-log/application/ports/public-content-queries.ts +++ b/src/features/tech-log/application/ports/public-content-queries.ts @@ -169,7 +169,11 @@ export type Project = { stage: "DESIGN" | "VALIDATION"; currentGoal: string; nextStep: string; - topics: ReadonlyArray; + /* + 이름만 있으면 그 주제로 갈 수 없다. 프로젝트 화면의 「주요 주제」가 오래 글자 목록이었던 + 것은 slug 를 여기서 버렸기 때문이고, 계약은 처음부터 둘 다 주고 있었다. + */ + topics: ReadonlyArray<{ name: string; slug: string }>; decisions: ReadonlyArray; activity: ReadonlyArray; }; diff --git a/src/features/tech-log/presentation/public/pages/project-overview-page.tsx b/src/features/tech-log/presentation/public/pages/project-overview-page.tsx index 115fd6e..d916332 100644 --- a/src/features/tech-log/presentation/public/pages/project-overview-page.tsx +++ b/src/features/tech-log/presentation/public/pages/project-overview-page.tsx @@ -5,8 +5,13 @@ import { useRouteInput, } from "../../../../../presentation/routes/route-input.tsx"; import { ProjectPageHeader } from "../components/project-page-header.tsx"; +import { ProseText } from "../../shared/public-render/prose-text.tsx"; +import { PublicRecordList } from "../components/public-record-list.tsx"; import { usePublicContent } from "../use-public-content.tsx"; +/** 첫 화면에 펴 두는 편 수. 넘으면 목록이 되고, 목록은 이미 `/records` 에 있다. */ +const READING_ORDER_SIZE = 4; + export function ProjectOverviewPage() { const { params } = useRouteInput<"TECH_LOG_PROJECT">(); const slug = typeof params.slug === "string" ? params.slug : ""; @@ -32,10 +37,15 @@ export function ProjectOverviewPage() { return (
+ {/* + 논지는 이 프로젝트가 무엇을 밝혔는가다. 담을 칸이 없던 동안 목적이 여기 나왔고, 목적은 + 시작할 때 쓰는 글이라 화면에는 늘 시작할 때의 말만 남았다. 여러 문단으로 쓸 수 있으므로 + 평문 한 줄이 아니라 산문으로 그린다. + */}

Thesis

-

프로젝트가 지키는 기준

-

{project.thesis}

+

이 프로젝트가 밝힌 것

+
@@ -51,14 +61,21 @@ export function ProjectOverviewPage() {
{project.nextStep}
-
+ {/* + 숫자 셋(기록 12 · 결정 4 · 활동 9)은 이 프로젝트가 얼마나 큰지는 말해도 어디서부터 읽어야 + 하는지는 말하지 않는다. 방문자가 실제로 필요한 것은 뒤쪽이므로, 세는 자리를 처음 몇 편으로 + 바꾼다 — 숫자는 각 목록으로 가는 줄에 남긴다. + */} +
-

Scope

-

연결된 작업 맥락

+

Reading order

+

여기서부터 읽으면 됩니다

+ {records.length > 0 ? ( + + ) : ( +

아직 공개된 기록이 없습니다.

+ )}
{records.length} @@ -76,9 +93,15 @@ export function ProjectOverviewPage() {

주요 주제

+ {/* + 주제 이름은 그 주제 화면으로 가는 링크다. 오래 글자 목록이었던 것은 매퍼가 slug 를 + 버렸기 때문이고, 계약은 처음부터 이름과 slug 를 함께 주고 있었다. + */}
    {project.topics.map((topic) => ( -
  • {topic}
  • +
  • + {topic.slug ? {topic.name} : topic.name} +
  • ))}