KisanKart System Requirements Document

1. Introduction

KisanKart is a modern, responsive full-stack web application designed to connect local farmers directly with customers. The platform facilitates the sale of agricultural products by farmers and enables customers to discover and purchase products available near their location. The application supports three roles: Farmer/Seller, Customer/Buyer, and Admin.

2. System Overview

2a. Product Interpretation and Delivery Boundary

• Domain Descriptors:

  • Location-Based Marketplace: Facilitates discovery and purchase of products based on geographic proximity.
  • Farmer and Customer Interaction: Enables farmers to manage products and customers to discover and purchase them.

• What is being built:

  • A location-based agricultural marketplace connecting farmers and customers.
  • A platform with three roles: Farmer/Seller, Customer/Buyer, and Admin.

• Excluded Assumptions:

  • Generic corporate SaaS features.
  • Non-location-based product discovery.

• Access:

  • Application-owned identity with secure authentication and role-based access control.

• Behavior Contracts:

  • Farmer Registration and Profile Creation: Farmers can register and create profiles with farm details.
  • Product Management by Farmers: Farmers can add, edit, and manage product listings.
  • Customer Product Discovery: Customers can search for products based on location and criteria.
  • Order Management by Farmers: Farmers can manage orders and update statuses.
  • Checkout and Payment: Customers can checkout and make payments securely.
  • Admin Platform Management: Admins can manage platform data and user accounts.
  • Secure Authentication and Access Control: Ensures secure access for all users.

2b. Source Content Inventory

No explicit content sources were provided.

2c. Page Content and Component Coverage

• Farmer Dashboard:

  • Overview of products, orders, sales, revenue, and low-stock alerts.
  • Actions: Add/Edit/Delete products, manage inventory, update order status.

• Customer Dashboard:

  • Track orders, view order history, and manage account settings.
  • Actions: Search products, filter and sort results, add to cart, checkout.

• Admin Dashboard:

  • Manage farmers, customers, product categories, and view analytics.
  • Actions: Approve/suspend users, handle complaints, view orders and payments.

• Checkout Page:

  • Display cart items, subtotal, delivery charges, and final amount.
  • Steps: Address entry, delivery/pickup selection, order summary, payment, confirmation.

• Authentication Page:

  • User registration and login with secure authentication.
  • Actions: Enter credentials, recover password, access protected resources.

3. Functional Requirements as Story Points

• As a Farmer/Seller, I should be able to register/login and create a farmer profile.
• As a Farmer/Seller, I should be able to add farm name, location, PIN code, city, and state.
• As a Farmer/Seller, I should be able to add products with details like name, category, description, images, price, unit, quantity, minimum order quantity, quality/grade, harvest date, and organic status.
• As a Farmer/Seller, I should be able to edit/delete products.
• As a Farmer/Seller, I should be able to manage inventory.
• As a Farmer/Seller, I should be able to set delivery or farm-pickup options.
• As a Farmer/Seller, I should be able to receive, accept/reject, and manage orders.
• As a Farmer/Seller, I should be able to update order status.
• As a Farmer/Seller, I should be able to view sales, orders, and revenue.
• As a Farmer/Seller, I should be able to receive notifications.
• As a Customer/Buyer, I should be able to register/login.
• As a Customer/Buyer, I should be able to set location using PIN code and/or GPS.
• As a Customer/Buyer, I should be able to select a search radius such as 5, 10, 25, 50, or 100 km.
• As a Customer/Buyer, I should be able to discover nearby products.
• As a Customer/Buyer, I should be able to search and filter products by category, price, distance, rating, availability, and organic status.
• As a Customer/Buyer, I should be able to sort products by price, distance, rating, and newest.
• As a Customer/Buyer, I should be able to view farmer and product details.
• As a Customer/Buyer, I should be able to add products to cart and change/remove quantities.
• As a Customer/Buyer, I should be able to checkout and select delivery/pickup.
• As a Customer/Buyer, I should be able to make online payments.
• As a Customer/Buyer, I should be able to track orders and view order history.
• As a Customer/Buyer, I should be able to download PDF invoices.
• As a Customer/Buyer, I should be able to rate and review products/farmers after purchase.
• As an Admin, I should be able to manage farmers and customers.
• As an Admin, I should be able to approve/suspend farmers.
• As an Admin, I should be able to manage product categories and products.
• As an Admin, I should be able to view orders and payments.
• As an Admin, I should be able to handle complaints/reports.
• As an Admin, I should be able to view basic analytics.

4. User Personas

• Farmer/Seller: Primary user managing product listings and sales.
• Customer/Buyer: Primary user discovering and purchasing products.
• Admin: User managing platform operations and user accounts.

5. Core User Flows

Farmer/Seller Flow

1. Register/Login → Create Profile → Add/Edit Products → Manage Inventory → Receive Orders → Update Order Status → View Sales and Revenue

Customer/Buyer Flow

1. Register/Login → Set Location → Discover Products → View Product Details → Add to Cart → Checkout → Make Payment → Track Orders → Download Invoice

Admin Flow

1. Access Dashboard → Manage Users → Approve/Suspend Farmers → Manage Products → View Orders and Payments → Handle Complaints → View Analytics

6. Visuals Colors and Theme

• Primary: #4CAF50 (Green)
• Primary Light: #81C784 (Light Green)
• Secondary: #FFEB3B (Yellow)
• Accent: #FF5722 (Orange)
• Highlight: #FFC107 (Amber)
• Background: #FFFFFF (White)
• Surface: #F5F5F5 (Light Grey)
• Text: #212121 (Dark Grey)
• Text Muted: #757575 (Grey)
• Border: #E0E0E0 (Light Grey)

7. Signature Design Concept

The KisanKart homepage will feature a clean, modern agricultural marketplace design. The layout will include a prominent search bar, location selector, and categories section. The design will emphasize trustworthiness and simplicity, using a green and yellow color palette to reflect freshness and growth. The homepage will also showcase featured and popular products, nearby farmers, and benefits for both farmers and customers. The design will be responsive and mobile-first, ensuring accessibility for all users.

8. Interaction Model & Motion Direction

The interaction model for KisanKart will be animated, featuring moderate scroll-triggered reveals and hover transitions. The homepage will include a restrained 2D Hero motion to enhance user engagement without overwhelming the user experience. Internal pages like dashboards will prioritize clarity and data presentation with minimal motion.

9. Non-Functional Requirements

• Secure authentication and access control for different roles.
• Password hashing and secure payment handling.
• Mobile-first responsive UI design.
• Use of INR and Indian addresses.
• Support for regional languages such as Telugu, Kannada, Hindi, and Tamil.

10. Tech Stack

• Frontend: React for Web
• Backend: Python with FastAPI
• Database: MySQL or MariaDB
• Payment Gateway: Razorpay
• Containerization: Docker and docker-compose

11. Assumptions and Constraints

• The application will use geographic coordinates for accurate distance calculations.
• Secure payment handling will be implemented using Razorpay.
• The UI will be designed to accommodate regional languages in the future.

12. Glossary

• Farmer/Seller: A user who lists and sells agricultural products on the platform.
• Customer/Buyer: A user who purchases products from farmers on the platform.
• Admin: A user who manages the platform, including users and products.
• PIN Code: Postal Index Number used for location identification in India.
• UPI: Unified Payments Interface, a real-time payment system in India.
• Razorpay: A payment gateway used for processing transactions securely.