dsp das

Applications et bibliothèques Dasch Monorepo

Ce monorepo héberge diverses applications et bibliothèques de la plate-forme de service Dasch.

Installer des bibliothèques

Pour installer les bibliothèques, exécutez simplement npm install .

@ Dasch-Swiss Librairies

Pour plus d'informations sur la bibliothèque spécifique, veuillez consulter sa lecture, par exemple:

• @ dasch-swiss / jdnconvertiblecalendar
• @ dasch-swiss / jdnconvertiblecalendardateadapter

DSP-App - Interface utilisateur générique de la plate-forme de service DASCH

DSP (Dasch Service Platform) est un cadre logiciel pour stocker, partager et travailler avec les ressources et les données primaires dans les sciences humaines.

DSP-APP est une interface utilisateur simple pour le référentiel de données de recherche du Centre national et de service national suisse pour les sciences humaines (DASCH), qui utilise l'application DSP-API dans le backend. C'est un système d'annotation et de liaison des ressources dans les arts et les sciences humaines.

DSP-APP implémente DSP-JS pour se connecter avec DSP-API.

DSP-App est un logiciel libre, publié sous la licence publique générale GNU Affero.

Utilisateur QuickStart

Pour essayer DSP-App Out, le backend DSP-API doit être démarré en premier:

Dans le terminal FO au référentiel DSP-API et démarrez l'API en exécutant les commandes suivantes:

$ make init-db-test
$ make stack-without-app

Une fois que le backend est opérationnel, dans l'instance du deuxième terminal, Démarrez DSP-App en exécutant:

 # come back to this repository and start the DSP-APP
$ npx nx run dsp-app:serve

Développeur QuickStart

Le monorepo est implémenté à l'aide de NX.

Les commandes les plus courantes sont définies dans package.json .

Remarque: Vous pouvez installer nx globalement avec npm install -g nx . Sinon, toutes les commandes nx ci-dessous doivent être préfixées avec npx .

nx	NPM
nx run dsp-app:test	npm run test-local
nx run dsp-app:test:ci	npm run test-ci
nx run-many --all --target=test --configuration=ci	npm run test-ci-all
nx run dsp-app:serve	npm run start-local
nx run dsp-app:serve:test-server	npm run start-test
nx run dsp-app:serve:dev-server	npm run start-dev
nx run dsp-app:serve:ls-test-server	npm run start-ls-test
nx run dsp-app:serve:stage-server	npm run start-stage
nx run dsp-app:serve:0845-test-server	npm run start-0845-test
nx run dsp-app:lint	npm run lint-ci
nx run dsp-app:lint --fix	npm run lint-local
nx run dsp-app-e2e:e2e:development	npm run e2e-ci-dev
nx run dsp-app-e2e:e2e:production	npm run e2e-ci
nx run dsp-app:build	build
nx run dsp-app:build:production	build-prod

NPX	NPM
cd apps/dsp-app-e2e && npx cypress open	npm run e2e-local

Plugins IDE

• https://plugins.jetbrains.com/plugin/15101-nx-console-idea
• https://marketplace.visualstudio.com/items?itemname=nrwl.angular-console

Tests E2E

Il y a trois scripts NPM pour exécuter les tests E2E:

• npm run e2e-ci-dev exécutera les tests E2E dans la console dans un environnement de développement.
• npm run e2e-ci exécutera les tests E2E dans la console dans un environnement de production. Il s'agit de la commande exécutée également sur GitHub CI.
• npm run e2e-local ouvrira l'interface utilisateur de Cypress qui permettra d'exécuter facilement des tests individuels et de voir chaque étape au fur et à mesure qu'il s'exécute.

Documentation supplémentaire

Guide de l'utilisateur

➡ pour la dernière version publiée

Doc des développeurs

➡ pour les développeurs

Contribution

Si vous souhaitez contribuer à l'élaboration de la DSP-App à côté de nous, veuillez suivre les directives générales de contribution du DSP.

Documentation / directives utilisateur

Nous avons construit les directives utilisateur et la documentation des développeurs avec MKDOCS. Plus d'informations peuvent être trouvées dans la lecture spécifique.