# 基金标的公司估值系统（GXApp）— 软件总览与使用指南

> 基于市场法的基金标的企业价值评估软件。采用熵权法 + TOPSIS 的客观加权与排序方法，结合可比公司筛选与市场乘数，生成专业的估值结果与报告。

- 项目名称：GSDJGX App（基金标的公司估值系统）
- 当前版本：2.1.498
- 开发者：beijihu
- 仓库文档：详见本目录与下文链接

相关文档：

- 用户操作说明：《[操作说明](/gxapp/%E6%93%8D%E4%BD%9C%E8%AF%B4%E6%98%8E.md)》
- 开发详情与技术架构：《[开发详情](/gxapp/%E5%BC%80%E5%8F%91%E8%AF%A6%E6%83%85.md)》

## 快速开始

### 面向业务用户（桌面应用）

- 启动方式：打开已安装的桌面程序。
- 首次启动：欢迎页点击“打开工作目录”，选择用于保存项目/数据库的根目录；或顶部菜单“文件 → 打开目录”。
- 切换工作区：顶部菜单“文件 → 恢复上次目录”快速定位到上次工作位置。
- 刷新：顶部菜单“文件 → 重新加载”。

提示：设置工作区后，系统会自动尝试加载“激活的基准日”。

### 面向开发者（本地运行）

- 环境要求：

  - Node.js 22+（Angular 22 要求 22.22.3 或 24.15+）
  - Rust 1.94+（`rust-version = "1.94"`，sqlx 0.9 / SeaORM 2.0 的最低要求）
  - pnpm
  - macOS 需安装 Xcode CLT（zsh 终端运行：`xcode-select --install`）
- 安装依赖：

  ```bash
  pnpm install
  ```
- 开发模式（桌面应用）：

  ```bash
  pnpm tauri dev
  ```
- 仅前端：

  ```bash
  pnpm start
  ```
- 运行测试：

  ```bash
  pnpm test
  pnpm test:watch
  pnpm test:coverage
  ```
- 构建：

  ```bash
  pnpm build        # 前端构建
  pnpm tauri build  # 桌面应用构建
  ```

脚本说明与更多细节见《[开发详情](/gxapp/%E5%BC%80%E5%8F%91%E8%AF%A6%E6%83%85.md)》。

## 核心功能模块

### 1) 可比公司筛选

- 基于行业/板块筛选上市公司，支持搜索与个股加入
- 多维过滤维度（ST、负利润、小市值、低流动性、停牌等）
- 支持“参与计算”勾选与自动保存
- 可按需拉取 PB/PE/PS 等财务指标并动态生成列

### 2) 指标体系配置

- 管理财务与非财务指标，设置正/负向/区间属性与计算规则
- 分层结构（规模、盈利、成长、研发等）与指标别名系统
- 支持动态调整与权重分析

### 3) 数据获取与标准化

- 多渠道数据获取（同花顺 API、内部数据库）
- 数据清洗、异常值处理与无量纲化（归一化/对数归一化）
- 生成标准化评价矩阵

### 4) 指标加权（熵权法）

- 依据指标离散度客观赋权，生成权重向量
- 中间结果可视化（entropy_table/weights）

### 5) TOPSIS 评分与排序

- 构造正/负理想解，计算相对贴近度
- 生成精选公司评分（final_scores）与排名

### 6) 估值计算与报告

- 价值比率类型选择与调整（如 PE/PB/PS/EV/S）
- 市场乘数重算与别名统计
- 股权价值计算、估值区间与结构化报告生成/管理

### 7) 项目与基金管理

- 基金树视图、项目切换与扩展信息管理
- 估值日期管理：新增/编辑/删除与“激活的基准日”设置

### 8) 办公系统联动（绑定 / 确认 / 上传）

- 项目汇总表中可将本地项目绑定到办公系统（Luculent）远程项目，支持换绑与解绑
- 数据校验页按基准日确认估值数据快照，确认状态与数据一致性实时显示
- 报告管理页一键上传估值数据 + 估值报告（HTML）+ 工作底稿（Excel）到办公系统
- 绑定状态为全局共享的 Signal 状态（单一数据源），绑定/确认/解绑后各标签页按钮状态即时同步，无需手动刷新
- 详细操作见《[项目数据提交](/gxapp/%E6%8A%A5%E5%91%8A%E4%B8%8A%E4%BC%A0.md)》

## 典型工作流（估值业务）

估值流程：公司选择 → 数据准备 → 指标规范化 → 熵权法 → TOPSIS → 估值与报告。

