FOSSMentoring Documentation

Overview

"FOSSMentoring" is a web application built using Next.js. The project focus on mentoring and opportunities.

Youtube Product Demo

Packed with features like markdown blogging, blog feed, mentor feed, scheduling features, availability setup, real-time chat and media share, opportunity board and multiple chaining for API integration, and a lot more.

V1: Instead of building a mentoring platform from scratch, clone and deploy to get a lot of features out of the box, and add additional features as required. (Completed)

V2: Enter certain parameters and get the platform deployed within minutes, all automated. (In progress)

Table of Contents

• FOSSMentoring Documentation
  • Overview
• Youtube Product Demo
  • Table of Contents
  • Getting Started
  • Installation
  • Key Features
  • Homepage
  • Mentor Page
  • Blog Page
  • Chat Page
  • Dashboard
  • Sign In/Enter Page
  • Opportunities Page
  • Additional Information
• API Documentation
  • Endpoints
    • POST /api/add
      • Request Body:
      • Headers:
      • Responses:
    • POST /api/book
  • Overview
  • Request
    • Headers:
    • Body:
  • Response
    • Success:
    • Errors:
  • Functionality
  • Dependencies
    • POST /api/createChat
  • Overview
  • Request
    • Headers:
    • Body:
  • Response
    • Success:
    • Errors:
  • Functionality
  • Dependencies
    • POST /api/edit
  • Overview
  • Request
    • Headers:
    • Body:
  • Response
    • Success:
    • Errors:
  • Functionality
  • Dependencies
    • POST /api/update
  • Overview
  • Request
    • Headers:
    • Body:
  • Response
    • Success:
    • Errors:
  • Functionality
  • Dependencies
    • POST /api/verify
  • Overview
  • Request
    • Headers:
  • Response
    • Success:
    • Errors:
  • Functionality
  • Dependencies
• Technologies Used
  • Programming Languages
  • Frameworks & Libraries
  • Cloud & Deployment
  • UI & Design
  • Third Party APIs
  • Extensions & Tools

Getting Started

Installation

Clone the repository or download the ZIP file.

Navigate to the project directory.
git clone https://github.com/RajGM/FOSSMentoring.git

Install the dependencies.
cd FOSSMentoring

Install the dependencies.
npm install

Add API keys to .env.local file

Run the development server.
npm run dev

Open your web browser and visit http://localhost:3000 to access the application.

Visit http://localhost:3000 in your browser to access the application.

Key Features

---

Homepage

Route: /pages/index.tsx

Description:
The homepage displays posts based on tags such as "VISA", "SOP", "Blog", and "Essay". It provides functionalities for users to load more posts and navigate through them.

---

Mentor Page

Route: /pages/[username]/index.tsx

Description:
This page allows users to search for mentors. They can search either by organization or by the name of a person. The results will display relevant mentor profiles.

---

Blog Page

Route: /pages/blog/

Description:
A dedicated space for users to read and explore various blogs. The content can range from informative articles to user experiences and more.

---

Chat Page

Route: /pages/chat

Description:
This page facilitates communication between users. It provides a platform for direct messaging, group chats, and other communication-related features.

---

Dashboard

Route: /pages/dashboard

Description:
The dashboard is a central hub for users. It provides functionalities like checking university emails, setting availability, managing sessions, updating profiles, and more. Users can also view their activities and notifications here.

---

Sign In/Enter Page

Route: /pages/enter

Description:
This is the entry point for users to log in to the platform. It supports authentication via Google. If a user is logging in for the first time, they will be prompted to choose a username.

---

Opportunities Page

Route: /pages/opp

Description:
The opportunities page is dedicated to showcasing various opportunities available for users. This could range from job listings to events or other types of opportunities.

---

Additional Information

The project uses next/font to automatically optimize and load Inter, a custom Google Font. For more details on deploying the Next.js app, refer to the Vercel Platform and the Next.js deployment documentation.

API Documentation

Version: 1.0.0

Endpoints

POST /api/add

Summary: Add new event

