53 lines
3.3 KiB
Markdown
53 lines
3.3 KiB
Markdown
# 投资目标采集与目标书
|
|
|
|
> 版本：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` | 查看关联目标书草稿及审核状态 |
|