{ "metadata": { "name": "Umay Ana Agricultural Data Dictionary", "version": "1.0-draft", "published_at": "2026-08-29", "purpose": "Institutional B2B data dictionary for banking, insurance/reinsurance, MRV, green finance and public-sector integration discussions.", "status_legend": { "live": "Produced by a current Umay Ana workflow.", "live_if_provided": "Available only when the user explicitly provides or records the value.", "live_if_recorded_in_carbon_diary": "Available when the user records the practice in Carbon Diary.", "live_for_what_should_i_plant": "Produced by the live crop-choice workflow.", "derived": "Derivable from current data but should be governed and validated before institutional use.", "proposed": "Future institutional/MRV field or derived signal; not claimed as live production output." }, "important_boundary": "Current farmer-facing data, proposed institutional fields and proposed derived indicators are explicitly separated. No derived signal is an automatic lending, insurance, certification or regulatory decision.", "interoperability_note": "Designed for future mapping to external agricultural data standards and partner schemas; this document does not claim ADAPT, CRCF or other formal compliance." }, "fields": [ { "domain": "Governance & Identity", "field_id": "GOV-001", "field_name": "User reference", "json_path": "user.id", "description": "Pseudonymous internal user reference used to join records.", "data_type": "string", "example": "usr_...", "source": "System", "status": "live", "evidence_level": "system", "sensitivity": "restricted", "update_cadence": "event", "banking_use": "Join permissioned borrower/farmer records", "insurance_use": "Join policyholder/farmer records", "mrv_use": "Operator identity linkage where lawful", "notes": "Do not expose raw internal ID externally without mapping." }, { "domain": "Governance & Identity", "field_id": "GOV-002", "field_name": "Partner subject reference", "json_path": "partner.subject_ref", "description": "Institution-specific pseudonymous reference used in B2B integrations.", "data_type": "string", "example": "bank_farmer_123", "source": "Partner mapping", "status": "proposed", "evidence_level": "partner", "sensitivity": "restricted", "update_cadence": "event", "banking_use": "Bank-side customer mapping", "insurance_use": "Policyholder mapping", "mrv_use": "Program participant mapping", "notes": "Prefer partner-specific aliases." }, { "domain": "Governance & Identity", "field_id": "GOV-003", "field_name": "Consent / legal basis status", "json_path": "governance.consent_status", "description": "Whether the record is permitted for the stated external purpose.", "data_type": "enum", "example": "granted", "source": "System / user", "status": "proposed", "evidence_level": "system", "sensitivity": "sensitive", "update_cadence": "change", "banking_use": "Required before data enrichment", "insurance_use": "Required before claims/underwriting reuse", "mrv_use": "Required before MRV/program export", "notes": "Purpose-specific, not blanket consent." }, { "domain": "Governance & Identity", "field_id": "GOV-004", "field_name": "Permitted purpose", "json_path": "governance.purpose", "description": "Declared purpose under which data may be shared or processed.", "data_type": "enum[]", "example": "credit_monitoring", "source": "System / partner", "status": "proposed", "evidence_level": "system", "sensitivity": "sensitive", "update_cadence": "change", "banking_use": "Credit origination/monitoring", "insurance_use": "Insurance monitoring/triage", "mrv_use": "MRV / certification support", "notes": "Purpose limitation should be enforceable." }, { "domain": "Governance & Identity", "field_id": "GOV-005", "field_name": "Record created at", "json_path": "metadata.created_at", "description": "Timestamp when record entered Umay Ana.", "data_type": "datetime", "example": "2026-08-29T12:00:00Z", "source": "System", "status": "live", "evidence_level": "system", "sensitivity": "internal", "update_cadence": "event", "banking_use": "Audit trail", "insurance_use": "Claim/event chronology", "mrv_use": "MRV provenance", "notes": "Immutable." }, { "domain": "Governance & Identity", "field_id": "GOV-006", "field_name": "Record updated at", "json_path": "metadata.updated_at", "description": "Timestamp of last record update.", "data_type": "datetime", "example": "2026-08-29T13:45:00Z", "source": "System", "status": "live", "evidence_level": "system", "sensitivity": "internal", "update_cadence": "change", "banking_use": "Data freshness", "insurance_use": "Evidence freshness", "mrv_use": "Monitoring chronology", "notes": "Maintain change history for high-value records." }, { "domain": "Governance & Identity", "field_id": "GOV-007", "field_name": "Source type", "json_path": "metadata.source_type", "description": "Origin of the field or record.", "data_type": "enum", "example": "farmer_entered", "source": "System", "status": "derived", "evidence_level": "system", "sensitivity": "internal", "update_cadence": "event", "banking_use": "Data quality weighting", "insurance_use": "Claims evidence weighting", "mrv_use": "Provenance", "notes": "Examples: farmer_entered, ai_derived, weather_provider, partner." }, { "domain": "Governance & Identity", "field_id": "GOV-008", "field_name": "Source version", "json_path": "metadata.source_version", "description": "Version of model, rule-set, API or taxonomy that produced a derived field.", "data_type": "string", "example": "crop-analysis-v3", "source": "System", "status": "proposed", "evidence_level": "system", "sensitivity": "internal", "update_cadence": "event", "banking_use": "Model-risk governance", "insurance_use": "Claims auditability", "mrv_use": "MRV auditability", "notes": "Important for reproducibility." }, { "domain": "Governance & Identity", "field_id": "GOV-009", "field_name": "Evidence status", "json_path": "evidence.status", "description": "Maturity of the evidence record.", "data_type": "enum", "example": "evidence_attached", "source": "System / verifier", "status": "proposed", "evidence_level": "mixed", "sensitivity": "internal", "update_cadence": "change", "banking_use": "Confidence in field signal", "insurance_use": "Confidence in triage input", "mrv_use": "MRV maturity", "notes": "Recommended → self-recorded → evidence attached → validated → certified." }, { "domain": "Governance & Identity", "field_id": "GOV-010", "field_name": "Data quality score", "json_path": "quality.completeness_score", "description": "Completeness/quality indicator for institutional interpretation.", "data_type": "number 0..1", "example": "0.86", "source": "System", "status": "proposed", "evidence_level": "derived", "sensitivity": "internal", "update_cadence": "change", "banking_use": "Coverage/confidence", "insurance_use": "Coverage/confidence", "mrv_use": "MRV readiness", "notes": "Not a farmer risk score." }, { "domain": "Farm & Geography", "field_id": "FARM-001", "field_name": "Country", "json_path": "farm.country_code", "description": "Country associated with farm/activity.", "data_type": "ISO-3166 string", "example": "TR", "source": "User / device", "status": "live_if_provided", "evidence_level": "self-recorded", "sensitivity": "sensitive", "update_cadence": "change", "banking_use": "Portfolio geography", "insurance_use": "Exposure geography", "mrv_use": "Program jurisdiction", "notes": "Use appropriate precision." }, { "domain": "Farm & Geography", "field_id": "FARM-002", "field_name": "Region / province", "json_path": "farm.region", "description": "Administrative region.", "data_type": "string", "example": "Konya", "source": "User / location", "status": "live_if_provided", "evidence_level": "self-recorded", "sensitivity": "sensitive", "update_cadence": "change", "banking_use": "Regional portfolio segmentation", "insurance_use": "Accumulation analysis", "mrv_use": "Regional program mapping", "notes": "" }, { "domain": "Farm & Geography", "field_id": "FARM-003", "field_name": "District / locality", "json_path": "farm.district", "description": "Local administrative area used for agricultural analysis.", "data_type": "string", "example": "Cihanbeyli", "source": "User / location", "status": "live_if_provided", "evidence_level": "self-recorded", "sensitivity": "sensitive", "update_cadence": "change", "banking_use": "Local crop suitability context", "insurance_use": "Local risk clustering", "mrv_use": "Program targeting", "notes": "" }, { "domain": "Farm & Geography", "field_id": "FARM-004", "field_name": "Latitude", "json_path": "farm.location.lat", "description": "Latitude for permissioned analysis/event.", "data_type": "number", "example": "38.65", "source": "Device / user", "status": "live_if_provided", "evidence_level": "system", "sensitivity": "sensitive", "update_cadence": "event", "banking_use": "Precise agricultural exposure", "insurance_use": "Claim/event geolocation", "mrv_use": "MRV project geometry input", "notes": "External sharing may require coarser precision." }, { "domain": "Farm & Geography", "field_id": "FARM-005", "field_name": "Longitude", "json_path": "farm.location.lon", "description": "Longitude for permissioned analysis/event.", "data_type": "number", "example": "32.92", "source": "Device / user", "status": "live_if_provided", "evidence_level": "system", "sensitivity": "sensitive", "update_cadence": "event", "banking_use": "Precise agricultural exposure", "insurance_use": "Claim/event geolocation", "mrv_use": "MRV project geometry input", "notes": "External sharing may require coarser precision." }, { "domain": "Farm & Geography", "field_id": "FARM-006", "field_name": "Location precision", "json_path": "farm.location.precision_m", "description": "Estimated location precision.", "data_type": "number", "example": "50", "source": "Device", "status": "proposed", "evidence_level": "system", "sensitivity": "internal", "update_cadence": "event", "banking_use": "Confidence in geography", "insurance_use": "Evidence confidence", "mrv_use": "MRV suitability", "notes": "" }, { "domain": "Farm & Geography", "field_id": "FARM-007", "field_name": "Field / parcel reference", "json_path": "farm.parcel_ref", "description": "Internal or partner-provided field/parcel identifier.", "data_type": "string", "example": "parcel_...", "source": "User / partner", "status": "proposed", "evidence_level": "partner", "sensitivity": "sensitive", "update_cadence": "change", "banking_use": "Loan collateral/production unit mapping", "insurance_use": "Policy unit mapping", "mrv_use": "Project/parcel mapping", "notes": "Avoid storing land-title assumptions." }, { "domain": "Farm & Geography", "field_id": "FARM-008", "field_name": "Area", "json_path": "farm.area_ha", "description": "Farm/field area where explicitly provided.", "data_type": "number", "example": "12.5", "source": "User / partner", "status": "proposed", "evidence_level": "self-recorded", "sensitivity": "sensitive", "update_cadence": "change", "banking_use": "Exposure sizing", "insurance_use": "Sum-insured context", "mrv_use": "Activity/project sizing", "notes": "Requires validation for formal use." }, { "domain": "Farm & Geography", "field_id": "FARM-009", "field_name": "Elevation", "json_path": "farm.elevation_m", "description": "Approximate elevation derived from location where used.", "data_type": "number", "example": "1020", "source": "External geo source", "status": "proposed", "evidence_level": "derived", "sensitivity": "internal", "update_cadence": "change", "banking_use": "Agronomic context", "insurance_use": "Weather/frost context", "mrv_use": "Environmental context", "notes": "" }, { "domain": "Farm & Geography", "field_id": "FARM-010", "field_name": "Farm system type", "json_path": "farm.system_type", "description": "Broad production system.", "data_type": "enum", "example": "rainfed_field_crop", "source": "User / derived", "status": "proposed", "evidence_level": "mixed", "sensitivity": "internal", "update_cadence": "change", "banking_use": "Segment farm risk", "insurance_use": "Underwriting context", "mrv_use": "Methodology eligibility context", "notes": "" }, { "domain": "Crop & Production", "field_id": "CROP-001", "field_name": "Crop name", "json_path": "crop.name", "description": "Crop selected or analysed.", "data_type": "string", "example": "wheat", "source": "User", "status": "live", "evidence_level": "self-recorded", "sensitivity": "internal", "update_cadence": "event", "banking_use": "Loan purpose / exposure", "insurance_use": "Insured crop context", "mrv_use": "Practice/methodology context", "notes": "" }, { "domain": "Crop & Production", "field_id": "CROP-002", "field_name": "Crop type", "json_path": "crop.type", "description": "Normalized crop category.", "data_type": "enum", "example": "annual_field_crop", "source": "System", "status": "derived", "evidence_level": "derived", "sensitivity": "internal", "update_cadence": "event", "banking_use": "Portfolio grouping", "insurance_use": "Product/rate segmentation", "mrv_use": "Methodology grouping", "notes": "" }, { "domain": "Crop & Production", "field_id": "CROP-003", "field_name": "Suitability score", "json_path": "analysis.crop_suitability.score", "description": "AI-generated crop suitability score.", "data_type": "integer 0..100", "example": "82", "source": "AI", "status": "live", "evidence_level": "ai-derived", "sensitivity": "internal", "update_cadence": "analysis", "banking_use": "Credit context only", "insurance_use": "Risk context only", "mrv_use": "Not primary MRV input", "notes": "Not a bank credit score." }, { "domain": "Crop & Production", "field_id": "CROP-004", "field_name": "Suitability level", "json_path": "analysis.crop_suitability.level", "description": "Categorical suitability assessment.", "data_type": "enum", "example": "high", "source": "AI", "status": "live", "evidence_level": "ai-derived", "sensitivity": "internal", "update_cadence": "analysis", "banking_use": "Production-context enrichment", "insurance_use": "Underwriting context", "mrv_use": "—", "notes": "" }, { "domain": "Crop & Production", "field_id": "CROP-005", "field_name": "Result summary", "json_path": "analysis.crop_suitability.summary", "description": "Human-readable crop analysis summary.", "data_type": "text", "example": "Suitable with irrigation caution", "source": "AI", "status": "live", "evidence_level": "ai-derived", "sensitivity": "internal", "update_cadence": "analysis", "banking_use": "Relationship-manager context", "insurance_use": "Underwriter context", "mrv_use": "—", "notes": "" }, { "domain": "Crop & Production", "field_id": "CROP-006", "field_name": "Top recommendations", "json_path": "analysis.crop_suitability.top_recommendations[]", "description": "Highest-priority recommendations returned by analysis.", "data_type": "string[]", "example": "[soil test, irrigation planning]", "source": "AI", "status": "live", "evidence_level": "ai-derived", "sensitivity": "internal", "update_cadence": "analysis", "banking_use": "Advisory context", "insurance_use": "Prevention/risk mitigation", "mrv_use": "Practice guidance", "notes": "" }, { "domain": "Crop & Production", "field_id": "CROP-007", "field_name": "Planting window", "json_path": "analysis.planting_window", "description": "Suggested planting period.", "data_type": "date range", "example": "2026-10-15/2026-11-15", "source": "AI", "status": "live", "evidence_level": "ai-derived", "sensitivity": "internal", "update_cadence": "seasonal", "banking_use": "Production timing", "insurance_use": "Seasonal exposure", "mrv_use": "Practice schedule context", "notes": "" }, { "domain": "Crop & Production", "field_id": "CROP-008", "field_name": "Planting timing status", "json_path": "analysis.timing_status", "description": "Whether current timing is early/on-time/late/not suitable.", "data_type": "enum", "example": "on_time", "source": "AI", "status": "live", "evidence_level": "ai-derived", "sensitivity": "internal", "update_cadence": "daily/analysis", "banking_use": "Operational context", "insurance_use": "Exposure context", "mrv_use": "—", "notes": "" }, { "domain": "Crop & Production", "field_id": "CROP-009", "field_name": "Today's planting score", "json_path": "analysis.today_planting_score", "description": "AI-generated score for planting today.", "data_type": "integer 0..100", "example": "74", "source": "AI", "status": "live", "evidence_level": "ai-derived", "sensitivity": "internal", "update_cadence": "daily", "banking_use": "Operational context", "insurance_use": "Weather-sensitive exposure", "mrv_use": "—", "notes": "" }, { "domain": "Crop & Production", "field_id": "CROP-010", "field_name": "Pre-plant preparation", "json_path": "analysis.preplant_actions[]", "description": "Recommended preparation actions before planting.", "data_type": "object[]", "example": "soil test; seedbed prep", "source": "AI", "status": "live", "evidence_level": "ai-derived", "sensitivity": "internal", "update_cadence": "analysis", "banking_use": "Use-of-funds context", "insurance_use": "Prevention guidance", "mrv_use": "Possible practice evidence precursor", "notes": "Recommendation ≠ implementation." }, { "domain": "Crop & Production", "field_id": "CROP-011", "field_name": "Yield expectation", "json_path": "analysis.yield_expectation", "description": "AI-generated qualitative/quantitative yield expectation where available.", "data_type": "object/string", "example": "medium-high", "source": "AI", "status": "live", "evidence_level": "ai-derived", "sensitivity": "internal", "update_cadence": "analysis", "banking_use": "Cash-flow scenario context", "insurance_use": "Sum-insured / risk context", "mrv_use": "—", "notes": "Not validated yield forecast unless partner-tested." }, { "domain": "Crop & Production", "field_id": "CROP-012", "field_name": "Harvest estimate", "json_path": "analysis.harvest_estimate", "description": "Estimated harvest period.", "data_type": "date range/string", "example": "July 2027", "source": "AI", "status": "live", "evidence_level": "ai-derived", "sensitivity": "internal", "update_cadence": "analysis", "banking_use": "Repayment timing context", "insurance_use": "Exposure duration", "mrv_use": "—", "notes": "" }, { "domain": "Crop & Production", "field_id": "CROP-013", "field_name": "Regional notes", "json_path": "analysis.regional_notes[]", "description": "Region-specific agronomic considerations.", "data_type": "string[]", "example": "late frost risk", "source": "AI", "status": "live", "evidence_level": "ai-derived", "sensitivity": "internal", "update_cadence": "analysis", "banking_use": "Portfolio context", "insurance_use": "Underwriting context", "mrv_use": "—", "notes": "" }, { "domain": "Crop & Production", "field_id": "CROP-014", "field_name": "Climate-change note", "json_path": "analysis.climate_change_note", "description": "AI-generated climate-change implications for crop/location.", "data_type": "text", "example": "Higher heat stress risk", "source": "AI", "status": "live", "evidence_level": "ai-derived", "sensitivity": "internal", "update_cadence": "analysis", "banking_use": "Longer-term portfolio context", "insurance_use": "Climate-risk context", "mrv_use": "Resilience context", "notes": "" }, { "domain": "Crop & Production", "field_id": "CROP-015", "field_name": "Post-harvest plan", "json_path": "analysis.post_harvest_calendar[]", "description": "Recommended post-harvest actions.", "data_type": "object[]", "example": "residue management", "source": "AI", "status": "live", "evidence_level": "ai-derived", "sensitivity": "internal", "update_cadence": "seasonal", "banking_use": "Next-cycle context", "insurance_use": "Risk prevention", "mrv_use": "Potential regenerative practice precursor", "notes": "" }, { "domain": "Soil, Water & Inputs", "field_id": "SOIL-001", "field_name": "Soil pH target", "json_path": "analysis.soil.ph_target", "description": "Recommended pH range for crop.", "data_type": "range", "example": "6.0-7.0", "source": "AI/reference", "status": "live", "evidence_level": "ai-derived", "sensitivity": "internal", "update_cadence": "analysis", "banking_use": "Agronomic viability", "insurance_use": "Production-risk context", "mrv_use": "Soil-management context", "notes": "" }, { "domain": "Soil, Water & Inputs", "field_id": "SOIL-002", "field_name": "Nitrogen target", "json_path": "analysis.soil.n_target", "description": "Recommended nitrogen range/need.", "data_type": "object", "example": "crop-stage dependent", "source": "AI/reference", "status": "live", "evidence_level": "ai-derived", "sensitivity": "internal", "update_cadence": "analysis", "banking_use": "Input-finance context", "insurance_use": "Management-risk context", "mrv_use": "Nutrient-management evidence context", "notes": "" }, { "domain": "Soil, Water & Inputs", "field_id": "SOIL-003", "field_name": "Phosphorus target", "json_path": "analysis.soil.p_target", "description": "Recommended phosphorus range/need.", "data_type": "object", "example": "crop-stage dependent", "source": "AI/reference", "status": "live", "evidence_level": "ai-derived", "sensitivity": "internal", "update_cadence": "analysis", "banking_use": "Input-finance context", "insurance_use": "Management-risk context", "mrv_use": "Nutrient-management context", "notes": "" }, { "domain": "Soil, Water & Inputs", "field_id": "SOIL-004", "field_name": "Potassium target", "json_path": "analysis.soil.k_target", "description": "Recommended potassium range/need.", "data_type": "object", "example": "crop-stage dependent", "source": "AI/reference", "status": "live", "evidence_level": "ai-derived", "sensitivity": "internal", "update_cadence": "analysis", "banking_use": "Input-finance context", "insurance_use": "Management-risk context", "mrv_use": "Nutrient-management context", "notes": "" }, { "domain": "Soil, Water & Inputs", "field_id": "SOIL-005", "field_name": "Observed soil test result", "json_path": "evidence.soil_test", "description": "User/partner supplied laboratory result.", "data_type": "object", "example": "pH 6.4; OM 2.1%", "source": "Lab / user / partner", "status": "proposed", "evidence_level": "external", "sensitivity": "sensitive", "update_cadence": "event", "banking_use": "Production-quality evidence", "insurance_use": "Underwriting evidence", "mrv_use": "MRV measurement input", "notes": "Do not conflate target with measured soil data." }, { "domain": "Soil, Water & Inputs", "field_id": "WATR-001", "field_name": "Irrigation schedule", "json_path": "analysis.irrigation_calendar[]", "description": "Recommended irrigation timing by crop stage.", "data_type": "object[]", "example": "weekly / stage-based", "source": "AI", "status": "live", "evidence_level": "ai-derived", "sensitivity": "internal", "update_cadence": "weekly", "banking_use": "Operating-context enrichment", "insurance_use": "Risk-mitigation context", "mrv_use": "Water-efficiency program context", "notes": "Recommendation ≠ actual irrigation." }, { "domain": "Soil, Water & Inputs", "field_id": "WATR-002", "field_name": "Recorded irrigation event", "json_path": "activity.irrigation[]", "description": "Farmer-recorded irrigation event.", "data_type": "object[]", "example": "2026-06-03; 20 mm", "source": "Farmer", "status": "proposed", "evidence_level": "self-recorded", "sensitivity": "sensitive", "update_cadence": "event", "banking_use": "Operating history", "insurance_use": "Loss-context evidence", "mrv_use": "Water-efficiency evidence", "notes": "" }, { "domain": "Soil, Water & Inputs", "field_id": "INPT-001", "field_name": "Fertilization schedule", "json_path": "analysis.fertilizer_calendar[]", "description": "Recommended fertilization timing and dosage guidance.", "data_type": "object[]", "example": "N topdress stage 2", "source": "AI", "status": "live", "evidence_level": "ai-derived", "sensitivity": "internal", "update_cadence": "seasonal", "banking_use": "Input-finance planning", "insurance_use": "Management context", "mrv_use": "Nutrient-management context", "notes": "Recommendation ≠ application." }, { "domain": "Soil, Water & Inputs", "field_id": "INPT-002", "field_name": "Recorded fertilizer application", "json_path": "activity.fertilizer[]", "description": "Farmer/partner recorded fertilizer application.", "data_type": "object[]", "example": "urea; 80 kg/ha", "source": "Farmer / partner", "status": "proposed", "evidence_level": "mixed", "sensitivity": "sensitive", "update_cadence": "event", "banking_use": "Use-of-funds / cost context", "insurance_use": "Risk / management context", "mrv_use": "GHG / nutrient MRV input", "notes": "Requires unit normalization." }, { "domain": "Soil, Water & Inputs", "field_id": "INPT-003", "field_name": "Tillage practice", "json_path": "activity.tillage", "description": "Recorded tillage practice.", "data_type": "enum/object", "example": "reduced_tillage", "source": "Farmer", "status": "live_if_recorded_in_carbon_diary", "evidence_level": "self-recorded", "sensitivity": "sensitive", "update_cadence": "event", "banking_use": "Sustainability-linked finance", "insurance_use": "Resilience/prevention context", "mrv_use": "Carbon-farming practice evidence", "notes": "" }, { "domain": "Soil, Water & Inputs", "field_id": "INPT-004", "field_name": "Organic amendment / compost", "json_path": "activity.organic_amendment", "description": "Recorded organic amendment activity.", "data_type": "object", "example": "compost applied", "source": "Farmer", "status": "live_if_recorded_in_carbon_diary", "evidence_level": "self-recorded", "sensitivity": "sensitive", "update_cadence": "event", "banking_use": "Green-finance evidence", "insurance_use": "Resilience context", "mrv_use": "Carbon/soil MRV input", "notes": "" }, { "domain": "Weather & Climate", "field_id": "WX-001", "field_name": "Current temperature", "json_path": "weather.current.temperature_c", "description": "Current temperature used in analysis.", "data_type": "number", "example": "31.2", "source": "Weather provider", "status": "live", "evidence_level": "external", "sensitivity": "internal", "update_cadence": "hourly", "banking_use": "Production context", "insurance_use": "Event context", "mrv_use": "MRV contextual only", "notes": "" }, { "domain": "Weather & Climate", "field_id": "WX-002", "field_name": "Current precipitation", "json_path": "weather.current.precipitation_mm", "description": "Current/recent precipitation.", "data_type": "number", "example": "0.0", "source": "Weather provider", "status": "live", "evidence_level": "external", "sensitivity": "internal", "update_cadence": "hourly", "banking_use": "Production context", "insurance_use": "Claim/event context", "mrv_use": "Contextual only", "notes": "" }, { "domain": "Weather & Climate", "field_id": "WX-003", "field_name": "Forecast horizon", "json_path": "weather.forecast[]", "description": "Short-term weather forecast used for planning.", "data_type": "object[]", "example": "5-day forecast", "source": "Weather provider", "status": "live", "evidence_level": "external", "sensitivity": "internal", "update_cadence": "daily", "banking_use": "Cash-flow/operations context", "insurance_use": "Early-warning context", "mrv_use": "Practice scheduling context", "notes": "" }, { "domain": "Weather & Climate", "field_id": "WX-004", "field_name": "Extreme-weather flag", "json_path": "weather.risk_flags[]", "description": "Derived weather-risk flags.", "data_type": "enum[]", "example": "heat", "source": "AI / weather rules", "status": "derived", "evidence_level": "derived", "sensitivity": "internal", "update_cadence": "daily", "banking_use": "Portfolio monitoring", "insurance_use": "Early warning", "mrv_use": "Resilience context", "notes": "" }, { "domain": "Weather & Climate", "field_id": "WX-005", "field_name": "Historical climate summary", "json_path": "climate.history_summary", "description": "Historical climate context used by crop-choice workflows.", "data_type": "object/text", "example": "3-year temperature/rainfall pattern", "source": "External datasets / AI", "status": "live_for_what_should_i_plant", "evidence_level": "derived", "sensitivity": "internal", "update_cadence": "analysis", "banking_use": "Crop-choice context", "insurance_use": "Long-term exposure context", "mrv_use": "Baseline context only", "notes": "" }, { "domain": "Weather & Climate", "field_id": "WX-006", "field_name": "Near-term climate outlook", "json_path": "climate.forward_outlook", "description": "Forward climate/weather outlook used by crop-choice workflows.", "data_type": "object/text", "example": "next-month outlook", "source": "External datasets / AI", "status": "live_for_what_should_i_plant", "evidence_level": "derived", "sensitivity": "internal", "update_cadence": "analysis", "banking_use": "Crop-choice context", "insurance_use": "Exposure planning", "mrv_use": "Practice timing context", "notes": "" }, { "domain": "Plant Health & Risk", "field_id": "PH-001", "field_name": "Photo reference", "json_path": "plant_health.photo_ref", "description": "Reference to farmer-submitted crop/plant image.", "data_type": "string", "example": "img_...", "source": "Farmer", "status": "live", "evidence_level": "self-recorded", "sensitivity": "sensitive", "update_cadence": "event", "banking_use": "Field-evidence context", "insurance_use": "Claim-triage evidence", "mrv_use": "Not primary MRV except practice evidence", "notes": "Image governance required." }, { "domain": "Plant Health & Risk", "field_id": "PH-002", "field_name": "Capture time", "json_path": "plant_health.captured_at", "description": "Time associated with image/event.", "data_type": "datetime", "example": "2026-05-17T08:15Z", "source": "Device / system", "status": "live", "evidence_level": "system", "sensitivity": "internal", "update_cadence": "event", "banking_use": "Chronology", "insurance_use": "Claim chronology", "mrv_use": "Evidence chronology", "notes": "" }, { "domain": "Plant Health & Risk", "field_id": "PH-003", "field_name": "Crop / plant identification", "json_path": "plant_health.crop", "description": "Crop/plant associated with photo analysis.", "data_type": "string", "example": "cotton", "source": "User / AI", "status": "live", "evidence_level": "mixed", "sensitivity": "internal", "update_cadence": "event", "banking_use": "Exposure context", "insurance_use": "Underwriting/claim context", "mrv_use": "—", "notes": "" }, { "domain": "Plant Health & Risk", "field_id": "PH-004", "field_name": "Observed condition category", "json_path": "plant_health.condition_category", "description": "Normalized risk/condition category.", "data_type": "enum", "example": "leaf_spot", "source": "AI", "status": "derived", "evidence_level": "ai-derived", "sensitivity": "internal", "update_cadence": "event", "banking_use": "Early field risk", "insurance_use": "Claim triage", "mrv_use": "—", "notes": "" }, { "domain": "Plant Health & Risk", "field_id": "PH-005", "field_name": "Analysis summary", "json_path": "plant_health.analysis_summary", "description": "AI-generated interpretation of the observed plant condition.", "data_type": "text", "example": "possible bacterial leaf spot", "source": "AI", "status": "live", "evidence_level": "ai-derived", "sensitivity": "internal", "update_cadence": "event", "banking_use": "Agronomic support", "insurance_use": "Triage context", "mrv_use": "—", "notes": "Not definitive diagnosis." }, { "domain": "Plant Health & Risk", "field_id": "PH-006", "field_name": "Severity indicator", "json_path": "plant_health.severity", "description": "Severity band where supported by workflow.", "data_type": "enum", "example": "moderate", "source": "AI", "status": "proposed", "evidence_level": "ai-derived", "sensitivity": "internal", "update_cadence": "event", "banking_use": "Risk prioritization", "insurance_use": "Claim/inspection prioritization", "mrv_use": "—", "notes": "Requires validation." }, { "domain": "Plant Health & Risk", "field_id": "PH-007", "field_name": "Model confidence", "json_path": "plant_health.model_confidence", "description": "Confidence/uncertainty metadata for AI interpretation.", "data_type": "number/object", "example": "0.71", "source": "AI", "status": "proposed", "evidence_level": "ai-derived", "sensitivity": "internal", "update_cadence": "event", "banking_use": "Model-risk governance", "insurance_use": "Triage confidence", "mrv_use": "—", "notes": "" }, { "domain": "Plant Health & Risk", "field_id": "PH-008", "field_name": "Recommended action", "json_path": "plant_health.recommendations[]", "description": "AI-supported next-step recommendations.", "data_type": "string[]", "example": "isolate; inspect nearby plants", "source": "AI", "status": "live", "evidence_level": "ai-derived", "sensitivity": "internal", "update_cadence": "event", "banking_use": "Risk mitigation support", "insurance_use": "Loss-prevention support", "mrv_use": "—", "notes": "" }, { "domain": "Plant Health & Risk", "field_id": "PH-009", "field_name": "Risk cluster signal", "json_path": "derived.risk_cluster", "description": "Aggregated signal for repeated similar observations by crop/geography/time.", "data_type": "object", "example": "cotton_leaf_risk_cluster", "source": "Analytics layer", "status": "proposed", "evidence_level": "derived", "sensitivity": "aggregated", "update_cadence": "daily", "banking_use": "Portfolio early warning", "insurance_use": "Accumulation / early warning", "mrv_use": "—", "notes": "Requires minimum sample/coverage thresholds." }, { "domain": "Decision Support", "field_id": "PLAN-001", "field_name": "Weekly plan items", "json_path": "weekly_plan.items[]", "description": "Weather-, crop- and condition-aware weekly farm actions.", "data_type": "object[]", "example": "irrigate Tuesday; scout Friday", "source": "AI", "status": "live", "evidence_level": "ai-derived", "sensitivity": "internal", "update_cadence": "weekly", "banking_use": "Operational context", "insurance_use": "Prevention context", "mrv_use": "Practice planning", "notes": "" }, { "domain": "Decision Support", "field_id": "PLAN-002", "field_name": "Weekly risk warnings", "json_path": "weekly_plan.risk_warnings[]", "description": "Near-term risks surfaced in weekly plan.", "data_type": "object[]", "example": "heat stress", "source": "AI", "status": "live", "evidence_level": "ai-derived", "sensitivity": "internal", "update_cadence": "weekly", "banking_use": "Portfolio monitoring context", "insurance_use": "Early-warning context", "mrv_use": "Resilience context", "notes": "" }, { "domain": "Decision Support", "field_id": "PLAN-003", "field_name": "Recommended crop list", "json_path": "what_should_i_plant.candidates[]", "description": "Ranked crop candidates for a selected region.", "data_type": "object[]", "example": "sunflower 84; barley 77", "source": "AI", "status": "live", "evidence_level": "ai-derived", "sensitivity": "internal", "update_cadence": "analysis", "banking_use": "Loan-purpose planning", "insurance_use": "New-business exposure context", "mrv_use": "Crop-rotation / resilience context", "notes": "" }, { "domain": "Decision Support", "field_id": "PLAN-004", "field_name": "Crop recommendation rationale", "json_path": "what_should_i_plant.rationale", "description": "Explanation for candidate ranking.", "data_type": "text", "example": "rainfall and market-season fit", "source": "AI", "status": "live", "evidence_level": "ai-derived", "sensitivity": "internal", "update_cadence": "analysis", "banking_use": "Relationship-manager context", "insurance_use": "Underwriter context", "mrv_use": "—", "notes": "" }, { "domain": "Decision Support", "field_id": "PLAN-005", "field_name": "Historical analysis reference", "json_path": "history.analysis_id", "description": "Reference to prior user analysis.", "data_type": "string", "example": "ana_...", "source": "System", "status": "live", "evidence_level": "system", "sensitivity": "internal", "update_cadence": "event", "banking_use": "Longitudinal borrower context", "insurance_use": "Longitudinal policy context", "mrv_use": "Longitudinal evidence context", "notes": "" }, { "domain": "Regenerative & Carbon", "field_id": "CARB-001", "field_name": "Practice category", "json_path": "carbon_diary.practice_category", "description": "Normalized sustainability/regenerative practice category.", "data_type": "enum", "example": "cover_crop", "source": "Farmer / taxonomy", "status": "live", "evidence_level": "self-recorded", "sensitivity": "sensitive", "update_cadence": "event", "banking_use": "Green-finance evidence", "insurance_use": "Resilience program evidence", "mrv_use": "MRV practice evidence", "notes": "" }, { "domain": "Regenerative & Carbon", "field_id": "CARB-002", "field_name": "Practice date", "json_path": "carbon_diary.practice_date", "description": "Date of recorded activity.", "data_type": "date", "example": "2026-10-15", "source": "Farmer / system", "status": "live", "evidence_level": "self-recorded", "sensitivity": "sensitive", "update_cadence": "event", "banking_use": "Implementation timeline", "insurance_use": "Prevention history", "mrv_use": "MRV chronology", "notes": "" }, { "domain": "Regenerative & Carbon", "field_id": "CARB-003", "field_name": "Practice location", "json_path": "carbon_diary.location", "description": "Location linked to activity.", "data_type": "geo/object", "example": "permissioned location", "source": "Farmer / device", "status": "live", "evidence_level": "mixed", "sensitivity": "sensitive", "update_cadence": "event", "banking_use": "Green-finance evidence", "insurance_use": "Resilience context", "mrv_use": "Project boundary input", "notes": "" }, { "domain": "Regenerative & Carbon", "field_id": "CARB-004", "field_name": "Practice photo reference", "json_path": "carbon_diary.photo_refs[]", "description": "Photo evidence attached to recorded activity.", "data_type": "string[]", "example": "img_...", "source": "Farmer", "status": "live", "evidence_level": "self-recorded", "sensitivity": "sensitive", "update_cadence": "event", "banking_use": "Evidence quality", "insurance_use": "Evidence quality", "mrv_use": "MRV evidence input", "notes": "Photo alone is not verification." }, { "domain": "Regenerative & Carbon", "field_id": "CARB-005", "field_name": "Practice notes", "json_path": "carbon_diary.notes", "description": "Farmer description of activity.", "data_type": "text", "example": "cover crop seeded after harvest", "source": "Farmer", "status": "live", "evidence_level": "self-recorded", "sensitivity": "sensitive", "update_cadence": "event", "banking_use": "Context", "insurance_use": "Context", "mrv_use": "MRV context", "notes": "" }, { "domain": "Regenerative & Carbon", "field_id": "CARB-006", "field_name": "Evidence status", "json_path": "carbon_diary.evidence_status", "description": "Maturity status for the record.", "data_type": "enum", "example": "self_recorded", "source": "System / verifier", "status": "proposed", "evidence_level": "mixed", "sensitivity": "internal", "update_cadence": "change", "banking_use": "Green-finance monitoring", "insurance_use": "Resilience monitoring", "mrv_use": "MRV maturity", "notes": "" }, { "domain": "Regenerative & Carbon", "field_id": "CARB-007", "field_name": "Methodology mapping", "json_path": "carbon_diary.methodology_mapping", "description": "External methodology identifier/version if mapped.", "data_type": "object", "example": "CRCF_method_x_v1", "source": "MRV partner", "status": "proposed", "evidence_level": "external", "sensitivity": "internal", "update_cadence": "change", "banking_use": "Program eligibility context", "insurance_use": "Sustainability-product context", "mrv_use": "Core MRV mapping", "notes": "No mapping by default." }, { "domain": "Regenerative & Carbon", "field_id": "CARB-008", "field_name": "Baseline reference", "json_path": "carbon_diary.baseline_ref", "description": "Reference to baseline required by selected methodology/program.", "data_type": "string/object", "example": "baseline_...", "source": "MRV partner", "status": "proposed", "evidence_level": "external", "sensitivity": "sensitive", "update_cadence": "change", "banking_use": "Green-finance program", "insurance_use": "—", "mrv_use": "MRV quantification", "notes": "" }, { "domain": "Regenerative & Carbon", "field_id": "CARB-009", "field_name": "Monitoring plan reference", "json_path": "carbon_diary.monitoring_plan_ref", "description": "Reference to partner/program monitoring plan.", "data_type": "string", "example": "mp_...", "source": "MRV partner", "status": "proposed", "evidence_level": "external", "sensitivity": "sensitive", "update_cadence": "change", "banking_use": "Program monitoring", "insurance_use": "—", "mrv_use": "Formal MRV workflow", "notes": "" }, { "domain": "Regenerative & Carbon", "field_id": "CARB-010", "field_name": "External validation status", "json_path": "carbon_diary.validation_status", "description": "Whether record has been independently validated.", "data_type": "enum", "example": "not_validated", "source": "Verifier / partner", "status": "proposed", "evidence_level": "external", "sensitivity": "internal", "update_cadence": "change", "banking_use": "Evidence confidence", "insurance_use": "Evidence confidence", "mrv_use": "Verification status", "notes": "" }, { "domain": "Regenerative & Carbon", "field_id": "CARB-011", "field_name": "Quantified climate outcome", "json_path": "carbon_diary.quantified_outcome", "description": "Methodology-derived climate outcome where externally quantified.", "data_type": "object/null", "example": "null", "source": "MRV partner", "status": "proposed", "evidence_level": "external", "sensitivity": "sensitive", "update_cadence": "change", "banking_use": "Green-finance metric if eligible", "insurance_use": "Product design context", "mrv_use": "Formal MRV output", "notes": "Null until qualified method applied." }, { "domain": "Regenerative & Carbon", "field_id": "CARB-012", "field_name": "Certification reference", "json_path": "carbon_diary.certification_ref", "description": "Reference to recognized certification outcome, if any.", "data_type": "string/null", "example": "null", "source": "Certification scheme", "status": "proposed", "evidence_level": "external", "sensitivity": "sensitive", "update_cadence": "change", "banking_use": "Verified green-finance evidence", "insurance_use": "—", "mrv_use": "Certification traceability", "notes": "Never created internally without formal certification." }, { "domain": "Livestock", "field_id": "LIVE-001", "field_name": "Species", "json_path": "livestock.species", "description": "Livestock species in analysis/workflow.", "data_type": "string", "example": "cattle", "source": "User", "status": "live", "evidence_level": "self-recorded", "sensitivity": "internal", "update_cadence": "event", "banking_use": "Agricultural exposure", "insurance_use": "Livestock policy context", "mrv_use": "—", "notes": "" }, { "domain": "Livestock", "field_id": "LIVE-002", "field_name": "Breed", "json_path": "livestock.breed", "description": "Breed where provided.", "data_type": "string", "example": "Holstein", "source": "User", "status": "live_if_provided", "evidence_level": "self-recorded", "sensitivity": "internal", "update_cadence": "event", "banking_use": "Production context", "insurance_use": "Underwriting context", "mrv_use": "—", "notes": "" }, { "domain": "Livestock", "field_id": "LIVE-003", "field_name": "Animal/group age", "json_path": "livestock.age", "description": "Age or age band where provided.", "data_type": "number/enum", "example": "24 months", "source": "User", "status": "live_if_provided", "evidence_level": "self-recorded", "sensitivity": "sensitive", "update_cadence": "event", "banking_use": "Production context", "insurance_use": "Underwriting context", "mrv_use": "—", "notes": "" }, { "domain": "Livestock", "field_id": "LIVE-004", "field_name": "Animal/group weight", "json_path": "livestock.weight_kg", "description": "Weight where provided for husbandry/ration workflow.", "data_type": "number", "example": "620", "source": "User", "status": "live_if_provided", "evidence_level": "self-recorded", "sensitivity": "sensitive", "update_cadence": "event", "banking_use": "Production context", "insurance_use": "Underwriting context", "mrv_use": "—", "notes": "" }, { "domain": "Livestock", "field_id": "LIVE-005", "field_name": "Ration / feed calculation", "json_path": "livestock.feed_plan", "description": "AI/calculator generated feed/ration guidance.", "data_type": "object", "example": "dry matter target...", "source": "System / AI", "status": "live", "evidence_level": "ai-derived", "sensitivity": "internal", "update_cadence": "analysis", "banking_use": "Operating-cost context", "insurance_use": "Husbandry context", "mrv_use": "—", "notes": "" }, { "domain": "Livestock", "field_id": "LIVE-006", "field_name": "Reported health issue", "json_path": "livestock.health_issue", "description": "Farmer-reported animal health concern.", "data_type": "text/enum", "example": "reduced appetite", "source": "Farmer", "status": "live", "evidence_level": "self-recorded", "sensitivity": "sensitive", "update_cadence": "event", "banking_use": "Operational risk context", "insurance_use": "Claim/health context", "mrv_use": "—", "notes": "Not veterinary diagnosis." }, { "domain": "Livestock", "field_id": "LIVE-007", "field_name": "Livestock guidance", "json_path": "livestock.recommendations[]", "description": "AI-supported husbandry guidance.", "data_type": "string[]", "example": "monitor temperature; contact vet if...", "source": "AI", "status": "live", "evidence_level": "ai-derived", "sensitivity": "internal", "update_cadence": "event", "banking_use": "Risk mitigation", "insurance_use": "Loss-prevention context", "mrv_use": "—", "notes": "" }, { "domain": "Institutional Derived Signals", "field_id": "DER-001", "field_name": "Agricultural exposure profile", "json_path": "derived.exposure_profile", "description": "Normalized crop/geography/season profile built from permissioned records.", "data_type": "object", "example": "wheat / Konya / planting", "source": "Analytics layer", "status": "proposed", "evidence_level": "derived", "sensitivity": "aggregated", "update_cadence": "daily", "banking_use": "Core portfolio enrichment", "insurance_use": "Exposure segmentation", "mrv_use": "Program segmentation", "notes": "" }, { "domain": "Institutional Derived Signals", "field_id": "DER-002", "field_name": "Weather exposure flag", "json_path": "derived.weather_exposure", "description": "Portfolio/farm exposure to material weather condition.", "data_type": "object", "example": "heat_watch", "source": "Analytics layer", "status": "proposed", "evidence_level": "derived", "sensitivity": "aggregated", "update_cadence": "daily", "banking_use": "Monitoring", "insurance_use": "Early warning", "mrv_use": "Resilience monitoring", "notes": "" }, { "domain": "Institutional Derived Signals", "field_id": "DER-003", "field_name": "Field-risk trend", "json_path": "derived.field_risk_trend", "description": "Trend in observed plant/agricultural risk signals.", "data_type": "object", "example": "rising", "source": "Analytics layer", "status": "proposed", "evidence_level": "derived", "sensitivity": "aggregated", "update_cadence": "daily", "banking_use": "Early warning", "insurance_use": "Accumulation / triage", "mrv_use": "—", "notes": "Coverage thresholds required." }, { "domain": "Institutional Derived Signals", "field_id": "DER-004", "field_name": "Portfolio concentration", "json_path": "derived.portfolio_concentration", "description": "Concentration by crop/region/season.", "data_type": "object", "example": "31% wheat / region X", "source": "Partner + analytics", "status": "proposed", "evidence_level": "derived", "sensitivity": "aggregated", "update_cadence": "daily", "banking_use": "Credit portfolio concentration", "insurance_use": "Reinsurance accumulation", "mrv_use": "Program cohort sizing", "notes": "" }, { "domain": "Institutional Derived Signals", "field_id": "DER-005", "field_name": "Data coverage score", "json_path": "derived.data_coverage", "description": "How much of target portfolio has usable field data.", "data_type": "number 0..1", "example": "0.64", "source": "Analytics layer", "status": "proposed", "evidence_level": "derived", "sensitivity": "aggregated", "update_cadence": "daily", "banking_use": "Confidence in analytics", "insurance_use": "Confidence in analytics", "mrv_use": "MRV cohort readiness", "notes": "Absence of data ≠ absence of risk." }, { "domain": "Institutional Derived Signals", "field_id": "DER-006", "field_name": "Sustainability evidence completeness", "json_path": "derived.sustainability_completeness", "description": "Completeness of required evidence for selected program.", "data_type": "number 0..1", "example": "0.78", "source": "Analytics layer", "status": "proposed", "evidence_level": "derived", "sensitivity": "aggregated", "update_cadence": "change", "banking_use": "Green-finance monitoring", "insurance_use": "Resilience program", "mrv_use": "MRV readiness", "notes": "Not environmental performance score." }, { "domain": "Institutional Derived Signals", "field_id": "DER-007", "field_name": "MRV readiness status", "json_path": "derived.mrv_readiness", "description": "Whether evidence package meets selected adapter's minimum input requirements.", "data_type": "enum", "example": "partial", "source": "Analytics + partner rules", "status": "proposed", "evidence_level": "derived", "sensitivity": "aggregated", "update_cadence": "change", "banking_use": "Green-finance workflow", "insurance_use": "—", "mrv_use": "MRV workflow", "notes": "Not certification." }, { "domain": "Institutional Derived Signals", "field_id": "DER-008", "field_name": "Claim triage support signal", "json_path": "derived.claim_triage", "description": "Non-decisional prioritization signal for insurer workflow.", "data_type": "object", "example": "additional_evidence_needed", "source": "Analytics layer", "status": "proposed", "evidence_level": "derived", "sensitivity": "aggregated", "update_cadence": "event", "banking_use": "—", "insurance_use": "Claims triage", "mrv_use": "—", "notes": "Never automatic pay/reject." }, { "domain": "Institutional Derived Signals", "field_id": "DER-009", "field_name": "Credit monitoring support signal", "json_path": "derived.credit_monitoring", "description": "Non-decisional change indicator for agricultural credit monitoring.", "data_type": "object", "example": "field_condition_changed", "source": "Analytics layer", "status": "proposed", "evidence_level": "derived", "sensitivity": "aggregated", "update_cadence": "daily", "banking_use": "Credit monitoring", "insurance_use": "—", "mrv_use": "—", "notes": "Never automatic approve/reject." }, { "domain": "Institutional Derived Signals", "field_id": "DER-010", "field_name": "Regional sustainability cohort", "json_path": "derived.sustainability_cohort", "description": "Aggregated cohort by practice/crop/geography for program design.", "data_type": "object", "example": "cover_crop_wheat_regionX", "source": "Analytics layer", "status": "proposed", "evidence_level": "derived", "sensitivity": "aggregated", "update_cadence": "monthly", "banking_use": "Green program targeting", "insurance_use": "Prevention programs", "mrv_use": "Carbon project aggregation", "notes": "" } ] }