LifePlay-Revival/Docs/Migration/etat/REL/MAPDL1/MAPDL1-P1-IMPL.md

Fiche MAPDL1-P1-IMPL — Niveau N3 — Modèle prévu opus medium | utilisé claude-opus-5-5 — Agent session « Medium · MAPDL1 » ; compilation et DryRun par le sous-agent lp-builder (`MAPDL1-P1-BUILD.md`, `MAPDL1-P1-BUILD-02.md`) — Skills sk-protocol, lp-city, lp-lot, lp-commandlets, lp-paths

# MAPDL1-P1 : commandlet `LPImportLegacyStreetMap`, reprise à l'identique d'une ancienne carte (2026-10-22)

GO de Big Boss (`local_d2580e73`), décision de l'utilisateur citée : « GO pour MAPDL1 avec les valeurs par défaut D7 à D14 : voie (a), commencer par L1, L2 et P1, vague 1 classée par population. »

Jeton UE : attribué par Big Boss à 11:52, rendu à la fin de cette fiche.

## 1. Ce qui a été fait

- **Deux fichiers neufs**, et seulement eux, sous l'instantané `Snapshot.ps1 -Lot MAPDL1` (`Existed=False`, `D:\Game\LifePlay_Backup_5.5\MAPDL1\manifest.csv`) :

  | Fichier | MD5 après | Fins de ligne |
  |---|---|---|
  | `Source/LifePlayEditorTools/LPImportLegacyStreetMapCommandlet.h` | `34874DB2638C26DE378CCAF5E85F297A` | LF |
  | `Source/LifePlayEditorTools/LPImportLegacyStreetMapCommandlet.cpp` | `0678BCCB6C86D9C40D55C11B74742AA0` | LF |

- **Ce que fait le commandlet** :
  - il lit le résumé UE4 (legacy −6 ou −7, non versionné ou version 511 et plus), la table de noms, les imports, puis l'export de classe `StreetMap` ;
  - il recopie **chaque propriété étiquetée** dans la propriété 5.8 du même nom, **par réflexion**. Types pris en charge : booléen, entier, flottant, chaîne, nom, octet ou énumération, `Vector2D` et `Vector` natifs, structures étiquetées, tableaux ;
  - il ne recalcule aucune donnée ;
  - une propriété inconnue ou incompatible est sautée par sa taille et comptée au rapport ;
  - il garde les mêmes protections que `LPImportCityOSM` : écriture seulement sous `_Pilot/` ou `/lpm_city_<v>/StreetMap/<Ville>`, jamais sur un paquet existant, `-DryRun` sans écriture.
- **Aucun fichier de STM1 n'est touché**, ni `LifePlayEditorTools.Build.cs` : `StreetMapRuntime` et `Json` y étaient déjà. MD5 relevés avant l'écriture et relus après, identiques :
  - `LPAssetRegistryHelpers.cpp` `7B44F5FA…` et `.h` `8E3B725A…` ;
  - `LPCityWaterSubsystem.cpp` `CC146CC6…` et `.h` `4A6C6711…` ;
  - `LPCityWaterMask.h` `E5027FD7…` ;
  - `LPBuildCityWaterCommandlet.cpp` `96EC9503…` et `.h` `AEFBBF33…` ;
  - `LPImportCityOSMCommandlet.cpp` `CFFBAAEC…` ;
  - `LifePlayEditorTools.Build.cs` `6487F4B6…`.
- **Correctif après la première compilation** : C4456, la variable `P` masquait une autre variable (`.cpp:188`, traité en erreur ; `MAPDL1-P1-BUILD.md`). Les deux variables ont été renommées `ByteProp` et `EnumProp`. La seconde compilation donne code 0, 0 erreur, 0 avertissement (`MAPDL1-P1-BUILD-02.md`).
- **Référence indépendante** : le script ponctuel `Saved\MAPDL1\lire_streetmap_ue4.py` (MD5 `10D1133BC2BCD1802E3E863E6CE55F5A`) a reçu l'option `--totaux`, un décodage complet et générique.

## 2. Mesuré

Référence Python :

```
python -I -X utf8 Saved\MAPDL1\lire_streetmap_ue4.py <…>\Paris.uasset <…>\Paris.uexp --totaux
TOTAUX routes=6719 points_routes=33916 sens_unique=4477 noeuds=7999 refs_noeuds=18057 batiments=43789
points_batiments=551010 nommes=2082 amenites=1290 hauteurs=296 parcs=273 points_parcs=6067 eaux=0
BORNES (-411527.8, -291203.4) a (417012.0, 308414.8) cm ; soit 8.29 x 6.00 km
code=0
```

