This repo contains the code for allReady, an open-source solution focused on increasing awareness, efficiency and impact of preparedness campaigns as they are delivered by humanitarian and disaster response organizations in local communities.

• Project overview
• How you can help
• Solution architecture
  • Web application
  • Cross-platform mobile app
• Get started with the allReady solution
  • Prerequisites
  • Configure the web project
  • Configure the mobile app project
  • Run and test locally
  • Deploy to Azure

##Project overview allReady is focused on increasing awareness, efficiency and impact of preparedness campaigns delivered by humanitarian and disaster response organizations in local communities. As community preparedness and resliency increases, the potential for impactful disasters (both large and small) is greatly decreased. Though not as visible or emotionally salient as saving children from a burning building, preparedness activities like ensuring working smoke detectors in a community, follows the industry rule of thumb where an hour or dollar spent before a disaster is worth 15-30 afterwards. The goal of allReady hinges on growing awareness of, and engaging communities and their volunteers in preparedness campaigns, and more aspirationally, to "put disaster response out of business" by preparing communities to be reslient to inevitable disasters.

To learn more about the need for allReady, the technologies involved and how the app came together, view the project information and blog post on the Humanitarian Toolbox website and watch the In the Code video series:

The allReady project was jumpstarted by volunteers at Microsoft and has been turned over to Humanitarian Toolbox to be maintained and improved by the technical community at large and ultimately deployed in support of organizations delivering preparedness campaigns everywhere.

The initial launch of development for allReady started on 7/20/2015 during the Visual Studio 2015 release event.

##How you can help To help make improvements to this project, you can just clone this repository and start coding, testing, and/or designing.

Before jumping in, please review the solution architecture and instructions below to get started.

As of this writing (week of 7/20/2015), we are focused on expanding and filling out our documentation, issues lists, milestones plan and supporting any issues that arise from community engagement with the codebase. Additionally, you willl find issues of all types (simple bugs, new feature & requirements and architectural updates) upon which you can contribute to the project. In the meantime, if you find any issues with the codebase or other content in our repository please log an issue and we will work with you to solve it.

Thank you for considering supporting this open source project for humanitarian support.

##Solution architecture

The allReady application is implemented as a Visual Studio 2015 solution that contains two projects: an ASP.NET 5 project that serves the web site and admin portal, and a cross-platform Cordova app project. The web application also exposes REST APIs used by the mobile app to access data.

###Web Application

An ASP.NET 5 web application provides the front-end web experience for volunteers accessing the allReady web site and the portal used by administrators. The site is powered by ASP.NET MVC 6 using .NET 4.6 and a dependency on .NET 4.5.1. Here's the landing page for the web site:

The web site relies on the following frameworks:

• Bootstrap: responsive layouts on mobile devices
• Font-awesome: scalable vector icons
• Hammer: gesture support
• jQuery: ubiquitous JavaScript library
• Knockout: MVVM bindings

####REST APIs

The same ASP.NET 5 project also exposes a set of Web APIs which are part of the MVC 6 framework. These REST APIs are used by both the web site and the Cordova mobile app.

####Data layer

Data is stored in a database that is accessed by the ASP.NET application using Entity Framework 7.

####Cloud services

The allReady web project is designed to be hosted in Microsoft Azure. The following services are used by this application when running in Azure:

• App Service Web Apps: hosts the web application.
• SQL Database: storage of relational data.
• Storage: storage of uploaded BLOB data.

####Authentication

Authentication of web site mobile app users leverages OAuth 2.0 with credentials from external authentication providers such as Facebook, Twitter, or Microsoft. Users can use their existing social media accounts to sign into the web site or mobile app. For more information, see Enabling authentication using external providers.

###Cross-platform mobile app

The mobile app project was added to the allReady solution as a Visual Studio Tools for Apache Cordova project.

The client app relies on the following frameworks:

• AngularJS: extensible web app framework
• Apache Cordova: cross-platform device deployment, including these plugins:
  • Whitelist
  • InAppBrowser
  • BarcodeScaner
• Ionic: enhancements for Cordova apps
• Moment.js: working with date-time values

The app accesses the Web API exposed by the web app for data access.

Users can sign-in with supported social providers such as their Facebook, Twitter, or Microsoft. You must configure each of these providers for the mobile app separately, as described in the next section.

##Get started with the allReady solution

This section will help you get up-and-running with the allReady solution.

###Prerequisites

