How to Use

msw-toolbox can be accessed at http://hkgnp.github.io/msw-toolbox
As this is a prototype, please do not use it for actual services, and do not key in any sensitive patient data.

This app consists of 3 core functions:

Ecomap:

When you are at your patient's home, you can use the ecomap locator to discover nearby care and social services.

Useful Statistics:

Access the latest statistics from Data.gov.sg to see the latest trends.

Referral System:

Reduce the time spent referring your patient to services by using the one-stop system. Select the service you want to refer your patient to, enter your patient's postal code or simply use the GPS on your mobile device, and the nearest service will appear. Simply click on the 'Refer' button, and fill out the form. Upon clicking submit, your referral will be immediately sent to the agency for processing.

As the agency, you can "login" to the system and see the referrals sent to you. You can process each referral, and upon clicking on the 'Process' button, the referral is removed from the database.

Project Summary

This toolbox is to be used by Medical Social Workers (MSWs) and other healthcare professionals at their patients' homes. This is a toolbox to be used by Medical Social Workers (MSWs) to make referrals to community services while they are at their patients' homes.

This toolbox is a prototype that may be used by Medical Social Workers (MSWs) and other healthcare professionals, especially those working in the community. It hopes to be able to help them to:

Discover a variety of social and care services near their patients' homes, without needing to research through several websites;
Increase their effeciency when referrals their patients to social and care services, enabling them to do it at their patients' homes; and
Make useful statistics easily available.

Strategy

Part of a MSW's role is to link their patients up with community services as part of their care. This applies to both patients in the hospitals and clinics, and those who are at home. Currently, when a MSW identifies that a patient needs to be linked up with a community service, she may not know the services that are in the particular patient's committee. Even if she knows, she will need to do so when she is back in the office, despite having the necessary tools with her.

Useful information like health and social policies, and statistics are fragmented and found on different sites. Currently, MSWs need to navigate these different sites just to obtain the information, decreasing their productivity.

This application hopes to be able to solve the above problems, and ideally, as part of a wider eco-system of applications.

User Stories

As a MSW, I want to be able to locate relevant community services that are near my patient so that I can share them without needing more than one visit.
As a MSW, I want to be able to refer my patient to these services from their homes, so that I do not need to return to my office to do so.
As a MSW, I want to be able to retrieve relevant policy information and statistics in a single place, so that I do not need to navigate several websites to do so.
As a MSW, I want the above functions to be available as a mobile app, because the work-issued devices have internet separation, and I will predominantly use my mobile or tablet to perform these functions.

Scope

The app must be able to perform the following functions:

Request and store a postal code to be converted to lat, long for processing.
Request for user location in the form of lat, long.
Request (from an API or local file) positional data of relevant community services.
Compare the above coordinates to retrieve services nearby to the user's location or postal code.
Store useful information and statistics, using graphs where necessary.

Structure

Ecomap Discoverer

User will be given an open map and be able to use the GPS on their mobile device to find out their exact position.
User will then be presented with toggle buttons to discover services that are nearby their location or around the island.

Useful data and Statistics

User will be able to access a menu through the hamburger to be able to obtain relevant policy information and statistics.
Graphs will be used where necessary.

Search and Refer

User will be presented with radio buttons to select the service that they would like to isolate.
User will be prompted with options to either (1) key in a postal code; or (2) use their device's GPS to retrieve their current location.
User will then be shown an interactive map that shows the above.
User will be able to refer to their marker of choice, and then click on a button to bring them to the referral page.
At the referral page, user will be presented with a form to key in the necessary referral information.
Upon submission, user will be presented with a HTML friendly version of the data that they can send to the community service via email.

Skeleton

Code style

Code is formatted using Prettier (installed as an extension in VS Code).

Deployment

msw-toolbox is deployed to Github Pages. MongoDB is used to store the referral information for retrieval, and the API used to communicate with MongoDB is hosted on Heroku. This API was specially created for this project and it can be found on mswapi. Dependency details for the API can be found on the page directly.

The dependencies for msw-toolbox can be found in the section below under "Tech/frameworks Used". Other than the CSS Menu (by Erik Terwan), Flat icons for the map pins, and geojson files, the other dependencies do not have to be downloaded as they are called through CDNs. Hence, if you would like to deploy this app on your own server, please ensure that the below files and folders are forked as well.

/geojson
/pins
/css/menu.css

Note: The geojson files are updated as of Jan 2021. There may be more updated datasets by the time you read this. However, the infograph data are obtained through a real-time API.

Tech/frameworks Used

This app is made only possible thanks to the following technologies:

Github
HTML
CSS
Vanilla Javascript
Leaflet
Leaflet Geometry Utility
Leaflet Omnivore
Bootstrap
Google Fonts
Font Awesome
MongoDB
Heroku
Axios
ApexCharts.JS
CSS Menu
Scroll Reveal
Flat Icons (for the pins)
- Freepik
- Smashicons
- Pixel Perfect
- srip
Built with VS Code

API References

And it is also made only possible thanks to the painstaking work done by the following organisations:

Acknowledgments

Mr Paul Chor
Mr Alexander Yan
Mr Shun
Mr Ace Liang
Mr Christopher Seow
My wonderful classmates who have been part of this journey together:
- Hidayah
- Howard
- Julius
- Ryan
- Ying Ru
My fellow professionals who have given feedback to help me finetune the application.

Testing

Category	Actions	Expected Outcome
General	Mobile-respnosiveness	Thanks to Bootstrap, site elements will resize depending on size
Ecomap Discoverer	1. Click on menu	Menu appears
	2. Click on Discover Ecomap	Page scrolls to map
	3. Click 'Ecomap Toggle Buttons'	A row of toggle buttons and a select input type will appear for user selection
	4. Make selection of using either GPS or enter a postal code.	If postal code is selected, an input and submit will appear for the user to enter a postal code. Once switched to GPS, the input box will disappear. Subsequently. your GPS or postal code location will appear as a marker on the map
	5. Toggle services' buttons: 'SSO', 'Disability', 'FSC'	Different markers will appear & disappear depending on which button is pressed
Useful information	1. Click on menu	Menu appears
	2. Click on Useful Information	Page scrolls to chart accordian
	3. Click on each accordian	Chart will display depending on accordian clicked
	4. Click on legend	Thanks to ApexCharts, data series will toggle depending on legend selection
Referral System	1. Click on the service you want to refer the patient to: 'Social Service Office', 'Family Service Centre', 'Disability Services'	Radio button will be highlighted depending on selection. Page will then scroill to the Step 2
	2a. Key in your postal code and press 'Submit'	Page will scroll to Step 3. If postal code is more or less than 6 numbers OR if it contains alphabets, user will be asked to input again.
	2b. Click 'Use My Location' to use the GPS location	Page will scroll to Step 3 after a 5s delay (timer shown) as it takes more time to calculate the closest point using GPS
	3. The closest service depending on what you selected will appear in a popup with a zoomed in view. Click the 'Refer' button to refer the patient to the selected service	The referral form will appear in a modal for the user to complete and submit. Upon submission, user will see a confirmation message containing the details that was submitted. If any of the fields are not filled in, user will be asked to complete all fields.
Referral History System	1. Click on menu	Menu appears
	2. Click on 'Log In'	User will be brought to the Referral History page
	3. For each referral, click on 'Process' to process the referral	Page will reload and the referral will be removed from the page (and database)

benjypng / msw-toolbox Goto Github PK

msw-toolbox's Introduction