Thanks to visit codestin.com
Credit goes to github.com

Skip to content

EXODESÉUS is a comprehensive application designed to deliver real-time news updates and offer emergency response features.

Notifications You must be signed in to change notification settings

TRSTN4/EXODESEUS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 

Repository files navigation

EXODESÉUS (Legacy / Version 1)

⚠️ Deprecated

This version of EXODESÉUS has been superseded by EXODESÉUS Essential,
which features a simplified Firebase-only architecture, Flutter-based cross-platform support, improved performance, and a plug-and-play household model.

👉 See: EXODESÉUS Essential for the current and actively maintained system.

EXODESÉUS Banner


What is included?

  • What is EXODESÉUS (Version 1) and how does it work?
  • System architecture overview
  • App Preview

What is EXODESÉUS (Version 1)?

EXODESÉUS is a comprehensive application designed to deliver real-time news updates and provide emergency response (SOS) features for selected households.

This document describes the original implementation of EXODESÉUS, including:

  • News scraping and storage
  • Centralized API and database usage
  • User-generated content
  • Emergency alert workflows

The app was available on:

  • iOS, developed in Swift
  • Android, developed in Kotlin

1. News Articles Handling

1.1 Data Collection

A Raspberry Pi continuously scrapes news data from multiple sources, including:

  • Sky News
  • LiveUaMap
  • Other monitored sources

The collected data is formatted and sent to a centralized API, hosted on Google Cloud Platform (GCP).


1.2 Storing Articles in the Database

Upon receiving data from the Raspberry Pi:

  • The API processes the incoming news content
  • Articles are stored in a centralized database
  • Stored articles become available for retrieval by users

News Source Data Flow


2. Retrieval by Users

When a user opens or refreshes the EXODESÉUS app:

  • The app sends a GET request to the API
  • The API retrieves relevant news articles from the database
  • The latest news is returned to the client

User Interaction With News


3. User-Generated Content

Version 1 allowed users to submit their own content.

How it worked:

  • Users could submit news articles or messages through the app
  • The app sent a POST request containing the user’s message
  • The API stored this content in the database
  • Submitted content became visible to other users

⚠️ Note:
User-generated content has been fully removed in EXODESÉUS Essential.

User Generated Content Flow


4. Emergency Response Features (SOS)

Available only for selected households.

4.1 SOS Functionalities

The app included an SOS tab integrated with:

  • Philips Hue lights
  • Sonos speakers

Integration was managed via Firebase, which stored device state values. These values were continuously monitored by the Raspberry Pi.


4.2 Activation Process

When an SOS alert was triggered:

  1. The app updated SOS-related values in Firebase
  2. The Raspberry Pi detected these changes
  3. Scripts were executed to activate:
    • Audio alerts via Sonos
    • Visual alerts via Hue lights

4.3 Alert to All Users

Upon SOS activation:

  • All users received an immediate notification
  • The app switched to a CODE RED ALERT screen
  • Normal app functionality was restricted to maintain emergency focus

4.4 Resolution of Alert

To exit CODE RED ALERT:

  • A unanimous decision from connected users was required
  • This voting mechanism prevented accidental or malicious deactivation

SOS Functionality and Response


5. Threat Monitoring

The Raspberry Pi performed continuous monitoring, including:

  • 24/7 DEFCON level tracking

If DEFCON 1 was detected:

  • CODE RED ALERT was triggered automatically
  • No user interaction was required

Monthly System Check

  • Runs every first Monday of the month at 12:00 PM
  • Duration: exactly 1 minute and 26 seconds
  • Ensures full system readiness

DEFCON Monitoring


6. Notifications

Users could opt in to receive notifications:

  • The app registered a Firebase Cloud Messaging (FCM) token
  • Tokens were used to deliver alerts and updates in real time

7. Access and Security

EXODESÉUS Version 1 was a closed application:

  • Access via invite keys only
  • Invite keys contained user-specific information
  • Available exclusively to selected households

Despite its closed nature, the system architecture allowed for rapid public deployment if required.


Legacy Summary

EXODESÉUS Version 1:

  • Used a centralized API and database
  • Supported user-generated content
  • Required per-household customization
  • Served as the foundation for later improvements

➡️ This version is now deprecated.
➡️ See EXODESÉUS Essential for the modern, maintained implementation.


App Preview (Legacy UI)

Below are images and GIFs showcasing how EXODESÉUS (Version 1) looked and behaved in practice.
These visuals are provided for reference and historical context only.


News Feed & Browsing

Automatically Posted Articles
View a continuous feed of war-related articles that are automatically uploaded to the app. Scroll to explore extensive content.


Article Presentation Examples
Visual examples demonstrating how articles are displayed within the app.


User Interaction (Legacy Feature)

Create and Update Messages
Users could instantly post messages within the app and update them as new information became available.


Navigation & Filtering

Filter Articles by Category
Use the top navigation bar to filter the news feed by category, displaying only relevant articles.


Source Transparency
Each article includes a source button, allowing users to quickly verify where the information originated.


Notifications

Category-Based Notifications
Users could manage notifications per category, enabling or disabling alerts based on personal preferences.


SOS & Emergency Features

Hue Light Red Alert
Activate a red alert across all connected Philips Hue lights for immediate visual warning.
(Available only to households with Philips Hue)


Sonos Panic Mode
Trigger Panic Mode to play an SOS signal through all connected Sonos speakers.
(Available only to households with Sonos devices)


Full SOS Mode
Enable all emergency systems at once: Hue lights, Sonos speakers, app-wide SOS lock, and notifications for all household members.


SOS Activity Logging
All SOS-related actions are logged, providing a clear activity history for review.


⚠️ Note
The UI, layout, and interaction model shown above belong to the deprecated legacy version.
The current and actively maintained version is EXODESÉUS Essential, featuring a redesigned UI, improved performance, and full cross-platform consistency.


About

EXODESÉUS is a comprehensive application designed to deliver real-time news updates and offer emergency response features.

Topics

Resources

Stars

Watchers

Forks