Tanzania Mesh Hernia Registry, is a mobile-first website and database designed to record and track Mesh Hernia operations in Tanzania. It was built by and for the SWIFTSS charity who are focused on improving the availability and effectiveness of mesh hernia surgery across Tanzania.

Set up Client

Pre-required

• Node v12+
• Yarn
• Git installed
• Github Account and private access on Orfium

How to install

Clone the project on your personal local machine and then

yarn install

You can run the app in development mode. Open http://localhost:3000 to view it in the browser. The page will reload if you make edits. You will also see any lint errors in the console.

yarn start

Note: If you are using Node v17+ you may get error:03000086:digital envelope routines::initialization error error when running yarn start. If so please follow the instructions on https://stackoverflow.com/questions/69692842/error-message-error0308010cdigital-envelope-routinesunsupported to resolve.

You can run the test runner in the interactive watch mode.

yarn test

E2E Testing

You can run end-to-end tests using Cypress.

Prerequisites

• Ensure the client app is running

yarn start

• Ensure Docker is running to host the registry-api backend and database.

Open Cypress Test Runner (Interactive)

yarn cy:open

Run tests in headless mode

# Run the entire suite sequentially (default)
yarn cy:run

# Run only mocked specs (120 tests, fast, no DB required)
yarn cy:run:mocked

# Run only real-DB user-journey specs (6 tests, requires API & DB)
yarn cy:run:e2e

# Run mocked and real-DB suites in parallel locally (mirrors CI split)
yarn cy:run:parallel

Running against a local instance of the registry-api

You can run against a different registry-api backend by changing BASE_URL in src/api/axiosInstances.ts. For example to run against a local development instance this should be set to:

const BASE_URL = 'http://localhost:8000/api';

Next steps for Devs

• Cross validate the names and types of the apiTypes, all data sent and received to, from the backend https://github.com/swiftss-org/registry-api/ scanning the registry-api as well
• Is the National ID required on the Register patient Form? Is it required in the DB inside https://github.com/swiftss-org/registry-api/? It looks like as I can't record a second row if I omit the National ID.
• Show the loading animation when data is still loading on all pages
• Add Notification messages for successful actions - make sure it only appears after a successful action but if the action fails it should show an error notification