# 掼蛋争霸

**Repository Path**: numen06/egg-laying-competition

## Basic Information

- **Project Name**: 掼蛋争霸
- **Description**: 掼蛋游戏的记分牌，同时积累积分
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-10-02
- **Last Updated**: 2025-12-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 对十争霸赛记分牌(掼蛋争霸)

这是一个用于管理"掼蛋争霸"比赛的全栈Web应用程序。该系统提供了实时比分跟踪、队员管理、比赛历史记录等功能。

## 项目概述

对十争霸赛是一种特殊的竞技游戏，本系统提供了一个完整的解决方案来管理比赛流程，包括：

- 实时比分跟踪
- 计时器控制
- 队员管理
- 比赛记录保存和查看
- 积分计算
- 历史数据分析

##界面展示
![界面预览](./1.png)

## 技术架构

### 前端
- HTML5/CSS3/Tailwind CSS
- JavaScript (ES6+)
- 模块化设计

### 后端
- Python Flask框架
- RESTful API
- JSON数据存储

### 部署
- Docker容器化部署
- docker-compose编排

## 功能特性

### 核心功能
1. **实时比分跟踪**
   - 支持红蓝两队比分实时更新
   - 圈数统计（每队最多可进行多圈比赛）
   - 主战方标识

2. **计时器控制**
   - 开始/暂停/结束比赛
   - 状态保存与恢复

3. **队员管理**
   - 队员信息维护（增删改查）
   - 队员分配到红蓝两队
   - 队员战绩统计

4. **比赛记录**
   - 自动保存已完成的比赛
   - 历史记录查看和筛选
   - 比赛积分自动计算

5. **积分系统**
   - 根据比赛结果自动计算积分
   - 积分规则：获胜方积分 = (获胜方圈数 - 失败方圈数) × 16 + (获胜方分数 - 失败方分数)
   - 特殊情况处理：当(获胜方圈数 - 失败方圈数) × 16小于0的时候则，获胜方积分 = 获胜方分数 - 失败方分数

### UI特色
- 响应式设计，支持多种屏幕尺寸
- 霓虹风格界面，符合电竞主题
- 主战方高亮显示（金色边框和动画效果）
- 实时数据可视化

## 目录结构

```
.
├── app
│   ├── backend             # 后端代码
│   │   ├── data            # 数据存储目录
│   │   │   ├── matches.json  # 比赛记录
│   │   │   └── players.json  # 队员信息
│   │   ├── templates       # HTML模板
│   │   │   └── player.html # 队员详情页
│   │   └── app.py          # Flask应用入口
│   └── frontend            # 前端代码
│       ├── assets          # 静态资源
│       ├── js              # JavaScript代码
│       ├── index.html      # 主页面
│       └── ...
├── Dockerfile              # Docker镜像配置
├── docker-compose.yml      # Docker编排配置
└── requirements.txt        # Python依赖
```

## 快速开始

### 使用Docker部署（推荐）

```bash
# 构建并启动服务
docker-compose up -d

# 访问应用
# 浏览器打开 http://localhost:8000

#快速部署
docker run -d --name=duishi -p 8000:8000 \
-v /opt/guandan:/app/backend/data \
-e FLASK_ENV=production \
-e APP_USERNAME=admin \
-e APP_PASSWORD=admin \
registry.cn-shanghai.aliyuncs.com/numen/egg-laying-competition
```

### 本地开发环境

1. 安装依赖：
```bash
pip install -r app/backend/requirements.txt
```

2. 运行应用：
```bash
python app/backend/app.py
```

3. 访问应用：
   浏览器打开 http://localhost:8000

### 数据持久化
通过挂载卷将`app/backend/data`目录映射到宿主机，确保数据持久化存储。

## 开发指南

### 前端开发
前端代码位于[app/frontend](app/frontend)目录，主要技术栈为原生JavaScript和Tailwind CSS。

### 后端开发
后端代码位于[app/backend](app/backend)目录，使用Flask框架构建RESTful API。

## 注意事项

1. 系统会在比赛过程中自动保存状态，防止数据丢失
2. 比赛结束后会自动计算积分并保存记录
3. 队员信息变更不会影响已完成的历史记录
4. 主战方标识会根据比分变动自动切换