🌱 GreenReach Farms - Inventory Management System (IMS)

A Professional Platform for Aeroponic Urban Farm Operations with Rolling Crop Cycles

---

🧩 Executive Summary

GreenReach Farms' Inventory Management System (IMS) is a next-generation, full-stack web application purpose-built to digitize, automate, and optimize aeroponic urban farming. Designed for scalability and real-time operations, IMS empowers farm managers and technicians to monitor crop cycles, manage inventory, and make data-driven decisions with ease.

Built on the Spring Boot + Angular + MongoDB stack, IMS delivers a robust, secure, and responsive experience, supporting real-time monitoring, predictive analytics, and granular role-based access for modern urban agriculture.

---

🚀 Key Features

🌾 Core Farm Management

• Real-Time Inventory Tracking:
  Live updates of nutrients, seeds, and supplies using WebSockets for instant visibility.
• Rolling Crop Cycle Management:
  Track multiple crops across all growth stages, supporting continuous harvests.
• Seed Order Calculator:
  Automatically estimates seed requirements based on yield targets and historical data.
• Yield Estimation Engine:
  Integrates machine learning models to predict yields, optimize planning, and reduce waste.
• Nutrient Monitoring:
  Tracks usage and provides alerts for low inventory of:
  • Solution A & B
  • pH Stabilizers
  • Oxidizers
• Low Inventory & Critical Alerts:
  Customizable notifications via dashboard, email, or SMS when stock drops below thresholds.
• Excel & PDF Report Generation:
  Export detailed reports for inventory, yield, and order history for compliance and analysis.
• Audit Logging:
  Tracks all critical actions for traceability and compliance.

🧑‍🌾 User & Access Management

• Role-Based Access Control (RBAC):
  • Farm Tech: Full permissions (view, edit, manage, export)
  • Farm Hand: Limited permissions (view-only)
  • Admin: System configuration, user management, and audit access
• Two-Factor Authentication (2FA):
  Enhanced security for all users.
• JWT-Based Authentication:
  Secure, stateless session management.

📈 Analytics & Visualization

• Interactive Dashboards:
  Real-time charts and graphs for crop growth, inventory trends, and yield forecasts.
• Customizable Widgets:
  Personalize dashboard views for different roles.

---

🖥️ Technology Stack

Backend

• Spring Boot (Java 17+) — RESTful APIs, business logic, and security
• MongoDB — Flexible NoSQL database for dynamic farm data
• WebSockets — Real-time updates for inventory and alerts
• Thymeleaf — Server-side rendering for admin and reporting views

Frontend

• Angular (Standalone Components) — Modular, maintainable, and responsive UI
• Bootstrap 5 — Modern, mobile-first design
• Chart.js / ngx-charts — Real-time data visualization
• RxJS — Reactive programming for live updates

---

🧱 System Architecture

[ Angular Frontend ] ⇄ [ Spring Boot REST API ] ⇄ [ MongoDB Database ]
           │                        │
           └──── WebSockets ────────┘

---

📊 Dashboard Overview

• Crop Growth Progress: Visualize each crop's stage and expected harvest.
• Yield Estimates: Predict and compare actual vs. expected yields.
• Inventory Overview: Monitor stock levels and usage rates.
• Order & Status Tracking: Track seed and supply orders in real time.
• Alerts & Notifications: Centralized panel for all system alerts.

---

🧮 Database Entities

Employee (User)

• id
• firstName
• lastName
• email
• password (hashed)
• role (Admin, Farm Tech, Farm Hand)
• accessLevel
• permissions
• department
• 2faEnabled
• lastLogin

Inventory

• id
• itemName
• category (Nutrient / Seed / Equipment)
• quantity
• unit
• reorderLevel
• lastUpdated
• supplierDetails
• expiryDate
• batchNumber

Crop

• id
• cropName
• stage (Seedling / Growth / Harvest)
• startDate
• expectedHarvestDate
• yieldEstimate
• actualYield
• nutrientUsage
• notes

AuditLog

• id
• userId
• action
• timestamp
• details

---

🧩 Core Modules

1. Authentication & Authorization
2. Employee Management
3. Inventory Tracking
4. Seed Order Calculator
5. Yield Estimation Engine
6. Alerts & Notifications
7. Reporting & Export (Excel/PDF)
8. Audit Logging

---

📦 Installation & Setup

Prerequisites

• Node.js & npm
• Angular CLI
• Java 17+
• Maven
• MongoDB (local or cloud)

Quick Start

# Backend
cd server
mvn clean install
mvn spring-boot:run

# Frontend
cd client
npm install
npm start

Visit: http://localhost:4200

---

🛡️ Security & Best Practices

• All passwords are hashed and salted.
• JWT and 2FA for secure authentication.
• Role-based access for sensitive operations.
• Audit logs for all critical actions.
• Input validation and sanitization throughout.

---

📚 Future Enhancements

• IoT Sensor Integration: Live crop/environment data from sensors.
• Mobile App: Remote monitoring and management.
• Predictive Analytics: Advanced ML for nutrient and yield optimization.
• Cloud Integration: Seamless connection with cloud-based farm control systems.
• API for Third-Party Integrations: Connect with ERP, logistics, or e-commerce platforms.

---

🤝 Contributors

Project by: GreenReach Farms Research Team
Lead Developer: Swastika
Role: Backend Developer (Spring Boot, MongoDB)
Frontend Lead: [Add Name]
UX/UI Designer: [Add Name]
Team Members: [List your teammates if applicable]

---

📄 License

This project is for research and educational purposes under GreenReach Farms.
Unauthorized distribution or commercial use is prohibited.

---

*Empowering sustainable urban agriculture