Field application · Visual specification

Wattr Survey

The Android app a field rep uses to record a water pump — who farms it, what the pump is, how it irrigates, and what it looks like. This is the complete picture of every screen, in every mode, with the questions each one asks.

4 modes11 pages maxOffline-first English + ਪੰਜਾਬੀScreens captured from a live build

What this app is

A rep stands at a tubewell in a Punjab field, often in bright sun, often with patchy signal, and answers a series of questions about the pump in front of them. The app writes the answers to the phone first and sends them when it can. Nothing depends on being online at the moment of the visit.

Every submission lands in the CRM as a field intake record. From there it is reviewed field by field, and — depending on the mode — used to create the pump, the device mapping and the farmer’s login.

The one thing to remember The rep’s phone number is their identity. There is no username or password. It is how the app finds their past submissions, and how the office knows who collected what.

The four modes

Everything hinges on one question — Installation Option — asked on the third page. It decides which pages the rep sees next and what the back office does with the result.

Mode	Use it when	Pages	Stored as
Survey	The pump has no Wattr device on it yet. The rep is capturing the site so a device can be provisioned and a farmer login created.	11	`new_pre_installation`
Audit	A device is already installed and the rep is inspecting or repairing it. The most common visit.	11	`with_existing_device`
Replace	A device is being swapped for a different one on the same pump.	11	`device_replacement`
Surrender	A device is coming off for good and nothing replaces it. The pump becomes unmonitored.	6	`device_surrender`

Getting started — the pages every mode shares

The first four pages are the same whatever the rep is doing. The mode only changes what comes after.

Splash — one action, and the language toggle

Surveyor Identity — the phone number is the rep’s ID

What do you want to do? — asked once, right after the phone

Same screen for a rep who has sent surveys before

Surveys you have sent — live staging data

Installation Option — this choice picks the mode

What happens here

Splash — one action, Begin Survey. The language toggle sits top-right and the choice sticks between launches.
Surveyor Identity — phone number is required; name and employee ID are optional and remembered on the device after the first time.
What do you want to do? — asked immediately after the phone, because that is the moment the app can look up what this rep has already sent. If they have history, the count appears on the second card.
Installation Option — the mode. Everything downstream follows from it.

Mode walkthroughs

Each strip below scrolls sideways and shows the real screens in order. The screenshots are from a live build against staging data, so the auto-filled values are genuine.

Survey

Survey (new / pre-installation)

Pages: 11
Stored as: new_pre_installation

The pump has no Wattr device on it yet. The rep is capturing the site so a device can be provisioned and a farmer login created.

This is the only mode that provisions automatically on submit — no reviewer needed — provided the tenant and farmer phone are valid. Anything that fails that check waits for a human.

01Surveyor Identity
02What do you want to do?
03Installation Option
04Device Identification
05Location
06Farmer Details
07Pump & Feeder
08Pump Discharge
09Irrigation Practices
10Crops Grown
11Photos

Device — IMEI optional for a new install

Location — tenant, then the geography cascade

Audit

Audit (existing device)

Pages: 11
Stored as: with_existing_device

A device is already installed and the rep is inspecting or repairing it. The most common visit.

Entering the IMEI pulls the existing record and auto-fills up to 15 fields. Nothing reaches the live system until a reviewer accepts the survey.

01Surveyor Identity
02What do you want to do?
03Installation Option
04Device Identification
05Location
06Farmer Details
07Pump & Feeder
08Pump Discharge
09Irrigation Practices
10Crops Grown
11Photos

Device — IMEI is required and pulls the record

Replace

Replace (swap device)

Pages: 11
Stored as: device_replacement

A device is being swapped for a different one on the same pump.

Two IMEIs are captured — the old one being removed and the new one going on. Everything else is a normal survey of the site.

01Surveyor Identity
02What do you want to do?
03Installation Option
04Device Identification
05Location
06Farmer Details
07Pump & Feeder
08Pump Discharge
09Irrigation Practices
10Crops Grown
11Photos

Two IMEIs — the old device and the new one

Surrender

Surrender (remove device)

Pages: 6
Stored as: device_surrender

A device is coming off for good and nothing replaces it. The pump becomes unmonitored.

The shortest flow. Farmer, pump, discharge, irrigation and crop pages are all skipped — nobody is going to be monitoring this pump, so re-collecting its agronomy is wasted effort at the roadside.

01Surveyor Identity
02What do you want to do?
03Installation Option
04Device Identification
05Device Surrender
06Photos

Every page and every field

The complete question set. A page only appears in the modes marked beside its title, and fields marked shown conditionally appear based on an earlier answer — for example, the canal name is only asked if the rep said the land is canal irrigated.

Surveyor Identity All modes

Tell us who is collecting this data — needed for traceability.

Key	Question	Type		Notes for the surveyor
`surveyor_contact`	Your Phone Number	Phone	Required	Your phone number is your surveyor ID — the next screen shows the surveys you have already sent from it.
`surveyor_name`	Your Name (optional)	Text	Optional	Optional — saved on this device after first entry.
`surveyor_employee_id`	Employee / Vendor ID (optional)	Text	Optional

Installation Option All modes

