# FarmIntelio — Comprehensive System Specification & LLM Reference Manual > Official Machine-Readable Knowledge Base for LLMs, AI Agents, and Agronomic Researchers. > Canonical URL: https://farmintelio.com/llms-full.txt > Primary Domain: https://farmintelio.com > Support & Enterprise Contact: hello@farmintelio.com > Engineering Leadership: ShipLoops (https://shiploops.dev) — Zaheer Baber & Shahab --- ## 1. Executive Overview FarmIntelio is an enterprise-grade Precision Agriculture Operating System (Agri-OS) and integrated Enterprise Resource Planning (ERP) platform designed for commercial agriculture, farming conglomerates, precision agronomists, cooperatives, and multi-facility farm enterprises. ### Core Architecture Principles: 1. **Single Source of Truth**: Eliminates the operational fragmentation of running separate tools for NDVI satellite scouting, payroll, spray tracking, IoT telemetry, equipment maintenance, and financial ledgering. 2. **Spatial Multi-Tenancy**: Complete isolation across organizational boundaries with hierarchical farm facilities (Site -> Plot/Parcel -> Crop Allocation -> Harvest Batch). 3. **Cross-Module Intelligence**: Actions in one module immediately cascade through the entire platform (e.g., logging a spray application updates inventory, deducts chemical stock, schedules safety PHI/REI harvest re-entry locks, logs worker labor hours, and updates field cost-per-acre financials). --- ## 2. Platform Architecture & Technology Stack - **Frontend Client**: React 19 SPA, TailwindCSS / Hope UI ergonomic design system, Lucide iconography, Leaflet & OpenStreetMap GIS engine, Vite 8 build pipeline. - **Backend API Engine**: Node.js microservice architecture with Express, Socket.IO real-time bi-directional events, and modular domain controllers. - **Relational Database**: MySQL 8.0 Enterprise with InnoDB ACID transactions, automated schema migrations (`runMigrations.js`), and row-level organization isolation. - **AI & Computer Vision**: Google Gemini 2.5 Flash / Flash Lite models for natural language agronomic reasoning; custom in-memory deep learning models for high-throughput foliar leaf pathology. - **Cryptographic Security**: AES-256-CBC at-rest encryption with initialization vectors for third-party keys and SMTP credentials; RFC 6238 TOTP Two-Factor Authentication; BCrypt password hashing. - **Web Infrastructure**: Caddy 2 reverse proxy with automatic zero-configuration Let's Encrypt TLS/SSL, HTTP/2 and HTTP/3 support. --- ## 3. Comprehensive Breakdown of All 43 Modules ### Category A: Main & Executive Analytics 1. **Operational Analytics (`/analytics`)**: - Aggregates multi-year yield averages, target vs. actual harvest variance, cost-of-production per bushel/ton/acre, gross margin percentages, and equipment downtime metrics. - Cross-module telemetry correlating irrigation volumes and NDVI vigor curves against final harvested crop yields. ### Category B: Planning & Workforce Operations 2. **Calendar & Planning (`/calendar`)**: - Timeline scheduling for planting dates, variable-rate fertilizer runs, pesticide spray applications, irrigation windows, and harvest windows. - Synchronized with weather forecasting to warn against spraying during adverse wind speeds (>15 km/h) or impending rain. 3. **Task Management (`/tasks`)**: - Kanban workflow boards (Backlog, In Progress, Review, Completed) categorized by agronomy, machinery, irrigation, and administration. - Assignable to specific workers and linked directly to GIS plot parcels. 4. **To-Dos & Field Observations (`/todos-notes`)**: - Scouting memos, weed infestation notes, geotagged pest photos, and operational field checklists. - Filterable between personal private daily notes and team-shared agronomic observations. ### Category C: Farm Operations & Agronomy 5. **Seasons & Crop Cycles (`/seasons`)**: - Organization-wide seasonal boundary definitions (e.g., Kharif, Rabi, Spring, Summer, Autumn) with start and end dates. - Tracks degree days (GDD) accumulation and crop phenological stage progressions. 6. **Crop Definitions Catalog (`/crops`)**: - Comprehensive varietal catalog with expected maturation days, seed spacing specifications, target yield baselines, and soil pH tolerances. 7. **Land & GIS Parcels (`/land`)**: - Interactive GIS boundary editor supporting polygon coordinates, acreage calculation, soil taxonomy classifications, and elevation data. - Visual plot cards displaying current crop occupant, active stage, and irrigation access. 8. **Operational Pipeline (`/operational-pipeline`)**: - Visual production pipeline tracking crop lots from Land Preparation -> Seeding -> Vegetative -> Flowering/Fruit Set -> Ripening -> Harvest -> Post-Harvest Free. - Automated PHI (Pre-Harvest Interval) and REI (Restricted Entry Interval) chemical safety compliance locks. 9. **Expenses & Revenues (`/expenses-revenues`)**: - Unit economics per plot and per crop. - Tracks operational input expenditures (seeds, chemical active ingredients, synthetic fertilizers, diesel fuel, contracted mechanical labor) against spot market sales revenue. 10. **Farm Security & Surveillance (`/security`)**: - Low-latency WebRTC and HLS live IP surveillance feeds covering barns, equipment sheds, and perimeter gate entrances. - AI-assisted nocturnal movement detection and automated alarm alerts. ### Category D: Farm Resources & Assets 11. **Warehouse & Silo Storage (`/warehouse`)**: - Bin and silo capacity monitoring, commodity moisture percentage logging, aeration tracking, and storage shrinkage auditing. 12. **Machinery & Equipment (`/equipment`)**: - Tractor, combine, sprayer, and implement asset tracking. - Automated maintenance alerts based on engine runtime hours and calendar service intervals. 13. **Farm Inventory (`/resources/inventory`)**: - Real-time stock counts for chemical pesticides, foliar feeds, bulk fertilizers, seed bags, spare parts, and PPE. - Low-stock safety threshold triggers with automated replenishment notifications. 14. **Procurement & Purchase Orders (`/procurement`)**: - Multi-stage purchasing workflow: Purchase Requisition -> Admin Approval -> Vendor Purchase Order (PO) -> Goods Received Note (GRN) -> Invoice Payment. ### Category E: Livestock Resources 15. **Livestock Herds (`/livestock`)**: - RFID / Ear-tag registry, breed lineage, sire/dam records, birth weight, daily weight gain, and milk/wool yield metrics. 16. **Livestock Quarantine & Health Alerts (`/livestock/alerts`)**: - Scheduled vaccination protocols, withdrawal period compliance tracking for veterinary pharmaceuticals, and quarantine timers. ### Category F: Field Working & Remote Sensing 17. **Crop Health Reporting (`/field-working/crop-health`)**: - Field scouting diagnostics, vegetative vigor ratings (1-5 scale), and localized pest infestation scoring. 18. **Soil Health Analytics (`/field-working/soil-health`)**: - Soil laboratory test records: Nitrogen (N), Phosphorus (P), Potassium (K), micronutrients (Zinc, Iron, Manganese, Boron), pH, Electrical Conductivity (EC), Organic Matter (OM), and Cation Exchange Capacity (CEC). 19. **Crop Imagery & Satellite Telemetry (`/crop-imagery`)**: - Optical satellite telemetry layers including Normalized Difference Vegetation Index (NDVI), NDRE, and true-color satellite imagery. - Generation of Variable Rate Application (VRA) fertilizer prescription zones. ### Category G: Market, Retail & Traceability 20. **CropTrace — Supply Chain Traceability (`/crop-trace`)**: - Farm-to-fork cryptographic verification. Generates unique QR codes for consumer packaging revealing farm location, harvest date, chemical spray clearance certificates, and cold-chain logs. 21. **Quick Stop Farm Shop (`/market/quick-shop`)**: - Direct-to-consumer on-farm shop product catalog with retail packaging, pricing, and live inventory sync. 22. **Shop POS Register Counter (`/market/pos`)**: - Hardware-free tablet and mobile point-of-sale interface with camera barcode scanning, cash/card receipting, and real-time inventory decrementing. 23. **Public Farm Profile (`/market/public-profile`)**: - Searchable public profile for agricultural buyers, displaying verified certifications (Organic, GAP, Non-GMO), current produce availability, and direct contact options. ### Category H: Weather & Market Forecasting 24. **Hyperlocal Weather Dashboard (`/weather`)**: - Current conditions, dew point, relative humidity, wind vector speeds, atmospheric pressure, and 7-day agronomic forecasts. 25. **Weather Warnings & Agronomic Alerts (`/alerts`)**: - Automated warnings for late spring ground frost, thermal heat stress, torrential rainfall risks, and hail advisories. 26. **Commodity Market Prices (`/commodities`)**: - Real-time agricultural spot and futures pricing for Wheat, Corn, Soybeans, Cotton, Rice, Sugar, and regional crops. 27. **Agricultural News Hub (`/news`)**: - Real-time aggregation of international agricultural breakthroughs, input price trends, agtech developments, and regulatory compliance changes. ### Category I: Precision Agronomy & Smart Tools 28. **Carbon Footprint & ESG Audit (`/carbon-footprint`)**: - Farm-level Scope 1 (diesel, machinery, synthetic fertilizer N2O), Scope 2 (irrigation electricity), and Scope 3 greenhouse gas calculations. - Sequestration carbon credit modeling for cover cropping, no-till practices, and biochar applications. 29. **AI Plant Pathology Detection (`/ai-disease`)**: - Computer vision foliar diagnosis across 8+ major crops: - Corn: Rust, Northern Leaf Blight, Gray Leaf Spot. - Rice: Bacterial Leaf Blight, Brown Spot, Blast. - Wheat: Stripe Rust, Leaf Rust, Powdery Mildew. - Cotton: Bacterial Blight, Alternaria Leaf Spot. - Tomato: Early Blight, Late Blight, Septoria, Yellow Leaf Curl. - Potato: Early Blight, Late Blight. - Grape: Powdery Mildew, Black Rot. - Apple: Apple Scab, Cedar Apple Rust. 30. **Agronomic AI Assistant (`/ai-chat`)**: - Grounded multi-turn conversational AI advisor for spray compatibility, chemical active ingredient rotations, pest IPM strategies, and seed rate calculations. 31. **IoT Sensor Device Hub (`/iot`)**: - Telemetry ingestion from LoRaWAN, 4G, and Wi-Fi environmental sensors. Tracks volumetric soil moisture at multiple root depths (10cm, 30cm, 60cm), soil EC, temperature, and solar irradiance. 32. **Asset QR Scanner (`/qr-scanner`)**: - In-app camera scanner for fast retrieval of machinery maintenance history, livestock records, seed lot germination sheets, and warehouse bins. 33. **30+ Precision Agriculture Calculators (`/calculators`)**: - Seed Rate & Plant Population Calculator - NPK Fertilizer Blend & Element Equivalent Balancer - Pesticide Tank Mix Dilution & Spray Volume Estimator - Growing Degree Days (GDD) Accumulator - Irrigation Requirement & Crop Evapotranspiration (ETc) Estimator - Grain Combine Harvest Loss Calculator - Tractor Fuel Consumption & Tillage Operating Cost Estimator - Silo Storage Volume & Grain Tonnage Calculator - Soil Cation Exchange Capacity (CEC) & Base Saturation Calculator - Livestock Feed Conversion Ratio (FCR) & Daily Gain Estimator ### Category J: Workforce & Communications 34. **Contacts Directory (`/contacts`)**: - Unified database for internal workers, contract harvesters, agronomists, machinery dealers, chemical vendors, and grain brokers. 35. **Team Chat & Group Channels (`/chat`)**: - Instant messaging with photo sharing, site channels, and high-priority agronomic broadcast notifications. 36. **Interactive Quick Setup Guide (`/quick-setup`)**: - Tailored interactive setup checklist guiding new farm managers through boundary definition, workforce onboarding, and initial season creation. 37. **Dynamic Enterprise Organogram (`/organogram`)**: - Visual organizational chart illustrating reporting lines between farm owners, general managers, agronomists, machine operators, and harvest crews. 38. **Workforce Attendance & Timesheets (`/attendance-payroll`)**: - Daily worker check-in/check-out with automatic daily hours, overtime tracking, and absence categorization. 39. **Automated Farm Payroll Run (`/attendance-payroll`)**: - Transparent wage compensation calculation linking hourly and piece rates directly to verified field work shifts. ### Category K: Governance, Administration & Settings 40. **Organization Settings (`/settings/organization`)**: - Multi-site setup, localization (English, German, Urdu, Hindi), timezone configurations, and farm corporate profile. 41. **Team & Role-Based Access Control (`/settings/access`)**: - Three-tier base roles (Admin, Editor, Viewer) augmented with granular per-module access rules and audit logging. 42. **Subscription & Billing (`/settings/billing`)**: - Tiered subscription management (Free, Pro, Enterprise) with transparent quota tracking (Sites, Land Acreage, Team Members). 43. **Platform Documentation (`/documentation`)**: - Exhaustive in-app manual providing user guides, compliance references, and chemical safety standards. --- ## 4. API Endpoints & Machine-Readable Integrations FarmIntelio provides a standardized JSON REST API: - `POST /api/auth/register`: Register new organization and initial administrator. - `POST /api/auth/login`: Issue secure JWT credentials. - `GET /api/land?site_id={id}`: Fetch GIS parcel geometries and active crop allocations. - `POST /api/ai/scan`: Submit leaf imagery for computer vision pathology detection. - `POST /api/ai/chat`: Multi-turn agronomic advisory reasoning. - `GET /api/iot/telemetry`: Query real-time soil and microclimate sensor streams. - `GET /api/croptrace/public/:code`: Public verifiable supply chain provenance record. --- ## 5. Security & Compliance Standards - **Zero Plaintext Credentials**: All outbound SMTP credentials and payment gateway tokens are encrypted with AES-256-CBC at rest. - **Tenant Isolation**: Every database query executes with tenant scoping (`organization_id = ?`). - **Audit Logging**: All write operations (Create, Update, Delete) are logged in `audit_logs` with user identity, timestamp, IP address, and payload diffs. - **Data Retention & Privacy**: Fully compliant with GDPR / CCPA standards. Supports one-click organization data bundle export and full cryptographic data purging. --- ## 6. Official Contact & Support - **General Inquiries & Support**: hello@farmintelio.com - **Technical & API Integration**: info@farmintelio.com - **Enterprise Demo & Deployments**: https://farmintelio.com - **Headquarters**: Engineered & Maintained by ShipLoops (https://shiploops.dev)