From e87cfdcb76a359d217130b33ffb4ed917b64d230 Mon Sep 17 00:00:00 2001
From: 1 <wentingyear@gmail.com>
Date: Thu, 25 Jun 2026 20:56:54 +0800
Subject: [PATCH] fix: rebuild project-info system documents

---
 ana-doc/案例存储体系.md |  151 +++++++++----------------------------------------
 1 files changed, 29 insertions(+), 122 deletions(-)

diff --git "a/ana-doc/\346\241\210\344\276\213\345\255\230\345\202\250\344\275\223\347\263\273.md" "b/ana-doc/\346\241\210\344\276\213\345\255\230\345\202\250\344\275\223\347\263\273.md"
index 81ed9f4..603d59c 100644
--- "a/ana-doc/\346\241\210\344\276\213\345\255\230\345\202\250\344\275\223\347\263\273.md"
+++ "b/ana-doc/\346\241\210\344\276\213\345\255\230\345\202\250\344\275\223\347\263\273.md"
@@ -1,135 +1,42 @@
-# 案例存储体系创建指南
+# 案例存储体系
 
-创建人员：Codex  
-文件职责：指导项目内案例分析体系如何记录数据、图片、结果包、表结构和读取方式。  
-管理规范/模板：../../全局规范.md；../../体系说明.md；案例分析规范.md。  
-引用文件：案例分析环境创建指南.md；案例总纲模版.md；案例分析设计模版.md；案例执行日志模版.md；案例审计报告模版.md。  
-记录方式：存储体系创建指南；案例数据存储口径变化时更新。
+创建人员：management.admin  
+文件职责：记录 `project-info` 项目案例分析体系的数据、证据、图片、结果包和临时文件存储位置。  
+管理规范/模板：../../common/ana-doc/案例存储体系创建指南.md；../../common/ana-doc/案例分析环境创建指南.md。  
+引用文件：案例分析规范.md；案例总纲.md；案例分析设计.md；案例执行日志.md；案例审计报告.md。  
+记录方式：存储体系入口；目录、表结构或结果包口径变化时维护更新。
 
-## 1. 定位
+## 1. 目录映射
 
-案例存储体系负责回答：
+| 路径 | 作用 | 状态 |
+|---|---|---|
+| `../ana-data/cases/` | 案例级结构化数据、证据 manifest、readout 和逐案例材料 | 已创建 |
+| `../ana-data/result/` | 正式结果包、汇总表、审计辅助输出 | 已创建 |
+| `../ana-data/img/` | 案例图片、图册、标注图和图片 manifest | 已创建 |
+| `../ana-data/tmp/` | 临时数据和中间文件，不得当正式结果 | 已创建 |
 
-1. 案例数据放在哪里。
-2. 图片和图册放在哪里。
-3. 每个表有哪些字段。
-4. 一个案例的证据链怎么串起来。
-5. 审核员怎么找到并复核关键数据。
+项目内正式路径默认使用项目根目录相对路径，例如 `ana-data/result/ANA-YYYYMMDD-主题-001/manifest.json`。
 
-## 2. 推荐目录
+## 2. 推荐结果包结构
 
 ```text
-ana-data/
-  cases/
-    <CASE-ID>/
-      data/
-      img/
-      notes/
-  result/
-    <PACK-ID>/
-  img/
-    individual/
-    by_type/
-  tmp/
+ana-data/result/<case_id>/
+  manifest.json
+  summary.md
+  evidence_index.csv
+  readout.md
+  image_manifest.csv       # 如涉及图片
 ```
 
-## 3. 核心表
+`manifest.json` 至少记录结果包 ID、生成时间、输入入口、文件清单、行数或哈希摘要。`summary.md` 只写摘要、结论边界和证据入口；大段原文应放在 readout 或 evidence 文件中。
 
-建议至少维护以下表，字段可按项目扩展。
+## 3. 外部信息和 K 线数据
 
-路径口径：表内 `input_path`、`output_path`、`image_path`、`evidence_pack_path` 等路径默认使用项目根目录相对路径，例如 `ana-data/result/<PACK-ID>/case_index.csv`。如果项目另有路径基准，必须在本地 `案例存储体系.md` 写清楚，避免审核员按不同目录解析路径。
+外部信息、研报、公告、新闻和网页内容只记录来源、采集时间、摘要和证据入口。K 线和市场数据优先引用全局数据文档、数据库查询口径、结果包路径或 manifest，不在窗口或文档中粘贴大体量数据。
 
-### 3.1 case_index.csv
+## 4. 禁止事项
 
-| 字段 | 含义 |
-|---|---|
-| 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. 结果包没有回写入口。
+1. 不得把 `ana-data/tmp/` 中的文件当作正式证据包。
+2. 不得只有结论 summary 而没有案例级证据索引。
+3. 图片作为证据时必须有 manifest 或等价索引。
+4. 不得把数据库密码、授权 token 或私有凭据写入结果包。

--
Gitblit v1.9.3