# 컴퍼니엑스(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)

