diff --git a/docs/reviews/2026-09-16-techlog-design-recheck.md b/docs/reviews/2026-09-16-techlog-design-recheck.md new file mode 100644 index 0000000..ab39aad --- /dev/null +++ b/docs/reviews/2026-09-16-techlog-design-recheck.md @@ -0,0 +1,40 @@ +# TechLog 디자인 재검증 리뷰 반영 (2026-09-16) + +이전 라운드(2026-09-15) 반영본을 다시 검증한 리뷰의 후속. 판정은 "방향을 제대로 잡은 Beta, +전체 제품화 60~65%" 였고, 읽는 쪽은 좋아졌는데 쓰는 쪽이 뒤처져 있다는 것이 핵심이었다. + +## P0 + +- [x] **P0-1 Studio Preview 회귀** — 주제를 보관으로 내리면 그 주제를 가리키던 작업본이 + `TOPIC catalog entry not found: …` 로 터졌다. 미리보기가 죽으면 고칠 화면까지 함께 죽는다. + 이름 없는 자리로 대신해 문서를 그리고, 무엇이 잘못됐는지는 편집 폼의 그 칸이 말한다. + 되돌리면 실패하는 검사로 막았다. +- [x] **P0-2 Editor 의 36개 Asset pill** — 폼에는 사용 개수와 단추만 두고, 고르는 일은 창에서 한다. +- [x] **P0-3 Project/Topic 내용 채우기** — 화면은 준비됐으나 내용은 작성자 몫이다. 빈 자리를 + 의도적인 상태로 말하게 하고, Studio 구조 화면이 무엇이 비었는지 짚는다. 아래 「남은 것」 참고. +- [x] **P0-4 Studio IA 축약** — 위에는 작업·구조·자료·게시 넷만. 그 안의 화면은 일을 고른 뒤 나타난다. +- [x] **P0-5 Editor 구조화** — 편집기 목차가 구역만 읽어 Question 에서 한 줄이었다. 항목 묶음도 + 함께 읽어 확인한 사실·가정·남은 미지수·제약으로 이동할 수 있다. +- [x] **P0-6 Asset Detail + Usage** — 큰 그림, 쓰이는 곳 링크, 지우기 전 영향 범위. + +## P1 + +- [x] Question 의 인식 상태 표식 (확인한 사실 ● / 가정 ○ / 남은 미지수 ? / 제약 │) +- [x] 다음 검증에 「왜 다음인가」 — 남은 미지수를 그 자리에 다시 세워 둘을 잇는다 +- [x] Concept 의 흐름 지도 — 본문 소제목에서 만든다(손으로 적으면 본문을 고칠 때 그 줄만 낡는다) +- [x] Projects 목록 정보 밀도 — 기록·열린 질문·결정 수 +- [x] Taxonomy 구조 보기 — 프로젝트 → 주제 나무, 걸리지 않은 주제, 질문 없는 주제 +- [x] Publish 요약 — 함께 나가는 관계·자료 수 +- [x] 모바일 code/table overflow 단서 (이전 라운드에서 반영, 이번에 유지) + +## 남은 것 + +- **프로젝트 네 개 전부 목적·논지·현재 목표·다음 작업이 비어 있다.** 주제 셋도 답하는 질문이 + 없다. 내용은 지어낼 수 없어 채우지 않았다 — 이전에 임의로 써 넣은 주제 다섯이 그대로 + 문제가 됐다. Studio 구조 화면이 어느 프로젝트·주제가 비었는지 짚어 준다. +- **Publish 의미 diff** — "무엇이 바뀌었나"(구역·관계·자료)를 말하려면 서버가 직전 게시본과 + 현재 작업본을 비교해 줘야 한다. 지금은 함께 나가는 것의 수까지만 말한다. +- **작업본 목록의 주제 필터** — `DocumentSummary` 에 주제가 없다. 계약에 없는 값이라 화면에서 + 만들 수 없다. +- **모바일 도식 확대와 표 overflow 는 정적 캡처로 검증할 수 없다.** 코드에는 들어 있다 + (본문 폭보다 넓은 그림은 확대 가능, 표·코드는 넘어가는 쪽에만 그림자). diff --git a/scripts/capture-screens.ts b/scripts/capture-screens.ts index 735b6e9..8f8b341 100644 --- a/scripts/capture-screens.ts +++ b/scripts/capture-screens.ts @@ -249,7 +249,20 @@ const EMPTY_STUDIO = { *

자격 증명을 스크립트가 들고 있지 않아도 되고, Keycloak 화면이 바뀌어도 깨지지 않는다. */ async function login(base: string): Promise { - const browser = await chromium.launch({ headless: false }); + /* + 로그인 창은 사람이 타이핑하는 동안 몇 분씩 떠 있다. 기본 설정으로 띄우면 그 시간 내내 + 메모리를 크게 물고 있어서 이 기계의 감시에 걸려 죽었다 — 창이 죽으면 세션도 못 받는다. + 그림을 그릴 일도 없는 창이므로 GPU 와 큰 공유 메모리를 쓰지 않게 하고 힙도 줄인다. + */ + const browser = await chromium.launch({ + headless: false, + args: [ + "--disable-gpu", + "--disable-dev-shm-usage", + "--disable-extensions", + "--js-flags=--max-old-space-size=320", + ], + }); const context = await browser.newContext({ viewport: { width: 1440, height: 900 } }); const page = await context.newPage(); await page.goto(`${base}/studio`);