crm-ai/twenty/README.md

Twenty 部署说明（全新实例 :3100）

本目录不需要源码：使用官方镜像 twentycrm/twenty:v2.30.1，由顶层 docker-compose.yml 编排。

与旧实例的区别

	旧实例（crm-ai-demo）	新实例（crm-new）
端口	3000	3100
数据库	crm-postgres / twenty	crmnew-postgres:5440 / twenty
Redis	crm-redis db1	crmnew-redis db1
镜像	twentycrm/twenty:flywheel（定制前端）	twentycrm/twenty:v2.30.1（官方）
数据	旧数据保留	全新，无旧数据

首次使用

1. 浏览器打开 http://localhost:3100
2. 注册第一个 workspace（邮箱 + 密码），工作区名建议 Yehwang
3. 进入 Settings → Developers → API Keys 创建 API key（JWT 形式）
4. 把 API key 和 workspace id 写入顶层 .env：

TWENTY_WORKSPACE_ID=<workspace uuid>
TWENTY_API_KEY=<jwt>

5. 重建 bridge 让配置生效：

cd /home/dev/code/crm-new
docker compose up -d --force-recreate bridge

6. 验证工具：

bash scripts/smoke.sh
curl -s http://localhost:4100/healthz

数据存储

• 业务数据：crmnew-postgres 的 twenty 库
• 文件：Docker volume crm-new_twenty-data（容器内 .local-storage）

注意

• ENCRYPTION_KEY / APP_SECRET 首次生成后不要随意更换，否则已加密数据（API key、连接配置）会失效。
• Twenty 首次启动会跑数据库迁移，约 1–3 分钟；bootstrap.sh 已内置等待。
• 如果需要旧项目的“数据飞轮”定制页，需要另做前端构建，本新栈暂不包含。