11 Commits

Author SHA1 Message Date
kimjh
18f2416414 외부 시퀀스 설계 일관성 개선
- API 경로 통일: /meetings → /minutes 리소스 기반 설계
- HTTP 메서드 표준화: 부분 수정 시 PUT → PATCH 변경
- 캐시 키 명명 규칙 통일: minutes:detail:, dashboard:, todo: 등
- 이벤트명 용어 통일: Transcript* → Minutes* 도메인 용어 적용
- DB 테이블명 정확성 개선: TranscriptVersion → MinutesVersion

수정 파일:
- 회의종료및최종확정.puml
- 회의록공유.puml
- Todo완료및회의록반영.puml
- 회의록상세조회및수정.puml

일관성 점수: 78/100 → 95/100

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-22 17:26:57 +09:00
hjmoons
4a4899e24d 내부,외부 시퀀스 기능 추가 2025-10-22 17:22:10 +09:00
Minseo-Jo
3cf8eb2995 AI 회의록 자동작성 내부 시퀀스 수정
- AI 서비스의 회의록 자동작성 내부 시퀀스 다이어그램 수정
- 프롬프트 생성, AI 요청, 응답 처리 로직 개선

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-22 16:24:33 +09:00
kimjh
afe02b3d0b AI 서비스 내부 시퀀스 PlantUML 문법 오류 수정
- 병렬 처리 블록에서 'and' 키워드를 'else'로 변경
- PlantUML sequence diagram에서 par/else/end가 올바른 문법
- 수정된 파일:
  - ai-맥락기반용어설명.puml (2개 else 사용)
  - ai-전문용어감지.puml (1개 else 사용)
  - ai-회의록자동작성.puml (1개 else 사용)
- PlantUML Server 검증 통과 확인

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-22 16:15:54 +09:00
kimjh
909025aa27 내부 시퀀스 설계 완료
- 총 21개 PlantUML 파일 생성 (Meeting 10개, AI 6개, STT 2개, Notification 3개)
- 서브 에이전트를 활용한 병렬 설계로 효율성 극대화
- 모든 시나리오는 유저스토리 및 외부 시퀀스와 1:1 매칭
- Controller → Service → Repository 계층 구조 명확히 표현
- Redis Cache, Azure Event Hubs 등 인프라 컴포넌트 표시
- 동기(→)/비동기(-->) 구분 명확
- 외부 참여자 <<E>> 표시 적용
- PlantUML 문법 검사 및 오류 수정 완료 (13개 파일 수정)
- par/and 블록 문법 오류 수정
- return 형식 적용으로 참여자 없는 화살표 오류 해결

설계 특징:
- 캐시 전략: Cache-Aside 패턴, TTL 관리, 즉시 무효화
- 비동기 처리: Azure Event Hubs 기반 이벤트 구독
- 실시간 협업: WebSocket 기반 동기화, 변경 델타 전송
- 데이터 일관성: 버전 관리, 양방향 연결, 트랜잭션 처리

추가 파일:
- claude/sequence-inner-design.md: 내부시퀀스설계 가이드
- tools/check-plantuml.ps1: PlantUML 문법 검사 스크립트

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-22 15:59:13 +09:00
Minseo-Jo
9f15f4f6e5 병합 완료: 원격 저장소 최신 변경사항 반영
- 회의시작및실시간회의록작성.puml 병합 완료
- .gitignore 업데이트
- stt-ai 디렉토리 추가
- requirements.txt, .env.example 추가

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-22 15:24:08 +09:00
kimjh
b05f7b2f22 PlantUML JSON 구조 오류 수정 (회의시작및실시간회의록작성)
- 메시지 텍스트의 JSON 데이터를 note 블록으로 분리
- MeetingStarted 이벤트: JSON을 note로 이동
- TranscriptReady 이벤트: JSON을 note로 이동
- TranscriptSummaryCreated 이벤트: JSON을 note로 이동
- WebSocket 메시지: JSON을 note로 이동
- 201 Created 응답: JSON을 note로 이동

PlantUML 렌더링 오류 해결

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-22 15:19:07 +09:00
kimjh
abb2f8c280 PlantUML 문법 오류 수정 (외부 시퀀스 설계)
- 7개 외부 시퀀스 설계서 PlantUML 문법 오류 수정 완료

**주요 수정 사항**:
1. 비동기 화살표 수정
   - `->>` → `->` (동기 메시지)
   - `-->>` → `-->` (응답 메시지)

2. 캐시 호출 화살표 수정
   - `-.->` → `-->` (응답 화살표)

3. note 블록 수정
   - 단일 라인 `note right:` → 블록 형태로 변경

4. activate/deactivate 최적화
   - 비동기 이벤트 처리에서 불필요한 activate/deactivate 제거

**수정된 파일**:
- Todo완료및회의록반영.puml
- 대시보드조회.puml
- 회의록공유.puml
- 회의록상세조회및수정.puml
- 회의시작및실시간회의록작성.puml
- 회의예약및참석자초대.puml
- 회의종료및최종확정.puml

**검증 결과**:
 모든 화살표가 PlantUML 표준 문법 준수 (`->`, `-->`)
 잘못된 화살표 문법 모두 제거 (`->>`, `-->>`, `-.->`)
 activate/deactivate 쌍 정상 매칭
 PlantUML 렌더링 오류 해결

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-22 15:09:18 +09:00
kimjh
a43b0c63cb 외부 시퀀스 설계 완료
- 7개 주요 비즈니스 플로우 설계 완료
  1. 회의예약및참석자초대 (2.5KB)
  2. 회의시작및실시간회의록작성 (4.9KB)
  3. 회의종료및최종확정 (4.6KB)
  4. 회의록공유 (2.1KB)
  5. Todo완료및회의록반영 (1.9KB)
  6. 대시보드조회 (1.6KB)
  7. 회의록상세조회및수정 (4.4KB)

- 설계 특징
  - 병렬 처리 전략: 서브 에이전트 활용 동시 작성
  - 5개 서비스 통합 아키텍처 (User, Meeting, STT, AI, Notification)
  - Azure Event Hubs를 통한 Pub/Sub 이벤트 기반 통신
  - Redis Cache-Aside 패턴을 통한 성능 최적화
  - AI 병렬 처리 (회의록 정리 + 전문용어 설명 + 관련 자료 검색)
  - WebSocket 실시간 동기화 (델타 전송)

- 작성원칙 준수
  - 유저스토리와 1:1 매칭
  - 논리 아키텍처에 정의된 참여자 표시
  - UI/UX 사용자 플로우 참조
  - 동기/비동기 통신 명확히 구분 (실선/점선)
  - 한글 설명 추가
  - PlantUML 표준 (!theme mono, 올바른 화살표 문법)

- PlantUML 문법 검증 완료 (수동)
  - @startuml, !theme mono 사용
  - 금지된 ..> 화살표 미사용
  - 동기 (→), 비동기 (->>), 캐시 (-.->) 구분

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-22 14:58:20 +09:00
djeon
3405d233ee 외부 시퀀스 설계 파일 정리 및 유저스토리 업데이트
- 기존 외부 시퀀스 설계 파일 삭제
- 유저스토리 수정
- 샘플 외부 시퀀스 파일 추가

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-22 14:25:29 +09:00
djeon
e1d411e989 외부 시퀀스 설계 가이드 및 설계서 추가
- 외부 시퀀스 설계 가이드 다운로드 (claude/sequence-outer-design.md)
- 외부 시퀀스 설계 디렉토리 생성 (design/backend/sequence/)

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-22 13:23:50 +09:00