A grade-tracking application designed to help coaches, trainers, and apprentices efficiently monitor and communicate grades and training progress, while following the existing conventions for grade reporting and training documentation.
Source-workflow is detailed in the workflows directory
W.I.P
- PHP 8.3+
- Composer
- Docker & Docker Compose (for Sail)
- Move inside repository directory and install PHP dependencies
Install PHP dependencies using composer. We ignore platform requirement because dependencies are managed through sail.
cd apprentice-cursus
composer install --ignore-platform-reqs- Copy the environment file and run containers
cp .env.example .env
./vendor/bin/sail up -d- Generate a key
./vendor/bin/sail artisan key:generate- Run database migrations
./vendor/bin/sail artisan migrate- Install JS dependencies and start Vite
./vendor/bin/sail pnpm installYou can safely ignore the build script for vue-demi, it's not needed in this version of the project.
- Run the app in your web browser Launch the local server using
./vendor/bin/sail pnpm devThe app should now be available at http://localhost
| Tool | Version |
|---|---|
| Vue | 3.x |
| Laravel | 13.x |
| Inertia | latest |
| Vite | 8.x |
| Tailwind | 4.x |
| shadcn-vue | latest |
| PostgreSQL | latest |
Application distinguish in two main features: a grade managment tool and a formation file managment tool
Source : Nommage et envoi des notes
Apprentices will be able to drag and drop their test PDF in the app. A notification will then be sent to both their trainers and assigned coaches.
The grades will be accessible in dashboard, giving apprentices an overview of their own grades, and trainers / coaches an overview of the grades of apprentice they're responsible of.
Trainers and coaches will be able to add commentaries to apprentice grades. They also will be able to download the PDF of the test
Apprentice need to complete a formation file during their cursus, so if something happen that could endanger their formation, they can justify with their formation file.
Source : Création et maintenance du dossier de formation
An apprentice can access and update their formation file via a dedicated form, featuring all the required shield.
Apprentice, coaches and trainers are able to see overview of formation file. They can also download that preview, taking the shape of a PDF files.
Trainers and coaches are able to add commentary to part of the project, so apprentice can come back to modify required part or discuss with coaches / trainers.
For some event, notification may be useful and sent via email to users, so they know when they need to act on something, read something etc.