Description: Endpoint to add a new event.

Request Body:

• Format: application/json
  • postedBy (string): Username of the poster.
  • eventN (string): Event name.
  • link (string): Link to the event.
  • appS (string): Application Starts.
  • appE (string): Application Ends.
  • eventS (string, optional): Event Starts.
  • eventE (string, optional): Event Ends.

Headers:

• authorization (string): Authorization token. Required
• category (string): Category of the event. Required

Responses:

• 200 OK: Event added successfully.

  • Content-Type: application/json
    • success (string): Success message.

• 400 Bad Request: Missing or invalid headers.

  • Content-Type: application/json
    • error (string): Error message.

POST /api/book

Overview

This endpoint is designed to handle the booking functionality. It verifies the authorization, creates an ICS event, sends emails to the relevant parties, and updates the booking slots in the database.

Request

Headers:

• authorization (string): Authorization token. Required

Body:

• mentor (string): Username of the mentor.
• start (string): Start time of the event.
• end (string): End time of the event.
• summary (string): Summary of the event.
• description (string): Description or details of the event.
• location (string): Location of the event.
• enteredEmail (string): Email provided during the booking process.
• date (string): Date of the booking.
• startTime (string): Start time of the booking slot.
• endTime (string): End time of the booking slot.

Response

Success:

• Status Code: 200
• Body:
  • success (string): Success message, typically indicating the event name added.

Errors:

• Status Code: 400

  • Body:
    • error (string): "Authorization header missing"

• Status Code: 500

  • Body:
    • error (string): "Internal Server Error"

Functionality

1. Verifies the presence of the authorization header.
2. Decodes the token and retrieves the user details.
3. Creates an ICS event based on the provided details.
4. Prepares an email with the ICS event attached and sets it up to be sent to the user, mentor, and the provided email.
5. Updates the booking slots in the database for the specified user and date.
6. Commits the batch operations to the database.

Dependencies

• Firebase Admin: Used for database operations and authentication.
• Utility functions: createICS, to24HourFormat for event creation and time formatting.

POST /api/createChat

Overview

This endpoint is designed to handle the creation of chat sessions between two users. It ensures that both users have references to each other in their chat lists and initializes a greeting message in the chat.

Request

Headers:

• authorization (string): Authorization token. Required

Body:

• user (object):
  • uid (string): User ID of the first user.
• user2 (string): User ID of the second user.
• combinedId (string): Combined ID representing the chat session.

Response

Success:

• Status Code: 200
• Body:
  • success (string): "Auth Done"

Errors:

• Status Code: 500
  • Body:
    • error (string): "Internal Server Error"

Functionality

1. Verifies the authorization token and decodes it.
2. Prepares references to both users' chat lists and individual user details.
3. Checks if the first user already has a chat list. If so, the new chat reference is added. If not, a new chat list is created with the new chat reference.
4. Repeats the same process for the second user.
5. Initializes a greeting message ("Hello") in the chat session.
6. Commits all the database operations in a batch.

Dependencies

• Firebase Admin: Used for database operations and authentication.
• Utility functions: arrayPush, serverTimestamp for array operations and timestamp generation.

POST /api/edit

Overview

This endpoint is designed to handle the editing of events. It verifies the authorization, checks if the event already exists, and either creates a new event or edits the existing one. The endpoint also interacts with calendar events and Discord messages, either creating or editing them based on the provided data.

Request

Headers:

• authorization (string): Authorization token. Required
• category (string): Category of the event. Required
• firestoreid (string): Firestore ID for the event. Required

Body:

• postedBy (string): Username of the poster.
• eventN (string): Event name.
• link (string): Link to the event.
• appS (string): Application Starts.
• appE (string): Application Ends.
• calID (number): Calendar ID of the event. If 0, a new event will be created.
• discordMessageID (number): Discord message ID. If 0, a new message will be sent.

Response

Success:

• Status Code: 200
• Body:
  • success (string): "Hack Updated"

Errors:

