From f6f0c6428450fcf1609ffed7eab219e4b0f42453 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Wed, 16 Sep 2026 02:08:01 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20=EC=9E=AC=EA=B2=80=EC=A6=9D=20=EB=A6=AC?= =?UTF-8?q?=EB=B7=B0=20=EB=B0=98=EC=98=81=20=EA=B8=B0=EB=A1=9D,=20?= =?UTF-8?q?=EB=A1=9C=EA=B7=B8=EC=9D=B8=20=EC=B0=BD=20=EB=A9=94=EB=AA=A8?= =?UTF-8?q?=EB=A6=AC=20=EC=B6=95=EC=86=8C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 리뷰의 P0 여섯과 P1 일곱을 반영한 결과를 남긴다. 채우지 못한 것(프로젝트·주제의 내용, Publish 의미 diff, 작업본 목록의 주제 필터)도 이유와 함께 적는다 — 무엇을 안 했는지가 적혀 있지 않으면 다음 검토가 그것을 다시 찾아야 한다. 로그인 창은 사람이 타이핑하는 동안 몇 분씩 떠 있다. 기본 설정으로 띄우면 그 시간 내내 메모리를 크게 물고 있어 이 기계의 감시에 걸려 죽었고, 창이 죽으면 세션도 못 받았다. 그림을 그릴 일이 없는 창이므로 GPU 와 큰 공유 메모리를 쓰지 않게 한다. Co-Authored-By: Claude Opus 5 (1M context) Claude-Session: https://claude.ai/code/session_015c8cBFUaVr7KLVUx6ujz7D --- .../2026-09-16-techlog-design-recheck.md | 40 +++++++++++++++++++ scripts/capture-screens.ts | 15 ++++++- 2 files changed, 54 insertions(+), 1 deletion(-) create mode 100644 docs/reviews/2026-09-16-techlog-design-recheck.md 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`);