Alexander Ü & Casandra's final project

README.md

@@ -1,13 +1,59 @@
-# Final Project
+# Creative Ideas Hub / The Pensive
 
-Replace this readme with your own information about your project.
+A collaborative platform where users can share and discover creative ideas in an immersive 3D environment. Connect with ideas and find collaborators for your projects through idea connections.
 
-Start by briefly describing the assignment in a sentence or two. Keep it short and to the point.
+OBS!!! MVP mode - header and nav not fixed/animated on mobile, basic scroll behavior. The hidden mobileheader also take room in the desktop, no time to refactor that one. 
 
-## The problem
+## What it does
 
-Describe how you approached to problem, and what tools and techniques you used to solve it. How did you plan? What technologies did you use? If you had more time, what would be next?
+This app lets you:
+
+- Share your creative ideas with text and images
+- Browse ideas in a cool 3D space where each idea is a floating orb
+- Connect with ideas you're interested in collaborating on
+- Receive email notifications when someone connects with your idea
+- Get social media links from potential collaborators
+- Navigate the 3D world using keyboard, mouse, or touch controls
+- Edit and manage your own ideas (under construction)
+- View and edit your profile (under construction)
+
+## How we built it
+
+### Frontend (React)
+
+- **React 19** - The main framework for building the user interface
+- **Three.js** - For the 3D graphics and interactive scene
+- **Zustand** - For managing app state (like user data and ideas)
+- **Styled Components** - For styling the app
+- **React Router** - For navigation between pages
+
+### Backend (Node.js)
+
+- **Express.js** - The server framework
+- **MongoDB** - Database to store users, ideas, and connections
+- **JWT** - For user authentication and security
+- **Cloudinary** - For storing and managing images
+- **Multer** - For handling file uploads
 
 ## View it live
 
-Every project should be deployed somewhere. Be sure to include the link to the deployed project so that the viewer can click around and see what it's all about.
+- **Frontend**: https://aesthetic-dolphin-63dc60.netlify.app/
+- **Backend API**: https://project-final-backend-gq0x.onrender.com
+
+## API Documentation
+
+The backend uses the `express-list-endpoints` library to automatically generate API documentation. You can view all available endpoints at:
+https://project-final-backend-gq0x.onrender.com/api-docs
+
+## Future improvements
+
+If we had more time, we'd add:
+
+- BETTER errorhandling
+- BETTER Loading States through out the app
+- BETTER User Experience
+- Well, to be honest, finish the app? Its only at MVP stage
+- Real-time chat between users
+- More 3D effects and animations
+- Idea categories and search
+- Video upload support

backend/middleware/auth.js

@@ -0,0 +1,50 @@
+import jwt from 'jsonwebtoken';
+import User from '../models/User.js';
+
+const JWT_SECRET = process.env.JWT_SECRET || 'your-secret-key';
+
+export const authenticateToken = async (req, res, next) => {
+  try {
+    // Get token from header
+    const authHeader = req.headers['authorization'];
+    const token = authHeader && authHeader.split(' ')[1]; // Bearer TOKEN
+
+    console.log('Auth: Checking token...', {
+      hasAuthHeader: !!authHeader,
+      hasToken: !!token,
+      tokenLength: token ? token.length : 0
+    });
+
+    if (!token) {
+      return res.status(401).json({ message: 'Access token required' });
+    }
+
+    // Verify token
+    const decoded = jwt.verify(token, JWT_SECRET);
+    console.log('Auth: Token decoded successfully', { userId: decoded.userId });
+
+    // Find user
+    const user = await User.findById(decoded.userId).select('-password');
+
+    if (!user) {
+      console.log('Auth: User not found', { userId: decoded.userId });
+      return res.status(401).json({ message: 'Invalid token' });
+    }
+
+    console.log('Auth: User authenticated successfully', {
+      userId: user._id,
+      email: user.email
+    });
+
+    // Add user to request object
+    req.user = user;
+    next();
+  } catch (error) {
+    console.error('Auth: Token verification failed', error.message);
+    return res.status(403).json({ message: 'Invalid token' });
+  }
+};
+
+// Default export for convenience
+const auth = authenticateToken;
+export default auth;

