Skip to content
RightCapital Knowledge Base

Security 类型体系 — Equity / Fixed Income / Fund

RC 系统中所有可交易的证券统一存储在 securities 表中，通过 type 字段区分三大类，每类有独立的 1:1 子表承载专属属性。

概念对比

Section titled “概念对比”
Equity（股票） Fixed Income（债券） Fund（基金）
你持有的 公司的一部分所有权 对发行方的债权 一篮子资产的份额
收益来源 股价上涨 + 股息 固定票息 + 到期还本 净值变动 + 分红
风险特征 高波动，无保本 信用风险 + 利率风险 取决于底层持仓
到期日 无 有明确到期日 开放式基金无
发行方 上市公司 政府 / 公司 基金公司

数据模型

Section titled “数据模型”
securities (主表)
├── type = 'equity'       → equities       (1:1)
├── type = 'fixed_income' → fixed_incomes  (1:1)
└── type = 'fund'         → funds          (1:1)

主表 securities

Section titled “主表 securities”

所有证券的通用标识和元信息：

字段 类型 说明
type enum equity | fund | fixed_income
name string 证券名称
symbol string 交易代码（如 AAPL）
normalized_symbol string 标准化后的 symbol（去特殊字符、大写）
cusip string(9) CUSIP 标识
isin string(12) ISIN 标识
reference string 供应商侧唯一标识
source enum 数据来源（morningstar、brokerage、generic 等 47 种）
exchange_id int FK → exchanges
organization_id int 所属组织

三个 scope 方法：

Security::equities()     → where type = 'equity'
Security::fixedIncomes() → where type = 'fixed_income'
Security::funds()        → where type = 'fund'

equities 表 — 股票专属属性

Section titled “equities 表 — 股票专属属性”
字段 类型 说明
security_id int FK → securities.id
sector_id int FK → sectors（11 个股票板块）
category_id int FK → categories（风格类别）
capitalization enum small | middle | large
valuation enum value | blend | growth
country string(3) 3 字母 ISO 国家代码

股票的核心分析维度：

  • Sector → 来自 Morningstar GECS Sector 层，11 个板块（详见 Sector 分类）
  • Category → capitalization × valuation = 9 宫格 Style Box
  • Country → 用于判定 developed / emerging 市场

fixed_incomes 表 — 债券专属属性

Section titled “fixed_incomes 表 — 债券专属属性”
字段 类型 说明
security_id int FK → securities.id
sector_id int FK → sectors（6 个债券板块）
category_id int FK → categories
subtype enum bond | cd | mbs
market enum developed | emerging
quality enum aaa | aa | a | bbb | bb | b | below | unrated

债券的分析维度：

  • Subtype：bond（普通债券）、cd（大额存单）、mbs（抵押贷款支持证券）
  • Quality：信用评级，直接影响风险分析和收益假设
  • Market：发达国家 / 新兴市场
  • Sector：不同于股票的板块体系（Government、Corporate、Securitized 等）

funds 表 — 基金专属属性

Section titled “funds 表 — 基金专属属性”
字段 类型 说明
security_id int FK → securities.id
subtype enum etf | open_end | closed_end | uit | money_market
expense_ratio float 费率（%）

基金不直接有 sector / category，而是通过 allocations 分配表“透视”底层持仓：

关联表 用途
allocations_by_asset_type 大类资产分配（US/Non-US Equity、US/Non-US Bond、Cash…）
allocations_by_sector 行业板块分配（11 个股票板块各占 %）
allocations_by_category 风格类别分配
allocations_by_market 发达 / 新兴市场分配
allocations_by_bond_quality 债券信用评级分配
allocations_by_equity_style 股票 9 宫格风格分配
fund_equity_portfolio 股票持仓明细
fund_bond_portfolio 债券持仓明细（duration、maturity）

基金的设计核心是 “透视”（look-through）：虽然基金本身是一个 Security，但通过 allocations 层层拆解到底层 equity/bond，从而穿透分析客户组合的真实风险暴露。

// 基金模型上的计算属性
$fund->equity_percentage;  // 底层股票占比
$fund->bond_percentage;    // 底层债券占比
$fund->percentages_by_category_id; // 风格类别分布
$fund->percentages_by_equity_style; // 9 宫格分布

Fund Subtype 详解

Section titled “Fund Subtype 详解”

Fund 的 subtype 区分的是法律结构和交易机制——同样是“一篮子资产”，不同 subtype 的申赎方式、定价频率、流动性完全不同。

enum FundSubtype: string
{
    case ETF          = 'etf';           // 交易所交易基金
    case OPEN_END     = 'open_end';      // 开放式基金（共同基金）
    case CLOSED_END   = 'closed_end';    // 封闭式基金
    case UIT          = 'uit';           // 单位投资信托
    case MONEY_MARKET = 'money_market';  // 货币市场基金
}
Subtype 中文 交易方式 定价 份额可变？ 典型例子
ETF 交易所交易基金 交易所实时买卖，像股票一样 盘中实时市价 是（授权参与人创建/赎回） SPY, QQQ
Open-End 开放式基金 通过基金公司每日申赎 每日收盘后 NAV 是 VTSAX
Closed-End 封闭式基金 交易所买卖 市价（可能溢价/折价于 NAV） 否（固定份额） 市政债 CEF
UIT 单位投资信托 通过发行商申赎 基于底层资产估值 否（固定组合+到期日） 固定收益 UIT
Money Market 货币市场基金 通过基金公司每日申赎 稳定 $1 NAV 是 VMFXX

为什么需要区分

Section titled “为什么需要区分”

1. 申购/赎回机制不同