Survey is for a new / pre-installation. Audit is for an existing installed device.

Key	Question	Type		Notes for the surveyor
`installation_option`	Installation Option Survey (new / pre-installation) · Audit (existing device) · Replace (swap device) · Surrender (remove device)	Choice	Required	Survey = new or pre-installation · Audit = inspect/repair an already-installed device.

Device Identification All modes

Scan or type the 15-digit IMEI from the device label.

Key	Question	Type		Notes for the surveyor
`imei_number`	IMEI Number	IMEI	Optional	Tap the scan button to read the QR/barcode on the device.
`new_imei_number`	New device IMEI shown conditionally	IMEI	Optional	Scan the QR/barcode on the NEW replacement device.

Location SurveyAuditReplace

State auto-fills from the device; pick District & Block from the list.

Key	Question	Type		Notes for the surveyor
`tenant_id`	Tenant / Organization	Tenant list	Required	Pick the tenant this pump belongs to — the farmer login is created under it.
`state`	State / Union Territory	Search list	Required	Auto-fetched from the device record; otherwise search to pick.
`district`	District	Search list	Required	Auto-fetched if mapped; otherwise pick from the list.
`block`	Block	Search list	Required	Auto-fetched if mapped; otherwise pick from the list.
`village`	Village	Search list	Required

Farmer Details SurveyAuditReplace

Key	Question	Type
`farmer_name`	Farmer Name	Text	Required
`farmer_father_name`	Farmer's Father's Name	Text	Required
`farmer_contact_number`	Farmer Contact Number	Phone	Required
`farmer_caste`	Farmer Caste General · OBC · SC · ST	Choice	Required

Pump & Feeder SurveyAuditReplace

Key	Question	Type		Notes for the surveyor
`feeder_name`	Feeder Name	Search list	Required	Auto-fetched when mapped; otherwise pick from the list or type the name.
`installation_date`	Installation Date	Date	Required	Auto-fetched when available; otherwise pick a date.
`year_of_pump_installation`	Year of Pump Installation	Year	Required
`pump_type`	Pump Type Centrifugal · Submersible	Choice	Required
`starter_button_type`	Starter Type 2-Starter (2-button) · 3-Starter (3-button)	Choice	Required	Number of buttons on the motor starter panel — check the physical starter, do not assume.
`depth_of_source`	Depth of Water Source	Value + unit	Required
`pump_runtime_hours`	Pump Runtime (Hours)	Number	Required	Average daily run time.
`land_type`	Agricultural Land Type Owned · Rented · Leased	Choice	Required
`pump_coverage_acres`	Pump Coverage (acres)	Number	Required
`has_issues`	Has the pump had issues?	Yes / No	Required
`issues_faced`	Issues Faced (tap all that apply) shown conditionally Bearing failure (noise, vibration) · Cavitation (noise, jerks at low water level) · Clogging of strainers/foot valves/suction line · Corrosion of metallic parts · Dry-running when groundwater falls · Electrical faults / single-phasing · Impeller wear / clogging by sand, silt, debris · Motor burn-out / coil burn · Seal/gland failure or leakage · Shaft misalignment / bending	Multi-choice	Required
`capacitor_available`	Capacitor Already Available	Yes / No	Required

Pump Discharge SurveyAuditReplace

Discharge can only be measured while the pump is running. If electricity is not available right now, answer No and we will skip the measurement.

Key	Question	Type		Notes for the surveyor
`electricity_at_visit`	Is electricity available at the site right now? (your visual check)	Yes / No	Required	Look at the meter / main switch yourself — do not rely on the device. We use your answer to decide whether to ask for discharge measurements.
`discharge_method`	How will you measure discharge? shown conditionally Flowmeter · Trajectory method	Choice	Required	Flowmeter: read the discharge straight off the meter in L/s. Trajectory: we calculate it from the pipe diameter and water-arc drop.
`flowmeter_discharge_lps`	Water Discharge (L/s) shown conditionally	Number	Required	Read the discharge directly from the flowmeter, in litres per second.
`outlet_pipe_diameter_in`	Diameter of Outlet Pipe (inches) shown conditionally	Number	Required	Inside diameter of the outlet pipe in inches.
`vertical_distance_in`	Vertical Distance (inches) shown conditionally	Number	Required	Vertical drop of the water arc from the pipe lip.
`pump_discharge`	Pump Discharge (auto-calculated) shown conditionally	Value + unit	Required	Auto-calculated in L/sec from outlet pipe diameter + vertical distance using Q = 0.05963 × D × D × V.

Irrigation Practices SurveyAuditReplace

Key	Question	Type
`canal_irrigated`	Canal Irrigated?	Yes / No	Required
`canal_name`	Name of Canal shown conditionally	Text	Required
`canal_irrigation_days`	Days of Canal Irrigation per Season shown conditionally	Number	Required
`laser_levelling_done_year`	Laser Land Levelling Done (Year)	Year	Required
`laser_levelling_planned_year`	Laser Land Levelling Planned (Year)	Year	Required
`irrigations_per_acre`	Irrigations per Acre (main crop)	Number	Required

Crops Grown SurveyAuditReplace

