Careers Management System for Schools

⚠️ 19 September 2024: We're back for some heavy work ths year ⚠️

⚠️ Warning ⚠️

This repository contains the source code of carrieres.inpt.ac.ma, backed by proprietary code. 
The license does not permit hosting it yourself.
The code is open for the sake of transparency and allowing contributions.

✅ If you have contributed to this repository, you can use the platfrom freely with no restrictions. ✅ These are our policies today and may change in the future. If you are interested in using this platform for your organization, please contact the author at m@meliani.xyz.

⚠️ Annother Warning: This Repository is Under Active Development ⚠️

Please note that this repository is currently in development. 
You may encounter bugs, incomplete features, or other issues.
Be prepared for frequent updates and changes.
Contributions, feedback, and bug reports are welcome. Thank you for your understanding!

What is that?

A platform that assists students in finding internships and jobs, while also helping professors manage their students and internships.

Where are we going?

We aim to expand our platform to offer more comprehensive career guidance and resources, fostering stronger connections between students, educators, and employers. Our goal is to become the leading solution for career management in educational institutions, providing seamless support from education to employment.

What's Next?

We are integrating machine learning and smart algorithms to enhance our platform. These advancements will offer personalized internship and job recommendations, predictive career path analysis, and data-driven insights for professors to better support their students' career development.

How to install

1. Clone the repository

git clone --recursive git@github.com:meliani/Career-Center.git

--recursive because I'm using a customized version of Countries package to accurately describe our country. It's hosted as submodule in the packages folder. It's not necessary to use --recursive if you don't want to use the customized version of the package. You can just remove the submodule and install the package from the official repository. You can also remove call to the local repository in the composer.json file.

2. Install the dependencies

cd Career-Center && composer install && npm install

3. Create a database and update the .env file

cp .env.dev .env

4. Generate the application key and run the migrations

php artisan key:generate

php artisan migrate --seed

5. Link the storage folder and run the server

php artisan storage:link

php artisan serve

6. Addons

install fasttext data models

Go somewhere in your server and run comands below Copy the binary and model paths to the .env file

git clone https://github.com/facebookresearch/fastText.git
cd fastText
make

wget https://dl.fbaipublicfiles.com/fasttext/supervised-models/lid.176.bin

If you have trouble with the installation, please send an email to m@meliani.xyz or open an issue.

Features

Quick overview

• Announce internships
• Generate internship agreements
• Generate internship projects
• Assign supervisors to projects
• Assign jury to projects
• Generate jury reports
• Generate calendars for students, supervisors, examiners, and jury
• Internship agreement management
• Send predefined emails to students, supervisors, examiners, and jury
• Send generic emails to students, supervisors, examiners, and jury
• Generate statistics
• Generate charts

For the comlete list look at English docs or French docs

Available charts

• Anounced Internships per Program
  • A chart that shows the number of internships announced per program
• Projects participation by department
  • A chart that shows the number of projects per department
• Internships per department
  • A chart that shows the number of internships per department
• Internships per program
  • A chart that shows the number of internships per program
• Intenships distribution by department
  • A chart that shows the number of internships per department
• Internships distribution by city
  • A chart that shows the number of internships per city
• Internships distribution by country
  • A chart that shows the number of internships per country
• Internships distribution by company
  • A chart that shows the number of internships per company
• Internships by end date
  • A chart that shows the number of internships by end date
• Assigned supervisors per department
  • A chart that shows the number of assigned supervisors per department

Supported browsers, databases, and PHP versions

Check Support.md

contributors

• github.com/meliani
• github.com/copilot

How to contribute

Fork to your account -> Clone locally -> Create Feature Branche -> Make your changes -> push to your github -> Open pull request on main repo

OR

Open an Issue here -> explain your idea or join a gist for example.

OR

Start a topic in discussion panel.

Code quality

will be displayed soon

testing

will be displayed soon

License

Source code in this repository is covered by a proprietary license. The license does not permit hosting it yourself. The code is open for the sake of transparency and allowing contributions.