sam-docs/features/sales/interviews.md

인터뷰 시나리오

개요

인터뷰 시나리오는 영업 상담 시 사용할 질문 템플릿을 관리하고, 인터뷰 세션을 진행/기록하는 기능입니다. 카테고리별 질문 구조, 체크리스트/텍스트 답변, MD 일괄 가져오기를 지원합니다.

• 라우트: GET /sales/interviews
• 미들웨어: auth, hq.member
• UI 기술: Blade + React/JavaScript (API 기반, 1,076줄)

파일 구조

mng/
├── app/Http/Controllers/Sales/
│   └── InterviewScenarioController.php   # 메인 컨트롤러 (16개 메서드)
├── app/Services/Sales/
│   └── InterviewScenarioService.php      # 비즈니스 로직 서비스
├── app/Models/Interview/
│   ├── InterviewCategory.php             # 카테고리
│   ├── InterviewTemplate.php             # 템플릿 (항목)
│   ├── InterviewQuestion.php             # 질문
│   ├── InterviewSession.php              # 인터뷰 세션
│   └── InterviewAnswer.php              # 답변
└── resources/views/sales/interviews/
    └── index.blade.php                   # 메인 페이지 (1,076줄)

api/
└── database/migrations/
    ├── 2026_02_06_100000_create_interview_categories_table.php
    ├── 2026_02_06_100001_create_interview_templates_table.php
    ├── 2026_02_06_100002_create_interview_questions_table.php
    ├── 2026_02_06_100003_create_interview_sessions_table.php
    └── 2026_02_06_100004_create_interview_answers_table.php

라우트

// routes/web.php (sales/interviews prefix 그룹 내)

// 페이지
GET  /interviews                            → index()           메인 페이지

// 카테고리 API
GET  /interviews/api/categories             → categories()       카테고리 목록
POST /interviews/api/categories             → storeCategory()    카테고리 생성
PUT  /interviews/api/categories/{id}        → updateCategory()   카테고리 수정
DELETE /interviews/api/categories/{id}      → destroyCategory()  카테고리 삭제

// 트리 API
GET  /interviews/api/tree                   → tree()             전체 계층 구조

// 템플릿(항목) API
POST /interviews/api/templates              → storeTemplate()    템플릿 생성
PUT  /interviews/api/templates/{id}         → updateTemplate()   템플릿 수정
DELETE /interviews/api/templates/{id}       → destroyTemplate()  템플릿 삭제

// 질문 API
POST /interviews/api/questions              → storeQuestion()    질문 생성
PUT  /interviews/api/questions/{id}         → updateQuestion()   질문 수정
DELETE /interviews/api/questions/{id}       → destroyQuestion()  질문 삭제

// 일괄 가져오기
POST /interviews/api/bulk-import            → bulkImport()       MD 파일에서 가져오기

// 세션(인터뷰) API
GET  /interviews/api/sessions               → sessions()         세션 목록 (필터)
POST /interviews/api/sessions               → storeSession()     인터뷰 시작
GET  /interviews/api/sessions/{id}          → showSession()      세션 상세
POST /interviews/api/sessions/toggle-answer → toggleAnswer()     답변 토글
POST /interviews/api/sessions/{id}/complete → completeSession()  인터뷰 완료

컨트롤러

InterviewScenarioController

메서드	HTTP	설명
index()	GET	메인 페이지
categories()	GET	카테고리 목록
storeCategory()	POST	카테고리 생성
updateCategory()	PUT	카테고리 수정
destroyCategory()	DELETE	카테고리 삭제
tree()	GET	전체 계층 구조 (카테고리→템플릿→질문)
storeTemplate()	POST	템플릿 생성
updateTemplate()	PUT	템플릿 수정
destroyTemplate()	DELETE	템플릿 삭제
storeQuestion()	POST	질문 생성
updateQuestion()	PUT	질문 수정
destroyQuestion()	DELETE	질문 삭제
bulkImport()	POST	MD 파일에서 일괄 가져오기
sessions()	GET	인터뷰 세션 목록
storeSession()	POST	인터뷰 시작
showSession()	GET	세션 상세
toggleAnswer()	POST	답변 토글/기록
completeSession()	POST	인터뷰 완료

InterviewScenarioService

메서드	설명
getCategories()	카테고리 목록
createCategory()	카테고리 생성
updateCategory()	카테고리 수정
deleteCategory()	카테고리 삭제
getTree()	전체 계층 구조 조회
createTemplate()	템플릿 생성
updateTemplate()	템플릿 수정
deleteTemplate()	템플릿 삭제
createQuestion()	질문 생성
updateQuestion()	질문 수정
deleteQuestion()	질문 삭제
bulkImport()	MD에서 일괄 가져오기
getSessions()	세션 목록 (필터)
startSession()	인터뷰 시작
getSessionDetail()	세션 상세
toggleAnswer()	답변 토글
completeSession()	인터뷰 완료

