# 案例分析设计

创建人员：management.admin
文件职责：记录 `project-info` 项目案例选择口径、执行步骤、证据要求、产物和验收方式。
管理规范/模板：../../common/ana-doc/案例分析设计模版.md；../../common/ana-doc/案例分析环境创建指南.md。
引用文件：案例分析规范.md；案例总纲.md；案例执行日志.md；案例审计报告.md；案例存储体系.md。
记录方式：append-only 设计账本；每个案例设计追加到文件末尾，设计审核通过后才能执行正式案例。

## 1. 当前设计总览

| 设计 ID | 所属案例事项 | 目标 | 状态 | 设计审计 |
|---|---|---|---|---|
| `DESIGN-ANA-SMOKE-001` | `ANA-SMOKE-001` | 验证项目案例体系环境能从总纲追到设计、执行日志和审计报告 | 已记录，待审核员复核 | `AUDIT-ANA-SMOKE-001` |
| `DESIGN-ANA-REPORT-SYSTEM-20260625-001` | `ANA-REPORT-SYSTEM-20260625-001` | 将研报体系融入 `project-info/ana-doc` 案例体系 | 已执行，待审核员复核 | `AUDIT-ANA-REPORT-SYSTEM-20260625-001` |

## 2. 设计记录模板

### <YYYY-MM-DD HH:mm:ss> <DESIGN-ID>：<设计标题>

所属案例事项：
<ANA-ID / 名称>

创建人员：
<创建人员>

来源聊天记录：
```text
<粘贴关键聊天记录，或写明案例总纲中的来源位置>
```

目标对齐说明：
<说明本设计如何满足案例总纲目标；如有取舍，写明原因>

案例选择口径：
<候选案例从哪里来，如何筛选，为什么这些案例代表当前目标>

分析对象：
<股票 / 用户 / 模块 / 流程 / 事件 / 资料 / 其他>

全流程步骤：

1. <候选来源与候选池生成>
2. <具体案例选择>
3. <关键判断或操作步骤>
4. <结果记录>
5. <复盘与结论>

逐案例执行流程：
```text
<写清每个案例实际执行时的证据链顺序>
```

执行流程冻结说明：
<说明设计审核通过后，执行员必须按上述流程执行；如需偏离，必须记录偏离原因并进入复审>

证据要求：

1. <每个案例必须保留哪些数据>
2. <每个关键判断必须指向什么证据>

图片要求：
<如需要图片，说明标注要求；如不需要，说明替代证据>

数据输出：
<case_index、case_step_trace、operation_ledger、image_manifest、summary 等>

验收方式：
<如何判断本设计执行成功>

未来函数 / 泄漏判断：
<是否需要防未来函数；如果不要求，写明原因>

设计审计状态：
未审计 / 审计通过 / 审计不通过 / 暂缓

设计审计入口：
<案例审计报告.md 中 AUDIT-ID>

执行日志入口：
<案例执行日志.md 中 LOG-ID>

当前结论：
<当前设计是否可执行>

## 3. 研报类设计补充模板

研报类案例除使用上方通用设计模板外，必须额外写清以下内容。没有这些字段，设计审核不得放行正式研报读取。

研报任务归属：

| 字段 | 内容 |
|---|---|
| 父级案例 ID | <必须已登记父级 `案例总纲.md`> |
| 行业容器 | `ana-doc/<行业>案例/` |
| 行业方案 | `<行业>研报解析方案.md` |
| case_id | <长期案例或专题案例 ID> |
| batch_id | <本次输入批次，例如 BATCH-001；不等于新案例> |
| run_id | <本次执行轮次> |

融合执行矩阵：

| 阶段 | ana 控制点 | 研报专业动作 | 产物 / 路径 | 验收口径 |
|---|---|---|---|---|
| 来源和总纲 | 记录来源、目标、行业、边界 | 判断研报任务和行业范围 | 父级 `案例总纲.md` | 来源可追踪 |
| 行业方案 | 方法先成型 | 创建或更新行业方案 | `<行业>研报解析方案.md` | 方案不是模板 |
| 设计冻结 | 冻结输入、步骤、证据、输出 | 写清 batch/run、资料范围、存储落点、darkline 触发边界 | 行业 `案例分析设计.md` | 可指导执行 |
| 设计审核 | 审核通过才执行 | 审核方案和设计 | 行业 `案例审计报告.md` | 未通过不执行 |
| raw 归档 | 执行留痕从原始资料开始 | 原件入行业统一 raw 池，登记 hash、文件头和来源 | `ana-data/cases/<行业案例>/raw/`；行业 `manifest/` | raw 可追溯 |
| 转换抽取 | 过程证据可复核 | 转换、抽取事实/观点/指标/公司映射/缺口 | 行业 `converted/`、`extracted/` | 不只读不归档 |
| 补数分流 | 缺口不过读 | 公开资料补充、市场反向补漏、darkline 分流 | 行业 `supplement/`、`evidence/` | 缺口和暗线分账 |
| 证据数据卡 | 关键判断有证据 | 数据卡、来源定位、结论证据映射 | 行业和案例级 `evidence/` | 强结论可复核 |
| 人读输出 | 结果包归档 | 行业视图、市场视图、公司视图和扩展输出 | 案例级 `outputs/` | 三类视图不缺失 |
| 归档自检 | 全流程留痕 | manifest、验证报告、tmp/result/img 分流 | 行业/案例 `manifest/`；父体系 `tmp/result/img` | 路径可打开 |
| 执行审核和回写 | 审核、修复、复审 | 审计问题修复，回写总纲、设计、行业方案 | 审计报告；父级总纲；行业方案维护记录 | 未复审不交付 |

