Node.js License MongoDB Express.js

📑 Table of Contents

About Findify

🎯 Mission

✅ Current Status

✨ Key Features

👥 User Features

🏢 Business Owner Features

🔐 Advanced Security

🛠️ Tech Stack

Node.js Express.js MongoDB Mongoose

EJS Bootstrap JavaScript CSS3

Mapbox Cloudinary Passport Resend

Detailed Technology Table

📁 Project Structure

Local Business Finder/
│
├── 📄 app.js # Main Express application (2377 lines)
├── 📄 cloudconfig.js # Cloudinary configuration
├── 📄 createAdmin.js # Admin creation utility
├── 📄 mapbox.js # Mapbox integration
├── 📄 middleware.js # Custom middleware functions
├── 📄 package.json # Project dependencies
├── 📖 README.md # Complete documentation
│
├── 📂 models/ # Mongoose Data Models
│ ├── Business.js # Business schema with GeoJSON
│ ├── User.js # User schema with OAuth fields
│ └── Review.js # Review schema with ratings
│
├── 📂 routes/ # Express Route Handlers
│ ├── auth.js # Authentication routes
│ └── business.js # Business CRUD routes
│
├── 📂 views/ # EJS Templates (Server-side)
│ ├── layouts/
│ │ └── boilerplate.ejs # Main layout template
│ ├── index.ejs # Home page with featured businesses
│ ├── discover.ejs # Business discovery page
│ ├── show.ejs # Business details page
│ ├── edit.ejs # Edit business page
│ ├── new.ejs # Create business page
│ ├── about.ejs # About page
│ ├── contact.ejs # Contact page
│ ├── login.ejs # Login page with OAuth
│ ├── register.ejs # Registration page with OAuth
│ ├── verify-otp.ejs # OTP verification form
│ ├── forgot-password.ejs # Forgot password form
│ ├── reset-password.ejs # Reset password form
│ ├── dashboard.ejs # Admin dashboard
│ ├── user-dashboard.ejs # User profile dashboard
│ ├── admin-dashboard.ejs # Admin management panel
│ ├── Premium.ejs # Premium features page
│ ├── Privacy.ejs # Privacy policy
│ ├── Terms.ejs # Terms of service
│ ├── error.ejs # Error page
│ ├── chatbot.ejs # Chatbot interface
│ ├── chatbot-analytics.ejs # Chatbot analytics
│ └── edit-review.ejs # Edit review form
│
├── 📂 public/ # Static Assets
│ ├── css/
│ │ ├── index.css # Main styles + animations
│ │ └── chatbot.css # Chatbot styling
│ ├── js/
│ │ ├── chatbot.js # Chatbot functionality
│ │ └── premium.js # Premium features logic
│ ├── Images/ # Static images
│ └── sitemap.xml # XML sitemap for SEO
│
└── 📂 utils/ # Utility Functions
 └── otp.js # OTP generation + email

🏗️ System Architecture

Overall Architecture Flow

┌──────────────────────────────────────────────────────┐
│ CLIENT LAYER │
│ ┌─────────────┐ ┌──────────┐ ┌──────────┐ │
│ │ EJS HTML │ │Bootstrap │ │JavaScript│ │
│ │ Templates │ │CSS + Anim│ │Interactivity│ │
│ └─────────────┘ └──────────┘ └──────────┘ │
└──────────────┬──────────────────────────────────────┘
 │ HTTP/HTTPS
