semprini/cbe-retail

cbe-retail镜像概述

cbe-retail是Common Business Entities（CBE）框架的零售扩展镜像，用于零售运营场景下的主数据治理。它提供RESTful CRUD及管理能力，支持关系型数据库与（即将支持的）NoSQL数据库的多语言持久化模型，为企业主数据治理提供基础架构。

核心功能

1. 零售扩展实体：包含Store（门店）、Credit（信用）、Sale（销售）、Order（订单）、Product（产品）、Pricing（定价）、Customer Bill（客户账单）、Loyalty（忠诚度）、Market（市场）等实体。
2. 继承CBE核心实体：涵盖business_interaction（业务交互）、customer（客户）、location（位置）、party（参与方）、trouble（问题）、physical_object（物理对象）、supplier_partner（供应商伙伴）、resource（资源）、human_resources（人力资源）等基础实体。
3. RESTful API支持：提供主数据的增删改查及管理接口。
4. 多数据库支持：兼容关系型数据库，并计划支持NoSQL数据库。
5. 松耦合架构：助力企业构建微服务架构，避免数据不一致问题，支持混合云或云部署模式。

使用场景

• 零售企业主数据管理：统一管理零售业务中的各类核心数据，确保数据一致性。
• 微服务架构支撑：作为微服务的数据层，让微服务无需独立数据库，通过API访问统一数据，实现松耦合。
• 混合云/云部署：适配混合云或纯云环境，提供跨后端与门店的API层，无需集成总线。
• 数据治理优化：简化集成、BI及报表等领域的工作，将业务数据作为独立产品进行治理。

配置说明

1. 数据库配置：需配置关系型数据库（如MySQL、PostgreSQL）连接信息，包括地址、端口、用户名、密码等。
2. API端口配置：默认端口为8080，可通过环境变量调整。
3. 持久化设置：根据需求选择关系型数据库或后续支持的NoSQL数据库。

Docker部署示例

Docker Run命令

bash
docker run -d \
  -p 8080:8080 \
  -e DB_HOST=your_db_host \
  -e DB_PORT=your_db_port \
  -e DB_USER=your_db_user \
  -e DB_PASSWORD=your_db_password \
  semprini/cbe-retail

Docker Compose示例

yaml
version: '3'
services:
  cbe-retail:
    image: semprini/cbe-retail
    ports:
      - "8080:8080"
    environment:
      - DB_HOST=db
      - DB_PORT=5432
      - DB_USER=postgres
      - DB_PASSWORD=postgres
    depends_on:
      - db
  db:
    image: postgres:14
    environment:
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
    volumes:
      - postgres_data:/var/lib/postgresql/data
volumes:
  postgres_data: