# cyrusi6/astravalue architecture

> Architecture diagram of the GitHub repository cyrusi6/astravalue, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cyrusi6/astravalue
- Repository: https://github.com/cyrusi6/astravalue

## Overview

这是一个本地运行的 A 股投研与财报分析系统。主要流程是研究者准备公司任务，工作区按研究问题读取并补充资料，轻量研究包整理证据与覆盖情况，再由结构化报告入口冻结报告版本并提供只读查询和导出。另有独立采集链负责计划、联网执行和快照留存。README 还列出估值、治理、知识库及多格式导出能力；部分未采样实现只按文档能力呈现，相关连线仅在有明确依据时给出。

Main entry points: [`src/analysis/structured/service.py`](https://github.com/cyrusi6/astravalue/blob/main/src/analysis/structured/service.py) (结构化服务), [`src/analysis/research/workspace.py`](https://github.com/cyrusi6/astravalue/blob/main/src/analysis/research/workspace.py) (研究工作区), [`src/analysis/research/catalog.py`](https://github.com/cyrusi6/astravalue/blob/main/src/analysis/research/catalog.py) (资料目录), [`src/analysis/acquisition/runtime.py`](https://github.com/cyrusi6/astravalue/blob/main/src/analysis/acquisition/runtime.py) (采集运行时)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_research["研究工作区"]
  node_workspace["研究工作区<br/>[workspace.py]"]
  node_catalog["资料目录<br/>[catalog.py]"]
  node_lite["八步研究包<br/>[research_lite.py]"]
end

subgraph group_acquisition["资料采集"]
  node_acq_runtime["采集运行时<br/>[runtime.py]"]
  node_orchestrator["采集编排<br/>[orchestrator.py]"]
  node_adapter["官方来源适配器<br/>[official.py]"]
  node_acq_repository[("采集仓储<br/>[repository.py]")]
  node_snapshots["采集快照<br/>[snapshots.py]"]
  node_acq_models["采集模型<br/>[models.py]"]
end

subgraph group_structured["结构化数据"]
  node_structured_service["结构化服务<br/>[service.py]"]
  node_structured_runtime["结构化运行时<br/>[runtime.py]"]
  node_field_registry["字段注册表<br/>[registry.py]"]
  node_identity["存储身份<br/>[identity.py]"]
  node_scope["研究范围<br/>[scope.py]"]
  node_structured_store[("结构化存储<br/>[storage.py]")]
end

subgraph group_analysis["分析与治理"]
  node_core_storage[("分析存储<br/>[storage.py]")]
  node_domain_models["领域模型<br/>[models.py]"]
  node_canonical["治理规范化<br/>[canonical.py]"]
  node_valuation["估值分析<br/>[valuation.py]"]
end

subgraph group_reporting["报告输出"]
  node_reporting_bridge["报告桥接"]
  node_exports["报告导出<br/>[exports.py]"]
  node_knowledge["知识服务<br/>[service.py]"]
end

node_analyst(("研究者"))

node_analyst -->|"准备任务"| node_workspace
node_workspace -->|"使用身份"| node_identity
node_workspace -->|"生成研究包"| node_lite
node_workspace -->|"读取范围"| node_scope
node_analyst -->|"请求资料"| node_catalog
node_catalog -->|"读取工作区"| node_workspace
node_catalog -->|"核对数据"| node_structured_runtime
node_catalog -->|"调用研究包"| node_lite
node_analyst -->|"启动采集"| node_acq_runtime
node_acq_runtime -->|"编排运行"| node_orchestrator
node_acq_runtime -->|"读写运行"| node_acq_repository
node_orchestrator -->|"请求来源"| node_adapter
node_orchestrator -->|"保存运行"| node_acq_repository
node_orchestrator -->|"保存快照"| node_snapshots
node_acq_runtime -->|"装配定义"| node_acq_models
node_analyst -->|"执行数据计划"| node_structured_service
node_structured_service -->|"调用运行时"| node_structured_runtime
node_structured_service -->|"读取注册表"| node_field_registry
node_structured_service -->|"读写投影"| node_structured_store
node_structured_service -->|"生成报告"| node_reporting_bridge
node_structured_service -->|"调用研究包"| node_lite
node_reporting_bridge -->|"生成版本"| node_domain_models
node_analyst -->|"提出假设"| node_valuation
node_reporting_bridge -->|"导出报告"| node_exports
node_structured_store -->|"共享控制面"| node_acq_repository
node_core_storage -->|"保存领域记录"| node_domain_models
node_canonical -->|"规范化实体"| node_domain_models
node_analyst -->|"按需查阅"| node_knowledge

click node_workspace "https://github.com/cyrusi6/astravalue/blob/main/src/analysis/research/workspace.py"
click node_catalog "https://github.com/cyrusi6/astravalue/blob/main/src/analysis/research/catalog.py"
click node_lite "https://github.com/cyrusi6/astravalue/blob/main/src/analysis/structured/research_lite.py"
click node_acq_runtime "https://github.com/cyrusi6/astravalue/blob/main/src/analysis/acquisition/runtime.py"
click node_orchestrator "https://github.com/cyrusi6/astravalue/blob/main/src/analysis/acquisition/orchestrator.py"
click node_adapter "https://github.com/cyrusi6/astravalue/blob/main/src/analysis/acquisition/adapters/official.py"
click node_acq_repository "https://github.com/cyrusi6/astravalue/blob/main/src/analysis/acquisition/repository.py"
click node_snapshots "https://github.com/cyrusi6/astravalue/blob/main/src/analysis/acquisition/snapshots.py"
click node_acq_models "https://github.com/cyrusi6/astravalue/blob/main/src/analysis/acquisition/models.py"
click node_structured_service "https://github.com/cyrusi6/astravalue/blob/main/src/analysis/structured/service.py"
click node_structured_runtime "https://github.com/cyrusi6/astravalue/blob/main/src/analysis/structured/runtime.py"
click node_field_registry "https://github.com/cyrusi6/astravalue/blob/main/src/analysis/structured/registry.py"
click node_identity "https://github.com/cyrusi6/astravalue/blob/main/src/analysis/structured/identity.py"
click node_scope "https://github.com/cyrusi6/astravalue/blob/main/src/analysis/structured/scope.py"
click node_structured_store "https://github.com/cyrusi6/astravalue/blob/main/src/analysis/structured/storage.py"
click node_core_storage "https://github.com/cyrusi6/astravalue/blob/main/src/analysis/storage.py"
click node_domain_models "https://github.com/cyrusi6/astravalue/blob/main/src/analysis/models.py"
click node_canonical "https://github.com/cyrusi6/astravalue/blob/main/src/analysis/governance/canonical.py"
click node_valuation "https://github.com/cyrusi6/astravalue/blob/main/src/analysis/valuation.py"
click node_reporting_bridge "https://github.com/cyrusi6/astravalue/blob/main/src/analysis/structured/reporting_bridge.py"
click node_exports "https://github.com/cyrusi6/astravalue/blob/main/src/analysis/exports.py"
click node_knowledge "https://github.com/cyrusi6/astravalue/blob/main/src/analysis/knowledge/service.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_workspace,node_catalog,node_lite toneBlue
class node_acq_runtime,node_orchestrator,node_adapter,node_acq_repository,node_snapshots,node_acq_models toneAmber
class node_structured_service,node_structured_runtime,node_field_registry,node_identity,node_scope,node_structured_store toneMint
class node_core_storage,node_domain_models,node_canonical,node_valuation toneRose
class node_reporting_bridge,node_exports,node_knowledge,node_analyst toneIndigo
```

## Components

### 研究工作区

- [研究工作区](https://github.com/cyrusi6/astravalue/blob/main/src/analysis/research/workspace.py): `src/analysis/research/workspace.py`
- [资料目录](https://github.com/cyrusi6/astravalue/blob/main/src/analysis/research/catalog.py): `src/analysis/research/catalog.py`
- [八步研究包](https://github.com/cyrusi6/astravalue/blob/main/src/analysis/structured/research_lite.py): `src/analysis/structured/research_lite.py`

### 资料采集

- [采集运行时](https://github.com/cyrusi6/astravalue/blob/main/src/analysis/acquisition/runtime.py): `src/analysis/acquisition/runtime.py`
- [采集编排](https://github.com/cyrusi6/astravalue/blob/main/src/analysis/acquisition/orchestrator.py): `src/analysis/acquisition/orchestrator.py`
- [官方来源适配器](https://github.com/cyrusi6/astravalue/blob/main/src/analysis/acquisition/adapters/official.py): `src/analysis/acquisition/adapters/official.py`
- [采集仓储](https://github.com/cyrusi6/astravalue/blob/main/src/analysis/acquisition/repository.py): `src/analysis/acquisition/repository.py`
- [采集快照](https://github.com/cyrusi6/astravalue/blob/main/src/analysis/acquisition/snapshots.py): `src/analysis/acquisition/snapshots.py`
- [采集模型](https://github.com/cyrusi6/astravalue/blob/main/src/analysis/acquisition/models.py): `src/analysis/acquisition/models.py`

### 结构化数据

- [结构化服务](https://github.com/cyrusi6/astravalue/blob/main/src/analysis/structured/service.py): `src/analysis/structured/service.py`
- [结构化运行时](https://github.com/cyrusi6/astravalue/blob/main/src/analysis/structured/runtime.py): `src/analysis/structured/runtime.py`
- [字段注册表](https://github.com/cyrusi6/astravalue/blob/main/src/analysis/structured/registry.py): `src/analysis/structured/registry.py`
- [存储身份](https://github.com/cyrusi6/astravalue/blob/main/src/analysis/structured/identity.py): `src/analysis/structured/identity.py`
- [研究范围](https://github.com/cyrusi6/astravalue/blob/main/src/analysis/structured/scope.py): `src/analysis/structured/scope.py`
- [结构化存储](https://github.com/cyrusi6/astravalue/blob/main/src/analysis/structured/storage.py): `src/analysis/structured/storage.py`

### 分析与治理

- [分析存储](https://github.com/cyrusi6/astravalue/blob/main/src/analysis/storage.py): `src/analysis/storage.py`
- [领域模型](https://github.com/cyrusi6/astravalue/blob/main/src/analysis/models.py): `src/analysis/models.py`
- [治理规范化](https://github.com/cyrusi6/astravalue/blob/main/src/analysis/governance/canonical.py): `src/analysis/governance/canonical.py`
- [估值分析](https://github.com/cyrusi6/astravalue/blob/main/src/analysis/valuation.py): `src/analysis/valuation.py`

### 报告输出

- [报告桥接](https://github.com/cyrusi6/astravalue/blob/main/src/analysis/structured/reporting_bridge.py): `src/analysis/structured/reporting_bridge.py`
- [报告导出](https://github.com/cyrusi6/astravalue/blob/main/src/analysis/exports.py): `src/analysis/exports.py`
- [知识服务](https://github.com/cyrusi6/astravalue/blob/main/src/analysis/knowledge/service.py): `src/analysis/knowledge/service.py`

### Other components

- **研究者**

## Connections

- 研究者 → 研究工作区: 准备任务 (evidence: `README.md`)
- 研究工作区 → 存储身份: 使用身份 (evidence: `src/analysis/research/workspace.py`)
- 研究工作区 → 八步研究包: 生成研究包 (evidence: `src/analysis/research/workspace.py`)
- 研究工作区 → 研究范围: 读取范围 (evidence: `src/analysis/research/workspace.py`)
- 研究者 → 资料目录: 请求资料 (evidence: `README.md`)
- 资料目录 → 研究工作区: 读取工作区 (evidence: `src/analysis/research/catalog.py`)
- 资料目录 → 结构化运行时: 核对数据 (evidence: `src/analysis/research/catalog.py`)
- 资料目录 → 八步研究包: 调用研究包 (evidence: `src/analysis/research/catalog.py`)
- 研究者 → 采集运行时: 启动采集 (evidence: `README.md`)
- 采集运行时 → 采集编排: 编排运行 (evidence: `src/analysis/acquisition/runtime.py`)
- 采集运行时 → 采集仓储: 读写运行 (evidence: `src/analysis/acquisition/runtime.py`)
- 采集编排 → 官方来源适配器: 请求来源 (evidence: `src/analysis/acquisition/orchestrator.py`)
- 采集编排 → 采集仓储: 保存运行 (evidence: `src/analysis/acquisition/orchestrator.py`)
- 采集编排 → 采集快照: 保存快照 (evidence: `src/analysis/acquisition/orchestrator.py`)
- 采集运行时 → 采集模型: 装配定义 (evidence: `src/analysis/acquisition/runtime.py`)
- 研究者 → 结构化服务: 执行数据计划 (evidence: `README.md`)
- 结构化服务 → 结构化运行时: 调用运行时 (evidence: `src/analysis/structured/service.py`)
- 结构化服务 → 字段注册表: 读取注册表 (evidence: `src/analysis/structured/service.py`)
- 结构化服务 → 结构化存储: 读写投影 (evidence: `src/analysis/structured/service.py`)
- 结构化服务 → 报告桥接: 生成报告 (evidence: `README.md`)
- 结构化服务 → 八步研究包: 调用研究包 (evidence: `src/analysis/structured/service.py`)
- 报告桥接 → 领域模型: 生成版本 (evidence: `README.md`)
- 研究者 → 估值分析: 提出假设 (evidence: `README.md`)
- 报告桥接 → 报告导出: 导出报告 (evidence: `README.md`)
- 结构化存储 → 采集仓储: 共享控制面 (evidence: `src/analysis/structured/storage.py`)
- 分析存储 → 领域模型: 保存领域记录 (evidence: `src/analysis/storage.py`)
- 治理规范化 → 领域模型: 规范化实体
- 研究者 → 知识服务: 按需查阅 (evidence: `README.md`)