backend/middleware/upload.js

@@ -0,0 +1,26 @@
+import multer from 'multer';
+
+// Keep files in memory as Buffer for Cloudinary upload
+const storage = multer.memoryStorage();
+
+// File filter to only allow certain file types
+const fileFilter = (req, file, cb) => {
+  // Allow images only
+  if (file.mimetype.startsWith('image/')) {
+    cb(null, true);
+  } else {
+    cb(new Error('Only image files are allowed!'), false);
+  }
+};
+
+// Configure multer for Cloudinary uploads
+const upload = multer({
+  storage: storage, // Keep in memory for Cloudinary
+  fileFilter: fileFilter,
+  limits: {
+    fileSize: 5 * 1024 * 1024, // 5MB limit
+    files: 5, // Maximum 5 files per request
+  },
+});
+
+export default upload;

backend/models/Idea.js

@@ -0,0 +1,62 @@
+import mongoose from 'mongoose';
+
+const ideaSchema = new mongoose.Schema(
+  {
+    title: {
+      type: String,
+      required: [true, 'Title is required'],
+      trim: true,
+      minlength: [3, 'Title must be at least 3 characters long'],
+      maxlength: [100, 'Title cannot exceed 100 characters'],
+    },
+    description: {
+      type: String,
+      required: [true, 'Description is required'],
+      trim: true,
+      minlength: [10, 'Description must be at least 10 characters long'],
+      maxlength: [2000, 'Description cannot exceed 2000 characters'],
+    },
+    creator: {
+      type: mongoose.Schema.Types.ObjectId,
+      ref: 'User',
+      required: [true, 'Creator is required'],
+    },
+    likeCount: {
+      type: Number,
+      default: 0,
+      min: 0,
+    },
+    connectionCount: {
+      type: Number,
+      default: 0,
+      min: 0,
+    },
+    images: [
+      {
+        type: String,
+        trim: true,
+      },
+    ],
+  },
+  {
+    timestamps: true,
+  }
+);
+
+// Virtual field to get image count
+ideaSchema.virtual('imageCount').get(function () {
+  return this.images.length;
+});
+
+// Virtual field to check if idea has images
+ideaSchema.virtual('hasImages').get(function () {
+  return this.images.length > 0;
+});
+
+// Ensure virtual fields are serialized
+ideaSchema.set('toJSON', { virtuals: true });
+ideaSchema.set('toObject', { virtuals: true });
+
+const Idea = mongoose.model('Idea', ideaSchema);
+
+export default Idea;

backend/models/User.js

