확장 가능한 Zoho CRM 위젯 개발 프레임워크
Zoho CRM 컨설팅 팀은 각 확장을 위한 프로젝트 스캐폴딩을 중복 생성하지 않고 여러 사용자 정의 CRM 위젯을 구축, 테스트 및 배포할 수 있는 확장 가능한 프레임워크가 필요했습니다.
프로젝트 상담하기
과제
Zoho CRM 위젯 구축은 반복적이고 파편화되어 있었습니다.
- 각 위젯은 자체 프로젝트 구조, manifest 및 빌드 설정을 필요로 했습니다.
- 위젯 간에 공유되는 유틸리티나 구성 요소가 없었습니다.
- 로컬 개발 시 CRM SDK 호환성을 위해 수동 HTTPS 서버 설정이 필요했습니다.
- 배포를 위한 위젯 패키징은 수동 ZIP 생성을 수반했습니다.
- 새 위젯을 추가하는 것은 기존 프로젝트의 boilerplate를 중복 생성하는 것을 의미했습니다.
우리의 솔루션
저희는 공유 유틸리티, 자동화된 scaffolding, 로컬 HTTPS 개발 서버 및 한 번의 명령으로 빌드 패키징이 가능한 다중 위젯 워크스페이스 프레임워크를 구축했습니다.
아키텍처
- Widget Apps: 공유 워크스페이스에 구성된 개별 위젯 소스
- Shared Utilities: 모든 위젯이 접근할 수 있는 공통 코드
- Dev Server: 로컬 CRM SDK 테스트를 위한 자체 서명 인증서가 있는 HTTPS 서버
- Build System: 위젯별 ZIP 패키징을 위한 자동화된 스크립트
- Scaffolding: 템플릿에서 새 위젯 boilerplate를 생성하는 CLI 도구
- Manifest: 모든 위젯 선언을 위한 중앙 집중식 manifest
개발 워크플로우
- Scaffold — scaffolding 도구를 실행하여 모든 boilerplate를 포함한 새 위젯 생성
- Develop — HTTPS 개발 서버를 사용하여 위젯 HTML/JS 편집, CRM 샌드박스에서 실시간 테스트
- Test — Zoho Embedded App SDK를 통해 CRM 샌드박스에 위젯 로드
- Build — 패키징 스크립트가 배포 가능한 ZIP 아티팩트 생성
- Deploy — Zoho CRM Extension 파이프라인에 ZIP 업로드
위젯 기능
이 프레임워크는 다음을 포함한 다양한 CRM 모듈에 내장된 위젯을 구축하는 데 사용되었습니다.
- 액션 트리거용 버튼 위젯 (템플릿 전송, 워크플로우 실행)
- 아코디언/리스트 UI로 관련 레코드를 표시하는 데이터 디스플레이 위젯
- CRM을 외부 microservices와 연결하는 통합 위젯
- CRM 레코드 교차 참조를 위한 쿼리 기능을 갖춘 위젯
주요 기능
- Multi-Widget Workspace — 공유 종속성을 가진 단일 프로젝트 내의 모든 위젯
- Automated Scaffolding — 한 번의 명령으로 템플릿에서 새 위젯 생성
- HTTPS Dev Server — CRM SDK 호환성을 통한 로컬 테스트
- One-Command Build — 위젯별 자동화된 ZIP 패키징
- Shared Code — 모든 위젯에서 사용 가능한 공통 유틸리티
- i18n Support — 다국어 위젯을 위한 국제화 통합
- Centralized Manifest — 모든 위젯 메타데이터를 위한 단일 구성
결과
기술 스택
caseStudyDetail.more 사례 연구
더 많은 기술 구현 사례를 살펴보세요
자주 묻는 질문
MicrocosmWorks는 재사용 가능한 위젯 개발 프레임워크를 개발했습니다. 이 프레임워크는 공유 인증, 데이터 가져오기, 상태 관리 및 UI 구성 요소를 제공하여 새로운 Zoho CRM 위젯을 몇 주가 아닌 며칠 만에 구축할 수 있도록 합니다. 프레임워크가 없으면 각 위젯은 중복된 상용구 코드, 일관성 없는 오류 처리 및 상이한 사용자 인터페이스를 가지며 독립적으로 개발됩니다. 이는 위젯 포트폴리오가 3~4개를 넘어서면서 유지보수 부담이 됩니다.
MicrocosmWorks는 프레임워크 내에 중앙 집중식 인증 모듈을 구축했습니다. 이 모듈은 Zoho CRM SDK 초기화, OAuth 토큰 관리, 그리고 자동 재시도 및 오류 처리 기능을 갖춘 API 호출 래핑을 담당합니다. 위젯 개발자는 단순히 인증 모듈을 가져와서 타입이 지정된 API 메서드를 호출함으로써, 토큰 새로 고침, 연결 범위 지정, 또는 Zoho CRM의 임베디드 위젯 환경에서 발생하는 다양한 인증 예외(edge case)를 처리할 필요가 없습니다.
예, MicrocosmWorks는 다양한 CRM 모듈에 걸쳐 필드 접근을 정규화하는 module-agnostic 데이터 어댑터로 프레임워크를 설계했습니다. 따라서 단일 위젯 코드베이스는 적절한 필드 매핑과 함께 Leads, Contacts, Deals 또는 사용자 정의 모듈 상세 페이지에서 렌더링될 수 있습니다. 프레임워크는 실행 중인 모듈 컨텍스트를 감지하고 코드 변경 대신 구성 레이어를 통해 데이터 쿼리 및 표시 로직을 자동으로 조정합니다.
MicrocosmWorks는 개발, 스테이징 및 프로덕션 Zoho 인스턴스를 위한 환경별 구성과 함께 위젯을 Zoho CRM 확장 기능으로 빌드, 테스트 및 패키징하는 CI/CD 파이프라인을 구현했습니다. 해당 프레임워크에는 배포 중에 여러 위젯 버전이 공존할 수 있도록 하는 버전 관리 시스템이 포함되어 있으며, 관리자는 프레임워크의 관리 인터페이스에서 간단한 토글을 통해 사용자 그룹별로 활성화할 버전을 제어할 수 있습니다.
MicrocosmWorks는 Zoho CRM 위젯 프레임워크를 시간당 $15-$35의 요율로 구축하며, 초기 프레임워크 투자는 일반적으로 2-3개의 개별 위젯을 구축하는 비용과 동일합니다. 프레임워크는 네 번째 위젯부터 비용 효율성을 발휘하는데, 그 이유는 각 후속 위젯이 공유 인프라를 활용하여 처음부터 구축하는 것에 비해 개발 시간을 60-70% 절약하기 때문입니다. 이는 CRM 기능을 확장하는 데 드는 지속적인 비용을 크게 절감합니다.