TL;DR

다중 테넌트 고객운영용 오픈소스 SaaS(Community edition)로, TypeScript 기반의 React 프론트엔드·Node.js API·PostgreSQL 16 데이터 레이어를 단일 저장소에서 제공합니다. Docker Compose 기반의 빠른 기동 흐름과 .env로 핵심 비밀값을 설정하는 절차가 있어 로컬 검증이 쉽고 docs/에 배포·데이터 모델·운영 가이드가 상세히 정리되어 있습니다. Telegram·WhatsApp 게이트웨이는 저장소에 포함되지 않으며 해당 채널은 외부 어댑터를 직접 구현해야 합니다. 스타 수 697개로 커뮤니티 관심은 있으나 프로덕션용 채널 연동이나 운영 준비를 자체적으로 해결해야 하는 프로젝트입니다.

핵심 포인트

• 이 저장소는 독립 실행형 SaaS 애플리케이션으로 다중 테넌트 고객운영(Customer operations)을 목표로 하는 Community edition입니다. 코드베이스는 React 프런트엔드, Node.js API, PostgreSQL 데이터 레이어를 포함하여 로컬에서 Docker Compose로 즉시 기동할 수 있도록 구성되어 있습니다. Telegram·WhatsApp 게이트웨이 구현은 제외되어 있고 외부 채널용 어댑터 계약만 제공되므로 해당 채널 연동은 배포자가 별도로 구현해야 합니다.
• 아키텍처는 Nginx가 프론트엔드 트래픽을 처리하고 React가 UI를 제공하며 Node.js API가 비즈니스 로직과 PostgreSQL 16을 연결하는 전형적인 웹 SaaS 구조입니다. AI, IMAP/SMTP, Stripe 같은 외부 서비스는 옵션으로 분리되어 있으며 환경변수(.env)로 DB 비밀번호와 JWT 시크릿을 설정한 뒤 docker compose로 서비스 전체를 빌드·기동하는 운영 흐름을 따릅니다. 운영 관련 배포·롤백·데이터 모델 문서는 docs/ 하위에 정리되어 있어 프로덕션 준비에 참고할 수 있습니다.
• 기능적으로는 멀티테넌시·계정·역할·토큰 철회·감사로그 같은 보안·관리 기능과 통합 메시지 작업대, 세션 페이지네이션·읽음·인용·미디어 메타데이터·WebSocket 증분 업데이트 등 실시간 메시징 역량을 제공합니다. 다국어 문장별 번역, 의도·감정·리스크 분석, 요약 및 AI 기반 답변 제안이 포함되어 있으며 AI 실패가 비즈니스 흐름을 차단하지 않도록 설계된 점이 명시되어 있습니다. 고객 프로필·상거래 기회·태스크·지식베이스·운영 분석과 기업용 IMAP/SMTP 연동, 선택적 Stripe 결제 연동까지 CRM·고객지원 워크플로우를 통합하려는 팀에 필요한 구성 요소가 광범위하게 담겨 있습니다.
• 개발자용 준비 상태로는 npm 기반 로컬 개발과 server 디렉토리에서의 직접 서버 기동 절차가 문서화되어 있습니다. 타입체크, 빌드, 단위·통합 테스트와 Playwright 기반 e2e 테스트 스크립트가 포함되어 있고 GitHub Actions CI 배지가 있어 기본적인 품질 검증 파이프라인이 존재합니다. CONTRIBUTING.md와 SECURITY.md에 따라 인증·테넌트·메시지·결제·DB 구조 변경 시 추가 테스트와 보안 문서 보완을 요구하므로 협업·운영 정책이 마련되어 있습니다.