viewer.runHelp / FAQ
viewer.run 도움말
DXF/CAD 도면을 브라우저에서 열고, 서버 파일로 관리하고, 권한과 감사 로그를 기반으로 운영하는 방법을 정리했습니다. 처음 사용하는 사용자는 빠른 시작부터 확인하면 됩니다.
Quick Start
빠른 시작
Workflow
주요 사용 흐름
로컬 DXF 열기
파일 열기 버튼이나 drag & drop으로 DXF를 선택합니다. 여러 파일을 선택하면 도면 목록에서 전환할 수 있습니다.
원격 URL 불러오기
URL 입력 후 Enter 또는 URL 열기를 사용합니다. 세미콜론으로 구분한 다중 URL도 지원합니다.
서버 파일 관리
로그인 사용자는 /files에서 업로드, 검색, 즐겨찾기, 상세 확인, 다운로드, 삭제/복구를 사용할 수 있습니다. 서버 파일은 업로드와 버전 업로드 후 CAD 원본 분석 결과를 함께 저장합니다.
도면 검토
레이어 on/off, 검색, 그룹 표시, 미니맵, 확대/축소/화면 맞추기, 회전으로 필요한 영역을 확인합니다.
측정
측정 모드를 켜고 도면 위 점을 선택해 거리와 면적 검토 흐름을 사용할 수 있습니다.
내보내기
현재 화면을 PNG로 저장하거나 원본 DXF를 다운로드할 수 있습니다. PDF는 브라우저 인쇄 기능을 사용합니다.
권한과 보안
- 공개 도면 열람 화면은 로그인 없이 사용할 수 있습니다.
- 서버 파일 목록, 상세, 다운로드, 권한 관리는 로그인과 파일 권한이 필요합니다.
- 관리자는 전체 파일과 사용자 상태, 실패 이력, 감사 로그를 확인할 수 있습니다.
- 중요 API는 rate limit, 업로드 검증, 보안 헤더 정책을 적용합니다.
문제 해결
- 도면이 보이지 않으면 먼저 화면 맞추기 버튼을 누르고, 인코딩을 utf-8 또는 cp949로 바꿔 다시 확인합니다.
- 원격 URL은 서버에서 접근 가능해야 하며, 대상 서버가 다운로드를 차단하면 열리지 않을 수 있습니다.
- 서버 업로드는 .dxf 확장자, 파일 크기, DXF SECTION signature 검증을 통과해야 합니다.
- 로그인 후에도 파일이 보이지 않으면 파일 소유자 또는 관리자에게 권한을 요청합니다.
- 회원가입에서 데이터베이스 마이그레이션 메시지가 나오면 운영자가 Prisma migration을 적용해야 합니다.
DXF 뷰어 단축키
- Ctrl/Cmd+Z: 마지막 레이어·측정·마크업·비교·표시 작업 실행 취소
- Ctrl/Cmd+Shift+Z 또는 Ctrl/Cmd+Y: 다시 실행
- ESC: 선택·작성 작업 또는 열린 dialog 종료
- 입력창, select와 textarea에 포커스가 있으면 undo/redo 단축키가 실행되지 않습니다.
FAQ
자주 묻는 질문
로그인 없이 도면을 열 수 있나요?
네. 로컬 파일은 브라우저에서 바로 열 수 있습니다. 서버 파일 관리, 즐겨찾기, 권한 기능은 로그인이 필요합니다.
어떤 CAD 파일 형식을 지원하나요?
DXF 파일을 기본 지원합니다. 서버 파일은 DXF 버전, bounds, 엔티티/레이어 분포, 주의 엔티티, SHX/폰트 매핑을 자동 분석합니다. simplex/txt/romans/whgtxt 계열은 SHX stroke 렌더링 기반을 판정하고, 미지원 glyph와 폰트는 기존 fallback으로 표시합니다. DWG는 운영 서버의 외부 변환기가 설정된 경우 DXF로 변환하며, 원본 DWG header probe와 기준 DXF diff로 결과를 검증합니다.
3종 데스크톱 뷰어는 어떻게 다르나요?
Pro Dark는 고밀도 CAD 작업, Modern Light는 밝은 검토 화면, Minimal Focus는 도면 몰입 확인에 맞춘 화면입니다.
PDF로 저장할 수 있나요?
서버에 저장된 도면은 일반·벡터·타일 PDF를 직접 생성할 수 있습니다. 로컬에서 연 파일은 브라우저 인쇄 대화상자의 PDF 저장을 사용합니다.
관리자는 무엇을 확인할 수 있나요?
관리자는 사용자 상태, 파일 소유자, 권한, 감사 로그, 실패 이력, 운영 알림과 telemetry 요약을 확인할 수 있습니다.