@axboot-mcp/mcp-server 1.0.0

package/src/handlers/suggest-layout.ts

@@ -0,0 +1,326 @@
+import { analyzeInterface } from './analyze.js';
+import { NH_LAYOUT_PATTERNS, getNHLayoutPattern } from '../config/nh-layout-patterns.js';
+
+/**
+ * 레이아웃 매칭 점수 결과
+ */
+export interface LayoutMatch {
+  layoutType: string;
+  layoutName: string;
+  matchScore: number;
+  matchReasons: string[];
+}
+
+/**
+ * 레이아웃 추천 결과
+ */
+export interface LayoutSuggestionResult {
+  success: boolean;
+  repositoryInfo: {
+    className: string;
+    serviceName: string;
+    methodCount: number;
+    methods: Array<{
+      name: string;
+      description: string;
+    }>;
+  };
+  analysis: {
+    hasTreeMethods: boolean;
+    hasListMethods: boolean;
+    hasDetailMethods: boolean;
+    hasSaveMethods: boolean;
+    hasDeleteMethods: boolean;
+    hasSummaryMethods: boolean;
+    hasStatMethods: boolean;
+    listMethodCount: number;
+    hasMultipleLists: boolean;
+    methodNames: string[];
+  };
+  suggestions: LayoutMatch[];
+  topRecommendation?: LayoutMatch;
+}
+
+/**
+ * Repository 분석 결과 기반 NH 레이아웃 패턴 추천
+ */
+export async function suggestLayout(args: {
+  interfacePath: string;
+}): Promise<{
+  content: Array<{ type: string; text: string }>;
+}> {
+  const { interfacePath } = args;
+
+  try {
+    // 1. Repository 분석
+    const analyzeResult = await analyzeInterface({ interfacePath });
+    const analyzeData = JSON.parse(analyzeResult.content[0].text);
+
+    if (!analyzeData.success) {
+      return {
+        content: [
+          {
+            type: 'text',
+            text: JSON.stringify({
+              success: false,
+              error: analyzeData.error || 'Repository 분석 실패',
+            }),
+          },
+        ],
+      };
+    }
+
+    // 2. Repository 특징 분석
+    const analysis = analyzeRepository(analyzeData);
+
+    // 3. 각 레이아웃 패턴과 매칭
+    const suggestions = matchLayoutPatterns(analysis);
+
+    // 4. 상위 추천 선택
+    const topRecommendation = suggestions.length > 0 ? suggestions[0] : undefined;
+
+    // 5. 결과 반환
+    const result: LayoutSuggestionResult = {
+      success: true,
+      repositoryInfo: {
+        className: analyzeData.className,
+        serviceName: analyzeData.serviceName,
+        methodCount: analyzeData.methods.length,
+        methods: analyzeData.methods.map((m: any) => ({
+          name: m.name,
+          description: m.description || '',
+        })),
+      },
+      analysis,
+      suggestions,
+      topRecommendation,
+    };
+
+    return {
+      content: [
+        {
+          type: 'text',
+          text: JSON.stringify(result, null, 2),
+        },
+      ],
+    };
+  } catch (error) {
+    return {
+      content: [
+        {
+          type: 'text',
+          text: JSON.stringify({
+            success: false,
+            error: error instanceof Error ? error.message : String(error),
+          }),
+        },
+      ],
+    };
+  }
+}
+
+/**
+ * Repository 특징 분석
+ */
+function analyzeRepository(analyzeData: any): LayoutSuggestionResult['analysis'] {
+  const methods = analyzeData.methods || [];
+
+  const methodNames = methods.map((m: any) => m.name?.toLowerCase() || '');
+
+  const listCount = methodNames.filter((n: string) => n.includes('list')).length;
+
+  return {
+    hasTreeMethods:
+      methodNames.some((n: string) => n.includes('tree')) || methodNames.some((n: string) => n.includes('node')),
+    hasListMethods: listCount > 0,
+    hasDetailMethods: methodNames.some((n: string) => n.includes('detail')),
+    hasSaveMethods: methodNames.some((n: string) => n.includes('save')) || methodNames.some((n: string) => n.includes('insert')),
+    hasDeleteMethods: methodNames.some((n: string) => n.includes('delete')) || methodNames.some((n: string) => n.includes('remove')),
+    hasSummaryMethods: methodNames.some((n: string) => n.includes('summary')),
+    hasStatMethods:
+      methodNames.some((n: string) => n.includes('stat')) ||
+      methodNames.some((n: string) => n.includes('dashboard')) ||
+      methodNames.some((n: string) => n.includes('chart')),
+    listMethodCount: listCount,
+    hasMultipleLists: listCount >= 2,
+    methodNames,
+  };
+}
+
+/**
+ * 레이아웃 패턴 매칭
+ */
+function matchLayoutPatterns(analysis: LayoutSuggestionResult['analysis']): LayoutMatch[] {
+  const matches: LayoutMatch[] = [];
+
+  // 각 레이아웃 패턴별 매칭 점수 계산
+  for (const [layoutType, layout] of Object.entries(NH_LAYOUT_PATTERNS)) {
+    const matchResult = calculateMatchScore(layoutType, layout, analysis);
+    matches.push(matchResult);
+  }
+
+  // 매칭 점수순 정렬
+  return matches.sort((a, b) => b.matchScore - a.matchScore);
+}
+
+/**
+ * 매칭 점수 계산
+ */
+function calculateMatchScore(
+  layoutType: string,
+  layout: { type: string; name: string; description: string },
+  analysis: LayoutSuggestionResult['analysis']
+): LayoutMatch {
+  let score = 0;
+  const reasons: string[] = [];
+
+  // LEFT_DETAIL_FORM: 트리 + 저장
+  if (layoutType === 'LEFT_DETAIL_FORM') {
+    if (analysis.hasTreeMethods) {
+      score += 10;
+      reasons.push('트리 메서드 감지됨');
+    }
+    if (analysis.hasSaveMethods) {
+      score += 5;
+      reasons.push('저장 메서드 감지됨');
+    }
+    if (analysis.hasListMethods && analysis.listMethodCount === 1) {
+      score += 3;
+      reasons.push('단일 목록 메서드');
+    }
+  }
+
+  // LEFT_DETAIL_LIST: 다중 목록 (좌-우 Master-Detail)
+  else if (layoutType === 'LEFT_DETAIL_LIST') {
+    if (analysis.hasMultipleLists) {
+      const listCount = analysis.listMethodCount;
+      if (listCount === 2) {
+        score += 12; // 2개의 list 메서드 = Master-Detail 패턴
+        reasons.push('2개의 목록 메서드 (Master-Detail 패턴)');
+      } else if (listCount >= 3) {
+        score += 10;
+        reasons.push('3개 이상의 목록 메서드');
+      } else {
+        score += 8;
+        reasons.push('다중 목록 메서드 감지됨');
+      }
+    }
+    if (analysis.hasDetailMethods) {
+      score += 5;
+      reasons.push('상세 메서드 감지됨');
+    }
+    // 그룹 관련 메서드가 있으면 추가 점수
+    if (analysis.methodNames.some((n: string) => n.includes('group'))) {
+      score += 3;
+      reasons.push('그룹 관련 메서드 감지됨 (Master)');
+    }
+  }
+
+  // MULTI_PANEL: 복잡한 다중 패널
+  else if (layoutType === 'MULTI_PANEL') {
+    if (analysis.hasMultipleLists && analysis.listMethodCount >= 3) {
+      score += 10;
+      reasons.push('3개 이상의 목록 메서드');
+    }
+    if (analysis.hasDetailMethods) {
+      score += 3;
+      reasons.push('상세 메서드 포함');
+    }
+    if (analysis.hasSaveMethods) {
+      score += 2;
+      reasons.push('저장 메서드 포함');
+    }
+  }
+
+  // LIST_DRAWER: 단일 목록 + 상세 (Drawer)
+  else if (layoutType === 'LIST_DRAWER') {
+    if (analysis.hasListMethods && analysis.listMethodCount === 1) {
+      score += 8;
+      reasons.push('단일 목록 메서드');
+    }
+    if (analysis.hasDetailMethods) {
+      score += 7;
+      reasons.push('상세 메서드 감지됨 (Drawer용)');
+    }
+    if (!analysis.hasSaveMethods) {
+      score += 2;
+      reasons.push('저장 메서드 없음 (조회 전용)');
+    }
+  }
+
+  // LIST_MODAL: 단일 목록 + CRUD (가장 일반적)
+  else if (layoutType === 'LIST_MODAL') {
+    if (analysis.hasListMethods && analysis.listMethodCount === 1) {
+      score += 7;
+      reasons.push('단일 목록 메서드');
+    }
+    if (analysis.hasSaveMethods) {
+      score += 5;
+      reasons.push('저장 메서드 감지됨');
+    }
+    if (analysis.hasDeleteMethods) {
+      score += 3;
+      reasons.push('삭제 메서드 감지됨');
+    }
+    // 기본 점수 (가장 일반적인 패턴)
+    score += 2;
+    reasons.push('가장 일반적인 패턴');
+  }
+
+  // TAB_BASED: 탭 기반
+  else if (layoutType === 'TAB_BASED') {
+    if (analysis.hasMultipleLists) {
+      score += 8;
+      reasons.push('다중 목록 (탭별)');
+    }
+    // 탭 관련 키워드는 메서드 이름으로 잘 안 나오므로 기본 점수 낮음
+    score += 1;
+  }
+
+  // LIST_SUMMARY: 목록 + 요약
+  else if (layoutType === 'LIST_SUMMARY') {
+    if (analysis.hasListMethods) {
+      score += 6;
+      reasons.push('목록 메서드 감지됨');
+    }
+    if (analysis.hasSummaryMethods || analysis.hasStatMethods) {
+      score += 8;
+      reasons.push('요약/통계 메서드 감지됨');
+    }
+  }
+
+  // DASHBOARD: 대시보드만
+  else if (layoutType === 'DASHBOARD') {
+    if (!analysis.hasListMethods) {
+      score += 10;
+      reasons.push('목록 메서드 없음');
+    }
+    if (analysis.hasStatMethods || analysis.hasSummaryMethods) {
+      score += 8;
+      reasons.push('통계/요약 메서드 감지됨');
+    }
+  }
+
+  // FORM_ONLY: 폼만
+  else if (layoutType === 'FORM_ONLY') {
+    if (!analysis.hasListMethods) {
+      score += 8;
+      reasons.push('목록 메서드 없음');
+    }
+    if (analysis.hasSaveMethods) {
+      score += 7;
+      reasons.push('저장 메서드만 존재');
+    }
+  }
+
+  // 점수 정규화 (0-100)
+  const maxScore = 20;
+  const normalizedScore = Math.min(100, Math.round((score / maxScore) * 100));
+
+  return {
+    layoutType: layout.type,
+    layoutName: layout.name,
+    matchScore: normalizedScore,
+    matchReasons: reasons.length > 0 ? reasons : ['기본 매칭'],
+  };
+}