Webtools Example Application

Background

This is a small laravel/inertia/react application.

It pulls a list of patients from a public FHIR API then displays them and allows for the drilldown to an individual patinet.

Task

Please extend the application to allow a user to do the following

• Search for by name
• Add pagination to the table to allow a user to navigate through the pages

Setup

Repo setup

1. Clone this repo
2. Create a new private repo and push to GitHub
3. Make changes as required below
4. Share with GitHub users karl-d, Matt-Web and kibbonz

Getting it running

There are a couple of options to get it running:

Laravel Sail

1. docker run --rm --interactive --tty --volume $PWD:/app --user $(id -u):$(id -g) composer install to install the dependencies
2. Copy .env.example to `.env
3. vendor/bin/sail artisan key:generate to generate the application key
4. vendor/bin/sail up to start up the application (NOTE: This could take a while to build the first time)
5. vendor/bin/sail npm install to install npm dependencies
6. vendor/bin/sail npm run dev to run the React build process
7. vendor/bin/sail artisan migrate --seed to run the React build process
8. Login to the application at http://localhost/login using the email and password in the DatabaseSeeder.php

SQLite & php artisan serve

Requires PHP >=8.1

1. touch database.sqlite to create a local database (take not of the absolute path for step 3)
2. Copy .env.example to `.env
3. Update database reference in the .env file
   • DB_CONNECTION=sqlite
   • DB_DATABASE=/absolute/path/to/database.sqlite
   • DB_FOREIGN_KEYS=true
4. composer install
5. php artisan key:generate to generate the application key
6. npm install to install npm dependencies
7. npm run dev to run the React build process
8. php artisan migrate --seed to run the React build process
9. php artisan serve to start up the application
10. Login to the application at url returned from the above command using the email and password in the DatabaseSeeder.php

Other options

You could use any other PHP stack that you are familiar with like Valet or Homestead

Useful Links

• FHIR API docs
• Laravel Sail