AGRI Guard System Requirements Document

1. Introduction

AGRI Guard is a comprehensive application designed to support farmers by integrating modern agricultural technology and AI capabilities. The application aims to provide a seamless experience for farmers in India, offering tools and features that enhance productivity and ensure compliance with agricultural standards.

2. System Overview

AGRI Guard is designed to offer a range of features that cater to the diverse needs of farmers. The application includes authentication mechanisms, real-time agricultural tools, compliance tracking, and more, all aimed at improving the efficiency and effectiveness of farming practices.

3. Functional Requirements as Story Points

• As a User, I should be able to authenticate using Google one-tap, Phone OTP, or Email + password with a VAA seal verification animation.
• As a User, I should see a Mandate ID card (AP-AGRI-MP-2026-V3) on the Home page.
• As a User, I should be able to view 4 live stats and scrollable problem cards on the Home page.
• As a User, I should see a Statutory Rule 10-A clause box with a lined paper texture on the Home page.
• As a User, I should have access to a Field News ticker displaying policy, cyclone, and pest advisories.
• As a User, I should be able to expand all 4 pillars (Soil & Organic, Organic Protections, Supply Chain Safeguards, Tenant Protections) with full content.
• As a User, I should see a live sensor node that ticks every 4 seconds with a green pulse dot in the Soil & Organic pillar.
• As a User, I should be able to perform a Disconnect/Reconnect demo in the Soil & Organic pillar.
• As a User, I should be able to use the MOD Verify Simulator with a 3-step walkthrough.
• As a User, I should be able to reset and run the MOD Verify Simulator again.
• As a User, I should be able to view 4 compliance cards with full operational standards and penalties in the Compliance Register.
• As a User, I should be able to access a full mandate metadata card in the Compliance Register.
• As a User, I should be able to use the Crop Calendar to view detailed care tips and upcoming tasks for Rice, Cotton, Groundnut, and Turmeric.
• As a User, I should be able to upload real photos for Pest Detection and receive simulated AI analysis results.
• As a User, I should be able to view a Soil Health Card with pH, EC, N/P/K/Organic C bars, and micronutrient status.
• As a User, I should receive VAA dosing recommendations based on the Soil Health Card.
• As a User, I should be able to view a Yield Prediction with a 4.2 t/acre forecast and contributing factors.
• As a User, I should be able to view a 5-year bar chart trend for Yield Prediction.
• As a User, I should be able to view current weather conditions, a 5-day forecast, and field advisories.
• As a User, I should be able to view Mandi Prices with live-style up/down indicators and nearby mandi distances.

4. User Personas

• Farmer: Primary user who utilizes the application for agricultural insights and tools.
• Agricultural Officer: Monitors compliance and provides advisories.
• Supply Chain Manager: Manages logistics and supply chain safeguards.
• Tenant Farmer: Focuses on tenant protections and related advisories.

5. Core User Flows

• User logs in using Google one-tap/Phone OTP/Email + password → VAA seal animation confirms login → User accesses Home page with live stats and news ticker.
• User navigates to Pillars section → Expands Soil & Organic pillar → Observes live sensor node → Performs Disconnect/Reconnect demo.
• User accesses MOD Verify Simulator → Completes 3-step walkthrough → Resets and runs the simulator again.
• User checks Compliance Register → Reviews compliance cards and mandate metadata.
• User navigates to Agriculture Tools → Uses Crop Calendar for care tips → Uploads photo for Pest Detection → Views Soil Health Card and Yield Prediction → Checks Weather and Mandi Prices.

6. Visuals Colors and Theme

• primary: #4CAF50 (Green)
• primary_light: #81C784 (Light Green)
• secondary: #FFEB3B (Yellow)
• accent: #FF5722 (Deep Orange)
• highlight: #FFC107 (Amber)
• bg: #F5F5F5 (Light Gray)
• surface: #FFFFFF (White)
• text: #212121 (Dark Gray)
• text_muted: #757575 (Gray)
• border: #E0E0E0 (Light Gray)

7. Signature Design Concept

The AGRI Guard homepage will feature an interactive "Living Farm" concept. As users scroll, they will see a dynamic illustration of a farm landscape that evolves with the seasons. The landscape will include animated elements such as growing crops, changing weather patterns, and active farm machinery. Users can click on different parts of the landscape to access detailed information about each feature, such as crop health or weather forecasts. This concept will be built using motion/react for smooth animations and interactions.

LANDING HERO MOTION BRIEF

The landing hero will depict a transformation from seed to harvest. As users scroll, they will see seeds being planted, growing into crops, and finally being harvested. The animation will loop every 10 seconds, showing the cycle of growth and harvest. The scene will include layers such as soil, crops, and sky, with interactive elements like clickable crops that reveal growth data. The animation will be responsive, adjusting to different screen sizes while maintaining clarity and engagement.

8. Interaction Model & Motion Direction

• Intended Interaction Model: Parallax
• Description: The homepage will use a parallax effect to create depth, with layers of the farm landscape moving at different speeds as users scroll. This will enhance the storytelling aspect of the "Living Farm" concept, providing an immersive experience.

9. Non-Functional Requirements

• The application must support multiple languages, including English and Hindi.
• The application should be optimized for both web and mobile platforms.
• The system must ensure data security and privacy compliance with local regulations.

10. Tech Stack

• Frontend: React for Web
• Backend: Python, FastAPI
• Database: MySQL or MariaDB
• AI Models: GPT 5.4 for user-friendly responses, Google Nano banana for image generation
• AI Tools: Litellm for LLM Routing, Langchain
• Local Orchestration: Docker, docker-compose
• Server-side Orchestration: Kubernetes

11. Assumptions and Constraints

• The application assumes users have basic digital literacy.
• Internet connectivity is required for real-time data updates.
• The system must handle high traffic during peak agricultural seasons.

12. Glossary

• VAA: Verified Agricultural Authority
• OTP: One-Time Password
• MSP: Minimum Support Price
• MOD: Ministry of Defense (contextual to the simulator feature)
• Pillars: Key focus areas within the application (Soil & Organic, Organic Protections, etc.)