投资目标采集与目标书

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

1. 范围

本能力先完成投顾流程的输入闭环：采集并确认收益目标、最大可承受回撤、流动性需求和投资期限，生成待审核的投资目标书草稿。仅支持场内基金模拟交易的后续分析输入，不创建委托、不执行交易，也不构成收益承诺。

策略组合草案、适当性复核、持证投顾审核和内容发布属于后续流程；本期不会将草稿作为正式投资建议返回或发布。

2. 数据与兼容性

新增表 advisor_investment_goal 保存每次采集的结构化目标版本，并关联已有的 client_facing_content 记录。目标书使用 content_type=investment_goal_book、review_status=pending_review 存储为对客内容草稿。

兼容性核对：本期迁移只执行 CREATE TABLE advisor_investment_goal，不修改、重命名、删除或复用《00-新数据库基线设计.md》中的任何表或字段。fin_customer_profile、fin_risk_assessment 和 client_facing_content 的结构均保持不变。

3. 采集字段

字段	规则
预期年化收益区间	0 至 100，区间下限不得超过上限；必须附带业绩比较基准名称
最大回撤	0 至 100 的百分比
流动性需求	可随时使用、7 日内、30 日内或 30 日后可使用
投资期限	1 至 600 个月
备注	不得包含保本、保证收益、稳赚、无风险或收益承诺表述

目标书必须展示“期望/业绩比较基准口径，不构成收益承诺”的风险提示。

4. 状态与权限

目标状态：pending_confirmation -> confirmed -> superseded。确认新的目标时，同一客户此前已确认的目标会变为 superseded；目标书草稿仍保持 pending_review，确认目标不等同于审核或发布。

权限按照资源及数据范围独立配置：

investment-goal:write:self、investment-goal:read:self、investment-goal:confirm:self：客户只能处理本人目标。
investment-goal:write:customer、investment-goal:read:customer、investment-goal:confirm:customer：员工仅可在 own_customers 或 all 范围内处理客户目标。

所有采集和确认动作都写入 interaction_audit。投顾 Agent 只可通过 query_investment_goal 读取当前调用者的目标，不具备写入权限。

部署时由超级管理员受控新增上述权限码并分配到相应角色，不在业务迁移中自动授予任何角色。启用 Agent 查询前，还需在已发布配置中登记 namespace=agent_tools、config_key=advisor:investment_goal、value_json={"allowed_tools":["query_investment_goal"]}；否则公共 ToolExecutor 会拒绝该工具调用。

5. HTTP 入口

方法	路径	说明
POST	`/api/v1/advisor/investment-goals`	采集目标并生成待审核目标书草稿，要求 `Idempotency-Key`
GET	`/api/v1/advisor/investment-goals/current`	查询本人当前目标
GET	`/api/v1/advisor/customers/{customer_id}/investment-goals/current`	员工按归属查询客户当前目标
POST	`/api/v1/advisor/investment-goals/{goal_no}/confirmations`	确认目标，要求 `Idempotency-Key`
GET	`/api/v1/advisor/investment-goals/{goal_no}/goal-book`	查看关联目标书草稿及审核状态

3.3 KiB Raw Permalink Blame History