Groundwater
Published depth bands and approved groundwater resource records where available.
Methodology
JalWater separates official measurements, transparent derived analytics, editorial interpretation, and unavailable evidence so users can see exactly what is known.
Evidence model and source-first communication
JalWater keeps its deterministic evidence model for completeness checks while public results lead with the supported conclusion, actual sources, and plain-language evidence.
Long-term availability
Published per-capita availability classifications for the approved reporting periods.
Rainfall
Official rainfall evidence is shown only after reviewed source records exist.
Reservoir and supply
Official reservoir or supply evidence is shown only after reviewed source records exist.
Water quality
Official quality evidence is shown only after reviewed source records exist.
How to read the labels
- Compact results lead with the supported conclusion, plain-language evidence, and the institutions that contributed the visible records.
- Confidence is derived from the internal evidence framework, recognised-source provenance, geography match, and whether comparable source pairs exist.
- The five evidence dimensions are an internal completeness framework, not a product score, city rank, suitability rating, or prediction.
- Official datasets update slower than local news. News is recent local context and does not change official data cards.
- A source is attributed to a result only when its approved record contributes to the evidence shown there.
- Evidence that has not been integrated remains explicit and is never treated as a zero value.
Deterministic evidence rules
These labels are rule-based reading aids. They never replace the source value, never create a score, and never rank locations.
Evidence state
- Available
- All required approved official records for that evidence area are present for the displayed geography.
- Partial
- Some approved official records are present, but a required pair, period, geography, or companion record is missing.
- Not available
- No approved official value is connected to that evidence area for the displayed geography.
- Not applicable
- The evidence area is outside the applicable source scope for the displayed geography or report type.
Confidence
- High
- Four or more evidence areas are available, recognised official sources are present, source geography matches, and comparable source pairs exist.
- Moderate
- Two or more evidence areas are available, recognised official sources are present, source geography matches, and comparable source pairs exist.
- Limited
- At least one approved record is present, but coverage, source pairing, or geography evidence is incomplete.
- Insufficient
- No approved source record is available for the displayed geography.
Freshness
- Fresh
- Latest retrieval date is within 180 days of the current JalWater audit date.
- Aging
- Latest retrieval date is older than 180 days and within 730 days of the audit date.
- Historical
- Latest retrieval date is older than 730 days or the publication period is explicitly historical.
- Unknown
- No approved retrieval date is available for the displayed geography.
Non-negotiable calculation rules
- No hallucinated data.
- Phase 13 renders every usable district row from the two approved XLSX workbooks after checksum validation and generated-record validation.
- CGWB PDF resource rows remain manual enrichment and render only where extraction was explicitly verified.
- Groundwater-depth ranges remain ranges; JalWater does not convert them into midpoint values or line charts.
- NITI ICED classifications are labelled as government dashboard dataset values with the source caveat.
- Manual workflow: official source identified → publication reviewed → value extracted → value approved → public rendering.
- Official Publication Review Framework: official publication identified → publication registered → human review → relevant tables identified → manual extraction → verification → second reviewer approval → published → visible on JalWater.
- JalWater does not scrape or estimate official source documents.
- Official source documents must be reviewed before display.
- Numeric values only render after approval of the exact official source value.
- Derived analytics are suppressed when required official inputs are missing.
- No interpolation of missing values.
- No fake trends or predictions.
- Missing data must display “Data not yet available.”
Phase 13 data pipeline
`npm run data:ingest` reads the approved XLSX workbooks, generates district-first locations from every usable spreadsheet row, preserves original labels, attaches spreadsheet rows, records PDF page/table citations for manually verified CGWB rows, and writes deterministic JSON. `npm run data:validate`, `npm run validate:locations`, `npm run validate:coverage`, and `npm run validate:news` check source checksums, Pune fixtures, geography mapping, public-rendering approval, route safety, source labels, news fallback, and provenance fields.