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 작업을 진행하도록 저에게 요청해 주세요.