모델

데이터 계층 구조

InterviewCategory (카테고리)
  └── InterviewTemplate (템플릿/항목)
        └── InterviewQuestion (질문)

InterviewSession (인터뷰 세션)
  └── InterviewAnswer (답변)

InterviewCategory

테이블: interview_categories

필드	타입	설명
tenant_id	bigint	테넌트 ID
name	string	카테고리명 (예: 제조-방화셔터)
description	text	설명
sort_order	int	정렬 순서
is_active	boolean	활성 여부
created_by	bigint	등록자

• SoftDeletes 적용
• 관계: templates(), sessions()

InterviewTemplate

테이블: interview_templates

필드	타입	설명
tenant_id	bigint	테넌트 ID
interview_category_id	bigint (FK)	카테고리 ID
name	string	항목명 (예: 견적서 제작)
description	text	설명
sort_order	int	정렬 순서
is_active	boolean	활성 여부

• SoftDeletes 적용
• 관계: category(), questions()

InterviewQuestion

테이블: interview_questions

필드	타입	설명
tenant_id	bigint	테넌트 ID
interview_template_id	bigint (FK)	템플릿 ID
question_text	string(500)	질문 텍스트
question_type	string	checkbox / text
options	json	선택지 (배열)
is_required	boolean	필수 여부
sort_order	int	정렬 순서
is_active	boolean	활성 여부

• SoftDeletes 적용
• 관계: template()

질문 타입

타입	설명	답변 방식
checkbox	체크 질문	is_checked 토글
text	서술형 질문	answer_text 입력

InterviewSession

테이블: interview_sessions

필드	타입	설명
tenant_id	bigint	테넌트 ID
interview_category_id	bigint (FK)	사용한 카테고리 ID
interviewer_id	bigint (FK)	면담자(매니저) ID
interviewee_name	string(100)	면담 상대 이름
interviewee_company	string(200)	면담 상대 회사
interview_date	date	면담 일자
status	string	in_progress / completed
total_questions	int	총 질문 수
answered_questions	int	답변 완료 수
memo	text	메모
completed_at	timestamp	완료 일시

• SoftDeletes 적용
• 관계: category(), interviewer(), answers()

InterviewAnswer

테이블: interview_answers

필드	타입	설명
tenant_id	bigint	테넌트 ID
interview_session_id	bigint (FK)	세션 ID
interview_question_id	bigint (FK)	질문 ID
interview_template_id	bigint (FK)	템플릿 ID
is_checked	boolean	체크 여부 (checkbox 유형)
answer_text	text	답변 텍스트 (text 유형)
memo	text	메모

인터뷰 진행 흐름

1. 카테고리 선택 + 면담 상대 정보 입력
   → storeSession() → 세션 생성 (status: in_progress)
   → 해당 카테고리의 모든 질문에 대해 빈 Answer 생성

2. 질문별 답변 기록
   → toggleAnswer() → is_checked 토글 / answer_text 저장
   → answered_questions 카운트 갱신

3. 인터뷰 완료
   → completeSession() → status: completed, completed_at 기록

뷰 구성

index.blade.php

┌─ 페이지 헤더 ──────────────────────
│  제목: "인터뷰 시나리오"
│  [카테고리 추가] [일괄 가져오기] 버튼
│
├─ 좌측 사이드바 ───────────────────
│  카테고리 트리
│  ├── 카테고리 A
│  │   ├── 템플릿 1 (질문 3개)
│  │   └── 템플릿 2 (질문 5개)
│  └── 카테고리 B
│      └── 템플릿 3 (질문 2개)
│
├─ 우측 메인 영역 ──────────────────
│  ├─ 템플릿 편집 모드
│  │   질문 목록 + 추가/수정/삭제
│  │   질문 타입(checkbox/text) + 옵션
│  │
│  └─ 인터뷰 세션 모드
│      면담 상대 정보 + 날짜
│      질문별 체크/답변 기록
│      진행률 표시
│      [완료] 버튼
│
└─ 세션 목록 ───────────────────────
   과거 인터뷰 기록 (필터: 카테고리, 날짜)
   면담자 | 상대방 | 회사 | 날짜 | 완료율 | 상태

HTMX 호환성

• JavaScript/React 기반 페이지이므로 HX-Redirect 필요
• API 호출로 동적 CRUD 관리
• @push('scripts') 블록에 스크립트 포함