Bonnes pratiques – VISION (Visionsoft)

Une bonne application no-code ne suffit pas.
Une application maintenable, évolutive et compréhensible fait toute la différence.

VISION, la solution no-code ultra performante de Visionsoft, permet de créer des applications métiers sans limite (GMAO, MES, Supply Chain, BIM, etc.).
Pour garantir la pérennité des projets, voici les bonnes pratiques recommandées.

1️⃣ Un modèle de données (SmartObjects) clair

Un modèle clair = un projet compréhensible dans le temps.

À faire

• Donner un nom métier clair à chaque SmartObject
• Définir chaque champ :
• Type
• Obligatoire / facultatif
• Valeur par défaut
• Préciser les dépendances avec d’autres applications

Bon exemple

Équipement

• Description : Entité représentant un actif maintenable.
• Champs :
• nom (string, obligatoire)
• date_mise_en_service (date)

À éviter

• Champs nommés : champ1, data2
• Relations implicites non documentées

2️⃣ Documenter les processus (Workflows)

Les workflows sont le coeur de la logique métier.

À faire

• Décrire l’objectif du workflow en utilisant les blocs
• Regrouper les principales étapes en plusieurs blocs logiques
• Détailler :
• Les étapes principales
• Les règles de décision
• Les notifications envoyées
• Les impacts sur les données

Exemple

Workflow : Validation d’un ordre de travail

1. Soumission par le technicien
2. Vérification des pièces
3. Validation responsable
4. Changement de statut → Planifié

3️⃣ Documenter les Smartflows (Intégrations & Automatisations)

Les Smartflows orchestrent les échanges de données.

À documenter

• Source de données (API, ERP, GMAO, CSV…)
• Règles de transformation
• Gestion des erreurs

4️⃣ Documenter l’interface utilisateur (UI Composer)

L’UI doit être compréhensible sans ouvrir le studio.

À inclure

• Objectif de chaque écran
• Règles d’affichage conditionnel
• Logique des boutons d’action

5️⃣ Documenter les règles métier

Les règles métier ne doivent jamais être implicites.

Exemples

• Un OT ne peut être clôturé si une NC est ouverte
• Une consommation matière doit être liée à un OF
• Une VGP ne peut être générée que si l’équipement est actif

Pour chaque règle, documenter :

• La règle dans le workflow ou dans le bouton d'appel si besoin

6️⃣ Utiliser VISION AI pour documenter plus vite

Grâce à VISION AI, il est possible de :

• Générer automatiquement une description de modèle
• Produire un résumé fonctionnel
• Générer une cartographie des objets
• Transformer une documentation en base de connaissances

De plus, chaque workflow ou écran généré avec l'IA garde l'historique des prompts, ce qui en fait une base de documentation idéale.

7️⃣ Conseils de prompts

💡Décrivez le résultat, pas les étapes.
Dites à Vision ce que vous voulez obtenir, pas comment le construire. Décrivez l'interface finale comme si vous l'expliquiez à un collègue.

💡Précisez le profil utilisateur cible
Mentionnez qui va utiliser la page ou le workflow. Vision adapte la complexité de l'interface au public visé.

💡Listez les données à afficher
Énumérez les champs importants. Plus vous êtes précis, moins Vision devra deviner. Indiquez aussi ce qui est facultatif.

💡Ancrez dans un processus métier réel
Décrivez brièvement le contexte : d'où viennent les données, qui valide quoi, quelle est la fréquence d'utilisation.

💡Décrivez les états et transitions de workflows
Pour un workflow, listez les étapes et ce qui déclenche le passage de l'une à l'autre.

💡Indiquez les actions possibles
Précisez ce que l'utilisateur doit pouvoir faire : consulter seulement, modifier, exporter, filtrer, déclencher une action.

💡Ne pas demander du code ou de la technique
Vision génère des interfaces no-code. Inutile de mentionner des API, du SQL ou des frameworks. Restez dans la logique métier.

💡Évitez les demandes trop vagues
Des prompts comme "fais un dashboard RH" laissent trop de liberté. Vision fait de son mieux, mais une itération sera nécessaire.

💡Séparez page et workflow dans un même prompt
Si vous voulez une page ET un workflow lié, décrivez-les en deux blocs distincts avec une phrase de liaison claire.

💡Spécifiez les règles métier importantes
Toute règle de gestion doit être explicite : seuils, conditions, permissions, calculs automatiques attendus.