🥬 Fresh Connect

A Complete Food Marketplace & Restaurant Management Ecosystem

Features • Tech Stack • Installation • Usage • API • Contributing

📋 Table of Contents

About The Project
Key Features
System Architecture
Tech Stack
Project Structure
Installation
Usage
API Documentation
Screenshots
Database Schema
Contributing
License
Acknowledgments

🌟 About The Project

Fresh Connect is a comprehensive full-stack web application designed to bridge the gap between food sellers, restaurants, and consumers. This platform promotes sustainable food consumption by featuring urgent sales for near-expiry products and free food listings to reduce food waste.

🎯 Problem Statement

Food waste is a major global issue with millions of tons wasted annually
Small restaurants and sellers lack digital presence for reaching customers
Consumers miss out on good deals due to lack of a unified platform
No proper system exists for managing leftover food distribution

💡 Our Solution

Fresh Connect provides a unified ecosystem where:

Restaurants can manage their operations, menus, and reduce food waste
Sellers can list products with special urgent sales features
Consumers can discover deals, track orders, and access free food listings
Admins can oversee the entire platform efficiently

🚀 Key Features

👤 Customer Portal

Feature	Description
🔐 Authentication	Secure JWT-based login/registration
🛒 Shopping Cart	Add, remove, and manage products
💝 Wishlist	Save favorite items for later
📍 Order Tracking	Real-time order status updates
💳 Payment Gateway	Secure payment processing
🔍 Product Search	Advanced search with filters
⭐ Reviews & Ratings	Rate and review products/restaurants
🆓 Free Food Listings	Access surplus food distributions
⚡ Urgent Sales	Grab discounted near-expiry products
✅ Verified Restaurants	Browse trusted verified establishments

🏪 Seller Dashboard

Feature	Description
📊 Analytics Dashboard	Sales insights and statistics
📦 Product Management	Add, edit, categorize products
🛍️ Order Management	Process and track orders
💰 Payment Management	View earnings and payment history
📝 Review Management	Respond to customer reviews
⚡ Urgent Sales	Create time-sensitive deals
✅ Verification System	Get verified seller badge
📞 Support System	Access customer support

🏨 Hotel Owner Portal

Feature	Description
📈 Analytics Dashboard	Comprehensive business analytics
🍽️ Menu Management	Digital menu creation and updates
📦 Inventory Management	Track stock levels
👥 Staff Management	Manage team members
🛒 Order Management	Handle incoming orders
🍕 Leftover Food	List surplus food for distribution
⚡ Urgent Sales	Quick sale for excess inventory
💬 Customer Feedback	View and respond to feedback
📜 Purchase History	Track all purchases
✅ Verification Badge	Display verified status

🛡️ Admin Panel

Feature	Description
👥 User Management	Manage all platform users
✅ Hotel Verification	Verify restaurant authenticity
✅ Seller Verification	Verify seller accounts
📋 Order Monitoring	Oversee all platform orders
💳 Payment Management	Handle payment disputes
📊 Analytics	Platform-wide statistics
📝 Content Management	Manage platform content
🚨 Complaint Handling	Resolve user complaints
📄 Report Generation	Generate business reports
⚙️ System Settings	Configure platform settings

🏗️ System Architecture

