# Installation — Coaster World v1.101.0

Base : `coaster-world_v1.100.7_2026-08-18.zip`

## 1. Sauvegarde
Effectuer une sauvegarde de la base MySQL avant la mise à jour.

## 2. Remplacer les fichiers
Déployer l'archive complète `coaster-world_v1.101.0_2026-08-18.zip` à la place de la version précédente, en conservant votre `.env` et les données de `storage/`.

## 3. Migration Laravel recommandée
Depuis le dossier du projet :

```bat
php artisan migrate
php artisan optimize:clear
```

La migration crée uniquement la table `visit_validations`. Elle ne supprime aucune donnée existante.

### Alternative SQL manuelle
Si vous ne pouvez pas exécuter les migrations Laravel, utilisez **à la place** :

`coaster_world_v1.101.0.sql`

Ne pas exécuter le SQL manuel après `php artisan migrate`.

## 4. HTTPS requis pour les utilisateurs
La géolocalisation du navigateur doit être utilisée dans un contexte sécurisé. Le site public doit donc être servi en HTTPS.

Sur l'environnement local HTTP, utilisez le déverrouillage de test administrateur pour tester le classeur sans falsifier de ride GPS, ou activez HTTPS dans Laragon pour tester le vrai flux GPS.

## 5. Test administrateur d'une carte
1. Ouvrir **Admin → Cartes**.
2. Modifier la carte à tester.
3. Dans **Déverrouillage de test**, cliquer sur **Déverrouiller pour mon compte**.
4. Ouvrir **Mon classeur** : la carte est accessible sur le compte admin.
5. Pour refaire un test verrouillé, utiliser **Reverrouiller la carte test**.

Le bouton de reverrouillage ne supprime jamais une carte obtenue normalement par une validation GPS.
Si une carte de test est ensuite obtenue réellement par GPS, elle est automatiquement convertie en acquisition réelle.

## 6. Fonctionnement GPS utilisateur
- Démarrer une visite demande la position GPS et confirme la présence dans le parc.
- Valider un coaster/une attraction redemande une position GPS fraîche.
- Le serveur contrôle la précision et la distance par rapport au parc et à l'attraction.
- Les coordonnées brutes ne sont pas stockées dans `visit_validations` ni dans les nouvelles `ride_validations` GPS de ce flux.
- Les anciennes cartes déjà débloquées sont conservées ; aucune donnée utilisateur n'est supprimée par cette mise à jour.