EMSUGI

EMSUGI

Daftar isi

• Ikhtisar Proyek
• Fitur Utama
• Tangkapan layar
• Memulai
  • Tumpukan Teknologi
  • Instalasi
  • Berjalan dengan Docker
  • Struktur Folder
• Penggunaan
• Berkontribusi
• Lisensi MIT

Ikhtisar Proyek

EMSUGI adalah aplikasi canggih yang dirancang untuk mengumpulkan dan menganalisis peringatan darurat dari berbagai sumber. Teknologi ini memanfaatkan AI generatif untuk memprediksi insiden di masa depan berdasarkan data historis dan tren saat ini. Sistem ini bertujuan untuk meningkatkan efisiensi tanggap darurat dengan memberikan laporan mendalam dan analisis visual.

Jika Anda menyukai proyek ini, jangan lupa memberi bintang pada repo ini dan fork jika Anda ingin berkontribusi! Kontribusi dan dukungan Anda sangat dihargai!

Fitur Utama:

• Pemantauan Peringatan Waktu Nyata : Mengambil dan menyimpan peringatan darurat di berbagai negara.
• AI Generatif : Menerapkan AI untuk menganalisis dan menghasilkan prediksi insiden darurat di masa depan.
• Representasi Grafis : Menampilkan data menggunakan bagan dan grafik, memungkinkan pengguna memvisualisasikan metrik utama.
• Pilihan Rentang Tanggal/Waktu Interaktif : Memungkinkan pengguna mengatur rentang tanggal dan waktu khusus untuk pembuatan laporan.
• Analisis Kata Kunci dan Topik : Mengidentifikasi kata kunci dan topik populer berdasarkan negara dan wilayah.
• Desain Responsif : Mendukung tata letak yang ramah seluler dan responsif untuk melihat laporan.

CATATAN: Fitur-fitur ini didasarkan pada tujuan proyek di masa depan sehingga kinerja dan fitur sebenarnya dapat bervariasi karena fase pengembangan aktif

Tangkapan layar

Berikut adalah beberapa tangkapan layar yang menunjukkan fitur dan tata letak sistem:

CATATAN: Tangkapan layar ini mencerminkan keadaan perkembangan proyek saat ini dan dapat berubah di masa mendatang seiring dengan perkembangan fitur dan peningkatan yang dilakukan.

Memulai

Tumpukan Teknologi:

• Python (Versi 3.x atau lebih tinggi): Bahasa pemrograman tingkat tinggi yang kuat yang digunakan untuk pengembangan backend.
• Flask : Kerangka web ringan untuk membangun aplikasi web dengan Python.
• pandas : Pustaka manipulasi data yang menyediakan struktur data yang kuat untuk analisis data.
• matplotlib : Pustaka plot populer yang digunakan untuk membuat visualisasi statis, animasi, dan interaktif.
• gemini : Alat bertenaga AI untuk pembuatan laporan generatif, digunakan untuk membuat laporan darurat dan bencana.
• torch : Kerangka pembelajaran mendalam yang menyediakan alat yang fleksibel dan efisien untuk melatih dan menerapkan model pembelajaran mesin, khususnya untuk inferensi model lokal.
• transformator : Perpustakaan oleh Hugging Face untuk bekerja dengan transformator terlatih dan model pembelajaran mesin canggih lainnya.
• logly : Alat pencatatan dan pemantauan yang digunakan untuk melacak dan mengelola log dalam aplikasi.
• python-dotenv : Alat untuk mengelola variabel lingkungan, memungkinkan konfigurasi informasi sensitif (kunci API, token, dll.) dalam file .env .
• SQLite : Database ringan berbasis disk untuk menyimpan dan mengambil data untuk aplikasi.
• Tailwind CSS : Kerangka kerja CSS yang mengutamakan utilitas untuk merancang antarmuka web modern yang responsif dan modern dengan cepat.
• Font Awesome - Pustaka ikon yang digunakan untuk menambahkan ikon vektor yang dapat diskalakan di UI.
• Chart.js - Pustaka JavaScript untuk membuat bagan interaktif dan dapat disesuaikan untuk visualisasi data.

Instalasi:

1. Kloning repositori:

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

2. Instal dependensi:

   pip install -r requirements.txt

3. Jalankan UI Web Flask:

   python launch.py

4. Buka browser Anda dan buka:

    http://127.0.0.1:5000/
   

Berjalan dengan Docker

Jika Anda ingin menjalankan proyek ini menggunakan Docker, lihat file docker_readme.md untuk panduan langkah demi langkah dalam membangun, menjalankan, dan mengelola aplikasi EMSUGI dalam kontainer Docker.

Struktur Folder:

 .
├── 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 

Penggunaan

• Buka aplikasi di browser Anda.
• Masukkan rentang tanggal dan waktu untuk menghasilkan laporan.
• Visualisasikan hasilnya dalam berbagai format grafis.

Berkontribusi

Kami menyambut kontribusi! Jangan ragu untuk mengirimkan masalah dan menarik permintaan untuk meningkatkan proyek. Saat berkontribusi, pastikan untuk mengikuti Kode Etik kami untuk menjaga lingkungan yang saling menghormati dan kolaboratif bagi semua kontributor.

Lisensi 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.

Untuk lebih jelasnya, silakan lihat LISENSI selengkapnya.