┌─────────────────────────────────────────────────────────────────┐
│                        FRESH CONNECT                             │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐           │
│  │   Customer   │  │    Seller    │  │ Hotel Owner  │           │
│  │   Portal     │  │   Dashboard  │  │   Portal     │           │
│  │  (React.js)  │  │  (React.js)  │  │  (React.js)  │           │
│  └──────┬───────┘  └──────┬───────┘  └──────┬───────┘           │
│         │                 │                 │                    │
│         └────────────────┬┴─────────────────┘                    │
│                          │                                       │
│                   ┌──────▼───────┐                               │
│                   │   Admin      │                               │
│                   │   Panel      │                               │
│                   │  (React.js)  │                               │
│                   └──────┬───────┘                               │
│                          │                                       │
│  ┌───────────────────────▼────────────────────────────────────┐ │
│  │                    REST API Layer                          │ │
│  │                   (Express.js + Node.js)                   │ │
│  │  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────────────┐  │ │
│  │  │  Auth   │ │ Orders  │ │Products │ │   Analytics     │  │ │
│  │  │ Routes  │ │ Routes  │ │ Routes  │ │    Routes       │  │ │
│  │  └─────────┘ └─────────┘ └─────────┘ └─────────────────┘  │ │
│  └────────────────────────┬───────────────────────────────────┘ │
│                           │                                      │
│                    ┌──────▼───────┐                              │
│                    │   MongoDB    │                              │
│                    │   Database   │                              │
│                    └──────────────┘                              │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

💻 Tech Stack

Frontend

Technology	Purpose
	UI Library
	Build Tool
	Styling
	Navigation
	HTTP Client
	Data Visualization

Backend

Technology	Purpose
	Runtime Environment
	Web Framework
	Database
	ODM
	Authentication
	Password Hashing

DevOps & Tools

Technology	Purpose
	Version Control
	Package Manager
	API Testing
	IDE

📁 Project Structure

Fresh-Connect/
│
├── 📂 admin/                      # Admin Panel (React)
│   ├── 📂 src/
│   │   ├── 📂 components/         # Reusable UI components
│   │   ├── 📂 pages/              # Admin pages
│   │   │   ├── Analytics.jsx
│   │   │   ├── ComplaintHandling.jsx
│   │   │   ├── ContentManagement.jsx
│   │   │   ├── Dashboard.jsx
│   │   │   ├── HotelVerification.jsx
│   │   │   ├── OrderMonitoring.jsx
│   │   │   ├── PaymentManagement.jsx
│   │   │   ├── ReportGeneration.jsx
│   │   │   ├── SellerVerification.jsx
│   │   │   ├── SystemSettings.jsx
│   │   │   └── UserManagement.jsx
│   │   ├── 📂 contexts/           # React Context providers
│   │   ├── 📂 services/           # API services
│   │   └── 📂 api/                # API routes
│   └── 📄 package.json
│
├── 📂 Major-Project-main/         # Main Application
│   │
│   ├── 📂 frontend/               # Customer & Seller Frontend (React + Vite)
│   │   ├── 📂 src/
│   │   │   ├── 📂 pages/
│   │   │   │   ├── 📂 user/       # Customer pages
│   │   │   │   │   ├── HomePage.jsx
│   │   │   │   │   ├── ShoppingCart.jsx
│   │   │   │   │   ├── OrderTracking.jsx
│   │   │   │   │   ├── PaymentGateway.jsx
│   │   │   │   │   ├── ProductSearch.jsx
│   │   │   │   │   ├── UrgentSales.jsx
│   │   │   │   │   ├── FreeFoodListings.jsx
│   │   │   │   │   └── ...
│   │   │   │   ├── 📂 seller/     # Seller pages
│   │   │   │   │   ├── Dashboard.jsx
│   │   │   │   │   ├── Products.jsx
│   │   │   │   │   ├── Orders.jsx
│   │   │   │   │   ├── Analytics.jsx
│   │   │   │   │   └── ...
│   │   │   │   └── 📂 hotelOwner/ # Hotel owner pages
│   │   │   │       ├── Dashboard.jsx
│   │   │   │       ├── MenuManagement.jsx
│   │   │   │       ├── Inventory.jsx
│   │   │   │       ├── LeftoverFood.jsx
│   │   │   │       └── ...
│   │   │   ├── 📂 components/     # Shared components
│   │   │   ├── 📂 context/        # State management
│   │   │   └── 📂 utils/          # Utility functions
│   │   └── 📄 package.json
│   │
│   └── 📂 backend/                # Backend API (Node.js + Express)
│       ├── 📂 controllers/        # Request handlers
│       ├── 📂 models/             # MongoDB schemas
│       ├── 📂 routes/             # API routes
│       ├── 📂 middleware/         # Custom middleware
│       ├── 📂 config/             # Configuration files
│       ├── 📂 utils/              # Utility functions
│       └── 📄 package.json
│
├── 📂 database-data/              # Sample database data
├── 📄 README.md                   # This file
├── 📄 LICENSE                     # MIT License
├── 📄 CONTRIBUTING.md             # Contribution guidelines
└── 📄 .gitignore                  # Git ignore rules

