Skip to content

Latest commit

 

History

History
341 lines (247 loc) · 11.9 KB

vue-architecture-applicative.adoc

File metadata and controls

341 lines (247 loc) · 11.9 KB

Vue architecture applicative

Dernière modification : 2024-09-28

Date dernière revue globale : <Faire régulièrement des revues globale de la vue (au moins une fois par an tant que le projet est actif) et mentionner la date ici>

Statut du document : <Donner ici le statut de la vue, par exemple 'DRAFT', 'FINALISÉ',…​>

1. Introduction

Ceci est la vue applicative du projet. Elle décrit les modules applicatifs en jeu et leurs échanges.

Les autres vues du dossier sont accessibles d’ici.

Le glossaire du projet est disponible ici. Nous ne redéfinirons pas ici les termes fonctionnels ou techniques utilisés.

1.1. Documentation de Référence

Mentionner ici les documents d’architecture de référence (mutualisés). Ce dossier ne doit en aucun cas reprendre leur contenu sous peine de devenir rapidement obsolète et inmaintenable.

Table 1. Références documentaires
Version Titre/URL du document Détail

1

2.0.4

XX_Urba_POS.pdf

POS du SI

2. Non statué

2.1. Points soumis à étude complémentaire

Table 2. Points soumis à étude complémentaire
Sujet Détail Statut Porteur du sujet Échéance

Utilisation des services Y

En fonction de l’avancement du projet Y, ce composant pourrait appeler les services de ce dernier ou ceux de l’ancien composant Z

EN_ATTENTE

Projet Y

AVANT 2040

2.2. Hypothèses

Table 3. Hypothèses
ID Détail

HA1

Même si la décision de généralisation de l’annuaire centralisé n’est pas totalement entérinée, l’application s’appuiera dessus et non sur un annuaire local.

3. Contexte général

3.1. Objectifs

Tip
Décrire succinctement le projet et en rappeler les objectifs. Mettre en évidence ceux qui sont structurants pour l’architecture.

Exemple 1 : Cette application doit permettre la dématérialisation des factures reçues de nos fournisseurs et une consultation aisée de ces documents par les services comptables.

Exemple 2 : ce projet est la réécriture en technologies Web de l’application Cobol X. Elle doit en faciliter la maintenance.

Exemple 3: l’ application X est l’un des composants principaux du programme Y. Il s’adosse sur les référentiels Personne et Facturation pour enrichir le CMS en données clients temps réel.

3.2. Existant

Tip
Si ce document présente un projet de refonte ou migration, décrire a minima l’application existante. Ne pas reprendre la documentation, y faire simplement référence et pointer vers son éventuel dossier d’architecture. Mentionner néanmoins toute information ayant un impact fort sur la migration ou la conception du nouveau projet.

Exemple 1 : L’application VENIR2 est une application Client-Server en FORMS 4 pointant vers une base Oracle 9i. Son dossier d’architecture est donné en [REFxyz].

Exemple 2 : L’application existante se base et alimente un annuaire LDAP pour ses autorisations. Le nouveau projet devant fonctionner un temps avec l’ancienne, il convient de prendre en compte les accès concurrents et la cohérence du LDAP pendant la période de tuilage.

3.3. Positionnement dans le SI

Tip
Si le SI est urbanisé, reprendre le plan d’occupation au sol et préciser le bloc concerné

3.4. Acteurs

3.4.1. Acteurs internes

Tip
On entend par ‘internes’ les acteurs appartenant à l’organisation. Il peut s’agir d’humains ou de composants applicatifs.
Table 4. Liste des acteurs internes
Acteur Description Population Localisation

Système de l’administration B

fournit les données comptables des entreprises

N/A

Site de Berlin

Agent

Agent back-office

100

Site de Paris

3.4.2. Acteurs externes

Table 5. Liste acteurs externes
Acteur Description Population Localisation

Client Web

Une entreprise depuis un PC

Max 1M

10 appels à l’IHM par session, une session par jour et par acteur

Client mobile

Une entreprise depuis un mobile

Max 2M

Monde entier

4. Contraintes

4.1. Budget

Tip
Donner les contraintes budgétaires du projet

Exemple 1: Enveloppe globale de 1 M€

Exemple 2: Coûts d’infrastructure cloud < 20K€ / mois

4.2. Planning

Tip
Sans reprendre dans le détail les plannings du projet, donner les éléments intéressants pour l’architecture.

Exemple 1: MEP avant fev 2034, prérequis au programme HEAVY en mai 2034.

4.3. Urbanisation

Tip

Lister ici les contraintes relatives à l’urbanisation, ceci inclut par exemple mais pas seulement :

  • Les règles applicables dans les appels entre composants (SOA)

  • Les règles d’appels entre zones réseau

  • Les règles concernant la localisation des données (MDM)

  • Les règles concernant la propagation des mises à jours par événements (EDA)

Exemple 1 : les appels inter-services sont interdits sauf les appels de services à un service de nomenclature.

Exemple 2 : pour en assurer la fraicheur, il est interdit de répliquer les données du référentiel PERSONNE. Ce dernier devra être interrogé au besoin en synchrone.

Exemple 3 : Lors de la modification d’une commande, les zones comptabilité et facturation seront mises à jour de façon asynchrone via un événement.

Exemple 4 : tous les batchs doivent pouvoir fonctionner en concurrence des IHM sans verrouillage des ressources.

Exemple 5 : les services ne peuvent être appelés directement. Les appels se feront obligatoirement via une route exposée au niveau du bus d’entreprise qui appellera à son tour le service. Il est alors possible de contrôler, prioriser, orchestrer ou piloter les appels.

