From 5b01f2e9f4d27f7b80d33950a2aa63f3227baa7c Mon Sep 17 00:00:00 2001 From: T'JAMPENS QUENTIN p2406187 Date: Mon, 17 Nov 2025 22:32:30 +0100 Subject: [PATCH 1/4] Update doc --- tests/Logout.bru | 7 +++++++ tests/Users/Create user.bru | 6 +++++- tests/Users/Delete user by id.bru | 19 ++++++++++++++++++- tests/Users/Delete user.bru | 8 ++++++++ tests/Users/Get User.bru | 7 ++++++- tests/Users/Modify user role.bru | 15 ++++++++++++++- tests/Users/Update User.bru | 10 ++++++++-- tests/Users/Validate User.bru | 18 +++++++++++++++++- tests/Users/get all users.bru | 6 ++++++ tests/get CSRF.bru | 6 ++++++ tests/me.bru | 12 +++++++++++- 11 files changed, 106 insertions(+), 8 deletions(-) diff --git a/tests/Logout.bru b/tests/Logout.bru index a1842f3..56641ec 100644 --- a/tests/Logout.bru +++ b/tests/Logout.bru @@ -23,3 +23,10 @@ settings { encodeUrl: true timeout: 0 } + +docs { + # /users/logout + + Permet de se déconnecter. + Supprime le remember_token et cookies de connexions. +} diff --git a/tests/Users/Create user.bru b/tests/Users/Create user.bru index 0fedbfc..4046e53 100644 --- a/tests/Users/Create user.bru +++ b/tests/Users/Create user.bru @@ -40,5 +40,9 @@ settings { } docs { - Créer un utilisateur test + # /users/register + + Permet de créer un compte utilisateur. + + Entrées: name, lastname, email, password } diff --git a/tests/Users/Delete user by id.bru b/tests/Users/Delete user by id.bru index 633709f..ed767dc 100644 --- a/tests/Users/Delete user by id.bru +++ b/tests/Users/Delete user by id.bru @@ -5,7 +5,7 @@ meta { } delete { - url: {{url}}/api/users/7 + url: {{url}}/api/users/{{id}} body: none auth: inherit } @@ -14,7 +14,24 @@ headers { X-XSRF-TOKEN: } +vars:pre-request { + id: 2 +} + settings { encodeUrl: true timeout: 0 } + +docs { + # /users/id + + + Permet de supprimer un compte utilisateur + + La connexion est obligatoire, les cookies de connexions/XSRF doivent être présents. + + L'utilisateur doit être admin poir supprimer un autre compte utilisateur. + + Entrée: id +} diff --git a/tests/Users/Delete user.bru b/tests/Users/Delete user.bru index 95fee60..281942f 100644 --- a/tests/Users/Delete user.bru +++ b/tests/Users/Delete user.bru @@ -19,3 +19,11 @@ settings { encodeUrl: true timeout: 0 } + +docs { + # /users -- DELETE + + Permet de supprimer le compte de l'utilisateur actuellement connecté. + + La connexion est obligatoire, les cookies de connexions/XSRF doivent être présents. +} diff --git a/tests/Users/Get User.bru b/tests/Users/Get User.bru index d0f618e..058c093 100644 --- a/tests/Users/Get User.bru +++ b/tests/Users/Get User.bru @@ -5,11 +5,15 @@ meta { } get { - url: {{url}}/api/users/5 + url: {{url}}/api/users/{{id}} body: none auth: inherit } +vars:pre-request { + id: 2 +} + settings { encodeUrl: true timeout: 0 @@ -18,6 +22,7 @@ settings { docs { Permet de récupérer les informations d'un utilisateur. Authetification demandée + Cookies de connexion/XSRF requis. /api/users/{ID} diff --git a/tests/Users/Modify user role.bru b/tests/Users/Modify user role.bru index 8d95cef..fbf78b8 100644 --- a/tests/Users/Modify user role.bru +++ b/tests/Users/Modify user role.bru @@ -5,7 +5,7 @@ meta { } post { - url: {{url}}/api/users/5/role + url: {{url}}/api/users/{{id}}/role body: json auth: inherit } @@ -23,6 +23,7 @@ body:json { vars:pre-request { role: 2 + id: 2 } assert { @@ -33,3 +34,15 @@ settings { encodeUrl: true timeout: 0 } + +docs { + # /users/id/role + + Permet de modifier le rôle d'un utilisateur. + + La connexion est obligatoire, les cookies de connexions/XSRF doivent être présents. + + L'utilisateur doit être admin pour modifier le rôle d'un utilisateur. + + Entrées: id, role +} diff --git a/tests/Users/Update User.bru b/tests/Users/Update User.bru index 0c10882..85ba0e1 100644 --- a/tests/Users/Update User.bru +++ b/tests/Users/Update User.bru @@ -39,7 +39,13 @@ settings { } docs { - Permet de modifier le nom, le prenom et le numéro de téléphone de l'utilisateur + # /users/update - le nom, le prenom et le numéro sont requis en entrée (même si pas modifié) + Permet de modifier les données de l'utilisateur actuellement connecté. + + La connexion est obligatoire, les cookies de connexions/XSRF doivent être présents. + + Entrées: name, lastname, phone + + Toutes les données d'entrées sont requises, même celles non modifiées. } diff --git a/tests/Users/Validate User.bru b/tests/Users/Validate User.bru index dfe4089..3077122 100644 --- a/tests/Users/Validate User.bru +++ b/tests/Users/Validate User.bru @@ -5,7 +5,7 @@ meta { } post { - url: {{url}}/api/users/5/validate + url: {{url}}/api/users/{{id}}/validate body: none auth: inherit } @@ -15,7 +15,23 @@ headers { X-XSRF-TOKEN: } +vars:pre-request { + id: 2 +} + settings { encodeUrl: true timeout: 0 } + +docs { + # /users/id/validate + + Permet de valider l'inscription d'un nouvel utilisateur. + + La connexion est obligatoire, les cookies de connexions/XSRF doivent être présents. + + L'utilisateur doit être admin pour valider un autre utilisateur + + Entrée: id: identifiant de l'utilisateur qui va être validé. +} diff --git a/tests/Users/get all users.bru b/tests/Users/get all users.bru index d2227be..ac9cc71 100644 --- a/tests/Users/get all users.bru +++ b/tests/Users/get all users.bru @@ -14,3 +14,9 @@ settings { encodeUrl: true timeout: 0 } + +docs { + # /users + + Permet de récupérer tous les IDs des utilisateurs. +} diff --git a/tests/get CSRF.bru b/tests/get CSRF.bru index cc6845b..713d9bc 100644 --- a/tests/get CSRF.bru +++ b/tests/get CSRF.bru @@ -18,3 +18,9 @@ settings { encodeUrl: true timeout: 0 } + +docs { + # /csrf-cookie + + Renvoi le cookie XSRF permettant de se connecter et de faire des requêtes afin d'éviter les failles CSRF. +} diff --git a/tests/me.bru b/tests/me.bru index c75a494..a3193de 100644 --- a/tests/me.bru +++ b/tests/me.bru @@ -5,7 +5,7 @@ meta { } get { - url: {{url}}/api/me + url: {{url}}/api/users/me body: none auth: inherit } @@ -22,3 +22,13 @@ settings { encodeUrl: true timeout: 0 } + +docs { + # /me + + Renvoi l'utilisateur acutllement connecté. + + La connexion est obligatoire, les cookies de connexions/XSRF doivent être présents. + + Renvoi un objet avec les informations de l'utilisateur +} From 67048d7f4bfc55e90c7e4e10ad94372e8484cf4f Mon Sep 17 00:00:00 2001 From: T'JAMPENS QUENTIN p2406187 Date: Mon, 17 Nov 2025 22:35:09 +0100 Subject: [PATCH 2/4] Add methods --- tests/Login.bru | 3 ++- tests/Logout.bru | 2 +- tests/Users/Create user.bru | 2 +- tests/Users/Delete user by id.bru | 2 +- tests/Users/Get User.bru | 2 ++ tests/Users/Modify user role.bru | 2 +- tests/Users/Update User.bru | 2 +- tests/Users/Validate User.bru | 2 +- tests/Users/get all users.bru | 2 +- tests/get CSRF.bru | 2 +- tests/me.bru | 2 +- 11 files changed, 13 insertions(+), 10 deletions(-) diff --git a/tests/Login.bru b/tests/Login.bru index 009e155..d416cb9 100644 --- a/tests/Login.bru +++ b/tests/Login.bru @@ -38,8 +38,9 @@ settings { } docs { - Permet de se connecter + # /users/login -- POST + Permet de se connecter Le header X-XSRF-TOKEN est obligatoire. Pour le récupérer: diff --git a/tests/Logout.bru b/tests/Logout.bru index 56641ec..f8dbd6c 100644 --- a/tests/Logout.bru +++ b/tests/Logout.bru @@ -25,7 +25,7 @@ settings { } docs { - # /users/logout + # /users/logout -- POST Permet de se déconnecter. Supprime le remember_token et cookies de connexions. diff --git a/tests/Users/Create user.bru b/tests/Users/Create user.bru index 4046e53..516fdbd 100644 --- a/tests/Users/Create user.bru +++ b/tests/Users/Create user.bru @@ -40,7 +40,7 @@ settings { } docs { - # /users/register + # /users/register -- POST Permet de créer un compte utilisateur. diff --git a/tests/Users/Delete user by id.bru b/tests/Users/Delete user by id.bru index ed767dc..0881bd5 100644 --- a/tests/Users/Delete user by id.bru +++ b/tests/Users/Delete user by id.bru @@ -24,7 +24,7 @@ settings { } docs { - # /users/id + # /users/id -- DELETE Permet de supprimer un compte utilisateur diff --git a/tests/Users/Get User.bru b/tests/Users/Get User.bru index 058c093..44eaf9b 100644 --- a/tests/Users/Get User.bru +++ b/tests/Users/Get User.bru @@ -20,6 +20,8 @@ settings { } docs { + # /users/id -- GET + Permet de récupérer les informations d'un utilisateur. Authetification demandée Cookies de connexion/XSRF requis. diff --git a/tests/Users/Modify user role.bru b/tests/Users/Modify user role.bru index fbf78b8..be141c3 100644 --- a/tests/Users/Modify user role.bru +++ b/tests/Users/Modify user role.bru @@ -36,7 +36,7 @@ settings { } docs { - # /users/id/role + # /users/id/role -- POST Permet de modifier le rôle d'un utilisateur. diff --git a/tests/Users/Update User.bru b/tests/Users/Update User.bru index 85ba0e1..6cadac8 100644 --- a/tests/Users/Update User.bru +++ b/tests/Users/Update User.bru @@ -39,7 +39,7 @@ settings { } docs { - # /users/update + # /users/update -- POST Permet de modifier les données de l'utilisateur actuellement connecté. diff --git a/tests/Users/Validate User.bru b/tests/Users/Validate User.bru index 3077122..4654c49 100644 --- a/tests/Users/Validate User.bru +++ b/tests/Users/Validate User.bru @@ -25,7 +25,7 @@ settings { } docs { - # /users/id/validate + # /users/id/validate -- POST Permet de valider l'inscription d'un nouvel utilisateur. diff --git a/tests/Users/get all users.bru b/tests/Users/get all users.bru index ac9cc71..359aff1 100644 --- a/tests/Users/get all users.bru +++ b/tests/Users/get all users.bru @@ -16,7 +16,7 @@ settings { } docs { - # /users + # /users -- GET Permet de récupérer tous les IDs des utilisateurs. } diff --git a/tests/get CSRF.bru b/tests/get CSRF.bru index 713d9bc..2b4b6bd 100644 --- a/tests/get CSRF.bru +++ b/tests/get CSRF.bru @@ -20,7 +20,7 @@ settings { } docs { - # /csrf-cookie + # /csrf-cookie -- GET Renvoi le cookie XSRF permettant de se connecter et de faire des requêtes afin d'éviter les failles CSRF. } diff --git a/tests/me.bru b/tests/me.bru index a3193de..1ff5838 100644 --- a/tests/me.bru +++ b/tests/me.bru @@ -24,7 +24,7 @@ settings { } docs { - # /me + # /me -- GET Renvoi l'utilisateur acutllement connecté. From dea69e018e4db5952243c46319461e2a663116af Mon Sep 17 00:00:00 2001 From: T'JAMPENS QUENTIN p2406187 Date: Mon, 17 Nov 2025 22:40:08 +0100 Subject: [PATCH 3/4] Remove vars values + move headers to collection headers --- tests/Events/Create event.bru | 21 +++++++++++++++------ tests/Login.bru | 5 ----- tests/Logout.bru | 5 ----- tests/Users/Create user.bru | 12 ++++-------- tests/Users/Delete user by id.bru | 6 +----- tests/Users/Delete user.bru | 5 ----- tests/Users/Get User.bru | 2 +- tests/Users/Modify user role.bru | 9 ++------- tests/Users/Update User.bru | 11 +++-------- tests/Users/Validate User.bru | 7 +------ tests/collection.bru | 1 + tests/me.bru | 4 ---- 12 files changed, 28 insertions(+), 60 deletions(-) diff --git a/tests/Events/Create event.bru b/tests/Events/Create event.bru index 0aef09b..ef54568 100644 --- a/tests/Events/Create event.bru +++ b/tests/Events/Create event.bru @@ -10,10 +10,6 @@ post { auth: inherit } -headers { - X-XSRF-TOKEN: -} - body:json { { "name": "{{name}}", @@ -22,8 +18,8 @@ body:json { } vars:pre-request { - name: Mon super event - description: Ma super description + name: + description: } assert { @@ -34,3 +30,16 @@ settings { encodeUrl: true timeout: 0 } + +docs { + # /events/create -- POST + + Permet de créer un événement. + + La connexion est obligatoire, les cookies de connexions/XSRF doivent être présents. + + L'utilisateur doit être admin pour créer un événement + + Entrée: nom, description + +} diff --git a/tests/Login.bru b/tests/Login.bru index d416cb9..163ee26 100644 --- a/tests/Login.bru +++ b/tests/Login.bru @@ -10,11 +10,6 @@ post { auth: none } -headers { - X-XSRF-TOKEN: - Accept: application/json -} - body:json { { "email": "{{email}}", diff --git a/tests/Logout.bru b/tests/Logout.bru index f8dbd6c..82691a8 100644 --- a/tests/Logout.bru +++ b/tests/Logout.bru @@ -10,11 +10,6 @@ post { auth: inherit } -headers { - X-XSRF-TOKEN: - Accept: application/json -} - assert { res.status: eq 200 } diff --git a/tests/Users/Create user.bru b/tests/Users/Create user.bru index 516fdbd..bea56af 100644 --- a/tests/Users/Create user.bru +++ b/tests/Users/Create user.bru @@ -10,10 +10,6 @@ post { auth: inherit } -headers { - Accept: application/json -} - body:json { { "name": "{{name}}", @@ -24,10 +20,10 @@ body:json { } vars:pre-request { - name: test - email: test@test.com - password: test - lastname: NAME + name: + email: + password: + lastname: } assert { diff --git a/tests/Users/Delete user by id.bru b/tests/Users/Delete user by id.bru index 0881bd5..f35ca22 100644 --- a/tests/Users/Delete user by id.bru +++ b/tests/Users/Delete user by id.bru @@ -10,12 +10,8 @@ delete { auth: inherit } -headers { - X-XSRF-TOKEN: -} - vars:pre-request { - id: 2 + id: } settings { diff --git a/tests/Users/Delete user.bru b/tests/Users/Delete user.bru index 281942f..2479dd4 100644 --- a/tests/Users/Delete user.bru +++ b/tests/Users/Delete user.bru @@ -10,11 +10,6 @@ delete { auth: inherit } -headers { - Accept: application/json - X-XSRF-TOKEN: -} - settings { encodeUrl: true timeout: 0 diff --git a/tests/Users/Get User.bru b/tests/Users/Get User.bru index 44eaf9b..300d56d 100644 --- a/tests/Users/Get User.bru +++ b/tests/Users/Get User.bru @@ -11,7 +11,7 @@ get { } vars:pre-request { - id: 2 + id: } settings { diff --git a/tests/Users/Modify user role.bru b/tests/Users/Modify user role.bru index be141c3..da9aed1 100644 --- a/tests/Users/Modify user role.bru +++ b/tests/Users/Modify user role.bru @@ -10,11 +10,6 @@ post { auth: inherit } -headers { - Accept: application/json - X-XSRF-TOKEN: -} - body:json { { "role": {{role}} @@ -22,8 +17,8 @@ body:json { } vars:pre-request { - role: 2 - id: 2 + role: + id: } assert { diff --git a/tests/Users/Update User.bru b/tests/Users/Update User.bru index 6cadac8..ef236e9 100644 --- a/tests/Users/Update User.bru +++ b/tests/Users/Update User.bru @@ -10,11 +10,6 @@ post { auth: inherit } -headers { - Accept: application/json - X-XSRF-TOKEN: -} - body:json { { "name": "{{name}}", @@ -24,9 +19,9 @@ body:json { } vars:pre-request { - name: testUpdated - lastname: testUpdated - phone: 0607080910 + name: + lastname: + phone: } assert { diff --git a/tests/Users/Validate User.bru b/tests/Users/Validate User.bru index 4654c49..689621b 100644 --- a/tests/Users/Validate User.bru +++ b/tests/Users/Validate User.bru @@ -10,13 +10,8 @@ post { auth: inherit } -headers { - Accept: application/json - X-XSRF-TOKEN: -} - vars:pre-request { - id: 2 + id: } settings { diff --git a/tests/collection.bru b/tests/collection.bru index 9220456..8e9945d 100644 --- a/tests/collection.bru +++ b/tests/collection.bru @@ -1,3 +1,4 @@ headers { Accept: application/json + X-XSRF-TOKEN: } diff --git a/tests/me.bru b/tests/me.bru index 1ff5838..3fc87b7 100644 --- a/tests/me.bru +++ b/tests/me.bru @@ -10,10 +10,6 @@ get { auth: inherit } -headers { - Accept: application/json -} - assert { res.status: eq 200 } From fdc4819c2e3fde5b250c72c6c4066f7601208149 Mon Sep 17 00:00:00 2001 From: T'JAMPENS QUENTIN p2406187 Date: Mon, 17 Nov 2025 22:51:25 +0100 Subject: [PATCH 4/4] Update README.md --- README.md | 70 +++++++++++++------------------------------------------ 1 file changed, 16 insertions(+), 54 deletions(-) diff --git a/README.md b/README.md index 75c347a..aa81d37 100644 --- a/README.md +++ b/README.md @@ -1,61 +1,23 @@

Laravel Logo

-

-Build Status -Total Downloads -Latest Stable Version -License -

+[Frontend repository](https://iutbg-gitlab.iutbourg.univ-lyon1.fr/sae-but2/2025-26/gestion-benevoles-association/Frontend) -## About Laravel +# Gestion des bénévoles d'une association -Laravel is a web application framework with expressive, elegant syntax. We believe development must be an enjoyable and creative experience to be truly fulfilling. Laravel takes the pain out of development by easing common tasks used in many web projects, such as: +## Installation -- [Simple, fast routing engine](https://laravel.com/docs/routing). -- [Powerful dependency injection container](https://laravel.com/docs/container). -- Multiple back-ends for [session](https://laravel.com/docs/session) and [cache](https://laravel.com/docs/cache) storage. -- Expressive, intuitive [database ORM](https://laravel.com/docs/eloquent). -- Database agnostic [schema migrations](https://laravel.com/docs/migrations). -- [Robust background job processing](https://laravel.com/docs/queues). -- [Real-time event broadcasting](https://laravel.com/docs/broadcasting). +- [Installer Laravel](https://laravel.com/docs/12.x#installing-php) +- Configurer le projet + - Renommer le fichier `.env.example` en `.env` + - Remplir le `APP_KEY` dans `.env` + - Remplir les paramètres de connexion à la base de données + +Exemple configuration base de donnée (.env) -Laravel is accessible, powerful, and provides tools required for large, robust applications. + DB_CONNECTION=mariadb + DB_HOST=127.0.0.1 + DB_PORT=3306 + DB_DATABASE=sae + DB_USERNAME=root + DB_PASSWORD=root -## Learning Laravel - -Laravel has the most extensive and thorough [documentation](https://laravel.com/docs) and video tutorial library of all modern web application frameworks, making it a breeze to get started with the framework. - -You may also try the [Laravel Bootcamp](https://bootcamp.laravel.com), where you will be guided through building a modern Laravel application from scratch. - -If you don't feel like reading, [Laracasts](https://laracasts.com) can help. Laracasts contains thousands of video tutorials on a range of topics including Laravel, modern PHP, unit testing, and JavaScript. Boost your skills by digging into our comprehensive video library. - -## Laravel Sponsors - -We would like to extend our thanks to the following sponsors for funding Laravel development. If you are interested in becoming a sponsor, please visit the [Laravel Partners program](https://partners.laravel.com). - -### Premium Partners - -- **[Vehikl](https://vehikl.com)** -- **[Tighten Co.](https://tighten.co)** -- **[Kirschbaum Development Group](https://kirschbaumdevelopment.com)** -- **[64 Robots](https://64robots.com)** -- **[Curotec](https://www.curotec.com/services/technologies/laravel)** -- **[DevSquad](https://devsquad.com/hire-laravel-developers)** -- **[Redberry](https://redberry.international/laravel-development)** -- **[Active Logic](https://activelogic.com)** - -## Contributing - -Thank you for considering contributing to the Laravel framework! The contribution guide can be found in the [Laravel documentation](https://laravel.com/docs/contributions). - -## Code of Conduct - -In order to ensure that the Laravel community is welcoming to all, please review and abide by the [Code of Conduct](https://laravel.com/docs/contributions#code-of-conduct). - -## Security Vulnerabilities - -If you discover a security vulnerability within Laravel, please send an e-mail to Taylor Otwell via [taylor@laravel.com](mailto:taylor@laravel.com). All security vulnerabilities will be promptly addressed. - -## License - -The Laravel framework is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).