웹 문서/도면 미리보기 구현 가이드

Word (.doc, .docx) 미리보기 방식 비교

구현 방법	설명	장점 (Pros)	단점 (Cons)	라이선스 / 비용
docx-preview (npm 패키지) 현재 기본 적용됨	docx 이진 데이터를 읽어 브라우저 JS로 파싱하여 HTML/CSS로 그리기	순수 프론트엔드 작동 (서버 부하 없음) 워드 파일 서식 보존 수준 우수	구형 `.doc` 파일 감지 및 파싱 불가 일부 복잡한 다단, 도형 객체 깨짐	완전 무료 (MIT)
서버 PDF 변환 (LibreOffice) PDF로 보기 선택적용	서버 단에서 LibreOffice CLI로 PDF 변환 후 브라우저 PDF.js로 화면 표출	100% 보안 및 오프라인망 지원 다양한 오피스 파일 공통 규격 처리 가능	최초 변환 대기 시간 발생 (1~2초) 서버 자원 소모 및 변환 엔진 세팅 필요	완전 무료 (LGPLv3)
Microsoft Office Online Viewer	MS 뷰어 URL 주소에 파일 링크를 태워 iframe으로 임베드하는 방식	개발 공수 제로에 가까움 오리지널 서식 레이아웃 완벽 보존	외부 인터넷 연동 필수 (로컬 사용 불가) 사내 기밀 문서 외부 반출 보안 이슈	무료 (비상업용 제한)
Mammoth.js	docx 구조를 순수 HTML 스트링 텍스트로 가볍게 치환해 표출	매우 가볍고 렌더링 속도가 가장 빠름 본문 텍스트 추출 및 본문 검색에 유리	레이아웃 및 원본 스타일 대부분 유실 줄글 형태 이외의 디자인 요소 깨짐	완전 무료 (BSD)

Excel (.xls, .xlsx) 미리보기 방식 비교

구현 방법	설명	장점 (Pros)	단점 (Cons)	라이선스 / 비용
SheetJS (xlsx.js) + Luckysheet 현재 기본 적용됨	브라우저 JS로 엑셀 파일을 읽어 순수 HTML Table 및 Luckysheet 웹 엑셀 셀로 렌더링	완전한 클라이언트 독립 처리 (서버 연산 없음) 스프레드시트 형태에 유사하게 파싱하여 표출	복잡한 글꼴, 서식 일부 및 테두리 소실 우려 엑셀 내장형 차트 및 피벗 드로잉 불가	무료 (Community 에디션)
서버 PDF 변환 (LibreOffice) PDF로 보기 선택적용	서버 단에서 엑셀을 PDF/HTML로 변환하여 브라우저에 표시	보안 유출 없는 자체 서버 환경 구축 열 너비, 정밀 선 스타일 보존 우수	시트가 여러 개일 때 출력 용지 맞춤 조절 필요 인터랙션(필터링, 탭 편집) 불가	완전 무료 (LGPLv3)
Microsoft Office Online Viewer	MS 뷰어 URL 주소에 파일 링크를 태워 iframe으로 임베드하는 방식	시트 탭, 대용량 표, 차트 완벽 렌더링 수식 연산 결과 그대로 노출	인터넷 및 공인 URL 필수 사내 기밀 엑셀 데이터 반출 위험	무료 (비상업용 제한)
Handsontable	SheetJS 등 데이터 파서 결과와 연동해 엑셀 형태 그리드로 표출	가장 엑셀에 근접한 편집/뷰포트 UI 정렬, 필터, 다중 복사 기능 지원	단순 미리보기 뷰어 대비 오버스펙 라이선스 비용이 매우 높음	비영리만 무료 / 상업 유료

PPT (.ppt, .pptx) 미리보기 방식 비교

구현 방법	설명	장점 (Pros)	단점 (Cons)	라이선스 / 비용
서버 PDF 변환 + PDF.js 현재 기본 적용됨	서버 단에서 PPT를 PDF로 일체 변환 후 브라우저에 임베딩 렌더링	자체 사내망 보안 완벽 보존 (100% 로컬) 슬라이드 레이아웃 훼손 없는 완벽한 품질 열람 페이지 점프 및 반응형 뷰어 연동	최초 요청 시 PDF 변환 연산 시간 필요 전환 애니메이션 및 동영상 등 미디어 소실	완전 무료 (LGPLv3)
Microsoft Office Online Viewer	MS 뷰어 URL 주소에 파일 링크를 태워 iframe으로 임베드하는 방식	슬라이드 애니메이션 효과 지원 도형, 그림, 차트 레이아웃 100% 보존	인터넷 및 공인 URL 필수 대용량 도표가 포함된 발표 기밀 반출 위험	무료 (비상업용 제한)
PptxGenJS 역파싱 / PPTXjs	pptx 압축을 풀어 XML 벡터 데이터를 해석해 Canvas/SVG로 드로잉	서버 전처리 없이 프론트 브라우저 드로잉	조금만 복잡한 도형, 스마트아트 깨짐 매우 심함 글꼴 폰트 밀림으로 텍스트 겹침 다수 발생	완전 무료 (오픈소스)

