---
title: Comprendre le dossier server
slug: oip-project-starter-v2/comprendre-le-dossier-server
description: This document offers comprehensive insights into the server setup and initialization process, database configuration, OIP Core configuration, GraphQL layer setup, and session and process logic. It also provides step-by-step instructions on launching the s
icon: 📁
createdAt: 2023-08-17T13:00:24.823Z
---

Le dossier `server` contient le server. Son point d'entrée est `app.mjs`.&#x20;Le serveur est lancé depuis le fichier `server/bin/www.mjs`.

### Database

Le server nécessite une db mongo. Exemple d'un `docker-compose.yml` pour un environnement de développement :

```yaml
version: '3.1'
services:
  mongo:
    container_name: mongodb
    image: mongo
    restart: always
    ports:
      - "27017:27017"
```

Mettre à jour la variable d'env de l'url mongo dans `.env` en fonction de l'implementation de la db, exemple :

```text
MONGO_DB_URL=mongodb://localhost:27017/fasst-oav-oip
```

### Logique d'initialisation du server

Dans `app.js` :

- initialisation du server express
- initialisation de la connexion à la db mongo
- initialisation de la logique de session. Utilise le package npm `express-session`.  &#x20;À chaque nouvelle session, un cookie est généré et une nouvelle session est créée dans  &#x20;la collection `sessions` en db.
- initialisation de l'**OIP Core**
- initialisation des routes déclarées dans le fichier `server/routes.mjs` et le dossier `server/routes/`
- initialisation du server graphql depuis `server/graphql/initGraphql.mjs`

### Configuration de l'OIP Core

Le fichier de configuration de l'OIP Core `oip.config.mjs` se trouve à la racine du projet.

```javascript
import { viewIds, actionIds } from './views/ids.mjs';
import { pubsub } from './server/graphql/initGraphql.mjs';

export default {
  debug: true,
  database: {
    url: process.env.MONGO_DB_URL
  },
  rabbitMQ: {
    name: 'fasst-oip-core'
  },
  views: {
    config: 'viewsConfig',
    viewIds,
    actionIds
  },
  pubsub
};

```

**Voir la [documentation](https://doc.fasst.tech/oip-core/configuration) de l'OIP Core pour plus de détails concernant sa configuration.**

### Layer graphql

Le dossier `server/graphql` contient la déclaration des types et des resolvers graphql.&#x20;

Voir le fichier `initGraphql.mjs` pour la logique d'initialisation du server graphql.&#x20;

Utilisez le package npm `apollo-server-express`.

Chaque resolver reçoit en paramètre un objet `context` qui contient :

```typescript
{
  // le current process résolu par l'OIP Core
  process: Process;
  // l'id de la session en cours lié au current process
  sessionId: string;
}
```

Le resolver `graphql/resolver/ProcessResolver.mjs` résout les queries et mutations liées au `process`.&#x20;Elles font appel aux **controllers** de l'**OIP Core** pour get ou altérer les données au niveau de la collection `processes`&#x20;en db.

### Logique de process / session

`req` exposé par express contient un objet `session` et son id `session.id`.&#x20;

Cet objet `session` est généré et set&#x20;dans `req` grâce au middleware `app.use(session(sess))` dans la fonction `initApp()` dans le fichier `app.js`.&#x20;

Un second middleware dans le fichier `server/routes.mjs` set `sessionId` dans `req.data` à partir de `req.session.id`.&#x20;

Enfin côté OIP Core, un middleware sur l'endpoint `/graphql` ajoute le `process` courant résolu également&#x20;dans `req.data`. Voir le fichier `src/routes/index.mjs` de l'OIP Core.

Lors de l'initialisation de `apolloServer`, fichier `graphql/initGraphql.mjs`, le `context` graphql est alors défini&#x20;grâce à `req.data.sessionId` et `req.data.process`.

### Lancer le server en mode dev

```shell
$> yarn server:dev
```

##

