# arena-frontend

**Repository Path**: quant-seminar/arena-frontend

## Basic Information

- **Project Name**: arena-frontend
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: dev
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-24
- **Last Updated**: 2026-05-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# arena-frontend

`arena-frontend` 是 Arena 因子挖掘网站的 React 前端。当前版本是一个可运行的静态工作台首屏，用于展示后续因子创建、单因子分析和多因子回测的产品形态。

## 技术栈

- Vite
- React
- TypeScript
- Tailwind CSS v4
- shadcn/ui 风格组件
- lucide-react

## 功能范围

- 因子构造 JSON textarea 编辑器。
- 示例载入、格式化、语法校验按钮。
- 因子表现概览、分组收益、单因子回测净值图。
- 已创建因子列表和多因子回测选择区。
- `VITE_ARENA_API_URL` 配置和 API client 骨架。

当前版本使用 mock 数据，不提交真实分析任务，也不持久化业务数据。

## 启动

```bash
cd arena/frontend
npm install
npm run dev
```

默认开发地址：

```text
http://127.0.0.1:5173
```

## 环境变量

复制示例：

```bash
cp .env.example .env
```

配置：

```env
VITE_ARENA_API_URL=http://127.0.0.1:8003
```

## Scripts

```bash
npm run dev
npm run build
npm run lint
npm run preview
```

## 目录结构

```text
frontend
|-- src
|   |-- app
|   |-- components
|   |-- lib
|   `-- styles
|-- components.json
|-- package.json
`-- vite.config.ts
```

## 后续方向

- 接入 `arena-backend` 的健康检查和业务接口。
- 将 JSON 校验升级为 `data` 因子 DSL schema 校验。
- 增加用户因子保存、任务状态和历史结果页面。
- 接入真实单因子分析和多因子回测结果。