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

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

3.6 KiB

영업파트너승인

개요

영업파트너승인은 신규 영업파트너 등록 신청을 검토하고 승인/반려를 처리하는 기능입니다. 본사 관리자 전용 페이지로, 신청자의 정보와 서류를 확인하고 일괄 처리할 수 있습니다.

  • 라우트: GET /sales/managers/approvals
  • 미들웨어: auth, hq.member + 관리자 권한 체크
  • UI 기술: Blade + HTMX + Tailwind CSS

파일 구조

mng/
├── app/Http/Controllers/Sales/
│   └── SalesManagerController.php        # 파트너관리와 동일 컨트롤러 (승인 메서드 포함)
├── app/Services/Sales/
│   └── SalesManagerService.php           # approve(), reject() 로직
└── resources/views/sales/managers/
    └── approvals.blade.php               # 승인 관리 페이지

라우트

// routes/web.php (sales prefix 그룹 내, resource 전에 정의)
GET  /managers/approvals                    approvals()       승인 목록 페이지
POST /managers/approvals/{id}/approve       approveFromList() 목록에서 승인
POST /managers/approvals/{id}/reject        rejectFromList()  목록에서 반려

컨트롤러

SalesManagerController (승인 관련 메서드)

메서드 HTTP 설명 권한
approvals() GET 승인 대기 목록 페이지 관리자 전용
approveFromList() POST 목록에서 승인 처리 관리자 전용
rejectFromList() POST 목록에서 반려 처리 관리자 전용
approve() POST 상세에서 승인 -
reject() POST 상세에서 반려 -

승인 처리 흐름

영업파트너 등록 신청 (store)
    ↓
approval_status = 'pending' (Users 테이블)
    ↓
관리자 승인 목록에서 확인
    ├── approveFromList() → status = 'approved'
    │   ├── approved_at 기록
    │   └── approved_by 기록
    │
    └── rejectFromList() → status = 'rejected'
        └── rejection_reason 저장 (필수)

응답 방식

HTMX 요청 → JsonResponse (success, message)
일반 요청 → Redirect (redirect back)

뷰 구성

approvals.blade.php

┌─ 페이지 헤더 ──────────────────────
│  제목: "영업파트너 승인관리"
│
├─ 통계 카드 ────────────────────────
│  승인 대기 | 오늘 승인 | 오늘 반려
│
├─ 검색/필터 영역 ──────────────────
│  검색 (이름, 아이디, 이메일, 전화번호)
│
├─ 2분할 레이아웃 ──────────────────
│  ┌─ 좌: 승인 대기 ────────────┐  ┌─ 우: 승인 완료 ─────────────┐
│  │  신청자명 | 역할 | 유치자  │  │  파트너명 | 승인일 | 승인자  │
│  │  └─ [승인] [반려] 버튼     │  │                             │
│  └────────────────────────────┘  └─────────────────────────────┘
│
└─ 상세 모달 ───────────────────────
   파트너 정보 (이름, 아이디, 이메일, 전화)
   계층 정보 (레벨, 추천인)
   등록 서류 목록 (다운로드/삭제)
   [승인] [반려] 버튼

반려 처리

반려 시:
  - rejection_reason (반려 사유) 필수 입력
  - 상태: pending → rejected
  - 반려 후 재신청 가능