mirror of
https://github.com/hwanny1128/HGZero.git
synced 2026-06-13 01:19:11 +00:00
feat: Meeting Service AI 통합 개발
✅ 구현 완료 - AI Python Service (FastAPI, Claude API, 8087 포트) - POST /api/v1/transcripts/consolidate - 참석자별 회의록 → AI 통합 분석 - 키워드/안건별 요약/Todo 추출 - Meeting Service AI 통합 - EndMeetingService (@Primary) - AIServiceClient (RestTemplate, 30초 timeout) - AI 분석 결과 저장 (meeting_analysis, todos) - 회의 상태 COMPLETED 처리 - DTO 구조 (간소화) - ConsolidateRequest/Response - MeetingEndDTO - Todo 제목만 포함 (담당자/마감일 제거) 📝 기술스택 - Python: FastAPI, anthropic 0.71.0, psycopg2 - Java: Spring Boot, RestTemplate - Claude: claude-3-5-sonnet-20241022 🔧 주요 이슈 해결 - 포트 충돌: 8086(feature/stt-ai) → 8087(feat/meeting-ai) - Bean 충돌: @Primary 추가 - YAML 문법: ai.service.url 구조 수정 - anthropic 라이브러리 업그레이드 📚 테스트 가이드 및 스크립트 작성 - claude/MEETING-AI-TEST-GUIDE.md - test-meeting-ai.sh 🤖 Generated with Claude Code Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Minseo-Jo
@@ -0,0 +1,16 @@
|
||||
"""Data Models"""
|
||||
from .transcript import (
|
||||
ConsolidateRequest,
|
||||
ConsolidateResponse,
|
||||
AgendaSummary,
|
||||
ParticipantMinutes,
|
||||
ExtractedTodo
|
||||
)
|
||||
|
||||
__all__ = [
|
||||
"ConsolidateRequest",
|
||||
"ConsolidateResponse",
|
||||
"AgendaSummary",
|
||||
"ParticipantMinutes",
|
||||
"ExtractedTodo",
|
||||
]
|
||||
@@ -0,0 +1,69 @@
|
||||
"""Keyword Models"""
|
||||
from pydantic import BaseModel, Field
|
||||
from typing import List
|
||||
from datetime import datetime
|
||||
|
||||
|
||||
class KeywordExtractRequest(BaseModel):
|
||||
"""주요 키워드 추출 요청"""
|
||||
meeting_id: str = Field(..., description="회의 ID")
|
||||
transcript_text: str = Field(..., description="전체 회의록 텍스트")
|
||||
max_keywords: int = Field(default=10, ge=1, le=20, description="최대 키워드 개수")
|
||||
|
||||
class Config:
|
||||
json_schema_extra = {
|
||||
"example": {
|
||||
"meeting_id": "550e8400-e29b-41d4-a716-446655440000",
|
||||
"transcript_text": "안건 1: 신제품 기획...\n타겟 고객을 20-30대로 설정...",
|
||||
"max_keywords": 10
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
class ExtractedKeyword(BaseModel):
|
||||
"""추출된 키워드"""
|
||||
keyword: str = Field(..., description="키워드")
|
||||
relevance_score: float = Field(..., ge=0.0, le=1.0, description="관련성 점수")
|
||||
frequency: int = Field(..., description="출현 빈도")
|
||||
category: str = Field(..., description="카테고리 (예: 기술, 전략, 일정 등)")
|
||||
|
||||
class Config:
|
||||
json_schema_extra = {
|
||||
"example": {
|
||||
"keyword": "신제품기획",
|
||||
"relevance_score": 0.95,
|
||||
"frequency": 15,
|
||||
"category": "전략"
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
class KeywordExtractResponse(BaseModel):
|
||||
"""주요 키워드 추출 응답"""
|
||||
meeting_id: str = Field(..., description="회의 ID")
|
||||
keywords: List[ExtractedKeyword] = Field(..., description="추출된 키워드 목록")
|
||||
total_count: int = Field(..., description="전체 키워드 개수")
|
||||
extracted_at: datetime = Field(default_factory=datetime.utcnow, description="추출 시각")
|
||||
|
||||
class Config:
|
||||
json_schema_extra = {
|
||||
"example": {
|
||||
"meeting_id": "550e8400-e29b-41d4-a716-446655440000",
|
||||
"keywords": [
|
||||
{
|
||||
"keyword": "신제품기획",
|
||||
"relevance_score": 0.95,
|
||||
"frequency": 15,
|
||||
"category": "전략"
|
||||
},
|
||||
{
|
||||
"keyword": "예산편성",
|
||||
"relevance_score": 0.88,
|
||||
"frequency": 12,
|
||||
"category": "재무"
|
||||
}
|
||||
],
|
||||
"total_count": 10,
|
||||
"extracted_at": "2025-01-23T10:30:00Z"
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,80 @@
|
||||
"""Todo Models"""
|
||||
from pydantic import BaseModel, Field
|
||||
from typing import List, Optional
|
||||
from datetime import datetime, date
|
||||
from enum import Enum
|
||||
|
||||
|
||||
class PriorityLevel(str, Enum):
|
||||
"""우선순위"""
|
||||
HIGH = "HIGH"
|
||||
MEDIUM = "MEDIUM"
|
||||
LOW = "LOW"
|
||||
|
||||
|
||||
class TodoExtractRequest(BaseModel):
|
||||
"""Todo 자동 추출 요청"""
|
||||
meeting_id: str = Field(..., description="회의 ID")
|
||||
transcript_text: str = Field(..., description="전체 회의록 텍스트")
|
||||
participants: List[str] = Field(..., description="참석자 목록")
|
||||
|
||||
class Config:
|
||||
json_schema_extra = {
|
||||
"example": {
|
||||
"meeting_id": "550e8400-e29b-41d4-a716-446655440000",
|
||||
"transcript_text": "안건 1: 신제품 기획...\n결정사항: API 설계서는 박민수님이 1월 30일까지 작성...",
|
||||
"participants": ["김민준", "박서연", "이준호", "박민수"]
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
class ExtractedTodo(BaseModel):
|
||||
"""추출된 Todo"""
|
||||
title: str = Field(..., description="Todo 제목")
|
||||
description: Optional[str] = Field(None, description="상세 설명")
|
||||
assignee: str = Field(..., description="담당자 이름")
|
||||
due_date: Optional[date] = Field(None, description="마감일")
|
||||
priority: PriorityLevel = Field(default=PriorityLevel.MEDIUM, description="우선순위")
|
||||
section_reference: str = Field(..., description="섹션 참조 (예: '결정사항 #1')")
|
||||
confidence_score: float = Field(..., ge=0.0, le=1.0, description="신뢰도 점수")
|
||||
|
||||
class Config:
|
||||
json_schema_extra = {
|
||||
"example": {
|
||||
"title": "API 설계서 작성",
|
||||
"description": "신규 프로젝트 API 설계서 작성 완료",
|
||||
"assignee": "박민수",
|
||||
"due_date": "2025-01-30",
|
||||
"priority": "HIGH",
|
||||
"section_reference": "결정사항 #1",
|
||||
"confidence_score": 0.92
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
class TodoExtractResponse(BaseModel):
|
||||
"""Todo 자동 추출 응답"""
|
||||
meeting_id: str = Field(..., description="회의 ID")
|
||||
todos: List[ExtractedTodo] = Field(..., description="추출된 Todo 목록")
|
||||
total_count: int = Field(..., description="전체 Todo 개수")
|
||||
extracted_at: datetime = Field(default_factory=datetime.utcnow, description="추출 시각")
|
||||
|
||||
class Config:
|
||||
json_schema_extra = {
|
||||
"example": {
|
||||
"meeting_id": "550e8400-e29b-41d4-a716-446655440000",
|
||||
"todos": [
|
||||
{
|
||||
"title": "API 설계서 작성",
|
||||
"description": "신규 프로젝트 API 설계서 작성 완료",
|
||||
"assignee": "박민수",
|
||||
"due_date": "2025-01-30",
|
||||
"priority": "HIGH",
|
||||
"section_reference": "결정사항 #1",
|
||||
"confidence_score": 0.92
|
||||
}
|
||||
],
|
||||
"total_count": 5,
|
||||
"extracted_at": "2025-01-23T10:30:00Z"
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,44 @@
|
||||
"""Transcript Models"""
|
||||
from pydantic import BaseModel, Field
|
||||
from typing import List, Optional, Dict
|
||||
from datetime import datetime
|
||||
|
||||
|
||||
class ParticipantMinutes(BaseModel):
|
||||
"""참석자별 회의록"""
|
||||
user_id: str = Field(..., description="사용자 ID")
|
||||
user_name: str = Field(..., description="사용자 이름")
|
||||
content: str = Field(..., description="회의록 전체 내용 (MEMO 섹션)")
|
||||
|
||||
|
||||
class ConsolidateRequest(BaseModel):
|
||||
"""회의록 통합 요약 요청"""
|
||||
meeting_id: str = Field(..., description="회의 ID")
|
||||
participant_minutes: List[ParticipantMinutes] = Field(..., description="참석자별 회의록 목록")
|
||||
agendas: Optional[List[str]] = Field(None, description="안건 목록")
|
||||
duration_minutes: Optional[int] = Field(None, description="회의 시간(분)")
|
||||
|
||||
|
||||
class ExtractedTodo(BaseModel):
|
||||
"""추출된 Todo (제목만)"""
|
||||
title: str = Field(..., description="Todo 제목")
|
||||
|
||||
|
||||
class AgendaSummary(BaseModel):
|
||||
"""안건별 요약"""
|
||||
agenda_number: int = Field(..., description="안건 번호")
|
||||
agenda_title: str = Field(..., description="안건 제목")
|
||||
summary_short: str = Field(..., description="짧은 요약 (1줄)")
|
||||
discussion: str = Field(..., description="논의 주제")
|
||||
decisions: List[str] = Field(default_factory=list, description="결정 사항")
|
||||
pending: List[str] = Field(default_factory=list, description="보류 사항")
|
||||
todos: List[ExtractedTodo] = Field(default_factory=list, description="Todo 목록 (제목만)")
|
||||
|
||||
|
||||
class ConsolidateResponse(BaseModel):
|
||||
"""회의록 통합 요약 응답"""
|
||||
meeting_id: str = Field(..., description="회의 ID")
|
||||
keywords: List[str] = Field(..., description="주요 키워드")
|
||||
statistics: Dict[str, int] = Field(..., description="통계 정보")
|
||||
agenda_summaries: List[AgendaSummary] = Field(..., description="안건별 요약")
|
||||
generated_at: datetime = Field(default_factory=datetime.utcnow, description="생성 시각")
|
||||
Reference in New Issue
Block a user