You will need the following to be able to run the allReady solution locally:

• Visual Studio 2015, the tools for Apache Cordova (which are included in the latest Visual Studio release) and optionally the emulator for Android apps. All of the needed tools are supported by all versions of Visual Studio 2015 including the free Community Edition. Download Visual Studio 2015.

• To use ASP.NET 5 beta8 with Visual Studio 2015, you will need to download and install the beta8 version of ASP.NET and Web Tools 2015.

You will need the following to be able to run the allReady solution in Azure:

• An active Microsoft Azure account to deploy the web app. You can sign-up for a free trial of Azure here.

###Configure the web project

The AllReady project relies on configuration settings at runtime, such as whether to use a local database or an Azure SQL Database for data storage, whether to load sample data, default accounts information, and credentials for connecting to other services. These setting values can be stored in the project's config.json file. However, doing this makes it easier to accidentally expose secrets. ASP.NET 5 includes a secrets manager tool, and you should instead use this to locally store settings in your user account. When you publish the project to Azure Web Apps, you will need to set these same values as app settings in your web app.

Note: currently the codebase does not include any 'secret' values in configuration. Since we deploy both a dev and live site for this project via HTBox, we will configure 'production' values for testing and production environments. Additionally, we are working on how to best support open development with identity providers listed below for all contributors and will update this information when a full solution is found.

Configuration settings are accessed at startup using the Configuration property, which implements Microsoft.Framework.Configuration.IConfiguration. The following example gets the value of the InsertSampleData field that is a child of the Data node:

Configuration["Data:InsertSampleData"]

These topics show you how to use the secrets manager for app settings when running locally and how to add app settings in your web app in the Azure portal:

• Safe Storage of Application Secrets
• Enabling authentication using external providers
• Configure web apps in Azure App Service

The following app settings are used by the project.

####General settings

These settings control how the web app stores and seeds data:

####Data settings

These settings control how the web app stores and seeds data:

Settings in bold should be stored in the secrets manager.

####Authentication settings

These settings are the credentials for the app registrations of the social media platforms supported for authentication:

All of these settings should be stored in the secrets manager.

####Connected service settings

The following settings enable the web app to connect to other services:

All of these settings should be stored in the secrets manager.

###Configure the mobile app project

The URL of the AllReady web site is set in the domainUrl variable in the /www/app/services.js file.

###Run and test locally

Once you have set the required settings either in the config.json file or in the secrets manager, you can run and locally debug the projects. If you have not yet created a SQL Database in Azure, you should use either the in-memory data storage option or Data:DefaultConnection:LocalConnectionString as the connectionStringPath value in Startup.cs.

Currently there are hardcoded user accounts for limited testing (this will of course be changed soon) For now: "DefaultAdminUsername": "Administrator@example.com", "DefaultAdminPassword": "YouShouldChangeThisPassword1!", "DefaultUsername": "User@example.com", "DefaultTenantUsername": "tenant@example.com",

###Deploy to Azure

The AllReady project is designed to run hosted in Azure. The following sections describes the steps needed to get the AllReady web app running in Azure as you develop. Note that App Service Mobile Apps are currently available in the Azure Preview Portal.

Note: Again as with config, we will be hosting test and production instances of the application in the near future for tester contributors looking for instances of the application to test against and for others to reference. The instructions here are for self hosting in your own trial instance, if you choose, during development. However-- our goal is for all development to be able to be performed locally with alternatives or emulators for the online pieces.

####Create an Azure Web app

To publish the AllReady project to Azure, you must first create a new web app in an Azure App Service environment. To learn how to do this, see How to Create a Web App in an App Service Environment.

Once you have created your web app, you must create the required app settings. To run the site, you must create a connection string setting for Data:DefaultConnection:AzureConnectionString. To learn how to do this, see Configure web apps in Azure App Service.

####Create SQL Database

The next step is to create a new Azure SQL Database. To learn how to do this, see Create your first Azure SQL Database. Once you have created your database in Azure, make sure that Data:DefaultConnection:UseInMemory is set to false (or not set at all) and that Data:DefaultConnection:AzureConnectionString is set as the connectionStringPath value in Startup.cs.

Note: If you have created a firewall exception for your local computer, you can use this connection even when running on a local machine. For more information, see Step 5: Configure the firewall.

####Publish to Azure

Once you have your web app configured, you can publish the project to Azure. For more information, see Deploy a web app in Azure App Service.