Skip to content
Felix Sommer edited this page Sep 30, 2020 · 4 revisions

Seed-Test

Behaviour-driven development (BDD) extends the Test-Driven Development (TDD) approach by the ‘desired behaviour’ of a software. It is designed to ensure a collaboration between business analysts and developers with explicitly written down scenarios.

What is Seed-Test?

Seed-Test is a website user interface testing tool, which uses approaches of behaviour-driven development and the notation of Gherkin to enable developers and business users to execute automated tests for their website. It can be tested on the official website.

We are greateful for any testing and feedback, so please help us by filling out this feedback form

Bugs, Problems ...

Please contact us via mail seed-test@adesso.de

Installation

To install and use the application localy, clone the repository. It is necessary to install NodeJS. Install Angular 7:

npm install -g @angular/cli 

Then install all necessary node modules once in the backend and in the frontend folder:

npm install

Create an .env file in the backend folder with following variables:

DATABASE_URI= uri for the database connection
REPORT_DELETION_TIME= minutes after which the generated reports are deleted (e.g. 5 for 5 minutes)
TESTACCOUNT_NAME= name of the github test account (not needed for you if you do not use a test account)
TESTACCOUNT_TOKEN= github token of the test account (not needed for you if you do not use a test account)
PORT= port of the server
SESSION_SECRET= secret for the send cookies (can be any arbitrary word)
JIRA_SECRET= secret for Jira requests (can also be any arbitrary word)
FRONTEND_URL= http://localhost:4200 
GITHUB_CLIENT_SECRET= client secret for your Github OAuth App
GITHUB_CLIENT_ID= client id for your Github OAuth App

Create an .env file in the frontend folder with following variables:

API_SERVER=http://localhost:8080/api
GITHUB_CLIENT_ID= client id for your Github OAuth App

To run the frontend server switch to the frontend folder and use this command:

cd frontend
npm start

To run the backend server switch to the backend folder and use this command:

cd backend
npm start

Database

Seed-Test uses a MongoDB. You can either create your own locally or in the cloud. For installation details check out our Check out the Database Tutorial

Once you set up the database, insert the uri into the mongodatabase.js file in the backend folder. Save it!

Then you can set up the database through this command:

npm run database

This command creates the collections 'Stories' and 'stepTypes' and inserts the current stepTypes into the collection. The Stories collection can stay empty. It will be automatically filled while accessing the web-app.

License

Copyright (c) 2020 Adesso SE Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.