fix: UX 리뷰의 남은 항목을 반영한다

주제 탭 (H1 연장). 홈 탭에 주제를 전부 세우고 목록 아래 「다른 주제 N개 보기」
줄을 없앴다. 축이 둘 이상인 주제만 탭이 되던 규칙 때문에 여섯 중 둘만 올라오고
나머지 넷은 비교표를 다 읽어야 만나는 작은 글씨 한 줄로 갔다. 축은 주제가
자라면서 생기는 것이지 기록이 없다는 뜻이 아니다. 축이 없는 주제는 그 주제의
기록을 세우고, 기록이 없으면 그렇다고 분명히 말한다.

탭 하나가 패널 하나를 가리키게 고쳤다. 탭 전부가 같은 패널을 가리키면 고르지
않은 탭이 "내가 저 패널을 연다" 고 말하면서 패널은 다른 탭의 이름을 달게 된다.

H1. `/studio/documents` 와 `/studio/publications` 의 검색·필터·쪽수를 주소에
담는다. 담지 않던 동안 3쪽에서 문서를 열고 뒤로 오면 1쪽이었고 필터도 사라졌다.
공개 `/search` 는 처음부터 담고 있었다.

H4. 문서 종류 이름을 `document-kind-labels.ts` 하나로 모았다. 세 곳에 흩어져
있어서 같은 CASE 가 목록에서는 「검증 기록」, 새 문서에서는 「Case」, 검색에서는
또 다른 이름이었다.

H5. `project.stage` 가 화면에 `DESIGN` 으로 그대로 새어 나왔다. 같은 프로젝트를
Studio 는 「설계」로 불렀다 — 두 화면이 다른 말을 했다.

H6. 값이 없는데 라벨만 그려지던 자리를 막았다. 네 프로젝트 중 셋이 「현재 목표」
라벨만 있고 값이 비어 있었다.

M2. 대시보드의 숫자를 목록으로 가는 길로 만들고, 할 일이 없는 구역은 그리지
않는다. 공개 홈 설정 폼은 작업 목록 한가운데에서 뒤로 옮겼다.

M3. 작업본 목록에 프로젝트 필터와 정렬을 더했다. 공개 `/explore` 는 독자에게
셋을 주는데 61개를 관리하는 작성자에게는 둘뿐이었다.

M4. 게시 기록의 필터 제출 방식을 작업본 목록에 맞췄다 — 셀렉트는 즉시, 검색만
버튼이다.

M5. MOCK 시절 문구("세션이 끝나면 사라집니다")를 지웠다. 실서버에는 작업본이
남는다.

M7. `aria-current="page"` 가 현재 페이지가 아닌 링크에 붙었다. 정확히 일치할
때만 붙게 하고 구역 강조는 따로 계산한다.

M8. 홈의 첫 화면을 비교표로 바꿨다. 다른 데서 얻을 수 없는 유일한 것이 y≈600 에
묻혀 있었다.

`ListDocumentsQuery.kind` 가 손으로 적은 union 이라 개념과 환경 구성이 빠져
있었다 — 그 둘은 작업본 목록에서 걸러 볼 수가 없었다. 계약 타입으로 바꿨다.

