Code Monkey home page Code Monkey logo

reliefsupports.org-v1's Introduction

ReliefSupports Platform

This is a community-driven Open Source project to support relief support activities conducted by volunteers. This project was originally created to support flood relief activities in Sri Lanka in May 2017. We are revamping the entire platform at the moment to mainly focus on supporting the economic and humanitarian crisis we are about to face in Sri Lanka.

We welcome your innovative ideas, codeing and non-coding contributions and suggestions to build a better platform.

How to Contribute

Setting up the development environment

Prerequisites

  • Install Node.js and MongoDB on your workstation.
  • We use Yarn as we use yarn-workspaces

Clone the main repository

git clone [email protected]:reliefsupports/reliefsupports.git
cd reliefsupports
yarn // will install all the dependencies for all the apps at once

Set /web/.env file.

Copy .env.example to .env and update necessary values (Firebase)

Run the application

yarn start // will start server and web at once

Frontend on ::3000 and Backend ::3001/api

Guidelines

  • Primary branch is master, and strongly recommend to avoid pushing changes to master branch directly.
  • Follow proper naming conventions always
  • Alyways put active WIP PRs in draft stage
Branch names
  • Use feat/<awasome-feature>-[issue-id] naming conventions for feature branches
  • Use fix/<good-fix>-[issue-id] for bug fixes
  • Use chore/<task>-[issue-id] for regular tasks
PR naming
  • Use feat: <My Awesome Feature> naming conventions for feature titles
  • Use fix: <That fix> for fixes
  • Use chore: <Regular Task> for regular tasks
Commit messages
Issues

Apply labels appropriately for each issues when created:

  • epic
  • story
  • bug
  • feature
  • feature-request
  • enhancement
  • documentation
  • question
  • help wanted

Components:

  • comp:frontend
  • comp:server

Labels for maintainers:

  • wontfix
  • invalid
  • good first issue
  • duplicate
  • freez

Priorities:

  • priority:high
  • priority:medium
  • priority:low

API Docs

Check postman collection

License

MIT

reliefsupports.org-v1's People

Contributors

chamilad avatar chathula avatar cloudypadmal avatar danishka avatar heimdallrj avatar ishanthilina avatar naveenmadhawa avatar paarandika avatar pathumego avatar sathinduga avatar shashika avatar thilinag avatar thinkholic avatar thpubs avatar yoosuf avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

reliefsupports.org-v1's Issues

Searching

We need some ways to search the stuff in the forum.

[Reports] Export, Download spreadsheets listing needs & supplies

As we don't have a proper supplier>need linking method, better if there is a feature to download two spreadsheets , ආධාර & අවශ්‍යතා , so our volunteers can match them manually & notify.. may be a quick fix for linking both parties , will be useful because building proper linking method in app surely takes some time

Categories

For both donations and needs, we may need to supply a set of categories.
And users should be able to filter them as well.

SMS Alerts for registered users

Warning/Alerting service to registered users.
Only send messages receiving from a trusted source such as DMC or other know party.

Register transport

We should maintain a list of people who willing to provide transport

  1. Name
  2. Contact details
  3. Nearest city
  4. Availability (willing to travel any location or limited area)
  5. Possibility of serve any time
  6. Type of transport (car, boat, van, motorbike, truck, bus, 4x4, 3wheeler, other)
  7. With fuel (if motor vehicle)

Validations

  • Review all validations
  • 'Submit' button should be green once required fields filled

!!! Need developers. (Please read before you create an issue)

Guys, I think the developers of this app need help in coding. Before you create an issue or suggest a feature, please see whether you can implement it yourself and if you can, please clone the project and try it. It would be a great help for these guys.

Register relief camp

  1. Main contact
    Name, contact details
  2. Location
    Address, Nearest city/village
    Geolocation
    How to reach the place
  3. Initial data
    Number of heads > there should be a way to get registration at camp.
  4. Requirements
  5. Special requirements
  6. Availability of people with special need
  7. Number of toilets
  8. Showers

FREE hosting

I'm working on a hosting company.
I can talk with them to give us FREE unlimited hosting.
Let me know, if you guys need it.

Search for help

With this feature people who wants help can search about relief groups and get the nearest one who can help them

Fix layout to suite for mobile devices

Mobile browsers do not render the tables in a readable way since they seem to have fixed widths. There might be a chance that most interactions happen through those devices and not with full resolutions available.

Mobile Application

  1. Registrations
  2. Retrieve data
  3. Notifications
  • Update users who willing to know new requests
  • Update users who expecting relevant offers

Share on Social Media.

Add sets of icons and integrate social media websites so users can share donation requests on their social media profiles.

Avoid duplicates when adding needs and donations

When adding needs and donations show previously added matching results with the information that user enter to form currently.
same as the stackoverflow do when asking questions. they show list of previous questions matching to the current typed title below the submit form, then user can avoid adding that again and again.

Integrate google (or any other) map

Shall we integrate a map to the system, people may add the location when they enter data, and we can have all the locations of the needs and supplies in a single map. This will help to get an idea at a glance.

A map might not be useful to find the direction at this disastrous moment, but I feel that it would be of some help.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.