2026-11-01 툴바의 예제는 모달로, 안드로이드에서 느린 로딩을 재 봄

메인테이너: “inbox 처리해주세요”

inbox에서 옮긴 원문

3. 기능 › ## MVP › ### 추가/변경 요건:

  • 툴바의 예제를 클릭하면 드롭다운이었던 것을 예제 선택 모달창으로 바꿔주세요
  • 안드로이드폰에서 로딩속도가 매우 느립니다. 혹시 개선할 방법이 있나요?

툴바의 “예제”는 예제 모달을 엶

  • 툴바의 “예제 ▾” 드롭다운을 “예제” 버튼으로 바꿈. 도움말 › 예제…와 같은 모달(제목 “예제 열기”)을 연다 → EX4, 05-screen-layout
  • 모달 맨 아래의 “툴바의 “예제 ▾“에서도 고를 수 있습니다”는 툴바에서 연 모달에 맞지 않아 지움. 환영 모달의 끝 문구는 “예제는 툴바의 “예제”와 도움말 › 예제…로 다시 열 수 있습니다.”로(Claude가 정함)
  • 예제 하나를 바로 여는 명령(example.<id>)은 커맨드 팔레트에 그대로
  • E2E: 툴바 버튼이 모달을 여는지로 바꿈. 드롭다운이 툴바에 갇히지 않는지의 검사는 “확대 ▾“로 옮김. pnpm check · E2E 39개 통과

안드로이드에서의 로딩

재는 스크립트 src/apps/web/scripts/measure-startup.mjs를 만듦. Chromium에서 CPU를 6배 느리게, 네트워크를 Lighthouse의 “slow 4G”(왕복 150 ms, 1.6 Mbps)로 두고, 화면 폭 412px로 연다. 세 번의 중앙값(ms):

경우편집 화면이 보임블록 글꼴까지 받음
첫 방문(환영 모달), slow 4G18194137
다시 방문, slow 4G17213379
첫 방문, CPU만 느리게9453144
다시 방문, CPU만 느리게7701112
  • 첫 내려받기는 gzip으로 465 KB이고, 그 가운데 320 KB(70%)가 화면용 블록 글꼴(woff2)이다. 글꼴에 한글 음절 11,172자가 모두 들어 있다(ADR-0034의 문자 범위)
  • 글꼴이 오기 전에도 편집 화면은 보이고(대체 글꼴로 그림), 글꼴이 오면 바뀐다
  • 해 보고 되돌린 것 둘:
    • 글꼴을 index.html에서 미리 받기(preload): 느린 4G에서 JS와 대역폭을 나눠 써서 편집 화면이 0.8초 늦게 보였다
    • 예제 썸네일 열 개를 하나씩 나눠 그리기: 썸네일은 원래 편집 화면과 함께 다 그려졌다(1.8초). 나누니 끝이 4.4초로 늦어졌다
  • 흉내 낸 폰에서는 2초 안에 편집 화면이 보인다. 메인테이너가 느꼈던 “매우 느림”과 차이가 있어, 폰의 기종 · 브라우저 · 네트워크 · 걸린 시간을 알아야 한다

느린 것이 아니라 뜨지 않음

메인테이너: “내 폰은 삼성캘럭시S26이고 크롬브라우저에서 한참을 기다려도 MVP 화면이 뜨지 않습니다.”

  • 느린 폰이 아니므로 로딩 속도가 아니라 시작이 멈추는 문제로 봄. 펴낸 사이트를 Playwright의 안드로이드 흉내(Galaxy S9+)로 열면 정상으로 뜬다. 실제 폰에서만 생긴다
  • 원인 후보: 페이지는 IndexedDB를 연 뒤에 그리는데(main.tsx의 await openBrowserDb), 여는 데 시간 제한도 onblocked 처리도 없었다. 응답이 없으면 화면이 영영 비어 있다
  • 고친 것(→ 06-web):
    • 여는 데 3초 제한, 다른 탭이 막으면(onblocked) 바로, 그때는 메모리로 계속
    • 시작 화면: 뜨기 전에 “AriadneNSD 불러오는 중…”, 시작 오류가 나거나 15초가 지나면 멈춘 단계(data-boot-step) · 오류 · 브라우저 정보를 화면에 적음. 폰에서 찍어 알릴 수 있게
    • E2E 둘: indexedDB.open이 응답하지 않아도 편집 화면이 뜨는가, 시작 오류가 시작 화면에 보이는가. pnpm check · E2E 41개 통과
  • 폰에서 확인하려고 메인테이너가 정해 마무리 전에 push함

휴대폰의 비기능 요구사항과 테스트 정리

메인테이너:

  1. 안드로이드폰에 대해 웹버전의 비기능요건을 추가해주시고 QAS와 관련된 테스트를 추가해주세요.
  2. 오늘 결함이나 품질에 대한 얘기를 많이 했습니다. 이런 것들이 해결됐음을 확인할 수 있는 테스트가 테스트 목록에 추가되고 있나요?
  3. 테스트들을 정리하고 항상 현행화해주세요. 테스트 목적/내용, 테스트 방법, 테스트 유형(모듈 단위 테스트 / 사용자관점의 통합테스트) ← 이렇게 정리하는게 좋은 방법인지 의견 주세요.

