ScrapBoyOnline - Complete Scrap Marketplace

The platform connects customers with scrap collection partners through an easy-to-use digital marketplace. Customers can view scrap rates, book pickups and track their requests, while partners can manage leads, pickup requests and earnings through their dedicated dashboard. The system includes a powerful administration panel that gives the business owner complete control over users, partners, leads, scrap rates, bookings, content and platform settings. It is suitable for entrepreneurs and businesses looking to launch their own scrap collection, recycling or waste pickup marketplace without developing the entire platform from scratch.

Features

3. Key Features

👤 User System

• User registration & login
• User profile management
• Scrap rate viewing
• Scrap pickup booking
• Pickup address management
• Booking history
• Pickup status tracking
• Lead/request management
• OTP verification
• Mobile-friendly interface

🤝 Partner System

• Partner registration/login
• Partner dashboard
• Nearby lead discovery
• Lead purchase system
• Wallet/Connect balance
• Lead history
• Earnings tracking
• Pickup management
• Customer contact details after lead confirmation
• OTP-based lead confirmation

👨‍💼 Admin Panel

• Dashboard
• User management
• Partner management
• Lead management
• Pickup management
• Scrap category management
• Scrap rate management
• Wallet/Connect management
• Manual lead assignment
• Booking management
• CMS pages
• Blog management
• SEO settings
• Platform settings

📍 Location & Lead System

• Location-based lead matching
• Google Maps integration
• Radius-based partner matching
• Nearby partner discovery
• Lead assignment
• Manual lead assignment by admin
• Customer location information

💳 Wallet / Connect System

• Partner wallet balance
• Lead purchase using Connects
• Automatic Connect deduction
• Balance management
• Transaction history
• Minimum balance rules
• Lead refund/chargeback logic

🔐 Security & Verification

• OTP verification
• Authentication system
• Role-based access
• Admin controls
• Protected APIs
• Secure database architecture 

5. Why Buy ScrapBoyOnline?

Instead of spending months and thousands of dollars developing a scrap collection marketplace from scratch, buyers can start with an already developed platform.

Suitable for:

• Scrap dealers
• Recycling companies
• Waste management companies
• Scrap pickup businesses
• Recycling startups
• Local scrap marketplaces
• Multi-partner pickup businesses
• Entrepreneurs launching a new SaaS/business

6. What Buyer Gets

Standard Source Code Package

• Complete frontend source code
• Complete backend source code
• Admin panel
• User system
• Partner system
• Database
• API source code
• Configuration files
• Documentation
• Installation guide
• Deployment guide
• Database setup
• Environment configuration guide 

Requirements

3. System Requirements

ComponentRecommendedOSUbuntu 22.04/24.04 LTS or another Node.js-compatible Linux serverNode.jsNode.js 20 LTS recommendednpmIncluded with Node.jsDatabaseMySQL 8.0 for production; SQLite is supported by the application database layerRAM2 GB minimum for a small deployment; 4 GB+ recommended for productionStorageAt least 5 GB free, plus space for uploads and database backupsOptional servicesFirebase, Google Maps Platform, SMTP, payment provider accounts, analytics/search tools

Instructions

Docker / VPS Deployment

Prerequisites

Install Docker Engine and Docker Compose on the VPS.

Configure environment

cp .env.example .env
# Edit .env with your production values

Build and start

docker compose up -d --build

set revers proxy port 3000 

## Demo Credentials
After installation, clients can use the following default credentials to test the application. The password for all accounts is **`password123`**:

| Role | Phone Number | Password |
| :--- | :--- | :--- |
| **Admin** | 9999999999 | password123 |
| **Partner** | 8888888888 | password123 |
| **Vendor** | 7777777777 | password123 |
| **User** | 6666666666 | password123 |

## Quick Start (Local Development)
1. Run `docker-compose up -d --build`
2. set revers proxy  port 3000
3. Access the app at `http://yourdomain.com:3000`

*Thank you for choosing ScrapBoy Online!*