feat: 프로젝트 화면이 어디서부터 읽을지를 말한다

숫자 셋(기록 12 · 결정 4 · 활동 9)은 이 프로젝트가 얼마나 큰지는 말해도 어디서부터
읽어야 하는지는 말하지 않는다. 세는 자리를 처음 몇 편으로 바꾸고, 숫자는 각 목록으로
가는 줄에 남긴다.

「주요 주제」는 글자 목록이었다. 매퍼가 이름만 남기고 slug 를 버려서 그 주제로 갈 수가
없었는데, 계약은 처음부터 둘 다 주고 있었다.

논지 자리의 제목도 고친다 — 「프로젝트가 지키는 기준」이 아니라 이 프로젝트가 밝힌
것이고, 여러 문단으로 쓸 수 있으므로 산문으로 그린다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011nAjrqNHGPNngN4aUbcyvJ
This commit is contained in:
DongHyeonka
2026-09-01 17:19:32 +09:00
co-authored by Claude Opus 5
parent 604ded5720
commit 3510ec013f
6 changed files with 58 additions and 19 deletions
@@ -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),
@@ -39,7 +39,7 @@ const projectTimeline: ReadonlyArray<LatestEntry> = 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,
};
@@ -159,7 +159,7 @@ export type Project = {
stage: "DESIGN" | "VALIDATION";
currentGoal: string;
nextStep: string;
topics: ReadonlyArray<string>;
topics: ReadonlyArray<{ name: string; slug: string }>;
decisions: ReadonlyArray<ProjectDecision>;
activity: ReadonlyArray<ProjectActivity>;
};
@@ -182,6 +182,7 @@ export type Profile = {
introduction: string;
principles: ReadonlyArray<{ title: string; description: string }>;
currentProjectSlugs: ReadonlyArray<string>;
/** 프로필의 주제는 이름만이다 — 관심사를 적는 자리이고, 주제 화면으로 가는 목록이 아니다. */
topics: ReadonlyArray<string>;
email?: string;
};
@@ -653,7 +654,12 @@ export const projects: ReadonlyArray<Project> = [
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<Project> = [
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",
@@ -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,
};
}