FarmSetu Installation Guide

Prerequisites

• Java 17 or later
• Maven 3.8+
• Node.js 18+ and npm
• Angular CLI
• MySQL 8.0+
• Git
• IDE (IntelliJ IDEA or VS Code)

1. Clone the Repository

git clone https://github.com/your-username/FarmSetu.git
cd FarmSetu

2. Configure MySQL

• Create a MySQL database.
• Update the database URL, username, and password in each microservice's application.properties file.

Example:

spring.datasource.url=jdbc:mysql://localhost:3306/farmsetu
spring.datasource.username=root
spring.datasource.password=your_password

3. Build Backend Services

From each microservice directory:

mvn clean install

4. Start Backend Services

Start the services in the following order:

1. Eureka Service Registry
2. API Gateway
3. Authentication Service
4. Marketplace Service
5. Bidding Service
6. Insurance Service

5. Install Frontend Dependencies

cd frontend
npm install

6. Run Angular Frontend

ng serve

or

npm start

The application will be available at:

http://localhost:4200

7. Login

Use the appropriate credentials to access the platform as:

• Farmer
• Bidder
• Administrator

Features

• Secure JWT Authentication
• Role-Based Access Control
• Real-Time Crop Auctions
• Crop Insurance Management
• Live Bid Tracking
• Admin Dashboard
• API Gateway
• Eureka Service Discovery
• REST API Communication
• MySQL Database Integration

Technology Stack

• Angular
• Spring Boot
• Spring Cloud Gateway
• Eureka Server
• Java
• REST APIs
• MySQL
• Maven
• JWT Authentication
• Microservices Architecture

1. Launch the Angular frontend and ensure all Spring Boot microservices are running.
2. Open the application in your browser (http://localhost:4200).
3. Register as a Farmer, Bidder, or Administrator.
4. Log in using your credentials.
5. Farmers can create crop listings by entering crop details and submitting them for approval.
6. Administrators verify users and approve crop listings before they appear in the marketplace.
7. Bidders browse available crops, participate in live auctions, and place bids in real time.
8. After the auction ends, the system automatically declares the highest bidder as the winner.
9. Farmers can apply for crop insurance, calculate premiums, and submit insurance claims through the insurance module.
10. Administrators review and process insurance claims using the admin dashboard.
11. Users can monitor auction status, bidding history, insurance requests, and account activities through role-based dashboards.
12. Log out securely after completing your tasks. 

Hardware

• Dual-Core Processor (Intel i3/Ryzen 3 or higher)
• 4 GB RAM (8 GB Recommended)
• 2 GB Free Disk Space
• Stable Internet Connection

Software

• Windows 10/11, Linux, or macOS
• Java JDK 17+
• Node.js 18+
• Angular CLI
• Maven 3.8+
• MySQL 8.0+
• Git
• IntelliJ IDEA / Eclipse / VS Code
• Google Chrome, Microsoft Edge, or Firefox

Backend

• Spring Boot
• Spring Cloud Gateway
• Eureka Service Registry
• REST APIs
• JWT Authentication

Frontend

• Angular
• HTML5
• CSS3
• TypeScript

Database

• MySQL 8.0+