Catégorie de programme

Documentation pour les catégories parentes dans le module Programme. Les sous-catégories (lignes enfants) sont traitées séparément : Sous-catégorie de programme.

• URL de base (Administration) : https://admin.acusolo.net/
• URL de base (Application web) : https://web.acusolo.net/

Modèle de données (catégorie parente)

Dans le tableau partagé des catégories, une catégorie parente est une ligne où parentId est null. Les lignes enfants sont documentées sur la page sous-catégorie.

Liste d'administration : Catégories

Colonnes

Colonne	Définition
Serial	Ordre d'affichage et de tri pour les catégories dans l'administration et dans les interfaces de l'application (cartes/listes). Affiché en tant que Numéro dans le tableau. Optionnel dans le formulaire de création lorsque vous vous fiez au tri par défaut.
Actions	Actions de ligne, ce n'est pas un champ stocké : Modifier (Edit) (stylo), Voir (View) (œil), Supprimer (Delete) (corbeille). Voir Actions et comportement ci-dessous.
Status	Visibilité booléenne : lorsqu'il est activé, la catégorie apparaît dans l'application mobile et web ; lorsqu'il est désactivé, il est masqué pour les utilisateurs finaux.
Name	Étiquette lisible par l'homme pour la catégorie. Requis. Maximum 256 caractères.
Icon	Optionnel. HTML ou SVG en ligne utilisé pour l'icône de la catégorie (par exemple, balises d'icônes de Lucide, Font Awesome ou similaire). S'il est vide, l'interface utilisateur peut afficher N/A ou omettre l'icône.
Gender	Ciblage pour l'imagerie et l'affichage (par exemple Les deux (Both), ou un genre spécifique lorsqu'il est configuré).
Male Images	Aperçu des éléments d'image masculins : emplacements par défaut et/ou par groupe d'âge (Enfant, Jeune adulte, Adulte, Senior) lorsque Images basées sur l'âge (Age-Based Images) est activé. Les règles de téléchargement correspondent au modal (par exemple, types d'images et 5 Mo max par fichier là où c'est indiqué).
Female Images	Identique à la colonne masculine, pour les éléments féminins.
Description	Copie longue (texte riche dans l'administration). Optionnel. Taille maximale alignée avec MySQL TEXT : 65 535 octets.
Timestamp	Dates et heures de Création (Created) et de dernière mise à jour (last updated) de l'enregistrement (created / updated, affichées comme Cr / Up ou équivalent dans l'interface utilisateur).

Règles de champ (champs de texte)

• Name : requis, maximum 256 caractères.
• Description : optionnel, taille maximale MySQL TEXT (65 535 octets).

Actions et comportement

• Modifier (Edit) (stylo) : ouvre le modal de modification avec les données existantes.
• Voir (View) (œil) : ouvre le flux pour gérer les sous-catégories sous ce parent. Voir Sous-catégorie de programme.
• Supprimer (Delete) (corbeille) : ouvre la confirmation et supprime définitivement l'enregistrement après confirmation.
• Bascule de statut (Status toggle) : contrôle la visibilité dans l'interface de l'application mobile et web.

Remarques sur le tri et l'affichage

• Les cartes de catégorie sont rendues par numéro de série croissant (serial ascending) dans les expériences de l'application.
• Le tableau de liste affiche un aperçu des images spécifiques au genre et balisées par âge lorsqu'elles configurées.

Modal de création de catégorie

Utilisez Ajouter une catégorie (Add category) pour créer une catégorie de niveau supérieur : laissez Catégorie parente (Parent category) vide (ou un équivalent « sans parent ») afin que parentId reste null.

Champs principaux

• Nom (Name) (requis)
• Série (Serial) (optionnel)
• Genre (Gender) (Both, ou cible spécifique telle que configurée)
• Catégorie parente (Parent Category) — à ne pas définir pour une catégorie parente ; requis lors de la création d'une sous-catégorie
• Image masculine (Male Image) et Image féminine (Female Image)
• Description (éditeur de texte riche)
• Icône HTML (Icon (HTML)) saisie pour le code HTML/SVG (par exemple le code SVG Lucide ou Font Awesome)

Remarques sur la description et l'icône

• La description utilise un éditeur de texte riche et prend en charge le contenu long.
• Le champ d'icône accepte le code HTML/SVG et est utilisé par les couches de rendu de l'interface utilisateur où l'affichage des icônes est activé.

Modal de modification de catégorie

À partir de la liste, cliquez sur le stylo jaune pour ouvrir Modifier la catégorie (Edit Category).

Différences entre la modification et la création

• Tous les champs sont pré-remplis avec l'enregistrement sauvegardé (nom, parent, images, description, options basées sur l'âge, etc.).
• L'action principale de sauvegarde est Mettre à jour (Update) (par exemple Mettre à jour avec les groupes d'âge (Update with Age groups) lorsque l'imagerie basée sur l'âge est activée), au lieu de Créer (Create) / Créer avec des groupes d'âge (Create with Age Groups).
• Annuler (Cancel) ferme le modal sans conserver les modifications.

