From 08a442b67faefa5942aff823b5af01e4570f584e Mon Sep 17 00:00:00 2001 From: 1 <wentingyear@gmail.com> Date: Fri, 26 Jun 2026 06:36:59 +0800 Subject: [PATCH] 研报体系建立完毕 --- ana-doc/目录导读.md | 135 ++++++++++++++++++++++++++++++++++++-------- 1 files changed, 109 insertions(+), 26 deletions(-) diff --git "a/ana-doc/\347\233\256\345\275\225\345\257\274\350\257\273.md" "b/ana-doc/\347\233\256\345\275\225\345\257\274\350\257\273.md" index 7fc6f9b..342c4aa 100644 --- "a/ana-doc/\347\233\256\345\275\225\345\257\274\350\257\273.md" +++ "b/ana-doc/\347\233\256\345\275\225\345\257\274\350\257\273.md" @@ -1,51 +1,134 @@ -# ana-doc 目录导读 +# ana-doc 目录导读 -创建人员：management.admin -文件职责：说明 `project-info` 项目案例分析体系文档入口和相邻数据目录用途。 -管理规范/模板：../项目规范.md；../../common/ana-doc/案例分析环境创建指南.md；../../common/ana-doc/案例分析规范.md。 -引用文件：案例分析规范.md；案例审核规范.md；案例总纲.md；案例分析设计.md；案例执行日志.md；案例审计报告.md；案例问题记录.md；案例存储体系.md；../项目配置清单.md。 +创建人员：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` 的案例分析体系用于沉淀股市信息案例，包括研报、公告、新闻、公开网络信息、K 线显影、数据证据和分析结论。案例体系只记录可复核的案例链路，不替代实验体系的可执行验证，也不直接给出交易建议。 +`project-info` 的案例分析体系用于承接研报研究、行业资料分析、外部信息补充、市场显影检查、暗线分流、证据归档、核心文档输出和审核闭环。 -## 2. 文档入口 +案例体系只记录可复核的案例链路，不替代实验体系的可执行验证，也不直接给出交易指令。研报体系进入本项目后，作为 `ana-doc` 案例体系的一部分运行：案例生命周期、设计审核、执行日志、审计闭环以 ana 体系为主；研报解析和研报分析方法作为专业步骤嵌入。 + +## 2. 父级文档入口 | 文件 | 作用 | |---|---| -| `案例分析规范.md` | 本项目案例分析本地规范入口，引用 common 规范并说明本项目补充口径 | -| `案例审核规范.md` | 本项目案例审核本地规范入口，引用 common 审核规范并说明审核员职责 | -| `案例总纲.md` | 案例事项背景、目标、边界、状态和结论账本 | -| `案例分析设计.md` | 案例选择口径、执行步骤、证据要求和验收方式 | -| `案例执行日志.md` | 案例执行过程、关键节点、数据和证据路径 | +| `研报体系导读.md` | 研报体系工作入口，说明案例分析员、审核员和体系维护者如何读取核心文档、执行案例、提交审核和归档产物 | +| `案例分析规范.md` | 本项目案例分析本地规范入口，融合研报解析架构和研报分析架构流程，含研报体系接入流程、资料归档、主动补数据、市场反向补漏、核心文档输出、行业子规范优先级和 darkline 使用规则 | +| `案例审核规范.md` | 本项目案例审核本地规范入口，融合研报解析架构和研报分析架构的审核要求，含研报案例设计审核、执行审核、存储审核、输出审核、结论边界审核和复审清单 | +| `案例存储体系.md` | 案例数据、研报资料、证据、结果包、manifest、MySQL 追溯和临时文件存储口径 | +| `数据抓取脚本说明.md` | `ana-data/tools/` 数据抓取、外部来源归档、本地 MySQL 只读导出和市场反向补漏脚本使用说明 | +| `案例总纲.md` | 父级案例事项背景、目标、边界、状态和结论账本 | +| `案例分析设计.md` | 父级案例选择口径、执行步骤、证据要求和验收方式 | +| `案例执行日志.md` | 父级案例执行过程、关键节点、数据和证据路径 | | `案例审计报告.md` | 初始化审计、设计审核、执行审核、复审和审计问题主记录 | -| `案例问题记录.md` | 非审计来源问题，或审计问题跨轮索引 | -| `案例存储体系.md` | 案例数据、证据、图片、结果包和临时文件存储口径 | +| `案例问题记录.md` | 外部反馈、执行者无法自行闭环或需跨轮/跨角色跟踪的非审计问题，或审计问题跨轮索引 | -## 3. 数据目录 +父级 `ana-doc/` 只记录体系级规则、跨行业规则、目录入口和跨行业问题；单个行业研报案例的过程明细写入对应行业案例目录。 + +## 3. 研报体系方法母版 + +| 文件 | 作用 | +|---|---| +| `研报体系/研报解析架构.md` | 行业研报解析方法母版；定义行业方案继承机制、行业/市场/公司三类视图和解析输出底线 | +| `研报体系/研报分析架构.md` | 行业研报分析方法母版；定义资料归档、转换、证据抽取、指标标准化、主动补数据、市场反向补漏、暗线分流和人读文档闭环 | + +说明： + +1. `研报解析架构.md` 和 `研报分析架构.md` 是方法母版，保留在 `ana-doc/研报体系/`。 +2. 研报存储规则已经融入 `案例存储体系.md`，不在 `ana-doc/研报体系/` 下另建正式 `研报存储体系.md`。 +3. 方法母版中出现的有色、铜、矿区等内容是示例，不是跨行业通用表或通用对象要求。 +4. 具体行业需要哪些对象、字段、表和输出文档，由该行业自己的 `<行业>研报解析方案.md` 定义。 + +## 4. 数据目录 | 目录 | 作用 | |---|---| -| `../ana-data/cases/` | 案例级结构化数据和逐案例证据目录 | -| `../ana-data/result/` | 正式结果包、汇总表、审计辅助输出 | -| `../ana-data/img/` | 案例图片、图册、标注图和图片 manifest | -| `../ana-data/tmp/` | 临时数据和中间产物，不得作为正式证据入口 | +| `../ana-data/cases/` | 逐行业统一 raw 池、行业级通用研报产物，以及逐案例正式输出、引用清单和证据映射 | +| `../ana-data/result/` | 父体系结果入口、对外交付包、跨案例汇总结果包、审计辅助输出、父级汇总表 | +| `../ana-data/img/` | 图片、图册、研报截图、OCR 图片、标注图和图片 manifest | +| `../ana-data/tmp/` | 临时数据和中间产物，按行业、case、run 分组，不得作为正式证据入口 | +| `../ana-data/tools/` | 数据抓取、MySQL 只读导出和市场反向补漏脚本；脚本产物不得留在此目录 | -## 4. 行业 / 研究案例目录 +研报类行业级通用资料库默认使用： -正式行业研报研究应按独立文件夹管理。每个新的行业研究案例必须在 `ana-doc/` 下创建自己的案例文件夹，并在文件夹根目录创建与本层 `ana-doc/` 对应的一组案例文档。 +```text +ana-data/cases/<行业案例>/ + raw/ + converted/ + extracted/ + supplement/ + evidence/ + manifest/ +``` + +研报类逐案例自定义结果目录默认使用： + +```text +ana-data/cases/<行业案例>/<case_id>/ + outputs/ + manifest/ + evidence/ +``` + +研报类父体系兼容目录默认使用： + +```text +ana-data/tmp/<行业案例>/<case_id>/<run_id>/ +ana-data/result/<行业案例>/<case_id>/ +ana-data/img/<行业案例>/<case_id>/ +``` + +研报类行业统一 raw 池默认使用： + +```text +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_id`、`batch_id`、`run_id` 绑定。不得创建 `ana-data/cases/<行业案例>/<case_id>/raw/`，也不得按 batch 或 run 拆 raw 原始资料目录。 + +## 5. 行业 / 研究案例目录 + +正式行业研报研究应按行业容器文件夹管理。每个新的行业方向必须在 `ana-doc/` 下创建自己的行业容器文件夹；行业容器不是一个案例，不创建自己的 `案例总纲.md`。 | 目录 | 作用 | 状态 | |---|---|---| -| `有色案例/` | 有色行业研报案例模板和后续有色研报研究入口 | 已创建模板 | +| `有色案例/` | 有色行业研报容器和后续有色研报研究入口 | 已创建 | -行业案例目录中的规范类和存储类文档以本层 `ana-doc/` 的同名文档为母版；总纲、分析设计、执行日志、审计报告和问题记录作为该行业案例自己的账本独立维护。 +每个行业案例目录根目录至少包含： -## 5. 当前案例入口 +1. `目录导读.md` +2. `案例分析规范.md` +3. `案例审核规范.md` +4. `案例存储体系.md` +5. `案例分析设计.md` +6. `案例执行日志.md` +7. `案例审计报告.md` +8. `案例问题记录.md` +9. `<行业>研报解析方案.md` + +行业案例目录中的规范类和存储类文档以本层 `ana-doc/` 的同名文档为母版；行业 `案例分析规范.md` 和 `案例审核规范.md` 默认只作为轻量继承入口和行业补充，不复制父级主流程、阶段门、审核类型和阻断条件。分析设计、执行日志、审计报告和问题记录作为该行业容器自己的事项、执行、审核和问题账本独立维护。真实案例统一登记在父级 `案例总纲.md`，行业目录不得创建平行的 `案例总纲.md`。 + +## 6. 当前案例入口 | 案例 ID | 名称 | 状态 | 入口 | |---|---|---|---| -| `ANA-SMOKE-001` | 案例体系初始化 dry-run | 初始化完成，待审核员复核 | `案例总纲.md`、`案例分析设计.md`、`案例执行日志.md`、`案例审计报告.md` | +| `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` 补设计；设计审核通过后才能执行。 +新增正式案例时，应先在父级 `案例总纲.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`。 -- Gitblit v1.9.3