Twenty CRM 딥다이브
— 커뮤니티가 만드는 오픈소스 Salesforce 대체제

1프로젝트 한줄 요약

Twenty는 Salesforce의 오픈소스 대안 — 커뮤니티가 만드는 현대적 CRM 플랫폼입니다. TypeScript + React + NestJS + PostgreSQL 기반의 풀스택 오픈소스 CRM으로, "비싸고 폐쇄적인 Salesforce를 대체하겠다"는 명확한 목표 아래, 커스텀 데이터 모델, 워크플로우 자동화, 이메일/캘린더 통합, AI 기능까지 갖춘 엔터프라이즈급 CRM을 커뮤니티 주도로 개발하고 있습니다.

2왜 주목받는가

Salesforce vs Twenty 비교

3기술 스택 전체 지도

① 프론트엔드 (twenty-front)

② 백엔드 (twenty-server)

③ 인프라

4아키텍처 심화 분석

전체 시스템 구조도

핵심 설계 패턴 4가지

1. 메타데이터 기반 엔진 (Metadata-Driven Engine)

Twenty에서 가장 주목할 만한 설계입니다. CRM의 객체(Contact, Company, Deal 등)를 하드코딩하지 않고, Engine 모듈이 메타데이터를 기반으로 동적으로 객체를 생성합니다.

2. 멀티 테넌트 워크스페이스 격리

각 워크스페이스(=회사)의 데이터가 PostgreSQL 스키마 분리를 활용하여 완전히 격리됩니다. 같은 DB 인스턴스에서도 워크스페이스 간 데이터 접근이 불가능합니다.

3. 이벤트 기반 워크플로우

4. 다중 LLM 프로바이더 추상화

// 추상화된 AI 호출 — 프로바이더를 설정에서 교체 가능
const result = await aiService.generate({
  provider: workspace.aiProvider,  // 'anthropic' | 'openai' | 'mistral'
  model: workspace.aiModel,
  prompt: "이 연락처를 분석해줘..."
});

5디렉토리 구조 해부

6학습 포인트 (기술별)

6-1. NestJS 실전 아키텍처

19개 도메인 모듈이 독립적으로 동작하면서도 app.module.ts에서 통합되는 모듈식 설계를 배웁니다. GraphQL 스키마 자동 생성(코드 퍼스트 방식), 커스텀 데코레이터와 가드를 활용한 인증/인가, BullMQ 작업 큐 패턴도 익힐 수 있습니다.

6-2. React + Jotai 상태관리

Jotai의 원자적(Atomic) 상태관리 — Redux보다 단순하면서 강력합니다. Apollo Client와 Jotai를 조합한 서버/클라이언트 상태 분리, 56개 모듈을 가진 대규모 React 앱의 구조 설계를 배울 수 있습니다.

6-3. 메타데이터 기반 동적 시스템 설계

하드코딩 없이 데이터 모델을 런타임에 정의하는 패턴입니다. PostgreSQL 동적 테이블/스키마 생성, GraphQL 스키마 동적 생성, Salesforce 같은 플랫폼의 내부 동작 원리를 이해하게 됩니다.

6-4. 멀티 테넌트 아키텍처

PostgreSQL 스키마 기반 테넌트 격리, 테넌트별 마이그레이션 관리, 멀티 테넌트 환경에서의 인증 플로우를 배웁니다.

6-5. 모노레포 관리 (Nx + Yarn Workspaces)

22개 패키지를 하나의 레포에서 관리하는 방법, Nx의 빌드 캐싱과 의존성 그래프, 패키지 간 공유 코드 관리(twenty-shared, twenty-utils)를 배웁니다.

7하드웨어 / 시스템 요구사항

개발 환경

셀프호스팅 (Docker Compose)

8직접 해볼 수 있는 실습 과제

curl -o docker-compose.yml \
  https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/docker-compose.yml
cat > .env << 'EOF'
TAG=latest
PG_DATABASE_PASSWORD=my-secret-password
APP_SECRET=my-app-secret-change-me
SERVER_URL=http://localhost:3000
EOF
docker compose up -d
# http://localhost:3000 접속

git clone https://github.com/twentyhq/twenty.git
cd twenty
yarn install
docker run -d --name twenty-postgres -p 5432:5432 \
  -e POSTGRES_PASSWORD=postgres postgres:16
docker run -d --name twenty-redis -p 6379:6379 redis
# 환경변수 설정 후
yarn start

9관련 기술 심화 학습 로드맵

10핵심 키워드 사전

11참고 링크

• GitHub — twentyhq/twenty
• 공식 웹사이트 — twenty.com
• 공식 문서 — docs.twenty.com
• NestJS 공식 문서
• Jotai 공식 문서
• Apollo Client 문서
• BullMQ 문서
• Nx 문서
• Vercel AI SDK 문서
• TrendShift