Backend Setup for OpenSoft 2024 Project

This README provides instructions on how to set up and run the backend for the OpenSoft 2024 project using Go and the Gin web framework.

Prerequisites

• Go (version 1.14 or later)
• Git (for version control)

Setup Instructions

1. Clone the Repository

   Clone the project repository to your local machine using Git:

   git clone https://github.com/[your-username]/opensoft-2024.git
   cd opensoft-2024

   Replace [your-username] with your actual GitHub username or organization where the repository is hosted.

2. Install Dependencies

   Navigate to the backend directory and install the necessary Go modules:

   cd backend
   go mod tidy

   go mod tidy will automatically add missing and remove unused modules.

3. Configuration

   Before running the server, ensure that you have the necessary configuration in place. The database credentials are stored in the db.go file. Make sure to review and update these credentials according to your database setup.

4. Running the Server

   Start the backend server using the following command:

   go run main.go

   This will start the server on localhost:8080 and will include the following routes for CRUD operations:

   [Routes details omitted for brevity]

5. Security Warning

   Be aware of the security implications of trusting all proxies. For production, configure the trusted proxies appropriately. Refer to the official Gin documentation for more details.

Frontend Setup for OpenSoft 2024 Project

This section provides instructions on how to set up and run the frontend for the OpenSoft 2024 project using React and Vite.

Prerequisites

• Node.js
• npm (or Yarn)

Setup Instructions

1. Navigate to the Frontend Directory

   If you are in the project's root directory:

   cd frontend

2. Install Vite (If Not Already Installed)

   npm install -g create-vite

3. Create a New React Project (If Starting From Scratch)

   npm create vite@latest my-react-app -- --template react
   cd my-react-app

4. Install Dependencies

   npm install

5. Configure the Development Server

   To use port 5173, modify vite.config.js:

   import { defineConfig } from 'vite';
   import react from '@vitejs/plugin-react';
   
   export default defineConfig({
     plugins: [react()],
     server: {
       port: 5173
     }
   });

6. Run the Frontend Development Server

   Start the server with:

   npm run dev

   The React application will now be running on http://localhost:5173.

Steps to Run the Frontend

To run the frontend of the OpenSoft 2024 project, navigate to the frontend directory, install the dependencies if not done already, and start the development server:

1. Open a terminal and navigate to the frontend directory of your project.
2. Install the necessary dependencies by running npm install.
3. Start the development server on the specified port (5173) with npm run dev.
4. Access the frontend in your browser at http://localhost:5173.

Steps to setup environment (.env)

1. Make a .env in both Frontend and backend
2. Declare DB_CONN and OPENAI_KEY keys in the backend .env and put the Mongodb Atlas database link and your openai key to generate embeddings respectively.
3. Declare VITE_BHOST and VITE_WS_HOST in Frontend env and put backend hosted link and websocket url respectively.