# 基金预估

**Repository Path**: goodlucks/fund-estimation

## Basic Information

- **Project Name**: 基金预估
- **Description**: 用ai生成的基金预估管理系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-02
- **Last Updated**: 2026-06-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 基金实时预估系统 MVP

原生 PHP + MySQL 实现的 PC 端基金实时预估系统。

## 功能

- 添加、编辑、删除基金持仓
- 添加时只需要基金代码、持有金额、总盈亏率
- 添加时自动从第三方接口获取基金名称
- 刷新时自动从第三方接口获取最后预估涨跌率
- 编辑时支持修改备注、持有金额、总盈亏金额
- 每只基金可配置估值来源：自动接口、东方财富移动端、天天基金旧接口、跟踪标的、不自动估值
- AJAX 定时刷新
- 统计盈亏金额、累计盈亏、当前金额
- 交易日 17:00 后执行每日结算并写入历史记录
- 查看历史收益

## 环境要求

- PHP 8.0+
- MySQL 5.7+ / MySQL 8+
- PHP 扩展：PDO、pdo_mysql、curl

## 安装

1. 创建数据库并导入 SQL：

```sql
CREATE DATABASE afund DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

然后导入：

```bash
mysql -uroot -p afund < database/schema.sql
```

如果已经导入过旧版本表结构，请额外执行：

```bash
mysql -uroot -p afund < database/migrations/20260613_add_manual_profit_rate.sql
mysql -uroot -p afund < database/migrations/20260613_add_estimate_profit_rate.sql
mysql -uroot -p afund < database/migrations/20260613_add_quote_source_config.sql
```

2. 复制配置文件：

```bash
copy config\config.example.php config\config.php
```

3. 修改 `config/config.php` 中的数据库账号密码。

4. 启动 PHP 内置服务器：

```bash
php -S 127.0.0.1:8000 -t public
```

5. 浏览器访问：

```text
http://127.0.0.1:8000
```

6. nginx配置
```angular2html
if (!-e $request_filename) {
   rewrite  ^(.*)$  /index.php?s=/$1  last;
   break;
}
```

## 定时任务

交易日 17:00 后执行每日结算：

```bash
php cron/daily_settlement.php
```

可配置到 Windows 任务计划程序或 Linux cron。

## 数据源说明

默认优先使用东方财富移动端估值接口：

```text
https://fundmobapi.eastmoney.com/FundMApi/FundVarietieValuationDetail.ashx
```

如果移动端接口失败，再回退到天天基金旧估值接口：

```text
https://fundgz.1234567.com.cn/js/{基金代码}.js
```

公开接口可能出现限流、字段变化或延迟。当前版本添加基金时会按代码自动获取基金名称，刷新时自动获取最后预估涨跌率；总盈亏率仍由用户手动维护。若某只基金页面显示与接口仍不一致，需要为该基金配置跟踪指数/ETF 估算法。

## 估值来源配置

```text
自动接口：优先东方财富移动端，失败后回退天天基金旧接口
东方财富移动端：只使用 FundVarietieValuationDetail
天天基金旧接口：只使用 fundgz.1234567.com.cn
跟踪标的：使用 Yahoo Finance 获取跟踪标的涨跌率，可叠加汇率涨跌率
不自动估值：不读取第三方接口
```

跟踪标的示例：

```text
纳指类基金：QQQ 或 ^NDX
标普类基金：SPY 或 ^GSPC
港股科技：可尝试 3033.HK、3067.HK 等相关 ETF
汇率：USDCNY、HKDCNY
```

## 手动盈亏计算

```text
总盈亏 = 持有金额 × 总盈亏率 / 100
当前金额 = 持有金额 + 总盈亏
预估盈亏 = 持有金额 × 第三方接口返回的最后预估涨跌率 / 100
```

例如基金 `016664`，持有金额 `10000`，总盈亏率 `2.77`，第三方接口返回最后预估涨跌率 `-0.44`：

```text
总盈亏 = 277.00
当前金额 = 10277.00
预估盈亏 = -44.00
```