Exemple 6 : Les composants de cette application suivent l’architecture SOA telle que définie dans le document de référence X.

Exemple 7 : Les composants en zone Internet ne peuvent appeler les composants en zone Intranet pour des raisons de sécurité.

4.4. Juridique

Lister ici (sans détailler) les éventuelles contraintes juridiques liées au projet.

Exemple 1 : Le contrat cadre établi avec l’ESN XYZ prévoit de transférer à notre société les droits patrimoniaux du code source.

Exemple 2 : Le code du projet sera en licence libre et open source GPL V3.

Exemple 3 : Les données produites par le projet seront en licence Ouverte version 2.0.

Exemple 4 : Le CLUF du progiciel prévoit un accès aux sources des utilisateurs ayant des parts dans la société.

5. Exigences

Tip
Donner ici les exigences d’architecture applicative pouvant s’appliquer au projet.

Exemple 1 (projet de migration) : Les modules legacy devront faire l’objet d’aussi peu d’adaptations que possible.

Exemple 2 : Les modules devront pouvoir s’interfacer avec le partenaire XYZ via leurs API.

Exemple 3 : Le développement devra pouvoir se faire au sein d’équipes distribuées, chacune travaillant sur des modules distincts.

6. Architecture cible

6.1. Architecture applicative générale

Tip

Présenter ici l’application dans son ensemble (sans détailler ses sous-composants) en relation avec les autres applications du SI. Présenter également les macro-données échangées ou stockées.

Rappeler :

  • Le type d’architecture (client-serveur, Web monolithique, SOA, micro-service…).

  • Les grands flux entre les composants ou entre les applications dans le cas des monolithes.

  • D’éventuelles dérogations aux règles d’architecture du SI.

Si l’application est prévue pour être implémentée en plusieurs étapes, décrire succinctement la trajectoire cible.

Tip

Le choix de la représentation est libre mais un diagramme C4 de System Landscape ou un diagramme de composant UML2 semble le plus adapté.

Numéroter les étapes par ordre chronologique assure une meilleure compréhension du schéma. Grouper les sous étapes par la notation x, x.y, x.y.z, …

Ne pas faire figurer les nombreux systèmes d’infrastructure (serveur SMTP, dispositif de sécurité, reverse proxy, annuaires LDAP, …) qui sont du domaine de l’architecture technique. Mentionner en revanche les éventuels bus d’entreprise qui ont un rôle applicatif (orchestration de service par exemple).

Exemple 1 : MesInfosEnLigne permet à une entreprise de récupérer par mail un document récapitulant toutes les informations dont l’administration dispose sur elle. L’administration peut compléter ses données par celles d’une autre administration.

Exemple 2 : MesInfosEnLigne est constituée de plusieurs microservices indépendants (composants IHM, batchs ou services REST)

Exemple 3 : Suite à la dérogation du DSI le 03 aout 20xx, l’IHM sera en architecture SPA (Single Page Application)

Diagramme architecture applicative générale

6.2. Architecture applicative détaillée

Tip

Détailler ici tous les composants de l’application, leurs flux entre eux et avec les autres applications du SI.

Proposer un ou plusieurs schémas (de préférence des diagrammes C4 de type containers ou diagramme UML2 de composant).

Idéalement, le schéma tiendra sur une page A4, sera autoporteur et compréhensible par un non-technicien. Il devrait devenir l’un des artefacts documentaires les plus importants et figurer dans la war room d’un projet agile ou être imprimé par chaque développeur.

Si l’application est particulièrement complexe, faire un schéma par chaîne de liaison.

Utiliser comme ID des flux une simple séquence non signifiante (1, 2, …, n). Les flux sont logiques et non techniques (par exemple, on peut représenter un flux HTTP direct entre deux composants alors qu’en réalité, il passe par un répartiteur de charge intermédiaire : ce niveau de détail sera donné dans la vue infrastructure).

Pour chaque flux, donner le protocole, un attribut synchrone/asynchrone, un attribut lecture/écriture/exécution et une description pour que le schéma soit auto-porteur.

6.3. Principes ayant dicté les choix

Tip

Donner ici l’intention dans la construction de l’architecture.

Exemple : nous utiliserons une approche monolithique et non micro-service par manque d’expertise.

6.4. Vision statique

Tip

Exposer les modules applicatifs dans leurs différentes zones ou domaines.

Exemple: module X, Y et Z dans le domaine GED. Modules A, B dans le domaine PERSONNE.

Diagramme d’Architecture applicative détaillée (vue statique)

6.5. Vision dynamique

Tip

Exposer les modules applicatifs dans leurs différentes zones ou domaines avec leurs flux applicatifs principaux.

Ne pas détailler les flux techniques (comme les flux liés à la supervision ou au clustering).

Si l’application est complexe, proposer un schéma global exposant tous les flux applicatifs puis un schéma par chaîne de liaison principale en numérotant les échanges (utiliser un diagramme de séquence ou (mieux) un Dynamic Diagram C4). Il est possible également de détailler les chaînes de liaison par fonctionnailité principale.

Exemple:

Diagramme architecture applicative détaillée (vue dynamique)

6.6. Matrice des flux applicatifs

Tip

Lister ici les flux principaux de l’application.

Ne pas détailler les flux techniques de supervision ou liés au clustering par exemple. Mentionner le type de réseau (LAN, WAN).

Table 6. Exemple partiel de matrice de flux applicatifs
Source Destination Type de réseau Protocole Mode.[1]

Entreprise

PC/tablette/mobile externe

ihm-miel

WAN

LE

batch-traiter-demandes

service-compo-pdf

HTTP

LAN

A


1. (L)ecture, (E)criture ou Lecture/Ecriture (LE), (A)ppel (vers un système stateless)