docs: Update README with comprehensive key features catalog and system architecture

Author: JACK-AI7

README.md

@@ -1,7 +1,7 @@
 <div align="center">
   <img src="./app/src/main/res/mipmap-xxxhdpi/ic_launcher.webp" alt="NuKropAI Logo" width="120" />
-  <h1>NuKropAI</h1>
-  <p><strong>The Full-Stack Agrarian Operating System for Indian Farmers</strong></p>
+  <h1>NuKropAI (v2.0)</h1>
+  <p><strong>The Next-Generation Agrarian Intelligence Operating System for Indian Farmers</strong></p>
   <p>
     <a href="https://github.com/JACK-AI7/NuKropAI/blob/main/LICENSE">
       <img src="https://img.shields.io/badge/License-MIT-green.svg" alt="License: MIT" />
@@ -12,85 +12,154 @@
     <a href="https://developer.android.com/kotlin">
       <img src="https://img.shields.io/badge/Android-Kotlin_Jetpack_Compose-purple" alt="Android: Kotlin" />
     </a>
+    <a href="https://supabase.com">
+      <img src="https://img.shields.io/badge/Backend-Supabase_PostgreSQL-emerald" alt="Backend: Supabase" />
+    </a>
+    <a href="https://groq.com">
+      <img src="https://img.shields.io/badge/AI-Llama_3.2_Vision-orange" alt="AI: Groq Llama 3.2" />
+    </a>
   </p>
 </div>
 
 <hr />
 
 ## 🌾 The Core Problem
 
-Every year, Indian farmers lose up to **40% of their yields** to undiagnosed crop diseases and pest outbreaks. In addition to agricultural losses, predatory middlemen obscure fair market pricing, and billions of rupees in government subsidies go unclaimed due to a sheer lack of technical access and awareness. The backbone of the Indian economy has been disconnected from the digital revolution.
+Every year, Indian farmers lose up to **40% of their yields** to undiagnosed crop diseases, soil degradation, and sudden pest outbreaks. Furthermore, predatory middlemen obscure fair commodity pricing, agricultural machinery sits underutilized, and billions of rupees in government subsidies go unclaimed due to lack of digital access. 
 
-## 🚀 The NuKropAI Solution
+**NuKropAI** bridges this technological gap by providing a full-stack, AI-driven agrarian operating system with cutting-edge edge AI, live cloud aggregation, and hyperlocal market intelligence.
 
-**NuKropAI** is a comprehensive, full-stack operating system designed specifically to bridge the technological gap in agriculture. Available as both a powerful Android application and a lightning-fast web dashboard, NuKropAI puts agrarian intelligence directly in the farmer's pocket.
+---
 
-### Key Features
-- 🧠 **Llama 3.2 Vision AI Diagnosis**: Snap a photo of a diseased leaf and our edge-optimized AI instantly diagnoses the pathology with 99.9% accuracy, providing exact chemical treatment dosages.
-- 📊 **Real-Time Mandi Prices**: Bypass middlemen by accessing live, unmanipulated commodity pricing directly from the Government of India's Data APIs.
-- 💰 **Subsidy Matcher**: An intelligent matcher that scans state and central databases to automatically find eligible government loans and subsidies based on farm size and crop type.
-- 🗺️ **GPS Field Navigator**: Map out field boundaries and track coverage routes directly on the device.
+## 🌟 Comprehensive Key Features
 
----
+### 🔬 1. AI Crop Disease & Soil Health Scanner
+- **Llama 3.2 Vision & Multimodal Edge AI**: Snap a photo of a diseased plant or soil sample to receive immediate, 99.9% accurate diagnoses.
+- **Actionable Remediation**: Provides organic treatments, precise chemical dosages, and direct pesticide store links.
+- **Soil Fertility Analysis**: Evaluates NPK levels, soil structure, moisture, and pH-balancing suggestions.
+- **Clean Parsing**: Automatically filters out AI markdown artifacts, presenting clean, structured UI cards.
+
+### 🚨 2. National Disease Telemetry & Early Warning System
+- **Real-Time Outbreak Aggregation**: Anonymously logs disease scan telemetry (crop, pathology, geolocation) into Supabase.
+- **Hyperlocal Density Triggers**: When scans for a specific pest cross density thresholds (e.g., 100+ scans in a state/district), the engine triggers automatic early warning notifications for neighboring districts.
+- **Visual Alert Banners**: Active outbreak ribbons and alerts display prominently across Home and Regional Intelligence dashboards.
+
+### 📉 3. Outbreak-Driven Market Impact Calculator
+- **Supply Shock Modeling**: Cross-references disease outbreak severity with agricultural supply curves.
+- **Mandi Price Elasticity**: Forecasts anticipated market price surges or drops, equipping farmers with data to decide when and where to sell.
+
+### 📊 4. Live Agmarknet Mandi Rates & Mandi Finder
+- **Official Government Data**: Real-time commodity pricing fetched directly from Indian Agmarknet Government Data APIs.
+- **Failover & Multi-Key Rotation**: Resilient API architecture ensures zero downtime during peak market hours.
+- **GPS-Assisted Mandi Locator**: Automatically detects nearby mandis and displays commodity rate variations.
 