⚡ Installation

Prerequisites

Before you begin, ensure you have the following installed:

Node.js (v16.x or higher) - Download
MongoDB (v6.x or higher) - Download
Git - Download
npm or yarn

🔧 Step-by-Step Setup

1️⃣ Clone the Repository

git clone https://github.com/VivekGhantiwala/Fresh-Connect.git
cd Fresh-Connect

2️⃣ Backend Setup

# Navigate to backend directory
cd Major-Project-main/backend

# Install dependencies
npm install

# Create environment file
cp .env.example .env

# Edit .env with your configurations
# MONGODB_URI=mongodb://localhost:27017/freshconnect
# JWT_SECRET=your_super_secret_key
# PORT=5001

# Start the backend server
npm run dev

3️⃣ Frontend Setup

# Open a new terminal
# Navigate to frontend directory
cd Major-Project-main/frontend

# Install dependencies
npm install

# Create environment file
echo "VITE_BASE_URL=http://localhost:5001/api" > .env

# Start the frontend development server
npm run dev

4️⃣ Admin Panel Setup

# Open a new terminal
# Navigate to admin directory
cd admin

# Install dependencies
npm install

# Start the admin panel
npm start

5️⃣ Seed Database (Optional)

cd Major-Project-main/backend
npm run seed

🌐 Access the Application

Portal	URL
👤 Customer Frontend	http://localhost:5173
🛡️ Admin Panel	http://localhost:3000
🔌 Backend API	http://localhost:5001

📖 Usage

Customer Flow

Register/Login to the platform
Browse Products or search for specific items
Add to Cart and manage your shopping cart
Checkout with secure payment
Track Orders in real-time
Rate & Review products/restaurants

Seller Flow

Register as a seller
Complete Verification for trust badge
Add Products to your store
Manage Orders and shipments
View Analytics and grow your business

Hotel Owner Flow

Register your restaurant
Get Verified for authenticity badge
Manage Menu items digitally
Track Inventory and orders
List Leftover Food to reduce waste

📚 API Documentation

Authentication Endpoints

Method	Endpoint	Description
POST	`/api/auth/register`	Register new user
POST	`/api/auth/login`	User login
GET	`/api/auth/profile`	Get user profile
PUT	`/api/auth/profile`	Update profile

Product Endpoints

Method	Endpoint	Description
GET	`/api/products`	Get all products
GET	`/api/products/:id`	Get single product
POST	`/api/products`	Create product
PUT	`/api/products/:id`	Update product
DELETE	`/api/products/:id`	Delete product

Order Endpoints

Method	Endpoint	Description
GET	`/api/orders`	Get user orders
POST	`/api/orders`	Create new order
GET	`/api/orders/:id`	Get order details
PUT	`/api/orders/:id/status`	Update order status

View All API Endpoints

Cart Endpoints

Method	Endpoint	Description
GET	`/api/cart`	Get user cart
POST	`/api/cart/add`	Add item to cart
DELETE	`/api/cart/:itemId`	Remove from cart

Hotel Endpoints

Method	Endpoint	Description
GET	`/api/hotels`	Get all hotels
GET	`/api/hotels/:id`	Get hotel details
POST	`/api/hotels`	Register hotel
GET	`/api/hotels/:id/menu`	Get hotel menu

