---

work_id: ux-2026-09-20-12 artifact_type: research_observation status: 준비 완료 owner_role: ui-ux-researcher source_request: "Site 원본 저장과 전달용 내보내기의 실행 전후 설명 확인" last_updated: 2026-09-20

UX-12 — Site 원본 파일과 전달용 출력을 구분하는가

연구 기록 상태: 준비 완료. UI/UX 영역 상태: 미완료. 이번 상태는 한정 관찰의 기록 완료를 뜻한다. 제품 전체 출시 준비를 뜻하지 않는다.

결과: 파일 메뉴는 저장·페이지 내보내기·전체 내보내기를 구분한다. 관찰한 실행 전 메뉴에는 파일 형식이나 재편집 목적 설명이 없었다. 실행 후에는 저장에서 .site.json 파일명, 페이지 내보내기에서 1개 HTML 파일을 표시했다. 두 상태는 다운로드 요청과 완료를 구분했다. 사용자 혼동이나 잘못된 파일 선택은 검증하지 않았다. 새 결함 이슈는 만들지 않는다.

범위와 버전

2026-09-20, macOS Codex 내장 브라우저, Node 22.22.0. 별도 http://127.0.0.1:5196/의 합성 자료 UX-06 원본 · Site 사본을 사용했다. 본문을 바꾸지 않고 관리 화면의 파일 메뉴에서 저장과 이 페이지 내보내기를 각 1회 실행했다. 발행하기는 실행하지 않았다.

실행 SHA는 42e9a88a6cd8d3ffc002d14cd29ef6905a3769c1, 관찰 비교 기준 main은 eeb0ab67390b2898e85d8aa1e028ce5b6a993ff2다. apps/site/src/app.tsx, menu-model.ts, site-file.ts, 공통 file-actions.tsx의 blob은 main과 같다. main 전체 통합 실행 결과는 아니다. 게시 직전 main은 0d97e1f00948aafd27bd6bdf4ac2b9a2f9f51e60으로 갱신됐다. 이 새 commit은 실행하지 않았다. 캡처는 브라우저 현재 크기 1280×720, 880×1132다. 화면 크기 변경이나 모바일 검사는 하지 않았다.

직접 관찰과 코드 확인

행동	직접 관찰	해석의 한계
파일 메뉴 열기	저장, 이 페이지 내보내기, 사이트 전체 내보내기, 발행하기가 별도 항목	관찰한 메뉴에 형식·재편집 목적 안내가 없음. 사용자가 구분하지 못한다는 증거는 아님
저장 실행	다운로드 요청됨. UX-06 원본 · Site 사본.site.json 표시. 완료 여부는 브라우저 목록에서 확인하도록 안내	실제 파일 재열기·내용 보존은 검사하지 않음
이 페이지 내보내기 실행	사이트 다운로드 요청됨. 1개 HTML 파일 표시. 브라우저 목록 확인 안내	외부 열기·전달·배포 성공을 뜻하지 않음

화면 기록: 파일 메뉴, 원본 파일 요청, HTML 요청.

Site 파일 형식은 .site.json을 쓰고 해당 reader로 읽는다. 호스트 출력은 페이지 HTML과 사이트 ZIP 처리를 나눈다. 전체 ZIP은 이번에 실행하지 않았다. 기존 HTML 출력 검사는 실패·재시도·중복 요청도 다룬다. 정의만 읽었고 자동 검사를 재실행하지 않았다.

공통 UI 범위와 다음 판단

공통으로 맞출 것은 원본 보관, 전달용 출력, 외부 게시의 의미와 요청·완료 상태다. 파일 확장자와 세부 보존 한계는 제품별로 설명한다. 관찰한 상태 안내는 요청과 완료를 이미 나누므로 완료 문구를 다시 만드는 과제는 제안하지 않는다.

실행 전 항목에 ‘Site 원본 파일’, ‘페이지 HTML’, ‘사이트 ZIP’ 같은 목적·형식 설명을 붙일지는 검증 전 후보다. 새 대화상자를 의무화하지 않는다. #289 고객 연구에서 ‘다른 환경에서 다시 편집하기’와 ‘방문자가 볼 파일 전달하기’를 주고 첫 선택과 설명을 관찰할 수 있다. 혼동이 확인되면 해당 문구 범위만 PM에게 제안한다. 이번 후보는 출시 필수 조건이 아니다.

기존 #327·PR #335는 SDK 문서와 출력 경계를 다룬다. #337은 전달 기록 제안이다. 이번 관찰은 둘을 다시 구현할 근거가 아니다. DOCX 검수 교환 판단의 별도 보존 문제와도 구분한다.

남은 위험은 실사용자의 목적·형식 이해, 파일 재열기와 전체 내용 보존, 실제 외부 배포다. 모두 미확인이다. Word·Slides·Note 화면, ZIP 실행, 실패·취소·스크린리더는 이번 범위 밖이다.

다음 담당자는 UI/UX 연구 역할(관찰 과제·근거 정리), Product Master PM(#289의 고객 연구 실행 담당과 범위 판단)이다. 구현 담당은 새로 지정하지 않았다. 계약·결제·개인정보·지원·운영의 담당 배정은 이번 조사에서 확인하지 않았다. 기술 출시 추적은 기존 #322를 유지한다.