sam-docs/features/sales

영업/매출관리

개요

영업/매출관리 모듈은 영업파트너 관리, 고객 영업권, 상품 관리, 인터뷰 시나리오 등 영업 전체 프로세스를 관리하는 기능 그룹입니다.

• 라우트 Prefix: /sales
• 미들웨어: auth, hq.member (본사 회원 전용)
• UI 기술: Blade + HTMX + Alpine.js (일부 React)

메뉴 구성

#	메뉴명	경로	문서	상태
1	영업관리 대시보드	/sales/salesmanagement/dashboard	sales-dashboard.md	구현완료
2	파트너관리	/sales/managers	partners.md	구현완료
3	영업파트너승인	/sales/managers/approvals	partner-approvals.md	구현완료
4	상품관리	/sales/products	products.md	구현완료
5	세일즈사이트	(외부 링크)	-	미구현
6	랜딩페이지	(외부 링크)	-	미구현
7	고객 관리	/sales/admin-prospects	admin-prospects.md	구현완료
8	영업파트너 고객관리	/sales/prospects	prospects.md	구현완료
9	인터뷰 시나리오	/sales/interviews	interviews.md	구현완료

아키텍처

영업/매출관리
├── 대시보드 ──── 수당 현황, 테넌트 진행률, 파트너 활동
├── 파트너관리
│   ├── 파트너 CRUD ──── 영업파트너 등록/수정/역할 관리
│   └── 파트너 승인 ──── 신규 파트너 신청 승인/반려
├── 상품관리 ──── 카테고리별 상품, 가격/수당률 설정
├── 고객관리
│   ├── 고객 관리(관리자) ──── 전사 고객 현황, 본사 진행상태
│   └── 파트너 고객관리 ──── 명함등록 기반 영업권 관리
└── 인터뷰 시나리오 ──── 질문 템플릿, 인터뷰 세션 기록

파일 구조

mng/
├── app/Http/Controllers/Sales/
│   ├── SalesDashboardController.php      # 영업관리 대시보드
│   ├── SalesManagerController.php        # 파트너관리 + 승인
│   ├── SalesProductController.php        # 상품관리
│   ├── TenantProspectController.php      # 영업권(명함등록) 관리
│   ├── AdminProspectController.php       # 관리자 전체 고객 관리
│   └── InterviewScenarioController.php   # 인터뷰 시나리오
├── app/Models/Sales/
│   ├── SalesPartner.php                  # 영업파트너
│   ├── SalesTenantManagement.php         # 테넌트 영업 관리
│   ├── TenantProspect.php                # 가망고객 (영업권)
│   ├── SalesCommission.php               # 영업 수수료
│   ├── SalesProduct.php                  # 영업 상품
│   ├── SalesProductCategory.php          # 상품 카테고리
│   └── SalesManagerDocument.php          # 파트너 서류
├── app/Models/Interview/
│   ├── InterviewCategory.php             # 인터뷰 카테고리
│   ├── InterviewTemplate.php             # 인터뷰 템플릿
│   ├── InterviewQuestion.php             # 인터뷰 질문
│   ├── InterviewSession.php              # 인터뷰 세션
│   └── InterviewAnswer.php              # 인터뷰 답변
├── app/Services/Sales/
│   ├── SalesManagerService.php           # 파트너 관리 서비스
│   ├── TenantProspectService.php         # 영업권 서비스
│   └── InterviewScenarioService.php      # 인터뷰 서비스
└── resources/views/sales/
    ├── dashboard/                        # 대시보드 뷰
    ├── managers/                         # 파트너관리 뷰
    ├── products/                         # 상품관리 뷰
    ├── prospects/                        # 영업권 관리 뷰
    ├── admin-prospects/                  # 관리자 고객관리 뷰
    └── interviews/                       # 인터뷰 시나리오 뷰

api/
└── database/migrations/
    ├── 2026_01_27_221000_create_tenant_prospects_table.php
    ├── 2026_01_28_090000_add_attachments_to_tenant_prospects_table.php
    ├── 2026_01_29_100000_create_sales_partners_table.php
    ├── 2026_01_29_100100_create_sales_tenant_managements_table.php
    ├── 2026_01_29_150000_create_sales_products_tables.php
    └── 2026_02_06_10000x_create_interview_*_tables.php (5개)

핵심 데이터 모델 관계

User (영업파트너)
  │
  ├── SalesPartner (파트너 정보, 수수료율, 계좌)
  │
  ├── TenantProspect (영업권 = 명함등록)
  │     ├── status: active → expired / converted / completed
  │     ├── 유효기간: 2개월
  │     └── 쿨다운: 만료 후 1개월
  │           │
  │           ↓ convert()
  │     Tenant (계약 고객사)
  │           │
  │           ↓
  │     SalesTenantManagement (영업 관리)
  │           ├── status: prospect → approach → negotiation → contracted → onboarding → active
  │           ├── hq_status: pending → review → planning → coding → dev_test → dev_done → int_test → handover
  │           └── SalesCommission (수당 정보)
  │
  └── SalesManagerDocument (등록 서류)

SalesProductCategory
  └── SalesProduct (개발비, 가입비, 구독료, 수당율)
        └── SalesContractProduct (계약별 선택 상품)

InterviewCategory
  └── InterviewTemplate
        └── InterviewQuestion
              └── InterviewSession → InterviewAnswer

권한 체계

역할	대시보드	파트너관리	승인	상품	고객관리	파트너고객	인터뷰
영업파트너	O (본인)	-	-	-	-	O (본인)	O
상담매니저	O (본인)	-	-	-	-	-	O
관리자	O (전체)	O	O	O	O	O	O
슈퍼관리자	O (전체)	O	O	O	O (삭제)	O	O