diff --git a/book/500_business/560_컴퍼니엑스_개요.md b/book/500_business/560_컴퍼니엑스_개요.md new file mode 100644 index 0000000..3f0c43b --- /dev/null +++ b/book/500_business/560_컴퍼니엑스_개요.md @@ -0,0 +1,216 @@ +# 컴퍼니엑스(Company X) 개요 + +**작성일**: 2025-12-16 +**관련 서비스**: `rb8001`, `skill-news`, `skill-slack`, `skill-rag-file` + +--- + +## 1. 컴퍼니엑스와 로빙의 관계 + +컴퍼니엑스(Company X)는 로빙의 **첫 직장이자 핵심 고객**입니다. 로빙 프로젝트는 컴퍼니엑스의 업무를 수행하고 지원하기 위해 시작되었으며, 컴퍼니엑스의 비즈니스 니즈에 맞춰 개발되고 있습니다. + +**핵심 원칙**: +- 로빙이 컴퍼니엑스의 일을 수행하고 있기 때문에, 그들의 요구사항에 맞춰야 하는 **의무**가 있습니다 +- 개발되는 모든 기능과 서비스들은 **컴퍼니엑스 기준**으로 작성되고 있습니다 +- 로빙 프로젝트의 우선순위와 방향성은 컴퍼니엑스의 비즈니스 목표와 일치합니다 + +--- + +## 2. 컴퍼니엑스란? + +컴퍼니엑스(Company X)는 스타트업을 지원하는 **액셀러레이터**입니다. 스타트업의 성장을 지원하기 위해 다양한 서비스를 제공하며, 특히 **IR Deck 개선 및 평가 서비스**를 핵심 기능으로 제공합니다. + +--- + +## 3. 주요 서비스 및 기능 + +### 3.1 IR Deck 평가 및 개선 서비스 + +컴퍼니엑스의 핵심 서비스로, 스타트업이 투자자에게 효과적으로 자신을 소개할 수 있도록 IR Deck을 평가하고 개선 방안을 제시합니다. + +**기능**: +- **Sequoia Capital 10가지 스토리 기준 평가**: 문제 정의, 시장 기회, 솔루션, 제품/서비스, 비즈니스 모델, 경쟁 우위, 팀, 트랙션, 재무, 비전 +- **페이지별 상세 평가**: 각 페이지에서 잘된 점과 개선점을 구체적으로 제시 +- **종합 점수 및 등급**: S/A/B/C 등급과 100점 만점 종합 점수 제공 +- **개선 피드백**: 각 페이지별로 "이 페이지에는 팀 정보가 부족합니다"와 같은 구체적인 피드백 제공 + +**사용 목적**: +- 스타트업이 자신의 IR Deck을 개선할 수 있도록 도움 +- 투자 유치를 위한 IR Deck 품질 향상 +- 페이지별로 어떤 부분을 보완해야 하는지 명확한 가이드 제공 + +**관련 파일**: +- `rb8001/app/services/ir_deck_analyzer.py`: IR Deck 평가 로직 +- `rb8001/app/services/ir_analyzer.py`: IR Deck 분석 유틸리티 +- `rb8001/app/state/ir_valuation_repository.py`: 평가 결과 저장소 + +--- + +### 3.2 콜드메일 IR Deck 분석 + +스타트업이 보낸 콜드메일에 첨부된 IR Deck을 자동으로 분석하고 평가합니다. + +**프로세스**: +1. 콜드메일 수신 및 필터링 +2. 첨부된 IR Deck PDF 자동 추출 및 업로드 +3. Slack Lists에 기업 정보 등록 (회사명, 대표자명, 연락처) +4. "이 기업을 분석해 드릴까요?" 버튼 제공 +5. 사용자가 "예" 클릭 시 IR Deck 평가 실행 +6. 평가 결과를 Slack에 공유 (점수, 등급, 상세 분석 링크) + +**관련 파일**: +- `rb8001/app/services/coldmail_processor.py`: 콜드메일 처리 +- `rb8001/app/services/slack/coldmail_service.py`: Slack 인터랙션 처리 +- `rb8001/app/services/workflows/coldmail_workflow.py`: 콜드메일 워크플로우 + +--- + +### 3.3 뉴스 수집 및 게시 + +컴퍼니엑스와 관련된 뉴스를 수집하고 게시합니다. + +**기능**: +- Google News API를 통한 뉴스 수집 +- 컴퍼니엑스 관련 기사 필터링 및 검증 +- Slack 채널로 뉴스 전송 +- Squarespace CMS로 뉴스 게시 + +**관련 파일**: +- `skill-news/app/services/companyx_news_scraper.py`: 뉴스 수집 +- `skill-news/app/services/companyx_news_collector.py`: 뉴스 수집 및 필터링 + +--- + +### 3.4 스타트업 가치 평가 + +IR Deck 평가 결과를 바탕으로 스타트업의 가치를 평가합니다. + +**프로세스**: +1. IR Deck 평가 (Sequoia 10가지 스토리 기준) +2. IR 지표 추출 (매출, 성장률, 팀 규모, 기술 우위 등) +3. 베이지안 프레임워크를 통한 가치 평가 +4. 투자 의사결정 지원 + +**관련 파일**: +- `rb8001/app/services/startup_valuation.py`: 가치 평가 로직 +- `rb8001/app/services/ir_analyzer.py`: IR 지표 추출 + +--- + +## 4. 로빙 프로젝트와의 관계 + +컴퍼니엑스는 로빙 프로젝트의 **방향성을 결정하는 핵심 요인**입니다. 로빙이 컴퍼니엑스의 업무를 수행하고 지원하기 때문에, 모든 개발은 컴퍼니엑스의 실제 업무 흐름과 요구사항을 기준으로 진행됩니다. + +**로빙의 역할**: +- **콜드메일 자동 처리**: 스타트업의 콜드메일을 자동으로 인식하고 처리하여 컴퍼니엑스 팀의 업무 부담 감소 +- **IR Deck 자동 평가**: AI를 통한 일관된 평가 기준 적용으로 평가 효율성 향상 +- **피드백 제공**: 페이지별 구체적인 개선 방안 제시로 스타트업 지원 품질 향상 +- **정보 관리**: Slack Lists를 통한 기업 정보 중앙 관리로 업무 프로세스 개선 + +**개발 우선순위**: +- 컴퍼니엑스의 실제 업무 니즈가 최우선 고려사항 +- 컴퍼니엑스의 업무 프로세스와 통합되는 것이 핵심 목표 +- 새로운 기능 개발 시 컴퍼니엑스의 사용 패턴과 요구사항을 기준으로 설계 + +--- + +## 5. 기술 스택 + +- **백엔드**: Python (FastAPI) +- **LLM**: Gemini (IR Deck 평가), Claude (이전에 사용) +- **데이터베이스**: PostgreSQL (평가 결과, 기업 정보 저장) +- **파일 스토리지**: skill-rag-file (IR Deck PDF 저장 및 텍스트 추출) +- **통신**: skill-slack (Slack 연동) +- **뉴스 수집**: skill-news (Google News API) + +--- + +## 6. 주요 데이터 구조 + +### 6.1 IR Deck 평가 결과 + +```sql +-- ir_deck_evaluations 테이블 +- id: 평가 ID (UUID) +- document_id: IR Deck 문서 ID +- total_score: 종합 점수 (0-100) +- grade: 등급 (S/A/B/C) +- email_metadata: 콜드메일 원본 데이터 (JSONB) +- created_at, updated_at: 생성/수정 시간 + +-- ir_deck_page_evaluations 테이블 +- id: 페이지 평가 ID +- evaluation_id: 평가 ID (외래키) +- page_number: 페이지 번호 +- strengths: 장점 배열 (TEXT[]) +- weaknesses: 개선점 배열 (TEXT[]) +- created_at: 생성 시간 +``` + +### 6.2 Slack Lists 구조 + +Slack Lists에 등록되는 기업 정보: +- 회사명 (company_name) +- 대표자명 (representative_name) +- 연락처 이메일 (contact_email) +- 관련 document_id, evaluation_id (참조용) + +--- + +## 7. 평가 기준: Sequoia Capital 10가지 스토리 + +IR Deck 평가는 Sequoia Capital의 10가지 스토리 기준을 사용합니다: + +1. **문제 정의 (Problem)**: 해결하려는 문제의 명확성 +2. **시장 기회 (Market Opportunity)**: 시장 규모와 성장성 +3. **솔루션 (Solution)**: 문제 해결 방법의 타당성 +4. **제품/서비스 (Product/Service)**: 제품의 차별성과 완성도 +5. **비즈니스 모델 (Business Model)**: 수익 모델의 명확성 +6. **경쟁 우위 (Competitive Advantage)**: 지속 가능한 경쟁력 +7. **팀 (Team)**: 팀의 역량과 실행력 +8. **트랙션 (Traction)**: 시장에서의 성과와 검증 +9. **재무 (Financials)**: 재무 건전성과 성장성 +10. **비전 (Vision)**: 장기 비전과 확장 가능성 + +각 스토리는 0-100점으로 평가되며, 전체 점수의 평균 또는 가중 평균으로 종합 점수가 계산됩니다. + +--- + +## 8. 사용 시나리오 + +### 시나리오 1: 콜드메일을 통한 IR Deck 분석 (컴퍼니엑스 실제 업무 흐름) + +1. 스타트업이 컴퍼니엑스에 콜드메일 발송 (IR Deck PDF 첨부) +2. 로빙이 콜드메일을 자동으로 감지하고 처리 +3. IR Deck을 skill-rag-file에 업로드 +4. Slack Lists에 기업 정보 등록 +5. Slack에 "이 기업을 분석해 드릴까요?" 버튼 전송 +6. 사용자가 "예" 클릭 +7. IR Deck 평가 실행 (페이지별 분석) +8. 평가 결과를 Slack에 공유 (점수, 등급, 상세 링크) + +### 시나리오 2: 직접 IR Deck 업로드 및 평가 + +1. 사용자가 IR Deck 평가 페이지에 접속 +2. PDF 파일 업로드 +3. "이 IR Deck 평가해줘" 클릭 +4. 페이지별 평가 실행 +5. 평가 결과 표시 (종합 점수, 등급, 페이지별 장점/개선점) + +--- + +## 9. 향후 발전 방향 (컴퍼니엑스 니즈 기반) + +- **평가 정확도 향상**: LLM 프롬프트 개선 및 평가 기준 세분화 +- **자동 개선 제안**: 평가 결과를 바탕으로 IR Deck 자동 수정 제안 +- **비교 분석**: 유사 업종/단계 스타트업과의 비교 분석 +- **트렌드 분석**: IR Deck 평가 데이터를 통한 스타트업 트렌드 분석 + +--- + +## 참고 문서 + +- [스타트업 가치분석 원칙](../300_architecture/314_스타트업_가치분석_원칙.md) +- [IR Deck 평가 시나리오](../../journey/scenarios/ir_deck_evaluation_scenario.md) +- [콜드메일 IR 분석 통합](../300_architecture/sequences/coldmail_ir_analysis_flow.md) +