DryRun (`MAPDL1-P1-BUILD-02.md`, rapport `D:\Game\LifePlay_Data\Mega-essai\P1-dryrun.md`) :

```
TOTAUX routes=6719 points_routes=33916 sens_unique=4477 noeuds=7999 refs_noeuds=18057 batiments=43789 points_batiments=551010 nommes=2082 amenites=1290 hauteurs=296 parcs=273 points_parcs=6067 eaux=0
BORNES (-411527.8, -291203.4) a (417012.0, 308414.8) cm ; soit 8.29 x 6.00 km
DryRun : aucun asset ecrit
CODE 0
```

Écriture du pilote :

```
& .\Tools\RunCommandlet.ps1 -Lot MAPDL1 -Commandlet LPImportLegacyStreetMap -EtatDir '<…>\etat\REL\MAPDL1' -Args '-Uasset=D:\Game\LifePlay_Data\Mega-essai\MAPDL1-entetes\Paris.uasset -Package=/Game/Heavy/StreetMap/_Pilot/MAPDL1_ParisLegacy -Report=D:\Game\LifePlay_Data\Mega-essai\P1-ecriture.md'
code=0 duree=26s erreurs=0 avertissements=0
proprietes lues jusqu'a l'octet 25005768 ; reste 4 octets apres la fin de liste (attendu : 4)
TOTAUX routes=6719 points_routes=33916 sens_unique=4477 noeuds=7999 refs_noeuds=18057 batiments=43789 points_batiments=551010 nommes=2082 amenites=1290 hauteurs=296 parcs=273 points_parcs=6067 eaux=0
BORNES (-411527.8, -291203.4) a (417012.0, 308414.8) cm ; soit 8.29 x 6.00 km
asset ecrit : /Game/Heavy/StreetMap/_Pilot/MAPDL1_ParisLegacy (…/Content/Heavy/StreetMap/_Pilot/MAPDL1_ParisLegacy.uasset), 29616770 octets
CODE 0
```

Relecture depuis le disque, par un autre outil :

```
& .\Tools\RunCommandlet.ps1 -Lot MAPDL1 -Commandlet LPCheckStreetMap -EtatDir '<…>\etat\REL\MAPDL1' -Args '-Path=/Game/Heavy/StreetMap/_Pilot -CSV=D:\Game\LifePlay_Data\Mega-essai\P1-relecture.csv'
code=0 duree=21s erreurs=0 avertissements=24          (les 24 lignes sont la synthèse de l'outil, écrite au niveau Warning)
Ville;Charge;Routes;Noeuds;Batiments;Eaux;Parcs;BatimentsNommes;AvecAmenity;TypesAmenity
MAPDL1_ParisLegacy;1;6719;7999;43789;0;273;2082;1290;120
Paris;1;22280;25221;110949;0;658;4246;1781;111
```

MD5 du pilote : `5BCB7785B9E5564377D9EE54E7D85A02`. `UeState.ps1 -Kind Editeur` en fin de fiche : `processus=0 editeur=0`, code 0.

## 3. Verdict

- **Les 13 comptes et les bornes sont identiques** entre trois lectures :
  - le lecteur Python, indépendant du moteur ;
  - le commandlet en DryRun et en écriture ;
  - la relecture du paquet écrit par `LPCheckStreetMap`.
- Le paquet se charge, avec 0 propriété inconnue et 0 propriété incompatible.

La voie (a) est **établie** pour Paris : l'ancienne carte est reprise à l'identique en `UStreetMap` 5.8.

**Non mesuré** :
- le maillage `Static/<Ville>` régénéré par `LPBuildCityStatic` et sa comparaison avec l'ancien `Static\Paris.uexp` (lot P2) ;
- un zip d'une autre année (2020 à 2022) ;
- l'aspect en jeu.

La ligne `Paris` du CSV est l'ancien pilote STM1 (`_Pilot/Paris`, OSM de 2026, 11 × 8 km). Elle n'est pas à comparer.

## 4. Écarts

