TrashToTreasure

TrashToTreasure is a waste management and upcycled product marketplace platform. It enables the collection, categorization, and sale of waste materials, while also allowing artisans to create and sell upcycled products.

Features

Waste Management System

• City corporations and companies collect waste from households and businesses.
• Workers separate materials and list them on the platform.
• Buyers (companies or artisans) can purchase waste materials for upcycling.
• Delivery system for waste materials via assigned drivers.

Upcycled Product Marketplace

• Artisans create and sell upcycled products.
• Admin approval required before products appear in the marketplace.
• Buyers can purchase products and leave ratings/reviews.

User Roles

• Admin: Manages user approvals, product verification, and platform settings, lists waste materials with prices and details.
• Driver/Delivery Guy: Collects and delivers materials.
• Artisan/Crafter: Purchases waste materials and sells upcycled products.
• Buyer: Purchases waste materials or upcycled products.

Tech Stack

• Backend: Django (Python)
• Frontend: HTML, CSS, JavaScript
• Database: sqLite
• Authentication: Django Auth (with role-based access control)
• Deployment: Docker, AWS/Heroku (Planned)

Installation

1. Clone the repository

   git clone https://github.com/maruf346/TrashToTreasure.git
   cd TrashToTreasure

2. Set up a virtual environment

   python -m venv venv
   source venv/bin/activate  # On Windows use `venv\Scripts\activate`

3. Install dependencies

   pip install -r requirements.txt

4. Run database migrations

   python manage.py makemigrations
   python manage.py migrate

5. Create a superuser (Admin access)

   python manage.py createsuperuser

6. Run the server

   python manage.py runserver

API Endpoints (Planned)

Endpoint	Method	Description
/api/waste-items/	GET	List all waste materials
/api/waste-items/{id}/	GET	Get details of a specific waste item
/api/upcycled-products/	GET	List all upcycled products
/api/upcycled-products/{id}/	GET	Get details of a specific upcycled product
/api/orders/	POST	Place an order

Future Enhancements

• Payment gateway integration.
• AI-based waste categorization.
• Mobile app development.

License

This project is licensed under the MIT License.

Contributing

We welcome contributions! If you'd like to contribute:

1. Fork the repository.
2. Create a new branch (git checkout -b feature-name).
3. Make your changes and commit (git commit -m 'Add new feature').
4. Push to your branch (git push origin feature-name).
5. Open a pull request.

Contact

For any inquiries, feel free to reach out:
Author: Maruf Hossain
Dept. of CSE
Green University of Bangladesh
📧 Email: [email protected]

• GitHub Issues: Create an issue

---

Let's turn waste into value! ♻️🚀