┌──────────────▼──────────────────────────────────────┐
│ EXPRESS.JS SERVER │
├──────────────────────────────────────────────────────┤
│ Routes Layer │
│ ├─ /auth/* (Authentication) │
│ ├─ /business/* (Business Operations) │
│ ├─ /messages/* (Messaging) │
│ └─ /search (Discovery) │
├──────────────────────────────────────────────────────┤
│ Middleware Stack │
│ ├─ Express.json (Body Parsing) │
│ ├─ Passport.js (Authentication) │
│ ├─ Express-session (Sessions) │
│ └─ Custom Middleware (Validation) │
├──────────────────────────────────────────────────────┤
│ Business Logic │
│ ├─ User Management │
│ ├─ Business Operations │
│ ├─ Review System │
│ └─ Messaging │
└──────┬────┬──────┬──────┬──────┬─────────────────────┘
 │ │ │ │ │
 ┌───▼──┐│ ┌─────▼─┐┌───▼──┐┌─▼───┐
 │MongoDB││ │Mapbox ││Resend││Razor│
 │(Data) ││ │(Maps) ││(Email││pay │
 └───────┘│ │ ││ ││ │
 └─▼──────┘└──────┘└─────┘

Authentication Flow Diagram

User Registration/Login Request
 │
 ├─ Option 1: Local (Email/Password)
 │ ├─ Register → OTP Email → Verify → Account Created
 │ ├─ Login → Validate Credentials → Session Created
 │ └─ Forgot Password → OTP Email → Reset → New Password
 │
 ├─ Option 2: Google OAuth
 │ ├─ Redirect to Google → User Approves → Get Auth Code
 │ ├─ Exchange Code for Profile → Create/Update User
 │ └─ Session Created
 │
 └─ Option 3: GitHub OAuth
 ├─ Redirect to GitHub → User Approves → Get Auth Code
 ├─ Exchange Code for Profile → Create/Update User
 └─ Session Created
 │
 ▼
 Passport.js Validation
 │
 ▼
 MongoDB User Document
 │
 ▼
 Express-session Created
 │
 ▼
 User Authenticated ✓

💾 Database Schema

User Model (Authentication & Profile)

{
 // Basic Information
 username: String (unique, required),
 email: String (unique, required),
 password: String (hashed with bcrypt),
 role: String (enum: ['user', 'admin'], default: 'user'),
 
 // Email Verification (OTP)
 otp: String (6-digit code),
 otpExpiry: Date (10-minute window),
 isEmailVerified: Boolean (email confirmation status),
 
 // Password Reset (OTP)
 resetOtp: String (6-digit code),
 resetOtpExpiry: Date (15-minute window),
 
 // OAuth Providers
 googleId: String (Google OAuth unique ID),
 githubId: String (GitHub OAuth unique ID),
 provider: String (enum: ['local', 'google', 'github']),
 
 // Profile Information
 profilePicture: String (URL from OAuth or upload),
 
 // Timestamps
 createdAt: Date,
 updatedAt: Date
}

Business Model (Listings)

{
 // Basic Information
 Name: String (business name),
 Category: String (category filter),
 description: String (business description),
 address: String (full address),
 
 // Location (GeoJSON for Mapbox)
 location: {
 type: Point,
 coordinates: [longitude, latitude]
 },
 
 // Contact Information
 contactNumber: String,
 email: String,
 website: String (optional),
 
 // Images & Media
 Image: {
 public_id: String (Cloudinary ID),
 url: String (Cloudinary URL)
 },
 
 // Ratings & Reviews
 avgRating: Number (average of all reviews),
 reviewCount: Number (total reviews),
 
 // Relationships
 Owner: ObjectId (Reference to User),
 reviews: [ObjectId] (Reference to Reviews),
 
 // Timestamps
 createdAt: Date,
 updatedAt: Date
}

Review Model (User Reviews)

{
 // Review Content
 content: String (review text),
 rating: Number (1-5 star rating),
 
 // References
 author: ObjectId (User who wrote review),
 business: ObjectId (Business being reviewed),
 
 // Metadata
 helpfulCount: Number (helpful votes),
 createdAt: Date,
 updatedAt: Date
}

🔐 Authentication System

Email Verification (OTP-Based)

OAuth Integration

Google OAuth

GitHub OAuth

Forgot Password (OTP-Based)

🌐 API Routes

Authentication Routes (/auth)

POST /register - Register new user with email
POST /verify-otp - Verify email with OTP code
POST /resend-otp - Resend OTP to email
GET /login - Display login page
POST /login - Local email/password login
GET /logout - Logout and destroy session
GET /forgot-password - Display forgot password form
POST /forgot-password - Send reset OTP to email
POST /reset-password - Reset password with OTP
POST /resend-reset-otp - Resend reset OTP
GET /auth/google - Redirect to Google OAuth
GET /auth/google/callback - Google OAuth callback handler
GET /auth/github - Redirect to GitHub OAuth
GET /auth/github/callback - GitHub OAuth callback handler

Business Routes (/business)

GET / - Home page with featured businesses
GET /discover - Browse all businesses
GET /show/:id - View business details
GET /new - Create business form
POST /create-business - Create new business listing
GET /edit/:id - Edit business form
PUT /update/:id - Update business information
DELETE /delete/:id - Delete business listing
GET /search - Search businesses by query
GET /business/:id - Business details page

Review Routes

POST /business/:id/reviews - Create review for business
PUT /reviews/:id - Edit review
DELETE /reviews/:id - Delete review
GET /reviews/:id - View review details

User Routes

GET /dashboard - User dashboard
GET /profile - User profile page
PUT /profile/update - Update user profile
GET /favorites - View saved businesses
POST /favorites/:id - Save business to favorites
DELETE /favorites/:id - Remove from favorites

Messaging Routes

GET /messages - View all message threads
GET /messages/:id - View specific conversation
POST /messages/:id/send - Send message to business
GET /unread-count - Get unread message count

⚙️ Environment Configuration

Required Environment Variables

# ==========================================
# DATABASE CONFIGURATION
# ==========================================
DB_URL=mongodb+srv://username:password@cluster.mongodb.net/findify_db
# ==========================================
# AUTHENTICATION - GOOGLE OAUTH
# ==========================================
GOOGLE_CLIENT_ID=your_google_client_id_here.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=your_google_client_secret_here
# ==========================================
# AUTHENTICATION - GITHUB OAUTH
# ==========================================
GITHUB_CLIENT_ID=your_github_client_id_here
GITHUB_CLIENT_SECRET=your_github_client_secret_here
# ==========================================
# EMAIL SERVICE (RESEND)
# ==========================================
RESEND_API_KEY=re_your_resend_api_key_here
# ==========================================
# IMAGE STORAGE (CLOUDINARY)
# ==========================================
CLOUD_NAME=your_cloudinary_cloud_name
CLOUD_API_KEY=your_cloudinary_api_key
CLOUD_API_SECRET=your_cloudinary_api_secret
# ==========================================
# MAPS & GEOLOCATION (MAPBOX)
# ==========================================
MAP_ACCESS_TOKEN=pk.your_mapbox_access_token_here
# ==========================================
# PAYMENT PROCESSING (RAZORPAY) - OPTIONAL
# ==========================================
RAZORPAY_KEY_ID=your_razorpay_key_id_here
RAZORPAY_KEY_SECRET=your_razorpay_key_secret_here
# ==========================================
# CHATBOT (OPENAI) - OPTIONAL
# ==========================================
CHATBOT=sk-proj-your_openai_api_key_here

🎨 UI/UX Improvements

Enhanced Business Cards

Improved Search Bar

Advanced Animations

Responsive Design

📦 Installation & Setup

Prerequisites

Step 1: Clone Repository

git clone https://github.com/aryaan022/Local-Business-Finder.git
cd "Local Business Finder"

Step 2: Install Dependencies

npm install

Step 3: Create Environment File

# Create .env file in root directory
cp .env.example .env

Step 4: Configure Environment Variables

Step 5: Obtain API Credentials

Step 6: Run Application

# Development with Nodemon (auto-reload)
nodemon app.js
# Or directly with Node
node app.js
# Application available at http://localhost:3000

🎯 UI/UX Features Implemented

Professional Animations

Responsive Design

User Feedback

🚀 Deployment

Development Start

nodemon app.js

Production Build

NODE_ENV=production node app.js

Hosting Options

📝 Contributing

How to Contribute

Code Standards

📄 License

📧 Contact & Support

⭐ If this project helped you, please give it a star!

Last Updated: December 19, 2025
Version: 2.0 (Production Ready)