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:
co-authored by
Claude Opus 5
parent
604ded5720
commit
3510ec013f
@@ -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>
|
||||
|
||||
Reference in New Issue
Block a user