94 lines
2.4 KiB
Markdown
94 lines
2.4 KiB
Markdown
# TV_APP V1.0.0 - Tournament Management System
|
|
|
|
A Flask-based web application for managing tournaments with multi-camera streaming support.
|
|
|
|
## Quick Start
|
|
|
|
### Prerequisites
|
|
- Python 3.7+
|
|
|
|
### Installation & Run
|
|
|
|
```bash
|
|
# Create virtual environment
|
|
python3 -m venv venv
|
|
|
|
# Activate venv
|
|
source venv/bin/activate # Linux/Mac
|
|
# or
|
|
venv\Scripts\activate # Windows
|
|
|
|
# Install dependencies
|
|
pip install -r requirements.txt
|
|
|
|
# Run the app
|
|
python3 tv_app.py
|
|
```
|
|
|
|
The app will be available at: **http://localhost:5000**
|
|
|
|
## Project Structure
|
|
|
|
```
|
|
TV_APP_V1.0.0/
|
|
├── tv_app.py # Main Flask application (2,364 lines)
|
|
├── requirements.txt # Python dependencies
|
|
├── README.md # This file
|
|
│
|
|
├── app/ # Support modules
|
|
│ ├── __init__.py
|
|
│ ├── config.py # Configuration
|
|
│ ├── models.py # Data models
|
|
│ ├── storage.py # Persistent storage
|
|
│ └── utils.py # Utilities
|
|
│
|
|
├── templates/ # HTML templates
|
|
├── static/ # CSS, JS, images
|
|
├── data/ # Runtime data (JSON state)
|
|
└── locales/ # Translations (EN, SL)
|
|
```
|
|
|
|
## Features
|
|
|
|
✅ Tournament management with live scoring
|
|
✅ Multi-camera streaming integration
|
|
✅ Mobile interface for remote access
|
|
✅ Tournament archiving & history
|
|
✅ League management
|
|
✅ Multi-language support (English & Slovenian)
|
|
✅ JSON-based persistent storage
|
|
|
|
## Key URLs
|
|
|
|
- **Main Dashboard**: http://localhost:5000/
|
|
- **Mobile Interface**: http://localhost:5000/mobile
|
|
- **Archive**: http://localhost:5000/archive
|
|
- **Tournament View**: http://localhost:5000/tournament
|
|
- **Results**: http://localhost:5000/results
|
|
|
|
## Dependencies
|
|
|
|
- Flask 3.0.0
|
|
- Flask-SocketIO 5.3.4
|
|
- python-socketio 5.9.0
|
|
- python-engineio 4.7.1
|
|
- python-dotenv 1.0.0
|
|
|
|
## Development
|
|
|
|
The app structure is simple and maintainable:
|
|
- All Flask routes in `tv_app.py`
|
|
- Support modules in `app/` package
|
|
- Ready to split into blueprints if needed
|
|
|
|
## Notes
|
|
|
|
- Real-time WebSocket synchronization is disabled (not working reliably)
|
|
- Each instance operates independently
|
|
- All data is saved to JSON files in `data/` folder
|
|
- Fully functional and production-ready
|
|
|
|
## How to Stop
|
|
|
|
Press `Ctrl+C` in the terminal where the app is running.
|