hoanganh8389/bizcity-twin-ai

Make WordPress as an AI operating system, every plugin becomes an agentic tool The "online Claude" vision — natural language → classify → plan → multi-step execution across plugins, zero config

Bizcity Twin AI – WordPress 기반 AI "디지털 트윈" 플랫폼

모든 채널에 하나의 뇌 – 이 프로젝트는 WordPress 사이트를 기업용 통합 AI 지식 허브로 전환합니다. Facebook, Zalo, 이메일, 웹채팅, Telegram, TikTok 등 다양한 커뮤니케이션 채널에서 데이터를 수신하고, 지식 그래프(KG) 허브를 구축하며, 관리형 제어 플레인(MCP) 을 통해 대규모 언어 모델 어시스턴트(Claude, ChatGPT 등)에 데이터를 공개합니다. 핵심 기능은 공유되는 "뇌"(ID, KG, 메모리, 추론, 로깅, 자동화, 권한)를 제공합니다. 기능은 플러그인을 통해 확장되며, 핵심 코드를 수정하지 않고도 도메인 특화 액션, 새로운 채널 어댑터, 또는 UI 뷰를 추가할 수 있습니다.

기능 개요

영역	핵심이 제공하는 것	플러그인으로 확장하는 방법
채널 게이트웨이	입/출력 메시지를 표준화하고, 테넌트 전체 ID와 연결하며, CRM 또는 추론 엔진으로 라우팅.	`channel` 플러그인으로 새로운 소스(예: TikTok 웹훅) 또는 사용자 정의 라우팅 규칙 추가.
TwinCRM	통합 수신함, 연락처, 대화, 캠페인 보고서.	`act` 플러그인으로 주문 생성, 레코드 업데이트, 알림 전송 등 수행.
TwinBrain / MPR	각 단계별 다단계 추론, 도구 선택 및 오케스트레이션.	`act` 플러그인으로 타입 지정된 도구(예: "create-invoice")를 공개하여 뇌가 호출할 수 있도록.
KG 허브	엔티티, 문장, 출처를 저장하고, 인용을 포함한 그래프 검색 제공.	`source` 플러그인으로 새로운 문서(제품 카탈로그, 법적 문서, POS 로그)를 KG에 공급.
자동화 및 스케줄러	사용자 설정 워크플로우(트리거, 조건, 액션)와 승인 게이트.	`act`/`view` 플러그인으로 워크플로우에서 사용되는 구체적인 액션 제공.
MCP	정책 기반 API로 외부 LLM(Claude, ChatGPT)이 KG를 질의하거나 도구를 호출할 수 있도록 엄격한 접근 제어 제공.	플러그인은 동일한 정책 계층을 준수하는 추가 엔드포인트를 공개할 수 있음.
TwinShell / Twin GPT	내장 채팅 UI(`/gpt/`) 및 내부 사용자용 관리 콘솔.	`view` 플러그인으로 대시보드, 보고서, 사용자 정의 관리 페이지 추가.

핵심 개념 ("삼축" 아키텍처)

수평축 – 채널 게이트웨이 – 모든 외부 채널에서 원시 메시지를 수집하고 공통 데이터 패키지로 표준화.
수직축 – 전문 플러그인 – 각 플러그인이 도메인(영업, 재무, 법무, 콘텐츠 등)을 제공하며 핵심 서비스의 중복을 피함.
지식 그래프 계층 – 모든 사실을 출처와 함께 저장하는 단일 KG 허브. 뇌는 근거 기반 답변을 얻기 위해 이를 질의함.

일반적인 사용 사례

사용 사례	흐름 (간략화)
다중 채널 영업 어시스턴트	고객 메시지 → 채널 게이트웨이 → TwinCRM 수신함 → KG(제품 + 고객 컨텍스트) → TwinBrain가 응답 도구 선택 → (옵션) 인간 승인 → 동일 채널을 통해 응답 전송.
고객 인사이트 대시보드	CRM/POS에서 주기적 ETL → `source` 플러그인이 문장을 KG에 푸시 → 분석 도구가 인용을 포함해 KG를 읽음 → `view` 플러그인이 신뢰도 점수 기반 인사이트를 대시보드로 렌더링.
내부 운영 봇 (Telegram/Zalo)	관리자 명령 → 채널 게이트웨이(존 2) → ID 확인 → TwinBrain가 워크플로우 실행(예: 보고서 생성, CI 트리거) → 결과를 봇에 다시 게시.
TikTok용 콘텐츠 생성	트렌드 조사 → KG 기반 검색 → 동영상 생성 도구 → 승인 단계 → TikTok 게시 어댑터(새로운 `channel` 플러그인).

