AgriOps — Project Roadmap

---

Phase 1 — Core Data Models ✅ Complete

Django project setup, PostgreSQL, multi-tenant architecture, CustomUser, Company, Supplier, Farm, Product, Inventory, PurchaseOrder, SalesOrder models. Full CRUD for all modules.

---

Phase 2 — Auth, RBAC, API ✅ Complete

Session authentication, JWT API, role-based access control (system_role + job_title), RoleRequiredMixin, AuditLog on all writes, security headers, HSTS, secure cookies.

---

Phase 3 — Cloud Deployment ✅ Complete

• Render deployment (web + PostgreSQL)
• GitHub Actions CI/CD — 12 tests, auto-deploy on pass
• Custom domains — app.agriops.io, api.agriops.io, docs.agriops.io
• Brute force protection — django-axes, 5 attempts, 1hr lockout
• CORS policy — django-cors-headers
• Dashboard live stats — suppliers, farms, EUDR panel, activity feed
• Compliance PDF — full traceability report on demand
• Landing page — agriops.io with request access form

---

Phase 4 — Product Depth ✅ Complete

• Inventory commodity fields — lot number, moisture, quality grade, harvest date, origin
• Supplier reliability score
• Bulk GeoJSON farm importer — SW Maps FeatureCollection support
• Traceability certificates — Batch model, QR codes, public trace URL
• Leaflet farm boundary maps on farm detail page
• Compliance report filtering — per sales order, per date range
• Request access form backend — auto-approve, creates Company + OrgAdmin user, welcome email, founder notification
• UX polish layer — toasts, search bars, empty states, overdue badges, EUDR expiry badges across all templates
• Dashboard intelligence cards Layer 1 — 6 rotating insight slides
• Ops dashboard — TOTP 2FA, OpsEventLog, 5 monitoring panels, live at app.agriops.io/ops-access/9f3k/
• Sentry error monitoring — live on production
• Posthog analytics — autocapture, pageview tracking, authenticated user identification
• SendGrid transactional email — domain authenticated, sender verified (no-reply@agriops.io)
• Cloudflare Email Routing — founder@agriops.io forwarding
• Landing page messaging overhaul — intelligence framing, two journeys (EUDR + supply chain intelligence)

---

Phase 4.5 — Compliance Infrastructure ✅ Complete

Two gap analyses completed against EU and Nigerian export regulations. All gaps closed.

EUDR Gaps — closed March 2026

• Farm: deforestation_reference_date (default 2020-12-31) + land_cleared_after_cutoff flag ✅
• Farm: harvest_year — production period proxy per Article 9(1)(d) ✅
• Product: hs_code for due diligence statement ✅
• Batch: quantity_kg (net mass in kg, operator-confirmed) ✅
• EUDR commodity scope — EUDR_COMMODITIES lookup set, is_eudr_commodity + is_disqualified properties on Farm ✅
• Certificate PDF: supplier chain section, harvest year + reference date columns ✅
• Batch: is_locked flag + delete guard (5-year retention) ✅
• Nigeria risk classification — MONITORING

Export Compliance Gaps — closed March 2026

• PhytosanitaryCertificate model linked to Batch ✅
• BatchQualityTest model linked to Batch ✅
• Company: nepc_registration_number + nepc_registration_expiry ✅
• SalesOrder: nxp_reference + certificate_of_origin_ref ✅
• Product: nafdac_registration_number ✅
• FarmCertification model linked to Farm ✅
• Product: eu_novel_food_status + eu_novel_food_ref ✅

---

Phase 4.6 — UX Simplification & Farmer Registry ✅ Complete

Shipped March 2026. Driven by live contract execution (soy export, AgriOps Trading LTD) — all features confirmed against real operational need, not hypothetical users.

• Farmer model — proper farmer registry (name, phone, village, LGA, NIN). Replaces free-text farmer_name on Farm with a FK to a structured Farmer record ✅
• Farm form — farmer dropdown scoped to tenant, farmer_name field retired from UI ✅
• PO auto-receipt — “Mark as Received” button on PO detail automatically stocks inventory for each line item. No separate inventory trip required ✅
• Batch embedded in SO flow — farm linking moved to Sales Order detail page. User selects farms, Batch is created transparently. Batches removed from sidebar nav ✅
• EUDR certificate on SO — download button appears on Sales Order detail once farms are linked ✅
• Farmer & Farm registry exports — CSV and PDF export on both list pages. Branded PDF with AgriOps header, colour-coded EUDR status, page numbers ✅
• PDF header fix — resolved jumbled header rendering across all PDF generators (EUDR report, registry exports) ✅

