LifePlay-Revival/Docs/Migration/etat/REL/KEY2/KEY2-SPEC-02.md

KEY2-SPEC-02 : regroupement du menu Clavier par fonctionnalité (étude)

Fiche KEY2-SPEC-02 — Niveau N3 — Modèle prévu opus (Medium) | utilisé Opus 5.5 — Session « Medium · KEY2 » — Skills : sk-protocol, lp-doc. Date : 2026-10-20. Ordre de Big Boss local_104ff22d, après COMMUN-18.14 (PASS). Demande de l'utilisateur, citée : « 14 ok mais il faudrait regroupé les touche par fonctionalité ». Étude seule : aucun code, aucune copie UE. Fichier lu : Source/LifePlay/LPKeyboardSubsystem.cpp (MD5 9d450aaf) et Config/DefaultInput.ini.

0. Décision de l'utilisateur (2026-10-20, citée par Big Boss)

« regroupement des touches ok ». Big Boss l'applique avec les recommandations de cette fiche :

1. les 9 sections du § 2, dans l'ordre et avec les noms proposés ;
2. option (A) : les flèches à deux places, même liaison ;
3. Pause dans Time, TestScenes dans System ;
4. RotateCamera en Camera seulement, signalé dans le libellé d'ActionPanel.

Réalisé par KEY2-IMPL-02 (affichage seul, LPKeyboardSubsystem.cpp, instantané KEY2-IMPL3) : MD5 9d450aaf → 0eb6a592 ; +63 / −62 ; CRLF gardé (1491 / 1491). Rien n'est changé dans DefaultInput.ini, dans LPKeyboard.ini ni dans les noms internes ; aucune migration. Compilation en attente du jeton UE.

1. État actuel (établi)

GroupFor (LPKeyboardSubsystem.cpp:207-262) range chaque action ou axe dans une section (Order) et, pour la section Scene, dans un bloc (Sub). Le tri se fait par section, puis bloc, puis libellé (:489-505), et le dessin par titre de section, puis sous-titre de bloc (:508-535).

Ordre	Section affichée	Contenu
0	Movement	MoveForward, MoveRight
2	Interaction	Interact, SwapRoles
3	Menus	MainMenu, CharacterMenu, Inventory, Journal, ContactsMenu, CityMenu, StatMenu, ModuleMenu, SearchBarToggle, Pause
4	Favorites	Favorite0 à Favorite9
5	Time	SpeedUp, SpeedDown
6	World	NextBuilding, PreviousBuilding
7	Save	QuickSave, Quickload
8	Scene › Camera	ScrollDownUp, RotateCamera, SwitchCamera, CameraHeight
8	Scene › Characters	option « Move couple with », ManualAnimating, l'axe de rotation, CoupleMoveY, LeftRight, DownUp
8	Scene › Actions	ActionPanel
8	Scene › Other	TestScenes, Recommended

Défauts pour le joueur :

• les commandes générales de la caméra (SwitchCamera, RotateCamera, zoom) sont rangées sous « Scene », alors qu'elles servent partout ;
• Pause est dans Menus et non dans Time ;
• les flèches n'apparaissent que dans le bloc du couple, alors qu'elles déplacent aussi la vue de dessus hors scène ;
• Interact (Interaction) est séparé d'ActionPanel (Scene › Actions).

Ne sont pas affichés, et ne le seront pas : ActionX / ActionY et CursorX / CursorY (axes de la souris, refusés par IsRemappable, :75-78).

