레거시 문서 보기 솔루션을 현대 저용량 SDK로 마이그레이션
현대적이고 안전하며 반응성이 뛰어난 문서 뷰어로 가는 가장 빠른 방법은 레거시 컴포넌트를 Doconut의 저용량 SDK로 교체하는 것입니다. Kendo UI를 사용하는 웹 포털의 경우, SDK는 빠른 렌더링, 완전한 접근성, 그리고 집중된 통합 경로를 제공합니다. 한때 데스크톱 전용 라이브러리나 외부 변환 서비스를 기반으로 맞춤형 뷰어를 조합하던 기업들은 곧 문제에 직면합니다: 유지보수 비용이 상승하고, 클라이언트 측 종속성이 취약해지며, 접근성이 무시됩니다. Doconut은 .NET 백엔드에서 직접 네이티브 PDF, Office, CAD 렌더링을 제공하면서 프런트엔드를 가볍게 유지하고 완전한 제어권을 제공합니다.
다음 섹션에서는 오래된 뷰어가 왜 위험 요소가 되는지, Doconut의 아키텍처가 이러한 문제점을 어떻게 해결하는지, 그리고 지금 바로 시작할 수 있는 실전 마이그레이션 로드맵을 살펴보겠습니다.
1. 레거시 뷰어: 익숙한 인터페이스 뒤에 숨은 비용
대부분의 “레거시” 문서 뷰어는 브라우저가 아직 플러그인, ActiveX 컨트롤, 혹은 서버에 무거운 Office 설치에 의존하던 시기에 탄생했습니다. 그 결과는 여러 형태로 나타납니다:
| 문제 | 실제 영향 |
|---|---|
| 클라이언트 측 종속성 | 사용자는 브라우저 플러그인을 설치하거나 활성화해야 하며, 기업 IT는 이를 차단해 워크플로가 중단됩니다. |
| 서버 측 Office 요구사항 | 웹 서버에 Microsoft Office를 설치하면 보안 모범 사례를 위반하고 라이선스 비용이 급증합니다. |
| 제한된 포맷 지원 | 새로운 CAD 또는 이미지 포맷(DWG, DXF, PNG)이 지원되지 않아 우회 방법이나 수동 변환이 필요합니다. |
| 확장성 병목 | 렌더링이 클라이언트 CPU에서 이루어지므로 대용량 PDF나 다페이지 Office 파일이 느려지거나 충돌합니다. |
| 접근성 격차 | 키보드 네비게이션, 스크린리더 지원, WCAG 준수 등이 사후에 고려되어 기업이 컴플라이언스 위험에 노출됩니다. |
| 유지보수 악몽 | 더 이상 업데이트되지 않는 벤더 SDK는 보안 위험이 되고, 패치마다 전체 재배포가 필요합니다. |
이러한 숨은 비용을 DMS, CRM 포털, 혹은 e‑learning 플랫폼과 같은 문서 중심 시스템에 추가하면 ROI가 급속히 사라집니다. 현대 기업은 클라이언트 플러그인에 의존하지 않고, Office 없이 실행되며, 서버에서 확장 가능한 뷰어가 필요합니다. Doconut이 바로 그 해답을 제공합니다.
2. 저용량 서버‑사이드 렌더링: 현대 앱을 위한 이상적인 PDF 뷰어 SDK
Doconut의 핵심 강점은 서버‑사이드 문서 렌더링 엔진에 있습니다. 이 엔진은 래스터 이미지를 브라우저로 스트리밍하여 클라이언트‑사이드 플러그인 필요성을 없앱니다. 아래는 위에서 언급한 과제와 아키텍처가 어떻게 맞물리는지 설명합니다:
a. 브라우저용 최소 클라이언트 풋프린트
- 뷰어는 HTML, CSS, 그리고 아주 적은 양의 JavaScript만 제공합니다. ActiveX, Flash, Silverlight 없이 표준 웹 자산만 지원되는 브라우저에 전달됩니다.
- 렌더링이 서버에서 이루어지므로 클라이언트는 .NET Desktop, Office, CAD 뷰어 등을 전혀 설치할 필요가 없습니다.
b. 포괄적인 포맷 지원
Doconut는 33개 이상의 포맷을 네이티브로 지원합니다. 여기에는 Office, PDF, CAD, 이메일, 이미지 카테고리의 DOC/DOCX, XLS/XLSX, PPT/PPTX, DWG, DXF, PNG, JPG 등이 포함돼 있어, 서드‑파티 변환기를 조합해야 하는 “파일‑타입‑갭”을 완전히 해소합니다.
c. 내장된 주석, 검색 및 제어된 인쇄
- 주석 플러그인 – 뷰어 내에서 하이라이트, 코멘트, 자유 손그림을 추가합니다.
- 검색 플러그인 – 전체 문서에 대한 즉시 텍스트 검색을 제공하며, 스캔 이미지에 대한 OCR도 지원합니다.
- 제어된 인쇄 – 뷰어 UI에서 인쇄 정책을 강제 적용해 무단 복사를 방지합니다.
d. Office‑프리 워크플로우를 위한 서버‑사이드 변환
변환 플러그인을 사용하면 Word, Excel, PowerPoint, CAD 파일을 서버에서 PDF, PNG, HTML 등으로 변환할 수 있습니다. Microsoft Office 설치 없이, 외부 SaaS 없이, 데이터가 방화벽을 떠나는 일도 없습니다.
e. 접근성 내장
Doconut는 WCAG 2.2 AA 가이드라인을 기본 제공합니다. 키보드 네비게이션, ARIA 라벨, 스크린리더 친화적인 마크업이 뷰어 HTML에 내장돼 있어, 기업의 접근성 정책을 별도 구현 없이 켜기만 하면 충족됩니다.
f. 현대 .NET 스택과의 원활한 통합
ASP.NET Core, .NET 6, 마이크로서비스 아키텍처 등 어느 환경이든 Doconut은 단일 미들웨어 호출만으로 요청 파이프라인에 삽입됩니다. 뷰어는 Kendo UI 컴포넌트나 지원되는 웹 프런트엔드와 손쉽게 결합됩니다.
3. 마이그레이션 청사진: 레거시에서 Doconut으로
아래는 기존 .NET 웹 애플리케이션에서 따라 할 수 있는 실용적인 단계별 마이그레이션 계획입니다. 목표는 기존 뷰어를 Doconut으로 교체하면서도 외부 API는 그대로 유지하는 것입니다.
단계 1: 환경 준비
- 솔루션에 Doconut NuGet 패키지를 추가합니다.
- 서버가 .NET 6(이상)에서 실행되는지 확인합니다. Doconut의 종속성 최적화는 최신 런타임에서 최적의 성능을 발휘합니다.
단계 2: Doconut 미들웨어 등록
ASP.NET 요청 파이프라인 초기에 Doconut 미들웨어를 삽입하여 문서 이미지 요청을 Doconut 엔진이 가로채고 처리하도록 합니다.
단계 3: 라이선스 로드
애플리케이션 시작 시 Doconut 라이선스 파일(또는 XML 문서)을 한 번 로드합니다. 주석 플러그인 등 플러그인별 라이선스가 있다면 해당 Doconut API를 사용해 로드합니다.
단계 4: 기존 렌더링 호출 교체
레거시 코드에서 비트맵이나 바이트 배열로 문서 페이지를 렌더링하는 부분을 찾아 Doconut의 문서 열기 흐름으로 교체합니다. 이 흐름은 열려 있는 문서를 나타내는 토큰을 반환하며, 토큰을 사용해 Doconut 이미지 제공 엔드포인트에서 페이지 이미지나 썸네일을 요청합니다.
단계 5: 주석 및 검색 활성화
기존 “댓글 추가” 혹은 “검색” 기능을 Doconut의 주석 및 검색 플러그인에 매핑합니다. 두 플러그인은 간단한 서버‑사이드 메서드로 JSON을 반환하므로 프런트엔드에서 바로 활용할 수 있습니다.
단계 6: 프런트엔드 통합 업데이트
Doconut은 렌더링된 이미지를 스트리밍하므로 프런트엔드에서는 페이지당 <img> 태그 또는 캔버스 기반 뷰어만 있으면 됩니다. Kendo UI를 사용하는 경우 이미지 URL을 Kendo Carousel에 바인딩해 부드러운 페이지 전환을 구현합니다.
단계 7: 테스트, 최적화, 배포
- 성능 – 첫 페이지까지의 시간을 측정합니다. Doconut의 서버‑사이드 래스터 렌더링은 일반 PDF에서 보통 1초 미만을 기록합니다.
- 보안 – 렌더링된 이미지 외에 문서 데이터가 클라이언트로 유출되지 않는지 검증합니다.
- 접근성 – 스크린리더 감사를 수행합니다. Doconut 마크업에 이미 ARIA 역할이 포함돼 있습니다.
테스트가 모두 통과하면 레거시 뷰어 라우트를 새로운 Doconut 엔드포인트로 교체하고 업데이트를 롤아웃합니다.
4. Doconut와 Kendo UI로 접근성 및 UX 향상
접근성은 이제 선택이 아니라 필수이며, 특히 의료, 금융, 공공 부문과 같은 규제 산업에서는 반드시 충족해야 합니다. Doconut의 즉시 사용 가능한 컴플라이언스 기능을 통해 별도 코딩 없이도 표준을 만족할 수 있습니다.
키보드 네비게이션
페이지 네비게이션, 확대/축소, 주석 도구 등 모든 인터랙티브 요소에 tabindex가 지정돼 있습니다. 사용자는 키보드만으로 문서를 탐색할 수 있어 Section 508 준수에 필수적입니다.
ARIA 라벨 및 스크린리더
뷰어 HTML에는 role="document"와 페이지 번호·확대 비율을 설명하는 aria-label이 포함돼 있어 보조 기술에 정보를 전달합니다. 별도 ARIA 스크립트를 추가할 필요가 없습니다.
고대비 모드
Doconut은 뷰어 인터페이스에서 사용자가 설정한 고대비 환경을 반영합니다. UI가 어두운 배경에 밝은 텍스트로 전환돼 시각 장애 사용자의 가독성을 높입니다.
Kendo UI와의 통합
Kendo UI의 접근성 위젯(kendoButton, kendoSlider 등)과 Doconut 이미지 렌더링을 결합하면, 전체 앱과 일관된 키보드‑네비게이션이 가능한 뷰어를 구현할 수 있습니다.
5. 미래 대비: 플러그인으로 뷰어 확장
Doconut의 모듈식 플러그인 아키텍처 덕분에 기본 뷰어만 사용하다가 비즈니스 요구가 확대될 때 추가 기능을 손쉽게 활성화할 수 있습니다.
| 플러그인 | 핵심 혜택 | 전형적인 엔터프라이즈 활용 |
|---|---|---|
| 주석 플러그인 | 하이라이트, 코멘트, 그리기 | 법률 검토, 엔지니어링 변경 주문 |
| 검색 플러그인 | 전체 텍스트, OCR 기반 검색 | 헬스케어 기록 조회, 금융 감사 |
| 변환 플러그인 | 서버‑사이드 Office → PDF/HTML | DMS 수집 파이프라인, 자동 보고 |
| 제어된 인쇄 | 인쇄 할당량, 워터마크 | 기밀 계약, 규제 문서 |
모든 플러그인이 서버에서 실행되므로 데이터 처리, 라이선스 관리, 스케일링을 중앙 집중식으로 제어할 수 있습니다. 새로운 플러그인을 추가하려면 라이선스를 로드하고 해당 API를 호출하면 되며, 프런트엔드 재컴파일은 전혀 필요하지 않습니다.
결론
문서 뷰어 스택을 현대화하는 데 비용이 많이 들고 위험 부담이 클 필요는 없습니다. Doconut의 저용량 서버‑사이드 렌더링 엔진을 도입하면 다음과 같은 이점을 얻을 수 있습니다:
- 외부 변환기 없이 광범위한 포맷 지원
- 컴플라이언스 요구를 충족하는 내장 주석, 검색 및 제어된 인쇄
- 바로 사용할 수 있는 엔터프라이즈 수준 접근성
- 기존 .NET 및 Kendo UI 프로젝트와의 원활한 통합
레거시 뷰어를 퇴출하고 사용자에게 더 빠르고 안전한 경험을 제공할 준비가 되셨나요? 오늘 바로 Doconut으로 마이그레이션을 시작하세요 – SDK를 다운로드하고, 마이그레이션 청사진을 따라 실행하면 몇 분 만에 차이를 확인할 수 있습니다.