Files
sam-hotfix/research/flow-chart/README.md

192 lines
5.3 KiB
Markdown
Raw Normal View History

# 📋 PPT Team Agent - 프레젠테이션 생성 시스템
TXT 파일을 분석하여 PowerPoint 프레젠테이션을 자동 생성하고, SAM ERP 견적서 PPTX를 생성하는 통합 시스템입니다.
## 🚀 주요 기능
### 1. TXT → PPTX 변환
- **입력**: `source/` 폴더의 자연어 TXT 파일
- **출력**: 전문적인 PowerPoint 프레젠테이션
- **특징**:
- 한국어 비즈니스 문서 파싱
- HTML 태그 제거 및 구조화
- 자동 섹션 인식 및 슬라이드 생성
- 목차 및 표지 자동 생성
### 2. SAM ERP 견적서 생성
- **기반**: PDF 샘플 구조 분석
- **출력**: SAM ERP 스타일의 견적서 PPTX
- **특징**:
- 견적관리 메인 화면
- 견적 상세 입력 폼
- 정식 견적서 문서 양식
- 전자결재 시스템 화면
## 📋 사용 방법
### 명령어 실행
```bash
# TXT → PPTX 변환
npm run ppt
# 또는
node run.js ppt
# SAM ERP 견적서 생성
npm run estimate
# 또는
node run.js estimate
# 대화형 모드
npm start
# 또는
node run.js
```
### 대화형 모드 명령어
```
• "ppt" 또는 "실행" - TXT → PPTX 변환
• "estimate" 또는 "견적서" - SAM ERP 견적서 생성
• "help" 또는 "도움말" - 도움말
• "exit" 또는 "종료" - 프로그램 종료
```
## 📁 디렉터리 구조
```
flow-chart/
├── source/ # TXT 입력 파일
│ └── sample_project.txt # 샘플 비즈니스 문서
├── pptx/ # PPTX 출력 파일
├── pdf_sample/ # PDF 참조 샘플
│ └── SAM_견적관리.pdf # SAM ERP 견적관리 구조
├── .claude/skills/
│ ├── text-analyzer-skill/ # TXT 분석 스킬
│ ├── pptx-skill/ # PPT 변환 스킬
│ └── proposal-skill/ # 기획서 생성 스킬
├── run.js # 통합 실행 스크립트
├── estimate-pptx-generator.js # 견적서 생성기
└── package.json # 프로젝트 설정
```
## ⚙️ 기술 스택
- **Node.js**: 백엔드 런타임
- **PptxGenJS**: PowerPoint 생성 라이브러리
- **자연어 처리**: 한국어 텍스트 파싱
- **PDF 분석**: 샘플 구조 기반 템플릿 생성
## 🎯 생성되는 슬라이드
### TXT → PPTX
1. **표지**: 프로젝트 제목, 날짜, 회사명
2. **목차**: 자동 인식된 섹션 목록
3. **섹션별 슬라이드**: 각 비즈니스 프로세스 상세
### SAM ERP 견적서
1. **표지**: SAM 로고 및 시스템 소개
2. **견적관리 메인**: 필터, 통계, 목록
3. **견적 상세**: 정보 입력 폼
4. **견적서 문서 (요약)**: 전체 견적 요약
5. **견적서 문서 (상세)**: 항목별 상세 내역
## 📊 샘플 결과
- **한국어 비즈니스 문서**: 125개 섹션 → 127개 슬라이드 (873KB)
- **SAM ERP 견적서**: 5개 주요 화면 (269KB)
## 🔧 개발 특징
- **컬러 호환성**: PptxGenJS 색상 오류 완전 해결
- **한글 지원**: 완전한 한국어 문서 파싱
- **템플릿 기반**: PDF 샘플 구조를 정확히 재현
- **확장 가능**: 새로운 문서 형식 쉽게 추가 가능
## 🚀 고급 기능
### 기존 기획서 생성 시스템
```bash
# 기존 PDF 기반 기획서 생성
npm run extract-template # PDF 구조 분석
npm run create-proposal # 기획서 생성
npm run demo-proposal # 전체 프로세스
```
### 지원되는 명령어
```bash
npm run html2pptx # HTML → PPTX 변환
npm run analyze-pdf # PDF 구조 분석
npm run txt-to-pptx # TXT → PPTX 직접 변환
```
## 🎨 예제 출력
### 1. 한국어 비즈니스 문서
- 회계 프로세스 검토 (127슬라이드)
- 자동 섹션 분류 및 구조화
- 전문적인 디자인 적용
### 2. SAM ERP 견적서
- 견적관리 시스템 완전 재현
- 실제 업무 프로세스 반영
- 전자결재 워크플로우 포함
## 📈 기술 개선사항
### 컬러 시스템 최적화
- PptxGenJS 색상 객체 오류 해결
- spread operator 호환성 개선
- 안정적인 색상 적용
### 한글 파싱 엔진
- HTML 태그 제거
- 한글 제목 패턴 인식
- 자연어 구조 분석
### 템플릿 시스템
- PDF 구조 자동 분석
- 재사용 가능한 컴포넌트
- 확장 가능한 아키텍처
## 🔮 향후 계획
### Phase 1: 완료 ✅
- [x] TXT → PPTX 변환 시스템
- [x] SAM ERP 견적서 생성
- [x] 통합 CLI 인터페이스
- [x] 한국어 문서 지원
### Phase 2: 진행 중
- [ ] 더 많은 문서 형식 지원
- [ ] AI 기반 콘텐츠 개선
- [ ] 템플릿 커스터마이징
- [ ] 실시간 미리보기
### Phase 3: 계획
- [ ] 웹 인터페이스
- [ ] 클라우드 통합
- [ ] 협업 기능
- [ ] 다국어 지원
## 🤝 기여 가이드
1. **새로운 템플릿 추가**
2. **문서 파싱 로직 개선**
3. **디자인 컴포넌트 확장**
4. **테스트 케이스 추가**
## 📞 지원 및 문의
- **GitHub Issues**: 버그 리포트 및 기능 제안
- **Documentation**: 사용법 및 API 문서
- **Examples**: 다양한 사용 예제
---
**🎯 핵심 가치**: 문서 작업의 자동화를 통한 생산성 극대화
**💡 비전**: 모든 비즈니스 문서를 자동으로 프레젠테이션으로 변환
**개발**: Claude Code + Human Collaboration
**날짜**: 2025.01.03
**버전**: 1.0.0