---
description:
globs:
alwaysApply: true
---
# 제품 요구사항 문서 (PRD)

## 1. 개요
인플루언서와 벤더사가 문서 교환 없이 웹 기반으로 수·발주 및 정산을 수행할 수 있는 통합 플랫폼 구축. 배송·정산·고객응대 전 과정을 자동화해 거래 속도와 신뢰도를 향상시킨다.

## 2. 문제 정의
- 엑셀·PDF 등 오프라인 문서 교환으로 인한 오류·지연
- 송장번호 수기 입력, 재고·배송 상태 불일치
- 계약·정산 내역 확인이 어렵고 가시성 부족
- 인플루언서 파트너 탐색 과정의 비효율

## 3. 목표 및 목적
- 1차 목표: 발주·승인·송장·정산 전 프로세스 웹 자동화
- 2차 목표: 파트너 매칭, 서브계정 관리, OCR 기반 송장 인식
- 성공지표
  - 발주 승인 평균 소요시간 50% 단축
  - 송장 입력 오류율 90% ↓
  - 월간 활성 인플루언서 수 1,000명
  - 거래액 월 10억 원

## 4. 타깃 사용자
### 주요 사용자
- 인플루언서: SNS 영향력 보유, 공동구매 운영, 재고·배송 부담 최소화 희망
- 벤더사: 상품 공급, 재고·배송·정산 자동화 필요
### 부차 사용자
- 통합 벤더사/유통업체, CS 담당자, 회계팀

## 5. 사용자 스토리
- “인플루언서로서 벤더사 제품을 조회·발주해 판매 준비를 간편히 하고 싶다.”
- “벤더사 담당자로서 인플루언서 요청을 클릭 한 번에 승인·거절하고 싶다.”
- “CS 담당자로서 주문 상태를 실시간 파악해 문의에 즉시 대응하고 싶다.”
- “벤더사 마스터로서 서브계정을 생성해 팀별 권한을 차등 부여하고 싶다.”

## 6. 기능 요구사항
### 핵심 기능
1. 벤더사 포털  
   - 상품 등록/수정/상태관리(배송중, 품절 등)  
     Acceptance: 상품 등록 시 필수 필드 검증, 상태 변경시 실시간 알림  
   - 주문 관리: 인플루언서 수주 승인/거절, 일괄처리  
   - 배송 관리  
     - 송장번호 엑셀 업로드·다운로드  
     - 송장 사진 OCR → 자동 입력  
   - 정산 관리: 월간 계약·정산 내역 확인, CSV 다운로드  
   - 인플루언서 승인 및 제안: 가입 요청 승인 및 파트너 제안 발송  
2. 인플루언서 포털  
   - SNS 간편 로그인(Google, Kakao, Naver)  
   - 벤더사 가입 요청 및 제안 수락  
   - 연결된 벤더사 상품 리스트 조회  
   - 상품 수주 요청, 송장번호 엑셀 다운로드  
3. 매칭 시스템  
   - 벤더사 조건(카테고리·팔로워 수) 기반 추천 알고리즘  
4. 알림 센터  
   - 이메일·푸시·웹 소켓 알림: 주문 상태, 승인 결과, 정산 완료  
### 보조 기능
- 벤더사 서브계정 관리(역할·권한 설정)
- 고객센터 게시판(FAQ, 1:1 문의)
- 대시보드(매출, 주문, 정산 현황)

## 7. 비기능 요구사항
- 성능: 평균 응답 300ms 이하, 동시 5,000사용자
- 보안: JWT 인증, OAuth2 SNS 로그인, HTTPS, 데이터 암호화
- 사용성: 반응형 UI, 접근성 WCAG 2.1 AA
- 확장성: 모듈화된 Micro Frontend, RESTful API
- 호환성: 최신 크롬·사파리·엣지, 모바일 브라우저

## 8. 기술 고려사항
- 프론트엔드: Vue3 + Composition API, Nuxt3, Vuetify, TypeScript, Axios
- 백엔드: CodeIgniter4 + Node.js BFF
- DB: MySQL(RDS), Redis 캐시
- 배포: Docker, K8s, GitHub Actions CI/CD
- OCR: Google Cloud Vision API
- 통합: 택배사 API(송장 추적), 회계 시스템 ERP 연동
- 로깅·모니터링: ELK, Grafana

## 9. 성공 지표(KPI)
- DAU / MAU, 유입·활성률
- 주문 승인 건수, 배송 완료율
- 거래 총액, 재구매율
- 서버 오류율 <1%, 가용성 99.9%

## 10. 일정 및 마일스톤
- Phase 1 (M+2): 로그인, 상품·주문·배송 기본, MVP 런칭
- Phase 2 (M+4): 정산 모듈, 매칭 시스템, 알림 센터
- Phase 3 (M+6): OCR, 서브계정, 대시보드, 모바일 최적화
- Phase 4 (M+9): AI 수요 예측, 글로벌 배송 연동

## 11. 위험 및 대응
- 데이터 정확도: OCR 오류 → 수동 검증 UI 제공
- 사용 미정착: 온보딩 튜토리얼, FAQ 운영
- 벤더사 API 변경: 버전 관리, 어댑터 패턴
- 개인정보 유출: 정기 보안 점검, 침투 테스트

## 12. 향후 고려사항
- 인플루언서 커미션 자동 분배, 블록체인 정산
- 다국어 지원, 환율 자동 적용
- 모바일 앱(iOS/Android) 출시
- AI 기반 악성 주문 탐지, 인플루언서 등급제 도입