1) 选择/设置工作区：欢迎页“打开工作目录”或“文件 → 打开目录”；已设置后可“恢复上次目录”。
2) 基金与项目选择：左侧“基金树”选择基金或项目；点击基金进入“基金管理”，点击项目进入“项目操作”。
3) 基金管理：

   - 项目汇总表 → 估值基准日 → 数据校验 → 报告管理（标签页 Tab 导航）
   - 设置/切换全局唯一“激活的基准日”
4) 项目操作：

   - 基本信息、投融资管理、财务数据、方法选择、可比公司、参数设定、校验计算、报告预览
   - 切换“激活的基准日”会刷新子模块数据

详细步骤请见《[操作说明](/gxapp/%E6%93%8D%E4%BD%9C%E8%AF%B4%E6%98%8E.md)》的第 9 章。

## 界面导航与路由结构

左侧导航（left-pane）

- fundtreeview：基金树视图
- folderpages：文件夹页面
- user-info：用户信息

主内容面板（main-pane）

- welcome、fund-management、project-operation、system-setting、project-summary、project-extension、auto-calculate-example、greedy-calaulate-example、report-management、aap-calculator（平均亚式期权法工具）

路由为懒加载（`withPreloading(PreloadAllModules)`），桌面端启动后空闲时预取全部模块，面板切换零延迟。

交互要点：

- 左侧栏图标重复点击可折叠/展开左侧面板
- 顶部菜单“最近项目”可快速切换历史项目
- 文件浏览器提供右键菜单，新建/预览/复制路径等

## 技术架构（精简版）

前端

- Angular 22.1.3（独立组件、懒加载路由）
- Zoneless 变更检测（`provideZonelessChangeDetection`）+ Angular Signals 信号优先的状态管理；组件普遍启用 OnPush
- Syncfusion EJ2 33.2.x（内置简体中文本地化 syncfusion-ej2-zh-cn）、ECharts 6.1.x
- TypeScript ~6.0.3、Syncfusion Tailwind3 Lite 主题、RxJS 7.8（服务层数据流）

后端/桌面

- Tauri 2.11.x、Rust 2021（rustc ≥ 1.94）
- SQLite（SeaORM 2.0 / sqlx 0.9 与 @tauri-apps/plugin-sql）
- OpenAI API RS v10、Reqwest v0.13

开发/构建

- pnpm、Angular CLI、Tauri CLI、Jasmine + Karma、ESLint
- `pnpm check`：项目结构检查 + 类型检查 + 单测 + 前端构建 + Rust 测试一条龙

完整说明见《[开发详情](/gxapp/%E5%BC%80%E5%8F%91%E8%AF%A6%E6%83%85.md)》。

## NPM/PNPM 脚本（摘录）

| 脚本                              | 作用                         |
| --------------------------------- | ---------------------------- |
| start                             | Angular Dev Server（仅前端） |
| build                             | 构建前端产物                 |
| tauri dev                         | 启动桌面开发环境             |
| tauri build                       | 构建生产桌面应用             |
| release                           | 前端构建 + 桌面应用打包      |
| release:upload                    | 构建并上传发行制品           |
| test / test:watch / test:coverage | 单元测试相关                 |

更多脚本与使用方式请查看《[开发详情](/gxapp/%E5%BC%80%E5%8F%91%E8%AF%A6%E6%83%85.md)》。

## 数据持久化与安全

- 数据库：SQLite（见 `src-tauri/sql/`）
- 结果持久化：指标结果/报告生成记录
- 状态持久化：`@tauri-apps/plugin-store`
- 能力与权限：`src-tauri/capabilities/` 控制文件系统/对话框/进程等访问

## 帮助与更新

- 文档：顶部菜单“帮助 → 文档”打开在线帮助站点；或查看本目录的《[操作说明](/gxapp/%E6%93%8D%E4%BD%9C%E8%AF%B4%E6%98%8E.md)》
- 检查更新：顶部菜单“帮助 → 检查更新”，如有新版本可一键下载并安装（已配置更新端点，但当前默认关闭自动更新，需手动触发）

## 常见问题与排查（FAQ）

- 无法选择工作区/数据库连接失败：确认通过“打开工作目录”设置工作区；可点击“重试数据库连接”或重启应用
- 切换项目无反应/失败：确认已设置“激活的基准日”，并保存未提交的修改
- 指标列未显示：在“可比公司”页面执行“更新财务数据”
- 估值结果异常：在“校验计算”页检查标准化参数、熵权与 TOPSIS 输入
- 报告无法预览/生成：确认可比公司与参数设定已完成；必要时“重新加载”或重启

## 许可证与联系

本项目为私有项目，版权所有。

- © 怪兽的家（GSDJ）
- 联系方式：[jun.yin@live.com](mailto:jun.yin@live.com)

---

最后更新时间：2026-09-07（与《开发详情》同步，对应应用版本 2.1.498）