한글 (.hwp, .hwpx) 미리보기 방식 비교

현재 한글 미리보기 적용 형태: 현재 PM 시스템에는 hwp.js 기반의 직접 렌더링 방식이 프론트엔드에 기본 탑재되어 있으며, 오피스 파일 공통으로 "PDF로 보기" 버튼을 제공하여 백엔드의 LibreOffice 엔진으로 변환하여 정밀하게 볼 수도 있도록 이중 구성(Hybrid)되어 있습니다.

구현 방법	설명	장점 (Pros)	단점 (Cons)	라이선스 / 비용
hwp.js (오픈소스 파서) 현재 기본 적용됨	오픈소스 HWP 바이너리 파서를 활용하여 브라우저에서 HTML5 객체화	서버 거치지 않아 즉시 로딩 완전한 오프라인/폐쇄망 무료 사용	정밀한 표 테두리, 수식 개체 스타일 일부 깨짐 신형 규격인 `.hwpx` 파싱력 아직 불안정	완전 무료 (MIT)
서버 LibreOffice (Linux / Windows) PDF로 보기 선택적용	리눅스 등 무료 백엔드 서버에서 LibreOffice 내장 변환 필터로 PDF 변환	추가 하드웨어 및 OS 제약 없음 최근 규격인 `.hwpx`는 꽤 준수하게 변환	구형 `.hwp`의 경우 폰트/표 틀어짐 가능성 있음 서버에 나눔 폰트 등 전용 한글 폰트 사전 설치 필수	완전 무료 (LGPLv3)
한컴 공식 클라우드 뷰어 API	한글과컴퓨터 공식 API 서버를 거쳐 문서 미리보기를 HTML로 획득	한글 문서 원본과 100% 일치하는 퀄리티	고가의 연간 이용요금 발생 외부 클라우드 통신 및 계약 절차 번거로움	유료 (계약 및 과금)
서버 한글 프로그램 (Windows 서버)	Windows 서버 환경에 한글 패키지 설치 후 백그라운드 CLI로 PDF 인쇄	안정적인 고품질 한글 PDF 변환 가능	서버가 Windows 환경으로 강제 제한됨 상업용 한글 오피스 구매 라이선스 비용	Windows 라이선스 / 한컴 비용

CAD (.dwg, .dxf) 미리보기 방식 비교

구현 방법	설명	장점 (Pros)	단점 (Cons)	라이선스 / 비용
서버 이미지/PDF 변환 (QCAD 등) 현재 기본 적용됨	백엔드 서버 내의 변환 필터를 거쳐 DWG/DXF 캐드 파일을 PDF로 강제 변환 후 브라우저에 PDF.js로 표출	보안 및 오프라인 지원: 도면의 외부 반출 원천 차단 SHX 한글 캐드 폰트 세팅 시 치수 및 글자 깨짐 없음	도면 렌더링에 따른 백엔드 서버 부하 도면 레이어 제어 불가능 (고정된 평면 PDF 형태)	무료 (단, 기업 라이선스 체크)
dxf-parser + Three.js / Canvas	DXF 아스키 텍스트 데이터를 분석해 브라우저 3D/2D Canvas로 직접 드로잉	인터랙티브 휠 줌/인/아웃, 팬(이동) 가능 도면 레이어 On/Off 제어 스위치 구현 가능	이진 파일인 `.dwg` 직접 파싱 불가 대형 설계 도면 로드 시 브라우저 연산 렉 유발 한글/설계 폰트 유실 시 텍스트 위치 틀어짐	완전 무료 (MIT)
Autodesk Platform Services (APS)	오토캐드 공식 클라우드 뷰어 API를 iframe으로 웹 포털에 삽입	설계 도면을 왜곡 없이 100% 완벽히 렌더링 치수 측정, 단면 추출, 3D 단면 분해 제공	종량제 기반의 API 요금 발생 기밀 도면 설계 자산 유출 우려	유료 (사용량 종량제 과금)

💡 사내 시스템 개발을 위한 최적의 조합 (Best Practice)

1순위: 자체 서버 PDF 선변환 방식

대상: Word, Excel, PPT, HWP, CAD 공통
설명: LibreOffice + QCAD 변환 엔진을 사내 서버에 탑재하고, 파일이 업로드되는 즉시 백그라운드에서 PDF로 변환을 완료해 저장해 둡니다. 사용자가 열람 시 이미 변환된 PDF를 PDF.js로 보여주므로 대기 시간 0초에 완벽한 사내 보안을 달성하는 실무상 가장 검증된 안전한 구성입니다.

2순위: 설치형 OnlyOffice 서버 도입

대상: MS Office 파일군 (Word, Excel, PPT)
설명: 사내 인프라(Docker 등)에 무료 오픈소스인 OnlyOffice Document Server를 1대 개설하여 iframe으로 연동합니다. 변환 대기 시간 없이 오리지널 수준의 재현력을 자랑하며, 웹 상에서 직접 편집 및 문서 다중 협업 기능까지 추가할 수 있는 중대형 인트라넷을 위한 최고급 구성입니다.