The allReady application is implemented as a Visual Studio 2017 solution that contains two projects: an ASP.NET Core 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
• 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

AnASP.NET Core 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 Core 2.0 using .NET Core 2.0. 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

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

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

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 of web site mobile app users leverages OAuth 2.0 with credentials from external authentication providers such as Facebook, Twitter, Google or Microsoft. Users can use their existing social media accounts to sign into the web site or mobile app. For more information, seeEnabling authentication using external providers.

The mobile app project was added to the allReady solution as aVisual 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
  • BarcodeScanner
• Ionic: enhancements for Cordova apps
• Moment.js: working with date-time values

The app accesses theWeb 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.

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

You will need several prerequisites in order to run the allReady solution locally. Please see thePrerequisite Install Guide for details on what to download, install and configure to get started.

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 Azurehere.

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 theConfiguration property, which implementsMicrosoft.Framework.Configuration.IConfiguration. The following example gets the value of theInsertSampleData field that is a child of theData 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.

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

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

Settings inbold should be stored in the secrets manager.

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

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

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

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

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 useData:DefaultConnection:LocalConnectionString as theconnectionStringPath 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!" (all accounts use this default password)
• "DefaultUsername": "User@example.com"
• "DefaultOrganizationUsername": "organization@example.com"

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 theAzure 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.

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, seeHow 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 forData:DefaultConnection:AzureConnectionString. To learn how to do this, seeConfigure web apps in Azure App Service.

The next step is to create a new Azure SQL Database. To learn how to do this, seeCreate your first Azure SQL Database. Once you have created your database in Azure, make sure thatData:DefaultConnection:AzureConnectionString is set as theconnectionStringPath 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, seeStep 5: Configure the firewall.

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