Networked Agro Management System (NagroMS)

Build Status Stack Course University

NagroMS is a digital agricultural ecosystem and direct trading marketplace engineered to empower Sri Lankan farmers. By eliminating exploitative middle vendors, connecting farmers with bulk buyers and consumers, and integrating agricultural services, NagroMS fosters transparent pricing, enhanced farmer profits, and nationwide agricultural collaboration.

๐Ÿ‘ฅ Team & Supervisors

๐Ÿ‘จโ€๐Ÿ’ป Project Team

๐Ÿ‘จโ€๐Ÿซ Project Supervisor

๐Ÿ“‘ Table of Contents

  1. Introduction & Problem Statement
  2. Key Objectives
  3. User Roles & Ecosystem
  4. User Interface Showcase
  5. System Architecture
  6. Security & Quality Assurance
  7. Testing Strategy
  8. Conclusion & Future Roadmap
  9. Links & References

๐ŸŒพ Introduction & Problem Statement

In the conventional Sri Lankan agricultural supply chain, farmers encounter severe bottlenecks:

NagroMS solves these systemic challenges by delivering an accessible, multilingual, and integrated digital hub for direct trading, farm logistics, and expert advisory.

+------------------+         +-------------------------------+         +---------------------+
|   Local Farmers  | <-----> |   NagroMS Central Marketplace | <-----> |  Buyers & Retailers |
+------------------+         +-------------------------------+         +---------------------+
                                            |
                             +-------------------------------+
                             |  Experts & Service Providers  |
                             +-------------------------------+

๐ŸŽฏ Key Objectives

๐Ÿ‘ฅ User Roles & Ecosystem

NagroMS supports distinct, persona-driven workflows:

Role Core Capabilities
๐Ÿง‘โ€๐ŸŒพ Farmer List produce with real-time stock levels, manage orders, track farm income/expenses, request equipment, and consult experts.
๐Ÿ›’ Customer & Retailer Browse verified local crops, filter by province/district and category, order fresh produce directly, and request custom produce batches.
๐Ÿ”ง Service Provider List tractors, harvesters, irrigation equipment, and transport services for rent to local farming communities.
๐ŸŽ“ Agricultural Expert Provide advisory services, diagnose crop ailments, respond to inquiries, and share farming best practices.
๐Ÿ›ก๏ธ Administrator Monitor platform security, manage verifications, audit transactions, and resolve disputes.

๐Ÿ“ธ User Interface Showcase

NagroMS features an intuitive, responsive interface optimized for desktop and mobile devices.

1. Multilingual & Multi-Identifier Authentication

Users can effortlessly access their accounts using their preferred language (English, Tamil, or Sinhala) with multiple convenient login methodsโ€”Email, Phone Number, or National Identity Card (NIC) lookup with secure OTP verification.

Multilingual Authentication Figure 1: Multilingual login portal with localized typography and multi-tab credentials.

2. Dynamic Role Onboarding

Upon registration, users can select one or more specific roles tailored to their participation in the agricultural value chain.

Role Selection Figure 2: Seamless step-by-step role selection (Farmer, Customer, Service Provider, Agricultural Expert).

3. Farmer Produce & Inventory Management

Farmers gain an intuitive management dashboard to track product stocks, set per-kilogram pricing, monitor total inventory valuations, and instantly update or remove active market listings.

Farmer Dashboard Figure 3: Farmer overview screen displaying active produce cards, pricing (LKR), and stock indicators.

4. Direct Agricultural Marketplace

Customers and retailers can explore fresh farm harvest directly with category filters (Vegetables, Fruits, Grains) and regional district filters (e.g., Jaffna, Colombo, Hambantota) with instant quality ratings.

Customer Marketplace Figure 4: Direct consumer marketplace with Tamil localization, category tabs, and district filters.

5. Community Network & Expert Hub

NagroMS builds a collaborative farming community across Sri Lanka, enabling farmers to connect with peers, follow updates, and consult certified agricultural specialists.

Community Network Figure 5: Community network directory with district filtering, feeds, and direct connection channels.

๐Ÿ—๏ธ System Architecture

NagroMS utilizes a modern Client-Server Architecture designed for high availability, fast response times, and robust security:

[ Frontend: React 19 + Lucide Icons + Leaflet ]
                       โ”‚
                  RESTful APIs
                       โ”‚
                       โ–ผ
[ Backend: Node.js + Express.js + Rate Limiter + Helmet ]
                       โ”‚
         โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
         โ–ผ                           โ–ผ
[ Firebase Firestore ]      [ Firebase Auth + JWT ]
(Cloud NoSQL DB)            (Authentication & RBAC)

๐Ÿ’ป Technology Stack

๐Ÿ›ก๏ธ Security & Quality Assurance

๐Ÿงช Testing Strategy

The system undergoes rigorous testing across all layers:

๐Ÿš€ Conclusion & Future Roadmap

NagroMS delivers a transformative digital marketplace for Sri Lankan agriculture, establishing direct market connections, empowering farmers with fair returns, and creating an integrated support network.

๐Ÿ”ฎ Future Enhancements

๐Ÿ”— Links & References