Integration 概览

什么是 Integration？

Integration 是指把外部系统（Vendor）连接到 RightCapital 平台。Integration Team 负责：

Data Integration：把 Vendor 的金融数据（positions、holdings、insurance）同步到 RightCapital。
SSO（Single Sign-On）：让 Advisor 可以在 RightCapital 和 Vendor 系统之间无感登录。
CRM Integration：从 Vendor 系统导入 household/client 信息。

Integration 为什么重要

业务背景：Advisor 的客户（household）通常把资产分散在多个机构，例如不同银行的 savings account 和不同 brokerage 的 investment account。

价值：Integration 让 Advisor 可以：

快速将 household financial data 导入 RightCapital。
每天自动同步 Vendor 数据。
节省手工录入所需的时间和精力。

Integration 组件

组件	说明	主要用途
Data Integration	同步 securities、positions、insurance data	日常核心操作
Morningstar	Security Master 数据源（prices、fundamentals）	Security matching 和 pricing
SSO	single sign-on authentication	无缝登录体验
CRM Integration	Household 和 contact information	Client data import

核心概念

Vendor

RightCapital 接入的外部金融机构或数据提供方，例如 Schwab、Fidelity、TD Ameritrade、Orion。

Rep Code

Advisor 在 Vendor 系统中的唯一标识。File-based integration 使用它把文件关联到具体 Advisor。

Integration Mapping

RightCapital Advisor 与其 Vendor 身份之间的关联（File-based 使用 Rep Code，API-based 使用 OAuth token）。

Link Account

Advisor 为某个 household 选择要从 Vendor 导入到 RightCapital 的 accounts 的过程。

Nightly Sync

每天运行的定时批处理（通常在 US evening），用于更新所有 Vendor integration 数据。

Data Integration Types

File-based Integration

已迁移：Vendor SFTP → Collector → raw S3 → Lambda → normalized S3 → ELT/Snowflake → Retail API → Database
legacy：Vendor SFTP → Collector → S3 latest → Retail API parser → Database

已迁移 vendor 的流程是：

Vendor 通过 SFTP 提供数据文件
Collector 下载/接收文件并写入 raw S3
Lambda 生成 normalized 文件，integrations/elt 写入 Snowflake target tables
Retail API 在 ELT completion 后读取 target tables 并写入 database

legacy vendor 才由 Retail API 直接解析 S3 的 LATEST/latest 文件。

主要特征：

Data files 包含用于识别 advisor 的 Rep Code。
Support team 在 Admin Center 创建 integration mapping。
文件通常包含 accounts、positions、securities、tax lots。

API-based Integration

Retail API → Vendor API → Database

Advisor authorizes RightCapital via OAuth or similar
RightCapital stores authorization credentials
System calls Vendor API to fetch data

Key Characteristics:

Advisor self-service authorization flow
Real-time or near-real-time data access
Common auth methods: OAuth 2.0, API tokens

工作流：Advisor 如何使用 Integration

创建 Integration

File-based:

Advisor contacts Support
Support guides advisor to request data push from Vendor
Vendor starts sending files to RightCapital
Support creates integration mapping with advisor’s Rep Code

API-based:

Advisor goes to Advisor Portal → Integrations
Selects Vendor and follows authorization flow
System stores credentials, integration is active

导入数据

Advisor opens Client Portal → Profile → Net Worth → Link Account
Selects a Vendor from their active integrations
System displays available households/accounts from Vendor
Advisor selects which data to import
Data is saved to the current household

删除数据

Unlink specific account: Client Portal → Link Account → uncheck the item
Remove entire integration:
- File-based: Contact Support to remove Rep Code
- API-based: Advisor Portal → Integrations → disconnect

关键系统

System	URL Pattern	Purpose
Advisor Portal	`app.rightcapital.{com,qa,net}`	Advisor-facing, integration management
Client Portal	`client.rightcapital.{com,qa,net}`	Client-facing, Link Account feature
Admin Center	`admin.rightcapital.{com,qa,net}`	Support/Admin, integration configuration