Skip to content

huynguyenjv/V-RELIEF

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

58 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

V-RELIEF

V-RELIEF

VIETNAM DISASTER RELIEF SYSTEM

Explore the docs ยป

๐Ÿ› Report Bug | โœˆ๏ธ Request Feature | ๐Ÿ’ฌ Join Our Telegram | ๐Ÿ“š Read Wiki | ๐Ÿ“‹ Roadmap

V-RELIEF issues V-RELIEF license Colab Gitpod Telegram

Preview


SonarCloud Pulumi

Features

  • ๐Ÿ“– Document Organization and Linking
  • ๐Ÿ“ฆ Terminology Extraction
  • ๐Ÿ” Quick Search for Related Content
  • ๐Ÿค– User Query Support

Table of Contents

Expand contents

What is V-RELIEF?

V-Relief is an innovative emergency response and disaster recovery platform designed to support communities in Vietnam during and after natural disasters such as storms and floods. The platform integrates real-time disaster tracking, utilizing tools like Windy Maps for monitoring and visualizing storm paths, and Goong Maps for pinpointing user locations and nearby relief centers. V-Relief streamlines essential supply distribution, allowing affected individuals to register their needs, while volunteers can offer services like transportation and first aid through an interactive community support map. With n8n automating workflows and notifications, the system efficiently connects those in need with resources and assistance. Additional features, such as damage area lookup, self-rescue knowledge databases, and social media integration, ensure comprehensive support, fostering resilience and coordinated relief efforts across Vietnam.

Sparkline

V-Relief is a comprehensive disaster response and recovery application designed for Vietnam, providing critical support during and after natural disasters such as storms and floods. Built on a Microservice Architecture , V-Relief leverages Generative AI to analyze disaster-related data and optimize resource allocation. It features an intelligent Question Answering system to address user inquiries about relief efforts, emergency procedures, and self-rescue knowledge. Developed using Open Source technologies, the platform ensures transparency and flexibility. Deployed on Cloud infrastructure, V-Relief delivers real-time data processing, seamless scalability, and reliable access for both victims and volunteers, enhancing coordination and resilience across affected communities.

If you want to find out more about the contest, please visit the VFOSSA website.

Preview

Tentative technologies

Building blocks

We used Microservice Architecture to build this project to make it easier to scale and maintain. The following diagram shows the architecture of the project.

Architecture

Getting Started

๐Ÿ› ๏ธ Prerequisites

Infrastucture

  • Nodejs - Node.jsยฎ is a JavaScript runtime built on Chrome's V8 JavaScript engine.
  • npm - Fast, disk space efficient package manager.
  • Python - Python is a programming language that lets you work quickly and integrate systems more effectively.
  • N8N - Poetry helps you declare, manage and install dependencies of Python projects, ensuring you have the right stack everywhere.
  • Pulumi - Pulumi is a manage infrastructure, secrets, and configurations intuitively on any cloud.
  • Docker (Kubernetes Enabled) - Docker is an open platform for developing, shipping, and running applications.
  • Helm - Helm is the best way to find, share, and use software built for Kubernetes.

๐Ÿง‘โ€๐Ÿ’ป Setup

First, clone the repository to your local machine:

git clone https://github.com/huynguyenjv/V-RELIEF

Next, navigate to the root directory of the project and install the dependencies:

npm install --force

๐Ÿš€ Running

For the website, you can run the following command:

npm run dev

Important

If you want to run with Nx, make sure you have installed `poetry` globally. Python version must be `>=3.9.1 <=3.12`.

Contributing

๐Ÿ“– Contributing Guidelines

We are excited that you are interested in contributing to this project! Before submitting your contribution, please make sure to take a moment and read through the following guidelines:

Read through our contributing guidelines to learn about our submission process, coding rules, and more.

๐Ÿ’ Want to Help?

Want to report a bug, contribute some code, or improve the documentation? Excellent! Read up on our guidelines for contributing and then check out one of our issues labeled as help wanted or good first issue.

๐Ÿซ‚ Code of Conduct

Help us keep HutechFoss pen and inclusive. Please read and follow our Code of Conduct.

Support and Organization

Hutech Hutech Husc ICPC

License

This project is licensed under the terms of the GNU license.

About

APPLICATION FOR EMERGENCY ASSISTANCE AND SUPPLY OF NEEDS AFTER A DISASTER

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors