이미 운영 중인 협업툴 flow에 엔터프라이즈 파일 관리 제품(드라이브)을 통합하는 프로젝트입니다. 워크스페이스 파일 첨부·미리보기, 외부 페이지 임베드용 파일 선택(File Picker) SDK, 정책 기반 권한, 한·영·일·스페인어 다국어를 목표로 했습니다.

가장 큰 제약은 기능이 아니라 정책이었습니다 — 기존 레거시 백엔드(WAS)는 한 줄도 변경하지 않고 게이트웨이 호출과 postMessage 프로토콜로만 통합해야 했습니다. 이 제약이 모든 통합 지점을 명시적인 계약으로 만들도록 강제했고, 결과적으로 결합도가 낮은 설계로 이어졌습니다.

미리보기 통일. 포맷마다 제각각이던 클라이언트 렌더러를 외부 문서 변환 뷰어(Synap)로 통일하고, 변환·조회 실패 시 네이티브 폴백을 두었습니다. 모바일 웹뷰에서 원본 저장(long-press)을 차단해야 하는 보안 요구가 이 선택을 이끌었습니다.

동영상 재생. 아이폰 HEVC/.MOV처럼 브라우저가 디코드하지 못하는 코덱은 ffprobe로 판별해 비호환 파일만 H.264로 서버 트랜스코딩하고, 첫 프레임을 포스터로 추출해 그리드 썸네일까지 복구했습니다.

썸네일 사전 생성. 모바일에서 무겁던 office·PDF 썸네일을 클라이언트 풀파싱에서 서버 사전 생성(동영상 poster와 평행한 BullMQ 워커)으로 옮겨 목록과 함께 즉시 뜨도록 구현하고, 미설정 환경에서는 클라이언트 렌더로 폴백하게 했습니다.

전문 검색. 별도 검색 엔진 없이 PostgreSQL 전문검색(FTS)과 trigram(pg_trgm) 하이브리드로 한국어 부분 검색까지 지원하고, 접근 권한은 RECURSIVE CTE로 일괄 필터링했습니다.

파일 버전관리. 최신본과 과거 버전을 분리하는 head/history 모델로, 기존 읽기 경로 코드를 바꾸지 않고 버전 히스토리를 구현해 회귀 위험을 제거했습니다.

임베드 SDK. postMessage 프로토콜과 티켓 기반 SSO로 외부 페이지에 파일 선택기(File Picker)와 파일함을 임베드하고, 내 드라이브와 동일한 멀티셀렉·드래그 이동·일괄 작업 UX를 그대로 제공했습니다.

약 1개월이라는 짧은 기간에 미리보기·검색·버전관리·임베드·멀티테넌시를 아우르는 제품을 풀스택으로 구축하며, 속도만큼이나 안정성을 중요하게 다뤘습니다.

핵심은 스토리지(로컬↔S3)·검색·큐를 어댑터로 격리해 의존성 하나가 빠져도 동기 폴백·클라이언트 렌더 폴백으로 graceful하게 동작하도록 설계한 것입니다. 덕분에 외부 시스템(WAS) 무변경 제약 속에서도 기능을 점진적으로 통합하고 기능 플래그로 안전하게 롤아웃할 수 있었습니다.

운영 측면에서는 사용자 오류 제보를 분류·재현·수정까지 잇는 처리 파이프라인을 구축해 피드백 루프를 자동화했습니다.