projet-mini-genie-logiciel-systeme/rapport/rapport.tex

\documentclass[a4paper, 12pt]{article}
\usepackage[T1]{fontenc}
\usepackage[french]{babel}
\usepackage[utf8]{inputenc}
\usepackage{graphicx}
\usepackage{amsmath}
\usepackage{amsfonts}
\usepackage{amssymb}
\usepackage{color}
\usepackage{xcolor}
\usepackage{natbib}
\usepackage[hidelinks]{hyperref}
\usepackage[nottoc, numbib]{tocbibind}
\usepackage[justification=centering]{caption}
\usepackage{mathtools}
\usepackage{lipsum}
\usepackage{lscape}
\usepackage{caption}
\usepackage{subcaption}
\usepackage{minted}
\usepackage{multicol}
\usepackage{svg}

\newminted{text}{linenos, numbersep=6pt, frame=leftline}
\newminted{html}{linenos, numbersep=6pt, frame=leftline}

\usepackage{contour}
\usepackage{ulem}
\renewcommand{\ULdepth}{1.8pt}
\contourlength{0.8pt}
\newcommand{\myuline}[1]{%
  \uline{\phantom{#1}}%
  \llap{\contour{white}{#1}}%
}

\newcommand{\dst}{\displaystyle}

\usepackage[margin=2cm]{geometry}

\graphicspath{
    {./assets/}
}

\begin{document}

\begin{figure}[t]
    \centering
    $\includesvg[height=1cm]{inp-enseeiht.svg}$
\end{figure}

\title{
    \vspace{4cm}
    \textbf{Rapport de Mini-Projet} \\
    Génie du Logiciel et des Systèmes \\
    Chaîne de vérification de modèles de processus
}
\author{
    \myuline{Groupe M-02} \\
    Fainsin Laurent \\
    Guillotin Damien \\
}
\date{
    \vspace{10cm}
    Département Sciences du Numérique \\
    Deuxième année \\
    2021 — 2022
}

\maketitle

\newpage

\tableofcontents

\newpage

\section{Métamodèles (avec Ecore)}

\subsection{simplePDL.ecore}

Ce projet se base sur un langage simplifié de modélisation de processus de développement, appelé SimplePDL.
Nous sommes donc parti du modèle Ecore de base du modèle SimplePDL auquel nous avons ajouté progressivement des nouveaux éléments.
Dans un premier temps, il a fallu ajouter la modélisation des guidances comme indiqué dans le sujet.

% \begin{figure}[H]
%     \centering
%     \includegraphics[width=15cm]{simplePDL_guidance.png}
%     \caption{Métamodèle simplePDL avec guidance}
%     \label{simplePDL_guidance}
% \end{figure}

Nous avons ensuite dû choisir une manière de modéliser les ressources nécessaires au processus de développement.
Notre choix de modélisation s’est porté sur : une Ressource (qui implémente ProcessElement) est demandée par le biai d’une Request elle-même générée par une WorkDefinition.
On se retrouve donc avec un nouveau modèle Ecore de la forme :

% \begin{figure}[H]
%     \centering
%     \includegraphics[width=15cm]{simplePDL_guidance_ressource.png}
%     \caption{Métamodèle simplePDL avec guidance et ressource}
%     \label{simplePDL_guidance_ressource}
% \end{figure}

Les relations Ressource-Request et Request-WorkDefinition sont déclarées en EOpposite pour pouvoir facilement passer d’un fils à un parent et vice versa.
Le modèle SimplePDL est maintenant complet pour représenter des processus de développement.
Un exemple complet d’utilisation de ce modèle serait :

% \begin{figure}[H]
%     \centering
%     \includegraphics[width=15cm]{simplePDL_complet.png}
%     \caption{Métamodèle simplePDL complet}
%     \label{simplePDL_complet}
% \end{figure}

\subsection{petriNet.ecore}

En se basant sur ce que l’on a vu pour le modèle SimplePDL, nous avons créé un modèle Ecore permettant de modéliser les réseaux de pétri.
Nous avons modélisé un réseau comme étant composé de nœuds.
Ces nœuds peuvent être les places ou des transitions.
Ils sont donc nommés et reliés entre eux par des arcs.
Ses arcs ont un attribut entier nommé weight pour indiquer le poids de l’arc ainsi qu’un boolean outgoing pour indiquer si ce dernier est dirigé d’une Place vers une Transition ou d’une Transition vers une Place.
(Si outgoing est vrai, alors l’arc va de la transition vers la place.)

% \begin{figure}[H]
%     \centering
%     \includegraphics[width=15cm]{petriNet_complet.png}
%     \caption{Métamodèle petriNet complet}
%     \label{petriNet_complet}
% \end{figure}

\section{Sémantique statique (avec OCL)}

Les contraintes OCL sont là pour vérifier des informations du modèle vis-à-vis du métamodèle.
Elles assurent certains points de cohérence et permettent d'éviter les ambiguïtés.

\subsection{simplePDL.ocl}

Pour les modèles SimplePDL, nous obligeons l’utilisateur à entrer des noms valides pour le Process, les WorkDefinition et les Resource.
Les noms doivent aussi être unique pour les WorkDefinition et les Ressource pour améliorer la clarté du modèle.
Nous avons aussi contraint l’utilisateur à utiliser les WorkSequence sur des WorkDefinition appartenant au même Process.
Pour éviter des non-sens, les WorkSequence ne peuvent pas non plus avoir le même successeur et prédécesseur.
Nous avons aussi ajouté des contraintes sur les quantités des Resource et Request.
En effet, cela n’a pas de sens d’savoir des Resource ou des Request avec des quantités négatives.
De plus, une Request ne peut pas être plus grande que le nombre initial de ressources.
(Le nombre initial de ressources est le maximum puisqu’il n’y a pas de création.)

\subsection{petriNet.ocl}

Les modèles PetriNet étant relativement similaireq aux modèles SimplePDL, nous avons établi des contraintes OCL similaires.
Nous obligeons le Network et les Node à avoir des noms uniques mais également sensés.
Le nombre de jetons des Place et le poids des Arc doivent évidemment être positifs.

\section{Eclipse Modeling Framework (EMF)}

Pour permettre une meilleur intégration de nos métamodèles dans notre environnement de developpement (sous Eclipse), nous pouvons créer des greffons nous permetttant de les intégrer dans d'autres projets ainsi que des éditeurs arborescents nous permettant de mieux visualiser/éditer des modèles conformes à nos métamodèles Ecore.
Le code java de ces éditeurs arborescent est engendré par nos métamodèles Ecore, mais nous pouvons le modifier manuellement pour que celui-ci convienne parfaitement à nos critères.
Ces plugins seront déployés dans une Eclipse Application séparée de notre Application principale pour ne pas mélanger métamodèles et modèles.

\subsection{plugin simplePDL}

\begin{figure}[H]
    \centering
    \includegraphics[width=15cm]{simplePDL_emf.png}
    \caption{Éditeur arborecent d'un modèle simplePDL}
    \label{simplePDL_EMF}
\end{figure}

\subsection{plugin petriNet}

% \begin{figure}[H]
%     \centering
%     \includegraphics[width=15cm]{petriNet_emf.png}
%     \caption{Éditeur arborecent d'un modèle petriNet}
%     \label{petriNet_EMF}
% \end{figure}

\subsection{simplePDL $\rightarrow$ petriNet (avec Java)}

\section{Transformation de modèle à texte (avec Acceleo)}

Il nous est possible de transcrire nos modèles vers d'autres formats de fichiers pour nous permettre de les utiliser dans logiciels tierces, et ainsi de les modifier/visualiser plus aisaiment.

\subsection{simplePDL $\rightarrow$ html}

Nous pouvons dans un premier temps de transformer nos modèles simplePDL selon le langage de balisage HTML.

\begin{htmlcode}
<head><title>developpement</title></head>
<body>
    <h1>Process "developpement"</h1>
    <h2>Work definitions</h2>
    <ul>
        <li>Conception</li>
        <li>
            RedactionDoc requires Conception to be finished,
            Conception to be started.
        </li>
        <li>Programmation requires Conception to be finished.</li>
        <li>
            RedactionTests requires Conception to be started,
            Programmation to be finished.
        </li>
    </ul>
</body>
\end{htmlcode}

\subsection{simplePDL $\rightarrow$ dot}

Nous pouvons de même transformer nos modèles simplePDL selon le langage de description de graphe DOT.

\begin{textcode}
digraph "developpement" {
    "Conception" -> "RedactionDoc" [arrowhead=vee label=finishToFinish]
    "Conception" -> "RedactionDoc" [arrowhead=vee label=startToStart]
    "Conception" -> "Programmation" [arrowhead=vee label=finishToStart]
    "Conception" -> "RedactionTests" [arrowhead=vee label=startToStart]
    "Programmation" -> "RedactionTests" [arrowhead=vee label=finishToFinish]
}
\end{textcode}

\subsection{petriNet $\rightarrow$ tina}

Enfin, il nous est possible de transformer nos modèles petriNet selon le language de description de réseau de Petri TINA (format .net).

\begin{textcode}
net coolNetwork
pl debut (1)
pl fin (0)
tr debut2fin debut*1 -> fin*1
\end{textcode}

\section{Définition de syntaxes concrètes graphiques (avec Sirius)}

Tout comme lors de la création d'éditeurs arborescent spécifiques à nos métamodèles (cf EMF), il nous est possible de créer des éditeurs graphiques spécifiques à nos métamodèles.

\subsection{Éditeur graphique simplePDL}

\begin{figure}[H]
    \centering
    \includegraphics[width=15cm]{simplePDL_sirius.png}
    \caption{Éditeur graphique d'un modèle simplePDL}
    \label{simplePDL_EMF}
\end{figure}

\subsection{Éditeur graphique petriNet}

\begin{figure}[H]
    \centering
    \includegraphics[width=15cm]{petriNet_sirius.png}
    \caption{Éditeur graphique d'un modèle petriNet}
    \label{petriNet_EMF}
\end{figure}

\section{Définition de syntaxes concrètes textuelles (avec Xtext)}

Dans la continuité de la création d'outils pour manipuler et visualiser nos modèles, il nous est possible de définir une styntaxe textuelle associée à nos métamodèles.

\subsection{Éditeur textuel simplePDL}

Ainsi, pour simplePDL, la syntaxe textuelle suivante permet de manipuler nos modèles, sans passer par des outils complexes générés automatiquement par Eclipse.

\begin{textcode}
process Developpement {
    res Crayon 10
    res Papier 20
    wd Conception
        req Crayon 10
        req Papier 5
    wd RedactionTest
    wd RedactionDoc
    wd Programmation
    ws f2s from Conception to Programmation
    ws s2s from Conception to RedactionTest
    ws s2s from Conception to RedactionDoc
    ws f2f from Conception to RedactionDoc
    ws f2f from Programmation to RedactionTest
}
\end{textcode}

\subsection{Éditeur textuel petriNet}

De même pour petriNet

% \begin{figure}[H]
%     \centering
%     \includegraphics[width=15cm]{petriNet_xtext.png}
%     \caption{Éditeur textuel d'un modèle petriNet}
%     \label{petriNet_xtext}
% \end{figure}

\section{Transformation de modèle à modèle (avec ATL)}

Finalement il nous est possible, tout comme lors de la transformation modèle à modèle via l'écriture d'un programme, de transformer un modèle selon un autre métamodèles via l'outil ATL.

\subsection{simplePDL $\rightarrow$ petriNet}

% \begin{figure}[H]
%     \centering
%     \includegraphics[width=15cm]{simplePDL_ATL_petriNet.png}
%     \caption{Transformation d'un modèles simplePDL en modèle petriNet via ATL}
%     \label{simplePDL_ATL_petriNet}
% \end{figure}

\end{document}