Skip to content

Tushya-web/samanloop

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

96 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

LOGINLOGO

SamanLoop

Borrow Smart. Earn Easy.

Django Python Firebase Status License Platform Deployment

GitHub repo size GitHub stars GitHub forks GitHub last commit

A peer-to-peer rental marketplace that allows people to borrow and lend everyday items locally instead of buying them for short-term use.

SamanLoop promotes cost saving, sustainability, and smarter resource utilization by enabling communities to share underused items.


๐ŸŒ Live Application

๐Ÿš€ Try the Live Platform

Live Demo

๐Ÿ”— https://samanloop.up.railway.app/

Screenshot 2026-03-13 000033

๐Ÿ“‘ Table of Contents


๐Ÿ“– About the Project

Many people buy items that they rarely use, such as tools, cameras, projectors, or camping gear.

At the same time, others need these items only temporarily.

SamanLoop bridges this gap by allowing users to:

โ€ข Borrow items when needed โ€ข Lend unused items to earn money โ€ข Reduce waste and unnecessary purchases

The platform works as a secure rental ecosystem between borrowers and lenders.


โš ๏ธ Problem Statement

Traditional item ownership leads to:

Problem Description
High Cost Buying expensive items for short-term use
Resource Waste Many items stay unused most of the time
Lack of Access People can't afford tools they occasionally need
No Sharing Platform No simple local platform for borrowing items

๐Ÿ’ก Proposed Solution

SamanLoop provides a digital platform where users can easily list, borrow, and return items securely.

Core solution features include:

โ€ข Item listing by owners โ€ข Borrow requests by users โ€ข Deposit-based security system โ€ข Return confirmation workflow โ€ข User dashboards for lenders and borrowers


โœจ Key Features

๐Ÿ‘ค User Features

  • User Registration & Login
  • Browse available items
  • Search items by category
  • Borrow items with deposit
  • Return items
  • Track borrowing history

๐Ÿท๏ธ Lender Features

  • Add items for rent
  • Approve borrow requests
  • Track item usage
  • Confirm item return
  • Earn rental income

๐Ÿ” Platform Features

  • Secure user sessions
  • Rental deposit management
  • Transaction workflow
  • Dashboard management
  • Item availability tracking

๐Ÿ”„ System Workflow

The SamanLoop platform operates through three main roles: Borrower, Lender, and Admin. Each role has specific responsibilities in the rental lifecycle.

๐Ÿ‘ค Borrower Workflow

1๏ธโƒฃ User registers or logs into the platform

2๏ธโƒฃ User browses available items

3๏ธโƒฃ User selects an item and sends a borrow request

4๏ธโƒฃ Borrower pays the required deposit / rental fee

5๏ธโƒฃ Borrower collects the item from the lender

6๏ธโƒฃ Borrower uses the item for the agreed rental duration

7๏ธโƒฃ Borrower returns the item on or before the return date

8๏ธโƒฃ Lender confirms the return

9๏ธโƒฃ Deposit is released or refunded

๐Ÿท๏ธ Lender Workflow

1๏ธโƒฃ Lender registers and logs into the platform

2๏ธโƒฃ Lender lists an item with details (name, category, price, deposit, availability)

3๏ธโƒฃ Lender receives borrow requests from users

4๏ธโƒฃ Lender reviews and approves or rejects the request

5๏ธโƒฃ Lender hands over the item to the borrower

6๏ธโƒฃ Lender monitors the item usage period

7๏ธโƒฃ Lender verifies item condition upon return

8๏ธโƒฃ Lender confirms the return in the system

9๏ธโƒฃ Platform completes the transaction

๐Ÿ› ๏ธ Admin Workflow

1๏ธโƒฃ Admin manages platform users

2๏ธโƒฃ Admin monitors listed items and categories

3๏ธโƒฃ Admin reviews reported issues or disputes

4๏ธโƒฃ Admin manages system queries and support requests

5๏ธโƒฃ Admin ensures platform security and data integrity

6๏ธโƒฃ Admin monitors transactions and platform activity

7๏ธโƒฃ Admin performs system updates and maintenance

๐Ÿ” Data Flow Architecture

User
 โ†“
Frontend (HTML / CSS / JS)
 โ†“
Django Views
 โ†“
Django Models
 โ†“
Database (SQLite / PostgreSQL)
 โ†“
Business Logic
 โ†“
Response to User

๐Ÿงฐ Technology Stack

Layer Technology
Frontend HTML CSS Bootstrap
Backend Django Python
Database SQLite OR PostgreSQL
Authentication Django Auth Firebase
Deployment Railway
Version Control Git GitHub

๐Ÿ—„ Database Design

Main database tables used:

Table Purpose
Users Stores registered user data
Item Item details listed by lenders
Category Item categorization
ItemUsage Tracks borrowing transactions
Payment Deposit / rental payments
Query User support queries

๐Ÿš€ Deployment

The project is deployed using Railway cloud hosting.

Live link:

https://samanloop.up.railway.app/

Deployment includes:

  • Production server
  • Static files configuration
  • Database migrations
  • Secure environment variables

๐Ÿ“š Documentation

Project documentation will include:

  • System Architecture
  • API Design
  • Database Schema
  • User Workflows
  • Deployment Guide

Documentation Link:

(Add documentation link here)
Soon...

๐Ÿ“Š Project Presentation

Project PPT used for demonstration and explanation.

Presentation Link:

(Add Google Drive PPT link here)
Soon...

๐Ÿ”ฎ Future Enhancements

Planned improvements for SamanLoop:

  • Integrated online payments [โœ” Implemented]
  • Real-time item availability [โœ” Implemented]
  • Location-based search [โœ” Implemented]
  • Ratings & reviews [โœ” Implemented]
  • Mobile application
  • AI-powered item recommendations [Soon...]
  • Fraud detection system

๐Ÿ‘จโ€๐Ÿ’ป Author

Tushya R Parmar

AI Engineer (Aspiring) Full Stack Developer

GitHub https://github.com/Tushya-web

Project Repository https://github.com/Tushya-web/samanloop


โญ Support

If you like this project, please star the repository to support development.

About

The platform focuses on cost saving, sustainability, and smart resource sharing by connecting borrowers and lenders in nearby locations.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors