Feature: Electron ADR 대시보드와 SQL 저장소 활용 검토 #57

문제

ADR가 늘어나면 Markdown 인덱스와 정적 Mermaid/SVG 그래프만으로 전체 현황, 상태 변화, 관계, 예외·위반 지표를 한눈에 파악하기 어렵다. 검색·집계가 복잡해질 때 파일 기반 조회만으로 충분한지도 검토할 필요가 있다.

사용 사례

• 팀이 Grafana와 비슷한 화면에서 ADR의 상태·태그·담당 영역·관계·변경 추이를 필터링하며 탐색한다.
• 의사결정 리드타임, 리뷰 지연, supersession, 미해결 위반, 예외 기간 등의 지표를 확인한다.
• 여러 저장소의 ADR을 통합해서 검색하고 관계를 살펴본다.

검토할 방향

1. 시각화: 기존 index의 Mermaid 그래프와 graph의 SVG를 출발점으로, 우선 단일 저장소용 대화형 HTML 뷰어가 필요한지 검증한다. 운영 지표까지 필요하면 별도 대시보드 또는 Grafana 연동을 비교한다.
2. 저장소: Markdown + Git을 원본으로 유지하고 SQLite 등 SQL DB를 재생성 가능한 조회용 인덱스로 쓰는 방식과, SQL을 원본 저장소로 전환하는 방식을 비교한다. 동기화, PR 리뷰·diff, 이식성, 백업, 스키마 변경, 오프라인 사용 비용을 포함한다.
3. 데이터: 현재 ADR frontmatter와 adoption_metrics.py의 JSON 출력만으로 어떤 화면과 지표를 만들 수 있는지 확인한다. 시계열에 필요한 이벤트가 빠져 있다면 수집 계약을 먼저 정의한다.

완료 기준

• 실제 사용자 시나리오와 필요한 화면·지표의 우선순위를 정리한다.
• 정적/단일 HTML 뷰어, Grafana 연동, 별도 웹 대시보드의 비용과 이점을 비교한다.
• Markdown 원본 + SQL 조회 인덱스와 SQL 원본 저장 방식의 장단점 및 데이터 동기화·마이그레이션 방안을 비교한다.
• 측정 가능한 도입 조건과 첫 구현 범위를 제안한다. 이 이슈 자체는 저장 방식 변경을 확정하지 않는다.

현재 맥락

• README.md는 ADR를 docs/decisions/*.md와 Git에 보관하고 검색·인덱스를 제공한다고 설명한다.
• adr.py graph는 Mermaid/SVG를 내보내고, improvements.md에는 대화형 HTML 그래프 뷰어가 열려 있다.
• project-roadmap.md에는 중앙 웹 뷰어와 여러 저장소의 의사결정 탐색이 장기 항목으로 있다.
• scripts/adoption_metrics.py는 지표를 JSON으로 출력한다.

사용자 요구 구체화 (2026-10-11)

• Electron 데스크톱 앱으로 ADR 대시보드를 제공하고 macOS(Apple Silicon·Intel)와 Windows에서 사용할 수 있게 한다.
• 현재 Markdown 파일 목록과 정적 Mermaid 의존성/관계 그래프보다 탐색하기 쉬운 화면을 만든다. 그래프의 노드·연결을 눌러 관련 ADR과 상세 내용으로 이동하고, 대체(supersedes) 흐름과 영향 범위를 파악할 수 있게 한다.
• 키워드 검색, 태그(해시태그)·상태·영향 경로 필터, 인덱스 및 트리형 탐색을 제공한다. 저장소/영역/태그/관계 중 어떤 축이 트리의 기준이 될지는 실제 사용 사례로 결정한다.
• Grafana처럼 현황을 깊이 파악할 수 있는 요약 화면을 목표로 하되, 보여줄 지표와 시계열 데이터의 근거·수집 방식을 먼저 정의한다.
• 첫 구현에서는 로컬 단일 저장소의 읽기 전용 탐색 화면을 기본 범위 후보로 검토한다. ADR 작성·상태 변경, 여러 저장소 통합, SQL 원본 전환은 별도 설계 결정으로 다룬다.
• 기존 Python CLI의 검색·관계 해석과 Electron 앱 사이의 데이터 계약을 정해 같은 규칙이 두 곳에서 어긋나지 않도록 한다.