Skip to content

openfoodfacts/nutripatrol

Repository files navigation

NutriPatrol πŸ›‘οΈ

A collaborative tool to monitor and improve food product data on Open Food Facts.

NutriPatrol is a web-based application designed to help the Open Food Facts community ensure the quality and accuracy of the data in the world's largest open database of food products. It allows users to easily patrol recent changes, spot inaccuracies, and contribute to making the food supply chain more transparent.

Production: https://nutripatrol.openfoodfacts.org Pre-production: https://nutripatrol.openfoodfacts.net

This is the backend

🌟 About the Project

The goal of NutriPatrol is to gamify the process of data verification for Open Food Facts. Moderators can quickly swipe through recent reports, to act on true issues and mark them as fixed, or flag incorrect ones as not a problem. This helps maintain the integrity of the data that powers countless apps and research projects related to food, nutrition, and health.

Key Features:

  • πŸ•΅οΈβ€β™€οΈ Patrol Recent Reports: Quickly review and verify edits made to products.
  • βœ… Approve or Flag from many places: Basic integration is available in the website (openfoodfacts-server), being added to openfoodfacts-explorer and the mobile app (smooth-app)
  • πŸ“± Mobile-Friendly: A responsive design that works on any device.

πŸš€ Getting Started

To get a local copy up and running, follow these simple steps.

Prerequisites

Installation

  1. Clone this repository :
git clone https://github.com/openfoodfacts/nutripatrol.git
cd nutripatrol

Run with docker containers

Make docker containers

make up

Your local instance of NutriPatrol should now be running at http://localhost:3000.

Authentication for local dev

To test with a global instance of Product Opener

In .env file uncomment the AUTH_SERVER_STATIC variable. If you want to use a local Product Opener Instance, use http://world.openfoodfacts.localhost

Then connect to your Open Food Facts profile, copy the session cookie (use developper toolbar, and find a cookie named session for openfoodfacts.org domain, copy its value) and paste it in the body at this endpoint /api/set_session_cookie (you have a form at the /api/docs URI).

πŸ“– Usage

Once the application is running, you can log in with your Open Food Facts account. The main screen will present you with cards showing recent reports. You might need to be a moderator to be able to use it.

How to Contribute

Pre-Commit

This repo uses pre-commit to enforce code styling, etc. To use it:

pre-commit run

🀝 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this project better, please fork the repo and create a pull request. You can also simply open an issue with the type "enhancement".

Wikipage

🎨 Design

Features

  • Image reporting
  • List of reported images

Roadmap

  • Insert main roadmap items here

Weekly meetings

Valentin (@valimp) and Raphael (@raphael0202) are working on this tool. They meet weekly. Please ping them on Slack if you'd like to contribute. We have more general quality meetings every month.

  • The meeting will handle Agenda items first, and if time permits, collaborative bug triage.
  • We strive to timebox the core of the meeting (decision making) to 30 minutes, with an optional free discussion/live debugging afterwards.
  • We take comprehensive notes in the Weekly Agenda of agenda item discussions and of decisions taken. Please read our Contributing Guidelines for more details on our code of conduct and the process for submitting pull requests.

πŸ“œ License

Distributed under the AGPL. See LICENSE for more information.

πŸ“¬ Contact

Open Food Facts - tech@openfoodfacts.org

Project Link: https://github.com/openfoodfacts/nutripatrol

This README is a starting point. Feel free to suggest improvements!

Contributors

List of contributors to this repository

About

The backend part of our moderation tool for Open Food Facts

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors 8