섹션 AI 요약 재생성으로 변경 (프로토타입 반영)

- 프롬프트 기반 회의록 개선 → 섹션 AI 요약 재생성으로 변경
- UFR-AI-030 → UFR-AI-035로 유저스토리 교체
- API 엔드포인트: POST /sections/{sectionId}/regenerate-summary
- 내부 시퀀스, 외부 시퀀스, API 설계서, 유저스토리 일관성 확보
- 프로토타입의 "AI 재생성" 버튼 기능과 정확히 매칭

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Minseo-Jo
2025-10-23 13:46:59 +09:00
parent d3faf55657
commit b8ff2a8339
5 changed files with 200 additions and 258 deletions
+39 -62
View File
@@ -31,8 +31,8 @@ tags:
description: 회의록 자동 작성 관련 API
- name: Todo
description: Todo 자동 추출 관련 API
- name: Improve
description: 회의록 개선 관련 API
- name: Section
description: 섹션 AI 요약 재생성 관련 API
- name: Relation
description: 관련 회의록 연결 관련 API
- name: Term
@@ -101,38 +101,38 @@ paths:
'500':
$ref: '#/components/responses/InternalServerError'
/transcripts/{meetingId}/improve:
/sections/{sectionId}/regenerate-summary:
post:
tags:
- Improve
summary: 회의록 개선
- Section
summary: 섹션 AI 요약 재생성
description: |
프롬프팅을 통해 회의록을 다양한 형식으로 변환합니다.
(1Page 요약, 핵심 요약, 상세 보고서 등)
operationId: improveTranscript
x-user-story: UFR-AI-030
x-controller: ImproveController
사용자가 작성한 섹션 내용을 기반으로 AI 요약을 재생성합니다.
회의록 작성/수정 중에 사용됩니다.
operationId: regenerateSectionSummary
x-user-story: UFR-AI-035
x-controller: SectionController
parameters:
- name: meetingId
- name: sectionId
in: path
required: true
schema:
type: string
format: uuid
description: 회의 ID
description: 섹션 ID
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/TranscriptImproveRequest'
$ref: '#/components/schemas/SectionSummaryRequest'
responses:
'200':
description: 회의록 개선 성공
description: AI 요약 재생성 성공
content:
application/json:
schema:
$ref: '#/components/schemas/TranscriptImproveResponse'
$ref: '#/components/schemas/SectionSummaryResponse'
'400':
$ref: '#/components/responses/BadRequest'
'404':
@@ -385,31 +385,29 @@ components:
## 보류사항
- 배포 일정은 다음 회의에서 논의
TranscriptImproveRequest:
SectionSummaryRequest:
type: object
required:
- promptType
- sectionContent
properties:
promptType:
sectionContent:
type: string
enum:
- 1PAGE_SUMMARY
- CORE_SUMMARY
- DETAILED_REPORT
- DECISION_FOCUSED
- ACTION_FOCUSED
- EXECUTIVE_REPORT
- CUSTOM
description: 프롬프트 유형
example: "1PAGE_SUMMARY"
customPrompt:
description: 사용자가 작성/수정한 섹션 내용 (Markdown 형식)
example: |
**논의 사항:**
- AI 기반 회의록 자동화 서비스 출시 결정
- 타겟 고객: 중소기업, 스타트업
- 주요 기능: 음성인식, AI 요약, Todo 자동 추출
- 차별화 포인트: 실시간 검증, 협업 기능
**결정 사항:**
- 베타 버전 출시일: 2025년 12월 1일
- 초기 목표 사용자: 100개 팀
meetingId:
type: string
description: 사용자 정의 프롬프트 (promptType이 CUSTOM일 때)
example: "경영진 보고용으로 3가지 핵심 결정사항만 요약해주세요"
userId:
type: string
description: 사용자 ID
example: "user123"
format: uuid
description: 회의 ID (맥락 이해용, 선택적)
example: "550e8400-e29b-41d4-a716-446655440000"
TermDetectionRequest:
type: object
@@ -517,39 +515,18 @@ components:
description: 추출 시간
example: "2025-01-23T11:00:00Z"
TranscriptImproveResponse:
SectionSummaryResponse:
type: object
properties:
transcriptId:
summary:
type: string
format: uuid
description: 개선된 회의록 ID
example: "770e8400-e29b-41d4-a716-446655440002"
version:
type: integer
description: 버전 번호
example: 2
baseVersion:
type: integer
description: 원본 버전 번호
example: 1
improvementType:
type: string
description: 개선 유형
example: "1PAGE_SUMMARY"
content:
type: string
description: 개선된 회의록 내용
example: "## 프로젝트 킥오프 미팅 요약\n\n### 핵심 결정사항\n1. React 기반 프론트엔드 개발..."
originalLink:
type: string
description: 원본 회의록 링크
example: "/transcripts/660e8400-e29b-41d4-a716-446655440001"
createdAt:
description: 생성된 AI 요약 (2-3문장)
example: "AI 기반 회의록 자동화 서비스로 결정. 타겟은 중소기업 및 스타트업이며, 주요 기능은 음성인식, AI 요약, Todo 추출입니다. 경쟁사 대비 차별점은 실시간 검증 및 협업 기능입니다."
generatedAt:
type: string
format: date-time
description: 생성 시간
example: "2025-01-23T11:30:00Z"
example: "2025-01-23T11:00:00Z"
RelatedTranscriptsResponse:
type: object
+17 -31
View File
@@ -7,7 +7,7 @@ AI Service는 회의록 작성 및 공유 개선 서비스의 핵심 차별화
### 주요 기능
- **회의록 자동 작성**: LLM 기반 회의록 자동 생성
- **Todo 자동 추출**: 액션 아이템 자동 식별 및 담당자 추출
- **회의록 개선**: 프롬프팅 기반 다양한 형식 변환
- **섹션 AI 요약 재생성**: 작성한 섹션 내용을 AI가 자동으로 요약
- **관련 회의록 연결**: RAG 기반 벡터 유사도 검색
- **전문용어 감지**: 맥락 기반 용어 설명 제공
- **실시간 추천**: 논의사항/결정사항 자동 제안
@@ -101,45 +101,30 @@ Todo 자동 추출
---
### 3. 회의록 개선 (Improve)
### 3. 섹션 AI 요약 재생성 (Section Summary)
#### POST /transcripts/{meetingId}/improve
회의록 개선
#### POST /sections/{sectionId}/regenerate-summary
섹션 AI 요약 재생성
**유저스토리**: UFR-AI-030
**Controller**: ImproveController
**유저스토리**: UFR-AI-035
**Controller**: SectionController
**Path Parameters**:
- `meetingId` (uuid, required): 회의 ID
- `sectionId` (uuid, required): 섹션 ID
**Request Body**:
```json
{
"promptType": "1PAGE_SUMMARY",
"customPrompt": "경영진 보고용으로 3가지 핵심 결정사항만 요약해주세요",
"userId": "user123"
"sectionContent": "**논의 사항:**\n- AI 기반 회의록 자동화 서비스 출시 결정\n- 타겟 고객: 중소기업, 스타트업\n- 주요 기능: 음성인식, AI 요약, Todo 자동 추출\n- 차별화 포인트: 실시간 검증, 협업 기능\n\n**결정 사항:**\n- 베타 버전 출시일: 2025년 12월 1일\n- 초기 목표 사용자: 100개 팀",
"meetingId": "550e8400-e29b-41d4-a716-446655440000"
}
```
**Prompt Types**:
- `1PAGE_SUMMARY`: A4 1장 분량 요약
- `CORE_SUMMARY`: 3-5개 핵심 포인트
- `DETAILED_REPORT`: 시간순 상세 기록
- `DECISION_FOCUSED`: 의사결정 중심
- `ACTION_FOCUSED`: 액션 아이템 중심
- `EXECUTIVE_REPORT`: 경영진 보고용
- `CUSTOM`: 사용자 정의
**Response (200 OK)**:
```json
{
"transcriptId": "770e8400-e29b-41d4-a716-446655440002",
"version": 2,
"baseVersion": 1,
"improvementType": "1PAGE_SUMMARY",
"content": "## 프로젝트 킥오프 미팅 요약\n\n### 핵심 결정사항...",
"originalLink": "/transcripts/660e8400-e29b-41d4-a716-446655440001",
"createdAt": "2025-01-23T11:30:00Z"
"summary": "AI 기반 회의록 자동화 서비스로 결정. 타겟은 중소기업 및 스타트업이며, 주요 기능은 음성인식, AI 요약, Todo 추출입니다. 경쟁사 대비 차별점은 실시간 검증 및 협업 기능입니다.",
"generatedAt": "2025-01-23T11:00:00Z"
}
```
@@ -425,10 +410,10 @@ docker run -p 8080:8080 \
- 회의록과 양방향 연결
- Meeting Service로 실시간 전달
### 3. 프롬프팅 기반 회의록 개선
- 7가지 프롬프트 유형 지원
- 원본 보존 + 버전 관
- 사용자 정의 프롬프트 지원
### 3. 섹션 AI 요약 재생성
- 작성 중 실시간 AI 요약 생성
- 섹션별 독립적 요약 처
- 회의 맥락 기반 정확도 향상
### 4. 실시간 추천
- 논의사항 제안 (빠진 안건 자동 감지)
@@ -443,7 +428,7 @@ docker run -p 8080:8080 \
|-----|---------------|
| 회의록 자동 작성 | 8-13초 |
| Todo 자동 추출 | 4-7초 |
| 회의록 개선 | 5-9초 |
| 섹션 AI 요약 재생성 | 2-5초 |
| 관련 회의록 연결 | 5-8초 |
| 전문용어 감지 | 3-5초 |
| 맥락 기반 용어 설명 | 5-8초 |
@@ -457,3 +442,4 @@ docker run -p 8080:8080 \
| 버전 | 작성일 | 작성자 | 변경 내용 |
|------|--------|--------|----------|
| 1.0 | 2025-01-23 | 준호 (Backend Developer) | AI Service API 설계 완료 |
| 1.1 | 2025-01-23 | 준호 (Backend Developer) | 회의록 개선 → 섹션 AI 요약 재생성으로 변경 (프로토타입 반영) |