문제 해결

증상별 점검 순서와, 막혔을 때 지원팀에 정확한 정보를 보내는 세션 진단(SESSION-DIAG) 사용법을 안내합니다.

증상별 점검

🔴 협업 상대의 마크업이 안 보여요

가장 흔한 문의입니다. 순서대로 확인하세요.

1. 양쪽 모두 새로고침합니다. 두 사람 다 최신 화면이어야 합니다.
2. 상대가 마크업을 게시(Publish) 했는지 확인합니다. 비공개(🔒) 초안은 보이지 않습니다.

• 협업 중에는 자동 게시되지만, 그러려면 둘 다 같은 도면을 편집 모드로 열고 있어야 합니다.

1. 같은 도면·같은 버전을 보고 있는지 확인합니다(과거 버전을 보고 있지 않은지).
2. 그래도 안 되면 세션 진단에서 collab 태그 로그를 확인/전달합니다.

🔴 협업 참여자(상대)가 목록에 안 떠요

1. 상대가 지금 그 도면을 열고 있는지 확인합니다(접속 중이어야 표시).
2. 둘 다 프로젝트 멤버인지 확인합니다(비멤버는 도면에 도달할 수 없습니다).
3. 탭을 앞으로 가져옵니다. 백그라운드 탭은 화면 갱신이 멈춰 커서가 안 보일 수 있습니다.
4. 새로고침 후에도 안 되면 세션 진단 로그를 전달합니다.

🔴 도면이 안 열려요 / 로딩에서 멈춰요

1. PDF 파일인지 확인합니다(타이거빔은 PDF만 지원).
2. 새로고침 후 다시 엽니다.
3. 큰 파일은 다운로드·렌더에 시간이 걸릴 수 있습니다. 잠시 기다려 주세요.
4. 계속 멈추면 세션 진단의 pdf 태그 로그를 확인/전달합니다.

🔴 줌을 키우면 도면이 사라지거나 화면이 멈춰요

• 타이거빔은 매우 높은 배율에서 성능 저하가 없도록 처리되어 있습니다. 그래도 멈추는 느낌이 들면:

1. 뷰 초기화(또는 Ctrl/⌘+0)로 맞춤 보기로 돌아옵니다.
2. 새로고침 후 다시 시도합니다.
3. 재현되면 세션 진단에서 상세 모드를 켜고(zoom 이벤트 포함) 로그를 전달합니다.

🟡 측정값이 이상해요

• 축척이 설정됐는지 확인합니다. 상태바에 ⚠ 축척 미설정이 보이면 축척 설정(C)을 먼저 하세요. → 02. 축척 설정

🟡 저장 / 편집이 안 돼요

1. 과거 버전(읽기 전용)을 보고 있지 않은지 확인합니다(「과거 버전 · 읽기 전용」 배지). 현재 버전을 여세요.
2. 편집 권한(역할)이 있는지 확인합니다(뷰어는 편집 불가).
3. 오프라인 상태가 아닌지 확인합니다 — 에디터에 「오프라인 · 읽기 전용」 배지가 보이면, 그 도면은 오프라인 저장(핀)이 완료되지 않아 읽기만 가능합니다. 핀 완료 도면은 오프라인에서도 편집되고 재접속 시 자동 동기화됩니다. → 01. 오프라인 저장

🟡 오프라인 관련 증상

• 상단에 「오프라인 — 핀한 도면만 열 수 있습니다.」 배너가 보이면 인터넷이 끊긴 상태입니다 — 핀해 둔 도면만 열립니다.
• 오프라인 저장 버튼·핀 아이콘이 아예 안 보이면: 브라우저 시크릿(프라이빗) 창이거나 저장소를 지원하지 않는 구형 브라우저입니다. 일반 창의 최신 크롬/엣지/사파리를 사용하세요.
• 재접속 후 「도면 N건을 동기화하지 못해 로컬에 보관했습니다 — 다시 시도합니다.」가 보이면 편집은 안전하게 보관된 것입니다 — 잠시 후 자동 재시도됩니다.

🟡 알림이 안 와요

1. 상단 🔔 벨의 배지를 확인합니다(앱 내 알림이 기본).
2. 알림은 나와 관련된 변화(담당·멘션·책임자 등)에 옵니다.
3. 이메일 알림은 운영자가 설정한 경우에만 옵니다.

🟡 화면 라벨이 영어로 나와요

• 상단 헤더의 KO / EN 토글에서 KO를 선택하세요.

🟡 (데스크톱 앱) "업데이트가 필요합니다" 배너가 떠요

