花开福来 核心概念与统计口径
花开福来是一款本地优先的个人金融资产管理微信小程序。理解下面五个概念，就能理解它的全部数据模型与统计口径。
一、五类数据实体
| 实体 | 是什么 | 回答的问题 | 说明 |
|---|---|---|---|
账户 Account |
资金存放的位置（银行 / 券商 / 第三方 / 公积金） | 钱在哪里 | 只描述存放位置，不描述风险 |
资产 Asset |
底层产品 / 标的（基金、ETF、黄金账户等） | 钱投到了什么 | 一份产品全局唯一，决定风险暴露 |
持仓 Holding |
某账户 × 某资产的持有关系 | 谁在哪个账户持有它 | 同一资产在不同账户各有一条持仓 |
快照 Snapshot |
某持仓在某个日期的状态（市值、份额、成本、收益） | 当天值多少钱 | 唯一时间序列真相，历史不可覆盖 |
负债 Liability |
房贷、信用卡、消费贷等 | 欠了多少钱 | 独立管理，不进入默认金融资产配置 |
关系：账户 1:N 持仓 N:1 资产；持仓 1:N 快照。负债完全独立。
关键字段
include_in_financial_assets（计入金融资产）：设为「否」的账户不进金融资产总额口径，例如单独记账用的钱包账户。status：账户 / 持仓 / 负债为active / closed；资产为active / inactive（启用 / 停用）。停用的资产不参与任何统计口径，但在资产列表中仍可见并带「停用」标记。holding_type：明细（detail）/ 汇总（summary）。同一账户同一资产同时存在明细与汇总时可能重复计入，导入会提示。market_value_cny：人民币市值；有值优先使用，否则按原币市值 × 汇率折算。
二、三维资产分类模型（V2）
每个资产同时具备三组维度，回答「这笔钱承担什么风险、集中在哪个市场、通过什么工具持有」。
1. 资产大类 asset_class（决定首页环形图与统计口径）
| 代码 | 中文 | 典型产品 |
|---|---|---|
cash | 现金 / 现金管理 | 活期、余额、货币基金（余额宝 / 朝朝宝）、逆回购 |
fixed_income | 固收 | 纯债基金、债券基金、偏固收银行理财 |
equity | 权益 | 股票、ETF、股票基金（不分 A 股 / 海外，地域由 market 表达） |
gold | 黄金 | 黄金账户、黄金积存、黄金 ETF |
alternative | 另类资产 | REITs、商品、私募等 |
other | 其他 | 暂无法归类 |
restricted_asset | 长期受限资产 | 公积金、养老金、企业年金；不进金融资产口径 |
2. 市场 / 地域 market
china（境内）｜overseas（海外：美股、港股、QDII）｜global（全球）｜other｜none（不适用：现金、黄金、受限等）。
3. 产品类型 product_type
cash、deposit、money_market、fund、etf、lof、stock、bond、bank_wealth、gold_account、precious_metal、provident_fund、other。
另有策略标签 strategy_tags（宽基 / 红利 / 科技 / 医药 / 消费 / 成长 / 价值 / 科创 / 纳斯达克100 / 主动权益 / 纯债 / 中短债，支持自定义），用于识别多产品背后的重复策略暴露。
注意：早期版本的china_equity/overseas_equity分类已废弃，地域统一由market字段表达。导入旧枚举会报错并提示合法值。
三、统计口径
# 金融资产总额：排除受限资产与停用资产，不含负债
金融资产总额 = Σ「计入金融资产 = 是」且 active 的持仓最新快照 market_value_cny
某类别占比 = 该 asset_class 市值合计 ÷ 金融资产总额
投资资产 = 金融资产总额 − cash（现金 / 现金管理）类别合计
长期受限资产 = asset_class = restricted_asset 的最新快照合计（单独展示）
负债总额 = 全部 active 负债余额合计（独立卡片）
净资产参考 = 金融资产 + 受限资产 − 计入净资产的负债（include_in_net_worth = true）
历史序列采用 as-of 语义
「某日总资产」= 每个持仓取「该日及之前最新一条快照」之和。只看某一天，就是还原那一天的状态；之后补录的历史数据不会改变过去某天的视图。收益归属以快照日期为准——次日补录前一天的数据，仍记在前一天。
每日收益统一口径
首页「昨日收益」、历史快照日收益、资产与账户详情的每日收益、按日收益日历，四处数字走同一套计算：
- 快照自带
daily_profit时，直接使用报告值； - 缺失时，按「当日市值 − 前一快照日市值」推算（as-of）；
- 首次进入快照的那天按 0 计，不以资金流入反推收益。
界面标签：恰为今天 / 昨天才叫「今日 / 昨日收益」，其他日期直接显示「MM-DD 收益」；表格列名统一为「日收益」。
人民币市值折算
优先取快照中的 market_value_cny；缺失时按 market_value × fx_rate_cny 折算；美元无汇率时用设置中的兜底汇率；其他币种无汇率按 1:1 并提示。
四、产品边界（明确不做）
- 不做交易、开户、申购、赎回；
- 不做券商 / 银行自动登录抓取；
- 不做完整会计记账系统；
- 不以交易流水推导资产余额——快照是唯一真相。