/Study-Tracker

Study management software for lab-based research organizations

Primary LanguageCSSApache License 2.0Apache-2.0

Study Tracker

UPDATE: Study Tracker has moved! You can find the latest builds of Study Tracker here. No future updates will be published to this repository.

Study Tracker makes the job of managing your team's research easier by providing a user-friendly web application that serves as a single source-of-truth for your organization. Save time by connecting with other required platforms, such as electronic laboratory notebooks (ELNs), data file storage systems, and team messaging services. Integrate Study Tracker with other platforms via an integrated REST API and event dispatcher service for sharing of data.

Requirements

  • JDK 11+
  • Maven 3+
  • PostgreSQL 12+
  • NPM 8+ and Node.JS 12+
  • Elasticsearch 7.10+ (optional)

Documentation

For instructions about how to configure and deploy Study Tracker, see the wiki.

Supported Integrations

Electronic Laboratory Notebook

  • Benchling

File storage

  • Egnyte
  • Local filesystem

Event Management

  • AWS EventBridge

Quick Start

For a rapid build and deployment in development mode, follow the steps below. For production deployment, see the wiki.

  1. Make sure you have all requirements installed.

  2. Create a new PostgreSQL database.

  3. Create a new file, src/main/resources/application.properties. Use the application.properties.example file as a template for filling out the required parameters for running the application.

  4. Create a new file, flyway.conf, using the flyway.conf.example file as a template. Fill in your database's username, password, and connection URL.

  5. Build the application in the following order:

    npm install
    npm run build
    mvn clean package -DskipTests
  6. Run the Flyway plugin to import the Study Tracker database schema and default data:

    mvn -Dflyway.configFiles=flyway.conf flyway:clean flyway:migrate
  7. You can run the application with Maven:

    mvn spring-boot:run 

    Or, you can execute the packaged WAR file directly:

    java -jar study-tracker.war

Contact

For questions about Study Tracker, or if you would like to contribute, please contact:

License

Copyright 2021 Decibel Therapeutics

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.