2. Regroupement proposé (ordre d'affichage)

Libellés en anglais, comme le reste du menu ; la traduction est donnée entre parenthèses.

Ordre	Section (libellé)	Actions et axes	Remarque
1	Movement (Déplacement)	MoveForward, MoveRight	inchangé
2	Camera (Caméra)	SwitchCamera, RotateCamera, ScrollDownUp (zoom), CameraHeight	sort de Scene ; CameraHeight n'agit qu'en scène : libellé « Camera Height Up / Down (scene) »
3	Map & World (Carte et monde)	LeftRight, DownUp (vue de dessus), NextBuilding, PreviousBuilding	les flèches y sont libellées « Map Right / Left / Forward / Back »
4	Couple (scene) (Couple en scène)	option « Move couple with », CoupleMoveY (Up / Down), DownUp, LeftRight (couple), ManualAnimating, l'axe de rotation existant	les flèches y sont libellées « Couple Forward / Back / Right / Left »
5	Actions & Interaction (Actions et interaction)	Interact, ActionPanel, SwapRoles, Recommended	regroupe Interact et ActionPanel
6	Menus	MainMenu, CharacterMenu, Inventory, Journal, ContactsMenu, CityMenu, StatMenu, ModuleMenu, SearchBarToggle	Pause en sort
7	Time (Temps)	Pause, SpeedUp, SpeedDown	Pause y entre
8	Favorites (Favoris)	Favorite0 à Favorite9	inchangé
9	System (Système)	QuickSave, Quickload, TestScenes	Save devient System ; TestScenes y entre (zone de commande interne, KEY1-CART-01 § 12.3)

Plus de sous-titres de bloc : chaque section est courte (2 à 10 entrées).

3. Actions qui appartiennent à deux groupes

Action ou axe	Groupes	Raison
LeftRight, DownUp (flèches)	Map & World, Couple (scene)	vue de dessus hors scène, couple en scène (CAM2-SPEC-02 § 7)
ScrollDownUp (molette)	Camera, Couple (scene) ?	zoom hors scène ; en scène, rôle à confirmer (KEY2-DIAG-02 § 3.4, et point b de la relecture CAM2-IMPL-03) : à classer en Camera seulement tant que ce n'est pas établi
RotateCamera (Alt, clic du milieu)	Camera ; Actions (en scène)	un appui bref en scène bascule aussi le panneau d'action (LPCameraModeSubsystem.cpp, TickPanelClick). Proposé : Camera seulement, avec la mention dans le libellé d'ActionPanel (« Action Panel (also Alt / middle click) »)
ManualAnimating (Ctrl, clic droit)	Couple (scene)	Ctrl sert aussi de modificateur aux menus (Ctrl+C, Ctrl+E…) : rien à dupliquer, c'est la touche seule

Affichage d'une action à deux groupes, à choisir par l'utilisateur :

• (A) Deux places, recommandé. La même liaison apparaît dans les deux sections, avec le libellé de la section (« Map … » / « Couple … »). Changer la touche dans l'une la change dans l'autre, car c'est la même liaison : le menu se redessine depuis les réglages (Rebuild, RefreshMenu). Le joueur trouve la touche là où il la cherche.
• (B) Une seule place. Section principale Couple (scene), avec un libellé à double sens comme aujourd'hui (« Forward (map view / couple) »). C'est plus court, mais on ne la trouve pas dans Map & World.

4. Changements dans LPKeyboardSubsystem.cpp (prévision, aucun autre fichier)

1. GroupFor (:208-262) : nouvelle table de 9 sections, conforme au § 2. Les constantes KbSceneOrder et KbCharactersSub (:48-49) deviennent KbCoupleOrder ; les sous-titres de bloc (Sub, SubTitle) sont retirés.
2. Option (A) seulement :
   • GroupFor rend une liste de sections (TArray<FBindGroup>, deux entrées pour LeftRight et DownUp) ;
   • la construction de Binds (:453-488) ajoute une ligne par section ;
   • FBindRow reçoit l'ordre de section pour le tri et le dessin (:489-535) ;
   • AxisLabel (:163-196) prend la section pour choisir « Map … » ou « Couple … ».
3. L'option « Move couple with » s'accroche au début de la section Couple (scene), au lieu du bloc Characters (:533-535).
4. Libellés : « Camera Height Up / Down (scene) » ; « Action Panel (also Alt / middle click) » ; flèches selon (A) ou (B).
5. Aucun changement de DefaultInput.ini, de LPKeyboard.ini, de nom interne ni de migration : le regroupement ne touche que l'affichage.
6. Contenu adulte (doc 27) : aucun libellé nouveau. L'axe de rotation garde « Rotation + / − ».

5. Coût estimé

Étape	Option (B)	Option (A)
IMPL (lp-impl ou la session, hors copie UE, sous instantané)	environ 40 lignes changées, 1 fichier	environ 90 lignes changées, 1 fichier
Build (jeton UE) et VAL statique	1 build éditeur + Development, environ 5 min	idem
Essai en jeu	une capture du menu Clavier : ordre des 9 sections ; Change sur une flèche	idem, plus : changer une flèche dans Map & World la change dans Couple (scene)
Risque	faible (affichage seul)	faible à moyen (tri et dessin avec lignes doublées ; Remove d'une ligne doublée retire la liaison des deux sections, ce qui est voulu)

6. Questions pour l'utilisateur (par Big Boss)

1. L'ordre et les noms des 9 sections du § 2 conviennent-ils ?
2. Une action à deux groupes (flèches) : (A) deux places, recommandé, ou (B) une seule place ?
3. Pause dans Time, et TestScenes dans System : d'accord ?
4. RotateCamera (Alt, clic du milieu) : en Camera seulement, avec la mention dans le libellé d'ActionPanel ?

Fichiers écrits : ce livrable. À commiter : A Docs/Migration/etat/REL/KEY2/KEY2-SPEC-02.md. Aucun git qui écrit.