Feature: ADR 시각화 대시보드와 SQL 저장소 활용 검토

[SHcommit]

문제

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으로 출력한다.