# App - Migration Nuxt 3

[![Latest Release](http://gitlab.2iopenservice.com/opentalent/app_nuxt3/-/badges/release.svg)](http://gitlab.2iopenservice.com/opentalent/app_nuxt3/-/releases)

| Branch  | Status                                                                                                                                                                         | Coverage                                                                                                                                                                       |
|---------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| master  | [![pipeline status](http://gitlab.2iopenservice.com/opentalent/app_nuxt3/badges/master/pipeline.svg)](http://gitlab.2iopenservice.com/opentalent/app_nuxt3/-/commits/master)   | [![coverage report](http://gitlab.2iopenservice.com/opentalent/app_nuxt3/badges/master/coverage.svg)](http://gitlab.2iopenservice.com/opentalent/app_nuxt3/-/commits/master)   |
| develop | [![pipeline status](http://gitlab.2iopenservice.com/opentalent/app_nuxt3/badges/develop/pipeline.svg)](http://gitlab.2iopenservice.com/opentalent/app_nuxt3/-/commits/develop) | [![coverage report](http://gitlab.2iopenservice.com/opentalent/app_nuxt3/badges/develop/coverage.svg)](http://gitlab.2iopenservice.com/opentalent/app_nuxt3/-/commits/develop) |


Frontend développé avec NuxtJs 3

A voir :

* [vuejs.org](https://vuejs.org/guide/introduction.html) : Vue est le framework de base de l'application
* [nuxtjs.org](https://nuxt.com/docs/getting-started/introduction) : Nuxt est une surcouche à Vue qui automatise et simplifie beaucoup de choses
* [pinia.vuejs.org](https://pinia.vuejs.org/introduction.html) : Store library that allow you to share a state accross your components / pages
* [pinia-orm.codedredd.de](https://pinia-orm.codedredd.de/guide/getting-started/quick-start) : Ajoute une gestion par modèles / repos au store Pinia
* [vuetifyjs.com](https://cdn.vuetifyjs.com/docs/images/logos/vuetify-logo-v3-slim-text-light.svg) : Composants graphiques préconstruits
* [typescriptlang.org](https://www.typescriptlang.org/) : Typescript
* [jestjs.io](https://jestjs.io/docs/getting-started) : Tests unitaires pour JS
* [cypress.io](https://docs.cypress.io/guides/getting-started/installing-cypress) : Tests end-to-end pour JS


## Installation (mode dev)

Cloner le projet :

    git clone git@gitlab.2iopenservice.com:opentalent/app_nuxt3.git


Installer les dépendances :

    yarn install

Créer le symlink vers le bon fichier env (remplacer `<environnement>` par l'env courant):

    ln -s .env.<environnement> .env


Copier les certificats à la racine de ce projet :

* local.app-v3.opentalent.fr.crt
* local.app-v3.opentalent.fr.key


Lancer le serveur de développement :

    yarn dev -o



## Déploiement en prod

### Premier déploiement en tant que service

On commence par cloner le projet app, puis par se placer dans le répertoire ainsi créé.

On créé un symlink vers le fichier .env.xxx voulu sous le nom de .env (selon l'environnement)

    ln -s .env.xxx .env

Pour déployer le projet en mode SSR, on commence par mettre à jour et compiler avec la commande custom :

    yarn deploy

Cette commande est un alias qui équivaut à lancer:

    git pull
    yarn install
    yarn build

### Mettre à jour

Se placer dans le répertoire de l'application, puis lancer :

    yarn deploy



## Autres

### Lancer les tests

Pour lancer les tests unitaires :

    jest

### Générer la doc

Pour régénérer la documentation automatique :

    yarn docs


## Plus d'infos

## Structure du projet

| Répertoire     | Rôle                                                                                                |
|----------------|-----------------------------------------------------------------------------------------------------|
| `assets`       | Contient les fichiers style et medias                                                               |
| `components`   | Les différents composants graphiques qui composent l'application                                    |
| `composables`  | Des fonctions conscientes du contexte applicatif, qui font le lien entre les pages et les services  |
| `config`       | La configuration de l'application                                                                   |
| `doc`          | Documentation du projet                                                                             |
| `lang`         | Les fichiers de traduction                                                                          |
| `layouts`      | Layouts des pages                                                                                   |
| `middleware`   | Code exécuté avant le rendu des pages (ex: pour vérifier l'authentification)                        |
| `models`       | Définition des entités (ou modèles)                                                                 |
| `node_modules` | Modules node installés via npm                                                                      |
| `pages`        | Définition des pages qui composent l'application                                                    |
| `plugins`      | Configuration des modules                                                                           |
| `public`       | Ressources statiques et publiques                                                                   |
| `services`     | Rassemble les classes utilitaires non graphiques et indépendantes du contexte applicatif            |
| `stores`       | Le store et ses composants servent d'entrepôt de donnés, et s'assurent de la cohérence de celles-ci |
| `tests`        | Regroupe les tests (unitaires, end-to-end...)                                                       |
| `types`        | Types Typescript (interfaces, enums...)                                                             |