- **Snapshot** : `pwsh -File Snapshot.ps1 -Path a, b` a inscrit une entrée fautive `…Commandlet.h,` (avec la virgule). Les deux fichiers ont ensuite été inscrits un par un. L'entrée fautive est à ignorer au retour arrière : la ligne `Existed=False` d'un chemin inexistant ne retire rien.
- **Résumés de `Build.ps1`** : ils sont dans `Docs\Migration\etat\MAPDL1\`, avec l'avertissement « EtatDir.ps1 : lot 'MAPDL1' hors table », donc **un dossier nouveau à la racine d'`etat\`**, ce qui est contraire à `lp-lot` (« Où écrire »). Je ne l'ai ni déplacé ni corrigé : `Tools\EtatDir.ps1` est un outil partagé avec l'addon. Décision à Big Boss : ajouter `MAPDL1` (projet `REL`) à la table, puis déplacer les deux `.txt`.
- **Commandlets de lecture lancés en plus**, sous le même jeton, pour préparer L4 comme Big Boss l'a demandé : `LPDumpFunction -BP=City`, `-BP=City -Fn=EventGraph -Pins -Exec`, `-BP=CityMenu -Fn=EventGraph -Pins -Exec`. Ils sont en lecture seule. Résultat dans `MAPDL1-L4-CART-01.md`.

## 5. Fichiers

À commiter (ticket du lot ; aucun fichier partagé) :
- A `Source/LifePlayEditorTools/LPImportLegacyStreetMapCommandlet.h`
- A `Source/LifePlayEditorTools/LPImportLegacyStreetMapCommandlet.cpp`
- A `Docs/Migration/etat/REL/MAPDL1/` : `MAPDL1-CART-01.md`, `MAPDL1-SPEC-01.md`, `MAPDL1-SPEC-02.md`, `MAPDL1-SPEC-03.md`, `MAPDL1-L1-CART-02.md`, `MAPDL1-L2-RECH-01.md`, `MAPDL1-P1-IMPL.md`, `MAPDL1-P1-BUILD.md`, `MAPDL1-P1-BUILD-02.md`, `MAPDL1-L4-CART-01.md`, `MAPDL1-JOURNAL-BROUILLON.md`

Hors git :
- `Content/Heavy/StreetMap/_Pilot/MAPDL1_ParisLegacy.uasset` (pilote) ;
- `Saved/MAPDL1/lire_streetmap_ue4.py` ;
- `D:\Game\LifePlay_Data\Mega-essai\` (extraits et rapports) ;
- résumés `.txt` dans `etat\REL\MAPDL1\` et `etat\MAPDL1\`, non suivis par git.

Retour arrière : `.\Tools\Restore.ps1 -Lot MAPDL1 -WhatIf`, puis sans `-WhatIf`. Il retire les deux sources et le pilote.

## 6. Compte rendu

- **Résultat** : réussi. Le commandlet est compilé, le pilote Paris écrit et relu, avec des comptes identiques à la référence.
- **Tours** : ≈ 22 pour P1 (déclaré ; `FicheStats.py` fait foi).
- **À verser** :
  - `lp-commandlets` § Cartes de villes : ajouter `LPImportLegacyStreetMap` (`-Uasset= [-Uexp=] (-DryRun | -Package=) [-Report=]`, reprise d'une carte « NEW Maps » UE4 cuite) ;
  - `lp-commandlets` : avec `RunCommandlet.ps1`, passer `-Args` par une variable dans la même session pwsh (`$a = '-Uasset=…'; & .\Tools\RunCommandlet.ps1 … -Args $a`). Par `pwsh -File`, une valeur qui commence par `-` est prise pour un paramètre (« Argument manquant pour le paramètre Args ») ;
  - `lp-lot` : `Snapshot.ps1 -Path a, b` par `pwsh -File` inscrit `a,` comme chemin. Un chemin par appel, ou `-Command`.
  - `lp-city` § 7 et `lp-commandlets` § Cartes de villes : **aucun asset de travail ne reste sous `Content\` entre deux sessions**. `DirectoriesToAlwaysCook` couvre tout `/Game`. Un asset de travail sous `_Pilot/`, absent de la release de base, fait échouer la cuisson des packs (« Uncooked … referenced by DLC »), comme ici avec `MAPDL1_ParisLegacy`. Il faut l'écrire sous un chemin exclu de la cuisson, ou le retirer, par déplacement, à la fin du lot.

**Après coup (Big Boss)** : le pilote a été déplacé hors de `Content\`, vers `D:\Game\LifePlay_Backup_5.5\MAPDL1\pilote-hors-content\MAPDL1_ParisLegacy.uasset` (MD5 `5BCB7785…` inchangé). La mention « Hors git : … pilote » du § 5 désigne maintenant ce chemin. Un `Restore.ps1 -Lot MAPDL1` n'a plus de pilote à retirer.
- **Suite** : P2, le pilote du maillage, sur la première ville de la vague 1 (Tokyo) : l'utilisateur télécharge `Tokyo.zip`, puis `LPBuildCityStatic -CompareStreetMap` et la comparaison avec l'ancien `Static`. État : P1 clos, jeton UE rendu.