This Laravel project aims to enhance the logbook implementation and organization process for practical training. It provides a comprehensive system for students to submit daily logbook entries, generate reports, and receive feedback from their supervisors. Additionally, supervisors have access to a dedicated dashboard to review and manage the submitted logbooks.On top of that there is an organization dashboard dedicated for organizations where they can select the number of students they want for practical training
To set up and run the Practical Training Management System on your local machine, follow these steps:
- Clone the repository to your local environment:
git clone https://github.com/PTMS.git
- Navigate to the project directory:
cd PTMS
- Install the project dependencies using Composer:
composer install
- Copy the
.env.example
file to create a new.env
file:
cp .env.example .env
- Generate an application key:
php artisan key:generate
-
Configure the database settings in the
.env
file, including the database connection, host, username, password, and database name. -
Run the database migrations to set up the required tables:
php artisan migrate
- Seed the database with sample data:
php artisan db:seed
- Serve the application locally:
php artisan serve
- And run npm run dev Serve :
npm run dev
- Access the application by visiting
http://localhost:8000
in your web browser.
Once the application is installed and running, follow these steps to set up and utilize the logbook management features:
-
Sign in as a student or supervisor using the provided login form. use username: [email protected] password: 12345678
-
As a student, you can add new logbook entries by navigating to the "Logbook" section and filling out the necessary details such as the date and activity description. Submit the logbook entry to save it.
-
Students can view and manage their submitted logbooks in the "My Logbooks" section. They can edit, delete, and download their logbook entries as required.
-
Supervisors have access to the supervisor dashboard, where they can review all the logbooks submitted by students. The dashboard provides a summary view of logbooks grouped by week number, displaying the last modification date and the start and end dates of each week. Access the supervisor dashboard from
http://localhost:8000/supervisor
-
Supervisors can click on individual logbooks to view the details, including the student's name, submission date, logbook entries, and any attachments. They can provide feedback and comments to the students as necessary.
-
Notifications are sent to both students and supervisors when logbooks are submitted or when feedback/comments are received.
-
To access the organization dashboard go to
http://localhost:8000/organization
orhttp://localhost:8000/signup
where you'll create an organization account and go tohttp://localhost:8000/signin
and sign in