数据和状态要求：

1. 每个输入资料必须有来源、原始路径、归档路径、hash 或等价校验。
2. `source_document`、`artifact_manifest`、`conversion_status`、`evidence_index` 或等价记录必须包含 `case_id`、`batch_id`、`run_id`。
3. 缺核心数据时必须写 `DATA_GAP_REVIEW`、`DATA_PARTIAL`、`MECHANISM_ONLY` 或 `HELD_BY_EVIDENCE_GAP`，不能用文字推理绕过。
4. 需要网上补充、外部信息、新闻公告、市场显影或暗线分析时，必须在设计里声明使用 `darkline` 技能。

## 2026-06-25 20:55:00 DESIGN-ANA-SMOKE-001：案例体系初始化 dry-run 设计

- 设计 ID：DESIGN-ANA-SMOKE-001
- 所属案例：ANA-SMOKE-001 / 案例体系初始化 dry-run
- 设计人员：management.admin
- 创建时间：2026-06-25T20:55:00+08:00
- 当前状态：待审核员复核
- 设计审计入口：`AUDIT-ANA-SMOKE-001`
- 执行日志入口：`RUN-ANA-SMOKE-001`

### 目标和边界

- 目标：验证项目案例体系环境能从总纲追到设计、执行日志和审计报告。
- 边界：不采集真实新闻、研报、公告、图片或 K 线数据，不产生真实业务结果包。

### 检查项

1. `ana-doc/` 下 9 个基础文档存在，且每个文档包含创建人员、文件职责、管理规范/模板、引用文件、记录方式。
2. `ana-data/cases/`、`ana-data/result/`、`ana-data/img/`、`ana-data/tmp/` 存在，并通过 `.gitkeep` 保证 Git 克隆后目录保留。
3. 本地规范和审核规范引用 common 规范，并声明不得削弱 common 硬约束。
4. `案例存储体系.md` 写清正式结果包、图片、readout、manifest 和 tmp 禁止事项。
5. 项目配置清单和 `mbx.project.yaml` 已登记案例体系目录、文档和角色。

### PASS / FAIL / HELD

- PASS：上述检查项全部满足，且审核员确认没有旧项目业务内容混入。
- FAIL：基础文档缺失、目录缺失、规范冲突、审计入口错误或混入其他项目结论。
- HELD：需要人类确认项目范围或审核员无法读取必要文档。

## 2026-06-25 21:30:00 DESIGN-ANA-REPORT-SYSTEM-20260625-001：研报体系接入 ana-doc 设计

- 设计 ID：DESIGN-ANA-REPORT-SYSTEM-20260625-001
- 所属案例：ANA-REPORT-SYSTEM-20260625-001 / 研报体系接入 ana-doc
- 设计人员：Codex
- 创建时间：2026-06-25
- 当前状态：已按人类确认方案执行，待审核员复核
- 设计审计入口：`AUDIT-ANA-REPORT-SYSTEM-20260625-001`
- 执行日志入口：`RUN-ANA-REPORT-SYSTEM-20260625-001`

### 目标和边界

- 目标：把现有研报体系融入 `project-info/ana-doc` 案例体系，使后续行业研报研究可以按案例总纲、分析设计、执行日志、审计报告、问题记录和统一存储体系运行。
- 边界：不执行真实研报读取，不迁移历史有色资料，不产出行业结论，不修改 common 母版。

### 执行范围

1. 创建 `ana-doc/研报体系/`，迁入 `研报解析架构.md` 和 `研报分析架构.md`。
2. 不迁入独立 `研报存储体系.md`；将研报存储规则融入 `ana-doc/案例存储体系.md`。
3. 更新父级 `案例分析规范.md`，写入研报体系接入流程、新行业创建流程、行业子规范优先级、记录落点和 darkline 使用口径。
4. 更新父级 `案例审核规范.md`，写入研报案例审核清单、阻断项和证据抽查方法。
5. 更新父级 `目录导读.md`，登记研报体系方法母版、行业案例目录和数据目录。
6. 同步 `ana-doc/有色案例/` 子规范和 `有色研报解析方案.md`，删除旧 mirror 临时路径和独立研报存储母版引用。
7. 创建 `ana-data/cases/有色案例/` 空目录入口。

### 验收方式

1. 父级 `ana-doc/研报体系/` 下只有 `研报解析架构.md`、`研报分析架构.md` 两份方法母版。
2. 父级 `案例存储体系.md` 包含研报 `raw/converted/extracted/supplement/evidence/outputs/manifest/tmp` 目录规则。
3. 父级 `案例分析规范.md` 能说明新行业案例如何创建、行业方案如何继承、过程记录落到哪里。
4. 父级 `案例审核规范.md` 能支持审核员发现研报案例的流程、证据、存储、输出和结论问题。
5. `有色案例/` 子规范不再引用旧 mirror 路径或独立 `研报存储体系.md` 作为正式执行入口。
6. 未把有色、矿区等行业专属对象写成通用存储要求。

### PASS / FAIL / HELD

- PASS：上述验收全部满足，且审核员确认未产生父级规范冲突。
- FAIL：仍存在旧路径作为正式入口、平行存储母版、父子规范冲突、行业专属对象被写成通用规则，或审核链路缺失。
- HELD：需要人类确认父级规则和行业子规则冲突点。