feat: 홈이 길을 보여 주고, 활동이 사람 말로 적힌다
홈의 첫 문장은 글 쓰는 태도를 말했다 — "문제를 재현하고 검증해 정리합니다". 맞는 말이지만 처음 온 사람이 알아야 하는 것은 태도가 아니라 길이다. 이 사이트에서 기록은 한 편으로 끝나지 않고 프로젝트 안의 주제에 속하고 주제 안에서 서로 이어진다. 그 구조를 설명하는 문장보다 실제 사슬 하나가 빠르므로, 최근 기록이 가장 많이 모인 주제를 골라 프로젝트 → 주제 → 기록으로 편다. 예시를 코드에 적어 두지 않는다 — 그 기록을 지우는 순간 홈이 죽은 링크를 가리킨다. 프로젝트 활동은 종류 자리에 `CONCEPT_PUBLISHED` 를 그대로 찍고 있었다. 그것은 데이터베이스 제약(`project_activity_activity_type_check`)이 허용하는 값이지 방문자에게 할 말이 아니다 — 감사 로그처럼 읽히고, 정작 무슨 일이 있었는지는 알 수 없었다. 포트의 타입은 `"PUBLICATION" | "PROJECT UPDATE" | "QUESTION"` 셋으로 적혀 있었는데 서버는 그중 무엇도 보내지 않는다. 매퍼가 단언으로 통과시켜서 타입 검사도 이것을 잡지 못했다. 실제 값 열하나로 맞추고, `Record<ProjectActivityType, string>` 표로 사람이 읽는 문장을 만든다. 픽스처도 같은 값을 쓰게 했다 — 픽스처가 자기만의 말을 쓰던 동안 화면은 픽스처에서만 멀쩡했다. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015c8cBFUaVr7KLVUx6ujz7D
This commit is contained in:
co-authored by
Claude Opus 5
parent
e88ed5eeb8
commit
0b0c5cb42d
@@ -26,16 +26,12 @@ const publicRecordByPath = new Map(publicRecords.map((record) => [record.path, r
|
||||
const projectTimeline: ReadonlyArray<LatestEntry> = projects.flatMap((project) =>
|
||||
project.activity.map((activity) => {
|
||||
const record = publicRecordByPath.get(activity.recordPath ?? activity.path);
|
||||
// 기록을 공개한 활동인가. 종류 이름이 아니라 접미사로 가른다 — 종류가 늘어도 그대로다.
|
||||
const published = activity.type.endsWith("_PUBLISHED") && record;
|
||||
return {
|
||||
id: activity.id,
|
||||
typeLabel:
|
||||
activity.type === "PUBLICATION" && record
|
||||
? record.kind
|
||||
: "PROJECT ACTIVITY",
|
||||
title:
|
||||
activity.type === "PUBLICATION" && record
|
||||
? record.title
|
||||
: activity.title,
|
||||
typeLabel: published ? record.kind : "PROJECT ACTIVITY",
|
||||
title: published ? record.title : activity.title,
|
||||
summary: activity.summary,
|
||||
date: activity.date,
|
||||
dateTime: activity.dateTime,
|
||||
|
||||
@@ -1,4 +1,21 @@
|
||||
export type RecordKind = "CASE" | "REFERENCE" | "QUESTION" | "CONCEPT" | "SETUP";
|
||||
|
||||
/**
|
||||
* 활동 종류. 서버가 실제로 내보내는 값과 같은 집합이다 — 어긋나면 `public-query.ts` 가 포트
|
||||
* 타입으로 옮길 때 컴파일러가 잡는다.
|
||||
*/
|
||||
export type ProjectActivityType =
|
||||
| "PHASE_CHANGED"
|
||||
| "QUESTION_OPENED"
|
||||
| "QUESTION_RESOLVED"
|
||||
| "DECISION_ACCEPTED"
|
||||
| "CASE_PUBLISHED"
|
||||
| "REFERENCE_PUBLISHED"
|
||||
| "CONCEPT_PUBLISHED"
|
||||
| "SETUP_PUBLISHED"
|
||||
| "MILESTONE_REACHED"
|
||||
| "PROJECT_PAUSED"
|
||||
| "PROJECT_RESUMED";
|
||||
export type QuestionStatus =
|
||||
| "OPEN"
|
||||
| "INVESTIGATING"
|
||||
@@ -159,7 +176,11 @@ export type ProjectActivity = {
|
||||
id: string;
|
||||
date: string;
|
||||
dateTime: string;
|
||||
type: "PUBLICATION" | "PROJECT UPDATE" | "QUESTION";
|
||||
/*
|
||||
서버가 실제로 내보내는 값과 같은 집합을 쓴다. 픽스처가 `"PUBLICATION"` 같은 자기만의 말을
|
||||
쓰던 동안, 화면은 픽스처에서는 멀쩡하고 배포본에서만 데이터베이스 상수를 찍었다.
|
||||
*/
|
||||
type: ProjectActivityType;
|
||||
title: string;
|
||||
summary: string;
|
||||
path: string;
|
||||
@@ -735,7 +756,7 @@ export const projects: ReadonlyArray<Project> = [
|
||||
id: "fetch-join-case-published",
|
||||
date: "2026.08.11",
|
||||
dateTime: "2026-08-11T14:10:00+09:00",
|
||||
type: "PUBLICATION",
|
||||
type: "CASE_PUBLISHED",
|
||||
title: "Fetch Join과 페이징 Case를 게시했습니다",
|
||||
summary: "20건을 요청했지만 DB LIMIT 없이 전체 컬렉션이 로드되는 과정을 측정했습니다.",
|
||||
path: "/cases/collection-fetch-join-pagination",
|
||||
@@ -745,7 +766,7 @@ export const projects: ReadonlyArray<Project> = [
|
||||
id: "storage-contract",
|
||||
date: "2026.08.10",
|
||||
dateTime: "2026-08-10T18:40:00+09:00",
|
||||
type: "PROJECT UPDATE",
|
||||
type: "MILESTONE_REACHED",
|
||||
title: "파일 저장소 계약을 하나로 통합했습니다",
|
||||
summary: "Filesystem과 Object Storage를 같은 Port 뒤의 Adapter로 정리했습니다.",
|
||||
path: "/projects/backend-skeleton/activity#storage-contract",
|
||||
@@ -754,7 +775,7 @@ export const projects: ReadonlyArray<Project> = [
|
||||
id: "redis-case-published",
|
||||
date: "2026.08.07",
|
||||
dateTime: "2026-08-07T16:30:00+09:00",
|
||||
type: "PUBLICATION",
|
||||
type: "CASE_PUBLISHED",
|
||||
title: "Redis Adapter 책임 경계 Case를 게시했습니다",
|
||||
summary: "만료 정책과 Redis 명령 실행 책임을 분리해 Adapter 교체 범위를 고정했습니다.",
|
||||
path: "/cases/redis-adapter-ttl-boundary",
|
||||
@@ -806,7 +827,7 @@ export const projects: ReadonlyArray<Project> = [
|
||||
id: "state-nonce-reference",
|
||||
date: "2026.08.09",
|
||||
dateTime: "2026-08-09T21:20:00+09:00",
|
||||
type: "PUBLICATION",
|
||||
type: "REFERENCE_PUBLISHED",
|
||||
title: "state와 nonce의 경계 Reference를 게시했습니다",
|
||||
summary: "요청 위조 방지와 ID Token 재사용 방지를 서로 다른 검증값으로 정리했습니다.",
|
||||
path: "/references/state-and-nonce-boundary",
|
||||
@@ -816,7 +837,7 @@ export const projects: ReadonlyArray<Project> = [
|
||||
id: "edge-trust-boundary",
|
||||
date: "2026.08.08",
|
||||
dateTime: "2026-08-08T19:05:00+09:00",
|
||||
type: "QUESTION",
|
||||
type: "QUESTION_OPENED",
|
||||
title: "oauth2-proxy 뒤에서 토큰을 다시 검증할 것인가",
|
||||
summary: "Edge 인증 이후 Spring이 신뢰할 경계를 OpenQuestion으로 분리했습니다.",
|
||||
path: "/projects/auth-lab/activity#edge-trust-boundary",
|
||||
@@ -862,7 +883,7 @@ export const releases: ReadonlyArray<Release> = [
|
||||
|
||||
export const profile: Profile = {
|
||||
name: "동현",
|
||||
introduction: "문제를 재현하고 검증해 실제 운영에 적용할 수 있는 형태로 정리합니다.",
|
||||
introduction: "문제를 한 편의 글로 끝내지 않고, 질문에서 검증과 결정까지 이어서 기록합니다.",
|
||||
principles: [
|
||||
{
|
||||
title: "확인된 사실과 남아 있는 가정",
|
||||
|
||||
@@ -215,7 +215,8 @@ export function getLatestEntries(): LatestRecordEntry[] {
|
||||
const activities = projects.flatMap((project) =>
|
||||
project.activity.map((activity) => {
|
||||
const record = recordByPath.get(activity.recordPath ?? activity.path);
|
||||
const published = activity.type === "PUBLICATION" && record;
|
||||
// 기록을 공개한 활동인가. 종류 이름이 아니라 접미사로 가른다 — 종류가 늘어도 그대로다.
|
||||
const published = activity.type.endsWith("_PUBLISHED") && record;
|
||||
return {
|
||||
id: activity.id,
|
||||
entryType: (published ? record.kind : "PROJECT_ACTIVITY") as LatestRecordEntry["entryType"],
|
||||
|
||||
@@ -178,11 +178,32 @@ export type ProjectDecision = {
|
||||
evidence: ReadonlyArray<{ title: string; path: string }>;
|
||||
};
|
||||
|
||||
/**
|
||||
* 활동의 종류. 데이터베이스 제약(`project_activity_activity_type_check`)이 허용하는 값과 같다.
|
||||
*
|
||||
* <p>오래 `"PUBLICATION" | "PROJECT UPDATE" | "QUESTION"` 셋으로 적혀 있었는데 서버가 그중
|
||||
* 무엇도 보내지 않았다 — 실제로 오는 값은 `CONCEPT_PUBLISHED` 같은 것이다. 매퍼가 단언으로
|
||||
* 통과시키고 화면이 그대로 찍어서, 방문자는 활동 목록에서 데이터베이스 상수를 읽고 있었다.
|
||||
*/
|
||||
export type ProjectActivityType =
|
||||
| "PHASE_CHANGED"
|
||||
| "QUESTION_OPENED"
|
||||
| "QUESTION_RESOLVED"
|
||||
| "DECISION_ACCEPTED"
|
||||
| "CASE_PUBLISHED"
|
||||
| "REFERENCE_PUBLISHED"
|
||||
| "CONCEPT_PUBLISHED"
|
||||
| "SETUP_PUBLISHED"
|
||||
| "MILESTONE_REACHED"
|
||||
| "PROJECT_PAUSED"
|
||||
| "PROJECT_RESUMED";
|
||||
|
||||
export type ProjectActivity = {
|
||||
id: string;
|
||||
date: string;
|
||||
dateTime: string;
|
||||
type: "PUBLICATION" | "PROJECT UPDATE" | "QUESTION";
|
||||
/** 서버가 모르는 값을 보낼 수 있으므로 화면은 늘 알 수 없는 경우를 다뤄야 한다. */
|
||||
type: ProjectActivityType | (string & {});
|
||||
title: string;
|
||||
summary: string;
|
||||
path: string;
|
||||
|
||||
@@ -1,6 +1,12 @@
|
||||
export const publicSiteConfig = Object.freeze({
|
||||
brandTitle: "TechLog",
|
||||
identityStatement: "문제를 재현하고 검증해 실제 운영에 적용할 수 있는 형태로 정리합니다.",
|
||||
/*
|
||||
이 한 줄이 사이트의 사용법을 말해야 한다. 오래 "문제를 재현하고 검증해 정리합니다" 였는데,
|
||||
그것은 글 쓰는 태도이지 이 사이트를 어떻게 읽는지가 아니다 — 기록이 한 편으로 끝나지 않고
|
||||
질문에서 검증과 결정까지 이어진다는 것이 이 사이트의 모양이다.
|
||||
*/
|
||||
identityStatement:
|
||||
"문제를 한 편의 글로 끝내지 않고, 질문에서 검증과 결정까지 이어서 기록합니다.",
|
||||
operator: "동현",
|
||||
contactLabel: "프로필",
|
||||
contactPath: "/profile",
|
||||
|
||||
@@ -0,0 +1,67 @@
|
||||
import { Link } from "react-router-dom";
|
||||
|
||||
import type { LatestEntry } from "./latest-index.tsx";
|
||||
|
||||
/** 한 줄에 펴 두는 기록 수. 넘으면 길이 아니라 또 하나의 목록이 된다. */
|
||||
const PATH_SIZE = 4;
|
||||
|
||||
/**
|
||||
* 이 사이트를 어떻게 쓰는지를 실제 기록 하나로 가르친다.
|
||||
*
|
||||
* <p>홈의 첫 문장은 글 쓰는 태도를 말했다 — "문제를 재현하고 검증해 정리합니다". 맞는 말이지만
|
||||
* 처음 온 사람이 알아야 하는 것은 태도가 아니라 <em>길</em>이다. 이 사이트에서 기록은 한 편으로
|
||||
* 끝나지 않고 프로젝트 안의 주제에 속하고, 주제 안에서 서로 이어진다. 그 구조를 설명하는 문장보다
|
||||
* 실제 사슬 하나를 보여 주는 편이 빠르다.
|
||||
*
|
||||
* <p>고르는 방법은 "최근 기록이 가장 많이 모인 주제"다. 손으로 고른 예시를 코드에 적어 두면 그
|
||||
* 기록을 지우는 순간 홈이 죽은 링크를 가리킨다 — 이 저장소에서 주제 셋을 코드에 적어 두었다가
|
||||
* 같은 일을 겪었다.
|
||||
*
|
||||
* <p>이을 것이 없으면 그리지 않는다. 한 편짜리 길은 길이 아니다.
|
||||
*/
|
||||
export function HomeInvestigationPath({ entries }: { entries: ReadonlyArray<LatestEntry> }) {
|
||||
/* 기록만 센다. 프로젝트 활동과 릴리스는 기록이 아니라 일어난 일이라 사슬의 마디가 아니다. */
|
||||
const records = entries.filter((entry) => entry.typeState !== undefined && entry.topic);
|
||||
|
||||
const byTopic = new Map<string, LatestEntry[]>();
|
||||
for (const record of records) {
|
||||
const bucket = byTopic.get(record.topic);
|
||||
if (bucket) bucket.push(record);
|
||||
else byTopic.set(record.topic, [record]);
|
||||
}
|
||||
|
||||
let lead: LatestEntry[] = [];
|
||||
for (const bucket of byTopic.values()) {
|
||||
if (bucket.length > lead.length) lead = bucket;
|
||||
}
|
||||
if (lead.length < 2) return null;
|
||||
|
||||
const head = lead[0]!;
|
||||
const path = lead.slice(0, PATH_SIZE);
|
||||
|
||||
return (
|
||||
<section className="shell home-path" aria-labelledby="home-path-title">
|
||||
<p className="section-kicker" id="home-path-title">
|
||||
이렇게 이어집니다
|
||||
</p>
|
||||
<ol className="home-path-trail">
|
||||
<li>
|
||||
<span>프로젝트</span>
|
||||
<strong>{head.project}</strong>
|
||||
</li>
|
||||
<li>
|
||||
<span>주제</span>
|
||||
<strong>{head.topic}</strong>
|
||||
</li>
|
||||
</ol>
|
||||
<ul className="home-path-records">
|
||||
{path.map((record) => (
|
||||
<li key={record.path}>
|
||||
<span>{record.typeLabel}</span>
|
||||
<Link to={record.path}>{record.title}</Link>
|
||||
</li>
|
||||
))}
|
||||
</ul>
|
||||
</section>
|
||||
);
|
||||
}
|
||||
@@ -10,6 +10,7 @@ import { useRouteInput } from "../../../../../presentation/routes/route-input.ts
|
||||
import { usePublicContent } from "../use-public-content.tsx";
|
||||
import { FatalErrorState } from "../components/fatal-error-state.tsx";
|
||||
import { HomeFocus } from "../components/home-focus.tsx";
|
||||
import { HomeInvestigationPath } from "../components/home-investigation-path.tsx";
|
||||
import { HomeTopicTabs } from "../components/home-topic-tabs.tsx";
|
||||
import {
|
||||
LatestIndex,
|
||||
@@ -203,6 +204,12 @@ export function HomePage() {
|
||||
<p className="identity-statement">{publicSiteConfig.identityStatement}</p>
|
||||
</section>
|
||||
|
||||
{/*
|
||||
첫 문장은 태도를 말한다. 처음 온 사람이 알아야 하는 것은 태도가 아니라 길이므로, 실제
|
||||
기록 하나로 그 길을 보여 준다 — 설명보다 사슬 하나가 빠르다.
|
||||
*/}
|
||||
<HomeInvestigationPath entries={latestEntries} />
|
||||
|
||||
{initialKey ? (
|
||||
<section className="shell focus-section" aria-labelledby="focus-label">
|
||||
<p className="section-kicker" id="focus-label">
|
||||
|
||||
@@ -2,6 +2,10 @@ import {
|
||||
RegisteredNotFoundRoute,
|
||||
useRouteInput,
|
||||
} from "../../../../../presentation/routes/route-input.tsx";
|
||||
import { resolvesToPublicRoute } from "../../../domain/navigation/public-path.ts";
|
||||
import { Link } from "react-router-dom";
|
||||
|
||||
import { projectActivityLabel } from "../../shared/project-activity-labels.ts";
|
||||
import { ProjectPageHeader } from "../components/project-page-header.tsx";
|
||||
import { usePublicContent } from "../use-public-content.tsx";
|
||||
|
||||
@@ -20,11 +24,11 @@ export function ProjectActivityPage() {
|
||||
if (!project) return <RegisteredNotFoundRoute />;
|
||||
|
||||
/*
|
||||
활동은 로그다 — 언제 무엇을 올렸는지만 적는다.
|
||||
활동은 이 프로젝트에서 언제 무슨 일이 있었는지를 적는다.
|
||||
|
||||
예전에는 각 줄에 그 기록으로 가는 링크가 있었다. 그러면 같은 글에 닿는 길이 둘이 되고,
|
||||
읽는 사람은 "기록"과 "활동"이 어떻게 다른지 매번 다시 판단해야 한다. 글을 읽는 자리는
|
||||
기록 화면 하나로 둔다.
|
||||
종류 자리에 `CONCEPT_PUBLISHED` 가 그대로 찍히고 있었다. 그것은 데이터베이스 제약이 허용하는
|
||||
값이지 방문자에게 할 말이 아니다 — 감사 로그처럼 읽히고, 정작 무슨 일이 있었는지는 알 수
|
||||
없었다. 사람이 읽는 문장으로 바꾸고, 그 일이 만든 기록으로 갈 길을 한 줄 붙인다.
|
||||
*/
|
||||
return (
|
||||
<main id="main-content" className="shell project-page">
|
||||
@@ -37,10 +41,19 @@ export function ProjectActivityPage() {
|
||||
<li key={item.id}>
|
||||
<article id={item.id}>
|
||||
<div>
|
||||
<span>{item.type}</span>
|
||||
<span>{projectActivityLabel(item.type)}</span>
|
||||
<time dateTime={item.dateTime}>{item.date}</time>
|
||||
</div>
|
||||
<h2>{item.title}</h2>
|
||||
{/*
|
||||
그 일이 만든 기록. 열리지 않는 주소는 줄로 그리지 않는다 — 활동의 `path` 는
|
||||
이 목록 자신을 가리키는 앵커일 수도 있다.
|
||||
*/}
|
||||
{item.recordPath && resolvesToPublicRoute(item.recordPath) ? (
|
||||
<p className="project-activity-record">
|
||||
<Link to={item.recordPath}>{item.summary || "이 활동이 남긴 기록"}</Link>
|
||||
</p>
|
||||
) : null}
|
||||
</article>
|
||||
</li>
|
||||
))}
|
||||
|
||||
@@ -0,0 +1,42 @@
|
||||
import type { ProjectActivityType } from "../../application/ports/public-content-queries.ts";
|
||||
|
||||
/**
|
||||
* 활동 한 줄을 사람이 읽는 문장으로 바꾼다.
|
||||
*
|
||||
* <p>공개 화면이 `CONCEPT_PUBLISHED` 를 그대로 찍고 있었다. 그것은 데이터베이스의 제약
|
||||
* (`project_activity_activity_type_check`)이 허용하는 값이지 방문자에게 할 말이 아니다 — 감사
|
||||
* 로그처럼 읽히고, 이 프로젝트에서 무슨 일이 있었는지는 여전히 알 수 없다.
|
||||
*
|
||||
* <p>`Record<ProjectActivityType, string>` 이라 종류가 늘면 컴파일러가 빈 자리를 잡는다. 빠뜨리면
|
||||
* 그 활동만 다시 코드로 나오고, 그 줄은 화면에서 이상해 보이지 않는다 — 다른 줄과 같은 모양으로
|
||||
* 앉아 있기 때문이다.
|
||||
*/
|
||||
export const PROJECT_ACTIVITY_LABELS: Record<ProjectActivityType, string> = {
|
||||
PHASE_CHANGED: "프로젝트 단계를 옮겼습니다",
|
||||
QUESTION_OPENED: "열린 질문을 남겼습니다",
|
||||
QUESTION_RESOLVED: "열린 질문에 답했습니다",
|
||||
DECISION_ACCEPTED: "설계 결정을 확정했습니다",
|
||||
CASE_PUBLISHED: "검증 기록을 공개했습니다",
|
||||
REFERENCE_PUBLISHED: "적용 기준을 공개했습니다",
|
||||
CONCEPT_PUBLISHED: "동작 원리를 공개했습니다",
|
||||
SETUP_PUBLISHED: "환경 구성을 공개했습니다",
|
||||
MILESTONE_REACHED: "중간 목표에 도달했습니다",
|
||||
PROJECT_PAUSED: "프로젝트를 잠시 멈췄습니다",
|
||||
PROJECT_RESUMED: "프로젝트를 다시 시작했습니다",
|
||||
};
|
||||
|
||||
const KNOWN = new Set(Object.keys(PROJECT_ACTIVITY_LABELS));
|
||||
|
||||
export function isProjectActivityType(value: string): value is ProjectActivityType {
|
||||
return KNOWN.has(value);
|
||||
}
|
||||
|
||||
/**
|
||||
* 모르는 값이 오면 원문을 그대로 보여 준다.
|
||||
*
|
||||
* <p>빈 칸으로 두거나 「기타」로 뭉개면 서버가 새 종류를 내보내기 시작한 사실이 화면에서 사라진다.
|
||||
* 보기 나쁜 편이 낫다 — 보기 나쁘면 고치게 된다.
|
||||
*/
|
||||
export function projectActivityLabel(type: string): string {
|
||||
return isProjectActivityType(type) ? PROJECT_ACTIVITY_LABELS[type] : type;
|
||||
}
|
||||
@@ -3585,3 +3585,95 @@ textarea.studio-control { min-height: 118px; resize: vertical; line-height: 1.65
|
||||
.project-empty-decisions ul a:hover {
|
||||
color: var(--signal);
|
||||
}
|
||||
|
||||
/* 활동이 남긴 기록으로 가는 줄 */
|
||||
|
||||
.project-activity-record {
|
||||
margin: 9px 0 0;
|
||||
}
|
||||
|
||||
.project-activity-record a {
|
||||
color: var(--muted);
|
||||
font-size: 15px;
|
||||
line-height: 1.6;
|
||||
}
|
||||
|
||||
.project-activity-record a::before {
|
||||
content: "→ ";
|
||||
color: var(--line-strong);
|
||||
}
|
||||
|
||||
.project-activity-record a:hover {
|
||||
color: var(--signal);
|
||||
}
|
||||
|
||||
/* 홈 — 이렇게 이어집니다 */
|
||||
|
||||
.home-path {
|
||||
padding-block: 4px 44px;
|
||||
}
|
||||
|
||||
.home-path-trail {
|
||||
display: flex;
|
||||
flex-wrap: wrap;
|
||||
gap: 8px 28px;
|
||||
margin: 15px 0 0;
|
||||
padding: 0;
|
||||
list-style: none;
|
||||
}
|
||||
|
||||
.home-path-trail li {
|
||||
display: flex;
|
||||
gap: 9px;
|
||||
align-items: baseline;
|
||||
}
|
||||
|
||||
.home-path-trail span {
|
||||
color: var(--faint);
|
||||
font-size: 12px;
|
||||
font-weight: 620;
|
||||
}
|
||||
|
||||
.home-path-trail strong {
|
||||
color: var(--ink);
|
||||
font-size: 16px;
|
||||
font-weight: 640;
|
||||
}
|
||||
|
||||
.home-path-records {
|
||||
margin: 16px 0 0;
|
||||
padding: 0 0 0 17px;
|
||||
border-left: 2px solid var(--line-strong);
|
||||
list-style: none;
|
||||
}
|
||||
|
||||
.home-path-records li {
|
||||
display: grid;
|
||||
grid-template-columns: 96px minmax(0, 1fr);
|
||||
gap: 16px;
|
||||
padding-block: 7px;
|
||||
}
|
||||
|
||||
.home-path-records span {
|
||||
color: var(--faint);
|
||||
font-size: 12px;
|
||||
font-weight: 620;
|
||||
line-height: 1.7;
|
||||
}
|
||||
|
||||
.home-path-records a {
|
||||
color: var(--ink-soft);
|
||||
font-size: 16px;
|
||||
line-height: 1.55;
|
||||
}
|
||||
|
||||
.home-path-records a:hover {
|
||||
color: var(--signal);
|
||||
}
|
||||
|
||||
@media (max-width: 767px) {
|
||||
.home-path-records li {
|
||||
grid-template-columns: minmax(0, 1fr);
|
||||
gap: 2px;
|
||||
}
|
||||
}
|
||||
|
||||
@@ -89,7 +89,7 @@ describe("production runtime application tree", () => {
|
||||
).toBeVisible();
|
||||
expect(
|
||||
await screen.findAllByText(
|
||||
"문제를 재현하고 검증해 실제 운영에 적용할 수 있는 형태로 정리합니다.",
|
||||
"문제를 한 편의 글로 끝내지 않고, 질문에서 검증과 결정까지 이어서 기록합니다.",
|
||||
),
|
||||
).toHaveLength(2);
|
||||
expect(fetcher).toHaveBeenCalledTimes(2);
|
||||
|
||||
@@ -139,7 +139,7 @@ describe("TechLog home discovery", () => {
|
||||
expect(screen.getByRole("heading", { level: 1, name: "TechLog" })).toBeVisible();
|
||||
expect(
|
||||
within(screen.getByRole("main")).getByText(
|
||||
"문제를 재현하고 검증해 실제 운영에 적용할 수 있는 형태로 정리합니다.",
|
||||
"문제를 한 편의 글로 끝내지 않고, 질문에서 검증과 결정까지 이어서 기록합니다.",
|
||||
),
|
||||
).toHaveClass("identity-statement");
|
||||
expect(screen.getByText("지금 집중하는 것")).toHaveClass("section-kicker");
|
||||
|
||||
@@ -313,11 +313,14 @@ describe("TechLog project screens", () => {
|
||||
});
|
||||
|
||||
/*
|
||||
활동은 로그다 — 언제 무엇을 올렸는지만 적는다. 각 줄에 그 기록으로 가는 링크가 있으면 같은
|
||||
글에 닿는 길이 둘이 되고, 읽는 사람은 "기록"과 "활동"이 어떻게 다른지 매번 다시 판단해야 한다.
|
||||
글을 읽는 자리는 기록 화면 하나로 둔다.
|
||||
활동은 이 프로젝트에서 언제 무슨 일이 있었는지를 적는다.
|
||||
|
||||
한동안 이 줄들에는 링크를 두지 않았다 — 같은 글에 닿는 길이 둘이 되면 "기록"과 "활동"이
|
||||
어떻게 다른지 매번 판단해야 한다는 이유였다. 그러나 종류 자리에 `CONCEPT_PUBLISHED` 라는
|
||||
데이터베이스 상수가 찍히고 있어서, 링크 없는 그 줄은 무슨 일이 있었는지도 그 일이 무엇을
|
||||
남겼는지도 말하지 못했다. 사람이 읽는 문장으로 바꾸고, 그 일이 남긴 기록으로 갈 길을 연다.
|
||||
*/
|
||||
it("keeps project activity ordered and leaves reading to the records screen", async () => {
|
||||
it("keeps project activity ordered and names what happened in plain words", async () => {
|
||||
const { container } = await renderPublicRoute(
|
||||
"TECH_LOG_PROJECT_ACTIVITY",
|
||||
"/projects/backend-skeleton/activity",
|
||||
@@ -331,7 +334,14 @@ describe("TechLog project screens", () => {
|
||||
"storage-contract",
|
||||
"redis-case-published",
|
||||
]);
|
||||
expect(items.flatMap((item) => Array.from(item.querySelectorAll("a")))).toEqual([]);
|
||||
// 종류는 사람이 읽는 문장이어야 한다. `CASE_PUBLISHED` 같은 값이 그대로 나오면 안 된다.
|
||||
const kinds = items.map((item) => item.querySelector("div > span")?.textContent ?? "");
|
||||
expect(kinds).toEqual([
|
||||
"검증 기록을 공개했습니다",
|
||||
"중간 목표에 도달했습니다",
|
||||
"검증 기록을 공개했습니다",
|
||||
]);
|
||||
expect(kinds.some((label) => /_[A-Z]/u.test(label))).toBe(false);
|
||||
});
|
||||
});
|
||||
|
||||
@@ -394,7 +404,7 @@ describe("TechLog release and profile screens", () => {
|
||||
|
||||
expect(within(main).getByRole("heading", { level: 1, name: "동현" })).toBeVisible();
|
||||
expect(
|
||||
within(main).getByText("문제를 재현하고 검증해 실제 운영에 적용할 수 있는 형태로 정리합니다."),
|
||||
within(main).getByText("문제를 한 편의 글로 끝내지 않고, 질문에서 검증과 결정까지 이어서 기록합니다."),
|
||||
).toBeVisible();
|
||||
expect(
|
||||
Array.from(container.querySelectorAll(".profile-principles h3"), (heading) =>
|
||||
|
||||
@@ -125,7 +125,7 @@ describe("TechLog Public shell", () => {
|
||||
}
|
||||
expect(screen.getByText("동현")).toHaveClass("footer-name");
|
||||
expect(
|
||||
screen.getByText("문제를 재현하고 검증해 실제 운영에 적용할 수 있는 형태로 정리합니다."),
|
||||
screen.getByText("문제를 한 편의 글로 끝내지 않고, 질문에서 검증과 결정까지 이어서 기록합니다."),
|
||||
).toBeVisible();
|
||||
expect(view.container.querySelector(".app-shell")).toBeNull();
|
||||
});
|
||||
|
||||
@@ -38,6 +38,9 @@ const SETTLED = new Set([
|
||||
// 맥락 덩어리의 두 목록은 한 모양의 항목만 담는다 — 프로젝트/주제 한 쌍, 기록 한 줄.
|
||||
".context-trail li",
|
||||
".context-siblings li",
|
||||
".home-path-trail li",
|
||||
".home-path-records li",
|
||||
".investigation-records li",
|
||||
".studio-warning-check span",
|
||||
]);
|
||||
|
||||
|
||||
Reference in New Issue
Block a user