Brief développeur — Power App Simulation Négo

1. Contrat — PBI lit, l'app écrit

Une phrase. Power BI est le seed lecteur (Simu_Scenario + Simu_Overlay, mesures COALESCE). L'humain crée le scénario, saisit la strate, valide. Dataverse mémorise header + overlay. Après refresh, les pages Simu suivent l'overlay persisté. Le ledger cr568_negotiation_current ne bouge que si le scénario est promu.

Chaîne à implémenter, dans cet ordre :

• Page Simulation Négo (Power BI) — slicers enseigne / nom / période DV, clic ligne EAN.
• Canvas Simu (nouvelle app) — lecture de PowerBIIntegration.Data, Patch sur clé alternative.
• Dataverse — header scénario + lignes overlay. Pas une colonne de plus sur cr568_negotiation_current tant que non promu (CDC S24).
• Flux + dataset — On Create/Update puis refresh 612ef347-d29a-40a4-9073-11a699847590.
• Retour Power BI — import header/overlay à la place du DATATABLE / ROW seed ; COALESCE inchangé.
• Promote (statut validé seulement) — écriture ledger + promu_nego = oui + même hop refresh.

Chaîne CDC (inchangée). Seule la deuxième boîte devient écrivain.

Rôles figés côté Power BI (déjà livrés — ne pas les reconstruire)

Le rapport ne persiste rien. Il affiche un what-if sur deux seeds figés (CARREFOUR HM). L'app est le seul endroit où un humain crée, clone, saisit et promeut.

• Lecteur (reste DAX). Porte ScId = SELECTEDVALUE(Simu_Scenario[scenario_id]). Overlay lu seulement si ScId n'est pas blank. Simu DV : overlay dv_cible sinon Dim_Strates sinon DVvaleur_LE. Valo Volume / CA / NR = maquette slide 5 (pas CAMH×52, S19).
• Actuel après bascule. Les mêmes mesures COALESCE, mais Simu_Scenario / Simu_Overlay deviennent l'import Dataverse. Tant que le flux ne pousse pas les tables vers le modèle, un Patch réussi ne bougera pas les pages après refresh.

Pattern Saisie : visuel 0aebe2b2f8c11bb0fa9f, table cr568_negotiation_current2. Pages Simu : Création e4a8c2b17f6d4095a5c3, Tableau f5b9d3c28a7e5106b6d4, Compare a6c0e4d39b8f6217c7e5, Waterfall b7d1f5e40c907328d8f6, Histo c8e2f6a51d018439e9a7, Mouvement d9f3a7b62e12954af0b8.

2. Dataverse — header scénario

CDC (écriture, pas encore dans le PBIX) : persister header + overlay, pas dans cr568_negotiation_current tant que non promu. Clone, saisie strate/dates/tx, promote validé → ledger négo + refresh. Le canvas CDC et S20 parlent de « tables scénario + overlay Dataverse / Excel » — aucun nom logique cr568_simu_* n'existe dans le CDC. Convention PowerRange (même publisher DataLift, préfixe cr568_, solution 1.0.0.3, org orgdbdf3046.crm12.dynamics.com) : cr568_simu_scenario et cr568_simu_overlay. Les colonnes contractuelles sont celles du seed PBI, pas des noms inventés.

Table non managée, audit on. Une ligne = un scénario nommé par enseigne / catégorie (CDC S2). Alternate key obligatoire : cr568_ak_simu_scenario sur cr568_scenario_id.

Création : enseigne + PeriodKey (Q1/Q3) + nom + période DV + contour. Import = copier le ledger live (is_duplicate = 0) de cet enseigne × PeriodKey vers des lignes overlay (S17). Copie Q1 → Q3 : cloner header, PeriodKey cible YYYYQ3, préremplir overlay depuis le Q1 (CDC Géographies : « Préremplir DV négo Q3 = Q1 ? Oui. » — S22).

3. Dataverse — overlay et sécurité

Grain : scenario_id × ean × conditionnement. Alternate key cr568_ak_simu_overlay. Une ligne = un écart EAN du scénario (CDC S4 / S20). Le seed n'a qu'une ROW TEST3 × 3502110008343 UNITAIRE T2, dv_cible blank, tx_transfo 0,95.

Ce que l'overlay ne stocke pas (et que le PBI calcule déjà)

Patch idempotent. LookUp sur la clé alternative, puis Patch. Ne pas Create en doublon si l'EAN est déjà overlay pour ce scénario × conditionnement.

Sécurité

CDC module 1 (Prio) = restreint Perfect Store + DXI. CDC module Simu = espace de travail RDE, sans cette phrase. Ne pas recopier la restriction Prio. S24 est la seule règle de sécurité d'écriture nommée : ne pas écrire le ledger tant que non promu.

Valeurs de choice — identiques au modèle PBI

• cr568_statut : EIE, LE, validé, ad hoc (même texte que Simu_Scenario[statut], sinon le slicer / la carte Création cassent).
• cr568_periode_dv_reelle : CAM, CAD, LP (slicer seed).
• cr568_promu_nego : oui, non (seed = non).
• cr568_enseigne : libellé référentiel (CARREFOUR HM…), aligné Dim_Enseignes.

4. Console Création / scénario

Une app, écrans RDE (wireframe — pas le chrome PBI). StartScreen selon host_screen (section Embed). Pas de menu interne qui duplique les six onglets PBI.

