Geospatial_Posts

define areas for sending posts

Skill set Needed: Moderate or expert Drupal 8 and Drupal 7 developer that has experience with Drupal modules and PHP. This module will be built with Drupal 8 methods (all of the logic and functionality), and include a plugin in the same module for Drupal 7 to connect with current Drupal 7 sites. All Drupal 8 sites will ignore the module's Drupal 7 plugin Hook.

Getting Involved

Environment

• Any basic vanilla Drupal 8 environment is acceptable for development. Look at guide here if you need help: https://github.com/hopeonesource/geospatial_posts/blob/master/setting_up_Drupal8_locally.md

• Guide on how to install and run the Geocoder Nominatum Module (https://www.drupal.org/project/geolocation_nominatim): https://github.com/hopeonesource/geospatial_posts/blob/master/install_geolocation_nominatim_module.md

Why do we need Geospatial Search and Querying capabilities?

1. Allowing HopeOneSource to scale. HopeOneSource will expand to different regions while retaining a single Drupal instance. Therefore we will need to have geospatial querying capabilities to limit posts being sent and received to selected regions in addition to just the distance based limits we place on sent posts. Users in the system will either have the capability to select regions based on searching for them (based on Nominatim search) and/or selecting pre-defined regions (such as using GADM).
2. This added functionality will also be part of one of the requirements when building our regional data dashboards, enabling metrics through an API per region, therefore limiting the amount of data being sent to the dashboard and speeding up load times.

UI updates related to this User Story:

1. When providers send posts, they will have the option of who will receive posts based on 1) all posts within x region (based on returned polygon on Nominatim search); be able to select multiple regions 2) x distance away 3) or within user-defined polygon. There will also be a map that shows where the post will be sent.
2. Think about this, it would add a lot more complexity, including adding subqueries and storing individual polygons per clients Clients will be able to adjust through their settings, how they receive posts: 1) all posts within x region 2) x distance away 3) or within user-defined polygon

Basic system components:

• UI modifications will be modified on select pages on HopeOneSource. New Map Module will have to be integrated with Drupal 8. • Drupal code in Drupal module will process form and send select PostGreSQL spatial queries to remote PostGIS database on AWS and be able to receive back results. • PostGIS database will be set up on AWS

Detailed implementation plan link:

https://docs.google.com/document/d/1HMQ2J9ikfK7IR1aI4ef6alnWBPNncKgik5iK3SJ8lPo/edit#

Doc outlining potential Drupal Modules to integrate

https://docs.google.com/document/d/1zcPsljPYsGa6f9JvfJ9B2c6Y3lzTl04do2RBhmsbyVo/edit

FAQs

Are we developing for both Drupal 7 and 8?

yes, the plan would be to develop 2 versions of the module, with anything that is common between the two be located in a third module.

Is there an overall system diagram?

https://docs.google.com/presentation/d/19ySapxChDHorljTLOP4pI5nmlQfstlNOHCR0pHGQeBk/edit?usp=sharing

What do the providers and clients see in the system?

providers making posts: https://www.youtube.com/watch?v=5qKlJFEQJlI

clients registering: https://www.youtube.com/watch?v=FJwb6KX30G0

How is user location stored at present?

We store lat/long of 1.) every client registered (person experiencing homelessness), and from 2.) every service provider's post (available service such as food and legal assistance).

Any tips for local development?

The project is hosted on Pantheon. Developers have used Kalabox in the past, but the new generation of it is Lando, which is the main tool we use locally now.