🌾 Farmaid - Farmer Loan Management System

📖 Project Overview

Farmaid is a robust full-stack web application designed to bridge the gap between farmers and financial institutions. It simplifies the complexity of agricultural loan management by providing a digital platform where farmers can apply for loans and track status while administrators can verify and approve requests efficiently.

The project is built using a RESTful API architecture with Spring Boot serving the backend and Angular delivering a responsive and dynamic frontend experience.

---

🌟 Key Features

👨‍🌾 For Farmers (User Module)

• Secure Registration & Login: JWT-based authentication.
• Loan Application: Easy-to-use forms to apply for crop, equipment, or land loans.
• Status Tracking: Real-time updates on application status (Pending, Approved, Rejected).

👨‍💼 For Administrators (Banker Module)

• Admin Dashboard: Overview of total applications, active loans, and disbursements.
• Application Verification: Review farmer documents and loan details.
• Approval Workflow: Approve or reject loans with remarks.
• Farmer Management: View and manage registered farmer details.

---

🛠️ Technology Stack

Layer	Technology
Frontend	Angular, TypeScript, HTML5, CSS3, Bootstrap/Tailwind
Backend	Java 17, Spring Boot 3, Spring Security
Database	MySQL
Build Tools	Maven (Backend), NPM (Frontend)
Tools	Postman (API Testing), Git

---

⚙️ Installation & Setup Guide

Follow these steps to set up the project locally.

Prerequisites

• Java JDK 17+
• Node.js & NPM
• MySQL Server
• Angular CLI (npm install -g @angular/cli)

Step 1: Database Setup 🗄️

1. Open your MySQL Workbench or Terminal.
2. Create a database named farmaid_db (or whatever you named it in properties).

   CREATE DATABASE farmaid_db;

3. (Optional) The tables will be auto-generated by Hibernate, or you can import the schema.sql if provided.

Step 2: Backend Setup (Spring Boot) 🍃

1. Navigate to the backend folder:

   cd springapp

2. Open src/main/resources/application.properties and update your MySQL credentials:

   spring.datasource.url=jdbc:mysql://localhost:3306/farmaid_db
   spring.datasource.username=YOUR_USERNAME (e.g., root)
   spring.datasource.password=YOUR_PASSWORD
   spring.jpa.hibernate.ddl-auto=update

3. Run the application:

   mvn spring-boot:run

   The backend server will start at http://localhost:8080

Step 3: Frontend Setup (Angular) 🅰️

1. Navigate to the frontend folder:

   cd angularapp

2. Install dependencies:

   npm install

3. Start the Angular development server:

   ng serve

4. Open your browser and navigate to http://localhost:4200.

---

👤 Author

Divyanshu Pandey