INATrace is a digital open-source solution designed to enhance the economic conditions of smallholder farmers by improving the traceability of global supply chains. Funded by the German Federal Ministry for Economic Cooperation and Development (BMZ) and implemented by GIZ, INATrace provides an efficient internal management system for cooperatives, digitally stores supply chain data, and supports compliance with regulations like the EU Deforestation Regulation (EUDR).
Project is composed of 4 parts, coordinated from the INATrace project hub (project-wide documentation and governance):
The Java backend: a Spring Boot REST API over MySQL, serving the web frontend and the mobile app.
# MySQL, and Mailpit to catch e-mails (http://localhost:8025)
docker compose -f compose-dev.yaml up -d
cp src/main/resources/application.properties.template \
src/main/resources/application.properties
# fill in the values, then run INATraceBackendApplication.javaTables are created and prefilled with starter data on first startup. Full instructions are in docs/getting-started.md.
| Page | What it covers |
|---|---|
| Getting started | Requirements, running locally, database and mail containers |
| Configuration | Every application.properties value, grouped by what it configures |
| API | Authentication, the OpenAPI definition, common requests, the currency service |
| Database | Connection parameters, entity model, users and roles, migrations |
| Building | Producing a jar and a Docker image |
These pages are written to be read on GitHub, and are also published at
https://docs.agstack.org/ — which imports this docs/ directory directly, so
editing them here updates the site.
TECHNICAL_DOCUMENTATION.md covers the platform
architecture and the Kubernetes deployment topology. It is not current and is
deliberately left out of docs/, so that nothing stale is published to the
documentation site. Read it for background, verify before relying on it.
Project INATrace welcomes contribution from everyone. See CONTRIBUTING.md for help getting started. Questions and discussion go to the INATrace mailing list.
Copyright (c) 2023 Anteja ECG d.o.o., GIZ - Deutsche Gesellschaft für Internationale Zusammenarbeit GmbH, Sunesis ltd.
This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, you can obtain one at https://mozilla.org/MPL/2.0/. The full text is in LICENSE.