---
title: Lancement du projet
slug: oip-next/v3/lancement-du-projet
icon: {"lucideIcon":"📘"}
createdAt: 2025-10-15T08:57:58.000Z
---

# Démarrer le projet en local

Ce template nécessite les services suivants :

- Une base de données **MongoDB**&#x20;
- Le service **fasst-sessions,** pour assurer le bon fonctionnement des sessions&#x20;
- Un service **RabbitMQ,** requis pour le support des **subscriptions GraphQL**

Le fichier `docker-compose.yml` situé à la racine de ce repository expose ces services.
Vous êtes libre de l’utiliser tel quel ou de configurer votre environnement local selon vos préférences.&#x20;

## Variables d'environnement

```bash
cp .env.dist .env
```

### Variables générales

| **Variable** | **Description**                                                                                                                                |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| ROOT\_DIR    | chemin du répertoire racine du projet, utilisé comme base pour les chemins relatifs.<br /><br />**Valeur par défaut** : . (répertoire courant) |
| PORT         | numéro du port sur lequel le serveur écoute les requêtes entrantes.                                                                            |
| NODE\_ENV    | définit l’environnement d’exécution de l’application.                                                                                          |

### Variables demandées par l'OIP Core

| **Variable**        | **Description**                                                                  |
| ------------------- | -------------------------------------------------------------------------------- |
| OIP\_WORK\_DIR      | Chemin relatif vers le répertoire de travail utilisé par **OIP Core**.           |
| OIP\_MONGO\_DB\_URL | URL de connexion à la base de données **MongoDB** utilisée par l’application.    |
| CIPHER\_IV          | Vecteur d’initialisation utilisé par l’algorithme de chiffrement d’**OIP Core**. |
| CIPHER\_KEY         | Clé de chiffrement utilisée par l’algorithme de sécurité d’**OIP Core**.         |

### Variables liées à la logique de session

| **Variable**                | **Description**                                                                                                                                                                                                              |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| SESSIONS\_SERVICE\_URL      | URL du service **fasst-sessions**, utilisé pour la gestion des sessions utilisateur.                                                                                                                                         |
| SESSION\_COOKIE\_MAX\_AGE   | Durée de validité du cookie d’authentification, exprimée en minutes.<br />**Valeur par défaut&#x20;**: 60<br />                                                                                                              |
| SESSION\_SECRET             | Chaîne secrète utilisée pour signer l’ID du cookie de session (HMAC).                                                                                                                                                        |
| SESSION\_CHECKING\_DISABLED | Si cette variable est définie à true, la vérification du token auprès du service **fasst-sessions&#x20;**&#x65;st désactivée.<br />\&#xNAN;**⚠️ À utiliser uniquement en environnement de développement ou pour des tests.** |

### Variables liées à la logique d'authentification

| **Variable**  | **Description**                                        |
| ------------- | ------------------------------------------------------ |
| API\_USER\_ID | Variable nécessaire pour la logique d'authentification |
| API\_KEY      | Variable nécessaire pour la logique d'authentification |
| API\_KEYS     | Variable nécessaire pour la logique d'authentification |
| JWT\_SECRET   | Variable nécessaire pour la logique d'authentification |

### Variables demandées par l'OIP Tools

| **Variable**                                                    | **Description**                      |
| --------------------------------------------------------------- | ------------------------------------ |
| `TOKEN_READONLY_OIP_API`<br />ou<br />`OIP_TOOLS_CLIENT_SECRET` | Variable requise par OIP Tools<br /> |

### Variables liées à la logique de connexion à RabbitMQ

| **Variable**            | **Description**                        |
| ----------------------- | -------------------------------------- |
| RABBIT\_MQ\_QUEUE\_NAME | Le nom de la queue                     |
| RABBIT\_MQ\_HOST        | Nom de l'host                          |
| RABBIT\_MQ\_VHOST       | Nom du virtual host                    |
| RABBIT\_MQ\_UI\_PORT    | Port d'écoute de l'interface graphique |
| RABBIT\_MQ\_USER        | Le nom de l'utilisateur                |
| RABBIT\_MQ\_PASSWORD    | Le mot de passe                        |

## Démarrer le server en local

Depuis la racine du projet :

```bash
npm run server:dev
```

## Démarrer l'application en local

Depuis la racine du projet :

```bash
npm run front:dev
```

URL par défaut : `http://localhost:8000`

## Build des views

Depuis la racine du repository

```bash
npm run views:build
```

## Initialiser une session

**En local, pour désactiver la vérification du token auprès du service fasst-sessions, définissez la variable d'environnement SESSION\_CHECKING\_DISABLED sur true**

Générez un token depuis le service `fasst-sessions`, exemple :

```bash
curl --request POST \
  --url http://localhost:3000/api/sessions/tokens \
  --header 'Content-Type: application/json' \
  --data '{
  "applicant": "magic",
  "metadata": {
    "externalId": "project-AAA"
  }
}'
```

Ensuite, insérez le jeton reçu en paramètre dans l’URL de l’application, comme suit : `http://localhost:8000/?token=my-beautiful-token`

Et voilà ! Votre session est désormais initialisée, vous êtes prêt à naviguer dans votre parcours.