OnVisible commun : Set(varRow; First(PowerBIIntegration.Data)). Si scenario_id et ean blank → « Choisissez un scénario, puis une ligne EAN ». Tous les Patch lisent varRow + galerie filtrée, jamais une galerie interne non filtrée.

Écran A — Nouveau / import / clone

Import persisté (S17) : pour chaque ligne ledger is_duplicate = 0 de l'enseigne × PeriodKey, créer une overlay (ean, conditionnement, strate, perma, dates, tx si connu). Ce n'est pas Flux PPC. La base du seed aujourd'hui est le ledger déjà chargé, sans écriture PeriodKey.

Patch(
  cr568_simu_scenarios;
  LookUp(cr568_simu_scenarios; cr568_scenario_id = varNewId);
  {
    cr568_scenario_id: varNewId;
    cr568_nom_scenario: TxtNom.Text;
    cr568_enseigne: CmbEnseigne.Selected.Value;
    cr568_periodkey: CmbPeriodKey.Selected.Value;
    cr568_annee_typo: Value(Left(CmbPeriodKey.Selected.Value; 4));
    cr568_nego: Right(CmbPeriodKey.Selected.Value; 2);
    cr568_statut: "ad hoc";
    cr568_statut_ordre: 4;
    cr568_base_type: CmbBase.Selected.Value;
    cr568_base_ref: varBaseRef;
    cr568_periode_dv_reelle: CmbPeriodeDV.Selected.Value;
    cr568_promu_nego: "non"
  }
)

5. Consoles saisie strat, états, promote

Écran B — Saisie overlay (strate par EAN)

Clic ligne PBI → varRow.ean. Galerie Filter(cr568_simu_overlays; cr568_scenario_id = varRow.scenario_id). Préremplir depuis l'overlay persistée, sinon ledger / Dim_Strates (même ordre que le COALESCE).

États — brouillon / validé / push

« Brouillon » n'est pas un statut CDC. C'est le panier de travail : ad hoc, EIE, LE (S3). validé est le seul statut qui autorise le promote. Seeds actuels : ad hoc + EIE ; LE / validé absents ; promu_nego = non.

Écran C — Promote validé → négo

Bouton visible seulement si statut = validé et promu_nego = non. Confirmer enseigne × PeriodKey. Pour chaque overlay : upsert ledger au grain EAN × enseigne × PeriodKey (ScaKey), is_duplicate = 0. Colonnes déjà lues par le rapport (architecture) : strate_LE ou strate_EIE selon le statut source, DVvaleur_LE / DNvaleur_LE (ou EIE), Typologie (perma), Mouvement, dates, conditionnement. PeriodKey = année & date_accords (Q1/Q3). Ne pas écrire DEF (2 lignes live — autre chemin). Ne pas passer par Flux PPC.

6. Embed Power BI

Remplacer la card « Console Simu — à brancher » (acedc191357f4eac992b) par le visuel Power Apps, même emplacement que Saisie / Prio : x ≈ 987, y ≈ 223, width ≈ 279, height ≈ 477, dans le rectangle arrondi console.

Placeholders déjà posés (prior work, hidden) : txt_console (titre « Console Simu ») et shape_console (fond arrondi, x ≈ 982, y ≈ 188, 290 × 519). Les six pages Simu les portent. Ne pas les redessiner — les laisser, y poser l'app.

Champs PowerBIIntegration.Data (nativeQueryRef)

Noms sans slash ni accent : l'app les lit en identifiants. Le tableau PBI peut garder les libellés FR.

Mesure host_screen par page pour StartScreen = Switch(First(PowerBIIntegration.Data).host_screen; …). Évite un Param() fragile dans l'embed Desktop.

Slicers obligatoires avant saisie

Set(varRow; First(PowerBIIntegration.Data));;
If(
  IsBlank(varRow.scenario_id);
  Notify("Sélectionnez une enseigne et un nom de scénario"; NotificationType.Warning);
  Navigate(EcrStrat; ScreenTransition.None)
)

7. Flux et contrat COALESCE

Sans ce hop, le Patch est invisible dans Power BI. Aujourd'hui Simu_Scenario est un DATATABLE (2 lignes) et Simu_Overlay une ROW calculée. Dataverse n'est importé que pour cr568_negotiation_current. Dataset 612ef347-d29a-40a4-9073-11a699847590, workspace 653b685c-… — les IDs que les flux cloud rafraîchissent déjà (Saisie / ingest).

Contrat de champs avec le seed (ne pas casser le COALESCE)

Fallback seed. Tant qu'aucune ligne Dataverse n'existe, garder le DATATABLE / ROW (deux scénarios CARREFOUR HM) pour que le lecteur continue. COALESCE(Dataverse ; seed) au go-live, comme COALESCE(décision ; spec) côté Prio.

Refresh à la demande. Bouton app « Publier vers le rapport » = flux Power Automate, pas un refresh Desktop. Ne rafraîchir que si le Patch a réussi. Pas toutes les 5 min (le PPC négo garde son cadencement). Mesure Trigger Refresh = MAX(Z_Table_Refresh_Key[Value1]) ne recharge pas les données — c'est le poke Saisie, pas le writeback Simu.

8. Recette

9. Checklist de livraison

Aligné sur le CDC module Simu Négo (chaîne = 2 ; maquette = 4 ; écrans #12–14 ; briefing 16.02.2026), la couverture S1–S24, le seed Simu_Scenario / Simu_Overlay, le ledger cr568_negotiation_current, et le brief Prio (même mécanique embed + refresh, autre grain).