• 앱 버전이 오래된 경우입니다. 화면 구석의 재시작하여 업데이트 배지를 눌러 새 버전을 적용하세요. 도면 열람·마킹은 배너가 떠 있어도 계속 가능합니다.
• macOS에서 배지를 눌러도 적용되지 않으면(베타 제한) 다운로드 페이지에서 최신 설치 파일을 받아 다시 설치하세요. → 00장 데스크톱 앱

세션 진단 (SESSION-DIAG) 사용법

문제가 반복되거나 원인을 알기 어려울 때, 에디터가 내부에서 무슨 일을 했는지 로그로 모아 지원팀에 전달하는 도구입니다. 협업·마크업·PDF 로딩·오류를 시간순으로 기록합니다.

진단 로그는 외부로 자동 전송되지 않습니다. 사용자가 직접 복사/저장해 전달할 때만 공유됩니다.

여는 방법 (세 가지)

📷 [스크린샷: 좌측 하단 진단 버튼(빨간 오류 배지) + 진단 패널]

패널 사용

진단 패널(제목 세션 진단)에서:

1. 필터로 좁히기

• 레벨: 전체 / info / warn / error — 오류만 보려면 error.
• 태그: collab(협업) · markup(마크업) · pdf(도면 로딩) · error 등.
• 검색창: 메시지·데이터로 검색.

1. 상세 모드: 협업/커서/줌 같은 세밀한 이벤트까지 보려면 상세를 켭니다(줌·도면 사라짐 문제 진단에 유용).
2. 로그 전달:

• 복사 — 전체 로그를 클립보드에 복사(메신저·메일에 붙여넣기).
• 저장 — hb-diag-…json 파일로 저장해 첨부.

1. 이전 세션 로그: 패널 하단의 이전 세션 로그를 펼치면, 직전에 새로고침/멈춤 직전의 로그까지 볼 수 있습니다(문제 직후 화면이 튕겼을 때 유용).

📷 [스크린샷: 진단 패널 — 레벨/태그 필터 + 복사/저장]

개발자용 (콘솔)

브라우저 개발자 콘솔에서 아래로도 전체 로그를 얻을 수 있습니다.

window.__hbDiag.dump()   // 전체 로그(이전+현재 세션)를 JSON 문자열로 반환

지원팀에 보낼 때 (권장 절차)

1. 문제를 재현한 직후 좌측 하단 버튼(또는 Ctrl+Shift+D)으로 진단을 엽니다.
2. 협업·커서·줌 문제라면 상세를 켭니다.
3. 복사 또는 저장으로 로그를 추출합니다(이전 세션 로그도 함께 포함됨).
4. 무엇을 하다가, 어떤 증상이 났는지 한두 줄 설명과 함께 로그를 지원팀에 전달합니다.

이렇게 보내 주시면 지원팀이 원인을 훨씬 빠르고 정확하게 찾을 수 있습니다.

앱에서 바로 의견·버그 보내기

앱 안에서 지원팀에 의견·버그를 바로 보낼 수 있습니다 — "제품에 바라는 점이나 불편한 점을 알려주세요. 매일 검토합니다."

• 어디서:

1. 에디터(도면 화면) 왼쪽 아래 말풍선 버튼(도움말·의견) → 도움말 / 의견 보내기 / 버그 신고 (스크린샷).
2. 대시보드 우상단 의견 보내기 버튼.

• 어떻게: 유형(기능 요청·버그 신고·기타 의견) 선택 → 제목(한 줄 요약) 입력 → 내용(선택) → 보내기. 「감사합니다!」가 뜨면 접수된 것입니다.
• 팁: 에디터에서 버그 신고 (스크린샷)로 열면 현재 도면 화면이 자동 캡처돼 미리보기로 붙습니다. 단, 캡처 이미지는 자동 전송되지 않으니 필요하면 이미지 저장으로 내려받아 전달 시 첨부하세요. 프로젝트를 연 채 보내면 그 프로젝트 정보가 함께 전달돼 재현 확인이 빨라집니다.
• 화면 멈춤·협업 문제처럼 원인 파악이 필요한 버그는 아래 세션 진단 로그(복사/저장)를 내용에 함께 붙여 주시면 처리가 훨씬 빠릅니다.

그래도 해결되지 않으면

• 11. FAQ에서 비슷한 질문을 확인하세요.
• 앱 안에서 의견 보내기 / 버그 신고 (스크린샷) 로 바로 알려주시거나(위 절 참조), 진단 로그(복사/저장)와 상황 설명을 지원팀에 전달하세요.