# FootBallWeb

**Repository Path**: wheat1224/foot-ball-web

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-01
- **Last Updated**: 2026-04-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FootMind 管理后台（Vue 3 + Vite + Element Plus）

## 技术栈

- Vite 6 + Vue 3（`<script setup>`）+ TypeScript  
- Element Plus、Vue Router 4、Pinia、Axios  
- 样式：Sass（`src/styles/main.scss`）

## 本地运行

1. 确保后端 `api_server.py` 已启动（默认 `http://127.0.0.1:10086`），且 `.env` 中配置了 **`INTERNAL_API_KEY`**。  
2. 安装依赖并启动：

```bash
cd admin-web
npm install
npm run dev
```

浏览器访问 `http://127.0.0.1:5173`，在登录页填入与后端一致的 **Internal API Key**。  
若后端未配置 `.env`，当前默认密钥为：`change-me-for-internal-and-admin-apis`（与 `api_server.py` 中 `INTERNAL_API_KEY` 一致）。

开发环境通过 `vite.config.ts` 的 `proxy` 将 `/api` 转发到后端，避免 CORS。

## 环境变量（可选）

在项目根目录新建 `.env`：

```env
# 若不走代理、直接请求远端 API 时填写完整 origin
# VITE_API_BASE=https://your-api.example.com
```

## 目录结构

```
src/
  api/           # 按模块划分的接口
  layouts/       # MainLayout 侧边栏布局
  router/        # 路由与登录守卫
  stores/        # Pinia（auth）
  utils/request.ts
  views/         # 各业务页
```

## 后端依赖说明

本后台使用以下管理端接口（均需 `X-Internal-Key`）：

- `GET /api/admin/dashboard-stats`
- `GET/PATCH /api/admin/users`、`PATCH /api/admin/users/{id}/assets`
- `GET /api/admin/offline-predictions`、`GET /api/admin/ai-predictions`
- `POST /api/internal/settle-predictions`
- `GET/POST/PUT /api/admin/parlays`
- `GET/PATCH /api/admin/feedback`
- `PATCH /api/admin/leagues/{league_id}/show-in-app`（Body：`{ "show_in_app": 0|1 }`，控制 App 是否展示该联赛）
- `PATCH /api/admin/leagues/{league_id}/league-name`（Body：`{ "league_name": "中文名" }`，`leagues.league_name`）

用户列表、预测列表与大盘统计已在 Python 仓库 `api_server.py` 中实现。完整 App/管理接口见仓库 `doc/FootMind-API.md`。