darlanschwartz/driven.t

Driven.t - Back-end

Back-end for Driven.t, an event management solution.

About

Driven.t is a web browser application with which you can manage every single aspect of your event.

How to run for development

1. Clone this repository
2. Install all dependencies

npm i

3. Create a PostgreSQL database with whatever name you want
4. Configure the .env.development file using the .env.example file (see "Running application locally or inside docker section" for details)
5. Run all migrations

npm run dev:migration:run

6. Seed db

npm run dev:seed

6. Run the back-end in a development environment:

npm run dev

How to run tests

1. Follow the steps in the last section
2. Configure the .env.test file using the .env.example file (see "Running application locally or inside docker" section for details)
3. Run all migrations:

npm run test:migration:run

4. Run test:

npm run test

Building and starting for production

npm run build
npm start

Running migrations or generate prisma clients

Before running migrations make sure you have a postgres db running based on .env.development or .env.test file for each environment.

You can operate on databases for different environments, but it is necessary to populate correct env variables for each environment first, so in order to perform db operations type the following commands:

• npm run dev:migration:run - run migrations for development environment by loading envs from .env.development file. It uses dotenv-cli to load envs from .env.development file.

• npm run test:migration:run - the same, but for test environment.

• npm run dev:migration:generate -- --name ATOMIC_OPERATION_NAME - generate and run migration and prisma client for development environment by loading envs from .env.development file. Replace ATOMIC_OPERATION_NAME by the name of the migration you want to generate.

What to do when add new ENV VARIABLES

There are several things you need to do when you add new ENV VARIABLES:

• Add them to .env.example file
• Add them to your local .env.development and .env.test files