🚀 Nivesha - Investment Banking Platform

Connecting Companies with Investors for World-Changing Ideas

📋 Table of Contents

• Overview
• Features
• Tech Stack
• Project Structure
• Getting Started
• API Documentation
• Deployment
• Contributing
• License

🎯 Overview

Nivesha is a comprehensive investment banking platform that facilitates connections between innovative companies and strategic investors. The platform serves as a bridge for entrepreneurs to reach multiple investors simultaneously and pitch their ideas, while providing investors with curated investment opportunities.

Key Statistics

• 4000+ Startups Registered
• 2000+ Investors Registered
• 3000+ Successful Collaborations
• ₹1,00,00,000+ Total Investments Facilitated

✨ Features

🔐 Authentication & User Management

• Multi-role Registration: Support for Companies, Investors, and Admins
• Secure Authentication: JWT-based authentication with bcrypt password hashing
• Profile Management: Comprehensive user profiles with photo uploads
• Role-based Access Control: Different features and permissions based on user type

🏢 Company Features

• Company Registration: Complete company profile creation
• Investment Tracking: Monitor all investments and equity gained
• Social Media Integration: Connect Twitter, Instagram, Facebook profiles
• Service Portfolio: Showcase company services and offerings
• Valuation Management: Track company valuation and growth

💼 Investor Features

• Investor Dashboard: Comprehensive investment portfolio management
• Company Discovery: Browse and discover investment opportunities
• Investment History: Track all past and current investments
• Portfolio Analytics: Monitor total portfolio value and performance
• Grade System: Investor grading and reputation management

🔄 Investment Management

• Investment Creation: Facilitate new investment deals
• Equity Tracking: Monitor equity percentages and ownership
• Deal Management: Complete investment lifecycle management
• Pull Request System: Investment proposal and approval workflow

📱 User Experience

• Responsive Design: Mobile-first approach with Bootstrap
• Modern UI: Clean, professional interface with FontAwesome icons
• Real-time Updates: Dynamic content updates and notifications
• Feedback System: User feedback collection and management

🛠 Tech Stack

Frontend

• React 18.2.0 - Modern UI library
• Vite 5.1.6 - Fast build tool and dev server
• React Router 6.22.3 - Client-side routing
• Bootstrap 5.3.3 - CSS framework for responsive design
• FontAwesome 6.5.1 - Icon library
• Axios 1.6.7 - HTTP client for API calls
• Firebase 10.9.0 - File storage and additional services

Backend

• Node.js - JavaScript runtime
• Express.js 4.18.2 - Web application framework
• MongoDB 8.1.3 - NoSQL database
• Mongoose 8.1.3 - MongoDB object modeling
• JWT 9.0.2 - JSON Web Token authentication
• bcrypt 5.1.1 - Password hashing
• CORS 2.8.5 - Cross-origin resource sharing

Development Tools

• ESLint - Code linting and formatting
• Nodemon - Development server with auto-restart
• Dotenv - Environment variable management

📁 Project Structure

nivesha/
├── client/                 # Frontend React application
│   ├── public/            # Static assets
│   │   ├── components/    # Reusable UI components
│   │   ├── pages/         # Page components
│   │   ├── context/       # React context providers
│   │   ├── hooks/         # Custom React hooks
│   │   ├── utils/         # Utility functions
│   │   ├── assets/        # Images and static files
│   │   └── App.jsx        # Main application component
│   ├── package.json       # Frontend dependencies
│   └── vite.config.js     # Vite configuration
├── api/                   # Backend Node.js application
│   ├── controller/        # Route controllers
│   ├── models/           # MongoDB schemas
│   ├── routes/           # API route definitions
│   ├── utils/            # Utility functions
│   ├── db.js             # Database connection
│   ├── index.js          # Server entry point
│   └── package.json      # Backend dependencies
└── README.md             # Project documentation

🚀 Getting Started

Prerequisites

• Node.js (v16 or higher)
• MongoDB (local installation or MongoDB Atlas)
• Git

Installation

1. Clone the repository

   git clone https://github.com/code-razz/Nivesha_
   cd nivesha

2. Install backend dependencies

   cd api
   npm install

3. Install frontend dependencies

   cd ../client
   npm install

4. Environment Setup

   Create .env file in the api/ directory:

   MONGO_URL=your_mongodb_connection_string
   JWT=your_jwt_secret_key
   PORT=8000

   Create .env file in the client/ directory:

   VITE_API_URL=http://localhost:8000/api
   FIREBASE_KEY=your_firebase_config

5. Start the development servers

   Backend (Terminal 1):

   cd api
   npm start

   Frontend (Terminal 2):

   cd client
   npm run dev

6. Access the application

   • Frontend: http://localhost:5173
   • Backend API: http://localhost:8000

📚 API Documentation

Authentication Endpoints

• POST /api/auth/register - User registration
• POST /api/auth/login - User login

User Management

• GET /api/users/:id - Get user profile
• PUT /api/users/:id - Update user profile

Company Management

• GET /api/company - Get all companies
• POST /api/company - Create company profile
• PUT /api/company/:id - Update company profile
• DELETE /api/company/:id - Delete company

Investor Management

• GET /api/investor - Get all investors
• POST /api/investor - Create investor profile
• PUT /api/investor/:id - Update investor profile
• DELETE /api/investor/:id - Delete investor

Investment Management

• GET /api/investments - Get all investments
• POST /api/investments - Create new investment
• PUT /api/investments/:id - Update investment
• DELETE /api/investments/:id - Delete investment

Pull Requests

• GET /api/pullreq - Get all pull requests
• POST /api/pullreq - Create pull request
• PUT /api/pullreq/:id - Update pull request status

🚀 Deployment

Frontend Deployment (Vercel)

1. Connect your GitHub repository to Vercel
2. Set build command: npm run build
3. Set output directory: dist
4. Configure environment variables

Backend Deployment (Railway/Heroku)

1. Connect your GitHub repository
2. Set environment variables
3. Set start command: npm start
4. Deploy the application

Database Setup

• Use MongoDB Atlas for cloud database
• Configure connection string in environment variables
• Set up proper security and access controls

🤝 Contributing

1. Fork the repository
2. Create a feature branch

   git checkout -b feature/amazing-feature

3. Commit your changes

   git commit -m 'Add some amazing feature'

4. Push to the branch

   git push origin feature/amazing-feature

5. Open a Pull Request

Development Guidelines

• Follow ESLint configuration
• Write meaningful commit messages
• Test your changes thoroughly
• Update documentation as needed

🙏 Acknowledgments

• React and Vite communities for excellent tooling
• MongoDB team for robust database solutions
• Bootstrap team for responsive design framework
• All contributors and users of Nivesha