#CRM 2.0 시스템 상세 설계

#1. 시스템 개요 및 설계 이념

#1.1 시스템 포지셔닝

본 시스템은 NocoBase 노코드 플랫폼을 기반으로 구축된 CRM 2.0 영업 관리 플랫폼입니다. 핵심 목표는 다음과 같습니다.

영업 담당자가 데이터 입력이나 반복적인 분석 대신 고객 관계 구축에 집중할 수 있도록 합니다.

시스템은 워크플로우를 통해 일상적인 업무를 자동화하고, AI를 활용하여 리드 점수 산정, 영업 기회 분석 등을 지원함으로써 영업 팀의 효율성을 높입니다.

#1.2 설계 이념

#이념 1: 완전한 판매 깔때기 (Sales Funnel)

엔드 투 엔드(End-to-End) 영업 프로세스:

왜 이렇게 설계했나요?

#이념 2: 구성 가능한 영업 파이프라인

산업군에 따라 코드 수정 없이 영업 파이프라인 단계를 사용자 정의할 수 있습니다.

#이념 3: 모듈화 설계

• 핵심 모듈(고객 + 영업 기회)은 필수이며, 기타 모듈은 필요에 따라 활성화할 수 있습니다.
• 모듈 비활성화 시 코드를 수정할 필요 없이 NocoBase 인터페이스 설정을 통해 가능합니다.
• 각 모듈은 독립적으로 설계되어 결합도를 낮췄습니다.

#2. 모듈 아키텍처 및 커스터마이징

#2.1 모듈 개요

CRM 시스템은 모듈화 아키텍처 설계를 채택하여, 비즈니스 요구사항에 따라 각 모듈을 독립적으로 활성화하거나 비활성화할 수 있습니다.

#2.2 모듈 의존성

#2.3 사전 구성 버전

#2.4 모듈-컬렉션 매핑

#핵심 모듈 컬렉션 (항상 필수)

#2.5 모듈 비활성화 방법

NocoBase 관리자 화면에서 해당 모듈의 메뉴 항목을 숨기기만 하면 되며, 코드를 수정하거나 컬렉션을 삭제할 필요가 없습니다.

#3. 핵심 엔티티 및 데이터 모델

#3.1 엔티티 관계 개요

#3.2 핵심 컬렉션 상세 정보

#3.2.1 리드 테이블 (nb_crm_leads)

간소화된 4단계 워크플로우를 적용한 리드 관리입니다.

단계 프로세스:

신규 → 진행 중 → 검증됨 → 고객/영업 기회로 전환
         ↓          ↓
      부적격      부적격

주요 필드:

#3.2.2 고객 테이블 (nb_crm_customers)

해외 비즈니스를 지원하는 고객/회사 관리입니다.

주요 필드:

#3.2.3 영업 기회 테이블 (nb_crm_opportunities)

구성 가능한 파이프라인 단계를 적용한 영업 기회 관리입니다.

주요 필드:

#3.2.4 견적 테이블 (nb_crm_quotations)

다중 통화 및 승인 워크플로우를 지원하는 견적 관리입니다.

상태 프로세스:

초안 → 승인 대기 → 승인됨 → 발송됨 → 수락됨/거절됨/만료됨
           ↓
       반려됨 → 수정 → 초안

주요 필드:

#3.2.5 주문 테이블 (nb_crm_orders)

결제 추적 기능이 포함된 주문 관리입니다.

주요 필드:

#3.3 컬렉션 요약

#CRM 비즈니스 컬렉션

#기초 데이터 컬렉션 (공통 모듈)

#3.4 보조 컬렉션

#3.4.1 댓글 테이블 (nb_crm_comments)

다양한 비즈니스 객체에 연결할 수 있는 범용 댓글/메모 테이블입니다.

#3.4.2 고객 공유 테이블 (nb_crm_customer_shares)

고객에 대한 다인 협업 및 권한 공유를 구현합니다.

#3.4.3 영업 기회 협업자 테이블 (nb_crm_opportunity_users)

