DECSYS is a tool that enables the creation and administration of digital surveys with support for conventional and custom responses.

• Research Project Homepage
• Usage and Technical Overview of the Application
• Custom Response Item Guide

Most of the above Project Areas each have their own README with some details on getting started, and further details can be found in the Developer Guide.

This monorepo uses Yarn 2 Workspaces for managing dependencies / running scripts across several javascript projects.

This means the following:

• Non javascript projects are managed as normal, relative to their project directories.
• The .NET app is a slight exception to the above
  • Because it hosts a javascript project (client-app), its debug build process has similar environment expectations to client-app
  • DECSYS.sln is actually in the root of the repo, not the project directory.
• Javascript projects have some environment prerequisites.

• Have node.js (10.x or newer, so it comes with npm)
• Have yarn globally installed.
  • the recommended way today is to install from npm:
    • npm i -g yarn
  • this global installation will then use the repo's local version in .yarn/releases

Some notes on our usage of Yarn 2 in this repo:

• We use Plug n' Play mode.
  • no node_modules folders.
  • better dependency integrity
  • stricter dependency rules
    • this can have side effects that may require temporary workarounds
• We use Workspaces
  • packages installed and cached at the top level of the repo, not per project
  • one yarn.lock for the whole repo
  • many package.json manifests - one per project.
  • one .yarnrc.yml config file for the repo.
  • yarn cli commands can be run against a workspace as follows:
    • yarn workspace <package_name> <command>
    • e.g. yarn workspace @decsys/client-app add some-package
  • scripts can be run against a workspace as above
    • yarn workspace <package_name> <script_name>
    • e.g. yarn workspace @decsys/client-app build
  • scripts can be run relative to a project directory
    • e.g. /app/client-app> yarn build
  • many yarn commands are workspace-wide:
    • e.g. yarn up my-package@latest will upgrade my-package in any package that depends on it.

This software is primarily licensed under the GNU Affero General Public License v3.0 only (AGPL-3.0-only).

A summary is provided below; the full license text may be found in LICENSE.md.

Other license arrangements may be made as appropriate on request.

DECSYS

Copyright (C) 2019 Christian Wagner, LUCID (Lab for Uncertainty in Data and Decision Making)

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published
by the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.