====== Démarche d'analyse d'une machine de manchonnage (approche SDD / BDD) ======

===== Objectif =====

L'objectif n'est pas de décrire l'automatisme ni les entrées/sorties, mais de comprendre et formaliser le comportement métier de la machine afin de pouvoir ensuite produire :

  * des exigences
  * des scénarios Gherkin
  * un DSL métier
  * un Grafcet
  * du code IEC 61131-3

-----

===== 1. Définir le périmètre du système =====

Première question :

<code>
Qu'est-ce que la machine doit faire ?
</code>

Ne pas réfléchir au "comment".

Exemple :

<code>
Entrée :
- bouteille nue

Transformation :
- pose d'un manchon thermorétractable

Sortie :
- bouteille manchonnée
</code>

Le périmètre du système est alors établi.

-----

===== 2. Identifier les flux =====

Avant de réfléchir aux séquences, identifier les flux traversant la machine.

==== Flux produit ====

<code>
Bouteille entrante
↓
Prise en charge
↓
Manchonnage
↓
Évacuation
</code>

==== Flux matière ====

<code>
Bobine
↓
Déroulage
↓
Découpe
↓
Pose
</code>

==== Flux opérateur ====

<code>
Marche
Arrêt
Réarmement
Changement de bobine
</code>

-----

===== 3. Construire le cycle nominal =====

Question principale :

<code>
Quel est le scénario idéal sans aucun défaut ?
</code>

Exemple :

<code>
Attente bouteille
↓
Détection
↓
Positionnement
↓
Déroulage film
↓
Découpe
↓
Pose manchon
↓
Libération bouteille
↓
Retour attente
</code>

Ce scénario constitue le ''Happy Path''.

-----

===== 4. Décomposer en capacités métier =====

Identifier les fonctions métier apportées par la machine.

Ne pas parler :

  * de moteurs
  * de vérins
  * de capteurs

Mais des capacités offertes.

Exemple :

<code>
Recevoir une bouteille
Positionner une bouteille
Produire un manchon
Déposer un manchon
Évacuer le produit
</code>

-----

===== 5. Identifier les règles métier =====

Pour chaque capacité :

<code>
Quand a-t-on le droit de commencer ?
Quand a-t-on terminé ?
Qu'est-ce qui interdit l'exécution ?
</code>

Exemple :

=== Découpe du manchon ===

Préconditions :

<code>
- bouteille présente
- film disponible
</code>

Résultat attendu :

<code>
- manchon disponible
</code>

Interdictions :

<code>
- bobine vide
- porte ouverte
</code>

-----

===== 6. Identifier les événements =====

Chaque évolution de la machine est déclenchée par un événement.

Structure :

<code>
Événement entrant
↓
Réaction machine
↓
Événement sortant
</code>

Exemple :

<code>
Bouteille détectée
↓
Positionnement démarre
↓
Bouteille positionnée
</code>

-----

===== 7. Construire les états métier =====

Définir les états stables du système.

Exemple :

<code>
ARRET
PRET
ATTENTE_BOUTEILLE
POSITIONNEMENT
PREPARATION_MANCHON
POSE_MANCHON
EVACUATION
DEFAUT
</code>

Ces états serviront de base :

  * au DSL
  * au Grafcet
  * aux scénarios Gherkin

-----

===== 8. Analyser les variantes =====

Le fonctionnement nominal ne décrit qu'une partie du comportement.

==== Variantes opératoires ====

<code>
Auto
Manuel
Pas à pas
Réglage
Maintenance
</code>

==== Variantes produit ====

<code>
Petit flacon
Grande bouteille
Format spécial
</code>

-----

===== 9. Analyser les situations anormales =====

Pour chaque anomalie :

<code>
Cause
↓
Conséquence
↓
Réaction machine
↓
Retour à la normale
</code>

Exemple :

<code>
Fin de bobine
↓
Plus de manchon
↓
Arrêt cycle
↓
Alarme
↓
Remplacement bobine
↓
Réarmement
</code>

-----

===== 10. Classifier les exigences =====

==== Exigences fonctionnelles ====

<code>
La machine doit poser un manchon.
</code>

==== Exigences de sécurité ====

<code>
La machine doit s'arrêter lors d'un arrêt d'urgence.
</code>

==== Exigences de performance ====

<code>
250 bouteilles par minute.
</code>

==== Exigences opérateur ====

<code>
L'opérateur doit pouvoir changer de format.
</code>

-----

===== 11. Écrire les scénarios métier =====

Une fois l'analyse réalisée, rédiger les scénarios.

Structure :

<code>
Contexte
↓
Événement
↓
Résultat observable
</code>

Autrement dit :

<code>
État métier
↓
Transition
↓
Nouvel état métier
</code>

Le Gherkin devient alors une transcription de l'analyse.

-----

====== Artefacts à produire avant d'écrire le Gherkin ======

===== 1. Carte des capacités =====

Identifier les grandes fonctions métier de la machine.

Exemple :

<code>
Recevoir
Positionner
Découper
Poser
Évacuer
</code>

-----

===== 2. Machine à états métier =====

Construire les principaux états du comportement.

Exemple :

<code>
PRET
ATTENTE
POSITIONNEMENT
DECOUPE
POSE
EVACUATION
DEFAUT
</code>

-----

===== 3. Catalogue des événements =====

Lister tous les événements significatifs.

Exemple :

<code>
Bouteille détectée
Position atteinte
Manchon découpé
Pose terminée
Produit évacué
Défaut détecté
</code>

-----

====== Critère de qualité de l'analyse ======

L'analyse est considérée comme mature lorsque :

  * les capacités métier sont identifiées ;
  * les états métier sont connus ;
  * les événements sont clairement définis ;
  * les règles métier sont explicites ;
  * les situations anormales sont décrites ;
  * les scénarios Gherkin s'écrivent presque automatiquement à partir des éléments précédents.

À ce stade, le passage :

<code>
Analyse métier
↓
Gherkin
↓
DSL
↓
Grafcet
↓
IEC 61131-3
</code>

devient largement mécanisable.