Skip to content

PROJECT_REPORT.md

Latest commit

 

History

History
73 lines (55 loc) · 5.18 KB

PROJECT_REPORT.md

File metadata and controls

73 lines (55 loc) · 5.18 KB
Raw

GreenGuard: A Premium Botanical Identification & Adoption Ecosystem

Comprehensive Project Report Date: June 19, 2026

1. Executive Summary

GreenGuard is a state-of-the-art environmental platform designed to bridge the gap between Non-Governmental Organizations (NGOs) and nature enthusiasts. The platform facilitates the adoption of trees and plants, provides real-time botanical intelligence through a RAG-based AI system, and fosters a community dedicated to reforestation and plant care.

2. Problem Statement

Despite the global push for reforestation, urban populations often find it difficult to contribute meaningfully or track the progress of planted saplings. Conversely, NGOs struggle with post-plantation care and consistent funding/adoption for their projects. There is a lack of high-fidelity, data-driven botanical advice available to the general public to ensure the survival of adopted plants.

3. The GreenGuard Solution

GreenGuard provides a triple-layered solution:

  1. Direct Adoption Pipeline: A seamless workflow for adopters to select, apply for, and manage plant adoptions from verified NGOs.
  2. Botanical Intelligence (Flora Genius): A specialized AI microservice that uses Retrieval-Augmented Generation (RAG) to provide expert, grounded advice on 130+ Indian medicinal plants.
  3. Community & Accountability: An Instagram-style social feed combined with a growth reporting system ensures transparency and long-term care for every adopted plant.

4. Key Functionality

4.1. User Ecosystem

  • Adopters: Can discover plants via geospatial maps, apply for adoption through a vetting questionnaire, and submit periodic health reports for their plants.
  • NGOs: Manage their plantation registry, review adoption applications, and post community updates.
  • Administrators: Oversee platform safety, verify NGO credentials, and manage global statistics.

4.2. Flora Genius Consultant (RAG AI)

The "Botanical Brain" of the project provides:

  • Species Identification: Instant recognition of plants via image analysis.
  • Expert Consultation: A chat interface that answers queries about medicinal uses, soil requirements, and specific care instructions by retrieving data from a curated botanical registry.
  • Grounded Responses: Unlike standard AI, the RAG system ensures every answer is backed by verified data points stored in a vector database.

4.3. Geospatial Discovery

  • Live Plant Map: Interactive visualization of plantations across the region with status-coded markers (Available, Pending, Adopted).
  • Nearby Search: Radius-based search functionality allowing users to find adoption opportunities within their immediate vicinity.

4.4. Community & Social Engine

  • Immersive Feed: High-performance social wall for sharing plantation updates, care tips, and success stories.
  • Social Engagement: Like, bookmark, and follow systems to build a network of environmental advocates.

5. Technical Architecture

5.1. Frontend Engine

  • Premium Design System: Implemented with Next.js and Tailwind CSS 4, featuring glassmorphism 2.0 and immersive atmospheric backgrounds.
  • Dynamic Rendering: Utilizes both Static and Dynamic server components for optimal performance and SEO.
  • Motion Orchestration: Sophisticated scroll-triggered animations and transitions powered by Framer Motion.

5.2. Core Backend

  • Microservices-ready API: A robust Node.js/Express server handling authentication, geospatial queries, and social logic.
  • Secure Authentication: Integrated with Supabase Auth for JWT-based session management and secure NGO verification.

5.3. Intelligence Microservice

  • RAG Implementation: A standalone service utilizing Google Gemini for reasoning and embeddings.
  • Vector Search Engine: High-speed semantic retrieval using Supabase pgvector to inject relevant botanical context into AI prompts.

5.4. Database & Storage

  • Relational Integrity: PostgreSQL-based schema with complex relations between Users, NGOs, Plants, and Adoptions.
  • Cloud Storage: Secure bucket storage for high-resolution plant imagery and user profiles.

6. Technical Challenges & Resolutions

  • API Reliability: Resolved critical key format and character encoding issues for AI service communication.
  • Schema Optimization: Refactored database functions to handle UUID-to-BigInt mismatches and ensured type-agnostic data retrieval for the AI engine.
  • Monorepo Orchestration: Successfully configured complex deployment pipelines for multiple microservices within a single repository structure.

7. Future Scope

  • Push Notification System: Real-time alerts for adoption approvals and plant care reminders.
  • Progressive Web App (PWA): Enhanced mobile experience for field use by NGO volunteers.
  • Expanded Botanical Registry: Scaling the RAG database to include thousands of global plant species.

8. Conclusion

GreenGuard v2.2 represents a significant leap in environmental technology. By combining premium UI/UX design with advanced RAG-based intelligence and a robust social workflow, it creates a scalable and transparent platform for global reforestation efforts.

Report generated by GreenGuard Documentation Engine