group_fqcd_jr/docs/17-开户风险测评设计.md

开户风险测评与后台画像

版本：v1.0
状态：实施中
修订日期：2026-09-10

1. 范围

客户第一次登录时必须完成开户风险测评。系统以是否存在有效的正式风险测评判断是否完成；没有有效测评的客户只能访问 /api/v1/onboarding/**，其他已鉴权业务入口返回 403 ONBOARDING_REQUIRED。

问卷来自《风险测评问卷》，共 13 道单选题。提交前必须确认真实、准确、完整声明。每天最多提交两次，滚动 365 天最多提交八次；正式测评有效期为提交时起一年。

2. 数据边界与兼容性

不新增、不删除或修改任何数据库表和字段：

• fin_risk_assessment：保存提交答案、后台总分、C1-C5 投资者类型和有效期，是正式风险测评权威记录。
• profile_snapshots：生成版本化后台客户画像；切换当前版本时仅变更既有 is_current 状态。
• memory_sync_outbox：同一事务创建 Milvus、Neo4j 两条画像同步事件。
• interaction_audit：记录完成事件，不记录原始答案和分数。

本期不修改 fin_customer_profile、fin_risk_assessment、profile_snapshots 或任何其他基线表的结构。客户接口禁止返回答案、总分、C1-C5、风险标签、画像或评分规则；这些内容仅可由已授权后台流程读取。

3. 后台评分规则

评分规则版本为 opening-risk-v1，在服务端以固定映射执行。问题按财务承受能力、投资经验、投资期限、产品偏好、投资态度和损失承受能力评分，总分范围 13 至 57：

总分	内部风险等级	后台画像
13-22	C1	谨慎型
23-31	C2	稳健型
32-40	C3	平衡型
41-49	C4	成长型
50-57	C5	进取型

评分映射不出现在客户 HTTP 响应、Agent 输出、日志或审计详情中。后续变更评分规则必须新建问卷版本，不得覆盖历史测评结果。

4. HTTP 入口

方法	路径	客户可见内容
GET	/api/v1/onboarding/risk-questionnaire	是否需要填写、13 道题和确认声明；已完成时不返回问卷和任何测评结果
POST	/api/v1/onboarding/risk-questionnaire/submissions	仅返回完成状态、问卷版本和有效期；要求 Idempotency-Key

提交请求包含 answers（q1 至 q13 的选项编号）与 declaration_accepted=true。接口不接受客户端传入分数、风险等级、画像或有效期。