shu8 / cap-editor

A web platform for creating, reviewing, managing, and publishing CAP v1.2-formatted emergency and hazard alerts.

Home Page:https://shu8.github.io/cap-editor/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

CAP Editor

Backend (API) Tests status Frontend (React) Tests status End-to-end tests

Build

Common Alerting Protocol logo

The CAP Editor is a web-based platform for creating, reviewing, managing, and publishing CAP v1.2-formatted emergency and hazard alerts.

It has been created in collaboration with the International Federation of Red Cross and Red Crescent Societies (IFRC) as part of the University College London (UCL) Industry Exchange Network (IXN) by Shubham Jain.

Features

  • Secure user authentication with 'magic links' and usernameless WebAuthn
  • Internationalised interface (English and French currently) using LinguiJS.
  • WMO Register of Alerting Authorities integration: users must be verified by their Alerting Authority to use the platform
  • Create draft alerts
  • Create multilingual alerts
  • User roles: composer (view/create/edit draft alerts), approver (viewc/create/edit/publish draft alerts), administrator (create/publish any alert)
  • User-friendly alert creation UI: individual steps, prefilled defaults, graphical map with circle/polygon drawing
  • WhatNow integration for pre-filled multilingual alert instruction and descriptions
  • Digital Signatures with XMLDSIG
  • Decentralised and easily deployable with Docker Compose

Please see the documentation site for full documentation on the system architecture, implementation details, development instructions, testing, and deployment information.

IMPORTANT: If you are using the CAP Editor to publish CAP alert feeds, you should get in touch with the IFRC to onboard with the IFRC Alert Hub, so your alerts can be aggregated and disseminated.

Screenshots

Dashboard:

Dashboard

Editor:

CAP Editor

Usage

This platform is for use by Alerting Authorities. It can be installed by individual regions/Alerting Authorities for a fully functional CAP Editor that works out-of-the-box, with built-in access rights management and security.

Architecture

This is a Next.js project.

In the below architecture diagram, the feed server is this Next.js app.

System Architecture

About

A web platform for creating, reviewing, managing, and publishing CAP v1.2-formatted emergency and hazard alerts.

https://shu8.github.io/cap-editor/


Languages

Language:TypeScript 96.7%Language:CSS 1.7%Language:JavaScript 0.6%Language:Shell 0.5%Language:PLpgSQL 0.2%Language:HTML 0.2%Language:Dockerfile 0.2%