SmartCane/webapps/data_validation_tool/README.md

SmartCane Data Validation Tool

A standalone, client-side data validation tool for validating Excel harvest data and GeoJSON field boundaries before uploading to the SmartCane system.

Features

🚦 Traffic Light System

• 🟢 GREEN: All checks passed
• 🟡 YELLOW: Warnings detected (non-critical issues)
• 🔴 RED: Errors detected (blocking issues)

✅ Validation Checks

1. Excel Column Validation

   • Checks for all required columns: field, sub_field, year, season_start, season_end, tonnage_ha
   • Identifies extra columns that will be ignored
   • Shows missing columns that must be added

2. GeoJSON Properties Validation

   • Checks all features have required properties: field, sub_field
   • Identifies redundant properties that will be ignored

3. Coordinate Reference System (CRS)

   • Validates correct CRS: EPSG:32736 (UTM Zone 36S)
   • This CRS was validated from your Angata farm coordinates
   • Explains why this specific CRS is required

4. Field Name Matching

   • Compares field names between Excel and GeoJSON
   • Shows which fields exist in only one dataset
   • Highlights misspellings or missing fields
   • Provides complete matching summary table

5. Data Type & Content Validation

   • Checks column data types and data validity
   • Identifies rows with issues

Local Use

1. Open index.html in a web browser
2. Upload both your Excel and GeoJSON files
3. Review validation results
4. All processing happens client-side - no data is sent to servers

Deployment

Can be deployed to Netlify or any static hosting provider.