warchron_app/README.md

# Wargame_campaign_app

A simple local app to manage players and their scores throughout several organised games of a tabletop wargame.

## Features

### Main logic

Manage a list of players to sign them up to be selectable for war(s) and campaign(s).
A year "war" contains several "campaign" events which contain several "battle" games organised in successive rounds.
Battle results determine campaign score which determines the war score. Wars are independent.

### Design notes

Players are global identities
Influence tokens are scoped to a war
Campaign order enables historical tie-breakers
Effects are generic → future-proof

## Installation

### Requirements

- Python >= 3.12
- pip

### Setup

```bash
git clone <your-forge-address>/Wargame_campaign_app.git
cd Wargame_campaign_app
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -r requirements.txt
```

### Run

`python main.py`