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,
};
}
@@ -169,7 +169,11 @@ export type Project = {
stage: "DESIGN" | "VALIDATION";
currentGoal: string;
nextStep: string;
topics: ReadonlyArray<string>;
/*
이름만 있으면 그 주제로 갈 수 없다. 프로젝트 화면의 「주요 주제」가 오래 글자 목록이었던
것은 slug 를 여기서 버렸기 때문이고, 계약은 처음부터 둘 다 주고 있었다.
*/
topics: ReadonlyArray<{ name: string; slug: string }>;
decisions: ReadonlyArray<ProjectDecision>;
activity: ReadonlyArray<ProjectActivity>;
};
@@ -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 (
<main id="main-content" className="shell project-page">
<ProjectPageHeader project={project} title={project.title} />
{/*
논지는 이 프로젝트가 무엇을 밝혔는가다. 담을 칸이 없던 동안 목적이 여기 나왔고, 목적은
시작할 때 쓰는 글이라 화면에는 늘 시작할 때의 말만 남았다. 여러 문단으로 쓸 수 있으므로
평문 한 줄이 아니라 산문으로 그린다.
*/}
<section className="project-thesis" aria-labelledby="thesis-title">
<p className="section-kicker">Thesis</p>
<h2 id="thesis-title">프로젝트가 지키는 기준</h2>
<p>{project.thesis}</p>
<h2 id="thesis-title">이 프로젝트가 밝힌 것</h2>
<ProseText text={project.thesis} />
</section>
<dl className="project-status-grid">
<div>
@@ -51,14 +61,21 @@ export function ProjectOverviewPage() {
<dd>{project.nextStep}</dd>
</div>
</dl>
<section
className="project-overview-section"
aria-labelledby="project-scope-title"
>
{/*
숫자 셋(기록 12 · 결정 4 · 활동 9)은 이 프로젝트가 얼마나 큰지는 말해도 어디서부터 읽어야
하는지는 말하지 않는다. 방문자가 실제로 필요한 것은 뒤쪽이므로, 세는 자리를 처음 몇 편으로
바꾼다 — 숫자는 각 목록으로 가는 줄에 남긴다.
*/}
<section className="project-overview-section" aria-labelledby="project-scope-title">
<div>
<p className="section-kicker">Scope</p>
<h2 id="project-scope-title">연결된 작업 맥락</h2>
<p className="section-kicker">Reading order</p>
<h2 id="project-scope-title">여기서부터 읽으면 됩니다</h2>
</div>
{records.length > 0 ? (
<PublicRecordList records={records.slice(0, READING_ORDER_SIZE)} />
) : (
<p className="public-empty-state">아직 공개된 기록이 없습니다.</p>
)}
<div className="project-stat-links">
<Link to={`/projects/${slug}/records`}>
<strong>{records.length}</strong>
@@ -76,9 +93,15 @@ export function ProjectOverviewPage() {
</section>
<section className="project-topics" aria-labelledby="project-topics-title">
<h2 id="project-topics-title">주요 주제</h2>
{/*
주제 이름은 그 주제 화면으로 가는 링크다. 오래 글자 목록이었던 것은 매퍼가 slug 를
버렸기 때문이고, 계약은 처음부터 이름과 slug 를 함께 주고 있었다.
*/}
<ul>
{project.topics.map((topic) => (
<li key={topic}>{topic}</li>
<li key={topic.slug || topic.name}>
{topic.slug ? <Link to={`/topics/${topic.slug}`}>{topic.name}</Link> : topic.name}
</li>
))}
</ul>
</section>