Features / Planning & tracking

Crop Plan

Lets the user plan crop blocks per land parcel for a season. Each block is a "Portfolio line item" (a crop block on one parcel) of type PLANNED on the server's portfolio service.

FactsheetPlanning & tracking
Who uses it
Cadre userHAN user (blocked)
How you get here
Farmer hub, Crop Plan tile, shown only when the Crop Plan switch is on; needs a category that is not C4/C5 and the season/survey disable flag off.
Tables
portfolio, portfolio_portfoliolineitem, portfolio_portfoliolineitem_portfolioproductlineitem
APIs
8 calls today, 0 App Service operations
Offline
Works offline; queued for sync.

Screens

ScreenWhat it doesSource
Portfolio list (PLANNED)Sections of planned crop blocks.app/src/main/java/org/platformcommons/urvi/view/portfolio/PortfolioActivity.kt
Add / Edit crop blockSame form as Crop Actual.app/src/main/java/org/platformcommons/urvi/view/portfolio/AddPortfolioActivity.kt

What it captures

FieldTypeRequiredValidationOptions from
Land, crop type, crops, acres, practicesFormYesSame fields and rules as Crop Actual.See Crop Actual

Rules

Conditions from the code, rewritten as plain decision rules.

WhenThen
The farmer has no landAdd shows "no land asset for farmer".
Saving a planned blockCrop acres on this land in this section (other tiles) + this block must be no more than land acres minus the latest ATM land; else "Land limit exceed".

API contracts

Each call opens to its use case, headers, request and response bodies, and errors.

Today: callUseReplaced by
GET /ctld/api/product/v1 (generated ProductAPI.getProduct)Load the tenant product (crop/input) master.
GET /ie-registration/assets/json/inventory/crops-list.jsonLoad the static crop list.
GET /gateway/portfolio-service/api/v1/portfolios/ownerEntities?ownerEntityIdList=&ownerEntityType=ENTITY_TYPE.IEDownload crop plans (portfolios with line items) for a chunk of farmers.
GET /gateway/asset-service/api/v1/assets/{assetId}Refetch one asset from the server to repair a sync error.
GET /gateway/commons-report-service/api/v1/datasets/name/PlusOneGetOwnedLandByIEID/executeGet a farmer's owned land, used to validate land entries.
POST /gateway/portfolio-service/api/v1/portfolios/line-items/v2?logCropActivity=true&actorType&actorIdCreate a crop plan entry (portfolio with one line item).
PATCH /gateway/portfolio-service/api/v1/portfolios/Update crop plans.
DELETE /gateway/portfolio-service/api/v1/portfolios/portfolioLineItem/?logCropActivity&portfolioId&portfolioLineItemId&portfolioLineItemUUIDDelete a crop line item.

Behaviour notes

  • Sections are hard-coded to 2023-24 Kharif and Rabi; in practice Crop Plan is retired and its tile is hidden by config.

Improve in the rewrite

  • Drop Crop Plan in the rewrite, or drive its seasons from server config.