From 2585b38af339658b2c27230e7ae63a78bdd2e41b Mon Sep 17 00:00:00 2001
From: dahoud <dahoud@dgbf.ci>
Date: Sat, 29 Nov 2025 19:19:10 +0000
Subject: [PATCH] =?UTF-8?q?feat(client):=20Cr=C3=A9ation=20du=20composant?=
 =?UTF-8?q?=20button-form-submit.xhtml=20pour=20les=20actions=20backend=20?=
 =?UTF-8?q?(DRY/WOU)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Nouveau composant button-form-submit.xhtml pour les boutons de soumission de formulaire
- Utilise ui:decorate avec ui:define pour passer l'expression de méthode action
- Supporte tous les attributs PrimeFaces : update, process, oncomplete, validateClient
- Paramètre severity pour les différents styles (success, secondary, warning, danger)
- Application dans nouvelle.xhtml et liste.xhtml (dialogue de modification)
- Respecte les conventions PrimeFaces et évite les erreurs EL

Cette approche permet de réutiliser le composant tout en passant correctement
les expressions de méthode via ui:define au lieu de ui:param.
---
 .../pages/secure/organisation/liste.xhtml     | 18 ++++---
 .../pages/secure/organisation/nouvelle.xhtml  | 16 ++++---
 .../buttons/button-form-submit.xhtml          | 47 +++++++++++++++++++
 3 files changed, 69 insertions(+), 12 deletions(-)
 create mode 100644 unionflow-client-quarkus-primefaces-freya/src/main/resources/META-INF/resources/templates/components/buttons/button-form-submit.xhtml

diff --git a/unionflow-client-quarkus-primefaces-freya/src/main/resources/META-INF/resources/pages/secure/organisation/liste.xhtml b/unionflow-client-quarkus-primefaces-freya/src/main/resources/META-INF/resources/pages/secure/organisation/liste.xhtml
index 254dcc2..4ea9b94 100644
--- a/unionflow-client-quarkus-primefaces-freya/src/main/resources/META-INF/resources/pages/secure/organisation/liste.xhtml
+++ b/unionflow-client-quarkus-primefaces-freya/src/main/resources/META-INF/resources/pages/secure/organisation/liste.xhtml
@@ -224,17 +224,23 @@
                 </ui:fragment>
             </ui:define>
             <ui:define name="footer">
+                <!-- Bouton Annuler : type="button" pour éviter la soumission -->
                 <p:commandButton value="Annuler"
                                icon="pi pi-times"
                                type="button"
                                onclick="PF('dlgModifier').hide();"
                                styleClass="ui-button-secondary" />
-                <p:commandButton value="Enregistrer"
-                               icon="pi pi-check"
-                               action="#{organisationsBean.modifierOrganisation}"
-                               update=":formOrganisations:dtOrganisations :formOrganisations:messages"
-                               oncomplete="if(!args.validationFailed) PF('dlgModifier').hide();"
-                               styleClass="ui-button-success" />
+                <!-- DRY/WOU: button-form-submit pour action backend -->
+                <ui:decorate template="/templates/components/buttons/button-form-submit.xhtml">
+                    <ui:param name="value" value="Enregistrer" />
+                    <ui:param name="icon" value="pi pi-check" />
+                    <ui:param name="update" value=":formOrganisations:dtOrganisations :formOrganisations:messages" />
+                    <ui:param name="oncomplete" value="if(!args.validationFailed) PF('dlgModifier').hide();" />
+                    <ui:param name="severity" value="success" />
+                    <ui:define name="action">
+                        #{organisationsBean.modifierOrganisation}
+                    </ui:define>
+                </ui:decorate>
             </ui:define>
         </ui:decorate>
     </ui:define>
diff --git a/unionflow-client-quarkus-primefaces-freya/src/main/resources/META-INF/resources/pages/secure/organisation/nouvelle.xhtml b/unionflow-client-quarkus-primefaces-freya/src/main/resources/META-INF/resources/pages/secure/organisation/nouvelle.xhtml
index cc6ad2d..2486a79 100644
--- a/unionflow-client-quarkus-primefaces-freya/src/main/resources/META-INF/resources/pages/secure/organisation/nouvelle.xhtml
+++ b/unionflow-client-quarkus-primefaces-freya/src/main/resources/META-INF/resources/pages/secure/organisation/nouvelle.xhtml
@@ -48,12 +48,16 @@
                     <ui:param name="icon" value="pi pi-times"/>
                     <ui:param name="outcome" value="/pages/secure/organisation/liste"/>
                 </ui:include>