Kharif is required; Rabi & Zaid are optional (leave blank if single-cropping).

Key	Question	Type		Notes for the surveyor
`kharif_crops`	Kharif (Jun – Oct)	Crop + variety	Required	Monsoon-season crops — rice, maize, cotton, pulses, fodder. Pick at least one crop and its variety.
`rabi_crops`	Rabi (Oct – Mar) · optional	Crop + variety	Optional	Winter-season crops — wheat, mustard, gram, lentils.
`zaid_crops`	Zaid (Mar – Jun) · optional	Crop + variety	Optional	Summer-season crops — fodder, summer pulses, vegetables.

Device Surrender Surrender

This device is being removed for good — no replacement. The pump will show as unmonitored and the device as unmapped until a new one is installed.

Key	Question	Type		Notes for the surveyor
`surrender_reason`	Reason for surrender Device faulty / beyond repair · Farmer opted out · Site / pump decommissioned · Device lost or stolen · Other	Choice	Required	Why the device is being taken down. Saved on the removal record for the back office.
`surrender_notes`	Additional notes (optional)	Text	Optional

Photos All modes

Capture the required slots — the checklist matches the visit purpose.

Key	Question	Type		Notes for the surveyor
`pump_location`	Pump Live GPS Location	GPS	Required	Capture the pump's real location via GPS before taking photos — required.
`field_boundary`	Field Boundary (tap GPS at each corner)	GPS boundary	Optional	Stand at each corner of the field and capture a GPS reading — four corners are joined into the field polygon.
`installation_photos`	Photos	Photos	Optional

Photos and GPS

The last page is the same in every mode, but the photo checklist changes with the purpose of the visit.

Mode	Required photos
Survey Audit Replace	Tubewell photo · Device setup photo
Surrender	Removed device photo

GPS lock

The pump’s live GPS location is required — it has to be captured standing at the pump, before the photos. The field boundary is optional: the rep walks the perimeter and taps at each corner, and the app joins the points into a polygon and reports the area in both square metres and acres.

Offline, drafts and sync

Every answer is written to the phone as the rep types. Submitting adds the survey to a queue; the queue drains whenever there is a connection.

Queued: Waiting to send, and it will go on its own. This is the number on the sync chip in the header.
Needs attention: The app tried to send it eight times and stopped. It will not retry on its own. Tapping the warning shows the actual error with Try again and Discard for each one.

Why these are shown separately They used to be counted together, so a survey the app had given up on still appeared as “1 unsynced” forever — auto-sync skipped it, reported nothing, and the number never moved. If a rep reports a count that will not clear, ask whether it says unsynced or needs attention; they mean different things.

What happens after the rep taps submit

The survey reaches the API and is stored as a field-intake record.
Survey provisions immediately — pump, device mapping and farmer login — provided the tenant and farmer phone are valid. Anything that fails that check waits for a person.
Audit Replace Surrender change nothing live until a reviewer accepts the survey.
A CS agent then reviews it field by field, marking each answer OK or not OK. A survey cannot be accepted until every answer that was filled in is marked OK.

When a survey comes back for correction

If the reviewer marks some answers as not OK, the rep sees the survey in Surveys you have sent with a count of what needs fixing, and the action reads Fix now instead of Edit.

Opening it puts the form in correction mode: only the rejected answers are editable and highlighted, and everything the reviewer confirmed is locked and labelled. A 20-question survey with 3 problems is a 3-question job.

An answer nobody has looked at is not the same as a wrong answer Fields the reviewer has not reached yet stay editable but are not flagged. Only an explicit “not OK” puts a field in the fix list.

Glossary

IMEI: The 15-digit serial on the device label. Scanned from the QR/barcode, or typed. Required for Audit, Replace and Surrender; optional for a new Survey, because there is no device on the pump yet.
Tenant: The organisation the pump belongs to. The farmer’s login is created under it, so picking the wrong one puts the pump on the wrong dashboard.
Feeder: The electricity feeder line supplying the pump.
Kharif / Rabi / Zaid: The three Indian cropping seasons — monsoon (Jun–Oct), winter (Oct–Mar) and summer (Mar–Jun). Only Kharif is required.
Trajectory method: Working out discharge from the outlet pipe diameter and how far the water arc drops, when there is no flowmeter. The app does the arithmetic.
Field intake: What a submitted survey is called once it reaches the back office.

Questions we get

The rep has no signal at the pump. Can they still work?: Yes. Everything is saved on the phone and sent later. The only thing that will not work offline is the IMEI lookup that auto-fills the site details.
Why did the app not ask for farmer or crop details?: They were in Surrender mode. The device is coming off and the pump will not be monitored, so those pages are skipped.
The rep typed the IMEI and half the form filled itself. Is that right?: Yes — that is the point. The device record already knows the location, farmer and pump. Everything auto-filled is still editable; the green chip marks what came from the record.
Two reps share one phone. Is that a problem?: They should change the number on the Surveyor page. Submissions are attributed to whichever number was entered.
A survey has been “unsynced” for days.: Check whether it says needs attention instead. That one is parked and needs the rep to tap Try again or Discard — see Offline & sync.