# Projets

> Créez un projet dans AI CodeOps : liez un dépôt Git ou partez de zéro, définissez la branche par défaut et la commande de test, et voyez ce qu'un projet suit dans le temps.

Source: https://aicodeops.dev/fr/docs/projects

Un projet est une base de code sur laquelle AI CodeOps travaille. Chaque session IA appartient à un projet, et le projet rassemble ce qui arrive à ce code dans le temps : sessions, changements, déploiements, incidents, SBOM et enregistrements de décision.

## Créer un projet

1. Ouvrez **Plan → Projects** et choisissez **New project**.
2. Remplissez le formulaire (champs ci-dessous).
3. Choisissez **Create project**.

| Champ                | Ce qu'il faut saisir                                                                                                                                                                                               |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Identifier**       | En minuscules, sans espaces, par exemple `billing-api`. Utilisé dans les URL et les rapports. Il ne peut pas être modifié ensuite.                                                                                 |
| **Name**             | Un nom lisible, par exemple « Billing API ».                                                                                                                                                                       |
| **Type**             | service, library, frontend, infra, data pipeline, model, docs ou other.                                                                                                                                            |
| **Repository URL**   | Facultatif. L'adresse du dépôt, par exemple `https://github.com/acme/billing-api`.                                                                                                                                 |
| **Default branch**   | Facultatif. La branche sur laquelle travaillent les sessions et le terminal. Vide signifie la branche par défaut du dépôt.                                                                                         |
| **Test command**     | Facultatif. Exécutée après qu'une session a écrit du code, sur le changement proposé, dans un environnement isolé. Vide signifie qu'elle est détectée (un script test de `package.json`, sinon pytest ou go test). |
| **Health check URL** | Facultatif. Un point de terminaison https public utilisé par la supervision.                                                                                                                                       |
| **Description**      | Facultatif.                                                                                                                                                                                                        |

### Vérifier l'accès au dépôt

Après avoir saisi l'URL d'un dépôt, choisissez **Verify access**. AI CodeOps vous indique si le dépôt est joignable, ainsi que sa branche par défaut. Si vous avez un [compte Git connecté](https://aicodeops.dev/fr/docs/git/github) pour cet hébergeur, les dépôts privés fonctionnent : « Will use your GitHub account … private repos accessible. » Sans compte connecté, les dépôts publics sont tout de même clonés, mais vous ne pouvez pas ouvrir de pull requests.

Avec un compte connecté, la vérification indique aussi si ce compte peut **pousser** vers le dépôt et y **ouvrir des pull requests**, et ce qu'il faut modifier sur votre hébergeur Git lorsqu'il ne le peut pas. Rien n'est poussé et rien n'est créé : elle interroge seulement l'hébergeur. Cela vaut la peine de le faire avant la première session, car sinon un token qui peut lire un dépôt mais pas y écrire n'échoue qu'au moment où la pull request est ouverte.

### Combien de projets vous pouvez avoir

Votre offre inclut un nombre de projets, comptés sur l'ensemble des espaces de travail de votre organisation. La page Projects affiche le décompte à côté de **New project**, par exemple « 2 of 3 used ». Lorsqu'il n'en reste aucun, la page l'indique à la place du formulaire : archivez un projet pour libérer sa place (son historique est conservé, et il peut être restauré plus tard), ou passez à une offre supérieure.

### Partir de zéro

Laissez **Repository URL** vide pour démarrer une nouvelle base de code. Les sessions génèrent alors le code source sur la plateforme, et vous pouvez le parcourir sous **Develop → Source**. Lorsque vous voulez le livrer, choisissez **Add repo** sur le projet et saisissez un dépôt ; les changements suivants peuvent alors être ouverts sous forme de pull requests.

### Désactiver les tests

Cochez **Don't run tests for this project** s'il n'a pas de suite de tests. Les sessions ignorent alors l'étape de test, et la page de l'exécution indique que le changement n'a pas été vérifié. C'est aussi ainsi que vous indiquez à la barrière de livraison de ne pas demander de résultat de test. Sans cela, une session qui a modifié du code et n'a pas de résultat de test avec des décomptes est refusée. Consultez [Barrières qualité](https://aicodeops.dev/fr/docs/quality-gates).

## La page du projet

Ouvrez un projet pour voir :

- **Deployments**, **Open incidents**, **Vulnerable components (latest SBOM)** et **Recent ADRs** en un coup d'œil ;
- une chronologie **Activity** des sessions, des déploiements, des incidents et des décisions ;
- **Recent deployments** et **Recent SBOMs**.

De là, vous pouvez choisir **Run workflow** (décrire une tâche et lancer une session sur ce projet), **Browse source**, **Edit** pour modifier le projet, ou **Archive** pour l'archiver.

Les projets qui apparaissent dans vos SBOM, vos enregistrements de décision ou vos incidents mais ne sont pas encore configurés figurent sous **Detected projects** dans la liste des projets, prêts à être ajoutés.

## Archiver et restaurer

**Archive** masque un projet de la liste active. Son historique est conservé, mais vous ne pouvez plus exécuter de sessions dessus. Les projets archivés sont listés sous **Archived**, avec **Restore** pour en rétablir un.

## Étapes suivantes

- [Lancer une session](https://aicodeops.dev/fr/docs/sessions)
- [Connecter un hébergeur Git](https://aicodeops.dev/fr/docs/git/github)
- [Sécurité et SBOM](https://aicodeops.dev/fr/docs/security-and-sbom)

## Questions fréquentes

### Puis-je créer un projet sans dépôt ?

Oui. Laissez l'URL du dépôt vide et le code généré par la session reste sur la plateforme. Ajoutez un dépôt plus tard pour le livrer sous forme de pull request.

### Puis-je supprimer un projet ?

Vous pouvez l'archiver. Un projet archivé est masqué et ne peut pas exécuter de sessions, mais son historique est conservé et vous pouvez le restaurer.
