Skip to content

shitcodebykaushik/fastapi-backend1

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
__pycache__
__pycache__
 
 
app
app
 
 
.env
.env
 
 
README.md
README.md
 
 
backend.db
backend.db
 
 
main.py
main.py
 
 
requirement.txt
requirement.txt
 
 

Repository files navigation

FastAPI Backend - For the kissan connect

Note

  • There is complete env file and the db also uploaded for the use case of the development for the new developer . To help the new developer i have made followed the practice to let the new developer enjoy the beauty of the backend . Happy learnig .

🚀 Overview

This is the backend API for Kissan Connect, a platform designed to connect farmers and buyers. It provides user authentication, product listing, bidding system, order management, notifications, and an insurance module.

📌 Features

  • User authentication (Signup/Login with role-based access)
  • Product listing and management
  • Bidding system for buyers and farmers
  • Order confirmation and tracking
  • Notifications for bids, orders, and updates
  • Insurance management (apply, claim)

🏗️ Setup Instructions

1️⃣ Prerequisites

Ensure you have the following installed:

  • Python 3.10+
  • FastAPI
  • SQLite (or PostgreSQL for production)
  • Uvicorn

2️⃣ Install Dependencies

pip install -r requirements.txt

3️⃣ Run the Application

uvicorn main:app --host 0.0.0.0 --port 8000 --reload

4️⃣ Database Setup

Ensure the database is created:

sqlite3 backend.db "PRAGMA table_info(users);"

📌 API Endpoints

🔐 Authentication

Method Endpoint Body Description
POST /auth/signup { full_name, email, phone, password, role } Register a new user
POST /auth/login { username, password } Login and get JWT token
GET /auth/me Headers: Authorization: Bearer {token} Get current user details

📦 Products

Method Endpoint Body Description
POST /products/ { name, price, quantity, image_url } List a new product (farmer only)
GET /products/ None Fetch all available products

⚖️ Bidding System

Method Endpoint Body Description
GET /bids/ None Fetch bids received by a farmer
POST /bids/place { product_id, amount } Place a bid on a product (buyer)
PUT /bids/{bid_id}/update?status=accepted Query: status=accepted/rejected Accept or reject a bid

📦 Orders

Method Endpoint Body Description
POST /orders/confirm { bid_id } Confirm an accepted bid and create an order
GET /orders/ None Get all orders for a user

🔔 Notifications

Method Endpoint Body Description
GET /notifications/ None Fetch notifications for the logged-in user

🛡️ Insurance

Method Endpoint Body Description
GET /insurance/ None Fetch available insurance plans (filtered by role)
POST /insurance/apply { insurance_id } Apply for an insurance plan
POST /insurance/claim { insurance_id, reason } Claim an insurance plan

🛠️ Testing with Postman

  1. Import the API collection into Postman.
  2. Set Authorization as Bearer {access_token} for protected routes.
  3. Test different functionalities like user signup, bidding, and insurance.

🔍 Troubleshooting

✅ Common Issues

  • Login failure: Ensure the credentials are correct and the database has users.
  • Unauthorized requests: Include the Authorization header in requests.
  • Database not updating: Run sqlite3 backend.db and check data consistency.

📜 License

This project is licensed under MIT License.

🙌 Contributors

  • Shit_code - Lead Developer

For any issues, feel free to open a GitHub issue or contact us. 🚀

About

No description, website, or topics provided.

Resources

Readme
Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages