Skip to content

Latest commit

 

History

126 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌐 Smart Platform for Students’ Practical Training

A full-stack web platform designed to simplify and manage the entire practical training process inside universities. The system connects students, training providers, university supervisors, and administrators in one smart digital environment.


📖 Overview

The Smart Platform for Students’ Practical Training helps universities digitize internship and training workflows by replacing manual processes with an organized and efficient online system.

The platform allows:

  • Students to apply for training opportunities.
  • Training providers to manage applicants and evaluate trainees.
  • University supervisors to monitor student progress.
  • Administrators to control and manage the entire system.

🚀 Main Features

🎓 Students

  • Browse available training opportunities.

  • Get AI-powered internship recommendations based on skills.

  • Upload periodic and final reports directly from the dashboard.

  • Track application status:

    • Pending
    • Accepted
    • Rejected

🏢 Training Providers

  • Publish training opportunities with required skills and details.
  • Manage student applications.
  • Accept or reject applicants.
  • Add evaluations and feedback for trainees.

🏛️ University Supervisors

  • Monitor students’ training progress.
  • Review submitted reports.
  • Approve training hours and reports.

⚙️ Admin

  • Manage all users and roles.
  • Control registrations and account approvals.
  • Activate or deactivate users.

🛠️ Technologies Used

Backend

  • Node.js
  • Express.js
  • MongoDB
  • Mongoose
  • JWT Authentication

Frontend

  • HTML5
  • CSS3
  • JavaScript

UI & Styling

  • Bootstrap
  • Tailwind CSS

Tools

  • Postman
  • Visual Studio Code

✅ Prerequisites

Make sure you have the following installed:

  • Node.js (v16 or later)
  • npm or yarn
  • MongoDB Community Server or MongoDB Atlas
  • Visual Studio Code
  • Live Server Extension (recommended)
  • Postman or API dog (optional for API testing)

⚙️ Installation & Setup

1️⃣ Clone the Repository

git clone <your-repository-link>
cd <repository-name>

2️⃣ Backend Setup

Navigate to the backend folder:

cd backend

Install dependencies:

npm install

Run the development server:

npm run dev

The backend server will usually run on:

http://localhost:3000

3️⃣ Frontend Setup

Navigate to the frontend folder and open:

index.html

Using VS Code:

  • Right click on index.html
  • Select Open with Live Server

Now the frontend should be connected successfully to the backend.


🧱 Project Structure

backend
├── config
├── controllers
├── middlewares
├── models
├── routes
├── utilities
├── app.js
├── index.js
└── package.json

frontend
├── css
├── js
├── index.html
├── login.html
├── student-dashboard.html
├── provider-dashboard.html
├── university-dashboard.html
└── admin-dashboard.html

🔐 Authentication & Authorization

The platform uses:

  • JWT Authentication
  • Role-Based Access Control (RBAC)

Roles include:

  • Student
  • Provider
  • University Supervisor
  • Admin

🤖 AI Recommendation System

The platform includes an AI-powered recommendation feature that suggests suitable training opportunities to students based on:

  • Skills
  • Interests
  • Training requirements

📌 API Features

The backend API supports:

  • Authentication
  • User management
  • Opportunity management
  • Applications system
  • Reports management
  • Evaluations system
  • Dashboard statistics

📷 Screens Included

  • Student Dashboard
  • Provider Dashboard
  • University Dashboard
  • Admin Dashboard
  • Authentication صفحات تسجيل الدخول

👨‍💻 Development Environment

  • Visual Studio Code
  • Postman for API Testing
  • MongoDB Compass

🤝 Contributing

Contributions are welcome!

If you'd like to contribute:

  1. Fork the repository
  2. Create a new branch
  3. Commit your changes
  4. Open a Pull Request

📄 License

This project is an educational open-source project available for learning, development, and improvement.


⭐ Future Improvements

  • Real-time notifications
  • File storage using cloud services
  • Advanced AI recommendation model
  • Mobile application version

👩‍💻 Authors

Developed as a university practical training management system project.

About

Smart internship and practical training management platform for universities with role-based dashboards, and application/report management using Node.js, Express.js, and MongoDB.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Contributors

Languages