Nowdatabase

NOW - New and Old Worlds - Database of fossil mammals

Rebuild of a fossil database application, old version at https://nowdatabase.luomus.fi/

The new version is not deployed yet.

Developer documentation

Basic commands :computer:

• npm run setup
  • Installs all node modules, and generates prisma client
• npm run dev
  • Uses docker-compose.dev.yml
  • Run in development mode: with hot reload

Testing:

• npm run check
  • Runs tsc and eslint for frontend and backend: Use this to check for errors before committing, if you feel like it.
• npm run start:anon
  • Uses docker-compose.anon.yml
  • Runs the app with anonymized test-database. Make cypress-tests using this version
• npm test
  • Runs cypress-tests in headless mode, same as in GitHub Actions. Requires the above command to be ran first.
• npm run cypress
  • Opens cypress. You can run tests and see what they do.

Run with the same image that is used in production:

• npm start
  • Uses docker-compose.yml
  • This builds the code and runs it. Mostly you'll want to use this after major technical changes to check the code works also in production mode, before deploying. And then you'll likely want to do: npm start -- --build to force rebuild of containers.

Further documentation

:rocket: Initialize app & restore db How to get the app up & running, and initialize database from sql-dumps

:wrench: Technical explanations Explanations of how things work, and guides for some more rare tasks like updating database-schema

:raised_hands: Contributing & integration flow Where to commit? Where are tests run? How is the code deployed?

:memo: Frontend Explanation of the frontend logic and how to add views

:mag_right: Validators The readme explains how validators are written

:mag_right: Class diagram See the relations of relevant tables. Notice that it omits some unimportant tables and does not show most columns.