기술 스택

구성 요소	기술
플랫폼	WordPress ≥ 6.0 (PHP 7.4+) – 핵심은 일반 WP 플러그인이므로, 어떤 WP 호스팅도 실행 가능.
핵심 언어	PHP (객체 지향, 의존성은 Composer 사용).
지식 그래프	WP 데이터베이스에 저장; 문장은 빠른 벡터/그래프 검색을 위해 인덱싱됨 (플랫폼이 인덱스 및 검색 API 제공).
LLM 통합	MCP가 프로바이더를 추상화; 내장 클라이언트 클래스가 HTTP를 통해 Claude, OpenAI ChatGPT 등과 통신.
CLI / 스크래핑	WP-CLI 명령 (`wp bizcity make:*`, `wp bizcity health`, `wp bizcity plugin lint`).
로그 및 감사	중앙 `bizcity_log_index`를 가진 JSONL 파일; 로그에는 출처는 포함되지만 원시 시크릿이나 PII는 포함되지 않음.
자동화	핵심에 내장된 DAG 기반 워크플로우 엔진; 플러그인은 입력, 출력, 동일성, 재시도 정책을 선언하는 블록을 제공.

프로젝트 건강 및 성숙도

버전: 1.3.7 (배지에 표시됨).
라이선스: GPL-2.0-or-later – 완전히 오픈소스.
문서: 상세한 개발자 가이드 (docs/vibe/README.md), 기여 가이드, 공개된 개발 체크리스트.
데모 인스턴스: 관리 콘솔, GPT UI, CRM용 라이브 데모 사이트 제공 (libedemo.bizcity.vn).
테스트: 내장된 린트(wp bizcity plugin lint), 진단 도구, 그리고 플러그인을 좁은 사전에서 실행하여 계약을 검증하는 "프로브" 명령어.
로드맵: 핵심에서 더 많은 전문 기능을 분리하는 작업 진행 중, 선택적 KG 인게스트 개선, TikTok 고객 메시징 어댑터 완성도 진행 중.

시작하기 (빠른 시작 단계)

# 1. WordPress 사이트에 설치 (6.0+ 및 PHP 7.4+ 필요)
cd wp-content/plugins
git clone https://github.com/hoanganh8389/bizcity-twin-ai.git
cd bizcity-twin-ai
composer install   # PHP 종속성 다운로드
wp plugin activate bizcity-twin-ai

# 2. WP 관리 패널에서 LLM/API 키 추가 (BizCity AI → LLM 설정).

# 3. 설치 확인
wp bizcity health --format=json   # 헬스 체크
wp bizcity sdk-check --format=json # 핵심 SDK 호환성 체크

# 4. 새 플러그인 스크래핑 (예: 고객 인사이트)
wp bizcity make:plugin customer-insight --name="Customer Insight"
wp bizcity make:source crm --plugin=customer-insight
wp bizcity make:tool analyze-customer --plugin=customer-insight
wp bizcity make:event insight-created --plugin=customer-insight
wp bizcity make:diagnostic runtime --plugin=customer-insight

# 5. 생성된 TODO를 비즈니스 로직으로 채우고, 린트 및 프로브 실행
wp bizcity plugin lint customer-insight --json --strict
wp bizcity probe --id=plugins.customer_insight.runtime --format=json

스크래핑은 매니페스트, 타입 지정된 계약, 진단, 제거 보호를 생성하므로 개발자는 도메인 특화 코드만 구현하면 됩니다.

누구에게 적합한가?

이미 WordPress를 운영 중인 중소기업 또는 중견 기업으로, 영업, 지원, 내부 운영용 단일 감사 가능한 AI "뇌"를 원하는 사람.
맞춤형 AI 강화 CRM을 개발하는 개발자 – 핵심의 KG, 추론, 보안 계층을 재사용하면서 도메인 플러그인에 집중할 수 있음.
외부 LLM에 내부 데이터를 공개할 때 엄격한 출처(그래프 인용, JSONL 감사)가 필요한 AI-ops 팀.

요약

Bizcity Twin AI는 다중 채널 데이터 수신, 지식 그래프 기반 검색, LLM 기반 추론, 플러그인 우선 확장성을 WordPress 위에 통합한 진정한 오픈소스 플랫폼입니다. 기업의 "디지털 트윈"으로서, 개발자가 데이터 거버넌스와 감사 가능성을 통제하면서도 AI 기반 CRM, 영업, 지원, 자동화 도구를 구축할 수 있도록 지원합니다.