fix: 관계의 묶음 이름과 작성자가 쓴 문장을 갈라 놓는다
관계 한 줄에 세 가지가 뭉쳐 있었다. 대상이 어떤 종류인지, 작성자가 왜 걸었는지, 대상이 무엇인지 — 셋 다 `reason` 한 칸을 지나느라 경로마다 다른 것이 같은 자리에 나왔다. 렌더 모델 경로에서는 작성자의 문장이 묶음 이름 자리에 눌려 한 줄짜리 라벨인 척했고, 공개 조회 경로에서는 묶음 이름이 그 자리를 차지하고 작성자의 문장은 아예 버려졌다. 「다음에 무엇을 읽을지」의 답이 그 문장인데 공개 화면에 한 번도 나오지 않았다. 이제 셋이 각자의 칸을 갖는다. `label` 은 대상의 종류, `note` 는 작성자가 쓴 문장, `summary` 는 대상의 요약이다. 설명 자리에는 문장이 있으면 문장을, 없으면 요약을 보인다 — 요약은 대상을 설명하고 문장은 왜 지금 이것을 읽어야 하는지를 설명한다. 공개 주소로 종류를 되짚던 삼항 사슬도 표로 바꾼다. `/concepts/` 가 어디에도 없어서 개념으로 가는 관계가 전부 `PROJECT` 로 떨어지고 있었다 — 손으로 나열한 목록에 새 종류를 빠뜨리는 일이 이 저장소에서만 다섯 번째다. 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
af5a6bbf23
commit
618a228eff
@@ -11,8 +11,20 @@ export type PublicRelation = {
|
||||
summary: string;
|
||||
title: string;
|
||||
path: string;
|
||||
/**
|
||||
* 작성자가 관계마다 남긴 이유. 아래 정적 자료에는 아무도 쓴 적이 없으므로 여기서는 빈 값이고,
|
||||
* 내보낼 때 {@link publicRecords} 가 한 번에 채운다. 목록마다 `note: ""` 를 손으로 적게 하면
|
||||
* 언젠가 하나를 빠뜨린다 — 이 저장소에서 이미 다섯 번 그랬다.
|
||||
*/
|
||||
note: string;
|
||||
/** 낮을수록 먼저. */
|
||||
priority: number;
|
||||
};
|
||||
|
||||
/** 정적 자료가 실제로 적는 모양. 작성자가 남긴 이유가 없으므로 두 칸이 선택이다. */
|
||||
type StaticRelation = Omit<PublicRelation, "note" | "priority"> &
|
||||
Partial<Pick<PublicRelation, "note" | "priority">>;
|
||||
|
||||
export type RecordSection = {
|
||||
id: string;
|
||||
title: string;
|
||||
@@ -185,7 +197,27 @@ export type HomeFocusItem = {
|
||||
targetPath: string;
|
||||
};
|
||||
|
||||
export const publicRecords: ReadonlyArray<PublicRecord> = [
|
||||
/** 아래 목록이 적는 모양. 관계의 두 칸만 느슨하다. 유니온마다 나눠 적용한다. */
|
||||
type Draft<T> = T extends unknown
|
||||
? Omit<T, "relations"> & { relations: ReadonlyArray<StaticRelation> }
|
||||
: never;
|
||||
|
||||
/**
|
||||
* 관계의 빈 칸을 채운다. 정적 자료가 적는 모양과 포트가 요구하는 모양이 갈리는 지점이 여기
|
||||
* 하나뿐이도록 한다.
|
||||
*/
|
||||
function withRelationDefaults(record: Draft<PublicRecord>): PublicRecord {
|
||||
return {
|
||||
...record,
|
||||
relations: record.relations.map((relation) => ({
|
||||
...relation,
|
||||
note: relation.note ?? "",
|
||||
priority: relation.priority ?? 0,
|
||||
})),
|
||||
} as PublicRecord;
|
||||
}
|
||||
|
||||
const staticPublicRecords: ReadonlyArray<Draft<PublicRecord>> = [
|
||||
{
|
||||
kind: "CONCEPT",
|
||||
slug: "kubernetes-scheduling",
|
||||
@@ -607,6 +639,9 @@ export const publicRecords: ReadonlyArray<PublicRecord> = [
|
||||
},
|
||||
];
|
||||
|
||||
export const publicRecords: ReadonlyArray<PublicRecord> =
|
||||
staticPublicRecords.map(withRelationDefaults);
|
||||
|
||||
export const projects: ReadonlyArray<Project> = [
|
||||
{
|
||||
slug: "backend-skeleton",
|
||||
|
||||
Reference in New Issue
Block a user