coco/v1-orgs-transformer

v1-orgs-transformer

镜像概述

本镜像封装了Financial-Times开发的v1-orgs-transformer服务，用于从TME（Taxonomy Management Environment）获取组织分类数据，并将其转换为内部UP JSON模型，同时提供RESTful接口供外部系统访问转换后的组织信息。

核心功能

1. 从TME获取组织分类数据并转换为标准化UP JSON模型
2. 提供接口获取所有组织的APIURL列表
3. 支持按UUID查询特定组织的详细信息
4. 获取所有组织的ID列表及数量统计
5. 重新加载TME数据并重建本地缓存
6. 提供健康检查、Ping等管理端点

使用场景

适用于需要集成组织分类数据的内部系统，如企业信息管理平台、数据集成服务等，帮助快速获取标准化的组织信息。

配置说明

通过环境变量配置服务参数：

• PORT: 服务监听端口（默认8080）
• BASE_URL: 服务基础URL（如http://localhost:8080/transformers/organisations/）
• TME_BASE_URL: TME服务基础URL（如[***]）
• TME_USERNAME: TME访问用户名
• TME_PASSWORD: TME访问密码
• TOKEN: 服务访问令牌
• CACHE_FILE_NAME: 缓存文件名称（默认cache.db）

Docker部署示例

构建镜像

bash
docker build -t coco/v1-orgs-transformer .

运行容器

bash
docker run -ti \
  --env BASE_URL="<服务基础URL>" \
  --env TME_BASE_URL="<TME服务URL>" \
  --env TME_USERNAME="<TME用户名>" \
  --env TME_PASSWORD="<TME密码>" \
  --env TOKEN="<访问令牌>" \
  --env CACHE_FILE_NAME="<缓存文件名>" \
  docker.xuanyuan.run/coco/v1-orgs-transformer

接口说明

业务接口

• GET /transformers/organisations: 返回所有组织的APIURL列表，成功返回200
• GET /transformers/organisations/{uuid}: 根据UUID获取组织详情，存在返回200，不存在返回404
• GET /transformers/organisations/__ids: 返回所有组织的ID列表，成功返回200
• GET /transformers/organisations/__count: 返回缓存中的组织数量，成功返回200
• POST /transformers/organisations/__reload: 重新加载TME数据并重建缓存，成功返回200

管理接口

• 健康检查：/__health
• Ping：/__ping 或 /ping
• 构建信息：/__build-info 或 /build-info
• 就绪检查：/__gtg