Champs visibles dans la modification (alignés sur la création)

• Catégorie parente (Parent category) — pour une ligne de niveau supérieur, cela reste vide ; c'est en le modifiant que vous déplacez ou attachez des lignes (voir sous-catégorie).
• Images basées sur l'âge (Age-Based images) — lorsqu'elles sont activées, les mêmes chargeurs par défaut et par groupe d'âge apparaissent ; les téléchargements existants s'affichent sous forme d'aperçus afin que vous puissiez remplacer les fichiers ou les conserver.
• Emplacements Par défaut (Default) — options de secours optionnelles (par exemple image par défaut / icône par défaut) lorsque l'ensemble basé sur l'âge est utilisé, selon la configuration.
• Images spécifiques au groupe d'âge (Age group specific images) — par groupe (Enfant, Jeune adulte, Adulte, Senior), emplacements masculins et féminins ; les formats et les limites de taille correspondent au flux de création (par exemple jusqu'à 5 Mo et types d'images courants).
• Description — éditeur de texte riche ; le contenu long et les médias intégrés se comportent comme lors de la création.

Bascule des images basées sur l'âge

Lorsque Images basées sur l'âge (Age-Based Images) est activé :

• Des sections d'images supplémentaires apparaissent.
• L'action du modal passe à Créer avec des groupes d'âge (Create with Age Groups).
• Vous pouvez télécharger un ensemble par défaut plus des ensembles spécifiques à l'âge.

Groupes d'âge

• CHILD : Enfant (8-17 ans)
• YOUNG_ADULT : Jeune adulte (18-35 ans)
• ADULT : Adulte (36-55 ans)
• SENIOR : Senior (55+ ans)

Pour chaque groupe d'âge, téléchargez :

• Image masculine
• Image féminine

Logique de sélection dans l'interface web/mobile

Les applications clientes calculent l'âge de l'utilisateur à partir de sa date de naissance et le combinent avec son genre :

1. Correspondance du genre
2. Correspondance de l'image du groupe d'âge (si disponible)
3. Repli vers l'image masculine/féminine par défaut

Les images basées sur l'âge sont destinées à être fournies par l'administration pour un ciblage précis de l'interface utilisateur.

Interface Web : cartes de catégories et détails

Les cartes de catégories affichent l'image, le titre et un résumé du contenu ; cliquer ouvre le flux de détails.

Sur les détails de la catégorie :

• Le contenu principal et l'image principale sont affichés côte à côte.
• La description longue est affichée dans une zone de contenu défilable.
• Les cartes des sous-catégories sont affichées en dessous — voir Sous-catégorie de programme.

Liaison d'URL (catégorie)

Les routes détaillées des catégories peuvent utiliser des URL basées sur l'ID ou sur un slug, selon la configuration du produit. Exemple d'hôte web :

• https://web.acusolo.net/...

Vidéo explicative

https://www.youtube.com/watch?v=3JOsXSAKzq4