Discipline note: From Phase 4.6 forward, no feature is built until confirmed by field use or direct user feedback. The live soy export contract is the primary signal source.

---

Phase 4.7 — Field Operations Hardening ✅ Complete

Shipped April 2026. Focused on making bulk farm data ingestion reliable and auditable for field officers — the people who do the uploads are typically the least technical in the organisation and the data they capture is the foundation of the EUDR compliance chain.

• GeoJSON import validation hardening — Nigeria bounding box check catches wrong CRS and swapped lat/lon; completeness warnings (non-blocking) flag missing farmer name, LGA, or commodity per row; area upper bound flags declared areas > 200 ha as suspicious ✅
• Dry-run mode — full validation pipeline runs without writing to the database. Field officers validate before committing. UI shows “would create” count and all warnings/errors ✅
• Upload history — FarmImportLog model records every import attempt (dry-run and real): who uploaded, when, which supplier, filename, all counts, and full error/blocked/warning detail in JSON. Visible on the import page (last 5) and at /farms/import/history/ (full log, expandable rows) ✅
• Mobile upload UX — import result summary appears above the form so field officers on phones see outcomes without scrolling; stats grids collapse to 2-column on small screens; download bars stack vertically; detail tables scroll horizontally ✅
• HS code in compliance PDF — batch DDS section now includes HS code derived from sales order line item products ✅
• Security patch — requests bumped to 2.33.0 ✅

---

Phase 4.8 — CI Hardening & Geospatial Integrity ✅ Complete

Shipped April 2026. Focused on making the geospatial validation pipeline structurally testable and regression-proof — a prerequisite for formal compliance assurance claims.

• GeoJSON validation test suite — 15 automated tests covering every known failure mode from real field GPS exports: self-intersecting polygons, coordinate bombs, swapped lat/lon, unclosed rings, degenerate rings, wrong geometry type, Feature wrapper edge cases, MultiPolygon support ✅
• GitHub Actions CI pipeline — automated test run on every push and on every pull request targeting main. A regression in geospatial data quality cannot reach production undetected ✅
• Branch protection rule — main branch requires audit_and_chaos status check to pass before any merge is permitted ✅
• Repository made private ✅

Why this matters for compliance: The EUDR compliance chain is anchored to the farm polygon. If a bad polygon enters the database — corrupt area calculation, wrong centroid, self-intersecting boundary — every downstream record (deforestation risk status, DDS net weight, compliance certificate) is silently wrong. Automated CI on the validator closes that risk at the infrastructure level.

---

Phase 4.9 — Field Operations + Security Hardening ✅ Complete

Shipped April 2026. Focused on field officer usability, digital audit trail for paper workflows, and eliminating two security findings from a formal posture audit.

• SW Maps CSV farm import — farm importer now accepts SW Maps CSV export (.csv) alongside GeoJSON. WKT geometry column converted transparently. Field teams no longer need to select a different export format ✅
• SW Maps column aliases on farmer import — farmer CSV importer recognises SW Maps header names (First Name, Last Name, Phone Number, Village, LGA, Commodity, NIN) directly. No reformatting required before upload ✅
• Field Verification Form (FVF) digital integration — 7 FVF fields added to Farm model: land acquisition method, tenure type, years farming, untouched forest flag, expansion intent (forward risk flag), and consent record. Appear on Farm edit page. Paper form remains the legal record. ✅
• FVF on farm detail page — dedicated FVF card shows completion status; expansion intent renders as a red risk pill; consent date shown with green badge ✅
• TenantManager — model-layer isolation convention — TenantManager added to all core models (Farmer, Supplier, Farm, Product, Inventory, PurchaseOrder, SalesOrder, Batch, AuditLog). Provides Model.objects.for_company(company) as a named, documented pattern enforcing tenant scope at the queryset level. Additive — existing view-layer filtering unchanged. ✅
• GeoJSON export — farm registry with polygons — Export dropdown on farm list now includes GeoJSON FeatureCollection. All farm polygons exported with full EUDR and FVF properties. Farms without a mapped polygon export with geometry: null. Importable into QGIS, SW Maps, and any GIS tool. ✅
• Security fix — session key whitelist — FarmerImportErrorsView and FarmImportErrorsView no longer accept session_key from GET params. Keys are now hardcoded constants, closing arbitrary session key enumeration via query string. ✅
• Security fix — ops URL constant — /ops-access/9f3k/ path removed from @login_required decorator literals. Both decorators now reference settings.OPS_LOGIN_URL (already defined in base.py). ✅