• Status Code: 401
  • Body:
    • error (string): "UnAuthorized"

Functionality

1. Verifies the authorization token and decodes it.
2. Retrieves the user's social data.
3. Checks if a calendar event already exists. If not, a new event is created. Otherwise, the existing event is edited.
4. Checks if a Discord message already exists. If not, a new message is sent. Otherwise, the existing message is edited.
5. Updates the Firestore with the new or edited event details.
6. Sends a success response upon successful operation.

Dependencies

• Firebase Admin: Used for database operations and authentication.
• Utility functions: addCalendarEvent, editCalendarEvent, sendMessage, editMessage for event and message operations.

POST /api/update

Overview

This endpoint is designed to handle the voting and closing of items. It verifies the authorization, checks the type of operation (vote or close), and updates the database accordingly.

Request

Headers:

• authorization (string): Authorization token. Required
• firestoreid (string): Firestore ID for the item being voted or closed. Required
• category (string): Category of the item. Required

Body:

• type (string): Type of operation - either "vote" or "close".
• username (string): Username of the user performing the operation.

Response

Success:

• Status Code: 200
• Body:
  • success (string): "Authorization Success"

Errors:

• Status Code: 200
  • Body:
    • error (string): "Authorization Failed"

Functionality

1. Verifies the authorization token and decodes it.
2. Retrieves the current data of the item from the database.
3. If the operation type is "vote":
   • Checks if the user has already voted.
   • If not, increments the vote count and adds the user to the list of voters.
4. If the operation type is "close":
   • Checks if the user has already voted to close.
   • If not, increments the close count and adds the user to the list of closers.
   • If the close count reaches or exceeds 9, the item is moved to a "Closed" collection and deleted from the original collection.
5. Sends a success response upon successful operation.

Dependencies

• Firebase Admin: Used for database operations and authentication.
• Utility function: arrayPush for array operations.

POST /api/verify

Overview

This endpoint is designed to verify the domain of a user's email against a list of university domains stored in Firestore. If a match is found, the user is marked as a mentor in the database.

Request

Headers:

• authorization (string): Authorization token. Required

Response

Success:

• Status Code: 200
• Body:
  • success (string): "ADDED"

Errors:

• Status Code: 400
  • Body:
    • error (string): "Authorization header missing" or "No matching university domain found"
• Status Code: 401
  • Body:
    • error (string): "Authorization Failed"

Functionality

1. Checks for the presence of the authorization header.
2. Verifies the authorization token and decodes it to extract the user's email.
3. Extracts the domain from the user's email.
4. Searches the Firestore for a university with a matching domain.
5. If a match is found, the user is marked as a mentor in the database.
6. Sends a success response if the user is marked as a mentor, or an error response if no matching university domain is found.

Dependencies

• Firebase Admin: Used for database operations and authentication.

Technologies Used

---

Programming Languages

• TypeScript: A superset of JavaScript that adds static types.

---

Frameworks & Libraries

• React: A JavaScript library for building user interfaces.
• Next.js: A React framework for server-rendered applications.
• Firebase: A platform for web and mobile app development that provides cloud services, including authentication, databases, and more.

---

Cloud & Deployment

• GCP (Google Cloud Platform): A suite of cloud computing services that runs on the same infrastructure that Google uses internally for its end-user products.
• Firebase Cloud Storage: Object storage service for Firebase apps.
• Vercel Deployment: Platform for static sites and Serverless Functions.

---

UI & Design

• TailWindCSS: A utility-first CSS framework for rapidly building custom user interfaces.
• DaisyUI: A plugin for Tailwind CSS that adds new utilities, components, and a dark mode.
• HyeprUI: A UI library for modern web applications.

---

Third Party APIs

• Gmail API: Allows interaction with Gmail, enabling functionalities like sending emails, reading emails, and more.
• Discord API: Enables interaction with Discord, allowing functionalities like sending messages, managing servers, and more.

---

Extensions & Tools

• Firebase Extensions: Pre-packaged solutions that help developers add common functionality to their apps quickly and safely.

---