SmartCane/webapps/data_validation_tool/README.md
2026-01-06 14:17:37 +01:00

48 lines
1.6 KiB
Markdown

# 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.