Projets
Les dépôts opérés par les agents : type, composants, livraison, hébergement.
Un projet est un dépôt git opéré par les agents de l'espace. Il porte tout ce qu'il faut pour travailler dessus : où est le code, sur quelle branche, comment un changement est livré, et où il est déployé.
Types de projet
| Type | Usage | Ce que ça change |
|---|---|---|
| Landing page | Un site vitrine. | Livraison par commit direct par défaut, déploiement Vercel, pas de backlog ni de versions. |
| Application | Une application avec du code à faire relire. | Livraison par merge request par défaut, hébergement Upsun, onglets Backlog, Versions et Documentation. |
| Autre | Tout autre dépôt. | Les onglets Backlog et Versions sont présents ; la Documentation apparaît dès qu'un dossier est configuré. |
Le type est déclaré dans les réglages du projet. Il n'est jamais déduit du mode de livraison.
Créer un projet
Un administrateur crée un projet depuis la page Projets. Deux choix se font à la création :
- Dépôt git : le mien (le client apporte un dépôt existant et un jeton qui l'atteint), ou hébergé par ERHA (ERHA crée le dépôt sur son GitLab).
- Hébergement : aucun, le mien, ou par ERHA. Une landing hébergée par ERHA part sur Vercel et passe en ligne dès la fin de la mise en place. Une application passe par un abonnement Upsun : le projet reste en attente le temps que l'équipe ERHA l'ouvre.
Le projet démarre en préparation, puis passe en mise en place, en attente, en ligne, ou en incident.
Réglages du projet
L'onglet Réglages est réservé aux administrateurs.
Source
Le fournisseur git (GitLab, cloud ou auto-hébergé, ou GitHub), le jeton d'accès, le dépôt et la branche cible. Le jeton est vérifié à l'enregistrement et gardé côté serveur : il n'est jamais renvoyé au navigateur. Le dépôt et la branche se choisissent dans ce que le jeton peut atteindre.
Livraison
- Type : landing page, application, autre.
- Mode de livraison : commit direct sur la branche cible, ou merge request. Ce mode s'applique à tout ce qui écrit dans le dépôt : les tâches confiées aux agents, les articles du blog, les pages de documentation.
- Environnement de test : quand la case est cochée, chaque changement déploie un environnement jetable (environnement Upsun ou preview Vercel) avant d'être fusionné.
Composants
Un projet possède au moins un composant : le composant principal, qui est le projet lui-même. D'autres composants découpent le dépôt en unités que les agents opèrent séparément : une application web, une API, une application mobile, une bibliothèque partagée.
Chaque composant porte :
- un type (landing, application, API, mobile, bibliothèque, autre) ;
- sa place dans git : le dépôt du projet ou un autre dépôt atteignable avec le même jeton, une branche, un dossier racine (le cas monorepo) ;
- le nom de son package npm pour une bibliothèque ;
- les composants qu'il utilise, par exemple l'API qu'il appelle ou la bibliothèque qu'il importe ;
- un dossier de blog, qui active l'onglet Blog ;
- un dossier de documentation, qui active l'onglet Documentation ;
- un Storybook, pour une bibliothèque de composants : ERHA le construit et le sert lui-même sur un lien privé, sans hébergement à votre charge. La branche cible est construite à chaque livraison, une merge request a sa propre page, et vous pouvez en demander une sur n'importe quelle branche. ERHA garde la branche cible plus les trois branches lues le plus récemment ; les autres sont retirées, et une reconstruction les remet.
Câblage
Une lecture seule de ce qui est branché : source, dépôt, fournisseur de déploiement, domaine, statut. Un bouton relance la mise en place si elle a échoué.
Les onglets d'un projet
| Onglet | Contenu |
|---|---|
| Aperçu | Les branches de travail du dépôt et les derniers déploiements. |
| Tâches | Le tableau des tâches du projet, décrit page Tâches. |
| Blog | Les articles du dossier de blog, lus depuis le dépôt. Un nouvel article ou une modification est une tâche confiée à l'agent. |
| Documentation | Les pages markdown du dossier de documentation, lues et éditées depuis ERHA. |
| Storybook | Les pages Storybook construites par ERHA, une par branche. Ouvrir, reconstruire, copier le lien à partager. |
| Backlog | Les epics et leurs tâches. |
| Versions | Ce qui part ensemble, et quand, avec des notes de version générées. |
| Réglages | Les réglages décrits plus haut. |
Le sélecteur en haut de page passe d'un projet à l'autre. Les agents assignés au projet sont affichés à droite : un clic ouvre la conversation.