GD Evaluation System - Frontend

A comprehensive web-based platform for evaluating and managing Group Discussion (GD) sessions. This system streamlines the assessment process for educational institutions, recruitment processes, and training programs.

🌟 Features

• Real-time Evaluation: Score participants across multiple criteria during live group discussions
• Multi-parameter Assessment: Evaluate communication skills, leadership, knowledge, teamwork, and presentation
• User Management: Separate dashboards for administrators, evaluators, and participants
• Session Management: Create, schedule, and manage multiple GD sessions
• Analytics Dashboard: View detailed performance metrics and comparative analysis
• Report Generation: Automated evaluation reports with comprehensive insights
• Responsive Design: Seamless experience across desktop, tablet, and mobile devices

🚀 Tech Stack

• Frontend Framework: React.js, TypeScript
• State Management: Redux / Vuex / Context API
• UI Library: Tailwind CSS
• HTTP Client: Axios
• Routing: React Router / Vue Router
• Build Tool: Vite / Webpack
• Testing: Jest, React Testing Library

📋 Prerequisites

Before you begin, ensure you have the following installed:

• Node.js (v14.0 or higher)
• npm (v6.0 or higher) or yarn (v1.22 or higher)
• Git

🔧 Installation

1. Clone the repository

git clone https://github.com/Nikhil-coder390/GdEvaluationSystemFrontend.git
cd GdEvaluationSystemFrontend

2. Install dependencies

npm install
# or
yarn install

3. Create environment variables file

cp .env.example .env

4. Configure environment variables

REACT_APP_API_URL=http://localhost:5000/api
REACT_APP_ENV=development

5. Start the development server

npm start
# or
yarn start

The application will open at http://localhost:3000

📦 Build for Production

npm run build
# or
yarn build

The optimized production build will be created in the build/ directory.

🗂️ Project Structure

GdEvaluationSystemFrontend/
├── public/
│   ├── index.html
│   └── assets/
├── src/
│   ├── components/
│   │   ├── common/
│   │   ├── evaluation/
│   │   ├── session/
│   │   └── user/
│   ├── pages/
│   │   ├── Dashboard.jsx
│   │   ├── Login.jsx
│   │   ├── Evaluation.jsx
│   │   └── Reports.jsx
│   ├── services/
│   │   ├── api.js
│   │   └── auth.js
│   ├── store/
│   │   ├── actions/
│   │   └── reducers/
│   ├── utils/
│   ├── App.js
│   └── index.js
├── .env.example
├── package.json
└── README.md

🎯 Key Modules

1. Authentication

• User login/logout
• Role-based access control (Admin, Evaluator, Participant)
• JWT token management

2. Session Management

• Create new GD sessions
• Schedule and configure sessions
• Participant allocation

3. Evaluation System

• Real-time scoring interface
• Multiple evaluation parameters:
  • Communication Skills
  • Leadership Quality
  • Subject Knowledge
  • Team Player Ability
  • Body Language & Confidence
  • Logical Reasoning

4. Analytics & Reports

• Individual performance reports
• Comparative analysis
• Export to PDF/Excel
• Historical data visualization

🔐 User Roles

• Admin: Full system access, user management, configuration
• Evaluator: Create sessions, evaluate participants, view reports
• Participant: View assigned sessions, access personal performance reports

🌐 API Integration

This frontend connects to the GD Evaluation System Backend API. Ensure the backend is running and properly configured.

Backend repository: [Link to backend repo]

API Documentation: [Link to API docs]

🧪 Testing

Run the test suite:

npm test
# or
yarn test

Run tests with coverage:

npm test -- --coverage
# or
yarn test --coverage

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👤 Author

Nikhil

• GitHub: @Nikhil-coder390

---

⭐ If you find this project useful, please consider giving it a star!