# 世界杯预测系统

一个展示世界杯比赛预测结果的Web应用，支持多算法预测对比和管理后台。

## 功能特点

### 前端展示
- 📊 **统计概览**：总比赛数、即将进行的比赛、算法数量、总体准确率
- 📅 **即将进行的比赛**：展示未来比赛及其多个算法的预测结果
- ✅ **已完成的比赛**：展示历史比赛结果和预测准确情况
- 🤖 **算法排行榜**：展示各算法的准确率、预测数、正确数统计
- 🎯 **预测详情**：点击比赛或算法可查看详细预测历史

### 管理后台
- ⚙️ **系统配置**：
  - 预测周期（小时）
  - 最近预测时间
  - 世界杯年份
- 🤖 **算法管理**：
  - 添加/编辑/删除预测算法
  - 启用/禁用算法状态
- ⚽ **比赛管理**：
  - 添加/编辑/删除比赛
  - 设置比赛时间、比分、状态
- 🎯 **预测管理**：
  - 添加预测结果
  - 评估预测准确性
  - 按比赛筛选预测

## 技术栈

- **后端**：Python Flask
- **数据库**：SQLite
- **前端**：HTML/CSS/JavaScript（原生，无框架）
- **样式**：现代玻璃态设计（Glassmorphism）

## 访问地址

系统已部署在端口 **16015**：

- **主页**：http://192.168.0.101:16015/
- **管理后台**：http://192.168.0.101:16015/admin

## 快速启动

```bash
# 进入项目目录
cd /home/openclaw/.openclaw/workspace-hz4th_coder/works/worldcup-predictor

# 启动服务
/home/hz1/miniconda3/envs/openclaw/bin/python backend/app.py
```

## API接口

### 比赛
- `GET /api/matches` - 获取所有比赛
- `GET /api/matches?status=upcoming` - 获取即将进行的比赛
- `GET /api/matches?status=finished` - 获取已完成的比赛
- `GET /api/matches/{id}` - 获取单场比赛详情
- `POST /api/matches` - 添加比赛
- `PUT /api/matches/{id}` - 更新比赛
- `DELETE /api/matches/{id}` - 删除比赛

### 算法
- `GET /api/algorithms` - 获取所有算法
- `GET /api/algorithms/{id}` - 获取单个算法详情（含预测历史）
- `POST /api/algorithms` - 添加算法
- `PUT /api/algorithms/{id}` - 更新算法
- `DELETE /api/algorithms/{id}` - 删除算法

### 预测
- `POST /api/predictions` - 添加预测
- `POST /api/predictions/evaluate` - 评估已完成比赛的预测结果

### 配置与统计
- `GET /api/config` - 获取系统配置
- `POST /api/config` - 更新系统配置
- `GET /api/stats/overview` - 获取总体统计

## 数据库结构

### algorithms（算法表）
- id, name, description, accuracy, total_predictions, correct_predictions, is_active

### matches（比赛表）
- id, match_code, home_team, away_team, match_time, home_score, away_score, status, round_name

### predictions（预测表）
- id, match_id, algorithm_id, predicted_home_score, predicted_away_score, predicted_winner, confidence, is_correct

### system_config（配置表）
- config_key, config_value, updated_at

## 示例数据

系统已预置示例数据：
- 4个预测算法（AI预测模型、专家预测系统、情绪分析模型、历史数据模型）
- 5场比赛（决赛、半决赛、8强、小组赛）
- 10条预测记录

## 文件结构

```
worldcup-predictor/
├── backend/
│   ├── app.py          # Flask后端应用
│   ├── requirements.txt # Python依赖
│   └── worldcup.db     # SQLite数据库
├── frontend/
│   ├── index.html      # 主页
│   ├── admin.html      # 管理后台
│   ├── css/
│   │   └── style.css   # 样式文件
│   └── js/
│       ├── app.js      # 主页逻辑
│       └── admin.js    # 管理后台逻辑
├── start.sh            # 启动脚本
└── README.md           # 说明文档
```

## 注意事项

- 当前使用Flask开发服务器，适合演示和测试
- 生产环境建议使用nginx + gunicorn部署
- 数据库文件位于 `backend/worldcup.db`，可直接备份
- 支持跨域访问（CORS已启用）

---

开发时间：2026-06-28
开发者：黄庄4号程序员