문제 해결

증상별 점검 순서와 막혔을 때 지원팀에 정확한 정보를 보내는 세션 진단(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에서 비슷한 질문을 확인하세요.
• 앱 안에서 의견 보내기 / 버그 신고 (스크린샷) 로 바로 알려주시거나(위 절 참조), 진단 로그(복사/저장)와 상황 설명을 지원팀에 전달하세요.