Homey

Application Landing Page
Application Dashboard Content
Application Dashboard Details
Home Map Locations
Published Home Details Sample
Published Home Graph Statistics
Email Messages Campaign
SMS Messages Campaign

Inspiration

As Ukraine is being attacked and invaded by Russians, Most of Ukrainians home are destroyed and many people are displaced. With Refugees looking for Shelter elsewhere, we develop an application to help connect Ukranian Home Seekers with Home Offerors

What it does

An application that connects Ukrainians Refugees(Home Seekers) to Home Offerors powered by Email Clients, Twilio SMS and Google Chart Statistics

How Dose the application Works

1.) The User Signup either as Home Seeker or Home Offeror and then Login

2.) If you are a Home Offeror, You will need to publish your home by clicking a Publish/Share Home to fill out form and Publish your home.

3.) Once a new Home is publish, the application sends automatic email broadcast to all registered Home Seekers Email Address regarding the new Home being share along with the house details and requirements. The Home Seeker can also be notified via a notification system within our app so as to contact and connect to the Home Offeror

4.) The Home Seeker can also View Published Homes from the applications dashboard and can contact and connect to the Home Offeror via Email and SMS Messages Campaign. The Home Seeker can also view the Home Locations and details on Google Map

5.) Once an agreements has been placed between Home Offeror and Home Seeker via Email and SMS Messages campaign, the Home Offeror can the mark the home as Taken or Matched

6.) We integrated Google Chart Statistic to help visualized Total Home Published vs Home still Open/Available vs Home Taken/Matched via Bar and Line Chart Graph distribution Analysis...

How we built it

The application was built with PHP, MYSQL, Jquery/Ajax, Bootstrap.

Technologies used includes Google Map Javascript API, Google Address Geocoding API, PhpMailer, Twilio SMS, and Google Chart/graphs

1.) We Used Twilio SMS API to send and recieve SMS messages campaign within the application. We are currently using Twilio Test/Sandox API Credentials and thus can only send and recieve SMS to only numbers (Eg. +2349135775247) configured on Twilio Dashboard.

In Production, You will need to enter your Production/Live Twilio SMS Credentials at settings.php files to enable you send and recieve SMS Message to any mobile contacts across the globe.

2.) We used Google Address Geocoding API to convert published home address to Latitude and Longitude to enable the Home to easily appear on Google Map.

3.) We used Google Map Javascript API to pinpoint the exact location of the published home on the Google Map

4.) We used PhpMailer to send and recieve and broadcast email messages to users email addresses

5.) We used Google Chart/graphs to be able to visualized Total Published Home vs Home still available vs home take/matched via Line and Bar Chart Graph Distribution Analysis

How to Use the Applications.

Testing the Application locally

1.) You will need to ensure that you have xampp Server install and that php and Mysql database is running.

2.) Edit settings.php file to admin Phone no, Email Address, Email Server Credentials, Twilio SMS Credentials, Google Map Javascript API Keys where appropriates

3.) Edit data6rst.php and db_connect_map.php to reflect your database credentials.

4.) Open table_db.txt to copy or export database tables used in creating the application to mysql database on xampp Server

5.) Open Your Browser and test the application at http://localhost/homey/index.php

Other Code details can be found in the Readme.txt file

Testing it Online

You can test it online by visiting https://www.fredjarsoft.com/homey/index.php

About Our Twilio SMS Gateway

We are currently using Twilio Test/Sandox API Credentials and thus can only send and recieve SMS to only numbers (Eg. +2349135775247) configured on Twilio Dashboard.

In Production, You will need to enter your Production/Live Twilio SMS Credentials at settings.php files to enable you send and recieve SMS Message to any mobile contacts across the globe. https://www.twilio.com/

Challenges we ran into

No Challenges Yet..

Market Viability

This application is ready for production and can easily be adopted by various Humanitarian Agencies, Governments, individuals for purpose of Providing Shelter to Ukrainians in need.