edit | blame | history | raw

ana-doc 目录导读

创建人员:management.admin
文件职责:说明 project-info 项目案例分析体系文档入口、研报体系方法母版、行业案例目录和相邻数据目录用途。
管理规范/模板:../项目规范.md;../../common/ana-doc/案例分析环境创建指南.md;../../common/ana-doc/案例分析规范.md。
引用文件:研报体系导读.md;案例分析规范.md;案例审核规范.md;案例存储体系.md;数据抓取脚本说明.md;案例总纲.md;案例分析设计.md;案例执行日志.md;案例审计报告.md;案例问题记录.md;研报体系/研报解析架构.md;研报体系/研报分析架构.md;../项目配置清单.md。
记录方式:目录入口文档;本目录正式文件新增、删除、改名或职责变化时同步更新。

1. 本体系定位

project-info 的案例分析体系用于承接研报研究、行业资料分析、外部信息补充、市场显影检查、暗线分流、证据归档、核心文档输出和审核闭环。

案例体系只记录可复核的案例链路,不替代实验体系的可执行验证,也不直接给出交易指令。研报体系进入本项目后,作为 ana-doc 案例体系的一部分运行:案例生命周期、设计审核、执行日志、审计闭环以 ana 体系为主;研报解析和研报分析方法作为专业步骤嵌入。

2. 父级文档入口

文件 作用
研报体系导读.md 研报体系工作入口,说明案例分析员、审核员和体系维护者如何读取核心文档、执行案例、提交审核和归档产物
案例分析规范.md 本项目案例分析本地规范入口,融合研报解析架构和研报分析架构流程,含研报体系接入流程、资料归档、主动补数据、补证轮次上限、市场反向补漏、核心文档输出、行业子规范优先级和 darkline 使用规则
案例审核规范.md 本项目案例审核本地规范入口,融合研报解析架构和研报分析架构的审核要求,含研报案例设计审核、执行审核、存储审核、输出审核、补证轮次上限、结论边界审核和复审清单
案例存储体系.md 案例数据、研报资料、证据、结果包、manifest、MySQL 追溯和临时文件存储口径
数据抓取脚本说明.md ana-data/tools/ 数据抓取、外部来源归档、本地 MySQL 只读导出和市场反向补漏脚本使用说明
案例总纲.md 父级案例事项背景、目标、边界、状态和结论账本
案例分析设计.md 父级案例选择口径、执行步骤、证据要求和验收方式
案例执行日志.md 父级案例执行过程、关键节点、数据和证据路径
案例审计报告.md 初始化审计、设计审核、执行审核、复审和审计问题主记录
案例问题记录.md 外部反馈、执行者无法自行闭环或需跨轮/跨角色跟踪的非审计问题,或审计问题跨轮索引

父级 ana-doc/ 只记录体系级规则、跨行业规则、目录入口和跨行业问题;单个行业研报案例的过程明细写入对应行业案例目录。

3. 研报体系方法母版

文件 作用
研报体系/研报解析架构.md 行业研报解析方法母版;定义行业方案继承机制、行业/市场/公司三类视图和解析输出底线
研报体系/研报分析架构.md 行业研报分析方法母版;定义资料归档、转换、证据抽取、指标标准化、主动补数据、市场反向补漏、暗线分流和人读文档闭环

说明:

  1. 研报解析架构.md研报分析架构.md 是方法母版,保留在 ana-doc/研报体系/
  2. 研报存储规则已经融入 案例存储体系.md,不在 ana-doc/研报体系/ 下另建正式 研报存储体系.md
  3. 方法母版中出现的有色、铜、矿区等内容是示例,不是跨行业通用表或通用对象要求。
  4. 具体行业需要哪些对象、字段、表和输出文档,由该行业自己的 <行业>研报解析方案.md 定义。

4. 数据目录

目录 作用
../ana-data/cases/ 逐行业统一 raw 池、行业级通用研报产物,以及逐案例正式输出、引用清单和证据映射
../ana-data/result/ 父体系结果入口、对外交付包、跨案例汇总结果包、审计辅助输出、父级汇总表
../ana-data/img/ 图片、图册、研报截图、OCR 图片、标注图和图片 manifest
../ana-data/tmp/ 临时数据和中间产物,按行业、case、run 分组,不得作为正式证据入口
../ana-data/tools/ 数据抓取、MySQL 只读导出和市场反向补漏脚本;脚本产物不得留在此目录

研报类行业级通用资料库默认使用:

ana-data/cases/<行业案例>/
  raw/
  converted/
  extracted/
  supplement/
  evidence/
  manifest/

研报类逐案例自定义结果目录默认使用:

ana-data/cases/<行业案例>/<case_id>/
  outputs/
  manifest/
  evidence/

