coco/composite-orgs-transformer

Composite Organisations Transformer

镜像概述

本镜像用于整合来自https://github.com/Financial-Times/v1-orgs-transformer和(v2-)orgs-transformer的组织数据，通过Bertha提供的concordance数据合并结果。初始化时缓存concordance数据、UUID列表及合并后的组织信息，优化请求响应效率。

核心功能

1. 数据整合：合并v1和v2转换器的组织数据，生成完整结果。
2. 缓存机制：将concordance数据、UUID列表及合并组织信息存储于嵌入式boltdb。
3. 请求处理：已合并的组织请求从缓存返回，未合并的转发至对应转换器。
4. 端点支持：提供应用端点（组织查询、计数、ID列表）和管理端点（健康检查、构建信息）。

使用场景

• 统一访问v1和v2组织数据的业务场景。
• 需要整合组织数据获取完整信息的需求。
• 降低后端转换器负载的高效缓存场景。

配置说明

通过环境变量配置参数：

• V1_TRANSFORMER_URL：v1组织转换器URL。
• FS_TRANSFORMER_URL：v2组织转换器URL。
• CACHE_FILE_NAME：缓存文件名称（默认：cache.db）。

Docker部署示例

构建镜像

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

运行容器

bash
docker run -p 8080:8080 \
    --env "V1_TRANSFORMER_URL=http://user:password@pub-pre-prod-up.ft.com/__v1-orgs-transformer/transformers/organisations" \
    --env "FS_TRANSFORMER_URL=https://v2-organisations-transformer-up.ft.com/transformers/organisations" \
    --env "CACHE_FILE_NAME=cache.db" \
    docker.xuanyuan.run/coco/composite-orgs-transformer

请求示例

仅v2存在的组织

bash
curl https://user:password@pub-pre-prod-up.ft.com/__composite-orgs-transformer/transformers/organisations/f7a4f045-d55c-338d-b1b6-4d92c2e7d30c

仅v1存在的组织

bash
curl https://user:password@pub-pre-prod-up.ft.com/__composite-orgs-transformer/transformers/organisations/b47d4c17-bbde-3351-a58b-019d25b95052

同时存在于v1和v2的组织

bash
curl https://user:password@pub-pre-prod-up.ft.com/__composite-orgs-transformer/transformers/organisations/0e474c59-6d06-3c86-868b-6a9f1249f8e7

注意：合并后的组织字段主要来自v2，alternativeIdentifiers.TME来自v1，alternativeIdentifiers.uuids为v1和v2 UUID的组合。