[Feature] 공통컴포넌트 구조화 카탈로그(JSON) 제공 — LLM·도구 연계용

[EricSeokgon]

배경 / 문제 정의

공통컴포넌트 정보(기능·의존성·버전·사용법)가 사람이 읽는 문서 형태로만 제공되어, LLM이나 자동화 도구가 기계적으로 조회·활용하기 어렵습니다. 그 결과 도구가 컴포넌트를 추천하거나 코드를 생성할 때 부정확합니다.

제안 내용

공통컴포넌트를 기계가 파싱 가능한 구조화 카탈로그(JSON/YAML)로 함께 제공합니다.

예시 스키마: id, name(ko/en), category(협업/보안/요소기술 등), summary, dependencies, minVersion, docUrl, usageSnippet(대표 호출 예시), relatedComponents.

{
  "id": "board",
  "name": { "ko": "게시판", "en": "Board" },
  "category": "collaboration",
  "summary": "일반/익명/사진 게시판 기능 제공",
  "minVersion": "v4.0",
  "docUrl": "/common-component/collaboration/board/",
  "dependencies": ["comment-management"],
  "usageSnippet": "..."
}

기대 효과

• LLM·IDE 확장·검색 도구가 컴포넌트를 정확히 조회·추천
• eGovFrame MCP Server의 get_component 도구가 직접 소비할 데이터 소스 확보
• 문서와 메타데이터의 단일 출처(Single Source) 유지

구현 아이디어

1. 대표 카테고리(협업/보안/요소기술)부터 카탈로그 스키마 확정
2. 기존 가이드 문서 front matter와 연계해 자동 생성 파이프라인 구성
3. CI에서 문서 변경 시 카탈로그 동기화