영업 기회에 대한 영업 팀의 협업을 지원합니다.

#3.4.4 지역 테이블 (nb_cbo_regions)

국가/지역 기초 데이터 사전입니다.

#4. 리드 수명 주기

리드 관리는 간소화된 4단계 워크플로우를 사용합니다. 새 리드가 생성되면 워크플로우를 통해 자동으로 AI 점수 산정이 트리거되어 영업 담당자가 고품질 리드를 빠르게 식별할 수 있도록 돕습니다.

#4.1 상태 정의

#4.2 상태 흐름도

#4.3 리드 전환 프로세스

전환 화면에서는 세 가지 옵션을 동시에 제공하며, 사용자는 생성 또는 연결을 선택할 수 있습니다.

• 고객: 새 고객 생성 또는 기존 고객 연결
• 연락처: 새 연락처 생성 (고객과 연결)
• 영업 기회: 영업 기회 생성 필수

전환 후 기록:

• converted_customer_id: 연결된 고객 ID
• converted_contact_id: 연결된 연락처 ID
• converted_opportunity_id: 생성된 영업 기회 ID

#5. 영업 기회 수명 주기

영업 기회 관리는 구성 가능한 파이프라인 단계를 사용합니다. 영업 기회 단계가 변경될 때 자동으로 AI 승률 예측이 트리거되어 영업 담당자가 위험과 기회를 식별할 수 있도록 돕습니다.

#5.1 구성 가능한 단계

단계는 nb_crm_opportunity_stages 테이블에 저장되며 사용자 정의가 가능합니다.

#5.2 파이프라인 흐름

#5.3 정체 감지

활동이 없는 영업 기회는 다음과 같이 표시됩니다.

-- 정체 일수 계산
UPDATE nb_crm_opportunities
SET stagnant_days = EXTRACT(DAY FROM NOW() - last_activity_at)
WHERE stage NOT IN ('won', 'lost');

#5.4 수주 성공/실패 처리

수주 성공 시:

1. 단계를 'won'으로 업데이트
2. 실제 수주 날짜 기록
3. 고객 상태를 'active'로 업데이트
4. 주문 생성 트리거 (견적이 수락된 경우)

수주 실패 시:

1. 단계를 'lost'으로 업데이트
2. 수주 실패 사유 기록
3. 경쟁사 ID 기록 (경쟁사에게 패한 경우)
4. 매니저에게 통지

#6. 견적 수명 주기

#6.1 상태 정의

#6.2 승인 규칙 (미완성)

승인 워크플로우는 다음 조건에 따라 트리거됩니다.

#6.3 다중 통화 지원

#설계 이념

모든 보고서 및 분석을 위해 USD를 통합 기준 통화로 사용합니다. 각 금액 기록에는 다음이 저장됩니다.

• 원본 통화 및 금액 (고객에게 보이는 금액)
• 거래 시점의 환율
• USD 환산 금액 (내부 비교용)

#통화 사전 테이블 (nb_cbo_currencies)

통화 설정은 공통 기초 데이터 테이블을 사용하여 동적 관리를 지원합니다. current_rate 필드는 현재 환율을 저장하며, nb_crm_exchange_rates의 최신 기록에서 스케줄러를 통해 업데이트됩니다.

#환율 이력 테이블 (nb_crm_exchange_rates)

과거 환율 데이터를 기록하며, 스케줄러가 최신 환율을 nb_cbo_currencies.current_rate로 동기화합니다.

설명: 견적서는 currency_id 외래 키를 통해 nb_cbo_currencies 테이블과 연결되며, 환율은 current_rate 필드에서 직접 가져옵니다. 영업 기회와 주문은 currency VARCHAR 필드를 사용하여 통화 코드를 저장합니다.

#금액 필드 패턴

금액이 포함된 테이블은 다음 패턴을 따릅니다.

적용 대상:

• nb_crm_opportunities.amount → amount_usd
• nb_crm_quotations.total_amount → total_amount_usd

#워크플로우 통합

환율 획득 로직:

