Skip to content

dasch-swiss/dsp-das

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DaSCH Applications and Libraries Monorepo

Github Docker CI

This monorepo hosts various applications and libraries of the DaSCH Service Platform.

Install libraries

To install libraries just run npm install.

@dasch-swiss librairies

For more information about specific library, please go to its readme, e.g.:

DSP-APP — generic user interface of DaSCH Service Platform

DSP (DaSCH Service Platform) is a software framework for storing, sharing, and working with primary resources and data in the humanities.

DSP-APP is a simple user interface for the research data repository of the Swiss National Data and Service Center for the Humanities (DaSCH), which uses the DSP-API server application in the backend. It's a system for annotation and linkage of resources in arts and humanities.

DSP-APP implements DSP-JS to connect with DSP-API.

DSP-APP is free software, released under GNU Affero General Public license.

User Quickstart

To try DSP-APP out the DSP-API backend should be started first:

In terminal fo to DSP-API repository and start the API by running following commands:

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

Once backend is up and running, in the second terminal instance start DSP-APP by running:

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

Developer Quickstart

The monorepo is implemented using NX.

The most common commands are defined in package.json.

NOTE: You can install nx globally with npm install -g nx. If not, then all nx commands below need to be prefixed with 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

IDE plugins

E2E Tests

There are three NPM scripts to run the E2E tests:

  • npm run e2e-ci-dev will run the E2E tests in the console in a development environment.
  • npm run e2e-ci will run the E2E tests in the console in a production environment. This is the command run also on GitHub CI.
  • npm run e2e-local will open the Cypress UI which will enable to run individual tests easily and see every step as it runs.

Further Documentation

User guide

for latest released version

Developer docs

for developers

Contribution

If you would like to contribute to the development of the DSP-APP alongside us, please follow the general DSP contribution guidelines.

Documentation / User guidelines

We built the user guidelines and developer documentation with MkDocs. More information can be found in the specific README.