EMSUGI

EMSUGI

Table des matières

• Aperçu du projet
• Principales fonctionnalités
• Captures d'écran
• Commencer
  • Pile technologique
  • Installation
  • Exécuter avec Docker
  • Structure des dossiers
• Usage
• Contribuer
• Licence MIT

Aperçu du projet

L' EMSUGI est une application sophistiquée conçue pour recueillir et analyser les alertes d'urgence provenant de diverses sources. Il exploite l’IA générative pour prédire les futurs incidents sur la base de données historiques et des tendances actuelles. Ce système vise à améliorer l’efficacité des interventions d’urgence en fournissant des rapports perspicaces et des analyses visuelles.

Si vous aimez ce projet, n'oubliez pas de mettre en vedette ce repo et de le forker si vous souhaitez contribuer ! Vos contributions et votre soutien sont grandement appréciés !

Principales caractéristiques :

• Surveillance des alertes en temps réel : récupère et stocke les alertes d'urgence dans différents pays.
• IA générative : met en œuvre l'IA pour analyser et générer des prévisions futures d'incidents d'urgence.
• Représentation graphique : affiche les données à l'aide de tableaux et de graphiques, permettant aux utilisateurs de visualiser les indicateurs clés.
• Sélection interactive de plages de dates/heures : permet aux utilisateurs de définir des plages de dates et d'heures personnalisées pour la génération de rapports.
• Analyse des mots-clés et des sujets : identifie les mots-clés et les sujets populaires par pays et région.
• Conception réactive : prend en charge une mise en page adaptée aux mobiles et réactive pour l'affichage des rapports.

REMARQUE : Ces fonctionnalités sont basées sur l'intention future du projet, de sorte que les performances et les fonctionnalités réelles peuvent varier en raison des phases de développement actives.

Captures d'écran

Vous trouverez ci-dessous quelques captures d'écran montrant les fonctionnalités et la disposition du système :

REMARQUE : Ces captures d'écran reflètent l'état actuel du développement du projet et peuvent changer à l'avenir à mesure que les fonctionnalités évoluent et que des améliorations sont apportées.

Commencer

Pile technologique :

• Python (version 3.x ou supérieure) : un langage de programmation puissant de haut niveau utilisé pour le développement backend.
• Flask : Un framework Web léger pour créer des applications Web en Python.
• pandas : Une bibliothèque de manipulation de données qui fournit des structures de données puissantes pour l'analyse des données.
• matplotlib : Une bibliothèque de traçage populaire utilisée pour créer des visualisations statiques, animées et interactives.
• gemini : Un outil basé sur l'IA pour la génération de rapports génératifs, utilisé pour créer des rapports d'urgence et de catastrophe.
• torch : Un framework d'apprentissage profond qui fournit des outils flexibles et efficaces pour former et déployer des modèles d'apprentissage automatique, en particulier pour l'inférence de modèles locaux.
• transformateurs : une bibliothèque de Hugging Face pour travailler avec des transformateurs pré-entraînés et d'autres modèles d'apprentissage automatique de pointe.
• logly : Un outil de journalisation et de surveillance utilisé pour suivre et gérer les journaux au sein des applications.
• python-dotenv : Un outil de gestion des variables d'environnement, permettant la configuration d'informations sensibles (clés API, tokens, etc.) dans un fichier .env .
• SQLite : une base de données légère basée sur disque pour stocker et récupérer des données pour l'application.
• Tailwind CSS : un framework CSS axé sur les utilitaires pour concevoir rapidement des interfaces Web réactives et modernes.
• Font Awesome - Bibliothèque d'icônes utilisée pour ajouter des icônes vectorielles évolutives dans l'interface utilisateur.
• Chart.js - Bibliothèque JavaScript pour créer des graphiques interactifs et personnalisables pour la visualisation des données.

Installation:

1. Clonez le dépôt :

   git clone https://github.com/muhammad-fiaz/EMSUGI.git
   cd EMSUGI

2. Installez les dépendances :

   pip install -r requirements.txt

3. Exécutez l'interface utilisateur Web de Flask :

   python launch.py

4. Ouvrez votre navigateur et accédez à :

    http://127.0.0.1:5000/
   

Exécuter avec Docker

Si vous souhaitez exécuter ce projet à l'aide de Docker, consultez le fichier docker_readme.md pour un guide étape par étape sur la création, l'exécution et la gestion de l'application EMSUGI dans un conteneur Docker.

Structure des dossiers :

 .
├── launch.py                  # Launch Flask application
├── modules/                # Application modules
│   ├── api/                # API endpoints
│   │   ├── __init__.py    # Initialize API endpoints
│   │   ├── loading.py      # Loading API endpoint
│   │   ├── cancel_process.py      # Cancel the report generation process
│   │   .
│   │   .
│   ├── fetch_alerts.py     # Fetch report from online
│   ├── generate.py  # Generate report
│   ├── process.py  # Process the report
│   ├── router.py  # Router for the application
│   ├── db.py # Database connection
│   ├── download.py # Download the models
│   ├── async_worker.py # Async worker for the application
│   ├── routes/            # Application routes
│   │   ├── __init__.py    # Initialize application routes
│   │   ├── index_page.py      # Index Page route
│   │   ├── report_page.py      # Report Page route
│   │   ├── analytics_page.py      # Analytics Page route
│   │   ├── notice_page.py      # Notice Page route
│   │   ├── license_page.py      # License Page route
│   │   ├── records_page.py      # Records Page route
│   │   ├── reports_page.py      # Reports Page route
│   ├── utils/              # Utility functions
│   │   ├── __init__.py    # Initialize utility functions
│   │   └── progress.py     # Progress utility functions
│   │   └── check_for_cancel.py # Check if the report generation has been canceled
│   │   .
│   │   .
├── templates/              # Contains HTML templates
│   └── index.html          # Main HTML file
├── static/                 # Static files (CSS, JS, images)
│   ├── styles.css          # Global styles
├── create_database.py      # Used to create DB
├─��� database_alerts.db      # Stored Database
├── Dockerfile              # Docker configuration file
├── CODE_OF_CONDUCT.md      # Code of conduct for contributors
├── LICENSE                 # Open-source license for the project
├── pyproject.toml          # Python project configuration file
├── docker_readme.md        # Instructions for using Docker
└── README.md               # Project documentation 

Usage

• Ouvrez l'application dans votre navigateur.
• Entrez une plage de dates et d'heures pour générer des rapports.
• Visualisez les résultats dans différents formats graphiques.

Contribuer

Nous apprécions les contributions ! N'hésitez pas à soumettre des problèmes et des demandes de tirage pour améliorer le projet. Lorsque vous contribuez, assurez-vous de suivre notre code de conduite afin de maintenir un environnement respectueux et collaboratif pour tous les contributeurs.

Licence MIT

 Copyright (c) 2024 Muhammad Fiaz

Permission is granted, free of charge, to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, subject to the condition that the copyright notice and this permission notice are included in all copies.

The software is provided "as is", without warranty of any kind, express or implied, including but not limited to warranties of merchantability, fitness for a particular purpose, and noninfringement. In no event shall the authors be liable for any claims or damages.

Pour plus de détails, veuillez vous référer à la LICENCE complète.