研报类父体系兼容目录默认使用:

ana-data/tmp/<行业案例>/<case_id>/<run_id>/
ana-data/result/<行业案例>/<case_id>/
ana-data/img/<行业案例>/<case_id>/

研报类行业统一 raw 池默认使用:

ana-data/cases/<行业案例>/raw/

所有原始研报、公告、网页快照和外部资料原件必须先进入行业统一 raw/。转换、抽取、补充、通用证据事实和行业级 manifest 进入行业级目录;逐案例目录只保存输出、案例引用清单和案例结论证据映射。临时文件进入 ana-data/tmp/<行业案例>/<case_id>/<run_id>/,结果入口或交付包索引进入 ana-data/result/<行业案例>/<case_id>/,图片进入 ana-data/img/<行业案例>/<case_id>/。raw 与具体案例、批次、执行轮次的关系由 manifest 中的 case_idbatch_idrun_id 绑定。不得创建 ana-data/cases/<行业案例>/<case_id>/raw/,也不得按 batch 或 run 拆 raw 原始资料目录。

5. 行业 / 研究案例目录

正式行业研报研究应按行业容器文件夹管理。每个新的行业方向必须在 ana-doc/ 下创建自己的行业容器文件夹;行业容器不是一个案例,不创建自己的 案例总纲.md

目录 作用 状态
有色案例/ 有色行业研报容器和后续有色研报研究入口 已创建

每个行业案例目录根目录至少包含:

  1. 目录导读.md
  2. 案例分析规范.md
  3. 案例审核规范.md
  4. 案例存储体系.md
  5. 案例分析设计.md
  6. 案例执行日志.md
  7. 案例审计报告.md
  8. 案例问题记录.md
  9. 待补资料清单.md
  10. <行业>研报解析方案.md

行业案例目录中的规范类和存储类文档以本层 ana-doc/ 的同名文档为母版;行业 案例分析规范.md案例审核规范.md 默认只作为轻量继承入口和行业补充,不复制父级主流程、阶段门、审核类型和阻断条件。分析设计、执行日志、审计报告和问题记录作为该行业容器自己的事项、执行、审核和问题账本独立维护。真实案例统一登记在父级 案例总纲.md,行业目录不得创建平行的 案例总纲.md

待补资料清单.md 用于承接同一案例、同一类证据缺口或同一组相关缺口补资料 3 轮后仍未补齐的资料需求。写入该清单后,分析员继续推进 DRAFT 核心文档和下一阶段工作;后续用户或人工同事索取需要补充的数据时,再从该清单提取反馈。

6. 当前案例入口

案例 ID 名称 状态 入口
ANA-SMOKE-001 案例体系初始化 dry-run 初始化审核通过 案例总纲.md案例分析设计.md案例执行日志.md案例审计报告.md
ANA-YS-TEMPLATE-001 有色行业研报容器初始化 已迁入父级总纲,待审核员复核 案例总纲.md有色案例/案例分析设计.md有色案例/案例执行日志.md有色案例/案例审计报告.md
ANA-YS-INDUSTRY-001 有色行业整体研报分析 进行中;BATCH-001 30 PDF 存储与转换试运行已完成,待正式审核员复核 案例总纲.md有色案例/案例分析设计.md有色案例/案例执行日志.md有色案例/案例审计报告.md

新增正式案例时,应先在父级 案例总纲.md 登记,再在对应行业目录 案例分析设计.md 补事项拆解、批次设计和执行方案;设计审核通过后才能执行。

7. 执行入口选择

AI 接到研报或行业资料分析任务时,先判断任务落点:

  1. 跨行业通用规则、父级规范、研报方法母版维护:落父级 ana-doc/
  2. 单个行业研报分析、资料读取、输出文档、证据链、执行日志、审计问题:案例登记落父级总纲,事项拆解和过程明细落对应行业案例目录;执行者自发现且可处理的问题写入执行日志、自检或验证报告,不写入问题记录。
  3. 行业原始资料和通用研报产物:落 ana-data/cases/<行业案例>/raw|converted|extracted|supplement|evidence|manifest/;逐案例输出、引用清单和案例证据映射:落 ana-data/cases/<行业案例>/<case_id>/
  4. 临时文件:落 ana-data/tmp/<行业案例>/<case_id>/<run_id>/,不得作为正式证据入口。
  5. 结果入口、对外交付包、跨案例汇总:落 ana-data/result/<行业案例>/<case_id>/;图片、截图、OCR 图片、图册和标注图:落 ana-data/img/<行业案例>/<case_id>/
  6. 数据抓取和只读导出脚本:从 ana-data/tools/ 执行,使用说明看 数据抓取脚本说明.md;输出仍按行业和案例进入 supplement/evidence/manifest/tmp/result/img