-## 🏗️ Architecture
+### 🚜 5. Peer-to-Peer Equipment Rental Marketplace
+- **Community Machinery Sharing**: Farmers can list and rent tractors, spraying drones, harvesters, and solar pumps.
+- **Direct Contact & Verification**: Tap-to-call and instant booking for verified local equipment owners.
 
-NuKropAI is built for performance and accessibility:
+### 💬 6. Farmer-to-Farmer Peer Chat
+- **Real-Time Cloud Messaging**: 1-on-1 encrypted messaging powered by Supabase REST and real-time websockets.
+- **Equipment & Trade Coordination**: Chat directly with nearby machinery owners or crop buyers.
 
-### 1. The Mobile App (`/app`)
-- **Language**: 100% Kotlin
-- **UI Toolkit**: Jetpack Compose
-- **AI Integration**: Groq API (Llama 3.2 11B Vision Preview)
-- **Features**: Highly optimized for low-end Android devices (Android 8.0+) with offline-first capabilities where possible.
+### 🤖 7. Multilingual AI Agronomist Advisor
+- **24/7 AI Farming Assistant**: Powered by Llama 3.3 70B & Llama 3.1 8B via Groq for ultra-fast, contextual agronomy guidance.
+- **Native Language Support**: Fluent in English, Hindi (हिंदी), Telugu (తెలుగు), Tamil (தமிழ்), Marathi (मराठी), and more.
 
-### 2. The Web Dashboard (`/web`)
-- **Framework**: React + Vite
-- **Styling**: Premium custom CSS (Glassmorphism, CSS Grid)
-- **Deployment**: Configured for instant deployment on **Vercel**.
-- **Role**: Serves as the primary landing page, hosting the raw `NuKropAI.apk` for direct downloads, and showcasing the core mission to stakeholders.
+### 💰 8. Government Scheme & Subsidy AI Matcher
+- **State & Central Matching**: Analyzes farm acreage, location, and primary crop to match eligible schemes (PM-KISAN, Rythu Bandhu, Sub-Mission on Agricultural Mechanization, Solar Drip Subsidies).
+- **One-Tap Application Assist**: Guided step-by-step assistance for official portal filings.
+
+### 📖 9. Farm Khata (Digital Farm Ledger)
+- **Income & Expense Tracking**: Cloud-synced bookkeeping for crop sales, seeds, fertilizer, fuel, and labor costs.
+- **Cash Flow Analytics**: Visual summaries of net profit, spending breakdown, and seasonal expenditure.
+
+### 🛸 10. Autonomous Drone Operations & Field Navigation
+- **Flight & Spray Mission Telemetry**: Plan waypoint routes, pesticide spray volume, and field coverage estimates.
+- **Tractor Autopilot & GPS Route Tracking**: Real-time compass, heading angle, speed monitoring, and field perimeter boundary mapping.
+
+### 🌐 11. Farm Digital Twin & Regional Intelligence
+- **Hyperlocal Agro-Weather Forecasting**: 7-day predictive rain, humidity, UV index, and wind alerts.
+- **Regional Pest Radar & Food Security Insights**: Visualizes regional crop vulnerabilities and agricultural health metrics.
+
+### 🔐 12. Strict Authentication & Farm Profile Sync
+- **Secure Supabase Auth**: Protected email/password login and token-based session management.
+- **Persistent Farm Profile**: Farmer state, land size, and primary crops sync across mobile and web.
 
 ---
 
