A platform that allows humanitarian organisations to manage relief items (Food, Non Food Items, CASH) to people in need for life-saving humanitarian responses to emergency situations.
Humansis is the first fully open-source relief platform for humanitarian actors to efficiently manage relief operations after a disaster, during a war or in response to long term crises.
This repo is the "master" repo for all Humansis-related projects. It hosts the documentation, the frontend and other misc. Code for other projects, like the API is hosted in other repositories.
We welcome contributions from anyone who acts in good faith and in a respectful manner and adds value to the project.
We are looking for collaboration from the Open Source community! There's so much we want to do, including but not limited to: enhancing existing applications with new features, optimizing the technical tools and algorithms involved to accommodate humanitarian challenges, and bringing our work closer to the public to leverage their inputs via blog posts and tutorials.
- Please read our contribution guidelines for details on what and how you can contribute.
- Check out our Trello Development Project Board.
- Look for tasks labelled
good first issuesunder the Issues tab in each repo.
We are hoping to establish a more user-friendly version soon, one that is readable by our potential users (e.g. developers and humanitarian actors).
To understand Humansis better:
- Read the README for each repo. An architecture diagram of how these components are connected to one another is coming soon.
This project was generated with Angular CLI version 6.2.3.
Run ng serve -o for a dev server. Navigate to http://localhost:4200/. The app will automatically reload if you change any of the source files.
Run ng build --prod to build the project. The build artifacts will be stored in the dist/bms-front directory.
You need to set up a s3 bucket and make sure "Static website hosting" is enabled as well as public access to read data.
A simple tutorial for reference: https://medium.com/codefactory/angular2-s3-love-deploy-to-cloud-in-6-steps-3f312647a659
To push the build code to S3 Bucket: aws s3 cp ./dist/bms-front s3://your-s3-bucket --recursive --acl public-read
A script has been created to compress and upload the project to the S3 bucket.
Run ng test to execute the unit tests via Karma.
Run ng e2e to execute the end-to-end tests via Protractor.
To get more help on the Angular CLI use ng help or go check out the Angular CLI README.
- Drag and drop doesn't work in Mozilla
This project works with Docker. Pay attention to the @angular/cli version in your package.json file and make sure it corresponds to the one in the Dockerfile.
To start coding in a safe environment, please launch the docker container with the following command:
sudo docker-compose up devappIf it's the first time, please run
sudo ./docker-build.sh bms/frontThe code follows the specifications explained here.