fyindr
/
siimee
Beobachten 4
Favorisieren 3
Fork 1
Code Pull-Requests 1 Releases 4 Wiki Aktivität
Du kannst nicht mehr als 25 Themen auswählen Themen müssen mit entweder einem Buchstaben oder einer Ziffer beginnen. Sie können Bindestriche („-“) enthalten und bis zu 35 Zeichen lang sein.
226 Commits
17 Branches
Struktur: 7a2e9df128
Branches Tags
${ item.name }
Erstelle Branch ${ searchTerm }
von „7a2e9df128“
${ noResults }
siimee/backend
J 7a2e9df128 :gear: redoing prettier config | running prettier | adding some sample wave-ui elements vor 3 Jahren
..
db :recycle: a bunch of random changes before we get started vor 3 Jahren
lib :gear: redoing prettier config | running prettier | adding some sample wave-ui elements vor 3 Jahren
server :gear: redoing prettier config | running prettier | adding some sample wave-ui elements vor 3 Jahren
tests :recycle: reworking tests to use new prescore tables and tags | tweaking broken validators vor 4 Jahren
.env.sample :recycle: rebuilt aspect and prescore table migrations vor 4 Jahren
.eslintrc :recycle: just cleaning up config stuff vor 5 Jahren
.nycrc :recycle: just cleaning up config stuff vor 5 Jahren
.prettierrc :gear: redoing prettier config | running prettier | adding some sample wave-ui elements vor 3 Jahren
README.md :recycle: a bunch of random changes before we get started vor 3 Jahren
docker-compose.yml :gear: enforcing usage of env file port vor 4 Jahren
knexfile.js :recycle: rebuilt aspect and prescore table migrations vor 4 Jahren
package-lock.json :sparkles: sse push updates! vor 4 Jahren
package.json :recycle: alterations to unseed and test user creation vor 4 Jahren

README.md

siimee backend API

An API for the siimee application

:white_check_mark: Prerequisites

You will need…

Node.js 14+

:package: Installation

  1. Install dependencies with npm install
  2. Copy the environments sample file from ./backend/.env.sample and rename it to ./backend/.env
  3. Fill out your database connection details in ./backend/.env
  4. A test database container is provided and can be started with docker-compose up -d
  5. Populate some basic tables for your database using npm run generate && npm run reseed

:package: Migrations

We use Knex.js,which comes with a couple nice database migration and seeding tools. Migrating tracks changes in schema. Migration steps are contained in the ./db/migrations folder. Seeding adds dummy data once our database tables have been created and schemas are set. Starting seed steps are contained in ./db/seeds and use the mock.js file as the main dummy data source.

Migrating

  • Run npm run migrate to run all migrations and establish the base schema
  • Run npm run unmigrate to roll back one migration

Seeding

  • Run npm run generate to generate dummy data
  • Run npm run seed to seed the database with generated dummy data

Restarting

Since we can’t unseed the database, it’s best to destroy the dev database and rebuild it.

  1. Stop the database by navigating to the project root directory cd ../ and running docker-compose down
  2. Destroy the database volume docker volume rm siimee_siimee_db. BE CAREFUL.
  3. Restart the database while still at the project root with docker-compose up -d
  4. Recreate schemas,tables and dummy data by navigating to ./backend and running npm run reseed

:electric_plug: Run

  1. Run npm run start to start up the server
  2. Check http://localhost:3001/documentation to see the interactive API documentation

:robot: Deployment

TBD

:pill: Tests & Code Quality

Tests are run with AVA with code coverage reporting via nyc. Look at the example test for ideas, as well as the ava documentation

  • Run tests with coverage report with npm test

:heart: Built With