CRM 모듈 (기관관리자)
기관 구성원이 고객사·담당자·명함·미팅·견적·내 핸드폰 연락처 동기화를 통합으로 다룰 수 있도록 CRM 모듈을 활성화합니다.
데이터 범위는 기관 공유: CRM 의 고객사 / 담당자 / 명함 / 미팅 데이터는 기관 단위로 모든 구성원이 공유 합니다. 핸드폰 연락처 동기화만 사용자 본인의 Google 계정에 따로 보관됩니다.
1. 사전 조건
| 항목 | 필수 / 권장 | 비고 |
|---|---|---|
| (없음 — 단독 활성 가능) | — | CRM 단독으로도 동작 |
| Drive 모듈 활성 | 권장 | 명함 Drive 인박스 / 미팅 트랜스크립트 Drive 가져오기 사용 시 필요 |
| AI API 키 (Gemini) 등록 | 권장 | 명함 OCR · 미팅 요약 · 고객사 매칭 제안 사용 시 필요 |
| Google 모듈 | 선택 | "내 핸드폰 연락처 동기화" 기능 (People API) 사용 시 |
→ Drive / AI 키 미설정 시 해당 기능만 비활성. CRM 핵심 (고객사 / 담당자 / 견적) 은 동작.
2. 모듈 활성화
좌측 사이드바 → 관리자 → 모듈 관리 (/app/admin/modules) → "CRM" 카드 토글 ON.
활성화 직후 좌측 사이드바에 고객관리 메뉴가 추가됩니다.
3. 설정 — 명함 Drive 인박스 폴더
CRM 모듈 카드의 [설정] 패널 (Drive 모듈이 활성화돼 있을 때만 표시):
| 항목 | 설명 |
|---|---|
| 명함 Drive 폴더 | 사용자가 폰으로 찍은 명함 사진을 업로드할 Drive 폴더. 비워두면 자동 생성 (/Workhub/CRM/명함-인박스/) |
| 트랜스크립트 폴더 (자동) | 미팅 트랜스크립트 원본을 보관할 폴더 — 자동 lazy create |
lazy create: 폴더 설정을 비워두거나 존재하지 않는 ID 를 입력하면, 첫 사용 시 워크허브가 자동으로 폴더를 생성합니다. 기존 폴더를 쓰려면 Drive 의 폴더 URL /drive/folders/XXX 의 XXX 를 복사해 입력.
4. AI API 키 (Gemini) — 의존성
다음 기능은 Gemini API 키가 등록돼 있어야 동작합니다:
| 기능 | 위치 |
|---|---|
| 명함 이미지 OCR (Vision) | 고객관리 → 명함 → Drive 인박스 → [OCR 처리] |
| 명함 텍스트 붙여넣기 파싱 | 고객관리 → 명함 → [텍스트 붙여넣기] |
| 미팅 트랜스크립트 요약 | 고객관리 → 미팅 → 트랜스크립트 ingest |
| 고객사 매칭 제안 | 명함 확정 시 자동 |
키 등록 방법: AI API 키 설정
키 미등록 시 해당 기능은 화면에 "AI 설정에서 Gemini API 키를 등록해주세요" 안내로 자동 fallback.
5. 데이터 범위 (기관 공유 vs 개인)
| 데이터 | 범위 | 비고 |
|---|---|---|
고객사 (customers) | 기관 공유 | 모든 사용자가 조회/편집 |
담당자 (crm_contacts) | 기관 공유 | 모든 사용자가 조회/편집 |
명함 (crm_business_cards) | 기관 공유 | 인박스 단계에서는 업로더 표시, 확정 후 공유 |
미팅 (crm_meetings) | 기관 공유 | 모든 사용자 조회 |
견적 (crm_quotes) | 기관 공유 | 모든 사용자 조회 (재무 모듈과 연동) |
| 핸드폰 연락처 매핑 | 개인 | 사용자 본인 Google People API 계정에만 저장 |
→ 핸드폰 sync 만 사용자 단위로 분리됩니다. 자세히는 명함 → 내 핸드폰 연락처 동기화 (사용자 가이드).
6. 다른 모듈과의 연동
| 연동 | 흐름 |
|---|---|
| 재무 모듈 | 견적 → 계약 승격, 명함 → finance_clients 자동 매칭 |
| 태스크 | 미팅 → 태스크 자동 생성 (source_meeting_id 기록) |
| Drive 모듈 | 명함 사진 / 미팅 첨부 / 트랜스크립트 원본을 Drive 에 보관 |
| Gmail 모듈 | 메일 → 태스크 → 미팅 / 견적 흐름 (역참조) |
7. 모듈 비활성화 시 영향
| 항목 | 영향 |
|---|---|
| 좌측 사이드바 고객관리 메뉴 | 즉시 사라짐 |
| 고객사 / 담당자 / 명함 / 미팅 데이터 | DB 에 보관 (재활성 시 복구) |
| 사용자의 핸드폰 sync OAuth 토큰 | 보관됨 (재활성 시 복구) |
| 견적 → 재무 계약 승격 연결 | 기존 데이터 그대로, 새 승격은 비활성 |
| Drive 명함 인박스 | Drive 폴더는 그대로 남음 — 워크허브에서만 인식 중단 |
8. 트러블슈팅
명함 Drive 인박스가 안 보임
체크:
- CRM 모듈 ON
- Drive 모듈 ON
- 명함 Drive 폴더 설정값 정상 (또는 lazy create 가 동작했는지)
- 사용자가 본인 Drive OAuth 동의 완료
명함 OCR 클릭 시 "AI 키를 등록해주세요"
- AI API 키 미등록 — AI API 키 설정 으로 등록
견적이 재무 모듈로 안 올라옴
- 재무 모듈이 비활성인 경우 견적은 CRM 안에만 존재
- 재무 모듈 활성 후 견적 → 계약 승격 메뉴가 노출
관련 가이드
- AI API 키 설정 — OCR / 요약 / 매칭 제안에 필요
- Drive 모듈 (관리자) — 명함 Drive 인박스 / 미팅 트랜스크립트
- 재무 모듈 (관리자) — 견적 → 계약 승격
- Gmail 모듈 (관리자) — 메일 → 태스크 → CRM 흐름
- 명함 → 내 핸드폰 연락처 동기화 (사용자 가이드) — 사용자 핸드폰 sync