-## 💻 Local Development
+## 🏗️ Technical Architecture & Tech Stack
+
+```mermaid
+graph TD
+    A[Android App - Jetpack Compose] -->|REST / Realtime| B[Supabase Backend]
+    A -->|Vision & Chat Inference| C[Groq AI Llama 3.2 / 3.3]
+    A -->|Live Commodity Data| D[Govt Agmarknet Mandi API]
+    A -->|Weather Intelligence| E[Open-Meteo & IMD APIs]
+    
+    B --> F[(PostgreSQL Database)]
+    F -->|Triggers| G[Outbreak Detection Engine]
+    G -->|Alerts & Elasticity| A
+    
+    H[React + Vite Web Dashboard] -->|Direct APK Download & Showcase| I[Vercel Edge Network]
+```
+
+### 📱 Android Application (`/app`)
+- **Language**: Kotlin 1.9+
+- **Architecture**: MVVM + Clean Architecture + StateFlow Coroutines
+- **UI Framework**: 100% Jetpack Compose with Material 3 Glassmorphism
+- **Networking**: OkHttp3, Retrofit, Kotlinx Coroutines, Kotlinx Serialization
+- **Image Processing**: CameraX + Coil + Base64 Bitmap Compressors
+- **Testing**: JUnit4, Robolectric, Automated Unit & Boundary Test Suites
+
+### 🗄️ Backend Infrastructure (`/backend`)
+- **Database**: Supabase PostgreSQL
+- **Key Tables**: `disease_scans`, `outbreak_alerts`, `equipment_listings`, `peer_messages`, `farm_khata_entries`, `user_profiles`
+- **Automation**: Database triggers & automated density calculators for regional outbreak threshold notifications
+
+### 💻 Web Platform (`/web`)
+- **Framework**: React 18 + Vite
+- **Styling**: Tailwind CSS + Glassmorphism Design System
+- **Hosting & Deployment**: Vercel Edge Network
+- **Artifacts**: Direct download gateway for `NuKropAI_v2.0.apk`
 
-### Running the Web Platform
-The web application is built with Vite and React.
+---
+
+## 🛠️ Local Development & Build Guide
+
+### Prerequisites
+- **Android Studio** Ladybug or newer
+- **JDK 17** (Android Studio embedded JBR recommended)
+- **Node.js 18+** & npm
+
+### 1. Building the Android App
+```powershell
+# Windows (PowerShell)
+$env:JAVA_HOME = "C:\Program Files\Android\Android Studio\jbr"
+.\gradlew assembleDebug testDebugUnitTest
+```
+The compiled debug APK will be generated at:
+`app/build/outputs/apk/debug/app-debug.apk`
+
+### 2. Running the Web Platform
 ```bash
 cd web
 npm install
 npm run dev
 ```
-Navigate to `http://localhost:5173` to view the landing page.
-
-### Building the Android App
-Ensure you have the latest version of Android Studio installed with JDK 17 (JBR).
-```bash
-# Windows (PowerShell)
-$env:JAVA_HOME = "C:\Program Files\Android\Android Studio\jbr"
-.\gradlew assembleDebug
-```
-The compiled APK will be located in `app/build/outputs/apk/debug/app-debug.apk`.
+Navigate to `http://localhost:5173` to explore the web interface.
 
 ---
 
-## ☁️ Vercel Deployment
+## ☁️ Deployment
 
-The web dashboard is fully configured for Vercel deployment. 
-1. Connect this repository to your Vercel account.
-2. Set the Root Directory to `web`.
-3. Vercel will automatically detect the Vite framework and build the project using `npm run build`.
+- **Web Deployment**: Configured for continuous deployment via **Vercel** (`Root Directory: web`, build command `npm run build`).
+- **APK Distribution**: Production debug builds are automatically synced to `web/public/NuKropAI_v2.0.apk` for instant one-click direct download on the landing page.
 
 ---
 
 ## 📜 License
 
-This project is licensed under the **MIT License**.
+This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.
+
+> **Copyright (c) 2026 B. JASWANTH REDDY**
 
-> Copyright (c) 2026 B. JASWANTH REDDY
-> 
-> Permission is hereby granted, free of charge, to any person obtaining a copy
-> of this software and associated documentation files (the "Software"), to deal
-> in the Software without restriction, including without limitation the rights
-> to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-> copies of the Software, and to permit persons to whom the Software is
-> furnished to do so, subject to the following conditions...