在Aleph项目中创建自定义FTM模型的技术指南

FollowTheMoney(FTM)是Aleph数据分析平台的核心数据模型框架。开发者可以通过扩展FTM模型来满足特定业务场景的数据需求。本文将详细介绍创建自定义FTM模型的技术实现方案。

FTM模型基础概念

FTM模型采用实体-关系(Entity-Relationship)范式，主要包含以下核心元素：

1. 实体类型(Entity)：如公司、人员、资产等
2. 属性(Property)：描述实体的特征字段
3. 关系(Relation)：实体间的关联方式

自定义模型创建步骤

1. 定义模型结构

创建YAML格式的模型定义文件，示例结构如下：

# my_schema.yml
name: CustomEntity
label: 自定义实体
extends: [Thing]
properties:
  customField:
    label: 自定义字段
    type: string
    description: 示例自定义属性

2. 模型加载机制

在Python代码中通过以下方式加载自定义模型：

from followthemoney import model

# 加载自定义模型
with open('my_schema.yml') as f:
    model.make(f)

3. 模型验证方法

创建模型后需要进行验证：

schema = model.get('CustomEntity')
assert schema is not None
prop = schema.get('customField')
assert prop.type == 'string'

高级扩展技巧

继承现有模型

可以通过extends字段继承基础模型：

name: EnhancedCompany
extends: [Company]
properties:
  riskScore:
    type: number
    range: [0, 100]

多语言支持

模型支持国际化标签：

label:
  en: Custom Entity
  zh: 自定义实体

数据类型规范

FTM支持丰富的数据类型：

• 基础类型：string、number、date等
• 复合类型：url、email、phone等
• 特殊类型：entity、country等

在Aleph中的集成应用

自定义模型在Aleph中的典型应用场景包括：

1. 行业特定数据建模（如金融交易、供应链等）
2. 扩展实体关联关系
3. 添加业务特定属性字段

最佳实践建议

1. 保持向后兼容性
2. 合理设计属性粒度
3. 建立完善的文档说明
4. 进行充分的测试验证

通过合理扩展FTM模型，可以显著提升Aleph平台处理特定领域数据的能力，同时保持系统的标准化和互操作性。