Skip to content

runrig-coop/early-warning-system

Repository files navigation

Early Warning System

An auditing dashboard that reports when and where (in terms of relative urgency) an on-site farm visit or other action may be required. Through a combination of automated, manual and verbal survey submissions, the status of each farm can be updated with regular crop assessments and reports on general field health.

Development Quick Start

First, make sure you have Rust, Node.js, and the full suite of Tauri prerequisites installed on your local development machine.

Then after cloning this repository, install the Node/JavaScript dependencies with npm (or the package manager of your choice), and start the Tauri development environment:

npm i               # Install JS dependencies
npm run tauri dev   # Start the Tauri development environment

# Alternatively, you can run the app in a browser-based dev env:
npm run dev

Project Background & Status

The Early Warning System (EWS) is part of a Runrig pilot project, which emerged from the Skywoman MAIA interviews with the Richland Gro-Op and OSU Microfarm Project from the fall of 2022. The EWS is one possible solution we identified to aid in the process of auditing crop production and ensure it is on track with the crop plan shared by all farms in the coop. To achieve profitability while aggregating yields from relatively small production lots, RGO takes orders in advance of planting and allows very little margin for error. Verifying each farm's status is therefore critical, but potentially quite time consuming. While on-site visits will always be necessary, the primary aim of this system is to provide the coop manager with reliable insights into where she can best focus her attention. View the rest of the preliminary design doc for further details, requirements and general context.

With this and future Runrig projects, we intend to provide the end users with carefully designed tools that can help bridge existing software platforms to meet their specific needs, while helping to improve the overall ecosystem of open technology. At the same time, we strive to make each Runrig apparatus more than just a proof-of-concept or a prototype, but a targeted intervention that delivers immediate gains for farmers and other food workers working in the field today.

For the Early Warning System, we're looking towards potential integrations with SurveyStack, the farmOS Data Model (particularly plans), and L'Atelier Paysan's Qrop.

In the process, we also seek to promote an open culture of design and knowledge production among practitioners from all levels and realms of expertise. Indeed, the process and relationships that come together in the production of these tools should be prioritized over the tools themselves, part of what we mean by "ecology over architecture".

To get involved or learn more about the Runrig community, you can read the plan, sign up for our newsletter or checkout the schedule of Runrig Open Design Workshops.

Project Status

We are tracking progress on issues using GitHub milestones:

As the last checklist item indicates, we're at a point where we need to take a step back and evaluate what makes sense to prioritize first. Keep an eye on the issue queue, discussions and check back here for updates!

First Functional Prototype (alpha.1)

A list of farms for a coop's crop plan, showing color-coded status indicators like the screenshot below, but also with a button to add another farm, cleaner styles and presented in dark mode. It is also in a standalone application window, rather than the browser.

We narrowed ths scope of requirements for what we considered the most essential features for a functional prototype or MVP. This included basic CRUD operations for adding and removing farms and updating the status. Persisting data between sessions was a key requirement, so as the screenshot here implies, we're now developing this primarily as a standalone desktop application, rather than a web app. The data is currently persisted as a very simple JSON document, but other formats and storage media will be explored in future iterations.

For ease of demonstration, we also retained some sample data that can be added quickly and also an option to clear all farms to start over. These won't be permanent features, but while this is functional MVP, it is still mainly for demos and gathering early feedback from prospective users.

First Screenshot (pre-alpha)

A list of farms for a coop's crop plan, showing for each farm a color-coded red, yellow or green status icon and the date of their last status report, all sorted by relative urgency.

The main screenshot for the first milestone is just meant to gesture towards the kinds of visual hierarchy of the Early Warning System, and a starting point for the second milestone.

Data Model

The data model consists of three tables representing physical items (farm, land, and planting) and three tables representing events or logs recorded by members (measurement, quantitative_measurement, and qualitative_measurement).

Data model of the RGO app