Sen descrición

Olivier Massot 0d43693773 Merge branch 'feature/V8-4132-CI' into develop		%!s(int64=2) %!d(string=hai) anos
assets	514994d3d8 revue de code	%!s(int64=2) %!d(string=hai) anos
components	d08d3b3bf3 add arrayUtils.test.ts, revise ArrayUtils, refact dateUtils	%!s(int64=2) %!d(string=hai) anos
composables	662e88eeb8 reorganize menuBuilder services and add menuComposer.test.ts	%!s(int64=2) %!d(string=hai) anos
config	08a1e05a37 rights configuration refactoring	%!s(int64=2) %!d(string=hai) anos
doc	74c54dde42 upgrade vitest, complete config and add doc	%!s(int64=2) %!d(string=hai) anos
lang	7926f629a1 complete subheader (historical, lists) and various fixes	%!s(int64=3) %!d(string=hai) anos
layouts	66f8eaf400 post refactoring import fixes	%!s(int64=2) %!d(string=hai) anos
middleware	a353618569 v4027 Review todos, .env.local becomes .env.docker	%!s(int64=3) %!d(string=hai) anos
models	7c2a602fa6 add entityManager.test.ts	%!s(int64=2) %!d(string=hai) anos
pages	099297b178 rename service Url into UrlUtils, refactor HydraDenormalizer	%!s(int64=2) %!d(string=hai) anos
plugins	1c2d381194 move content of AbilityBuilder.setupAbilities into the ablity plugin	%!s(int64=2) %!d(string=hai) anos
public	3f16ce8b8c v8-3565 nuxt3 upgrade and partial restoration of organization page	%!s(int64=3) %!d(string=hai) anos
services	62e305d67f add enumManager.test.ts and imageManager.test.ts	%!s(int64=2) %!d(string=hai) anos
stores	1c2d381194 move content of AbilityBuilder.setupAbilities into the ablity plugin	%!s(int64=2) %!d(string=hai) anos
tests	62e305d67f add enumManager.test.ts and imageManager.test.ts	%!s(int64=2) %!d(string=hai) anos
types	662e88eeb8 reorganize menuBuilder services and add menuComposer.test.ts	%!s(int64=2) %!d(string=hai) anos
.env.docker	514994d3d8 revue de code	%!s(int64=2) %!d(string=hai) anos
.env.preprod	a353618569 v4027 Review todos, .env.local becomes .env.docker	%!s(int64=3) %!d(string=hai) anos
.env.prod	a353618569 v4027 Review todos, .env.local becomes .env.docker	%!s(int64=3) %!d(string=hai) anos
.env.test	a353618569 v4027 Review todos, .env.local becomes .env.docker	%!s(int64=3) %!d(string=hai) anos
.eslintrc.cjs	d4019bd3db rewrite data services (ongoing)	%!s(int64=3) %!d(string=hai) anos
.gitignore	93fe0f054a update readme	%!s(int64=2) %!d(string=hai) anos
.gitlab-ci.yml	93fe0f054a update readme	%!s(int64=2) %!d(string=hai) anos
.npmrc	514994d3d8 revue de code	%!s(int64=2) %!d(string=hai) anos
.prettierrc	d4019bd3db rewrite data services (ongoing)	%!s(int64=3) %!d(string=hai) anos
README.md	93fe0f054a update readme	%!s(int64=2) %!d(string=hai) anos
app.vue	dd15fcee93 Menu	%!s(int64=3) %!d(string=hai) anos
logo.png	d4019bd3db rewrite data services (ongoing)	%!s(int64=3) %!d(string=hai) anos
nuxt.config.ts	c5de262f34 Merge branch 'develop' of	%!s(int64=2) %!d(string=hai) anos
package-lock.json	514994d3d8 revue de code	%!s(int64=2) %!d(string=hai) anos
package.json	74c54dde42 upgrade vitest, complete config and add doc	%!s(int64=2) %!d(string=hai) anos
tsconfig.json	685085c2e4 add unit tests and minor fixes	%!s(int64=2) %!d(string=hai) anos
vitest.config.ts	ae7aeb4270 fix CI config and allow empty unit test to pass	%!s(int64=2) %!d(string=hai) anos
yarn.lock	74c54dde42 upgrade vitest, complete config and add doc	%!s(int64=2) %!d(string=hai) anos

App - Migration Nuxt 3

Branch	Status	Coverage
master
develop

Frontend développé avec NuxtJs 3

A voir :

vuejs.org : Vue est le framework de base de l'application
nuxtjs.org : Nuxt est une surcouche à Vue qui automatise et simplifie beaucoup de choses
pinia.vuejs.org : Store library that allow you to share a state accross your components / pages
pinia-orm.codedredd.de : Ajoute une gestion par modèles / repos au store Pinia
vuetifyjs.com : Composants graphiques préconstruits
typescriptlang.org : Typescript
jestjs.io : Tests unitaires pour JS
cypress.io : 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...)

README.md