그리고 일하는 중에: “단위 테스트 / 사용자관점의 통합테스트 등 테스트 유형에 대한 설명이 테스트 설계에 있나요? 일하면서 테스트 아키텍쳐라는 문서들을 종종 봤습니다. 우리도 테스트 설계의 한 꼭지로 이런 것이 있으면 좋겠어요.”

  • 1: 비기능 요구사항 R-NFR-08(휴대폰 호환성) · R-NFR-09(휴대폰에서의 시작 시간) · R-NFR-10(시작 실패를 보임), 모두 P0(Claude가 정함, 확인 전). QAS QA-18(느린 폰에서 편집 화면 3초 · 글꼴 5초, 제안값) · QA-19(빈 화면 없음) · QA-20(휴대폰에서 탭으로 쓰기) → 03-quality-attribute-scenarios. E2E mobile.spec.ts(Galaxy S9+ 흉내, CPU 4배 · slow 4G), boot.spec.ts
  • 2: 오늘의 결함(스크롤바, 툴바 드롭다운, S26 빈 화면)에는 E2E가 있었지만 문서의 테스트 목록(인수 테스트 표)에는 없었다. 결함 기록을 만들어 BUG-01 ~ BUG-03을 붙이고, 회귀 테스트의 이름 앞에 적음
  • 3: 메인테이너가 고른 안(Claude의 추천): 근거 칸 + 자동 생성. 칸은 ID · 목적/내용 · 근거 · 방법 · 유형 · 자리, 유형은 단위 · 통합 · E2E · 성능(수동은 점검표). 테스트 목록을 src/scripts/test-list.mjs가 테스트 이름과 파일 첫 주석에서 만들고, pnpm check가 목록이 낡으면 실패한다. 끝에 “테스트가 없는 ID”(인수 테스트나 검사가 맡은 것은 그 길을 적음). 남은 빈 곳 QA-05 · 08 · 11 · 13 · 16은 backlog로
  • 테스트 아키텍처: 1. 테스트 아키텍처를 새로 넣음(유형마다 확인하는 것 · 진짜와 가짜 · 실행 환경, 유형과 구성 요소의 그림, 테스트 더블, 테스트 이름의 ID, 결함과 회귀 테스트, 어느 유형으로 쓸지). 뒤의 절 번호가 하나씩 밀려 링크와 코드 주석을 고침(승인 ADR은 링크 주소만)

S26에서 뜸, 휴대폰의 툴바

메인테이너: “S26에서 MVP가 뜹니다. 근데 S26에서 툴바에 예제 버튼이 안 보이네요?” 그리고 “그리고 감싸기가 화면 아래에 있어요. 이럴 필요가 있나요?”

  • BUG-03은 S26에서 확인됨 → 결함 기록
  • BUG-04: 예제 버튼에 “넓은 화면에서만” 클래스가 남아 있었다(드롭다운이던 때의 설정). 좁은 화면에서는 아이콘만 보이게. 회귀 테스트 mobile.spec.ts(고치기 전 실패를 확인)
  • 감싸기: 아래 줄은 툴바를 두 줄로 지키려는 Claude의 설계였다. MVP를 폰 크기로 띄워 세 가지를 찍어 견주고(journal/assets/2026-11-01-narrow-wrap-options.png), 메인테이너가 3 “아래 줄 없앰”을 고름(Claude의 추천) → MB2. 아래 줄을 없애고 되돌리기 · 다시 · 감싸기를 툴바에, 도움말 버튼은 좁은 화면에서만 툴바 끝에. 05-screen-layout의 휴대폰 그림을 다시 찍음(찍는 스크립트가 첫 방문 모달에 가려 멈추던 것도 고침)
  • 남은 흠: 툴바가 접힐 때 줄 맨 앞에 구분선이 남는다(backlog)

매듭 (2026-11-01)

  • inbox의 두 항목 모두 처리하고 지움(원문은 위)
  • ADR-0038의 “이후 변경”에 테스트 아키텍처 · 자동 테스트 목록 · 휴대폰 흉내를 덧붙임
  • TIL test-types-and-doubles

확인받음

메인테이너: “새로 넣은 “확인해 주세요” 5개 모두 ok입니다.” outbox에서 옮긴 원문:

  • 휴대폰의 비기능 요구사항과 QAS에서 Claude가 정한 것 (2026-11-01 세션 04 → 2026-11-01-04-examples-button-android-load)
    • R-NFR-08 ~ R-NFR-10을 모두 P0(MVP에 듦)으로. 휴대폰은 Android의 Chrome만(iPhone의 Safari는 넣지 않음)
    • QA-18의 합격 기준(제안값): CPU 4배 느림 + slow 4G에서 편집 화면 3초, 블록 글꼴까지 5초 → QA-18 모바일 시작 시간
    • 시작이 15초를 넘거나 오류가 나면 “AriadneNSD를 시작하지 못했습니다. 이 화면을 찍어 알려 주세요.”와 멈춘 단계 · 오류 · 브라우저 정보를 보임. 저장소 열기는 3초 제한 → 7. 웹에서의 화면
  • 툴바의 “예제”를 모달로 바꾸며 정한 문구 (2026-11-01 세션 04): 툴바에서 연 모달에는 맨 아래 문구가 없고, 환영 모달에만 “예제는 툴바의 “예제”와 도움말 › 예제…로 다시 열 수 있습니다.” → EX4
  • 테스트 목록의 유형 나누기 (2026-11-01 세션 04): 통합으로 본 파일 여덟은 스크립트(src/scripts/test-list.mjs의 integrationFiles)에 적은 목록이고, 나머지 Vitest 파일은 단위. 결함 번호는 BUG-01처럼 두 자리 → 1. 테스트 아키텍처, defects

QA-18의 기준은 제안값에서 확정으로 바꿈 → QA-18 모바일 시작 시간

다음 할 것

  • push 뒤 CI에서 휴대폰 E2E(특히 QA-18의 시작 시간)가 통과하는지 보기
  • 메인테이너가 S26에서 바뀐 툴바(예제 버튼, 아래 줄 없앰)를 써 보기
  • 휴대폰 첫 내려받기를 줄일지(글꼴 나눠 받기) → backlog