@@ -0,0 +1,168 @@
+import mongoose from 'mongoose';
+import bcrypt from 'bcrypt';
+
+const userSchema = new mongoose.Schema(
+  {
+    email: {
+      type: String,
+      required: [true, 'Email is required'],
+      unique: true,
+      lowercase: true,
+      trim: true,
+      match: [
+        /^\w+([.-]?\w+)*@\w+([.-]?\w+)*(\.\w{2,3})+$/,
+        'Please enter a valid email',
+      ],
+    },
+    password: {
+      type: String,
+      required: [true, 'Password is required'],
+      minlength: [6, 'Password must be at least 6 characters long'],
+    },
+    firstName: {
+      type: String,
+      required: [true, 'First name is required'],
+      trim: true,
+      minlength: [2, 'First name must be at least 2 characters long'],
+      maxlength: [50, 'First name cannot exceed 50 characters'],
+    },
+    lastName: {
+      type: String,
+      required: [true, 'Last name is required'],
+      trim: true,
+      minlength: [2, 'Last name must be at least 2 characters long'],
+      maxlength: [50, 'Last name cannot exceed 50 characters'],
+    },
+    role: {
+      type: String,
+      default: 'creative mind',
+      trim: true,
+      maxlength: [100, 'Role cannot exceed 100 characters'],
+    },
+    description: {
+      type: String,
+      trim: true,
+      maxlength: [500, 'Description cannot exceed 500 characters'],
+    },
+    link: {
+      type: String,
+      trim: true,
+      maxlength: [200, 'Link cannot exceed 200 characters'],
+    },
+    likedIdeas: [
+      {
+        type: mongoose.Schema.Types.ObjectId,
+        ref: 'Idea',
+      },
+    ],
+    connectedIdeas: [
+      {
+        idea: {
+          type: mongoose.Schema.Types.ObjectId,
+          ref: 'Idea',
+        },
+        message: {
+          type: String,
+          required: true,
+          maxlength: [500, 'Connection message cannot exceed 500 characters'],
+        },
+        socialLink: {
+          type: String,
+          trim: true,
+          maxlength: [200, 'Social link cannot exceed 200 characters'],
+        },
+        connectedAt: {
+          type: Date,
+          default: Date.now,
+        },
+      },
+    ],
+    receivedConnections: [
+      {
+        idea: {
+          type: mongoose.Schema.Types.ObjectId,
+          ref: 'Idea',
+        },
+        connectedBy: {
+          type: mongoose.Schema.Types.ObjectId,
+          ref: 'User',
+        },
+        message: {
+          type: String,
+          required: true,
+          maxlength: [500, 'Connection message cannot exceed 500 characters'],
+        },
+        socialLink: {
+          type: String,
+          trim: true,
+          maxlength: [200, 'Social link cannot exceed 200 characters'],
+        },
+        connectedAt: {
+          type: Date,
+          default: Date.now,
+        },
+      },
+    ],
+  },
+  {
+    timestamps: true,
+  }
+);
+
+// Virtual field to get full name
+userSchema.virtual('fullName').get(function () {
+  return `${this.firstName} ${this.lastName}`;
+});
+
+// Virtual field to get like count
+userSchema.virtual('likeCount').get(function () {
+  return this.likedIdeas ? this.likedIdeas.length : 0;
+});
+
+// Virtual field to get connection count (ideas I connected to)
+userSchema.virtual('connectionCount').get(function () {
+  return this.connectedIdeas ? this.connectedIdeas.length : 0;
+});
+
+// Virtual field to get received connections count (people who connected to my ideas)
+userSchema.virtual('receivedConnectionCount').get(function () {
+  return this.receivedConnections ? this.receivedConnections.length : 0;
+});
+
+// Virtual field to check if user has description
+userSchema.virtual('hasDescription').get(function () {
+  return this.description && this.description.trim().length > 0;
+});
+
+// Virtual field to check if user has link
+userSchema.virtual('hasLink').get(function () {
+  return this.link && this.link.trim().length > 0;
+});
+
+// Ensure virtual fields are serialized
+userSchema.set('toJSON', { virtuals: true });
+userSchema.set('toObject', { virtuals: true });
+
+// Hash password before saving
+userSchema.pre('save', async function (next) {
+  // Only hash the password if it has been modified (or is new)
+  if (!this.isModified('password')) return next();
+
+  try {
+    // Hash password with salt rounds of 10
+    const hashedPassword = await bcrypt.hash(this.password, 10);
+    this.password = hashedPassword;
+    next();
+  } catch (error) {
+    next(error);
+  }
+});
+
+// Method to compare password for login
+userSchema.methods.comparePassword = async function (candidatePassword) {
+  return bcrypt.compare(candidatePassword, this.password);
+};
+
+const User = mongoose.model('User', userSchema);
+
+export default User;

backend/package.json

@@ -12,9 +12,18 @@
     "@babel/core": "^7.17.9",
     "@babel/node": "^7.16.8",
     "@babel/preset-env": "^7.16.11",
+    "bcrypt": "^5.1.0",
+    "cloudinary": "^2.7.0",
     "cors": "^2.8.5",
+    "dotenv": "^16.0.3",
     "express": "^4.17.3",
+    "express-list-endpoints": "^6.0.0",
+    "express-validator": "^7.0.1",
+    "jsonwebtoken": "^9.0.0",
+    "mongodb": "^6.18.0",
     "mongoose": "^8.4.0",
+    "multer": "^2.0.2",
+    "nodemailer": "^7.0.5",
     "nodemon": "^3.0.1"
   }
-}
+}