65 lines
3.5 KiB
Markdown
65 lines
3.5 KiB
Markdown
# Carte des élus américains
|
|
|
|
Carte interactive des États-Unis : sénateurs et représentants fédéraux, gouverneur et chambres législatives de chaque État, avec un bouton qui relit Wikipédia (en anglais) pour rafraîchir les données. Python 3.12 seul, sans dépendance.
|
|
|
|
## Lancer
|
|
|
|
```sh
|
|
docker compose up -d --build
|
|
```
|
|
|
|
Puis ouvrir <http://localhost:8080>. Au premier démarrage, le dossier `./data` est rempli avec les données de départ (lues sur Wikipédia le 13 novembre 2026).
|
|
|
|
Le port n'est ouvert que sur la machine locale (`127.0.0.1:8080`). Pour l'ouvrir au réseau, remplacer la ligne `ports` de `docker-compose.yml` par `"8080:8080"`.
|
|
|
|
Arrêter : `docker compose down` (les données restent dans `./data`).
|
|
|
|
## Mettre à jour les données
|
|
|
|
- **Depuis la page** : bouton « Update from Wikipedia ». La progression s'affiche, puis la carte se recharge. Les avertissements sont listés sous le bouton.
|
|
- **En ligne de commande** :
|
|
|
|
```sh
|
|
docker compose run --rm app python update.py
|
|
```
|
|
|
|
Une seule mise à jour à la fois (le bouton refuse une seconde demande, la ligne de commande aussi). Une mise à jour fait une dizaine de requêtes à Wikipédia et dure moins d'une minute.
|
|
|
|
## Choisir le mode
|
|
|
|
`UPDATE_MODE` vaut `auto` (par défaut), `election` ou `current` :
|
|
|
|
- `election` : résultats de la dernière élection (pages « 2026 United States … elections »), soit les élus qui siégeront à partir de janvier.
|
|
- `current` : élus en fonction aujourd'hui (listes « List of current … » et article de chaque chambre).
|
|
- `auto` : `election` entre le jour de l'élection (novembre des années paires) et le 3 janvier suivant, `current` le reste du temps.
|
|
|
|
Forcer le mode :
|
|
|
|
```sh
|
|
# ligne de commande
|
|
docker compose run --rm -e UPDATE_MODE=current app python update.py
|
|
|
|
# bouton de la page : mettre UPDATE_MODE=current dans un fichier .env à côté de docker-compose.yml, puis
|
|
docker compose up -d
|
|
```
|
|
|
|
## Où sont les données
|
|
|
|
Dans `./data` (monté dans le conteneur sur `/data`) :
|
|
|
|
- `senate.json`, `house.json`, `governors.json`, `legislatures.json` : une catégorie par fichier, avec la date de lecture, le mode et les pages Wikipédia utilisées ;
|
|
- `meta.json` : le dernier passage (date, mode, avertissements).
|
|
|
|
Chaque catégorie est vérifiée avant de remplacer l'ancien fichier (50 États, 100 sénateurs, 435 représentants selon la répartition par État, 50 gouverneurs, 99 chambres dont les sièges font le bon total). Si la lecture ou la vérification échoue, l'ancienne version est gardée et un avertissement l'explique. Les fichiers sont écrits d'un coup (fichier temporaire puis renommage).
|
|
|
|
Les pouvoirs des gouverneurs ne sont pas lus sur Wikipédia : ils viennent des données de départ (`app/seed/governors.json`).
|
|
|
|
Pour revenir aux données de départ : `docker compose down`, vider `./data`, puis `docker compose up -d`.
|
|
|
|
## Limites connues
|
|
|
|
- La lecture dépend de la mise en page des articles Wikipédia : si un tableau change de forme, la catégorie concernée garde ses anciennes données et un avertissement le signale.
|
|
- En mode `election`, une chambre dont Wikipédia n'a pas encore publié les résultats garde les chiffres déjà connus pour la même élection ; sinon tous ses sièges sont comptés « Not yet called ».
|
|
- Une course non tranchée n'affiche pas de gagnant, seulement les deux principaux candidats.
|
|
- Les présidents de chambre affichés sont ceux en fonction ; la fin de leur mandat est déduite de la prochaine élection de la chambre (indiqué dans la note).
|