3.2 KiB
3.2 KiB
权威产品适当性与合同字段接入
适用范围
本功能只接入南方基金的场内 ETF/LOF 模拟交易产品。fin_product.risk_level 中的
历史测试映射不是权威适当性依据，推荐服务不会使用它作为生产准入条件。
产品适当性等级必须来自实际销售机构的产品风险等级披露。基金管理人、第三方行情 网站和历史波动率都不能替代该披露。基金合同字段必须来自南方基金官网、交易所公告或 基金合同原文，并保留原文 HTTPS 链接及 SHA-256 文件哈希。
数据表
advisor_product_suitability_reference：按销售机构、生效期保存 R1-R5 适当性等级。advisor_product_contract_snapshot：按生效期保存基金类型、投资范围、业绩比较基准、 风险收益特征、托管人、费率、成立日和合同来源。
两张表均为新增表，不修改基线表或字段。相同产品和生效期的来源哈希不可覆盖；原文变化 时必须创建新的生效版本。
导入
先执行迁移，再设置实际销售机构名称：
python -m alembic upgrade head
$env:PRODUCT_SUITABILITY_SALES_INSTITUTION = "实际销售机构全称"
适当性 CSV 必须包含以下表头：
product_code,sales_institution,risk_level,effective_from,effective_until,source_url,document_title,document_published_at,document_sha256,source,review_status,verified_by,verified_at
合同 CSV 必须包含以下表头：
product_code,effective_from,effective_until,fund_type,investment_scope,performance_benchmark,risk_return_characteristics,custodian_name,management_fee_rate_pct,custodian_fee_rate_pct,inception_date,source_url,document_title,document_published_at,document_sha256,source,review_status,verified_by,verified_at
先校验再写入：
python tools/import_product_governance_reference.py --suitability data/suitability.csv --contracts data/contracts.csv --dry-run
python tools/import_product_governance_reference.py --suitability data/suitability.csv --contracts data/contracts.csv
只有 review_status=verified 且包含 verified_by、带时区的 verified_at、HTTPS 原文链接
和 64 位 SHA-256 的记录，才会参与推荐。未配置销售机构或没有同时具备有效适当性和合同
证据的产品，推荐接口会安全返回相应的 *_reference_required 状态。
南方基金官网同步
仓内的南方场内 ETF/LOF 可使用官网直销产品详情页同步。同步器读取官网明确标注“评级 来自南方基金”的 R1-R5，读取官网法律文件目录中的基金合同原件并计算文件 SHA-256。 它不使用第三方平台、产品类型或历史波动率推导风险等级。
$env:PRODUCT_SUITABILITY_SALES_INSTITUTION = "南方基金管理股份有限公司直销"
python tools/sync_nanfang_official_product_governance.py --dry-run
python tools/sync_nanfang_official_product_governance.py
同步记录的核验人固定标注为 system:official-source-sync，表示已完成官网来源、风险等级、
合同文件及哈希的一致性校验；不等同于人工合规复核。生产环境应按销售机构的变更周期复跑
同步，并由合规人员复核版本差异。