1. Food Bank Management
  2. Data model
Reference

The tables behind Food Bank Management

Food Bank Management ships with 13 tables, grouped here by the feature that uses them. Every record your team works with lives in one of them, and you can add fields and tables in Proto.

Tables
13
Features
6
Change it
Add fields and tables in Proto

How the model is organised

Operating scope

Organizations, storage locations, team members and Users identify the entity, location and people responsible for work.

Food inventory

Stock items and stock lots hold item identity, base unit, expiry and release state.

Requests and claims

Stock requests link demand to its item, location and owner; stock reservations claim an eligible quantity.

Stock effects

Stock movements retain signed, posted and reversed movement history.

Assistance and evidence

Distribution allocations, review decisions, record attachments and operation receipts connect the allocation, parent-request decisions and operation results to a stock request.

Every table, by feature

Stock requests

6 tablesAbout this feature
  • Stock requests

    Scoped stock requests with revision-controlled lifecycle.

    Linked to Organizations, Team members, Storage locations, Stock items
  • Review decisions

    Revision-specific approve, reject, and return decisions.

    Linked to Stock requests, Team members
  • Record attachments

    Evidence files attached to operational requests.

    Linked to Stock requests, Team members
  • Team members

    Authenticated operational members assigned to an organization.

    Linked to Users, Organizations
  • Stock items

    Food inventory items with base units and lot tracking.

    Linked to Organizations
  • Storage locations

    Eligible food storage and distribution locations.

    Linked to Organizations

Items and lots

5 tablesAbout this feature
  • Stock items

    Food inventory items with base units and lot tracking.

    Linked to Organizations
  • Stock lots

    Lot-level expiry and release state for tracked food.

    Linked to Stock items
  • Stock reservations

    Eligibility-scoped claims against available stock.

    Linked to Stock requests, Stock items, Storage locations, Stock lots
  • Stock movements

    Immutable signed inventory movements and posting evidence.

    Linked to Stock requests, Stock items, Storage locations, Stock movements
  • Organizations

    Active food bank operating organizations and their reporting scope.

Locations and people

7 tablesAbout this feature
  • Organizations

    Active food bank operating organizations and their reporting scope.

  • Storage locations

    Eligible food storage and distribution locations.

    Linked to Organizations
  • Team members

    Authenticated operational members assigned to an organization.

    Linked to Users, Organizations
  • Users

    Users

    Linked to Users
  • Stock items

    Food inventory items with base units and lot tracking.

    Linked to Organizations
  • Stock requests

    Scoped stock requests with revision-controlled lifecycle.

    Linked to Organizations, Team members, Storage locations, Stock items
  • Distribution allocations

    Food assistance allocations released through independent review.

    Linked to Organizations, Stock requests

Reservations and movements

7 tablesAbout this feature
  • Stock reservations

    Eligibility-scoped claims against available stock.

    Linked to Stock requests, Stock items, Storage locations, Stock lots
  • Stock movements

    Immutable signed inventory movements and posting evidence.

    Linked to Stock requests, Stock items, Storage locations, Stock movements
  • Stock requests

    Scoped stock requests with revision-controlled lifecycle.

    Linked to Organizations, Team members, Storage locations, Stock items
  • Stock items

    Food inventory items with base units and lot tracking.

    Linked to Organizations
  • Stock lots

    Lot-level expiry and release state for tracked food.

    Linked to Stock items
  • Storage locations

    Eligible food storage and distribution locations.

    Linked to Organizations
  • Operation receipts

    Idempotent operation receipts and result evidence.

    Linked to Stock requests

Allocation review

8 tablesAbout this feature
  • Distribution allocations

    Food assistance allocations released through independent review.

    Linked to Organizations, Stock requests
  • Stock requests

    Scoped stock requests with revision-controlled lifecycle.

    Linked to Organizations, Team members, Storage locations, Stock items
  • Review decisions

    Revision-specific approve, reject, and return decisions.

    Linked to Stock requests, Team members
  • Record attachments

    Evidence files attached to operational requests.

    Linked to Stock requests, Team members
  • Stock reservations

    Eligibility-scoped claims against available stock.

    Linked to Stock requests, Stock items, Storage locations, Stock lots
  • Stock lots

    Lot-level expiry and release state for tracked food.

    Linked to Stock items
  • Stock movements

    Immutable signed inventory movements and posting evidence.

    Linked to Stock requests, Stock items, Storage locations, Stock movements
  • Operation receipts

    Idempotent operation receipts and result evidence.

    Linked to Stock requests

Evidence and reconciliation

7 tablesAbout this feature
  • Operation receipts

    Idempotent operation receipts and result evidence.

    Linked to Stock requests
  • Record attachments

    Evidence files attached to operational requests.

    Linked to Stock requests, Team members
  • Review decisions

    Revision-specific approve, reject, and return decisions.

    Linked to Stock requests, Team members
  • Stock requests

    Scoped stock requests with revision-controlled lifecycle.

    Linked to Organizations, Team members, Storage locations, Stock items
  • Stock movements

    Immutable signed inventory movements and posting evidence.

    Linked to Stock requests, Stock items, Storage locations, Stock movements
  • Distribution allocations

    Food assistance allocations released through independent review.

    Linked to Organizations, Stock requests
  • Team members

    Authenticated operational members assigned to an organization.

    Linked to Users, Organizations

Keys and references

A request is the shared parent for movements, receipts, decisions, attachments and allocations. A reservation references the request directly. Keep the organization’s identity aligned across each related record. A movement can reference another movement when correcting a posted effect. Revision and operation key fields help relate a decision or result to the precise attempted scope.

Migration order

  1. Organizations and people. Establish active organizations, Users and team members with the intended assignments.
  2. Locations and food. Load storage locations, stock items and stock lots with consistent codes, units and release states.
  3. Requests. Bring in stock requests and their owner, item and location references.
  4. Operational history. Import stock reservations and stock movements with their parent links and original references.
  5. Assistance and evidence. Add distribution allocations, record attachments, review decisions and operation receipts after parent identity is stable.

Set up Food Bank Management your way.

Start free, then use Proto to change fields, steps and approvals before your team goes live.

How to get started