FinClaw V1 Task Packet: Product Object and Schema Design

本 packet 已完成，仅作历史归档。 后续需读 schema 设计请直接读 v1-product-object-and-schema-design.md； Schema 在工程仓库的实现请参考 v1-eng-impl-sub-1 ~ sub-3。 Phase 0 补 frontmatter context_budget 仅用于让本 packet 可被检索器统一处理，不需要再被分发执行。

状态：Completed / P0 Design Task output created 日期：2026-05-13 Lane：Object / Schema Owner：FinClaw Controller 分发，Product + Engineering 承接 上游文档：v1-design-kickoff-packet.md、v1-prd.md、product-object-and-advisor-design.md、terminology-and-object-naming.md、evaluation/finclaw/case-schema.md

1. 目标

产出 V1 Product Object and Schema Design，把 V1 PRD 中的 Market Cognition Snapshot（市场认知快照）、Market Cognition Thread（市场认知线程）、Pre-Execution Checkpoint（执行前认知检查点）、Evidence / Data Quality、Advisor Output、User Context / Profile Consent、Sensitive Input Handling 映射为可评审的字段、状态、关系和验收约束。

该任务包只产出产品对象和 schema 设计，不改工程代码、不冻结数据库实现、不定义 API 细节。

2. 允许读取

• v1-design-kickoff-packet.md
• v1-prd.md
• product-object-and-advisor-design.md
• terminology-and-object-naming.md
• evaluation/finclaw/case-schema.md
• evaluation/finclaw/cases/README.md
• 必要时读取 mvp-product-definition.md 的对象和敏感信息约束

3. 禁止范围

• 不把 Action Suggestion、行动建议、反弹做空、开多 / 开空等 legacy 语义恢复为正式对象；
• 不把 Pre-Execution Checkpoint 设计成订单、信号、提醒或执行触发器；
• 不定义真实账户、交易所 key、私钥、资金划转或链上执行字段；
• 不把用户画像、敏感信息处理、凭证拒收写成已实现能力；
• 不提前冻结数据库、API、SDK 或工程实现。

4. 输出要求

输出文档建议路径：

projects/finclaw/design/v1/v1-product-object-and-schema-design.md

必须覆盖：

1. Snapshot 字段、必填 / 可选、证据关系和 UI 状态；
2. Thread 字段、生命周期状态、刷新记录、合并 / 拆分 / 暂停 / 关闭字段；
3. Pre-Execution Checkpoint 字段、行动语言降级、风险约束、失效条件和不可执行边界；
4. Evidence Item 与 Data Quality Note 的试运行字段；
5. Advisor Output 到 Snapshot / Thread / Checkpoint 的写入目标；
6. User Context、Profile Consent 和 Research Preference 的最小字段；
7. Sensitive Input Handling，包括凭证 / 私钥拒收、非凭证类金融上下文临时使用和保存确认；
8. Model / Provider / Source boundary 字段；
9. 训练资产候选字段：授权、去标识化、敏感信息过滤、退出和删除状态；
10. 与 evaluation/finclaw/ case schema 的映射表；
11. 后续 API / persistence 设计不能越过的边界。

5. 验收标准

该输出被接收前，必须满足：

• 每个核心对象都能回链到 v1-prd.md；
• 线程对象是一等对象，不是普通聊天历史字段；
• 行动邻近字段只进入 Strategy Hypothesis / Pre-Execution Checkpoint；
• 凭证、私钥、账户权限类输入有拒收 / 屏蔽 / 不保存 / 不训练字段；
• 用户画像和金融上下文保存前有确认状态；
• 数据质量、证据限制、模型来源和用户授权可被 evaluation 检查；
• schema 不要求 V1 已经具备完整自有模型训练闭环。

6. 回写位置

• 正式输出进入 projects/finclaw/design/；
• 评测字段变化回写 evaluation/finclaw/case-schema.md 或新增 evaluation task；
• 若发现产品对象边界需要改变，提交 Controller 判断是否进入 packets/escalation/。

7. 分歧 / 风险 / 需裁决项

本任务包的首版输出已落盘到 v1-product-object-and-schema-design.md。以下风险保留为后续 Design Packet review、schema 工程映射和 evaluation case 对齐需继续验证的事项。

当前已知风险：

• Evidence Item 和 Data Quality Note 当前仍是试运行字段，是否升级为正式一等对象需要后续评测证明；
• 用户画像字段过多会把 V1 onboarding 复杂化；
• 训练资产字段必须只表达候选治理状态，不能让团队误判为已完成训练闭环；
• Pre-Execution Checkpoint 字段若命名不当，容易被外部系统误读为执行输入。