Analytics Endpoints

Method	Endpoint	Description
GET	`/api/analytics/dashboard`	Dashboard stats
GET	`/api/analytics/sales`	Sales analytics
GET	`/api/analytics/orders`	Order analytics

📸 Screenshots

Click to View Screenshots

🏠 Home Page

Customer landing page with featured products and restaurants

🛒 Shopping Cart

Cart management with quantity controls

📊 Seller Dashboard

Analytics and order management for sellers

🍽️ Hotel Owner Dashboard

Comprehensive restaurant management interface

🛡️ Admin Panel

Platform administration and monitoring

🗄️ Database Schema

User Collection

{
  _id: ObjectId,
  name: String,
  email: String,
  password: String (hashed),
  role: ['customer', 'seller', 'hotel_owner', 'admin'],
  isVerified: Boolean,
  createdAt: Date,
  updatedAt: Date
}

Product Collection

{
  _id: ObjectId,
  name: String,
  description: String,
  price: Number,
  category: String,
  seller: ObjectId (ref: User),
  images: [String],
  stock: Number,
  isUrgentSale: Boolean,
  urgentSaleDiscount: Number,
  createdAt: Date
}

Order Collection

{
  _id: ObjectId,
  customer: ObjectId (ref: User),
  items: [{
    product: ObjectId,
    quantity: Number,
    price: Number
  }],
  totalAmount: Number,
  status: ['pending', 'confirmed', 'shipped', 'delivered'],
  shippingAddress: Object,
  paymentStatus: String,
  createdAt: Date
}

🤝 Contributing

Contributions are what make the open source community amazing! Any contributions you make are greatly appreciated.

Fork the Project
Create your Feature Branch (git checkout -b feature/AmazingFeature)
Commit your Changes (git commit -m 'Add some AmazingFeature')
Push to the Branch (git push origin feature/AmazingFeature)
Open a Pull Request

See CONTRIBUTING.md for detailed guidelines.

📜 License

Distributed under the MIT License. See LICENSE for more information.

🙏 Acknowledgments

👨‍💻 Author

BCA Semester 6 Major Project
Designed & Developed with passion

⭐ Star this repository if you found it helpful! ⭐

Name		Name	Last commit message	Last commit date
Latest commit History 2 Commits
Major-Project-main		Major-Project-main
admin		admin
.gitignore		.gitignore
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
Project.pptx		Project.pptx
README.md		README.md
SECURITY.md		SECURITY.md
documentation.pdf		documentation.pdf

Folders and files

Latest commit

History

Repository files navigation

🥬 Fresh Connect

📋 Table of Contents

🌟 About The Project

🎯 Problem Statement

💡 Our Solution

🚀 Key Features

👤 Customer Portal

🏪 Seller Dashboard

🏨 Hotel Owner Portal

🛡️ Admin Panel

🏗️ System Architecture

💻 Tech Stack

Frontend

Backend

DevOps & Tools

📁 Project Structure

⚡ Installation

Prerequisites

🔧 Step-by-Step Setup

1️⃣ Clone the Repository

2️⃣ Backend Setup

3️⃣ Frontend Setup

4️⃣ Admin Panel Setup

5️⃣ Seed Database (Optional)

🌐 Access the Application

📖 Usage

Customer Flow

Seller Flow

Hotel Owner Flow

📚 API Documentation

Authentication Endpoints

Product Endpoints

Order Endpoints

Cart Endpoints

Hotel Endpoints

Analytics Endpoints

📸 Screenshots

🏠 Home Page

🛒 Shopping Cart

📊 Seller Dashboard

🍽️ Hotel Owner Dashboard

🛡️ Admin Panel

🗄️ Database Schema

User Collection

Product Collection

Order Collection

🤝 Contributing

📜 License

🙏 Acknowledgments

👨‍💻 Author

About

Resources

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages