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
@@ -151,10 +151,26 @@ describe("TechLog home discovery", () => {
"aria-selected",
"true",
);
/*
패널은 묶음마다 하나뿐이라 고른 탭만 그것을 가리킨다. 탭 전부가 같은 패널을 가리키면
고르지 않은 탭이 "내가 저 패널을 연다" 고 말하면서 패널은 다른 탭의 이름을 달게 된다.
그래서 검사도 고른 탭에만 건다.
*/
/*
두 탭 묶음이 서로 다른 모양을 쓴다. 「지금 집중하는 것」은 탭마다 패널이 하나씩이고,
주제 탭은 패널이 하나뿐이라 고른 탭만 그것을 가리킨다 — 전부가 같은 패널을 가리키면
고르지 않은 탭이 "내가 저 패널을 연다" 고 말하면서 패널은 다른 탭의 이름을 달게 된다.
두 모양에 다 성립하는 것은 이것이다: 가리키는 패널이 있으면 그 패널은 실제로 있고
자기를 가리킨 탭의 이름을 달고 있다.
*/
for (const tab of screen.getAllByRole("tab")) {
const panelId = tab.getAttribute("aria-controls");
expect(panelId).toBeTruthy();
expect(document.getElementById(panelId!)).toHaveAttribute(
if (!panelId) {
expect(tab.getAttribute("aria-selected")).toBe("false");
continue;
}
expect(document.getElementById(panelId)).toHaveAttribute(
"aria-labelledby",
tab.id,
);
@@ -218,7 +234,11 @@ describe("TechLog home discovery", () => {
expect(screen.getByRole("tab", { name: "최근 결정" })).toHaveFocus();
await user.keyboard("{Home}");
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 () => {
@@ -274,7 +294,11 @@ describe("TechLog home discovery", () => {
"0",
);
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 () => {
@@ -131,11 +131,11 @@ describe("TechLog project screens", () => {
).toEqual([
{
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",
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_SEARCH", "/search", "PUBLIC", null, "TechLogSearchQuery"],
["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_EDIT", "/studio/documents/:id/edit", "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_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_ASSETS", "/studio/assets", "STUDIO", null, null],
["TECH_LOG_STUDIO_TAXONOMY", "/studio/taxonomy", "STUDIO", null, null],
@@ -81,7 +81,7 @@ describe("TechLog Studio project decision authoring", () => {
</MemoryRouter>,
);
await user.click(screen.getByRole("radio", { name: /Decision/ }));
await user.click(screen.getByRole("radio", { name: /설계 결정/ }));
await user.click(screen.getByRole("button", { name: "작업본 만들기" }));
await waitFor(() => {
@@ -254,9 +254,13 @@ describe("TechLog Studio publication flow", () => {
await user.click(screen.getByRole("button", { name: "다시 시도" }));
expect(await screen.findByRole("heading", { name: "Redis Adapter가 도메인 TTL 정책을 소유하지 않는 이유" })).toBeVisible();
/*
필터 제출 방식이 작업본 목록과 같아졌다 — 셀렉트는 즉시 적용, 검색어만 버튼이다.
예전에는 이 화면만 둘을 묶어 「적용」을 눌렀고, 작성자는 화면마다 어느 쪽인지 기억해야 했다.
*/
await user.selectOptions(screen.getByLabelText("이벤트"), "UNPUBLISHED");
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(screen.queryByRole("heading", { name: "Redis Adapter가 도메인 TTL 정책을 소유하지 않는 이유" })).not.toBeInTheDocument();
});
@@ -74,9 +74,12 @@ describe("TechLog Studio index screens", () => {
link.textContent,
link.getAttribute("href"),
]),
/*
할 일이 있는 구역만 그린다. 픽스처에서 「게시 준비」는 0건이므로 그 구역은 없다 — 예전에는
세 구역이 각각 ~150px 를 쓰면서 "없습니다" 를 말했고, 대시보드의 절반이 할 일이 없다는
말이었다.
*/
).toEqual([
["전체 보기", "/studio/documents"],
["전체 보기", "/studio/documents"],
["전체 보기", "/studio/documents"],
["게시 기록 보기", "/studio/publications"],
]);
@@ -160,7 +163,7 @@ describe("TechLog Studio index screens", () => {
gateway,
);
await user.click(screen.getByRole("radio", { name: /Question/ }));
await user.click(screen.getByRole("radio", { name: /열린 질문/ }));
await user.click(screen.getByRole("button", { name: "작업본 만들기" }));
await waitFor(() => expect(screen.getByLabelText("현재 경로")).toHaveTextContent(/^\/studio\/documents\/[0-9a-f-]+\/edit$/));