Nav apraksta

Olivier Massot 7a4cad7cf8 Merge branch 'develop' of git@gitlab.2iopenservice.com:opentalent/app_nuxt3.git into develop		2 gadi atpakaļ
assets	514994d3d8 revue de code	2 gadi atpakaļ
components	cd0a29396c import models	2 gadi atpakaļ
composables	662e88eeb8 reorganize menuBuilder services and add menuComposer.test.ts	2 gadi atpakaļ
config	08a1e05a37 rights configuration refactoring	2 gadi atpakaļ
doc	74c54dde42 upgrade vitest, complete config and add doc	2 gadi atpakaļ
lang	7926f629a1 complete subheader (historical, lists) and various fixes	3 gadi atpakaļ
layouts	66f8eaf400 post refactoring import fixes	2 gadi atpakaļ
middleware	a353618569 v4027 Review todos, .env.local becomes .env.docker	3 gadi atpakaļ
models	cd0a29396c import models	2 gadi atpakaļ
pages	cd0a29396c import models	2 gadi atpakaļ
plugins	1c2d381194 move content of AbilityBuilder.setupAbilities into the ablity plugin	2 gadi atpakaļ
public	3f16ce8b8c v8-3565 nuxt3 upgrade and partial restoration of organization page	3 gadi atpakaļ
services	cd0a29396c import models	2 gadi atpakaļ
stores	1c2d381194 move content of AbilityBuilder.setupAbilities into the ablity plugin	2 gadi atpakaļ
tests	62e305d67f add enumManager.test.ts and imageManager.test.ts	2 gadi atpakaļ
types	662e88eeb8 reorganize menuBuilder services and add menuComposer.test.ts	2 gadi atpakaļ
.env.docker	514994d3d8 revue de code	2 gadi atpakaļ
.env.preprod	a353618569 v4027 Review todos, .env.local becomes .env.docker	3 gadi atpakaļ
.env.prod	a353618569 v4027 Review todos, .env.local becomes .env.docker	3 gadi atpakaļ
.env.test	a353618569 v4027 Review todos, .env.local becomes .env.docker	3 gadi atpakaļ
.eslintrc.cjs	d4019bd3db rewrite data services (ongoing)	3 gadi atpakaļ
.gitignore	93fe0f054a update readme	2 gadi atpakaļ
.gitlab-ci.yml	93fe0f054a update readme	2 gadi atpakaļ
.npmrc	514994d3d8 revue de code	2 gadi atpakaļ
.prettierrc	d4019bd3db rewrite data services (ongoing)	3 gadi atpakaļ
README.md	93fe0f054a update readme	2 gadi atpakaļ
app.vue	dd15fcee93 Menu	3 gadi atpakaļ
logo.png	d4019bd3db rewrite data services (ongoing)	3 gadi atpakaļ
nuxt.config.ts	cd0a29396c import models	2 gadi atpakaļ
package-lock.json	514994d3d8 revue de code	2 gadi atpakaļ
package.json	74c54dde42 upgrade vitest, complete config and add doc	2 gadi atpakaļ
tsconfig.json	685085c2e4 add unit tests and minor fixes	2 gadi atpakaļ
vitest.config.ts	ae7aeb4270 fix CI config and allow empty unit test to pass	2 gadi atpakaļ
yarn.lock	74c54dde42 upgrade vitest, complete config and add doc	2 gadi atpakaļ

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