This is the monorepo for the reference implementation of the Open Product Recovery standards. Open Product Recovery is a collection of standards and implementations designed to facilitate sharing of excess products with charitable (and secondary market) organizations.
Open Product Recovery is a specification for describing and communicating about excess food (and other donatable products). OPR servers can publish offers of donatable products to other OPR servers, and every OPR server hosts a public REST API to allow other organizations to accept those offers.
Yes! If:
- Your organization generates enough donatable products that you need a way to automatically tell charitable organizations that you have donations for them.
- Or, your charitable organization needs to receive enough donatable products that you need a way to automatically discover donations.
Ideally, your organization already has an inventory system that tracks the donations you work with. OPR has a flexible plugin system that allows it to read and write offers to and from just about any storage system with an API.
This repository contains a number of nodejs projects that work together to implement the OPR specification. Please read the README file in each of the subdirectories to find out more about the libraries in each component.
First, run lerna bootstrap to install all package dependencies and compile local libraries in the correct order.
npx lerna bootstrap --hoistThe --hoist flag is optional for local builds, but the --hoist flag is required for library development. Hoisting creates a very different package-lock structure from non-hoisted repositories. We standardize on the hoisted versions in the repository to avoid churn.
Run
npx lerna run testfrom the root directory to run all the unit tests. If you want to run the Postgres tests in opr-sql-database, you need to have a working installation of Postgres and the initdb, postgres and psql commands must be in your PATH environment variable. If those commands aren't available, the Postgres tests will be skipped.
This library is the reference implementation for the Open Product Recovery standards. You may want to read the standards docs before you dive into setting up your own server.
The examples in opr-example-server are a great place to start.