# MANUEL D'UTILISATION
# Bienvenue😀

My Campus Face est un projet de fin de formation en licence 3 ICT4D qui porte sur la conception d'une application de reconnaissance faciale.

Lien du projet : (https://github.com/Systeme-de-reconnaisance-facial)

## FONCTIONNALITES
L'application a été développée pour faciliter la gestion des control d'access en salle d'examen via la reconnaissance faciale. Ce manuel d'utilisation vous guidera à travers les différentes fonctionnalités de l'application et vous aidera à tirer pleinement parti de ses capacités.

### Etape 1 : Connexion
* Pour accéder à l'application, rendez-vous sur la page de connexion.
* Saisissez vos identifiants (nom d'utilisateur et mot de passe) pour vous connecter à votre compte.
* Si vous n'avez pas de compte, veuillez vous inscrire en suivant les instructions fournies.

* Interface administrateur :
* Une fois connecté en tant qu'administrateur, vous accéderez à l'interface d'administration.
* Cette interface comprend les sections suivantes :
* Etudiant : Consultez et gerer les étudiants enregistrer dans le systeme.
* Examen : Ici nous pourrons creer un nouvelle examen et scanner les etudiant qui ont droit a la compos.
* Users: Gérez les comptes des utilisateurs de l'application.

### Etape 2 : Fonctionnalités de l'administrateur :
* Gestion des etudiant:
* Dans la section "Etudiant", vous pouvez voir la liste d'étudiants.
Sélectionnez un etudiant pour afficher les details sur lui.

* Toujour dans la section etudiant nous avons la posibilite de mettre a jour les information d'un etudiant , ajouter et supprimer un etudiant du systeme.
* Control d'Access :
* Dans l'onglet control 'Examen' vous pouvez lancer le control d'access a la salle pour verifier si les visage scanner ont access a la salle.

* Gestion des utilisateurs :
* Dans la section "Users", vous pouvez ajouter, supprimer ou modifier les comptes des utilisateurs de l'application.

### * Etape 3 : Different acteur du systeme :
* Auteurs(Enseignant/surveillant) :
Qui dit mémoire implique des auteurs ici ont peut retrouver de 1-7 auteur avec les encadreur i compris . Dans cette Platform l’auteur est celui qui a la possibilité du publie sont mémoire. Mais avant de pouvoir etre un auteur quelque condition dois etre satisfait ,cette a dire

* Avoir sont mémoire sur forme pdf
* Avoir une attestions de soutenance de correction
* Un document qui prouve qu’il est bien étudient

### Etape 4 : Administrateur(Gérant du systeme de reconnaissance et control access):
Dans chaque Platform ou application ont i retrouve toujours quelqu’un qui dois gère l’organisation et le bien-être de celle si . dans notre cas administrateur est celui qui serait le plus haut place dans la Platform , il aura la possibilte de faire certain operation telque ajouter d'autres utilisateur qui pourrons utiliser l'application.
Mais quelqu’un condition dois etre satisfait avant d’etre administrateur ,telque

* Etre un gestionnaire aux sien de l'etablissement
* Etre responsable d'un departement au sein de l'universite

## INSTALLATION ET PARAMETRAGE

Ce projet est destiné à la reconnaissance facial et control d'access au salle d'examen.

### Etape 1 : Presentation de la base de donnees
1. Admin
2. User table
3. Etudiant table
4. Reconnu

### Etape 2 : Package install
1.python 3
2.node js
3.openCv
4.DeepFace
5.numpy
6.flask
### Etape 3 : comment lancer l'application
1. Clone the repository frontend and backend from the above github link
2. Install all the necessary packages by: `$ pip install` follow by the package name for backend or `$ npm install ` from end
3.
4. Run npm ins: `$ php artisan key:generate`
5. Run the migration (create the database): `$ php artisan migrate`
6. Insert dumy data: `$ php artisan db:seed`
7. Run the backend app: `$ php artisan serve` and launch your browser on the url from your local machine
8. Run the FrontEnd app: `$ npm install`
8. To run vite :`$ npm run` and launch your browser on the url from your local machine
9. Enjoy !!!

### Etape 4 : How to configure your email credential in the project for mail operation
1. open your .env file
2. Add the followinf code in it will your gmail information
MAIL_MAILER=smtp
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
MAIL_USERNAME=your_gmail_username
MAIL_PASSWORD=your_gmail_password
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=your_email_address
MAIL_FROM_NAME="${APP_NAME}"
3. Replace your_gmail_username with your Gmail username, and your_gmail_password with your Gmail password. Also, make sure to update your_email_address with your own email address.
4. Note that if you're using two-factor authentication for your Gmail account, you'll need to generate an "App Password" and use that instead of your regular password.

#### Code source

- Application web : https://github.com/konnofuente/Team4-Plateforme-de-l-ecole-doctorale-Module-de-publication-des-travaux-des-etudiants

### Etape 5 : Quelques commandes
1. for create controller => php artisan make:controller Api\UserController
2. for create model and migration => php artisan make:model DOc -m
3. for create a seeder => php artisan make:seeder UsersTableSeeder
4. for apply seeder in database => php artisan migrate:fresh --seed
5. for fresh all route and clear cash => php artisan optimize
6. for create a middleware => php artisan make:middleware AdminMiddleware
7. for create model => php artisan make:model contact
8. for make seed => php artisan migrate:fresh --seed
9. for specific seed => php artisan migrate:fresh --seed --seeder=UserSeeder
10. for adding toast => composer require brian2694/laravel-toastr

## EQUIPE DE DEVELOPPEMENT

L'équipe de développement est constituée de :

==> NYOBE DJOB ELIE THOMAS [e-mail]
==> MBIADA FOSSO CEDRIC GEORDAN [e-mail]
==> DIEMBO PEKA IVAN DAMIEN [e-mail]

#### Technologies et outils utilisées

- Framework backend flask
- SQLite pour la gestion de la base de donnee
- Bootstrap 4 et Javascript
- Java Android