Files
sam-docs/features/sales/README.md
김보곤 c5b1eb050e docs:영업/매출관리 개발문서 추가 (7개 메뉴)
- 영업관리 대시보드: 수당 현황, 테넌트 진행률, 파트너 활동
- 파트너관리: 영업파트너 CRUD, 역할 관리, 서류 관리
- 영업파트너승인: 신규 파트너 신청 승인/반려 워크플로우
- 상품관리: 카테고리별 상품, 가격/수당률 설정
- 고객관리(관리자): 전사 고객 현황, 본사 진행상태 8단계
- 영업파트너 고객관리: 명함등록 기반 영업권, 테넌트 전환
- 인터뷰 시나리오: 질문 템플릿, 세션 기반 인터뷰 기록

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-11 17:04:06 +09:00

6.1 KiB

영업/매출관리

개요

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

  • 라우트 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