M9 는 고치지 않는다. 「문제·결론이 11px 회색」이라는 지적이 지금 빌드에서
재현되지 않는다 — 실측은 17px `rgb(63,66,73)` 이고 본문이 18px 같은 색이다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PTnWufiY9ATv57egkKKVAV
This commit is contained in:
DongHyeonka
2026-09-09 17:15:04 +09:00
co-authored by Claude Opus 5
parent 0d4d1e5c0c
commit b9e29369ee
24 changed files with 489 additions and 161 deletions
+3 -1
View File
@@ -14,7 +14,9 @@ export type RouteCodecId =
| "TechLogExploreSearch" | "TechLogExploreSearch"
| "TechLogExploreKindSearch" | "TechLogExploreKindSearch"
| "TechLogSearchQuery" | "TechLogSearchQuery"
| "TechLogCaseStateSearch"; | "TechLogCaseStateSearch"
| "TechLogStudioDocumentsSearch"
| "TechLogStudioPublicationsSearch";
export type RouteRuntimeDefinition = Readonly<{ export type RouteRuntimeDefinition = Readonly<{
routeId: string; routeId: string;
moduleId: string; moduleId: string;
@@ -1,5 +1,6 @@
import type { import type {
CatalogPage, CreateDocumentInput, CreatePreviewCommand, DocumentPage, CatalogPage, CreateDocumentInput, CreatePreviewCommand, DocumentPage,
RecordKind,
PublicationPage, PublicationSnapshot, PublicPreview, PublishDocumentCommand, PublicationPage, PublicationSnapshot, PublicPreview, PublishDocumentCommand,
PreviewDetail, PublishResult, SaveDocumentCommand, StudioDashboard, UnpublishCommand, PreviewDetail, PublishResult, SaveDocumentCommand, StudioDashboard, UnpublishCommand,
ValidationReport, ValidateDocumentCommand, WorkingCopy, WorkingCopyDetail, ValidationReport, ValidateDocumentCommand, WorkingCopy, WorkingCopyDetail,
@@ -8,7 +9,12 @@ import type {
export type RequestOptions = { signal?: AbortSignal }; export type RequestOptions = { signal?: AbortSignal };
export type IdempotentOptions = RequestOptions & { idempotencyKey: string }; export type IdempotentOptions = RequestOptions & { idempotencyKey: string };
export type ListDocumentsQuery = { export type ListDocumentsQuery = {
q?: string; kind?: "CASE" | "REFERENCE" | "QUESTION" | "PROJECT_DECISION"; /*
종류는 계약의 `RecordKind` 를 그대로 쓴다. 여기 손으로 적어 두었던 동안 개념과 환경 구성이
빠져 있었고, 작업본 목록의 종류 필터는 그 둘을 아예 고를 수 없었다 — 손으로 나열한 목록에
새 종류를 빠뜨리는 일이 이 저장소에서 반복됐다.
*/
q?: string; kind?: RecordKind;
publicationStatus?: "NEVER_PUBLISHED" | "PUBLISHED" | "UNPUBLISHED"; publicationStatus?: "NEVER_PUBLISHED" | "PUBLISHED" | "UNPUBLISHED";
nextAction?: "CONTINUE_EDITING" | "VALIDATE" | "FIX_VALIDATION" | "CREATE_PREVIEW" | "PUBLISH" | "NONE"; nextAction?: "CONTINUE_EDITING" | "VALIDATE" | "FIX_VALIDATION" | "CREATE_PREVIEW" | "PUBLISH" | "NONE";
projectId?: string; sort?: "UPDATED_DESC" | "UPDATED_ASC" | "TITLE_ASC"; projectId?: string; sort?: "UPDATED_DESC" | "UPDATED_ASC" | "TITLE_ASC";
@@ -48,13 +48,13 @@ const TECH_LOG_ROUTE_SPECS = [
defineSpec({ routeId: "TECH_LOG_PROFILE", path: "/profile", layoutGroup: "PUBLIC", paramsSchema: null, searchSchema: null, title: "프로필", navigationLabel: "프로필", navigationOrder: 40 }), defineSpec({ routeId: "TECH_LOG_PROFILE", path: "/profile", layoutGroup: "PUBLIC", paramsSchema: null, searchSchema: null, title: "프로필", navigationLabel: "프로필", navigationOrder: 40 }),
defineSpec({ routeId: "TECH_LOG_SEARCH", path: "/search", layoutGroup: "PUBLIC", paramsSchema: null, searchSchema: "TechLogSearchQuery", title: "검색", navigationLabel: null, navigationOrder: null }), defineSpec({ routeId: "TECH_LOG_SEARCH", path: "/search", layoutGroup: "PUBLIC", paramsSchema: null, searchSchema: "TechLogSearchQuery", title: "검색", navigationLabel: null, navigationOrder: null }),
defineSpec({ routeId: "TECH_LOG_STUDIO_HOME", path: "/studio", layoutGroup: "STUDIO", paramsSchema: null, searchSchema: null, title: "TechLog Studio", navigationLabel: null, navigationOrder: null }), defineSpec({ routeId: "TECH_LOG_STUDIO_HOME", path: "/studio", layoutGroup: "STUDIO", paramsSchema: null, searchSchema: null, title: "TechLog Studio", navigationLabel: null, navigationOrder: null }),
defineSpec({ routeId: "TECH_LOG_STUDIO_DOCUMENTS", path: "/studio/documents", layoutGroup: "STUDIO", paramsSchema: null, searchSchema: null, title: "작업본", navigationLabel: "작업본", navigationOrder: 10 }), defineSpec({ routeId: "TECH_LOG_STUDIO_DOCUMENTS", path: "/studio/documents", layoutGroup: "STUDIO", paramsSchema: null, searchSchema: "TechLogStudioDocumentsSearch", title: "작업본", navigationLabel: "작업본", navigationOrder: 10 }),
defineSpec({ routeId: "TECH_LOG_STUDIO_DOCUMENT_NEW", path: "/studio/documents/new", layoutGroup: "STUDIO", paramsSchema: null, searchSchema: null, title: "새 문서", navigationLabel: "새 문서", navigationOrder: 30 }), defineSpec({ routeId: "TECH_LOG_STUDIO_DOCUMENT_NEW", path: "/studio/documents/new", layoutGroup: "STUDIO", paramsSchema: null, searchSchema: null, title: "새 문서", navigationLabel: "새 문서", navigationOrder: 30 }),
defineSpec({ routeId: "TECH_LOG_STUDIO_DOCUMENT_EDIT", path: "/studio/documents/:id/edit", layoutGroup: "STUDIO", paramsSchema: "TechLogDocumentIdParams", searchSchema: null, title: "문서 편집", navigationLabel: null, navigationOrder: null }), defineSpec({ routeId: "TECH_LOG_STUDIO_DOCUMENT_EDIT", path: "/studio/documents/:id/edit", layoutGroup: "STUDIO", paramsSchema: "TechLogDocumentIdParams", searchSchema: null, title: "문서 편집", navigationLabel: null, navigationOrder: null }),
defineSpec({ routeId: "TECH_LOG_STUDIO_DOCUMENT_VALIDATION", path: "/studio/documents/:id/validation", layoutGroup: "STUDIO", paramsSchema: "TechLogDocumentIdParams", searchSchema: null, title: "문서 검증", navigationLabel: null, navigationOrder: null }), defineSpec({ routeId: "TECH_LOG_STUDIO_DOCUMENT_VALIDATION", path: "/studio/documents/:id/validation", layoutGroup: "STUDIO", paramsSchema: "TechLogDocumentIdParams", searchSchema: null, title: "문서 검증", navigationLabel: null, navigationOrder: null }),
defineSpec({ routeId: "TECH_LOG_STUDIO_DOCUMENT_PREVIEW", path: "/studio/documents/:id/preview", layoutGroup: "STUDIO", paramsSchema: "TechLogDocumentIdParams", searchSchema: null, title: "Public Preview", navigationLabel: null, navigationOrder: null }), defineSpec({ routeId: "TECH_LOG_STUDIO_DOCUMENT_PREVIEW", path: "/studio/documents/:id/preview", layoutGroup: "STUDIO", paramsSchema: "TechLogDocumentIdParams", searchSchema: null, title: "Public Preview", navigationLabel: null, navigationOrder: null }),
defineSpec({ routeId: "TECH_LOG_STUDIO_DOCUMENT_PUBLISH", path: "/studio/documents/:id/publish", layoutGroup: "STUDIO", paramsSchema: "TechLogDocumentIdParams", searchSchema: null, title: "게시", navigationLabel: null, navigationOrder: null }), defineSpec({ routeId: "TECH_LOG_STUDIO_DOCUMENT_PUBLISH", path: "/studio/documents/:id/publish", layoutGroup: "STUDIO", paramsSchema: "TechLogDocumentIdParams", searchSchema: null, title: "게시", navigationLabel: null, navigationOrder: null }),
defineSpec({ routeId: "TECH_LOG_STUDIO_PUBLICATIONS", path: "/studio/publications", layoutGroup: "STUDIO", paramsSchema: null, searchSchema: null, title: "게시 기록", navigationLabel: "게시 기록", navigationOrder: 20 }), defineSpec({ routeId: "TECH_LOG_STUDIO_PUBLICATIONS", path: "/studio/publications", layoutGroup: "STUDIO", paramsSchema: null, searchSchema: "TechLogStudioPublicationsSearch", title: "게시 기록", navigationLabel: "게시 기록", navigationOrder: 20 }),
defineSpec({ routeId: "TECH_LOG_STUDIO_PUBLICATION_PREVIEW", path: "/studio/publications/:publicationEventId/preview", layoutGroup: "STUDIO", paramsSchema: "TechLogPublicationEventIdParams", searchSchema: null, title: "게시 Snapshot", navigationLabel: null, navigationOrder: null }), defineSpec({ routeId: "TECH_LOG_STUDIO_PUBLICATION_PREVIEW", path: "/studio/publications/:publicationEventId/preview", layoutGroup: "STUDIO", paramsSchema: "TechLogPublicationEventIdParams", searchSchema: null, title: "게시 Snapshot", navigationLabel: null, navigationOrder: null }),
defineSpec({ routeId: "TECH_LOG_STUDIO_ASSETS", path: "/studio/assets", layoutGroup: "STUDIO", paramsSchema: null, searchSchema: null, title: "Asset", navigationLabel: "Asset", navigationOrder: 45 }), defineSpec({ routeId: "TECH_LOG_STUDIO_ASSETS", path: "/studio/assets", layoutGroup: "STUDIO", paramsSchema: null, searchSchema: null, title: "Asset", navigationLabel: "Asset", navigationOrder: 45 }),
defineSpec({ routeId: "TECH_LOG_STUDIO_TAXONOMY", path: "/studio/taxonomy", layoutGroup: "STUDIO", paramsSchema: null, searchSchema: null, title: "주제와 프로젝트", navigationLabel: "주제·프로젝트", navigationOrder: 40 }), defineSpec({ routeId: "TECH_LOG_STUDIO_TAXONOMY", path: "/studio/taxonomy", layoutGroup: "STUDIO", paramsSchema: null, searchSchema: null, title: "주제와 프로젝트", navigationLabel: "주제·프로젝트", navigationOrder: 40 }),
@@ -139,6 +139,16 @@ export const TECH_LOG_ROUTE_SCHEMA_REGISTRY = Object.freeze({
"route-search", "route-search",
"STRIP_UNKNOWN", "STRIP_UNKNOWN",
), ),
TechLogStudioDocumentsSearch: routeSchema(
"TechLogStudioDocumentsSearch",
"route-search",
"STRIP_UNKNOWN",
),
TechLogStudioPublicationsSearch: routeSchema(
"TechLogStudioPublicationsSearch",
"route-search",
"STRIP_UNKNOWN",
),
}); });
function chunkId(routeId: TechLogRouteId): string { function chunkId(routeId: TechLogRouteId): string {
@@ -77,7 +77,30 @@ export function HomeTopicTabs({
if (!active) return null; if (!active) return null;
const detail = details[active.slug]; const detail = details[active.slug];
const axisLabel = (detail?.variantLabel ?? active.variantLabel).trim(); /*
축을 쓰는 주제는 축끼리 견주고, 아직 쓰지 않는 주제는 그 주제의 기록을 세운다.
예전에는 축이 둘 이상인 주제만 탭이 됐고 나머지는 목록 아래 한 줄짜리 링크로 갔다. 축은
주제가 자라면서 생기는 것이지 기록이 없다는 뜻이 아니다 — 축이 없다고 이름을 숨길 이유가
없다.
*/
const rows: ReadonlyArray<{ path: string; title: string; line: string }> = detail
? detail.variants.length > 1
? detail.variants.map((variant) => ({
path: variant.path,
title: variant.title,
line: variant.conclusion || variant.summary,
}))
: detail.featuredCases.map((record) => ({
path: record.path,
title: record.title,
line: record.summary || record.note,
}))
: [];
const comparing = (detail?.variants.length ?? 0) > 1;
const axisLabel = comparing
? (detail?.variantLabel ?? active.variantLabel).trim()
: "기록";
const multiple = topics.length > 1; const multiple = topics.length > 1;
return ( return (
@@ -103,7 +126,12 @@ export function HomeTopicTabs({
type="button" type="button"
role={multiple ? "tab" : undefined} role={multiple ? "tab" : undefined}
aria-selected={multiple ? selected : undefined} aria-selected={multiple ? selected : undefined}
aria-controls="home-topic-panel" /*
패널은 하나뿐이라 고른 탭만 그것을 가리킨다. 탭 전부가 같은 패널을 가리키면
고르지 않은 탭이 "내가 저 패널을 연다" 고 말하면서 패널은 다른 탭의 이름을
달고 있게 된다 — 화면 읽기 프로그램에게 서로 어긋난 두 문장이다.
*/
aria-controls={selected ? "home-topic-panel" : undefined}
tabIndex={multiple && !selected ? -1 : 0} tabIndex={multiple && !selected ? -1 : 0}
onClick={() => select(topic.slug)} onClick={() => select(topic.slug)}
onKeyDown={onKeyDown} onKeyDown={onKeyDown}
@@ -136,21 +164,25 @@ export function HomeTopicTabs({
{`${active.name} 전체 보기`} {`${active.name} 전체 보기`}
</Link> </Link>
</div> </div>
{detail ? ( {detail && rows.length > 0 ? (
<ul> <ul>
{detail.variants.map((variant) => ( {rows.map((row) => (
<li key={variant.slug}> <li key={row.path}>
<Link to={variant.path}> <Link to={row.path}>
<strong>{variant.title}</strong> <strong>{row.title}</strong>
{/* {/*
비교표가 읽는 것은 결론이다. 요약은 이것이 무엇인가를 말하고, 결론은 만들어 비교표가 읽는 것은 결론이다. 요약은 이것이 무엇인가를 말하고, 결론은 만들어
보고 무엇을 알게 됐는가를 말한다. 보고 무엇을 알게 됐는가를 말한다.
*/} */}
<p>{variant.conclusion || variant.summary}</p> <p>{row.line}</p>
</Link> </Link>
</li> </li>
))} ))}
</ul> </ul>
) : detail ? (
<p className="home-topic-pending">
{`${active.name}에는 아직 공개된 기록이 없습니다.`}
</p>
) : ( ) : (
<p className="home-topic-pending"> <p className="home-topic-pending">
{failedSlug === active.slug {failedSlug === active.slug
@@ -140,20 +140,28 @@ function dateLabel(isoTimestamp: string): string {
*/ */
async function getTopics(publicContent: PublicContentQueries) { async function getTopics(publicContent: PublicContentQueries) {
const topics = await publicContent.listTopics(); const topics = await publicContent.listTopics();
// 목록의 순서는 서버가 정한다. 「가장 많이 다룬」은 여기서 직접 골라야 하는 것이고, /*
// 첫 항목을 쓰면 기록 3편짜리 주제가 18편짜리를 제치고 홈에 오른다. 주제는 전부 탭에 오른다.
const comparable = [...topics]
.filter((topic) => topic.variantCount > 1) 한때 축이 둘 이상인 주제만 탭이 되고 나머지는 목록 아래 「다른 주제 N개 보기」 한 줄로
.sort((left, right) => right.recordCount - left.recordCount); 갔다. 그 줄은 없애려던 바로 그 줄이다 — 읽는 사람은 비교표를 다 읽고 나서야 다른 주제가
const first = comparable[0]; 있다는 것을 알았고, 대개 거기까지 가지 않았다.
기록이 아직 없는 주제도 세운다. 주제를 만든다는 것은 앞으로 그것을 쓰겠다는 선언이고,
그 선언이 홈에 먼저 서 있는 편이 이 사이트가 무엇을 다루는지 말해 준다. 대신 그 탭을
누르면 「아직 공개된 기록이 없습니다」라고 분명히 말한다 — 빈 목록으로 두지 않는다.
순서는 기록이 많은 것부터다. 서버가 주는 순서를 그대로 쓰면 기록 3편짜리가 18편짜리를
제치고 홈의 첫 화면에 오른다.
*/
const ordered = [...topics].sort((left, right) => right.recordCount - left.recordCount);
const first = ordered[0];
const firstDetail = first ? await publicContent.getTopicDetail(first.slug) : undefined; const firstDetail = first ? await publicContent.getTopicDetail(first.slug) : undefined;
return { return {
/** 탭 하나씩. 축이 둘 이상이어야 견줄 것이 있다. */ /** 탭 하나씩. 주제 전부다. */
tabs: comparable, tabs: ordered,
/** 처음 열려 있을 주제. 이것만 미리 받는다. */ /** 처음 열려 있을 주제. 이것만 미리 받는다. */
firstDetail: firstDetail && firstDetail.variants.length > 1 ? firstDetail : undefined, firstDetail,
/** 축이 없어 탭이 되지 못한 주제 수. 있으면 주제 목록으로 가는 길을 남긴다. */
remaining: topics.length - comparable.length,
}; };
} }
@@ -195,6 +203,27 @@ export function HomePage() {
<p className="identity-statement">{publicSiteConfig.identityStatement}</p> <p className="identity-statement">{publicSiteConfig.identityStatement}</p>
</section> </section>
{/*
30초 안에 알아야 할 것은 「무엇을 만들었나」가 아니라 「무엇을 견줬고 무엇이 남았나」다.
축마다 만들어 보고 무엇을 알게 됐는지(결론)를 나란히 둔다 — 요약을 쓰면 무엇인가만
말하고 무엇을 알게 됐는지는 말하지 않는다.
이 구역이 첫 화면에 온다. 예전에는 제품명 한 줄과 일반적인 문장이 상단 300px 을 쓰고
그 아래 130px 이 빈 공간이었으며, 이 사이트에서 다른 데서 얻을 수 없는 유일한 것 —
네 구조를 나란히 견주는 표 — 이 y≈600 에 11px 회색으로 묻혀 있었다. 스크롤할 이유를
주는 것이 그 표다.
제목 자리에는 주제 이름들이 탭으로 선다. 「구조별로 알게 된 것」 한 줄이 서 있던 동안
홈이 펴 두는 주제는 하나였고, 나머지로 가는 길은 목록 밑 작은 글씨 한 줄뿐이었다 —
무엇이 더 있는지는 다 읽고 나서야 알 수 있었다. 이름을 나란히 세우면 목록을 읽기
전에 먼저 보인다.
*/}
{topics.firstDetail ? (
<section className="shell home-comparison" aria-label="주제별로 견준 것">
<HomeTopicTabs topics={topics.tabs} firstDetail={topics.firstDetail} />
</section>
) : null}
{initialKey ? ( {initialKey ? (
<section className="shell focus-section" aria-labelledby="focus-label"> <section className="shell focus-section" aria-labelledby="focus-label">
<p className="section-kicker" id="focus-label"> <p className="section-kicker" id="focus-label">
@@ -208,32 +237,6 @@ export function HomePage() {
</section> </section>
) : null} ) : null}
{/*
30초 안에 알아야 할 것은 「무엇을 만들었나」가 아니라 「무엇을 견줬고 무엇이 남았나」다.
축마다 만들어 보고 무엇을 알게 됐는지(결론)를 나란히 둔다 — 요약을 쓰면 무엇인가만
말하고 무엇을 알게 됐는지는 말하지 않는다.
제목 자리에는 주제 이름들이 탭으로 선다. 「구조별로 알게 된 것」 한 줄이 서 있던 동안
홈이 펴 두는 주제는 하나였고, 나머지로 가는 길은 목록 밑 작은 글씨 한 줄뿐이었다 —
무엇이 더 있는지는 다 읽고 나서야 알 수 있었다. 이름을 나란히 세우면 목록을 읽기
전에 먼저 보인다.
*/}
{topics.firstDetail ? (
<section className="shell home-comparison" aria-label="주제별로 견준 것">
<HomeTopicTabs topics={topics.tabs} firstDetail={topics.firstDetail} />
{/*
축을 쓰지 않아 탭이 되지 못한 주제로 가는 길. 탭에 다 올라와 있으면 이 줄은
없다 — 같은 곳으로 가는 길이 둘일 이유가 없다.
*/}
{topics.remaining > 0 ? (
<p className="home-other-topics">
<Link to="/topics">{`다른 주제 ${topics.remaining}개 보기`}</Link>
</p>
) : null}
</section>
) : null}
<LatestIndex <LatestIndex
entries={requestedState === "latest-empty" ? [] : latestEntries} entries={requestedState === "latest-empty" ? [] : latestEntries}
status={requestedState === "latest-error" ? "error" : "ready"} status={requestedState === "latest-error" ? "error" : "ready"}
@@ -1,4 +1,5 @@
import { Link } from "react-router-dom"; import { Link } from "react-router-dom";
import { projectStageLabel } from "../../shared/project-phase-labels.ts";
import { TECH_LOG_FEATURE_ID } from "../../../application/tech-log-feature-input.ts"; import { TECH_LOG_FEATURE_ID } from "../../../application/tech-log-feature-input.ts";
import { publicSiteConfig } from "../../../contracts/public-site-config.ts"; import { publicSiteConfig } from "../../../contracts/public-site-config.ts";
@@ -88,9 +89,9 @@ export function ProfilePage() {
<Link to={`/projects/${project.slug}`}> <Link to={`/projects/${project.slug}`}>
<div> <div>
<strong>{project.title}</strong> <strong>{project.title}</strong>
<span>{project.stage}</span> <span>{projectStageLabel(project.stage)}</span>
</div> </div>
<p>{project.currentGoal}</p> {project.currentGoal ? <p>{project.currentGoal}</p> : null}
<span aria-hidden="true">↗</span> <span aria-hidden="true">↗</span>
</Link> </Link>
</li> </li>
@@ -1,4 +1,5 @@
import { Link } from "react-router-dom"; import { Link } from "react-router-dom";
import { projectStageLabel } from "../../shared/project-phase-labels.ts";
import { import {
RegisteredNotFoundRoute, RegisteredNotFoundRoute,
@@ -50,16 +51,21 @@ export function ProjectOverviewPage() {
<dl className="project-status-grid"> <dl className="project-status-grid">
<div> <div>
<dt>단계</dt> <dt>단계</dt>
<dd>{project.stage}</dd> <dd>{projectStageLabel(project.stage)}</dd>
</div>
<div>
<dt>현재 목표</dt>
<dd>{project.currentGoal}</dd>
</div>
<div>
<dt>다음 작업</dt>
<dd>{project.nextStep}</dd>
</div> </div>
{/* 값이 없으면 라벨도 그리지 않는다 — 목록 화면과 같은 규칙이다. */}
{project.currentGoal ? (
<div>
<dt>현재 목표</dt>
<dd>{project.currentGoal}</dd>
</div>
) : null}
{project.nextStep ? (
<div>
<dt>다음 작업</dt>
<dd>{project.nextStep}</dd>
</div>
) : null}
</dl> </dl>
{/* {/*
숫자 셋(기록 12 · 결정 4 · 활동 9)은 이 프로젝트가 얼마나 큰지는 말해도 어디서부터 읽어야 숫자 셋(기록 12 · 결정 4 · 활동 9)은 이 프로젝트가 얼마나 큰지는 말해도 어디서부터 읽어야
@@ -1,4 +1,5 @@
import { Link } from "react-router-dom"; import { Link } from "react-router-dom";
import { projectStageLabel } from "../../shared/project-phase-labels.ts";
import { usePublicContent } from "../use-public-content.tsx"; import { usePublicContent } from "../use-public-content.tsx";
@@ -40,19 +41,31 @@ export function ProjectsPage() {
<div> <div>
<div className="project-index-title"> <div className="project-index-title">
<h2>{project.title}</h2> <h2>{project.title}</h2>
<span>{project.stage}</span> <span>{projectStageLabel(project.stage)}</span>
</div> </div>
<p>{project.summary}</p> <p>{project.summary}</p>
<dl> {/*
<div> 값이 없으면 라벨도 그리지 않는다. 네 프로젝트 중 셋이 「현재 목표」·「다음 작업」
<dt>현재 목표</dt> 라벨만 있고 값이 빈 채로 나왔다 — 읽는 사람에게는 목표가 없다는 말이 아니라
<dd>{project.currentGoal}</dd> 화면이 덜 만들어졌다는 말로 읽힌다. Studio 홈이 이미 "셋 다 비우면 그 영역은
</div> 나타나지 않는다"는 규칙을 갖고 있고, 같은 규칙이 여기에는 없었다.
<div> */}
<dt>다음 작업</dt> {project.currentGoal || project.nextStep ? (
<dd>{project.nextStep}</dd> <dl>
</div> {project.currentGoal ? (
</dl> <div>
<dt>현재 목표</dt>
<dd>{project.currentGoal}</dd>
</div>
) : null}
{project.nextStep ? (
<div>
<dt>다음 작업</dt>
<dd>{project.nextStep}</dd>
</div>
) : null}
</dl>
) : null}
</div> </div>
<span aria-hidden="true">↗</span> <span aria-hidden="true">↗</span>
</Link> </Link>
@@ -1,9 +1,24 @@
import { Link, useNavigate } from "react-router-dom"; import { Link, useNavigate } from "react-router-dom";
import { DOCUMENT_KIND_LABELS } from "../../shared/document-kind-labels.ts";
import type { SearchablePublicEntity } from "../../../application/ports/public-content-queries.ts";
import { useRouteInput } from "../../../../../presentation/routes/route-input.tsx"; import { useRouteInput } from "../../../../../presentation/routes/route-input.tsx";
import { usePublicContent } from "../use-public-content.tsx"; import { usePublicContent } from "../use-public-content.tsx";
const labels = { CASE: "Case", REFERENCE: "Reference", QUESTION: "Open Question", CONCEPT: "개념", SETUP: "환경 구성", PROJECT: "Project", RELEASE: "Release" } as const; /*
기록 종류의 이름은 `document-kind-labels.ts` 한 곳에서만 정한다. 이 파일이 자기 표를 따로
갖고 있던 동안 같은 CASE 가 목록에서는 「검증 기록」, 검색 결과에서는 「Case」로 나왔다 —
릴리즈 노트가 "화면마다 달랐던 이름을 하나로 통일했다" 고 적은 뒤에도 그랬다.
프로젝트와 릴리즈는 기록 종류가 아니라 검색이 함께 싣는 다른 대상이라 여기서 이름을 준다.
*/
type SearchContentType = SearchablePublicEntity["contentType"];
const labels: Record<SearchContentType, string> = {
...DOCUMENT_KIND_LABELS,
PROJECT: "프로젝트",
RELEASE: "릴리즈",
};
function optionalString(value: unknown): string | undefined { function optionalString(value: unknown): string | undefined {
return typeof value === "string" ? value : undefined; return typeof value === "string" ? value : undefined;
@@ -0,0 +1,37 @@
import type { Project } from "../../application/ports/public-content-queries.ts";
/**
* 프로젝트가 지금 어디까지 왔는지를 사람에게 보여 주는 이름.
*
* <p>이 표가 없던 동안 공개 화면은 `DESIGN` 이라는 낱말을 그대로 그렸다. 한국어 화면의 영어
* 단어였고, 같은 프로젝트를 Studio 는 「설계」로 불렀다 — 두 화면이 서로 다른 말을 했다.
*
* <p>Studio 와 공개 화면이 다루는 값 자체가 다르다. Studio 는 저장하는 단계 일곱을 그대로
* 쓰고(`project_phase_check`), 공개 조회는 그것을 둘로 접어 준다. 그래서 표도 둘이다 —
* 하나로 합치면 없는 값을 화면에 노출하거나 저장이 제약에서 터진다.
*/
export const PROJECT_PHASE_LABELS: Record<string, string> = {
RESEARCH: "조사",
DESIGN: "설계",
IMPLEMENTATION: "구현",
VERIFICATION: "검증",
MAINTENANCE: "유지",
PAUSED: "중단",
COMPLETED: "완료",
};
/**
* 공개 조회가 접어서 주는 단계.
*
* <p>`Record<Project["stage"], string>` 이므로 계약이 값을 늘리면 여기가 비어 있는 것을
* 컴파일러가 잡는다.
*/
export const PROJECT_STAGE_LABELS: Record<Project["stage"], string> = {
DESIGN: "설계",
VALIDATION: "검증",
};
/** 모르는 값이 오면 원문을 그대로 보여 준다 — 빈 칸보다 낫고, 무엇이 빠졌는지도 드러난다. */
export function projectStageLabel(stage: string): string {
return PROJECT_STAGE_LABELS[stage as Project["stage"]] ?? PROJECT_PHASE_LABELS[stage] ?? stage;
}
@@ -1,8 +1,9 @@
import { useEffect, useState, type FormEvent } from "react"; import { useEffect, useState, type FormEvent } from "react";
import { useSearchParams } from "react-router-dom";
import { DestructiveConfirmDialog } from "./destructive-confirm-dialog.tsx"; import { DestructiveConfirmDialog } from "./destructive-confirm-dialog.tsx";
import type { ListDocumentsQuery } from "../../../application/ports/studio-gateway.ts"; import type { ListDocumentsQuery } from "../../../application/ports/studio-gateway.ts";
import type { DocumentPage } from "../../../contracts/studio/contract.ts"; import type { CatalogPage, DocumentPage } from "../../../contracts/studio/contract.ts";
import type { components } from "../../../contracts/studio/generated.ts"; import type { components } from "../../../contracts/studio/generated.ts";
import { managementFailureMessage } from "../../../application/ports/management-gateway-error.ts"; import { managementFailureMessage } from "../../../application/ports/management-gateway-error.ts";
import { useStudio } from "../use-studio.ts"; import { useStudio } from "../use-studio.ts";
@@ -25,6 +26,16 @@ const STUDIO_KIND_ORDER: Record<RecordKind, number> = {
PROJECT_DECISION: 6, PROJECT_DECISION: 6,
}; };
/** 상태 필터가 받는 값. 주소에서 온 문자열을 이 목록으로 좁힌다. */
/** 정렬 선택지. 계약의 `ListDocumentsQuery.sort` 와 같은 집합이다. */
const SORTS = Object.freeze(["UPDATED_DESC", "UPDATED_ASC", "TITLE_ASC"] as const);
const PUBLICATION_STATUSES = Object.freeze([
"NEVER_PUBLISHED",
"PUBLISHED",
"UNPUBLISHED",
] as const);
const STUDIO_KINDS: ReadonlyArray<RecordKind> = Object.freeze( const STUDIO_KINDS: ReadonlyArray<RecordKind> = Object.freeze(
(Object.keys(STUDIO_KIND_ORDER) as RecordKind[]).sort( (Object.keys(STUDIO_KIND_ORDER) as RecordKind[]).sort(
(left, right) => STUDIO_KIND_ORDER[left] - STUDIO_KIND_ORDER[right], (left, right) => STUDIO_KIND_ORDER[left] - STUDIO_KIND_ORDER[right],
@@ -74,12 +85,50 @@ export function DocumentList() {
*/ */
const [pendingDelete, setPendingDelete] = const [pendingDelete, setPendingDelete] =
useState<DocumentPage["items"][number] | null>(null); useState<DocumentPage["items"][number] | null>(null);
const [searchDraft, setSearchDraft] = useState(""); /*
const [q, setQ] = useState(""); 목록의 상태는 주소가 갖는다.
const [kind, setKind] = useState<ListDocumentsQuery["kind"]>();
const [status, setStatus] = 컴포넌트 state 로만 들고 있던 동안 3쪽에서 문서를 열고 뒤로 오면 1쪽이었고, 걸어 둔
useState<ListDocumentsQuery["publicationStatus"]>(); 종류·상태·검색어도 함께 사라졌다. 61개를 20개씩 넘겨 보던 사람은 그 왕복을 매번 다시
const [pageNumber, setPageNumber] = useState(1); 했다. 공개 `/search` 는 처음부터 주소에 담고 있었다 — 같은 방식을 여기에 쓴다.
검색 입력만 state 다. 한 글자마다 주소를 바꾸면 뒤로가기가 글자 수만큼 쌓인다.
*/
const [searchParams, setSearchParams] = useSearchParams();
const q = searchParams.get("q") ?? "";
const kind = STUDIO_KINDS.find((item) => item === searchParams.get("kind"));
const status = PUBLICATION_STATUSES.find((item) => item === searchParams.get("status"));
const projectId = searchParams.get("project") ?? "";
const sort = SORTS.find((item) => item === searchParams.get("sort")) ?? "UPDATED_DESC";
const pageNumber = Math.max(1, Number(searchParams.get("page")) || 1);
const [searchDraft, setSearchDraft] = useState(q);
const [projects, setProjects] = useState<CatalogPage["items"]>([]);
/*
주소를 새로 쓴다. 값이 비면 조각을 빼서 `?kind=&status=` 같은 빈 꼬리가 남지 않게 한다.
1쪽도 빼는데, `?page=1` 은 아무것도 더 말해 주지 않으면서 주소만 길게 만든다.
*/
const go = (
next: Readonly<{
q?: string;
kind?: string;
status?: string;
project?: string;
sort?: string;
page?: number;
}>,
) => {
const params = new URLSearchParams();
const merged = { q, kind, status, project: projectId, sort, page: pageNumber, ...next };
if (merged.q) params.set("q", merged.q);
if (merged.kind) params.set("kind", merged.kind);
if (merged.status) params.set("status", merged.status);
if (merged.project) params.set("project", merged.project);
// 기본 정렬은 주소에 적지 않는다 — 아무것도 더 말해 주지 않으면서 주소만 길어진다.
if (merged.sort && merged.sort !== "UPDATED_DESC") params.set("sort", merged.sort);
if (merged.page && merged.page > 1) params.set("page", String(merged.page));
setSearchParams(params);
};
const [page, setPage] = useState<DocumentPage | null>(null); const [page, setPage] = useState<DocumentPage | null>(null);
const [loading, setLoading] = useState(true); const [loading, setLoading] = useState(true);
const [error, setError] = useState(""); const [error, setError] = useState("");
@@ -140,6 +189,29 @@ export function DocumentList() {
} }
}; };
// 뒤로가기로 다른 검색어의 주소에 돌아오면 입력칸도 그 값이어야 한다.
useEffect(() => {
setSearchDraft(q);
}, [q]);
/*
프로젝트 선택지. 목록과 같은 카탈로그를 읽는다 — 편집기의 프로젝트 셀렉트가 쓰는 것과
같은 원천이라 두 화면이 다른 목록을 보여 주지 않는다.
실패는 조용히 넘긴다. 프로젝트로 거르지 못하는 것은 불편이지만, 그것 때문에 작업본 목록
자체를 못 보게 만들 이유는 없다.
*/
useEffect(() => {
const controller = new AbortController();
void gateway
.getCatalog({ type: "PROJECT", limit: 100 }, { signal: controller.signal })
.then(
(page) => setProjects(page.items),
() => undefined,
);
return () => controller.abort();
}, [gateway]);
useEffect(() => { useEffect(() => {
const controller = new AbortController(); const controller = new AbortController();
setLoading(true); setLoading(true);
@@ -150,6 +222,8 @@ export function DocumentList() {
...(q ? { q } : {}), ...(q ? { q } : {}),
...(kind ? { kind } : {}), ...(kind ? { kind } : {}),
...(status ? { publicationStatus: status } : {}), ...(status ? { publicationStatus: status } : {}),
...(projectId ? { projectId } : {}),
sort,
page: pageNumber, page: pageNumber,
limit: 20, limit: 20,
}, },
@@ -167,21 +241,22 @@ export function DocumentList() {
}, },
); );
return () => controller.abort(); return () => controller.abort();
}, [gateway, kind, pageNumber, q, retryGeneration, status]); }, [gateway, kind, pageNumber, projectId, q, retryGeneration, sort, status]);
const changeFilter = (next: { const changeFilter = (next: {
kind?: ListDocumentsQuery["kind"]; kind?: ListDocumentsQuery["kind"];
status?: ListDocumentsQuery["publicationStatus"]; status?: ListDocumentsQuery["publicationStatus"];
}) => { }) => {
if ("kind" in next) setKind(next.kind);
if ("status" in next) setStatus(next.status);
// 3쪽에 있던 채로 필터를 좁히면 결과가 그보다 적어 빈 화면이 나온다. // 3쪽에 있던 채로 필터를 좁히면 결과가 그보다 적어 빈 화면이 나온다.
setPageNumber(1); go({
...("kind" in next ? { kind: next.kind ?? "" } : {}),
...("status" in next ? { status: next.status ?? "" } : {}),
page: 1,
});
}; };
const submitSearch = (event: FormEvent) => { const submitSearch = (event: FormEvent) => {
event.preventDefault(); event.preventDefault();
setQ(searchDraft.trim()); go({ q: searchDraft.trim(), page: 1 });
setPageNumber(1);
}; };
return ( return (
@@ -251,6 +326,33 @@ export function DocumentList() {
<option value="UNPUBLISHED">게시 취소</option> <option value="UNPUBLISHED">게시 취소</option>
</select> </select>
</label> </label>
{/*
프로젝트로 거르는 길이 없었다. 공개 `/explore` 는 독자에게 종류·주제·프로젝트 셋을
주는데, 61개를 관리하는 작성자에게는 종류·상태 둘뿐이었다 — 읽는 사람이 쓰는 사람보다
좋은 도구를 갖고 있었다.
*/}
<label>
프로젝트
<select
value={projectId}
onChange={(event) => go({ project: event.target.value, page: 1 })}
>
<option value="">전체</option>
{projects.map((project) => (
<option key={project.id} value={project.id}>
{project.label}
</option>
))}
</select>
</label>
<label>
정렬
<select value={sort} onChange={(event) => go({ sort: event.target.value, page: 1 })}>
<option value="UPDATED_DESC">최근 수정 순</option>
<option value="UPDATED_ASC">오래된 수정 순</option>
<option value="TITLE_ASC">제목 순</option>
</select>
</label>
</section> </section>
{loading ? ( {loading ? (
<p className="studio-loading" role="status"> <p className="studio-loading" role="status">
@@ -374,7 +476,7 @@ export function DocumentList() {
<StudioPagination <StudioPagination
page={page.page} page={page.page}
label="작업본 페이지" label="작업본 페이지"
onChange={setPageNumber} onChange={(next) => go({ page: next })}
/> />
</> </>
) : null} ) : null}
@@ -1,4 +1,5 @@
import { useEffect, useRef, useState, type FormEvent } from "react"; import { useEffect, useRef, useState, type FormEvent } from "react";
import { DOCUMENT_KIND_LABELS } from "../../shared/document-kind-labels.ts";
import type { import type {
CreateDocumentInput, CreateDocumentInput,
@@ -7,40 +8,44 @@ import type {
import { createLocalId } from "../../../domain/studio/local-id.ts"; import { createLocalId } from "../../../domain/studio/local-id.ts";
import { useStudio } from "../use-studio.ts"; import { useStudio } from "../use-studio.ts";
/*
이름은 `document-kind-labels.ts` 가 정한다. 여기서 따로 적던 동안 작업본 목록은 「검증 기록」,
새 문서 화면은 「Case」였다 — 같은 것을 만드는 두 화면이 다른 말을 썼다.
*/
const types = [ const types = [
{ {
kind: "CASE", kind: "CASE",
title: "Case", title: DOCUMENT_KIND_LABELS.CASE,
description: "문제를 재현하고 검증한 결론을 기록합니다.", description: "문제를 재현하고 검증한 결론을 기록합니다.",
fields: "문제 · 결론 · 환경 · 재현 · 본문", fields: "문제 · 결론 · 환경 · 재현 · 본문",
}, },
{ {
kind: "REFERENCE", kind: "REFERENCE",
title: "Reference", title: DOCUMENT_KIND_LABELS.REFERENCE,
description: "반복해서 적용할 기술 기준을 정리합니다.", description: "반복해서 적용할 기술 기준을 정리합니다.",
fields: "목적 · 규칙 · 적용 조건 · 예외 · 예시", fields: "목적 · 규칙 · 적용 조건 · 예외 · 예시",
}, },
{ {
kind: "CONCEPT", kind: "CONCEPT",
title: "개념", title: DOCUMENT_KIND_LABELS.CONCEPT,
description: "개념의 내부 동작과 아키텍처를 처음부터 풀어 씁니다.", description: "개념의 내부 동작과 아키텍처를 처음부터 풀어 씁니다.",
fields: "기준 버전 · 본문", fields: "기준 버전 · 본문",
}, },
{ {
kind: "SETUP", kind: "SETUP",
title: "환경 구성", title: DOCUMENT_KIND_LABELS.SETUP,
description: "이 기록을 자기 손으로 재현하는 절차를 남깁니다.", description: "이 기록을 자기 손으로 재현하는 절차를 남깁니다.",
fields: "버전 · 본문", fields: "버전 · 본문",
}, },
{ {
kind: "QUESTION", kind: "QUESTION",
title: "Question", title: DOCUMENT_KIND_LABELS.QUESTION,
description: "아직 닫히지 않은 판단과 다음 검증을 관리합니다.", description: "아직 닫히지 않은 판단과 다음 검증을 관리합니다.",
fields: "상태 · 사실 · 가정 · 미지수 · 선택지", fields: "상태 · 사실 · 가정 · 미지수 · 선택지",
}, },
{ {
kind: "PROJECT_DECISION", kind: "PROJECT_DECISION",
title: "Decision", title: DOCUMENT_KIND_LABELS.PROJECT_DECISION,
description: "프로젝트가 선택한 방향과 그 근거·영향을 기록합니다.", description: "프로젝트가 선택한 방향과 그 근거·영향을 기록합니다.",
fields: "상태 · 결정일 · 결정문 · 판단 이유 · 영향 · 근거", fields: "상태 · 결정일 · 결정문 · 판단 이유 · 영향 · 근거",
}, },
@@ -196,13 +201,6 @@ export function NewDocumentForm() {
<button className="studio-primary-button" type="submit" disabled={pending}> <button className="studio-primary-button" type="submit" disabled={pending}>
{pending ? "만드는 중…" : "작업본 만들기"} {pending ? "만드는 중…" : "작업본 만들기"}
</button> </button>
{/*
세션이 끊기면 쓴 것이 사라진다. 그 사실이 버튼 옆 작은 회색 글씨로만 있었다 —
잃을 수 있는 것을 알리는 문구는 잃기 전에 눈에 들어와야 한다.
*/}
<p className="studio-field-warning" role="note">
이 화면의 작업본은 현재 Studio 세션에서만 유지됩니다. 세션이 끝나면 사라집니다.
</p>
</div> </div>
{error ? ( {error ? (
<p className="studio-screen-error" role="alert"> <p className="studio-screen-error" role="alert">
@@ -1,4 +1,5 @@
import { useCallback, useEffect, useState, type FormEvent } from "react"; import { useCallback, useEffect, useState, type FormEvent } from "react";
import { PROJECT_PHASE_LABELS } from "../../shared/project-phase-labels.ts";
import type { components } from "../../../contracts/studio/generated.ts"; import type { components } from "../../../contracts/studio/generated.ts";
import type { import type {
@@ -21,15 +22,7 @@ function routeId(value: unknown): string {
} }
/** `project_phase_check` 와 같은 집합이다 — 화면이 더 많은 값을 보여 주면 저장이 제약에서 터진다. */ /** `project_phase_check` 와 같은 집합이다 — 화면이 더 많은 값을 보여 주면 저장이 제약에서 터진다. */
const PHASES = [ const PHASES = Object.entries(PROJECT_PHASE_LABELS).map(([value, label]) => ({ value, label }));
{ value: "RESEARCH", label: "조사" },
{ value: "DESIGN", label: "설계" },
{ value: "IMPLEMENTATION", label: "구현" },
{ value: "VERIFICATION", label: "검증" },
{ value: "MAINTENANCE", label: "유지" },
{ value: "PAUSED", label: "중단" },
{ value: "COMPLETED", label: "완료" },
] as const;
/** `project_activity_activity_type_check` 와 같은 집합이다. */ /** `project_activity_activity_type_check` 와 같은 집합이다. */
const ACTIVITY_TYPES = [ const ACTIVITY_TYPES = [
@@ -1,4 +1,5 @@
import { useEffect, useRef, useState, type FormEvent } from "react"; import { type FormEvent, useEffect, useMemo, useRef, useState } from "react";
import { useSearchParams } from "react-router-dom";
import { import {
isStudioGatewayError, isStudioGatewayError,
@@ -47,14 +48,43 @@ function snapshotHref(item: PublicationListItem) {
return null; return null;
} }
/** 이벤트 필터가 받는 값. 주소에서 온 문자열을 이 목록으로 좁힌다. */
const EVENT_TYPES = Object.freeze(["PUBLISHED", "REPUBLISHED", "UNPUBLISHED"] as const);
export function PublicationList({ export function PublicationList({
classes: styles = defaultPublicationFlowClasses, classes: styles = defaultPublicationFlowClasses,
}: { classes?: PublicationFlowClasses } = {}) { }: { classes?: PublicationFlowClasses } = {}) {
const studio = useStudio(); const studio = useStudio();
const [query, setQuery] = useState<ListPublicationsQuery>({ page: 1, limit: 20 }); /*
const [queryDraft, setQueryDraft] = useState(""); 작업본 목록과 같은 규칙으로 상태를 주소에 담는다. 담지 않던 동안 게시 기록에서 Snapshot 을
const [typeDraft, setTypeDraft] = 열고 뒤로 오면 필터도 쪽수도 처음으로 돌아갔다.
useState<ListPublicationsQuery["type"]>();
필터 제출 방식도 작업본 목록에 맞춘다 — 셀렉트는 즉시 적용, 검색어만 버튼이다. 두 화면이
다른 방식을 쓰던 동안(여기는 둘을 묶어 「적용」) 작성자는 화면마다 어느 쪽인지 기억해야 했다.
*/
const [searchParams, setSearchParams] = useSearchParams();
const q = searchParams.get("q") ?? "";
const eventType = EVENT_TYPES.find((item) => item === searchParams.get("event"));
const pageNumber = Math.max(1, Number(searchParams.get("page")) || 1);
const query = useMemo<ListPublicationsQuery>(
() => ({
...(q ? { q: q.slice(0, 100) } : {}),
...(eventType ? { type: eventType } : {}),
page: pageNumber,
limit: 20,
}),
[eventType, pageNumber, q],
);
const [queryDraft, setQueryDraft] = useState(q);
const go = (next: Readonly<{ q?: string; event?: string; page?: number }>) => {
const params = new URLSearchParams();
const merged = { q, event: eventType, page: pageNumber, ...next };
if (merged.q) params.set("q", merged.q);
if (merged.event) params.set("event", merged.event);
if (merged.page && merged.page > 1) params.set("page", String(merged.page));
setSearchParams(params);
};
const [reload, setReload] = useState(0); const [reload, setReload] = useState(0);
const [state, setState] = useState< const [state, setState] = useState<
| { status: "LOADING" } | { status: "LOADING" }
@@ -96,11 +126,7 @@ export function PublicationList({
const applyFilter = (event: FormEvent) => { const applyFilter = (event: FormEvent) => {
event.preventDefault(); event.preventDefault();
setQuery({ go({ q: queryDraft.trim().slice(0, 100), page: 1 });
...(queryDraft.trim() ? { q: queryDraft.trim().slice(0, 100) } : {}),
...(typeDraft ? { type: typeDraft } : {}),
limit: 100,
});
}; };
const dismiss = () => { const dismiss = () => {
@@ -163,15 +189,12 @@ export function PublicationList({
placeholder="제목 또는 요약" placeholder="제목 또는 요약"
/> />
</label> </label>
<button type="submit">검색</button>
<label> <label>
<span>이벤트</span> <span>이벤트</span>
<select <select
value={typeDraft ?? ""} value={eventType ?? ""}
onChange={(event) => onChange={(event) => go({ event: event.currentTarget.value, page: 1 })}
setTypeDraft(
(event.currentTarget.value || undefined) as ListPublicationsQuery["type"],
)
}
> >
<option value="">전체</option> <option value="">전체</option>
<option value="PUBLISHED">게시</option> <option value="PUBLISHED">게시</option>
@@ -179,7 +202,6 @@ export function PublicationList({
<option value="UNPUBLISHED">게시 취소</option> <option value="UNPUBLISHED">게시 취소</option>
</select> </select>
</label> </label>
<button type="submit">적용</button>
</form> </form>
{announcement ? ( {announcement ? (
@@ -271,7 +293,7 @@ export function PublicationList({
<StudioPagination <StudioPagination
page={state.page.page} page={state.page.page}
label="게시 기록 페이지" label="게시 기록 페이지"
onChange={(next) => setQuery((current) => ({ ...current, page: next }))} onChange={(next) => go({ page: next })}
/> />
) : null} ) : null}
@@ -41,6 +41,13 @@ function WorkRow({ item }: Readonly<{ item: DocumentSummary }>) {
); );
} }
/**
* 할 일이 있는 구역만 그린다.
*
* <p>세 구역이 각각 ~150px 를 차지하면서 "없습니다" 를 말하고 있었다. 대시보드는 지금 무엇을
* 해야 하는지 보여 주는 자리인데, 화면의 절반이 할 일이 없다는 말이었다. 셋 다 비면 그
* 사실은 아래 「최근 게시」가 대신 말한다.
*/
function WorkSection({ function WorkSection({
title, title,
items, items,
@@ -52,6 +59,7 @@ function WorkSection({
href: string; href: string;
empty: string; empty: string;
}>) { }>) {
if (items.length === 0) return null;
return ( return (
<section className="studio-work-section"> <section className="studio-work-section">
<div className="studio-section-title"> <div className="studio-section-title">
@@ -131,23 +139,30 @@ export function StudioDashboard() {
) : null} ) : null}
{dashboard ? ( {dashboard ? (
<> <>
{/*
숫자는 목록으로 가는 길이다.
예전에는 넷 다 누를 수 없는 글자였다. 「전체 작업본 61」을 보고 그 61개로 가려면
위 내비게이션으로 돌아가 다시 눌러야 했다 — 대시보드가 세어 준 것과 그것을 볼 수
있는 곳이 이어져 있지 않았다.
*/}
<section className="studio-summary-grid" aria-label="Studio 요약"> <section className="studio-summary-grid" aria-label="Studio 요약">
<div> <GuardedStudioLink href="/studio/documents">
<span>전체 작업본</span> <span>전체 작업본</span>
<strong>{dashboard.totals.documents}</strong> <strong>{dashboard.totals.documents}</strong>
</div> </GuardedStudioLink>
<div> <GuardedStudioLink href="/studio/documents?status=NEVER_PUBLISHED">
<span>검증할 기록</span> <span>검증할 기록</span>
<strong>{validationItems.length}</strong> <strong>{validationItems.length}</strong>
</div> </GuardedStudioLink>
<div> <GuardedStudioLink href="/studio/documents?status=NEVER_PUBLISHED">
<span>게시 준비</span> <span>게시 준비</span>
<strong>{dashboard.totals.readyToPublish}</strong> <strong>{dashboard.totals.readyToPublish}</strong>
</div> </GuardedStudioLink>
<div> <GuardedStudioLink href="/studio/publications">
<span>게시 기록</span> <span>게시 기록</span>
<strong>{dashboard.totals.publications}</strong> <strong>{dashboard.totals.publications}</strong>
</div> </GuardedStudioLink>
</section> </section>
<WorkSection <WorkSection
title="이어서 작성" title="이어서 작성"
@@ -167,7 +182,6 @@ export function StudioDashboard() {
href="/studio/documents" href="/studio/documents"
empty="게시 준비가 끝난 문서가 없습니다." empty="게시 준비가 끝난 문서가 없습니다."
/> />
<HomeFocusEditor />
<section className="studio-work-section"> <section className="studio-work-section">
<div className="studio-section-title"> <div className="studio-section-title">
<h2>최근 게시</h2> <h2>최근 게시</h2>
@@ -205,6 +219,12 @@ export function StudioDashboard() {
)} )}
</div> </div>
</section> </section>
{/*
공개 홈에 무엇을 세울지 고르는 폼이다. 작업 목록 한가운데(「게시 준비」와 「최근
게시」 사이)에 있어서, 오늘 할 일을 훑는 흐름이 설정 화면에 끊겼다. 설정은 작업이
아니므로 목록 뒤로 보낸다.
*/}
<HomeFocusEditor />
</> </>
) : null} ) : null}
</div> </div>
@@ -1,4 +1,5 @@
import { useCallback, useEffect, useState, type FormEvent } from "react"; import { useCallback, useEffect, useState, type FormEvent } from "react";
import { PROJECT_PHASE_LABELS } from "../../shared/project-phase-labels.ts";
import { DestructiveConfirmDialog } from "./destructive-confirm-dialog.tsx"; import { DestructiveConfirmDialog } from "./destructive-confirm-dialog.tsx";
import type { ProjectIndexItem, TopicEdit } from "../../../contracts/management/contract.ts"; import type { ProjectIndexItem, TopicEdit } from "../../../contracts/management/contract.ts";
@@ -17,16 +18,6 @@ import { useStudio } from "../use-studio.ts";
* <p>새 CSS 를 만들지 않는다. 작업본 목록이 쓰는 클래스만 재사용하므로 이 화면은 Studio 의 * <p>새 CSS 를 만들지 않는다. 작업본 목록이 쓰는 클래스만 재사용하므로 이 화면은 Studio 의
* 나머지와 같은 간격·타이포·색을 그대로 따른다. * 나머지와 같은 간격·타이포·색을 그대로 따른다.
*/ */
/** 공개 프로젝트 화면과 같은 말을 쓴다 — 두 화면이 다른 낱말을 쓰면 같은 것인지 알기 어렵다. */
const phaseLabel: Record<string, string> = {
RESEARCH: "조사",
DESIGN: "설계",
IMPLEMENTATION: "구현",
VERIFICATION: "검증",
MAINTENANCE: "유지",
PAUSED: "중단",
COMPLETED: "완료",
};
const visibilityLabel: Record<string, string> = { const visibilityLabel: Record<string, string> = {
PRIVATE: "비공개", PRIVATE: "비공개",
@@ -356,7 +347,7 @@ export function TaxonomyManager() {
<dl> <dl>
<div> <div>
<dt>단계</dt> <dt>단계</dt>
<dd>{phaseLabel[project.phase] ?? project.phase}</dd> <dd>{PROJECT_PHASE_LABELS[project.phase] ?? project.phase}</dd>
</div> </div>
<div> <div>
<dt>공개</dt> <dt>공개</dt>
@@ -57,4 +57,27 @@ export const TECH_LOG_ROUTE_CODECS = Object.freeze({
state: optionalString, state: optionalString,
}) })
.strip(), .strip(),
/*
Studio 목록의 상태를 주소에 담는다.
담지 않던 동안 3쪽에서 문서를 열고 뒤로 오면 1쪽이었고, 종류·검색을 걸어 둔 것도 함께
사라졌다. 61개를 20개씩 넘겨 보던 사람은 그 왕복을 매번 다시 했다. 공개 `/search` 는
처음부터 주소에 담고 있었고, 같은 방식을 Studio 에 적용하지 않았을 뿐이다.
*/
TechLogStudioDocumentsSearch: z
.object({
q: optionalSelection,
kind: optionalString,
status: optionalString,
page: optionalString,
})
.strip(),
TechLogStudioPublicationsSearch: z
.object({
q: optionalSelection,
kind: optionalString,
event: optionalString,
page: optionalString,
})
.strip(),
} as const); } as const);
+25 -2
View File
@@ -169,12 +169,33 @@ export function AppShell() {
function PrimaryNavigation({ id }: Readonly<{ id: string }>) { function PrimaryNavigation({ id }: Readonly<{ id: string }>) {
const { resolve, message } = useLocale(); const { resolve, message } = useLocale();
const { runtime } = useApplication(); const { runtime } = useApplication();
const { pathname } = useLocation();
// §3.5. A feature the runtime document disabled does not advertise itself. // §3.5. A feature the runtime document disabled does not advertise itself.
// The router refuses its routes too, so this is presentation, not the switch. // The router refuses its routes too, so this is presentation, not the switch.
const routes = NAVIGATION_ROUTES.filter((definition) => { const routes = NAVIGATION_ROUTES.filter((definition) => {
const owner = ROUTE_FEATURE_OWNER[definition.routeId]; const owner = ROUTE_FEATURE_OWNER[definition.routeId];
return owner === undefined || runtime.isFeatureActive(owner); return owner === undefined || runtime.isFeatureActive(owner);
}); });
/*
`aria-current="page"` 와 시각적 강조는 서로 다른 것을 말한다.
`end` 없이 `NavLink` 를 쓰면 `/studio/documents` 링크가 `/studio/documents/:id/edit` 에서도
활성으로 잡히고, 그때 `aria-current="page"` 가 붙는다. 그 화면은 그 페이지가 아니다 —
화면 읽기 프로그램에게는 잘못된 말이다.
그래서 `end` 로 정확히 일치할 때만 `aria-current` 가 붙게 하고, 「지금 이 구역에 있다」는
표시는 여기서 따로 계산한다. 가장 긴 접두사 하나만 고른다 — 그러지 않으면 `/studio` 가
모든 Studio 화면에서 함께 켜진다.
*/
const sectionPath = routes
.map((definition) => definition.path)
.filter(
(path) =>
path !== "/" && (pathname === path || pathname.startsWith(`${path}/`)),
)
.sort((left, right) => right.length - left.length)[0];
return ( return (
<nav id={id} aria-label={message("shell.primaryNavigation")}> <nav id={id} aria-label={message("shell.primaryNavigation")}>
<ul className="app-navigation"> <ul className="app-navigation">
@@ -182,9 +203,11 @@ function PrimaryNavigation({ id }: Readonly<{ id: string }>) {
<li key={definition.routeId}> <li key={definition.routeId}>
<NavLink <NavLink
className={({ isActive }) => className={({ isActive }) =>
`app-navigation__link${isActive ? " is-active" : ""}` `app-navigation__link${
isActive || definition.path === sectionPath ? " is-active" : ""
}`
} }
end={definition.path === "/"} end
to={definition.path} to={definition.path}
> >
{resolve(`route.${definition.routeId}.navigation`)} {resolve(`route.${definition.routeId}.navigation`)}
@@ -151,10 +151,26 @@ describe("TechLog home discovery", () => {
"aria-selected", "aria-selected",
"true", "true",
); );
/*
패널은 묶음마다 하나뿐이라 고른 탭만 그것을 가리킨다. 탭 전부가 같은 패널을 가리키면
고르지 않은 탭이 "내가 저 패널을 연다" 고 말하면서 패널은 다른 탭의 이름을 달게 된다.
그래서 검사도 고른 탭에만 건다.
*/
/*
두 탭 묶음이 서로 다른 모양을 쓴다. 「지금 집중하는 것」은 탭마다 패널이 하나씩이고,
주제 탭은 패널이 하나뿐이라 고른 탭만 그것을 가리킨다 — 전부가 같은 패널을 가리키면
고르지 않은 탭이 "내가 저 패널을 연다" 고 말하면서 패널은 다른 탭의 이름을 달게 된다.
두 모양에 다 성립하는 것은 이것이다: 가리키는 패널이 있으면 그 패널은 실제로 있고
자기를 가리킨 탭의 이름을 달고 있다.
*/
for (const tab of screen.getAllByRole("tab")) { for (const tab of screen.getAllByRole("tab")) {
const panelId = tab.getAttribute("aria-controls"); const panelId = tab.getAttribute("aria-controls");
expect(panelId).toBeTruthy(); if (!panelId) {
expect(document.getElementById(panelId!)).toHaveAttribute( expect(tab.getAttribute("aria-selected")).toBe("false");
continue;
}
expect(document.getElementById(panelId)).toHaveAttribute(
"aria-labelledby", "aria-labelledby",
tab.id, tab.id,
); );
@@ -218,7 +234,11 @@ describe("TechLog home discovery", () => {
expect(screen.getByRole("tab", { name: "최근 결정" })).toHaveFocus(); expect(screen.getByRole("tab", { name: "최근 결정" })).toHaveFocus();
await user.keyboard("{Home}"); await user.keyboard("{Home}");
expect(screen.getByRole("tab", { name: "현재 작업" })).toHaveFocus(); expect(screen.getByRole("tab", { name: "현재 작업" })).toHaveFocus();
expect(screen.getAllByRole("tabpanel")).toHaveLength(1); /*
탭 묶음이 둘이다 — 「지금 집중하는 것」과 주제 탭. 각 묶음은 패널을 하나만 펴 두므로
화면 전체에서 둘이다. 주제 탭이 생기기 전에는 하나였다.
*/
expect(screen.getAllByRole("tabpanel")).toHaveLength(2);
}); });
it("treats external focus URL changes as authoritative without stealing focus", async () => { it("treats external focus URL changes as authoritative without stealing focus", async () => {
@@ -274,7 +294,11 @@ describe("TechLog home discovery", () => {
"0", "0",
); );
expect(screen.getByRole("tabpanel", { name: "최근 결정" })).toBeVisible(); expect(screen.getByRole("tabpanel", { name: "최근 결정" })).toBeVisible();
expect(screen.getAllByRole("tabpanel")).toHaveLength(1); /*
탭 묶음이 둘이다 — 「지금 집중하는 것」과 주제 탭. 각 묶음은 패널을 하나만 펴 두므로
화면 전체에서 둘이다. 주제 탭이 생기기 전에는 하나였다.
*/
expect(screen.getAllByRole("tabpanel")).toHaveLength(2);
}); });
it("preserves the source home empty and error states", async () => { it("preserves the source home empty and error states", async () => {
@@ -131,11 +131,11 @@ describe("TechLog project screens", () => {
).toEqual([ ).toEqual([
{ {
href: "/projects/backend-skeleton", href: "/projects/backend-skeleton",
text: "01Backend SkeletonDESIGN저장소·Redis·JPA·MongoDB 같은 기술을 붙일 때 애플리케이션 경계를 다시 만들지 않도록 공통 계약을 정리하는 프로젝트입니다.현재 목표Filesystem과 Object Storage를 하나의 StoragePort로 통합다음 작업MinIO Adapter와 공통 계약 테스트 연결↗", text: "01Backend Skeleton설계저장소·Redis·JPA·MongoDB 같은 기술을 붙일 때 애플리케이션 경계를 다시 만들지 않도록 공통 계약을 정리하는 프로젝트입니다.현재 목표Filesystem과 Object Storage를 하나의 StoragePort로 통합다음 작업MinIO Adapter와 공통 계약 테스트 연결↗",
}, },
{ {
href: "/projects/auth-lab", href: "/projects/auth-lab",
text: "02Auth LabVALIDATION브라우저·Edge·Spring 사이에서 Token과 Session의 책임을 나누고 인증 경계를 검증하는 프로젝트입니다.현재 목표oauth2-proxy 뒤의 Spring 신뢰 경계 결정다음 작업JWT 재검증안과 신뢰 헤더안의 위협 모델 비교↗", text: "02Auth Lab검증브라우저·Edge·Spring 사이에서 Token과 Session의 책임을 나누고 인증 경계를 검증하는 프로젝트입니다.현재 목표oauth2-proxy 뒤의 Spring 신뢰 경계 결정다음 작업JWT 재검증안과 신뢰 헤더안의 위협 모델 비교↗",
}, },
]); ]);
}); });
@@ -39,13 +39,13 @@ const expectedRoutes = [
["TECH_LOG_PROFILE", "/profile", "PUBLIC", null, null], ["TECH_LOG_PROFILE", "/profile", "PUBLIC", null, null],
["TECH_LOG_SEARCH", "/search", "PUBLIC", null, "TechLogSearchQuery"], ["TECH_LOG_SEARCH", "/search", "PUBLIC", null, "TechLogSearchQuery"],
["TECH_LOG_STUDIO_HOME", "/studio", "STUDIO", null, null], ["TECH_LOG_STUDIO_HOME", "/studio", "STUDIO", null, null],
["TECH_LOG_STUDIO_DOCUMENTS", "/studio/documents", "STUDIO", null, null], ["TECH_LOG_STUDIO_DOCUMENTS", "/studio/documents", "STUDIO", null, "TechLogStudioDocumentsSearch"],
["TECH_LOG_STUDIO_DOCUMENT_NEW", "/studio/documents/new", "STUDIO", null, null], ["TECH_LOG_STUDIO_DOCUMENT_NEW", "/studio/documents/new", "STUDIO", null, null],
["TECH_LOG_STUDIO_DOCUMENT_EDIT", "/studio/documents/:id/edit", "STUDIO", "TechLogDocumentIdParams", null], ["TECH_LOG_STUDIO_DOCUMENT_EDIT", "/studio/documents/:id/edit", "STUDIO", "TechLogDocumentIdParams", null],
["TECH_LOG_STUDIO_DOCUMENT_VALIDATION", "/studio/documents/:id/validation", "STUDIO", "TechLogDocumentIdParams", null], ["TECH_LOG_STUDIO_DOCUMENT_VALIDATION", "/studio/documents/:id/validation", "STUDIO", "TechLogDocumentIdParams", null],
["TECH_LOG_STUDIO_DOCUMENT_PREVIEW", "/studio/documents/:id/preview", "STUDIO", "TechLogDocumentIdParams", null], ["TECH_LOG_STUDIO_DOCUMENT_PREVIEW", "/studio/documents/:id/preview", "STUDIO", "TechLogDocumentIdParams", null],
["TECH_LOG_STUDIO_DOCUMENT_PUBLISH", "/studio/documents/:id/publish", "STUDIO", "TechLogDocumentIdParams", null], ["TECH_LOG_STUDIO_DOCUMENT_PUBLISH", "/studio/documents/:id/publish", "STUDIO", "TechLogDocumentIdParams", null],
["TECH_LOG_STUDIO_PUBLICATIONS", "/studio/publications", "STUDIO", null, null], ["TECH_LOG_STUDIO_PUBLICATIONS", "/studio/publications", "STUDIO", null, "TechLogStudioPublicationsSearch"],
["TECH_LOG_STUDIO_PUBLICATION_PREVIEW", "/studio/publications/:publicationEventId/preview", "STUDIO", "TechLogPublicationEventIdParams", null], ["TECH_LOG_STUDIO_PUBLICATION_PREVIEW", "/studio/publications/:publicationEventId/preview", "STUDIO", "TechLogPublicationEventIdParams", null],
["TECH_LOG_STUDIO_ASSETS", "/studio/assets", "STUDIO", null, null], ["TECH_LOG_STUDIO_ASSETS", "/studio/assets", "STUDIO", null, null],
["TECH_LOG_STUDIO_TAXONOMY", "/studio/taxonomy", "STUDIO", null, null], ["TECH_LOG_STUDIO_TAXONOMY", "/studio/taxonomy", "STUDIO", null, null],
@@ -81,7 +81,7 @@ describe("TechLog Studio project decision authoring", () => {
</MemoryRouter>, </MemoryRouter>,
); );
await user.click(screen.getByRole("radio", { name: /Decision/ })); await user.click(screen.getByRole("radio", { name: /설계 결정/ }));
await user.click(screen.getByRole("button", { name: "작업본 만들기" })); await user.click(screen.getByRole("button", { name: "작업본 만들기" }));
await waitFor(() => { await waitFor(() => {
@@ -254,9 +254,13 @@ describe("TechLog Studio publication flow", () => {
await user.click(screen.getByRole("button", { name: "다시 시도" })); await user.click(screen.getByRole("button", { name: "다시 시도" }));
expect(await screen.findByRole("heading", { name: "Redis Adapter가 도메인 TTL 정책을 소유하지 않는 이유" })).toBeVisible(); expect(await screen.findByRole("heading", { name: "Redis Adapter가 도메인 TTL 정책을 소유하지 않는 이유" })).toBeVisible();
/*
필터 제출 방식이 작업본 목록과 같아졌다 — 셀렉트는 즉시 적용, 검색어만 버튼이다.
예전에는 이 화면만 둘을 묶어 「적용」을 눌렀고, 작성자는 화면마다 어느 쪽인지 기억해야 했다.
*/
await user.selectOptions(screen.getByLabelText("이벤트"), "UNPUBLISHED"); await user.selectOptions(screen.getByLabelText("이벤트"), "UNPUBLISHED");
await user.type(screen.getByLabelText("검색"), "Fetch 전략"); await user.type(screen.getByLabelText("검색"), "Fetch 전략");
await user.click(screen.getByRole("button", { name: "적용" })); await user.click(screen.getByRole("button", { name: "검색" }));
expect(await screen.findByRole("heading", { name: "JPA 목록 조회에서 Fetch 전략을 선택하는 기준" })).toBeVisible(); expect(await screen.findByRole("heading", { name: "JPA 목록 조회에서 Fetch 전략을 선택하는 기준" })).toBeVisible();
expect(screen.queryByRole("heading", { name: "Redis Adapter가 도메인 TTL 정책을 소유하지 않는 이유" })).not.toBeInTheDocument(); expect(screen.queryByRole("heading", { name: "Redis Adapter가 도메인 TTL 정책을 소유하지 않는 이유" })).not.toBeInTheDocument();
}); });
@@ -74,9 +74,12 @@ describe("TechLog Studio index screens", () => {
link.textContent, link.textContent,
link.getAttribute("href"), link.getAttribute("href"),
]), ]),
/*
할 일이 있는 구역만 그린다. 픽스처에서 「게시 준비」는 0건이므로 그 구역은 없다 — 예전에는
세 구역이 각각 ~150px 를 쓰면서 "없습니다" 를 말했고, 대시보드의 절반이 할 일이 없다는
말이었다.
*/
).toEqual([ ).toEqual([
["전체 보기", "/studio/documents"],
["전체 보기", "/studio/documents"],
["전체 보기", "/studio/documents"], ["전체 보기", "/studio/documents"],
["게시 기록 보기", "/studio/publications"], ["게시 기록 보기", "/studio/publications"],
]); ]);
@@ -160,7 +163,7 @@ describe("TechLog Studio index screens", () => {
gateway, gateway,
); );
await user.click(screen.getByRole("radio", { name: /Question/ })); await user.click(screen.getByRole("radio", { name: /열린 질문/ }));
await user.click(screen.getByRole("button", { name: "작업본 만들기" })); await user.click(screen.getByRole("button", { name: "작업본 만들기" }));
await waitFor(() => expect(screen.getByLabelText("현재 경로")).toHaveTextContent(/^\/studio\/documents\/[0-9a-f-]+\/edit$/)); await waitFor(() => expect(screen.getByLabelText("현재 경로")).toHaveTextContent(/^\/studio\/documents\/[0-9a-f-]+\/edit$/));