0518

LOF 实时数据查询系统

前后端分离项目，展示 LOF 基金的实时交易价格、溢价率和申购限额。

技术栈

端	技术
前端	Vue 3 + Vite + Element Plus + Axios
后端	FastAPI + Uvicorn + akshare + pandas

---

目录结构

lof_project/
├── back/               # 后端服务
│   ├── main.py         # FastAPI 主程序
│   └── requirements.txt
├── front/              # 前端项目
│   └── vite-project/
│       ├── package.json
│       └── src/
└── README.md

---

一、后端服务

前置要求

• Python 3.10+（下载地址）

1. 安装依赖

cd back

# 创建虚拟环境（推荐）
python -m venv venv

# 激活虚拟环境
# macOS / Linux
source venv/bin/activate

# Windows
venv\Scripts\activate

# 安装依赖
pip install -r requirements.txt

2. 启动服务

# 确保在 back 目录且虚拟环境已激活
source venv/bin/activate

uvicorn main:app --reload --port 8000

• main:app — main.py 中的 app 实例
• --reload — 开发模式，代码修改自动重启
• --port 8000 — 服务端口

3. 验证

• API 文档：http://127.0.0.1:8000/docs
• LOF 数据接口：http://127.0.0.1:8000/api/lof

---

二、前端服务

前置要求：电脑上需安装 nvm（Node 版本管理工具）。

1. 切换 Node 版本

前端项目通过 .nvmrc 文件锁定 Node 版本（当前为 v22.21.1）。

macOS / Linux：

cd front/vite-project

# 自动读取 .nvmrc 中的版本并切换
nvm use

# 如果该版本未安装，先安装再切换
nvm install
nvm use

Windows：

Windows 版 nvm 不支持自动读取 .nvmrc，需显式指定版本号：

cd front/vite-project

nvm install v22.21.1
nvm use v22.21.1

2. 安装依赖

npm install

3. 启动服务

npm run dev

默认运行在 http://localhost:5173

3. 构建生产包

npm run build

---

三、接口说明

GET /api/lof

获取全量 LOF 实时数据。

返回字段：

字段	类型	说明
fundCode	string	基金代码
fundName	string	基金名称
tradePrice	number	最新交易价
increaseRate	number	涨跌幅（%）
netValue	number	最新净值
premiumRate	number	溢价率（%）
purchaseLimit	string	日申购限额
purchaseStatus	string	申购状态

限额显示规则：

• 不限 — 日限额 ≥ 1 亿
• 暂停申购 — 日限额为 0
• xx元/日 — 日限额 < 1 万
• xx万/日 — 日限额 ≥ 1 万

---

四、常见问题

1. 后端端口被占用

# 查找占用 8000 端口的进程并结束
lsof -ti:8000 | xargs kill -9

2. 前端请求后端接口失败

确保后端服务已启动，且 CORS 配置正确（默认允许所有来源）。