# Allianties

Webspel naar de basisregels van *Tank Turn Tactics* (Halfbrick). Gebouwd voor
[projects.timfalken.com](https://projects.timfalken.com/allianties/). De
spelnaam blijft in elke taal **Allianties**.

Live (na de eerste deploy): https://projects.timfalken.com/allianties/

## Spelen

1. Log in met je account op [auth.timfalken.com](https://auth.timfalken.com).
2. Maak een lobby of voer een uitnodigingscode in. Deel de link of de code.
3. De host start het spel zodra er minstens twee spelers zijn. Het spel blijft
   daarna lopen, dagenlang, tot er één overlevende is.
4. Elke tank begint met 3 levens, bereik 2 (Chebyshev, ook diagonaal) en 1
   actiepunt. Elke dag op het ingestelde tijdstip (standaard 00:00, in de lokale tijd van de host) krijgt elke levende
   speler 1 actiepunt erbij.
5. Voor 1 actiepunt kun je: één vakje bewegen (8 richtingen, niet op een bezet
   of onbegaanbaar vakje), een speler binnen bereik beschieten (−1 leven), je
   bereik met 1 vergroten, of actiepunten geven aan een speler binnen bereik.
6. Bij 0 levens ben je uitgeschakeld. De laatste overlevende wint. Overgeven
   kan via het instellingenmenu, na een duidelijke bevestiging.

Optionele regels (in de lobby, vóór de start):

- **Jury** (standaard aan): dode spelers stemmen dagelijks op één levende
  speler. Wie de meeste stemmen heeft, krijgt +1 actiepunt bij de volgende
  uitdeling. Stemmen zijn geheim en tot de uitdeling te wijzigen.
- **Krimpend speelveld** (standaard uit): na een instelbaar aantal dagen
  (standaard 7) wordt de buitenste ring onbegaanbaar. Spelers die erop staan
  verliezen een leven en worden naar binnen geduwd.
- **Gedwongen staakt-het-vuren** (standaard uit): in door de host gekozen
  uren mag niemand schieten. De periodes zijn te tekenen
  op een 24-uursklok.
- **Actiepunten plunderen bij een kill** (standaard uit): alleen bij een
  uitschakelend schot krijgt de schutter de resterende AP van het doelwit.
- **Dagelijks AP-tijdstip**: per lobby instelbaar,
  standaard 00:00. Jury en krimp vallen samen met dit tijdstip.
- **Tijdzones**: iedere speler ziet en voert alle tijden in zijn eigen lokale
  tijd in (browserzone). De host definieert tijden in zijn zone; de server
  bewaart ze met die IANA-zone en rekent exact, ook rond zomertijd.
- **Alleen de host** mag de spelregels wijzigen (server: 403).
- **Bordgrootte**: de host kiest de zijde van het vierkante bord (6–24).
  De suggestie is `max(6 + ceil(n / 2), n + 1)` (2 spelers: 7×7; 6: 9×9;
  10: 11×11; 14: 15×15) en wordt bijgewerkt als er mensen joinen, tenzij
  de host zelf een maat instelt. `ceil` rondt halven naar boven af.
- **Zichtbaarheid** (standaard alles openbaar): de host bepaalt wie schoten,
  giften, actiepuntentotalen, bereik en levens ziet. Voor levens en
  actiepunten is er een tussenoptie *Binnen bereik*: je ziet die gegevens
  van een speler die in **jouw** schootsveld staat. Dat verschilt van de
  bereik-optie *Bekend bij spelers binnen bereik*, die kijkt naar **diens**
  bereik. De server filtert de staat en de tijdlijn per kijker. Eigen
  gegevens en verplaatsingen blijven altijd zichtbaar.

Events staan niet in een tekstlog: je ziet ze alleen in de video-weergave
van de tijdlijn (groene pijl bij een gift, rode pijl bij een schot, een
schuivende pion bij een zet, een pulsering bij een bereik-upgrade). Klik
of tik ergens op de balk om naar het dichtstbijzijnde event te springen;
slepen scrubt, ook met touch.

De aannames bij deze regels staan in [`docs/ASSUMPTIONS.md`](docs/ASSUMPTIONS.md).

## Lokaal bouwen en draaien

```bash
# Tests
node --test test/*.test.js
php server/tests/run.php

# Bundel (src/ → build/game.js) en kopieer de PHP-API naar build/
./src/build.sh
# of: npm run build

# Met API (lokale testers: auth.php?test=1 tot ?test=8)
php -S 127.0.0.1:8080 -t build build/router.php
# spel: http://127.0.0.1:8080/
```

De testlogins (`auth.php?test=1` … `?test=8`) werken alleen op localhost en
zijn op de live site uitgeschakeld.
Met `&avatar=none` (geen profielplaatje) of `&avatar=broken` (plaatje-URL
die 404 geeft) test je spelers zonder plaatje.

Browsertests (Playwright, met de lokale server):

```bash
python3 test/ui-playwright.py                 # hele flow, desktop + mobiel
python3 test/lobby-interaction-playwright.py  # klok slepen, focus, host-only, tijdzones
python3 test/avatar-layout-playwright.py      # speelstukken zonder plaatje, geen scroll op mobiel
```

## Architectuur

| Pad | Rol |
| --- | --- |
| `src/i18n.js` | Vertalingen en vlaggenkiezer (Engels als standaard, 10 talen) |
| `src/rules.js` | Client-spiegel van raster, Chebyshev, staakt-het-vuren (incl. zomertijd) |
| `src/api.js` | API-client, CSRF, lichte `sync`-poll |
| `src/avatar.js` | Speelstukken: kleurcirkel met initialen, plaatje erbovenop (robuust bij laadfouten) |
| `src/main.js` | Menu, lobby, bord, tijdlijn, klok-editor, countdowns |
| `server/lib/Engine.php` | Authoritatieve regelmotor: zetten, jury, krimp, staakt-het-vuren, einde |
| `server/lib/Store.php` | SQLite, `BEGIN IMMEDIATE`, JSON-game, profielen |
| `server/lib/i18n.json` | Gedeelde catalogus (JS en PHP) |
| `docs/ASSUMPTIONS.md` | Alle aannames waar de specificatie ruimte liet |
| `src/build.sh` | Bundelt bronnen naar `build/` |
| `ci/` | FTP-deploy **zonder** `--delete`. Expandeert `$timftproot`. Raakt `favicon.ico` en `data/` niet aan. |

De server is leidend bij elke actie. De client toont legale zetten die de
server meestuurt en speelt de tijdlijn af uit het eventlog.

## Vertalingen

Standaardtaal is Engels. Rechtsonder kies je een van tien talen via de vlag
(Verenigd Koninkrijk, Nederland, Duitsland, Frankrijk, Japan, China, Korea,
Polen, Rusland, Spanje). De keuze staat in `localStorage` en, als je
ingelogd bent, in je profiel, en wordt bij inloggen weer toegepast. De
spelnaam blijft altijd **Allianties**.