---

Phase 4.10 — Field GPS Import Hardening ✅ Complete

Shipped April 2026. Driven by real field data from SW Maps revealing that GPS exports are consistently messy — duplicate vertices, 3D coordinates, occasionally unclosed rings.

• normalize_field_gps_geometry() pipeline — pre-processing applied to all polygon imports before validation: strip Z-coordinates (elevation), remove consecutive duplicate GPS vertices (GPS-paused-at-corner produces long identical-point runs), auto-close rings where first ≠ last vertex, simplify via Ramer–Douglas–Peucker if vertex count exceeds 200 after dedup. Tolerance 0.00001° (≈ 1 m) — EUDR-grade precision preserved. Real-world result: 217-vertex SW Maps export reduced to 125 clean vertices. ✅
• ZIP upload support — farm import page now accepts .zip directly. Unzipped in memory (stdlib zipfile, no new dependencies). All GeoJSON files inside the ZIP are found and merged into one import run — handles multi-session exports where field officers record several areas in the same outing. macOS __MACOSX/ metadata folders and non-FeatureCollection JSON (e.g. style.json) skipped silently. Import log records the source filename(s). ✅
• Tool-agnostic pipeline — renamed normalize_sw_maps_geometry → normalize_field_gps_geometry and _sw_maps_csv_to_features → _wkt_csv_to_features. All user-facing error messages updated to “your mapping app”. The import pipeline now explicitly supports SW Maps, Avenza Maps, QGIS, ODK Collect, and any tool that exports GeoJSON or WKT CSV. ✅
• Self-intersection auto-repair — buffer(0) repair moved into normalize_field_gps_geometry() as step 6, before validation. Previously the repair was dead code (the validator raised first). GPS tracks that cross themselves are now resolved automatically; output may be stored as MultiPolygon when the crossing splits the area into two sub-polygons. Confirmed on real field data (Khadija Suleiman Farms). Only geometry that buffer(0) cannot fix triggers a hard rejection. ✅

---

Phase 4.11 — Field Flow Completion ✅ Complete

Shipped April 2026. Closed the last gaps in the end-to-end field officer workflow — from SW Maps export to committed farm records — making the full data collection loop operable from a mobile phone in the field.

• Dry run → one-tap commit — parsed features stashed in session after dry run. A sticky green bar fixed to the bottom of the screen shows “N farms ready to commit” and stays visible at all scroll positions. One tap commits without re-uploading the file. Session cleared on commit ✅
• Multi-file upload — file input accepts multiple. FOs can Ctrl/Cmd + select several GeoJSON, CSV, or ZIP files; the view merges all features before running the pipeline ✅
• Farmer auto-creation on import — GeoJSON import pipeline now creates a Farmer record when first name is present and no matching record exists. Previously only looked up existing farmers, silently leaving farm.farmer null ✅
• Farmer completeness — badge + post-import nudge — Farmer model gains missing_fields and is_complete properties (required: phone, NIN, village). Amber “Incomplete” badge on farmer list. Farmer detail header shows exactly which fields are missing with a direct edit link. After every real import, a second amber section lists all farmers linked to created farms that still need completing ✅
• Warning farm names link to edit page — farms flagged with incomplete data on the import result page show their name as a direct link to the farm edit form with ?next= back to import ✅
• Mobile import result page — error detail and blocked detail tables replaced with stacked cards on small screens ✅
• Case-insensitive GeoJSON property lookup — SW Maps exports lowercase keys with spaces (first name, last name, phone number). Lookup was title-case only — farmer names and phone numbers were silently dropped on every real field export. Fixed by normalising all property keys to lowercase on ingest ✅
• Float coercion hotfix — SW Maps exports phone number as a float (8135099470.0), causing AttributeError: 'float' object has no attribute 'strip' in production. _s() helper coerces all GeoJSON property values to strings; whole-number floats drop the decimal so phone normalisation works correctly ✅
• Phone captured from GeoJSON import — phone number / phone_number / phone now passed to Farmer.objects.create(). Normalised to E.164 by Farmer.save() ✅

