ai_invest/설계/01/1차 요구사항정의서.md

I'm AI 투자매니저 요구사항 정의서

1. 프로젝트 개요

1.1 프로젝트명

Invest Manager AI (I'm AI)

1.2 프로젝트 목적

무료 웹 기반 AI 투자 분석 서비스 MVP를 개발하여 개인 투자자에게 실시간 투자 분석과 수익률 시뮬레이션을 제공

1.3 개발 범위

• 투자 상품: 코인 5종 + 주식 5종
• 서비스 범위: AI 투자 분석, 실시간 가격 모니터링, 수익률 시뮬레이션
• 서비스 형태: 웹 기반 무료 서비스

2. 기능적 요구사항 (Functional Requirements)

2.1 투자 상품 관리

• FR-001: 시스템은 코인 5종(BTC, ETH, ADA, DOGE, XRP)의 실시간 가격을 표시해야 한다
• FR-002: 시스템은 주식 5종(AAPL, GOOGL, TSLA, MSFT, NVDA)의 실시간 가격을 표시해야 한다
• FR-003: 시스템은 각 투자 상품의 기본 정보(명칭, 현재가, 등락률)를 제공해야 한다

2.2 AI 투자 분석

• FR-004: 시스템은 투자 상품별 AI 분석 결과를 제공해야 한다
  • 목표가 (Target Price)
  • 손절가 (Stop Loss)
  • 진입가 (Entry Price)
  • 매력도 점수 (Attractiveness Score)
  • 관련 근거 뉴스
  • AI 분석 내용
• FR-005: AI 분석은 최신 뉴스 데이터와 캔들 데이터를 기반으로 수행되어야 한다
• FR-006: AI 분석 결과는 24시간마다 업데이트되어야 한다

2.3 실시간 데이터 수집

• FR-007: 시스템은 업비트 API를 통해 코인 가격을 실시간 수집해야 한다
• FR-008: 시스템은 야후파이낸스 API를 통해 주식 가격을 실시간 수집해야 한다
• FR-009: 시스템은 투자 상품 관련 뉴스를 수집해야 한다
• FR-010: 시스템은 캔들 데이터(OHLCV)를 수집하고 저장해야 한다

2.4 상세 분석 및 수익률 시뮬레이션

• FR-011: 시스템은 투자 상품별 상세 분석 페이지를 제공해야 한다
• FR-012: 상세 분석 페이지는 캔들차트, AI 분석 결과, 관련 뉴스를 포함해야 한다
• FR-013: 시스템은 상세 페이지에서 AI 분석 결과를 기반으로 수익률 시뮬레이션을 제공해야 한다
• FR-014: 사용자는 여러 AI 분석 결과 중 원하는 것을 선택하여 시뮬레이션할 수 있어야 한다
• FR-015: 사용자는 투자 금액(기본값 1,000만원)을 입력하여 예상 수익/손실을 계산할 수 있어야 한다
• FR-016: 시뮬레이션 결과는 선택된 AI 분석의 목표가 달성시, 손절가 도달시 수익률을 표시해야 한다
• FR-017: 시뮬레이션을 통해 AI 분석 결과의 신뢰도와 유효성을 검증할 수 있어야 한다
• FR-018: 시스템은 AI 분석 결과를 날짜, 점수, 상태별로 필터링할 수 있어야 한다
• FR-019: 시스템은 AI 분석 결과의 간략히보기/상세보기 모드를 제공해야 한다
• FR-020: 시스템은 AI 분석 결과를 페이지네이션 또는 무한스크롤로 처리해야 한다
• FR-021: 사용자는 AI 분석 결과를 일괄 선택/해제할 수 있어야 한다

2.5 사용자 인터페이스

• FR-022: 메인 대시보드는 모든 투자 상품을 그리드 형태로 표시해야 한다
• FR-023: 투자 상품 클릭시 상세 분석 페이지가 표시되어야 한다
• FR-024: 상세 분석 페이지는 캔들차트, AI 분석 결과, 수익률 시뮬레이션 섹션을 포함해야 한다
• FR-025: 웹 인터페이스는 모바일 반응형으로 구현되어야 한다
• FR-026: 시스템은 다크모드/일반모드 테마 전환 기능을 제공해야 한다
• FR-027: 테마 설정은 브라우저 로컬스토리지에 저장되어야 한다

2.6 다국어 지원

• FR-028: 시스템은 사용자의 IP 주소를 기반으로 자동 언어 감지 기능을 제공해야 한다
• FR-029: 시스템은 한국어, 영어, 중국어(간체)를 지원해야 한다
• FR-030: 언어 설정은 수동으로 변경 가능해야 한다
• FR-031: 모든 UI 텍스트, 버튼, 메뉴는 다국어로 표시되어야 한다
• FR-032: 투자 상품명과 기본 정보는 해당 언어로 표시되어야 한다

3. 비기능적 요구사항 (Non-Functional Requirements)

3.1 성능 요구사항

• NFR-001: API 응답시간은 500ms 이내여야 한다
• NFR-002: 실시간 가격 업데이트 지연은 1초 이내여야 한다
• NFR-003: 시스템은 동시 사용자 1,000명을 지원해야 한다
• NFR-004: 페이지 로딩 시간은 3초 이내여야 한다

3.2 가용성 요구사항

• NFR-005: 시스템 가용성은 99.5% 이상이어야 한다
• NFR-006: 예정된 유지보수를 제외하고 월 다운타임은 3.6시간 이하여야 한다

3.3 확장성 요구사항

• NFR-007: 투자 상품은 추가 개발 없이 확장 가능해야 한다
• NFR-008: 서버리스 아키텍처로 자동 스케일링이 가능해야 한다

3.4 보안 요구사항

• NFR-009: 모든 API 통신은 HTTPS를 사용해야 한다
• NFR-010: API 키는 환경변수로 관리되어야 한다
• NFR-011: 개인정보는 수집하지 않아야 한다 (무료 서비스)

3.5 데이터 요구사항

• NFR-012: 가격 데이터는 실시간 업데이트되어야 한다
• NFR-013: AI 분석용 데이터는 최소 90일간 보관되어야 한다
• NFR-014: 데이터 백업은 일 1회 수행되어야 한다

4. 사용자 스토리 (User Stories)

4.1 메인 사용자 (개인 투자자)

• US-001: "투자자로서, 관심 있는 투자 상품의 실시간 가격을 한눈에 볼 수 있기를 원한다"
• US-002: "투자자로서, AI가 분석한 목표가와 손절가를 통해 투자 결정에 도움을 받고 싶다"
• US-003: "투자자로서, 투자 금액에 따른 예상 수익률을 미리 계산해보고 싶다"
• US-004: "투자자로서, 모바일에서도 편리하게 투자 정보를 확인하고 싶다"
• US-005: "투자자로서, 별도 회원가입 없이 바로 서비스를 이용하고 싶다"
• US-006: "투자자로서, 어두운 환경에서도 편안하게 볼 수 있는 다크모드를 사용하고 싶다"
• US-007: "투자자로서, 내가 이해할 수 있는 언어로 서비스를 이용하고 싶다"

4.2 관리자

• US-008: "관리자로서, 데이터 수집 상태와 AI 분석 결과를 모니터링하고 싶다"
• US-009: "관리자로서, 시스템 성능과 사용자 현황을 실시간으로 확인하고 싶다"

5. 유스케이스 (Use Cases)

5.1 Primary Use Cases

1. 투자 상품 조회

   • Actor: 개인 투자자
   • Flow: 메인 페이지 접속 → 투자 상품 리스트 확인 → 실시간 가격 조회

2. 투자 상품 상세 분석

   • Actor: 개인 투자자
   • Flow: 투자 상품 클릭 → 상세 분석 페이지 진입 → 캔들차트, AI 분석 결과, 관련 뉴스 확인

3. 수익률 시뮬레이션

   • Actor: 개인 투자자
   • Flow: 상세 분석 페이지 → 시뮬레이션 섹션 → 여러 AI 분석 결과 중 선택 → 투자 금액 입력(기본 1,000만원) → 선택된 AI 분석의 목표가/손절가 기준 수익률 계산 → 결과 확인 및 AI 분석 신뢰도 검증

5.2 System Use Cases

1. 데이터 수집

   • Actor: System
   • Flow: API 호출 → 데이터 수집 → 정규화 → 저장 (로컬DB)

2. AI 분석 수행

   • Actor: System
   • Flow: 데이터 수집 → AI 프롬프트 생성 → AI API 호출 → 결과 저장 (로컬DB)

3. AI 분석 결과 업데이트

   • Actor: System
   • Flow: DB에서 데이터 읽어오기 → 데이터 가공 → AWS-S3 저장

6. MVP 범위 정의

6.1 MVP 포함 기능

✅ 포함

• 코인 5종 + 주식 5종 실시간 가격 표시
• 투자 상품별 상세 분석 페이지 (캔들차트, AI 분석, 뉴스)
• AI 분석 결과 (목표가, 손절가, 진입가, 매력도)
• 상세 페이지 내 수익률 시뮬레이션 (다중 AI 분석 선택)
• AI 분석 신뢰도 검증 기능
• 반응형 웹 인터페이스
• 실시간 데이터 수집 및 처리
• 다크모드/일반모드 테마 전환
• 다국어 지원 (한글/영어/중국어)

6.2 MVP 미포함 기능

❌ 미포함

• 사용자 회원가입/로그인
• 포트폴리오 관리
• 알림/푸시 서비스
• 과거 데이터 분석
• 커뮤니티 기능
• 결제 시스템

7. 제약사항 및 전제조건

7.1 기술적 제약사항

• 업비트 API 호출 제한 준수
• 야후파이낸스 API 사용 정책 준수
• AI API 비용 최적화 필요

7.2 비즈니스 제약사항

• 무료 서비스로 운영 (광고로만 수익 창출)
• 투자 권유 금지 (분석 정보만 제공)
• 개인정보 수집 없음

7.3 전제조건

• AWS 계정 및 서비스 사용 가능
• 외부 API 서비스 정상 운영
• 개발 및 운영 환경 구축 완료

8. 성공 기준

8.1 기술적 성공 기준

• API 응답시간 < 500ms 달성
• 시스템 가용성 99.5% 이상
• 실시간 데이터 업데이트 지연 < 1초
• 모바일 사용성 테스트 통과

8.2 비즈니스 성공 기준

• DAU 100명 이상
• 평균 세션 시간 5분 이상
• 투자 상품 클릭률 30% 이상
• 주간 재방문률 40% 이상

9. 위험 요소 및 대응책

9.1 기술적 위험

• 위험: 외부 API 서비스 중단

• 대응: 다중 API 소스 활용, 캐싱 전략 수립

• 위험: AI API 비용 초과

• 대응: 사용량 모니터링, 비용 알람 설정

9.2 운영 위험

• 위험: 사용자 급증으로 인한 서비스 부하

• 대응: Auto Scaling 설정, 성능 모니터링

• 위험: 데이터 정확성 이슈

• 대응: 데이터 검증 로직 구현, 모니터링 대시보드 구축