-                <!-- Note: p:commandButton direct car action avec méthode backend ne peut pas être passé via ui:param -->
-                <p:commandButton value="Créer"
-                               icon="pi pi-check"
-                               action="#{organisationsBean.creerOrganisation}"
-                               update=":formNouvelleOrganisation:messages"
-                               styleClass="ui-button-success" />
+                <!-- DRY/WOU: button-form-submit pour action backend -->
+                <ui:decorate template="/templates/components/buttons/button-form-submit.xhtml">
+                    <ui:param name="value" value="Créer" />
+                    <ui:param name="icon" value="pi pi-check" />
+                    <ui:param name="update" value=":formNouvelleOrganisation:messages" />
+                    <ui:param name="severity" value="success" />
+                    <ui:define name="action">
+                        #{organisationsBean.creerOrganisation}
+                    </ui:define>
+                </ui:decorate>
             </div>
         </h:form>
     </ui:define>
diff --git a/unionflow-client-quarkus-primefaces-freya/src/main/resources/META-INF/resources/templates/components/buttons/button-form-submit.xhtml b/unionflow-client-quarkus-primefaces-freya/src/main/resources/META-INF/resources/templates/components/buttons/button-form-submit.xhtml
new file mode 100644
index 0000000..c97b629
--- /dev/null
+++ b/unionflow-client-quarkus-primefaces-freya/src/main/resources/META-INF/resources/templates/components/buttons/button-form-submit.xhtml
@@ -0,0 +1,47 @@
+<ui:composition xmlns="http://www.w3.org/1999/xhtml"
+                xmlns:h="http://xmlns.jcp.org/jsf/html"
+                xmlns:ui="http://xmlns.jcp.org/jsf/facelets"
+                xmlns:p="http://primefaces.org/ui">
+    
+    <!-- 
+        Composant bouton de soumission de formulaire réutilisable (WOU/DRY)
+        
+        Usage :
+        <ui:decorate template="/templates/components/buttons/button-form-submit.xhtml">
+            <ui:param name="value" value="Enregistrer" />
+            <ui:param name="icon" value="pi pi-check" />
+            <ui:param name="update" value=":form:messages" />
+            <ui:param name="process" value="@form" />
+            <ui:param name="severity" value="success" />
+            <ui:param name="oncomplete" value="if(!args.validationFailed) PF('dialog').hide();" />
+            <ui:define name="action">
+                #{bean.saveMethod}
+            </ui:define>
+        </ui:decorate>
+        
+        Paramètres :
+        - value : Texte du bouton (requis)
+        - icon : Icône (optionnel, défaut: pi pi-check)
+        - update : Composants à mettre à jour (optionnel)
+        - process : Composants à traiter (optionnel, défaut: @form)
+        - severity : success, secondary, warning, danger, info, primary (défaut: success)
+        - disabled : true/false (défaut: false)
+        - oncomplete : JavaScript à exécuter après l'action (optionnel)
+        - validateClient : true/false pour validation côté client (défaut: false)
+        - styleClass : Classes CSS additionnelles (optionnel)
+        
+        Slot action : Expression de méthode du bean (requis)
+    -->
+    
+    <p:commandButton value="#{value}"
+                   icon="#{empty icon ? 'pi pi-check' : icon}"
+                   action="#{action}"
+                   update="#{update}"
+                   process="#{empty process ? '@form' : process}"
+                   oncomplete="#{oncomplete}"
+                   validateClient="#{not empty validateClient and validateClient}"
+                   disabled="#{not empty disabled and disabled}"
+                   styleClass="ui-button-#{empty severity ? 'success' : severity} #{not empty styleClass ? styleClass : ''}"
+                   title="#{title}" />
+</ui:composition>
+