Result: Complete data collection loop from a phone in the field. FO maps polygon in SW Maps → exports ZIP → uploads to AgriOps on mobile → dry run → one tap commit → farms and farmer records created with phone normalised → incomplete profiles flagged with direct edit links.

---

Phase 4.12 — Pipeline Transparency Audit ✅ Complete

Shipped April 2026. Driven by a rigorous real-data analysis comparing a raw SW Maps GeoJSON export (James Farm, Ahmad Farm) against AgriOps-processed output. Every gap between “what the device recorded” and “what reached the database” was identified and made auditable.

• Geometry invariant guarantee — every farm polygon now emits a transformation event regardless of whether it was corrected. geometry_normalised if the pipeline made changes; geometry_clean if the polygon passed without modification. No polygon can reach the registry without an explicit audit record ✅
• Geometry detail metrics — each geometry event records exactly what ran: 3D→2D strip, duplicate vertex collapse, topology repair, vertex count before/after, area delta %, centroid shift in metres ✅
• LGA confidence tiering — fuzzy LGA matches below 0.90 confidence correct the value (a wrong LGA is worse than no match) but surface an operator warning for human review. Above 0.90, silent correction is appropriate ✅
• Source area comparison — device-reported AREA property (from SW Maps and similar apps) compared against independently computed polygon area. Unit (m² vs ha) inferred by whichever interpretation produces the smaller delta. Delta and unit inference logged as an auditable transformation event ✅
• EUDR commodity scope check — at import time, any commodity outside EUDR Annex I (Cattle, Cocoa, Coffee, Palm Oil, Soybeans, Wood, Rubber) surfaces a warning: standard EUDR due-diligence rules do not apply. Operator makes a conscious decision at source, not at report generation ✅
• Field officer provenance — mapped_by_name (the field officer string from the GeoJSON file) now parsed from all common property names, stored on the farm record, and surfaced on the farm detail page as “Field Officer”. Satisfies EUDR Section 6 accountability requirement for who mapped the data and when ✅
• Import history UI expanded — amber area field badge; geometry_clean and area_source_comparison reason labels; area delta sub-line with amber highlight at >5% deviation; section header updated from “Normalisations” to “Transformation records” to cover both corrections and validations ✅
• Stale warning erasure bug neutralised — row_warnings = [] was initialised mid-loop, silently wiping LGA confidence and EUDR scope warnings on every import before they reached the operator. Removed ✅

Outcome: The import pipeline is no longer a silent uploader. Every farm in the registry has a reconstructable chain of custody — what geometry arrived, what was corrected, what the device reported vs what was computed, who mapped it and when, and what the system chose not to change. This is the answer to the compliance question: “Can you show me exactly what happened to this polygon between the GPS device and your database?”

---

Phase 5 — Buyer Portal 🔄 Planned

• buyers.agriops.io — separate authenticated surface for EU buyers
• Available inventory catalogue per operator
• Traceability certificate viewer per batch
• Sample requests — triggers operator notification
• Order placement — connects to SalesOrder model
• Buyer registration and authentication

---

Phase 6 — Market Intelligence 🔄 Planned

• Commodity price trends — AFEX API + World Bank
• Harvest forecasting — Open-Meteo weather API + historical yield data
• Warehouse stock analytics — turnover rates, low-stock frequency
• Regional supply heatmaps — Leaflet choropleth by state/region

---

Phase 7 — AI Intelligence 🔄 Planned

• Anthropic API integration
• Customer onboarding assistant — guided setup for new tenants
• Document parsing — extract fields from PDFs, pre-fill forms
• Supplier reliability scoring — anomaly detection from purchase history
• EUDR risk assessment — location-based deforestation risk suggestions
• Compliance report narrative — natural language due diligence statements

---

Tier System — Starter → Growth → Enterprise 🔄 Planned

Seat-based pricing with feature gating. Trigger: first paying tenant.

---

Revenue Model

Stream	Detail	Phase
SaaS subscriptions	Starter / Growth / Enterprise tiers	Phase 4 (Stripe pending)
Transaction fees	1–2% on buyer portal orders	Phase 5
Data intelligence	Supply trend subscriptions	Phase 6

---

EU Buyer Target Markets

France (gum arabic), Germany (organic ingredients), Netherlands (Rotterdam import hub), UK (superfoods). Key targets: Nexira, Alland & Robert, IMCD, Caldic, Kerry Group, Aduna, Tradin Organic. Trade shows: Biofach, SIAL Paris, Fi Europe.

---

Last updated: 18 April 2026