sam-sales/sales_process_plan.md

# 영업파트너 프로세스 및 테넌트 등록 관리 계획

본 문서는 영업파트너가 자신이 관리하는 테넌트를 등록하고, 상품 계약을 통해 발생하는 수익을 체계적으로 관리하며, 영업 프로세스(시나리오)를 기록하기 위한 구현 계획을 담고 있습니다.

## 1. 개요
영업파트너는 자신의 활동 결과인 테넌트와 계약 정보를 시스템에 기록합니다. 이 데이터는 영업파트너의 **수익(Commission)** 근거가 되며, **운영팀(Operator)**은 이를 확인하고 승인함으로써 최종 정산이 이루어집니다.

---

## 2. 데이터베이스 설계 (C:\Users\light\sam\sales\sales_records_schema.sql)
제공된 SQL 파일을 실행하면 다음과 같은 구조가 생성됩니다.

### 2.1 sales_tenants (테넌트 관리)
- 영업파트너와 1:N 관계로 매칭되는 고객사 정보.
- 상태(status) 변화를 통해 리드(Lead)에서 계약(Active)까지의 단계 관리.

### 2.2 sales_tenant_products (계약 및 수익 관리)
- 각 테넌트가 구매한 상품과 금액, 수수료율 기록.
- `commission_amount`: 계약 금액과 수수료율에 따라 자동 계산되는 영업자 수익.
- `operator_confirmed`: 운영팀이 데이터의 정당성을 확인하고 승인하는 필드.

---

## 3. 영업 프로세스 기록 관리 계획 (C:\Users\light\sam\sales\sales_scenario)

영업파트너의 프로세스를 `C:\Users\aweso\sam\sales\sales_scenario`에 기록하고 활용하는 상세 계획입니다.

### 3.1 시나리오 기반 체크리스트 통합
- 신규 테넌트 등록 시, `sales_scenario_checklist` 테이블에 해당 테넌트용 체크리스트를 자동 생성합니다.
- 영업파트너는 7단계(또는 설정된 단계)의 영업 프로세스를 진행하며 각 체크포인트를 달성할 때마다 체크합니다.

### 3.2 활동 로그 (sales_scenario_logs)
- 체크리스트 이외의 구체적인 상담 내역이나 영업 전략을 텍스트로 기록합니다.
- 이는 추후 운영팀이 승인 여부를 판단할 때 중요한 검토 자료가 됩니다.

---

## 4. 구현 단계별 로드맵

### Step 1: 데이터베이스 연동 및 관리자 UI 확장
- `index.php`의 `ManagerView`에 '테넌트 등록' 버튼 및 모달 폼 추가.
- 테넌트 목록에서 '상품/계약 추가' 기능 구현.

### Step 2: 수익 대시보드 구축
- 영업파트너가 자신의 누적 수익(승인됨/대기중)을 한눈에 볼 수 있는 통계 카드 UI 구현.
- `sales_tenant_products` 테이블의 금액 합산 연동.

### Step 3: 운영팀 승인 프로세스
- `OperatorView`에 '전체 계약 승인 관리' 섹션 추가.
- 운영팀이 각 영업자의 계약 건을 확인하고 `operator_confirmed`를 1로 변경하는 UI 구현.

### Step 4: 시나리오 체크리스트 UI 연동
- `sales_scenario` 폴더의 기존 체크리스트 UI를 테넌트별로 필터링하여 노출.
- 각 테넌트 상세 보기 페이지에서 현재 영업 진행 단계(Step 1~7)를 실시간으로 확인 및 업데이트.

---

## 5. 실행 가이드
1. 생성된 `c:\Users\aweso\sam\sales\sales_records_schema.sql` 파일을 MySQL 클라이언트(DBeaver, phpMyAdmin 등)에서 실행해 주세요.
2. 실행이 완료되면, 해당 테이블을 기반으로 실제 API(api/sales_tenants.php 등)와 UI 작업을 진행하도록 저에게 요청해 주세요.