# 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.