Features / Farming models & harvest

Crop Actual harvest

Logs a harvest for one crop on a Crop Actual (portfolio) tile: output, surplus, date and harvest type. It is separate from ATM harvest.

FactsheetFarming models & harvest

Who uses it: Field staff / CRP (regular cadre)
How you get here: Crop Actual (Add/Edit portfolio) screen > tap harvest on a crop chip.
Tables: harvest_logs
APIs: 1 calls today, 7 App Service operations
Offline: Offline-first: saved to harvest_logs and uploaded by HarvestWorker when online.

Screens

Screen	What it does	Source
Select harvest bottom sheet	Harvest form for a single crop.	app/src/main/java/org/platformcommons/urvi/view/harvest/SelectHarvestBottomSheet.kt
Add portfolio (host)	Crop Actual screen that opens the harvest dialog.	app/src/main/java/org/platformcommons/urvi/view/portfolio/AddPortfolioActivity.kt

Field	Type	Required	Validation	Options from
Harvest type	Radio: Continuous / Whole crop	Yes	Each option shows only if remote config's enabled-versions list contains the current versionName_versionCode.	Remote config
Early Harvest Reason	Text	If current month is before the month of the crop's expected harvest date	Hidden otherwise.	User input
Total output (quintals)	Decimal	Yes	0-999.99 (up to 3 whole digits, 2 decimals).	User input
Surplus for sale (quintals)	Decimal	Yes	0-999.99 and less than or equal to total output.	User input
Interested in marketing with RySS	Checkbox	No	Shown only for Whole crop when surplus > 0.	User input
Harvest date	Date (yyyy-MM-dd)	Yes	Latest = today. Earliest = crop's previous harvest end date + 1 day.	Date picker
Photo	Camera	If Whole crop	Location must be captured first.	Device camera
Location	GPS	Yes		Device GPS

Conditions from the code, rewritten as plain decision rules.

When	Then
Form is valid and confirmed	A harvest_logs row is written (quantity, surplus, harvest date as complete date, status, type, PLI id, product line item id, earlyHarvestReason, interestedInCropMarketing), the portfolio product's harvest status and complete date update, and sync is triggered.
HarvestWorker runs	Harvest log is POSTed for the owner.

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

Today: call	Use	Replaced by
POST `/gateway/portfolio-service/api/v1/portfolios/harvest/{id}/ENTITY_TYPE.IE`	Record a crop harvest. Sent through the queue or online.	`POST /sync/batch`

App Service v2: operation	Use
GET `/config`	Typed config bundle (ETag)
GET `/farmers/snapshot`	Cursor-paged hydrated farmer snapshot
GET `/farmers/{farmerId}/crop-blocks`	A farmer's Crop Actual blocks for a season / month
POST `/sync/batch`	Apply an ordered batch of offline mutations
POST `/files`	Create a file upload (resumable or single-shot)
PATCH `/files/{fileId}`	Append a chunk to a resumable upload
HEAD `/files/{fileId}`	Current offset of a resumable upload

Possible bug · unverified photo and GPS are required to pass validation but are not stored in harvest_logs or sent (not confirmed against the server payload).

Merge with ATM harvest into one component with consistent date rules and limits.
Persist and upload photo and geotag, or drop the requirement.
Replace version-list feature gating with a simple per-option flag.