= !BluePrint: AlertHub module of SAMBRO =
[[TOC]]

== Introduction
Alerthub builds on [https://sahanafoundation.org/SAMBRO/ SAMBRO] and the [http://eden.sahanafoundation.org/wiki/UserGuidelines/Messaging Messaging] module. One can configure the Alerthub to receive messages through CAP, RSS/Atom, Twitter, Facebook news feeds to, then, aggregate all those alerts for various information needs. It is intend to serve as a [https://sahanafoundation.org/philippines-sambro-dissemination-workshop/ one-stop-shop for all your alerts]. The alerts will be classified for the ease of filtering and drilling down into desired sets of spatial and temporal data. Moreover, the classification and other statistical analysis will provide insightful information for improved [https://sahanafoundation.org/tag/cross-agency-situational-awareness/ cross-agency situational-awareness].

== Requirements
1. Register an alert feed as CAP, RSS/Atom, and Twitter
1. Stage them in a database and sanitize the data for processing
1. Develop various views and APIs mainly for
   1. generating exports in CSV and JSON formats
   1. automation (e.g. extracting data for running the classifier)
1. Implement standard EDEN reporting tool for generating cross-tabs and charts for SAMBRO Alerthub data.  

=== Functional

=== Interoperability

=== Visualization

== Use-Cases

=== Actors and Use-cases

=== Roles

||= Actor =||= Role =||
||Administrator ||Install and manage updates, database migrations, and other routine maintenance ||
||Feed Manager ||add and edit news feeds; mainly from CAP, RSS/Atom, and Twitter  feeds ||


=== Diagram

== Design

=== GUI

=== Process Flow

=== Eden model

=== Mandatory Modules

=== Alerthub specific modules

== Implementations
1. [http://eden.sahanafoundation.org/wiki/BluePrint/CAPBroker/Philippines Philippine Atmospheric Geophysical and Astronomical Service Administration (PAGASA)] - is implemented to serve as the [https://sahanafoundation.org/philippines-sambro-dissemination-workshop/ Philippines National Alerthub], a one-stop-shop for alert. 
1. [http://cap.sahana.io/ GRAB - Globally Relayed Alerts and Bulletins] has been collecting data, on a prototype basis.

== References
1. [https://s3-eu-west-1.amazonaws.com/alert-hub/index.html WMO Filtered Alerthub]
1. [https://github.com/waidyanatha/IAN/wiki github code of IAN prototype] 

== Notes

== Current status
[https://github.com/nursix/sambro Alerthub releases on Nursix] [[br]]


=== Available features
1. Map view of alerts with filtering
1. Table view of alert with filtering
1. CAP RSS and Atom feed register
1. RSS and Atom (non-CAP) feed register
1. Twitter feed register
1. Facebook feed register


=== Missing features
1. Spatial and Temporal filter widget to focus in on a particular time and space