Build a Rural Cooperative Inventory Pooling and Allocation Engine

Consolidate perishable agricultural inventory across smallholder farm cooperatives into unified Beckn catalog offerings. Allocate incoming bulk commercial purchase orders proportionally based on certified regional warehouse stocks.

Agricultural cooperative logistics manager

Ingest decentralized stock manifests from regional cooperative nodes into a normalized inventory pool.

Publish pooled inventory availability using Beckn protocol discovery catalog item structures.

Parse incoming bulk order quotes and calculate fair allocation shares across contributing farm warehouses.

Generate split fulfillment work orders and simulated Beckn on_select responses for dispatch review.

Cooperative operations screen showing participating warehouse quotas, pooled inventory levels, and order splits.

Construct synthetic cooperative warehouse stock listings and mock Beckn order JSON packets locally. Starter examples below are synthetic. They are not downloaded records.

Beckn protocol specifications Adopts Beckn protocol discovery, ordering, and fulfillment catalog structures for multi-provider inventory pooling.

langgraph, pydantic, pytest. LangGraph orchestrates the cyclic state transitions between inventory aggregation, stock allocation, and dispatch validation. Local or hosted LLM with multi-step reasoning capabilities to resolve complex allocation edge cases.

Submit runnable source, pinned dependencies, setup commands, a working interface, example outputs, and a recorded end-to-end demo. Include tests and an action log.

Aggregates multi-warehouse inventory without double-counting available stock.

Splits incoming bulk orders proportionally across contributing warehouses with positive capacity.

Rejects or truncates orders that exceed cumulative pooled availability.

```json [ { "input": { "order_request": { "item_id": "wheat_sharbati", "requested_quantity_kg": 500, "delivery_pincode": "462001" }, "participating_coops": [ { "coop_id": "coop_a", "available_kg": 300, "distance_km": 12 }, { "coop_id": "coop_b", "available_kg": 300, "distance_km": 25 } ] }, "expected_output": { "allocation_status": "FULFILLED", "allocated_total_kg": 500, "fulfillment_splits": [ { "coop_id": "coop_a", "allocated_kg": 250 }, { "coop_id": "coop_b", "allocated_kg": 250 } ], "unallocated_kg": 0 } }, { "input": { "order_request": { "item_id": "pulses_chana", "requested_quantity_kg": 1000, "delivery_pincode": "452001" }, "participating_coops": [ { "coop_id": "coop_c", "available_kg": 200, "distance_km": 10 }, { "coop_id": "coop_d", "available_kg": 300, "distance_km": 18 } ] }, "expected_output": { "allocation_status": "PARTIAL_SHORTAGE", "allocated_total_kg": 500, "fulfillment_splits": [ { "coop_id": "coop_c", "allocated_kg": 200 }, { "coop_id": "coop_d", "allocated_kg": 300 } ], "unallocated_kg": 500 } } ] ```

Inventory pooling and allocation calculations are simulated; no actual commercial contracts or physical logistics are committed. Use mock external writes. Require human review before any real deployment.