Integration 术语表
Advisor
Section titled “Advisor”使用 RightCapital 管理客户 financial plans 的 financial advisor。Advisor 是 integration 功能的主要使用者。
Household
Section titled “Household”由 advisor 管理的客户单位，通常代表拥有金融资产的家庭或个人。每个 household 可以通过 integration 关联多个 accounts。
Account
Section titled “Account”属于 household 的金融账户（brokerage、bank、insurance 等）。Account 通过 integration 流程从 Vendor 关联进来。
Vendor
Section titled “Vendor”RightCapital 接入的外部系统或金融机构，例如 Schwab、Fidelity、Orion、TD Ameritrade。
Integration
Section titled “Integration”RightCapital 与 Vendor 之间用于同步数据的连接，可以是 file-based 或 API-based。
Integration Mapping
Section titled “Integration Mapping”将 RightCapital entity（advisor、household、account）关联到 Vendor 对应实体的数据库记录。
Rep Code
Section titled “Rep Code”Advisor 在 Vendor 系统中的唯一标识，主要用于 file-based integration，将数据文件关联到具体 advisor。
Reference
Section titled “Reference”integration 表中保存 Vendor entity identifier 的字段，与 credentials 不同。
Credentials
Section titled “Credentials”访问 Vendor API 所需的认证信息（OAuth tokens、API keys、passwords），以加密形式保存。
Mappable Type
Section titled “Mappable Type”integration 中被映射实体的类型（household、account 等）。不同 mappable type 的同步行为不同。
LATEST 文件
Section titled “LATEST 文件”S3 上指向 Vendor 最新数据文件的兼容性文件或 symlink。legacy Retail API parser 可能使用它查找当前数据；但部分已完成 ELT cutover 的 vendor 仍可能生成 LATEST，是否由 Retail API 消费必须以 isMigratedToElt() 和 vendor 配置为准。
Security Master
Section titled “Security Master”证券信息（stocks、bonds、funds）的权威数据源，主要来自 Morningstar。
Position
Section titled “Position”Account 中某个具体 security 的持仓，包含 quantity、market value 等信息。
Holding
Section titled “Holding”账户中资产的统称，可以包括 securities（positions）、cash、insurance、real estate 等。
Tax Lot
Section titled “Tax Lot”一次具体的 security purchase，拥有独立的 cost basis 和 acquisition date，用于税务计算。
Committee on Uniform Securities Identification Procedures. A 9-character identifier for North American securities.
Net Asset Value. The per-share value of a mutual fund or ETF.
Integration 类型
Section titled “Integration 类型”File-based Integration
Section titled “File-based Integration”Vendor 通过 SFTP 等方式推送数据文件，由 Collector 采集；后续可能进入 Lambda/ELT，也可能由 legacy Retail API parser 处理。
API-based Integration
Section titled “API-based Integration”RightCapital 调用 Vendor API 获取数据的 integration。具体运行链路需按 vendor contract 确认，不能仅凭类型假设一定直写 PostgreSQL。
Nightly Sync
Section titled “Nightly Sync”每天更新 integration 数据的定时 batch process。数据可能来自 Snowflake target tables、Vendor API 或 legacy parser。
Link Account
Section titled “Link Account”用户选择要导入 RightCapital household 的 Vendor accounts 的操作。
SSO 术语
Section titled “SSO 术语”SSO (Single Sign-On)
Section titled “SSO (Single Sign-On)”让用户使用一组 credentials 登录多个系统的认证机制。
IdP (Identity Provider)
Section titled “IdP (Identity Provider)”负责认证用户并提供 identity assertions 的系统。在 Vendor SSO 中，Vendor 通常是 IdP。
SP (Service Provider)
Section titled “SP (Service Provider)”接收 authentication assertions 并提供服务的系统。RightCapital 通常是 SP。
Security Assertion Markup Language，一种用于交换认证数据的 XML-based protocol。
Contextual SSO
Section titled “Contextual SSO”包含额外上下文（例如 household ID）的 SSO，可自动导航到指定数据。
Collector
Section titled “Collector”从 Vendor SFTP 下载文件、完成文件级处理并上传到 S3 的服务。
Admin Center
Section titled “Admin Center”用于管理 integration、查看日志和支持 advisor 的内部管理应用。
Retail API
Section titled “Retail API”处理 integration 数据并为 advisor-facing application 提供服务的主要 backend service。
integrations
Section titled “integrations”保存 advisor 与 Vendor 之间的连接，包含 credentials 和 reference 信息。
integration_mappings
Section titled “integration_mappings”保存 RightCapital entities 与 Vendor entities 的 mapping，将 households/accounts 关联到 Vendor 对应实体。