Este Monorepo hospeda vários aplicativos e bibliotecas da plataforma de serviço DASCH.
Para instalar as bibliotecas, basta executar npm install .
Para obter mais informações sobre a biblioteca específica, vá para o seu ReadMe, por exemplo:
O DSP (Dasch Service Platform) é uma estrutura de software para armazenar, compartilhar e trabalhar com recursos e dados primários nas ciências humanas.
O DSP-APP é uma interface de usuário simples para o repositório de dados de pesquisa do Centro Nacional de Dados e Serviços Swiss para Humanidades (DASCH), que usa o aplicativo DSP-API Server no back-end. É um sistema para anotação e ligação de recursos em artes e humanidades.
O DSP-APP implementa o DSP-JS para se conectar com DSP-API.
O DSP-App é o software gratuito, lançado sob licença pública geral do GNU Affero.
Para experimentar o DSP-App, o back-end do DSP-API deve ser iniciado primeiro:
No Terminal FO para o repositório DSP-API e inicie a API executando os seguintes comandos:
$ make init-db-test
$ make stack-without-appDepois que o back-end estiver em funcionamento, na segunda instância do terminal, inicie o DSP-App executando:
# come back to this repository and start the DSP-APP
$ npx nx run dsp-app:serveO Monorepo é implementado usando o NX.
Os comandos mais comuns são definidos no package.json .
Nota: Você pode instalar
nxglobalmente comnpm install -g nx. Caso contrário, todos os comandosnxabaixo precisam ser prefixados comnpx.
| 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 |
Existem três scripts do NPM para executar os testes E2E:
npm run e2e-ci-dev executará os testes E2E no console em um ambiente de desenvolvimento.npm run e2e-ci executará os testes E2E no console em um ambiente de produção. Este é o comando executado também no Github CI.npm run e2e-local abrirá a interface do usuário do Cypress, que permitirá executar testes individuais com facilidade e ver todas as etapas à medida que funcionar. ➡ para a versão mais recente lançada
➡ Para desenvolvedores
Se você deseja contribuir para o desenvolvimento do DSP-App ao nosso lado, siga as diretrizes gerais de contribuição do DSP.
Construímos as diretrizes do usuário e a documentação do desenvolvedor com o MKDOCS. Mais informações podem ser encontradas no ReadMe específico.