ETF 和 Closed-End 在交易所交易（有 bid/ask spread），Open-End 和 Money Market 是按 NAV 申赎。在 brokerage 集成中直接影响持仓匹配：

// Security::matchEquityFundMoneyMarketSecuritiesBySymbol()
if ($discrete_type === 'money_market_fund') {
    $query->where(self::COLUMN_TYPE, SecurityType::FUND)
        ->whereHas('fund', fn ($q) => $q->where('subtype', FundSubtype::MONEY_MARKET));
}

2. 现金等价物判定

Money Market Fund 被视为现金等价物，在计算投资账户的现金头寸时被特殊对待：

InvestmentAccount.php
} elseif ($position->security?->type === SecurityType::FUND
    && $position->security->fund?->subtype === FundSubtype::MONEY_MARKET) {
    $carry += $position->value;  // 归入现金
}

3. 供应商数据映射

不同供应商对同一类基金的叫法不同，subtype 是统一抽象层。HoldingInterface 将供应商的 discrete type 映射到系统 subtype：

HoldingInterface.php
self::DISCRETE_TYPE_ETF               → FundSubtype::ETF
self::DISCRETE_TYPE_OPEN_END_FUND     → FundSubtype::OPEN_END
self::DISCRETE_TYPE_CLOSED_END_FUND   → FundSubtype::CLOSED_END
self::DISCRETE_TYPE_MONEY_MARKET_FUND → FundSubtype::MONEY_MARKET
self::DISCRETE_TYPE_UIT               → FundSubtype::UIT

4. 费率差异

ETF 通常费率最低（被动指数），Open-End 主动管理基金费率较高，Money Market 费率极低。expense_ratio 字段配合 subtype 一起影响投资回报计算。

Sector 两套分类

Section titled “Sector 两套分类”

同一张 sectors 表，通过 type 字段区分：

// SectorType enum
case EQUITY = 'equity';  // 11 个股票板块 (ID 1-12，含 Not Classified)
case BOND   = 'bond';    // 6 个债券板块  (ID 13-18)
Sector Type ID 范围 板块
equity 1 Basic Materials
equity 2 Consumer Cyclical
equity 3 Financial Services
equity 4 Real Estate
equity 5 Communication Services
equity 6 Energy
equity 7 Industrials
equity 8 Technology
equity 9 Consumer Defensive
equity 10 Health Care
equity 11 Utilities
equity 12 Not Classified
bond 13 Government
bond 14 Corporate
bond 15 Securitized
bond 16 Municipal
bond 17 Cash
bond 18 Others

equities.sector_id 和 fixed_incomes.sector_id 指向同一个 sectors 表但不同的子集。

本地创建证券的默认值

Section titled “本地创建证券的默认值”

Security::createLocal() 在通过 brokerage 集成或手动录入创建证券时，按类型填充默认属性：

类型 默认 Sector 默认 Category 其他默认值
Equity Not Classified (12) Large Growth capitalization=Large, valuation=Blend, country=USA
Fixed Income Government (13) Government quality=AAA, market=Developed, subtype=入参
Fund 不适用 Other expense_ratio=0, allocations 按 S&P 500 近似分布填充

未知证券 fallback

Section titled “未知证券 fallback”

系统定义了三个通用 symbol 用于无法识别的证券：

Symbol 类型 用途
!?E equity 无法识别的股票
!?F fund 无法识别的基金
!?B bond 无法识别的债券

Morningstar 数据来源

Section titled “Morningstar 数据来源”

生产环境中，这三类证券的数据主要来自 Morningstar：

数据类型 Morningstar 来源 本地 extractor / transformer
Equity 基本数据 CompanyReference + SecurityReference Equity\CompanyReference、Equity\SecurityReference
Equity sector + style AssetClassification（Data Point 3007、3001） Equity\AssetClassification
Equity 价格 Price（Data Point 30003） Equity\Price
Fund 数据 DataWarehouse37 + AssetClassification30 + InvestmentVehicle Fund\* extractors
Fund 价格 Prices Fund\Price

迁移到 GEDF / Snowflake 后，Equity 数据来源变更详见 DEV-19911 Morningstar GECS 和 equity-data-migration-v1.md。

架构总览

Section titled “架构总览”
graph TD
    S["securities<br/>type: equity | fund | fixed_income<br/>name, symbol, cusip, isin"]

    E["equities<br/>sector_id (1-12)<br/>capitalization: small|middle|large<br/>valuation: value|blend|growth<br/>country"]
    FI["fixed_incomes<br/>sector_id (13-18)<br/>subtype: bond|cd|mbs<br/>quality: aaa...below<br/>market: developed|emerging"]
    F["funds<br/>subtype: etf|open_end|closed_end|uit|money_market<br/>expense_ratio"]

    S -->|type=equity| E
    S -->|type=fixed_income| FI
    S -->|type=fund| F

    F --> AAT["allocations_by_asset_type<br/>US/Non-US Equity/Bond/Cash %"]
    F --> ASEC["allocations_by_sector<br/>11 个股票板块 %"]
    F --> ACAT["allocations_by_category<br/>风格类别 %"]
    F --> AMKT["allocations_by_market<br/>发达/新兴 %"]
    F --> ABQ["allocations_by_bond_quality<br/>信用评级分布"]
    F --> AES["allocations_by_equity_style<br/>9 宫格风格分布"]
    F --> FEP["fund_equity_portfolio<br/>股票持仓明细"]
    F --> FBP["fund_bond_portfolio<br/>债券持仓明细"]

    E --> SEC_E["sectors (type=equity)<br/>11 板块"]
    FI --> SEC_B["sectors (type=bond)<br/>6 板块"]
    ASEC --> SEC_E