beakston/centerpiece

CenterPiece Docker镜像文档

镜像概述

CenterPiece是一款专为Agility ERP与Trello系统集成设计的工具，旨在打通企业资源规划（ERP）与项目管理工具间的数据壁垒，实现业务数据双向流转与流程自动化，提升跨系统协作效率。

核心功能与特性

核心功能

• 双向数据同步：支持Agility ERP与Trello间关键业务数据（如订单、任务、库存状态等）的实时或定时双向同步
• 流程自动化：可配置触发规则，实现事件驱动的自动化流程（如Agility ERP新订单创建后自动在Trello生成任务卡片）
• 数据格式转换：内置数据映射引擎，自动处理两系统间数据结构差异，确保信息一致性

特性

• 配置灵活性：通过环境变量或配置文件自定义同步规则、频率及数据映射关系
• 轻量部署：基于Docker容器化设计，部署简单，资源占用低
• 日志监控：提供详细同步日志，便于问题排查与流程审计
• 安全认证：支持Agility ERP与Trello官方API认证机制，保障数据传输安全

使用场景与适用范围

典型使用场景

• 电商运营：Agility ERP订单数据同步至Trello，实现客服团队任务跟踪
• 生产管理：Agility ERP生产计划同步至Trello看板，生产团队实时更新执行进度
• 库存管理：Trello库存检查任务完成后，自动更新Agility ERP库存状态
• 客户服务：Trello客户问题卡片状态变更时，同步至Agility ERP客户档案

适用范围

• 同时使用Agility ERP和Trello进行业务管理的企业或团队
• 需要跨系统数据整合与流程自动化的中小型企业
• 希望减少手动数据录入、提升协作效率的运营/项目团队

使用方法与配置说明

前置条件

• 已部署Agility ERP并获取API访问权限（API地址、访问密钥）
• 已创建Trello账号及目标看板，获取Trello API密钥、令牌（Token）及看板ID
• 安装Docker Engine（20.10+）或Docker Compose（2.0+）

Docker部署示例

1. 基础部署（docker run）

bash
docker run -d \
  --name centerpiece \
  -e AGILITY_API_URL="https://your-agility-erp.com/api/v1" \
  -e AGILITY_API_KEY="your-agility-api-key" \
  -e TRELLO_API_KEY="your-trello-api-key" \
  -e TRELLO_TOKEN="your-trello-token" \
  -e TRELLO_BOARD_ID="your-trello-board-id" \
  -e SYNC_INTERVAL="5m" \  # 同步频率，支持s(秒)/m(分)/h(时)
  -v /path/to/your/config:/app/config \  # 挂载自定义配置文件（可选）
  centerpiece:latest

2. Docker Compose部署

创建docker-compose.yml文件：

yaml
version: '3'
services:
  centerpiece:
    image: docker.xuanyuan.run/centerpiece:latest
    container_name: centerpiece
    restart: always
    environment:
      - AGILITY_API_URL=https://your-agility-erp.com/api/v1
      - AGILITY_API_KEY=your-agility-api-key
      - TRELLO_API_KEY=your-trello-api-key
      - TRELLO_TOKEN=your-trello-token
      - TRELLO_BOARD_ID=your-trello-board-id
      - SYNC_INTERVAL=5m
      - LOG_LEVEL=info  # 日志级别：debug/info/warn/error
    volumes:
      - ./centerpiece-config:/app/config  # 自定义同步规则配置目录
    networks:
      - erp-trello-network

networks:
  erp-trello-network:
    driver: bridge

启动服务：

bash
docker-compose up -d

关键配置参数

环境变量配置

自定义同步规则（可选）

通过挂载配置目录（如/app/config），可创建sync-rules.yaml文件定义具体同步规则，示例：

yaml
rules:
  - name: "ERP订单同步至Trello卡片"
    source: "agility"
    resource: "orders"  # Agility ERP资源类型
    trigger: "created"  # 触发条件：created/updated/deleted
    target: "trello"
    action: "create_card"  # Trello动作：create_card/update_card/delete_card
    mapping:  # 数据字段映射
      trello.card.name: "Order {{order_number}} - {{customer_name}}"
      trello.card.desc: "Order total: {{total_amount}} | Due date: {{due_date}}"
      trello.card.list_id: "60a2b3c4d5e6f7a8b9c0d1e2"  # 目标列表ID

日志与监控

• 容器日志查看：docker logs -f centerpiece
• 日志文件路径（容器内）：/app/logs/centerpiece.log（可通过挂载目录持久化）

注意事项

• 确保Agility ERP与Trello API访问权限足够（如Agility需读取订单、Trello需读写卡片权限）
• 首次部署建议先使用LOG_LEVEL=debug排查配置问题
• 大规模数据同步建议适当延长SYNC_INTERVAL避免API请求限流
• 定期备份同步规则配置文件，防止配置丢失