AgriOps Documentation

Agricultural Supply Chain Intelligence

AgriOps is a secure, multi-tenant SaaS platform for agricultural SMEs and cooperatives — providing farm-level GPS traceability, supply chain intelligence, and compliance verification across regulatory frameworks including EUDR.

Live platform: app.agriops.io · API: api.agriops.io/api/v1/

---

Start Here

Document	When to read it
How to navigate these docs	First visit — reading orders, document types, contribution rules
Project Roadmap	Phase-by-phase build plan, current and upcoming work

---

User Guide

Document	Description
User Manual	Field officers, coordinators, managers — how to use AgriOps end-to-end

---

System Design

Document	Description
System Overview	Architecture, stack, RBAC matrix, security posture
Data Model	All models, fields, relationships, ERD
API Contract	REST API endpoints, authentication, throttling
EUDR Compliance Module	Farm traceability and EU regulation
RBAC Design	Permission matrix and role hierarchy
Tenant Model	Multi-tenant isolation design

---

Architecture Decision Records

ADR	Decision
ADR 001	Django + PostgreSQL stack selection
ADR 002	Hybrid role architecture — system_role + job_title
ADR 003	Tenant isolation strategy
ADR 004	GeoJSON over PostGIS for farm geolocation
ADR 005	Farm model separation from Supplier
ADR 006	Separate OpsEventLog from tenant AuditLog
ADR 007	TOTP over IP restriction for ops dashboard
ADR 008	Cloudflare Email Routing as interim MX (superseded — Google Workspace live 2026-05-08)
ADR 009	Production hardening — DB indexes, async email, env validation
ADR 010	Billing architecture — dual processor (Paystack/Stripe), isolated app, plan-gated access
ADR 011	PostgreSQL Row-Level Security — deferral criteria and implementation shape
ADR 012	Enterprise tenant API integration — deferral criteria and P0 build sequence
ADR 013	Evidence-gated Compliance Readiness sign-off — engine produces evidence, a manager signs off

---

Runbooks

Runbook	Description
Local Setup	Getting started locally
Deployment	Render deployment, CI/CD, DNS
Seed Data	Loading test data
Incident Response	How to respond to production incidents
Backup and Restore	Database backup and restore procedures
Geometry Drift Detection	Verify GPS polygon hash integrity — inject drift, run check, restore

---

Security

Document	Description
Threat Model	STRIDE threat analysis and mitigations
Security Testing Log	Red team exercises, findings, and resolutions
Production Readiness	Pre-launch hardening checklist — security, data integrity, compliance, UX

---

Legal & Compliance

Document	Description
Data Protection	NDPA 2023 compliance posture — lawful basis, DPIA summary, data subject rights, cross-border transfers

---

Commercial

Document	Description
Subscription Agreement	Standard SaaS contract template — Schedule A covers tier, currency, and limits
Tenant Onboarding Checklist	White-glove onboarding across 3 sessions — done when first compliance PDF is in tenant’s hands

---

Platform URLs

URL	Purpose
app.agriops.io	Main platform
api.agriops.io/api/v1/	REST API root
docs.agriops.io	This documentation

---

Built by Sirleroy · Phase 4 in progress · May 2026