1. 비즈니스 작업 시 nb_cbo_currencies.current_rate에서 직접 환율을 가져옵니다.
2. USD 거래: 환율 = 1.0, 조회 불필요.
3. current_rate는 스케줄러에 의해 nb_crm_exchange_rates의 최신 기록에서 동기화됩니다.

#6.4 버전 관리

견적이 거절되거나 만료된 경우 새 버전으로 복사할 수 있습니다.

QT-20260119-001 v1 → 거절됨
QT-20260119-001 v2 → 발송됨
QT-20260119-001 v3 → 수락됨

#7. 주문 수명 주기

#7.1 주문 개요

주문은 견적이 수락될 때 생성되며, 확정된 비즈니스 약속을 나타냅니다.

#7.2 주문 상태 정의

#7.3 주문 데이터 모델

#nb_crm_orders

#nb_crm_order_items

#7.4 결제 추적

#nb_crm_payments

#8. 고객 수명 주기

#8.1 고객 개요

고객은 리드 전환 시 또는 영업 기회 수주 시 생성됩니다. 시스템은 고객 확보부터 옹호자 단계까지의 전체 수명 주기를 추적합니다.

#8.2 고객 상태 정의

#8.3 고객 건강도 점수

여러 요인을 기반으로 고객 건강도를 계산합니다.

건강도 임계값:

if (health_score >= 90) status = 'advocate';
else if (health_score >= 70) status = 'active';
else if (health_score >= 50) status = 'growing';
else status = 'at_risk';

#8.4 고객 세분화

#자동 세분화

#9. 이메일 통합

#9.1 개요

NocoBase는 Gmail 및 Outlook을 지원하는 내장 이메일 통합 플러그인을 제공합니다. 이메일이 시스템으로 동기화되면 워크플로우를 통해 자동으로 AI가 이메일의 감정과 의도를 분석하여 영업 담당자가 고객의 태도를 빠르게 파악할 수 있도록 돕습니다.

#9.2 이메일 동기화

지원되는 메일 서비스:

• Gmail (OAuth 2.0 사용)
• Outlook/Microsoft 365 (OAuth 2.0 사용)

동기화 동작:

• 송수신 이메일 양방향 동기화
• 이메일을 CRM 기록(리드, 연락처, 영업 기회)에 자동 연결
• 첨부 파일은 NocoBase 파일 시스템에 저장

#9.3 이메일-CRM 연결 (미완성)

#9.4 이메일 템플릿

영업 담당자는 사전 설정된 템플릿을 사용할 수 있습니다.

#10. AI 보조 기능

#10.1 AI 직원 팀

CRM 시스템은 NocoBase AI 플러그인을 통합하여 다음의 내장 AI 직원을 활용하며, CRM 시나리오에 맞는 전용 작업을 설정합니다.

#10.3 AI 작업 목록

AI 기능은 상호 독립적인 두 가지 범주로 나뉩니다.

#1. AI 직원 (프론트엔드 블록 트리거)

사용자는 프론트엔드 AI 직원 블록을 통해 AI와 직접 대화하며 분석 및 제안을 받습니다.

#2. 워크플로우 LLM 노드 (백엔드 자동 실행)

워크플로우 내에 포함된 LLM 노드로, 테이블 이벤트, 작업 이벤트, 스케줄러 등을 통해 자동으로 트리거되며 AI 직원과는 별개로 작동합니다.

설명: 워크플로우 LLM 노드는 프롬프트와 Schema 출력을 사용하여 구조화된 JSON을 생성하며, 이를 해석하여 사용자 개입 없이 비즈니스 데이터 필드에 기록합니다.

#10.3 데이터베이스 내 AI 필드

#11. 워크플로우 엔진

#11.1 구현된 워크플로우

#11.2 구현 예정 워크플로우

#12. 메뉴 및 인터페이스 설계

#12.1 백엔드 관리 구조

#12.2 대시보드 뷰

#영업 매니저 뷰

#영업 담당자 뷰

#경영진 뷰

문서 버전: v2.0 | 업데이트 날짜: 2026-02-06