R Station image manifest

Holds rstation-image.json, which RI Launcher reads to find the current R Station SD card image. Not a software release.

Initial 0.1.0 Release

The first release of Relief Inventory, free and open-source warehouse management for donated goods in disaster
response (GPL-3.0). It was built with, and for, a disaster-response warehouse operation, originally in cooperation
with Adventist Community Services.

What's in it

• Receiving. Log a donation at the dock (donor, driver, what arrived, photo) and print a barcode label for every
  pallet, box, bag or tote. Track donations offered by phone before they ship.
• Sorting. Scan a pallet and enter what's inside, by keyboard, USB/Bluetooth scanner or phone camera. Barcodes
  resolve to item types, including cartons. Each item is recorded as usable, outdated, trashed or diverted; only usable
  goods count as stock.
• Inventory. An append-only ledger is the source of truth for stock on hand. Warehouse pallets, locations, a pick
  path, inventory labels and an end-of-day sorting-area report show where things are.
• Requests and filling. Partner agencies' requests are filled from stock by paper pick sheets or by scanning at the
  shelf. A review panel suggests a fair split when there isn't enough to go around.
• Reports. Inventory, outstanding requests, unfulfilled requests, flow, donors and partners, with CSV and PDF output.
• Printing. A print queue sends labels and reports to the right printer at each site, via a Raspberry Pi (R Station)
  or the desktop ri-print client.
• Everything else. Role-based permissions, a volunteer and guest sign-in kiosk, in-app issue reporting, backups and
  restore, a first-run setup wizard, and an offline "whole site on a Pi" mode.

Installing with Docker

The easiest way to run Relief Inventory is with Docker. On Windows, macOS and Linux you can use
Docker Desktop (free for personal use, education and small
businesses), or plain Docker Engine on a Linux server. You download one settings file, run docker compose up -d,
and a setup page in your browser creates your administrator account. Nothing else needs to be installed.

The image supports both amd64 (PCs and servers) and arm64 (Raspberry Pi, Apple silicon). For a step-by-step guide
written for people who haven't used Docker before, see
Installing Relief Inventory with Docker.

Downloads

• Docker image (linux/amd64 and linux/arm64, including Raspberry Pi and Apple silicon):
  ghcr.io/fiforms/reliefinventory:0.1.0. Start with the quick start in the
  README.
• ri-print (desktop print server for Linux, macOS and Windows): attached below.
  Tested on Linux and macOS. The Windows build is untested.
• R Station images (Raspberry Pi): too large to attach here, so they are hosted separately: link TBD.

R-Station Images

• Latest R-Station images can be downloaded from the VBSP Nextcloud Server
• Filename: rstation-0.4.6_0.1.5.img.xz
• SHA256 Sum: 67391426a5cc1398386bd0607f7a7ff35eceb4baeb8ab29426a448385958d9a3
• Copy to an SD Card with Balena Etcher
• Run on a Raspberry Pi 4B or later (4GB RAM Recommended)

SHA-256 checksums: add before publishing.

Known limitations

• The request lifecycle stops at Filled. Ready to Ship, Shipped, Delivered and bill-of-lading upload are not
  built yet.
• Stock is pooled by item type once sorted. An item on the shelf can't be traced back to a specific donor or pallet,
  so this is not recall-style tracing.
• Printing: the Pi's on-device Printers page and USB/label printers are untested, the SATO label driver has not been run
  on a Pi or from an image build, and the desktop print client has not been run on Windows.
• Some screens still say "Order" where partner-facing text will eventually say "Request".
• Not built yet: the donor notification letter and scanning an inventory label to find its stock.

See PROJECT_ANALYSIS.md for the full
list, and CHANGELOG.md for future changes.

Feedback

Found a bug? Open an issue on GitHub, or use "Report an Issue" in the app's profile menu.
d