# Projet et étapes

> Statuts d'un projet, types et statuts d'étape, jalons, exigences documentaires et calcul de l'avancement.

Un projet d'accompagnement est une suite d'étapes que Wakastellar et votre équipe franchissent ensemble. Cette page décrit les objets que vous voyez dans la console et les règles qui les relient.

## Définition

Un **projet** est un projet de réalisation mené par Wakastellar pour votre entreprise, rattaché à votre organisation de [propriétaire](/v1.0/glossaire#propriétaire). Il porte un nom, une description, un statut et une date de signature du contrat.

Une **étape** est une phase du projet. Elle a un ordre, un type, un statut, des acteurs impliqués et, parfois, une date cible.

Une **exigence documentaire** est un document attendu pour une étape : son nom, son caractère obligatoire ou facultatif, et les formats de fichier acceptés.

```mermaid
flowchart TD
  P["Projet"] --> S1["Étape d'avancement"]
  P --> S2["Jalon<br/>date cible"]
  S1 --> R1["Exigence obligatoire<br/>ex. Cahier de recette (PDF)"]
  S1 --> R2["Exigence facultative"]
  R1 --> D1["Document déposé<br/>version 1, 2…"]
  S1 --> C["Commentaires"]
  S1 --> T["Temps saisi"]
```

## Pourquoi ce découpage

Un projet de réalisation avance par livrables successifs, et chaque livrable demande souvent une pièce de votre part : validation d'une maquette, signature d'un procès-verbal. Rattacher les documents aux étapes rend visible ce qui bloque, et empêche de clore une phase sans ses justificatifs.

## Comment ça marche

### Le statut du projet

| Statut | Signification |
|---|---|
| **Brouillon** | Projet en préparation |
| **Actif** | Projet en cours |
| **Terminé** | Projet livré |
| **Archivé** | Projet clos, masqué par défaut de la liste |
| **Annulé** | Projet arrêté |

### Les types d'étape

| Type | Usage |
|---|---|
| **Étape d'avancement** | Phase de travail, sans date imposée |
| **Jalon** | Échéance datée : sa date cible est fixée, ou calculée à partir de la date de signature du contrat et d'un délai en jours |

### Le statut d'une étape

| Statut | Signification |
|---|---|
| **En attente** | L'étape n'a pas commencé |
| **En cours** | L'étape est l'étape active du projet |
| **Terminé** | L'étape a été validée |
| **Terminé en retard** | L'étape a été validée après sa date cible |
| **Alerte** | Un risque a été signalé sur l'étape |
| **Bloqué** | L'étape ne peut pas avancer |

Une étape validée après sa date cible passe automatiquement en **Terminé en retard**, même si la validation demandait **Terminé**.

### La règle des documents obligatoires

Une étape ne peut être validée que si chacune de ses exigences obligatoires a reçu au moins un document. Sinon, la validation est refusée et la console liste les documents manquants. Les exigences facultatives n'empêchent rien.

Si Wakastellar met à jour le modèle du projet, une exigence peut devenir **historique** : elle n'est plus demandée, mais le document déjà fourni reste visible.

### L'avancement

L'avancement d'un projet est le pourcentage d'étapes au statut **Terminé** ou **Terminé en retard**, arrondi à l'unité. Un projet de huit étapes dont six sont validées affiche 75 %.

### Les notifications

Quand le statut d'une étape change, ou qu'un document est déposé, un e-mail part vers les acteurs actifs du projet qui tiennent le rôle de chef de projet Wakastellar ou de contact principal côté client.

## Exemples

- **Recette d'une application** : l'étape « Recette » exige un cahier de recette signé, en PDF. Tant qu'il n'est pas déposé, le bouton de validation reste inactif et la timeline affiche « 1 manquant ».
- **Mise en production datée** : le jalon « Mise en production » a une date cible au 15 décembre ; validé le 18, il apparaît en **Terminé en retard**.

## Pour aller plus loin

- [Équipe et rôles](/v1.0/accompagnement-projet/equipe-et-roles)
- [Valider une étape](/v1.0/accompagnement-projet/valider-une-etape)
- [Référence de l'accompagnement projet](/v1.0/accompagnement-projet/reference)
