132 lines
4.0 KiB
Markdown
132 lines
4.0 KiB
Markdown
# 世界杯预测系统
|
||
|
||
一个展示世界杯比赛预测结果的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号程序员 |