discoos / sar-status-personnel

A system that gives an overview of which SAR-personell are available at any time

sar-status-personnel

Hybrid-app in Ionic / Cordova for SAR personnel

Requirements

You need to have following assets available on PATH to build this app

• Node 7+, install Node
• Ionic 2, install Ionic
• Gradle 4, install Gradle
• Java JRE or SDK 8, install Java
• Android SDK Platform 25, install Android Studio
• Xcode, install Xcode
• ios-deploy, install ios-deploy (use npm)
• CocoaPods, install CocoaPods

After installing Ionic2, use the following command to check requirements

$ cordova requirements

This should produce an output similar to this

Requirements check results for android:
Java JDK: installed 1.8.0
Android SDK: installed true
Android target: installed android-25,android-24,android-23
Gradle: installed /path/to/gradle

Requirements check results for ios:
Apple OS X: installed darwin
Xcode: installed 8.3.3
ios-deploy: installed 1.9.1
CocoaPods: installed

Android

Running in emulator

In order to test app on Android run following commands.

$ yarn
$ ionic cordova platform add
$ ionic cordova run android

Release to Google Play

Since this repo is public you need to fist get PRIVATE signing keys release-signing.properties, sar-status-personnel.jks and place them into platforms/android/. Once done you can release the app with following command.

Before every release remember to increace build number in config.xml

$ ionic cordova build android --prod --release

Upload platforms/android/build/outputs/apk into Google Play.

iOS

Running on emulator

$ ionic cordova run ios
$ ionic cordova run ios --device

Release to App Store

Follow this guide https://ionicframework.com/docs/intro/deploying/ .

$ ionic cordova platform add ios
$ ionic cordova build ios

sar-status-personnel's Issues

Rename from SAR User to SAR Personnel

SAR User is to general. SAR Personnel is more accurate labeling of the people using this application.

Integrate UMS Voice and SMS

Alerts sent using UMS Voice and SMS.

Geolocation is not working as expected

At this stage, geolocation is just a "proof-of-concept" and needs further work and testing

Show response to callout in SAR User

When you respond to a callout in SAR User, the status is not shown afterward in the app.

Synchronize status across multiple parallel logins

It is possible to login from multiple apps, on multiple devices and in multiple locations. This should be handled in an consistent manner, where at minimum the status is automatically synchronized across all online devices. Today, duplicate responses are added to the list of responses in SAR Admin for each new "yes" or "now" from same user from different app. Is state is synchronized, only the first app should be able to respond, all other should be updated with the response.

List all alerted users regardless of status

Alerted users are not shown until they respond. We need to see the status of all recipients all the time.

Generalize apps and facilitate branding

Remove organization-specific symbols and add support for branding on org-level (symbol and name).

Position not shown in map when user responds with "yes"

See operations https://sar-admin.herokuapp.com/mission-active/9

Replace font-face MyriadPro

MyriadPro requires an annual license of $29.99 for use on web (see https://typekit.com/fonts/myriad), which is unreasonable for this project at this time. We need to replace it with something similar. After some research, it seems like

• Vagur (see http://www.cufonfonts.com/en/font/12046/vegur)
• PT Sans (see comparison http://joelcrawfordsmith.com/closest-font/font/myriad-pro, and specimen at https://fonts.google.com/specimen/PT+Sans?selection.family=PT+Sans)
• Source Sans Pro (see specimen at https://fonts.google.com/specimen/Source+Sans+Pro)

are all good alternatives.

Add number of unseen callout on tabs "active" and "closed" in "my callouts" page

When opening the SAR User application, the "my calloutss" icon should be marked with a red number indication the number of callouts not responded to. When opening the "my callouts" page, the number should also be shown in tabs "active" and "closed", see sketch below

Add "Logout" to "My profile" page

Makes it possible to log out without exiting the app.

Add "alerted" and "alerts" columns to list of alerted users

Each user can be alerted multiple times. We should add a column with timestamp of last alter sent to user, and the number of times the user is alerted.

Can't enter phone number in SAR User test version

Downloaded the test version on a Samsung A5, and can't enter my phone number at the profile page.

Move "callouts" component to flow right of "mission info" component

Closed callouts disappears in SAR User after a while

The exact time it takes is not known, but the following operations are not shown for [email protected], which was alerted and responded with "yes"

• https://sar-admin.herokuapp.com/mission-active/7
• https://sar-admin.herokuapp.com/mission-active/8

Store config vars in environment

According to factor III in the twelve-factor app, we should

Store config in the environment

This prevents us from storing sensitive configuration data like API-keys and passwords in the code which is publicly available. This however, requires us to rethink how we handle configuration. Today we use the same custom CONFIG-object in every environment which is imported whenever needed. This CONFIG should only contain default values to allow for local setup and running automatic tests. Only non-sensitive config data should be stored in git. The rest should be stored in each environment the application or the test runs, typically overriding the default values. Since this is a front-end application, process.env.* isn't available at runtime in the browser. We therefore need a solution which simulates process.env.* in the browser, injected with values only available in the server, or during build and test.

Inject config during build

• Make the app environmentally aware using Angular 2 built inn support for this
• Make each environment module read config values from global variable env.* defined in env.js
• Make CONFIG object read config values from environment module
• Add env.js as an external app asset inindex.html
• Generate env.js from process.env.* using Ionic hooks
• Build the app

References

• Angular 2 and environment variables
• Angular 2: Application Settings using the CLI Environment Option
• External JavaScript dependencies in Typescript and Angular 2
• Angular-CLI Meets Webpack

Restructure sar-status repo to sar-status-personnel

Current structure is making it hard to find which repos belongs to the sar-status project. All repos are prefixed with sar-*, which is much to inclusive, since several other projects already use this prefix, and more are expected to come. Two solutions are possible

1. Namespacing - change repo names to sar-status-api, sar-status-user, sar-status-admin
2. Move all to one repo - all three are merged into one with subdirs api, user and admin

Add filter "not-alerted" to prevent multiple callouts

We should add a "not-alerted" filter to the list of users to alert and activate this as default to prevent multiple callouts.