- You may help each other, but I recommend solving the assignment on your own
- It is not an assignment you have to "submit", but we have "product showcases" next Monday just before we start building server applications with C#.
- It is not mandatory to show your application, but I strongly recommend to do so: It can be a great learning opportunity to present your work to stakeholder/colleagues (and flex on others).
- The student with my favorite implementation gets a 🎁mystery prize🎁 (only students who do a showcase will be eligible to enter competition)
You can clone this recommended startup boilerplate including the backend program neede like this:
git clone https://github.com/uldahlalex/react-assignmentThe "client" folder contains relevant dependencies and configuration for the frontend. You are also free to build the client app completely from scratch if you prefer.
Have docker daemon running (you can check if you get an error when running 'docker ps' ). From the "postgrest" directory in this project, run:
docker compose upAll "client" commands like npm install, npm run dev, etc should be executed inside the "client" directory
I have made a swagger.json file (in the "client" directory) which documents the API running on port 3000 when using docker compose up.
You can either open it with Webstorm and it will look like this:
(Notice the buttons in the top right corner to see json / visual representation). But for many Webstorm doesn't allow for sending HTTP requests, so I recommend copying the file contents from swagger.json and pasting into https://editor.swagger.io/ It might ask if you want to convert to YAML. Just say yes, and you should have the Hospital API swagger page in your browser like this:
The "npm run scaffold" command from the client directory also uses this swagger.json file to generate the API Client code.
You can also choose to use fetch() as an HTTP client and make your own models / generate them using https://transform.tools/json-to-typescript if you prefer.
You can also open up the Postgres Database manually using Datagrip / whatever other Database browser if you would like to. It runs on localhost:5432 and requires the credentials listed in docker-compose.yml (username "testuser" password "testpass" and databasename "testdb")
If you have made some changes in the database data, and you want to "go back" to the starting point, you can use:
(from the "postgrest" directory):
docker-compose down
docker volume rm postgrest_dbdata
docker-compose up- It should be possible to get an overview of all patients when navigating to /patients.
- It should be possible get all data for a singular patient when navigating to /patients/:id where ID is the patient ID
- It should be possible to enroll a new patient (create)
- It should be possible to delete a patient
- It should be possible to change the name of a patient
- The client application should be deployed to Firebase. If the backend is running locally, opening the deployment should still work with the local backend.
- It should be possible to add new diagnoses to a patient
- It should be possible to see all diagnosis history (for all patients) with disease name, patient name and timestamp (diagnosis_date)
- It should be possible to create a new disease which patients may be diagnosed with
- In the patients feed overview (all patients), a number next to the patient name should indicate the number of diagnosis for the patient
- It should be possible to see all diseases with a count of how many patients have exactly that disease
- The overview of patients should be paginated such that the page only shows the first X patients and the user can go to next page
- It should be possible to search for patients and diseases
- Whatever other feature you think will be cool to have!
The backend is built with postgREST which is a REST tool on top of a PostgreSQL database. The reference API for querying the "tables" can be found here: https://docs.postgrest.org/en/v12/references/api/tables_views.html