Jira 이슈 링크 시각화와 자동 검증을 위한 OpenReq 플러그인

초록

본 논문은 대규모 Jira 프로젝트에서 이슈 간 의존성을 한눈에 파악하고, 누락·중복 링크를 자동으로 탐지하며, 릴리즈 계획과의 일관성을 검증하는 OpenReq Issue Link Map 플러그인을 소개한다. 그래프 기반 시각화, 텍스트 유사도·코멘트 크로스레퍼런스 기반 링크 추천, 제약 해결 엔진을 결합해 개발·관리자의 의사결정을 지원한다.

상세 분석

OpenReq Issue Link Map은 기존 Jira의 단일 이슈 페이지가 제공하는 1‑depth 링크 정보만을 보여주는 한계를 극복하기 위해 설계되었다. 전체 아키텍처는 프론트엔드 웹 UI와 백엔드 마이크로서비스 군으로 구성되며, 각 서비스는 ‘choreography’ 방식으로 비동기적으로 협업한다. 핵심 서비스는 (1) 링크 그래프 생성 서비스로, 모든 이슈와 그들의 링크를 실시간 그래프 구조로 유지해 빠른 탐색을 가능하게 한다. (2) 링크 탐지 서비스는 두 가지 서브모듈을 포함한다. 첫 번째는 제목·설명 텍스트를 TF‑IDF 혹은 임베딩 기반으로 비교해 중복(duplicate) 가능성을 판단한다. 두 번째는 이슈 코멘트 내에 다른 이슈 번호가 언급되는지를 정규식으로 추출해 ‘잠재적 링크’를 제안한다. 이러한 탐지는 오픈소스 프로젝트처럼 링크 생성 권한이 제한된 환경에서도 사용자가 직접 링크를 만들지 않아도 자동으로 후보를 제공한다는 장점이 있다. (3) 일관성 검사기는 릴리즈 플래닝 제약을 수학적 제약식으로 모델링한다. 하위 이슈는 상위 이슈와 동일하거나 높은 우선순위를 가져야 하며, 더 늦은 릴리즈에 배정될 수 없고, 필수(dependency) 관계에 있는 이슈는 선행 릴리즈에 포함돼야 한다. 또한 중복 이슈는 원본 이슈의 모든 링크를 자동 상속한다. 제약 해결은 SAT/SMT 솔버를 활용해 빠르게 위배 여부를 판단한다. UI 측면에서 사용자는 좌측 그래프에서 깊이(depth)를 조절해 원하는 범위의 이슈 맵을 시각화하고, 우측 패널에서 선택 이슈의 메타데이터와 함께 ‘링크 탐지’·‘일관성 검사’ 탭을 전환한다. 탐지 결과는 5개의 추천 링크를 리스트 형태로 제시하고, 사용자는 각각 수락·거부와 링크 유형을 지정한다. 일관성 검사 결과는 위배된 제약과 해당 이슈·릴리즈를 강조해 보여준다. 현재 Qt Company의 112 k 이슈 중 27 k에 링크가 존재하고, 평균 24 k개의 링크가 실시간으로 관리되는 환경에서 파일럿 테스트가 진행 중이며, 초기 사용자는 복잡한 의존 관계를 시각적으로 파악하고 중복 이슈를 빠르게 식별하는 데 긍정적인 반응을 보였다. 한계점으로는 텍스트 기반 중복 탐지의 정확도가 아직 낮으며, 대규모 그래프에서 UI 렌더링 성능이 제한적이라는 점이 있다. 향후 작업에서는 사용자 피드백을 학습 데이터로 활용한 인간‑인‑루프(HITL) 방식으로 탐지 모델을 지속 개선하고, 위배 제약을 자동으로 수정하는 ‘자동 복구’ 기능을 추가할 계획이다. 전체적으로 이 도구는 시각화와 AI‑기반 추천·검증을 결합해 대규모 요구사항 관리의 인지 부하를 크게 낮추는 실용적 기여를 한다.