많은 팀의 기업위챗(WeCom) 개발은 처음부터 새 시스템을 만드는 것이 아니라, 더 흔하고 현실적인 시나리오를 마주합니다. 업무 시스템이 이미 존재하고 수년간 운영 중인 경우입니다. 근태 모듈은 이미 오픈되었고, 결재 흐름은 Activiti 기반으로 회람(전원 승인), 또는결재(아무 1명 승인), 조직도 기반 단계별 결재 등 복잡한 프로세스를 구현했으며, 결재 과정에서 근태 데이터를 재조회하고 연동합니다. 이제 요구사항은 이 시스템을 WeCom으로 가져와, 직원이 WeCom 워크벤치에서 열기만 하면 바로 사용할 수 있게 하는 것입니다. 다시 아이디와 비밀번호를 입력할 필요 없이, 들어가면 바로 자신의 근태 현황과 결재 대기 태스크가 보여야 합니다.

이러한 전제에서 H5 앱 방식은 미니프로그램보다 적합한 선택인 경우가 많습니다. 기존 시스템 자체가 Angular + SpringBoot 웹 아키텍처이므로, H5는 프런트엔드 페이지와 백엔드 API를 그대로 재사용할 수 있고, WeCom OAuth2 웹 인가(snsapi_base)와 결합하면 완전히 조용한 자동 로그인(SSO)을 구현할 수 있습니다. 배포 즉시 적용되고 심사와 릴리스가 필요 없으며, 결재 양식이 자주 바뀔 때 반복 비용이 가장 낮습니다.

이 글은 「기존 근태 관리 시스템 + Activiti 복잡 결재 흐름」을 배경으로 H5 방식을 중심 축으로 설명합니다. 업무 시스템을 다시 작성하지 않고 WeCom 연동을 완료하는 방법을 체계적으로 다루며, OAuth2 무소음 자동 로그인의 전체 경로, WeCom 계정과 시스템 계정의 바인딩 매핑, JS-SDK 디바이스 기능 호출, 그리고 Activiti 회람/또는결재/조직도 결재와 근태 연동을 WeCom에서 구현하는 방법(결재 대기 태스크 푸시, 카드 원클릭 결재, 조직도 동기화)을 중점적으로 분석합니다.