edit | blame | history | raw

案例存储体系创建指南

创建人员：Codex
文件职责：指导项目内案例分析体系如何记录数据、图片、结果包、表结构和读取方式。
管理规范/模板：../../全局规范.md；../../体系说明.md；案例分析规范.md。
引用文件：案例分析环境创建指南.md；案例总纲模版.md；案例分析设计模版.md；案例执行日志模版.md；案例审计报告模版.md。
记录方式：存储体系创建指南；案例数据存储口径变化时更新。

1. 定位

案例存储体系负责回答：

  1. 案例数据放在哪里。
  2. 图片和图册放在哪里。
  3. 每个表有哪些字段。
  4. 一个案例的证据链怎么串起来。
  5. 审核员怎么找到并复核关键数据。

2. 推荐目录

ana-data/
  cases/
    <CASE-ID>/
      data/
      img/
      notes/
  result/
    <PACK-ID>/
  img/
    individual/
    by_type/
  tmp/

3. 核心表

建议至少维护以下表，字段可按项目扩展。

路径口径：表内 input_path、output_path、image_path、evidence_pack_path 等路径默认使用项目根目录相对路径，例如 ana-data/result/<PACK-ID>/case_index.csv。如果项目另有路径基准，必须在本地 案例存储体系.md 写清楚，避免审核员按不同目录解析路径。

3.1 case_index.csv

字段 含义
case_id 案例唯一 ID
case_name 案例名称
case_type 案例类型
source_id 来源方法论、笔记、样本或聊天要求 ID
target_object 分析对象，如股票、用户、模块、流程等
anchor_date_or_time 案例关键锚点日期或时间
status 未开始 / 进行中 / 待审核 / 完成 / 暂缓
result_summary 当前结果摘要
evidence_pack_path 证据包路径
audit_id 审计报告 ID

3.2 case_step_trace.csv

字段 含义
trace_id 步骤证据 ID
case_id 所属案例
step_order 步骤顺序
step_name 步骤名
rule_or_reason 使用的规则或判断原因
input_path 输入数据路径
output_path 输出数据路径
image_path 图片证据路径
decision 本步骤判断或动作
reviewer_note 审核备注

3.3 operation_ledger.csv

如果案例包含操作或交易，建议维护操作流水。

字段 含义
operation_id 操作 ID
case_id 所属案例
operation_time 操作时间
operation_type 买入 / 卖出 / 选择 / 排除 / 标记 / 其他
trigger_rule 触发规则
trigger_evidence_path 触发证据
quantity 数量，可为空
price_or_value 价格或数值，可为空
result 操作结果

3.4 image_manifest.csv

字段 含义
image_id 图片 ID
case_id 所属案例
image_type 候选图 / 操作图 / 结果图 / 汇总图 / 审计图
image_path 图片路径
marked_points 图上标注的关键点
source_data_path 生成图片的数据
generated_by 生成者
generated_at 生成时间

4. 图片要求

图片必须服务复核。

建议至少包含：

  1. 候选阶段图：说明为什么案例进入候选。
  2. 关键判断图：说明哪里满足规则。
  3. 操作阶段图：说明何时买入、卖出、进入、退出或标记。
  4. 结果图：说明最终走势、效果或失败点。

如果项目不涉及图片，应在存储体系中说明替代证据。

5. 结果包要求

每个正式结果包至少包含：

  1. 主表。
  2. case_index。
  3. case_step_trace。
  4. image_manifest，如有图片。
  5. summary。
  6. readout 或说明文档。

结果包入口必须回写到案例总纲、案例分析设计和案例执行日志；审计结论回写到案例审计报告。

6. 禁止事项

禁止：

  1. 只有 summary，没有案例级明细。
  2. 图片存在但没有 manifest。
  3. 操作流水没有触发证据。
  4. 证据路径指向临时目录但当作正式证据。
  5. 结果包没有回写入口。

7. 长期行业成果目录

对需要持续增量更新的行业研究，项目本地存储体系应固定以下用户入口：

ana-data/cases/<行业>案例/
  当前成果索引.md
  核心文档/
  manifest/
  审计包/

ana-data/tmp/<行业>案例/<task_id>/<run_id>/
ana-data/result/<行业>案例/当前成果索引.md

核心文档/ 保存稳定、可读、持续合并更新的行业成果；tmp/ 保存候选；审计包/ 保存历史和恢复材料；result/当前成果索引.md 只作轻量跳转。长期行业成果不得默认按任务建立多个 <case_id>/outputs/。一次性专题或单公司独立案例仍可使用案例级输出目录，但必须在本地规范中明确分类。