Merge branch 'trunk'

fix breeding content value

See merge request ldc-web/projets/nature-eleveurs!26

.browserslistrc

@@ -0,0 +1,5 @@
+# Browsers that we support
+
+last 3 version
+> 0.3%
+not dead # no browsers without security updates

.editorconfig

@@ -3,9 +3,9 @@ root = true
 [*]
 charset = utf-8
 end_of_line = lf
-insert_final_newline = true
-indent_style = space
 indent_size = 4
+indent_style = space
+insert_final_newline = true
 trim_trailing_whitespace = true
 
 [*.md]
@@ -14,8 +14,8 @@ trim_trailing_whitespace = false
 [*.{yml,yaml}]
 indent_size = 2
 
-[*.vue]
-indent_size = 2
-
 [docker-compose.yml]
 indent_size = 4
+
+[*.vue]
+indent_size = 2

.env.example

@@ -17,30 +17,41 @@ DB_PASSWORD=
 
 BROADCAST_DRIVER=log
 CACHE_DRIVER=file
-FILESYSTEM_DRIVER=local
+FILESYSTEM_DISK=local
 QUEUE_CONNECTION=sync
 SESSION_DRIVER=file
 SESSION_LIFETIME=120
 
+MEMCACHED_HOST=127.0.0.1
+
+REDIS_HOST=127.0.0.1
+REDIS_PASSWORD=null
+REDIS_PORT=6379
+
 MAIL_MAILER=smtp
-MAIL_HOST=mailhog
+MAIL_HOST=mailpit
 MAIL_PORT=1025
 MAIL_USERNAME=null
 MAIL_PASSWORD=null
 MAIL_ENCRYPTION=null
-MAIL_FROM_ADDRESS=null
+MAIL_FROM_ADDRESS="hello@example.com"
 MAIL_FROM_NAME="${APP_NAME}"
 
-# Exception Handler
-MAIL_LIST_SERVICEWEB=
-# Google Analytics
-GOOGLE_ANALYTICS_ID=
-# Google Recaptcha
-GOOGLE_RECAPTCHA_PUBLIC=
-GOOGLE_RECAPTCHA_PRIVATE=
-GOOGLE_RECAPTCHA_VERSION=
-# LDC Web Status Checker
-LDC_STATUS_CHECKER_API_KEY="MY_KEY"
-LDC_STATUS_CHECKER_UUID="UUID_PROJECT"
-# LDC Web Admin Secure
-LDC_WEB_API_KEY="MY_KEY"
+# SENTRY
+SENTRY_LARAVEL_DSN=
+
+# MATOMO
+MATOMO_SITE_ID=
+
+# UWIL ADMIN SECURE
+# - LIST SEPARATED WITH ',' (Required)
+UWIL_ADMIN_SECURE_CIDR_LIST=""
+# - LIST SEPARATED WITH ',' (Optional)
+UWIL_ADMIN_SECURE_CIDR_PROJECT_ALLOWED_LIST=""
+
+# SAML
+SAML2_DEFAULT_TENANT_UUID=
+SAML2_SP_CERT_x509=
+SAML2_SP_CERT_PRIVATEKEY=
+SAML2_CONTACT_TECHNICAL_EMAIL=
+SAML2_CONTACT_SUPPORT_EMAIL=

.eslintrc.json

@@ -29,7 +29,14 @@
         "sourceType": "module"
     },
     "plugins": ["vue", "@typescript-eslint"],
-    "ignorePatterns": ["webpack.mix.js", "**/vendor/*.js", "**/vendor/**/*.js"],
+    "ignorePatterns": [
+        "webpack.mix.js",
+        "**/*.php",
+        "**/*.svg",
+        "**/vendor/*.js",
+        "**/vendor/**/*.js",
+        "**/vendor/**/*.scss"
+    ],
     "rules": {
         "indent": ["error", 4, { "SwitchCase": 1 }],
         "linebreak-style": ["error", "unix"],
@@ -37,5 +44,19 @@
         "semi": ["error", "always"],
         "vue/script-indent": ["error", 2, { "baseIndent": 0, "switchCase": 1 }],
         "vue/one-component-per-file": "off"
+    },
+    "settings": {
+        "import/resolver": {
+            "node": {
+                "extensions": [".js", ".vue", ".ts", ".d.ts"]
+            },
+            "alias": {
+                "extensions": [".vue", ".js", ".ts", ".scss", ".d.ts"],
+                "map": [
+                    ["~", "./resources/assets"],
+                    ["@", "./node_modules"]
+                ]
+            }
+        }
     }
 }

.gitattributes

@@ -1,4 +1,4 @@
-* text=auto
+* text=auto eol=lf
 
 *.blade.php diff=html
 *.css diff=css
@@ -8,3 +8,4 @@
 
 /.github export-ignore
 CHANGELOG.md export-ignore
+.styleci.yml export-ignore

.gitignore

@@ -1,25 +1,38 @@
-/node_modules
-/public/hot
-/public/storage
-/public/css
-/public/js
-/public/images
-/public/fonts
-/public/medias
-/public/uploads
-/public/assets
-/public/cache
-/public/mix-manifest.json
-/storage/*.key
-/vendor
 .env
 .env.backup
+.env.production
 .phpunit.result.cache
+.stylelintcache
+/.fleet
+/.idea
+/.phpunit.cache
+/.vscode
+/node_modules
+/bootstrap
+/public/build
+/public/cache
+/public/hot
+# /public/sitemap.xml
+/public/storage
+/storage/*.key
+/vendor
+auth.json
 docker-compose.override.yml
 Homestead.json
 Homestead.yaml
 npm-debug.log
 yarn-error.log
-/.idea
-auth.json
-.vscode
+.npmrc
+
+# Ignore public favicon
+/public/android-chrome-192x192.png
+/public/android-chrome-512x512.png
+/public/apple-touch-icon.png
+/public/browserconfig.xml
+/public/browserconfig.xml
+/public/favicon-16x16.png
+/public/favicon-32x32.png
+/public/favicon.ico
+/public/mstile-150x150.png
+/public/safari-pinned-tab.svg
+/public/site.webmanifest

.gitlab/issue_templates/bug.md

@@ -0,0 +1,11 @@
+## Comportement constaté
+
+
+## Comportement attendu
+
+
+## Solution envisagée
+
+
+## Étapes pour la reproduction du bug
+* 

.gitlab/issue_templates/feature.md

@@ -0,0 +1,7 @@
+## Présentation du besoin
+
+
+## Implémentation
+
+
+## Maquettes, documentations...

.stylelintrc.json

@@ -1,8 +1,16 @@
 {
     "extends": [
+        "stylelint-config-standard-scss",
         "stylelint-config-sass-guidelines",
         "stylelint-config-idiomatic-order"
     ],
+    "plugins": [
+        "stylelint-scss"
+    ],
+    "files": [
+        "**/*.css",
+        "**/*.scss"
+    ],
     "ignoreFiles": [
         "**/vendor/*.css",
         "**/vendor/**/*.css",
@@ -15,13 +23,23 @@
     ],
     "customSyntax": "postcss-scss",
     "rules": {
-        "indentation": 4,
-        "string-quotes": "double",
+        "declaration-property-value-no-unknown": true,
         "selector-max-id": null,
         "color-no-invalid-hex": true,
-        "selector-no-qualifying-type": null,
         "order/properties-alphabetical-order": null,
-        "max-nesting-depth": 10,
-        "selector-max-compound-selectors": 10
+        "max-nesting-depth": 5,
+        "selector-max-compound-selectors": 5,
+        "declaration-colon-newline-after": null,
+        "value-list-comma-newline-after": null,
+        "scss/double-slash-comment-empty-line-before": [
+            "always",
+            {
+                "ignore": [
+                    "between-comments",
+                    "stylelint-commands",
+                    "inside-block"
+                ]
+            }
+        ]
     }
 }

.vscode/settings.json

@@ -19,5 +19,8 @@
         "titleBar.inactiveForeground": "#e7e7e799",
         "commandCenter.border": "#e7e7e799"
     },
-    "peacock.remoteColor": "#342617"
+    "peacock.remoteColor": "#342617",
+    "intelephense.environment.phpVersion": "8.2.0",
+    "intelephense.completion.fullyQualifyGlobalConstantsAndFunctions": true,
+    "intelephense.phpdoc.useFullyQualifiedNames": true
 }

Dockerfile

@@ -1,4 +1,4 @@
-FROM registry.s-web.fr/ldc-web/projets/ldc-web-images-docker/ldcweb-production-7.3:latest
+FROM registry.s-web.fr/ldc-web/projets/ldc-web-images-docker/uwil-production-8.5:${PHP_8_5_TAG}
 COPY --chown=www-data:www-data . /app/srcs
 USER root
 RUN chmod -R 755 /app/srcs/storage

README.md

@@ -1,40 +1,66 @@
-# Nature d'éleveurs
-## Installation
-```
-cp .env.example .env
-php artisan key:generate
-php artisan storage:link
-```
+<p align="center"><a href="https://laravel.com" target="_blank"><img src="https://raw.githubusercontent.com/laravel/art/master/logo-lockup/5%20SVG/2%20CMYK/1%20Full%20Color/laravel-logolockup-cmyk-red.svg" width="400" alt="Laravel Logo"></a></p>
 
-## Front
-```
-npm install && npm run prod
-```
+<p align="center">
+<a href="https://github.com/laravel/framework/actions"><img src="https://github.com/laravel/framework/workflows/tests/badge.svg" alt="Build Status"></a>
+<a href="https://packagist.org/packages/laravel/framework"><img src="https://img.shields.io/packagist/dt/laravel/framework" alt="Total Downloads"></a>
+<a href="https://packagist.org/packages/laravel/framework"><img src="https://img.shields.io/packagist/v/laravel/framework" alt="Latest Stable Version"></a>
+<a href="https://packagist.org/packages/laravel/framework"><img src="https://img.shields.io/packagist/l/laravel/framework" alt="License"></a>
+</p>
 
-## Commands
-```
-php artisan user:create for create admin account
-```
+## About Laravel
 
-## Crons
-Put every min in PROD :
-```
-php artisan schedule:run
-```
+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:
 
-### LDC Web Status Report
-#### Available Commands
-```
-ldc:status-report
-ldc:send-status-report
-```
-### LDC Web Admin Secure
-#### Available Commands
-```
-ldcweb:admin-secure-sync
-```
-### Refresh-Sitemap
-#### Available Commands
-```
-sitemap:refresh --dry-run
-```
+- [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).
+
+Laravel is accessible, powerful, and provides tools required for large, robust applications.
+
+## 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 over 2000 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 [Patreon page](https://patreon.com/taylorotwell).
+
+### Premium Partners
+
+- **[Vehikl](https://vehikl.com/)**
+- **[Tighten Co.](https://tighten.co)**
+- **[Kirschbaum Development Group](https://kirschbaumdevelopment.com)**
+- **[64 Robots](https://64robots.com)**
+- **[Cubet Techno Labs](https://cubettech.com)**
+- **[Cyber-Duck](https://cyber-duck.co.uk)**
+- **[Many](https://www.many.co.uk)**
+- **[Webdock, Fast VPS Hosting](https://www.webdock.io/en)**
+- **[DevSquad](https://devsquad.com)**
+- **[Curotec](https://www.curotec.com/services/technologies/laravel/)**
+- **[OP.GG](https://op.gg)**
+- **[WebReinvent](https://webreinvent.com/?utm_source=laravel&utm_medium=github&utm_campaign=patreon-sponsors)**
+- **[Lendio](https://lendio.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).

app/Console/Commands/CreateAdmin.php

@@ -1,90 +0,0 @@
-<?php
-
-namespace App\Console\Commands;
-
-use App\Models\User;
-use Illuminate\Console\Command;
-use Illuminate\Support\Facades\Validator;
-use Illuminate\Validation\ValidationException;
-
-/**
- * Creates a new user
- */
-class CreateAdmin extends Command
-{
-    /**
-     * The name and signature of the console command.
-     *
-     * @var string
-     */
-    protected $signature = 'user:create';
-
-    /**
-     * The console command description.
-     *
-     * @var string
-     */
-    protected $description = 'Create a backend admin user';
-
-    /**
-     * Execute the console command.
-     *
-     * @return integer
-     */
-    public function handle()
-    {
-        $email = null;
-        while (is_null($email)) {
-            try {
-                $tmp       = $this->ask('Type the wanted user email', 'equipe.web@ldc.fr');
-                $validator = Validator::make(['email' => $tmp], [
-                    'email' => 'required|unique:users,email|email:rfc,dns'
-                ]);
-                $validator->validate();
-                $email = $tmp;
-            } catch (ValidationException $e) {
-                $this->error(sprintf(
-                    'Please provide a valid email %s',
-                    \implode(',', collect($e->errors())->flatten()->all())
-                ));
-                continue;
-            }
-        }
-        $name = null;
-        while (is_null($name)) {
-            try {
-                $tmp       = $this->ask('Type the wanted user name', 'Admin');
-                $validator = Validator::make(['name' => $tmp], [
-                    'name' => 'required|min:5,max:255'
-                ]);
-                $validator->validate();
-                $name = $tmp;
-            } catch (ValidationException $e) {
-                $this->error(sprintf(
-                    'Please provide a valid name %s',
-                    \implode(',', collect($e->errors())->flatten()->all())
-                ));
-                continue;
-            }
-        }
-
-        $password = null;
-        while (
-            ($password = $this->secret(
-                (!\is_null($password) ? 'Failed to confirm, ' : '') . 'Type the wanted user password'
-            )) !== $this->secret('Confirm the password')
-        ) {
-            continue;
-        };
-
-        $admin = new User([
-            'name' => $name,
-            'email' => $email,
-            'password' => $password
-        ]);
-        $admin->saveOrFail();
-
-        $this->info('User created.');
-        return 0;
-    }
-}

app/Console/Commands/TestMail.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace App\Console\Commands;
+
+use Illuminate\Console\Command;
+use Illuminate\Support\Facades\Mail;
+
+class TestMail extends Command
+{
+    /**
+     * The name and signature of the console command.
+     *
+     * @var string
+     */
+    protected $signature = 'uwil:mail:test';
+
+    /**
+     * The console command description.
+     *
+     * @var string
+     */
+    protected $description = 'Send test email to equipe.web@ldc.fr';
+
+    /**
+     * Execute the console command.
+     *
+     * @return void
+     */
+    public function handle()
+    {
+        Mail::raw(sprintf('UWIL mail-test from %s %s', \config('app.name'), \config('app.url')), function ($msg) {
+            $msg->to('equipe.web@ldc.fr')->subject('Test Email');
+        });
+    }
+}

app/Console/Commands/UserCreate.php

@@ -0,0 +1,207 @@
+<?php
+
+namespace App\Console\Commands;
+
+use App\Enums\Users\RoleEnum;
+use App\Models\User;
+use Carbon\Carbon;
+use Illuminate\Console\Command;
+use Illuminate\Support\Facades\Validator;
+use Illuminate\Validation\ValidationException;
+use Illuminate\Support\Str;
+
+class UserCreate extends Command
+{
+    /**
+     * The name and signature of the console command.
+     *
+     * @var string
+     */
+    protected $signature = 'uwil:user:create';
+
+    /**
+     * The console command description.
+     *
+     * @var string
+     */
+    protected $description = 'Create a backend admin user';
+
+    /**
+     * The first name of the new user.
+     *
+     * @var string|null
+     */
+    protected $first_name;
+
+    /**
+     * The last name of the new user.
+     *
+     * @var string|null
+     */
+    protected $last_name;
+
+    /**
+     * The email of the new user.
+     *
+     * @var string|null
+     */
+    protected $email;
+
+    /**
+     * The role of the new user.
+     *
+     * @var string|null
+     */
+    protected $role;
+
+    /**
+     * Execute the console command.
+     *
+     * @return integer
+     */
+    public function handle(): int
+    {
+        $this->first_name = null;
+        $this->addFirstName();
+
+        $this->last_name = null;
+        $this->addLastName();
+
+        $this->email = null;
+        $this->addEmail();
+
+        $this->role = null;
+        $this->addRole();
+
+        $user = new User([
+            'first_name' => $this->first_name,
+            'last_name' => $this->last_name,
+            'email' => $this->email,
+            'role' => $this->role,
+            'published' => true,
+            'published_at' => Carbon::now(),
+        ]);
+        $user->saveOrFail();
+
+        $this->info('User created 👌');
+
+        return 0;
+    }
+
+    /**
+     * Add a first name to the user.
+     *
+     * @return void
+     */
+    private function addFirstName(): void
+    {
+        while (is_null($this->first_name)) {
+            try {
+                $tmp       = $this->ask('Type the wanted user first name', 'Admin');
+                $validator = Validator::make(['first_name' => $tmp], [
+                    'first_name' => 'required|min:3|max:255'
+                ]);
+                $validator->validate();
+                $this->first_name = $tmp;
+            } catch (ValidationException $e) {
+                $this->error(sprintf(
+                    'Please provide a valid first name %s',
+                    \implode(',', collect($e->errors())->flatten()->all())
+                ));
+                continue;
+            } //end try
+        }; //end while
+    }
+
+    /**
+     * Add a last name to the user.
+     *
+     * @return void
+     */
+    private function addLastName(): void
+    {
+        while (is_null($this->last_name)) {
+            try {
+                $tmp       = $this->ask('Type the wanted user last name', 'Saïtama');
+                $validator = Validator::make(['last_name' => $tmp], [
+                    'last_name' => 'required|min:3|max:255'
+                ]);
+                $validator->validate();
+                $this->last_name = $tmp;
+            } catch (ValidationException $e) {
+                $this->error(sprintf(
+                    'Please provide a valid last_name %s',
+                    \implode(',', collect($e->errors())->flatten()->all())
+                ));
+                continue;
+            } //end try
+        }; //end while
+    }
+
+    /**
+     * Add an email to the user.
+     *
+     * @return void
+     */
+    private function addEmail(): void
+    {
+        while (is_null($this->email)) {
+            try {
+                $tmp       = $this->ask('Type the wanted user email', 'equipe.web@ldc.fr');
+                $validator = Validator::make(['email' => $tmp], [
+                    'email' => 'required|unique:users,email|email:rfc,dns'
+                ]);
+                $validator->validate();
+                $this->email = $tmp;
+            } catch (ValidationException $e) {
+                $this->error(sprintf(
+                    'Please provide a valid email %s',
+                    \implode(',', collect($e->errors())->flatten()->all())
+                ));
+                continue;
+            } //end try
+        }; //end while
+    }
+
+    /**
+     * Add a role to the user.
+     *
+     * @return void
+     */
+    private function addRole(): void
+    {
+        while (is_null($this->role)) {
+            try {
+                $tmp = $this->choice(
+                    'Select his role',
+                    [
+                        Str::ucFirst(RoleEnum::conceptor->label()),
+                        Str::ucFirst(RoleEnum::admin->label()),
+                        Str::ucFirst(RoleEnum::visitor->label())
+                    ],
+                    Str::ucFirst(RoleEnum::visitor->label()),
+                );
+                if ($tmp === Str::ucFirst(RoleEnum::conceptor->label())) {
+                    $tmp = RoleEnum::conceptor;
+                }
+                if ($tmp === Str::ucFirst(RoleEnum::admin->label())) {
+                    $tmp = RoleEnum::admin;
+                }
+                if ($tmp === Str::ucFirst(RoleEnum::visitor->label())) {
+                    $tmp = RoleEnum::visitor;
+                }
+                $validator = Validator::make(['role' => $tmp], [
+                    'role' => 'required'
+                ]);
+                $validator->validate();
+                $this->role = $tmp;
+            } catch (ValidationException $e) {
+                $this->error(sprintf(
+                    'Please choose from the selection %s',
+                    \implode(',', collect($e->errors())->flatten()->all())
+                ));
+                continue;
+            } //end try
+        }; //end while
+    }
+}

app/Enums/ActivityLogs/ActivityLogsEventEnum.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace App\Enums\ActivityLogs;
+
+use App\Traits\Enums\BaseEnum;
+
+enum ActivityLogsEventEnum: int
+{
+    use BaseEnum;
+
+    case created    = 1;
+    case updated    = 2;
+    case duplicated = 3;
+    case deleted    = 4;
+
+    /**
+     * Optionnal labels definition
+     *
+     * @phpstan-ignore-next-line
+     */
+    private const LABELS = [
+        self::created->name    => 'Création',
+        self::updated->name    => 'Mise à jour',
+        self::duplicated->name => 'Duplication',
+        self::deleted->name    => 'Suppression',
+    ];
+
+
+    /**
+     * Custom added classes definition
+     */
+    private const BOOTSTRAPCLASS = [
+        self::created->name    => 'success',
+        self::updated->name    => 'warning',
+        self::duplicated->name => 'secondary',
+        self::deleted->name    => 'danger',
+    ];
+
+    /**
+     * Get Class
+     *
+     * @return string
+     */
+    public function bootstrapClass(): string
+    {
+        return self::BOOTSTRAPCLASS[$this->name];
+    }
+}

app/Enums/Country.php

@@ -0,0 +1,625 @@
+<?php
+
+namespace App\Enums;
+
+use App\Traits\Enums\BaseEnum;
+
+enum Country: int
+{
+    use BaseEnum;
+
+    case afghanistan                            = 1;
+    case alandIslands                           = 2;
+    case albania                                = 3;
+    case algeria                                = 4;
+    case americanSamoa                          = 5;
+    case andorra                                = 6;
+    case angola                                 = 7;
+    case anguilla                               = 8;
+    case antarctica                             = 9;
+    case antiguaAndBarbuda                      = 10;
+    case argentina                              = 11;
+    case armenia                                = 12;
+    case aruba                                  = 13;
+    case australia                              = 14;
+    case austria                                = 15;
+    case azerbaijan                             = 16;
+    case bahrain                                = 17;
+    case bahamas                                = 18;
+    case bangladesh                             = 19;
+    case barbados                               = 20;
+    case belarus                                = 21;
+    case belgium                                = 22;
+    case belize                                 = 23;
+    case benin                                  = 24;
+    case bermuda                                = 25;
+    case bhutan                                 = 26;
+    case boliviaPlurinationalStateOf            = 27;
+    case bonaireSintEustatiusAndSaba            = 28;
+    case bosniaAndHerzegovina                   = 29;
+    case botswana                               = 30;
+    case bouvetIsland                           = 31;
+    case brazil                                 = 32;
+    case britishIndianOceanTerritory            = 33;
+    case bruneiDarussalam                       = 34;
+    case bulgaria                               = 35;
+    case burkinaFaso                            = 36;
+    case burundi                                = 37;
+    case cambodia                               = 38;
+    case cameroon                               = 39;
+    case canada                                 = 40;
+    case capeVerde                              = 41;
+    case caymanIslands                          = 42;
+    case centralAfricanRepublic                 = 43;
+    case chad                                   = 44;
+    case chile                                  = 45;
+    case china                                  = 46;
+    case christmasIsland                        = 47;
+    case cocosKeelingIslands                    = 48;
+    case colombia                               = 49;
+    case comoros                                = 50;
+    case congo                                  = 51;
+    case congoTheDemocraticRepublicOfThe        = 52;
+    case cookIslands                            = 53;
+    case costaRica                              = 54;
+    case coteDivoire                            = 55;
+    case croatia                                = 56;
+    case cuba                                   = 57;
+    case curacao                                = 58;
+    case cyprus                                 = 59;
+    case czechRepublic                          = 60;
+    case denmark                                = 61;
+    case djibouti                               = 62;
+    case dominica                               = 63;
+    case dominicanRepublic                      = 64;
+    case ecuador                                = 65;
+    case egypt                                  = 66;
+    case elSalvador                             = 67;
+    case equatorialGuinea                       = 68;
+    case eritrea                                = 69;
+    case estonia                                = 70;
+    case ethiopia                               = 71;
+    case falklandIslandsMalvinas                = 72;
+    case faroeIslands                           = 73;
+    case fiji                                   = 74;
+    case finland                                = 75;
+    case france                                 = 76;
+    case frenchGuiana                           = 77;
+    case frenchPolynesia                        = 78;
+    case frenchSouthernTerritories              = 79;
+    case gabon                                  = 80;
+    case gambia                                 = 81;
+    case georgia                                = 82;
+    case germany                                = 83;
+    case ghana                                  = 84;
+    case gibraltar                              = 85;
+    case greece                                 = 86;
+    case greenland                              = 87;
+    case grenada                                = 88;
+    case guadeloupe                             = 89;
+    case guam                                   = 90;
+    case guatemala                              = 91;
+    case guernsey                               = 92;
+    case guinea                                 = 93;
+    case guineaBissau                           = 94;
+    case guyana                                 = 95;
+    case haiti                                  = 96;
+    case heardIslandAndMcdonaldIslands          = 97;
+    case holySeeVaticanCityState                = 98;
+    case honduras                               = 99;
+    case hongKong                               = 100;
+    case hungary                                = 101;
+    case iceland                                = 102;
+    case india                                  = 103;
+    case indonesia                              = 104;
+    case iranIslamicRepublicOf                  = 105;
+    case iraq                                   = 106;
+    case ireland                                = 107;
+    case isleOfMan                              = 108;
+    case israel                                 = 109;
+    case italy                                  = 110;
+    case jamaica                                = 111;
+    case japan                                  = 112;
+    case jersey                                 = 113;
+    case jordan                                 = 114;
+    case kazakhstan                             = 115;
+    case kenya                                  = 116;
+    case kiribati                               = 117;
+    case koreaDemocraticPeoplesRepublicOf       = 118;
+    case koreaRepublicOf                        = 119;
+    case kuwait                                 = 120;
+    case kyrgyzstan                             = 121;
+    case laoPeoplesDemocraticRepublic           = 122;
+    case latvia                                 = 123;
+    case lebanon                                = 124;
+    case lesotho                                = 125;
+    case liberia                                = 126;
+    case libya                                  = 127;
+    case liechtenstein                          = 128;
+    case lithuania                              = 129;
+    case luxembourg                             = 130;
+    case macao                                  = 131;
+    case macedoniaTheFormerYugoslavRepublicOf   = 132;
+    case madagascar                             = 133;
+    case malawi                                 = 134;
+    case malaysia                               = 135;
+    case maldives                               = 136;
+    case mali                                   = 137;
+    case malta                                  = 138;
+    case marshallIslands                        = 139;
+    case martinique                             = 140;
+    case mauritania                             = 141;
+    case mauritius                              = 142;
+    case mayotte                                = 143;
+    case mexico                                 = 144;
+    case micronesiaFederatedStatesOf            = 145;
+    case moldovaRepublicOf                      = 146;
+    case monaco                                 = 147;
+    case mongolia                               = 148;
+    case montenegro                             = 149;
+    case montserrat                             = 150;
+    case morocco                                = 151;
+    case mozambique                             = 152;
+    case myanmar                                = 153;
+    case namibia                                = 154;
+    case nauru                                  = 155;
+    case nepal                                  = 156;
+    case netherlands                            = 157;
+    case newCaledonia                           = 158;
+    case newZealand                             = 159;
+    case nicaragua                              = 160;
+    case niger                                  = 161;
+    case nigeria                                = 162;
+    case niue                                   = 163;
+    case norfolkIsland                          = 164;
+    case northernMarianaIslands                 = 165;
+    case norway                                 = 166;
+    case oman                                   = 167;
+    case pakistan                               = 168;
+    case palau                                  = 169;
+    case palestineStateOf                       = 170;
+    case panama                                 = 171;
+    case papuaNewGuinea                         = 172;
+    case paraguay                               = 173;
+    case peru                                   = 174;
+    case philippines                            = 175;
+    case pitcairn                               = 176;
+    case poland                                 = 177;
+    case portugal                               = 178;
+    case puertoRico                             = 179;
+    case qatar                                  = 180;
+    case reunion                                = 181;
+    case romania                                = 182;
+    case russianFederation                      = 183;
+    case rwanda                                 = 184;
+    case saintBarthelemy                        = 185;
+    case saintHelenaAscensionAndTristanDaCunha  = 186;
+    case saintKittsAndNevis                     = 187;
+    case saintLucia                             = 188;
+    case saintMartinFrenchPart                  = 189;
+    case saintPierreAndMiquelon                 = 190;
+    case saintVincentAndTheGrenadines           = 191;
+    case samoa                                  = 192;
+    case sanMarino                              = 193;
+    case saoTomeAndPrincipe                     = 194;
+    case saudiArabia                            = 195;
+    case senegal                                = 196;
+    case serbia                                 = 197;
+    case seychelles                             = 198;
+    case sierraLeone                            = 199;
+    case singapore                              = 200;
+    case sintMaartenDutchPart                   = 201;
+    case slovakia                               = 202;
+    case slovenia                               = 203;
+    case solomonIslands                         = 204;
+    case somalia                                = 205;
+    case southAfrica                            = 206;
+    case southGeorgiaAndTheSouthSandwichIslands = 207;
+    case southSudan                             = 208;
+    case spain                                  = 209;
+    case sriLanka                               = 210;
+    case sudan                                  = 211;
+    case suriname                               = 212;
+    case svalbardAndJanMayen                    = 213;
+    case swaziland                              = 214;
+    case sweden                                 = 215;
+    case switzerland                            = 216;
+    case syrianArabRepublic                     = 217;
+    case taiwanProvinceOfChina                  = 218;
+    case tajikistan                             = 219;
+    case tanzaniaUnitedRepublicOf               = 220;
+    case thailand                               = 221;
+    case timorLeste                             = 222;
+    case togo                                   = 223;
+    case tokelau                                = 224;
+    case tonga                                  = 225;
+    case trinidadAndTobago                      = 226;
+    case tunisia                                = 227;
+    case turkey                                 = 228;
+    case turkmenistan                           = 229;
+    case turksAndCaicosIslands                  = 230;
+    case tuvalu                                 = 231;
+    case uganda                                 = 232;
+    case ukraine                                = 233;
+    case unitedArabEmirates                     = 234;
+    case unitedKingdom                          = 235;
+    case unitedStates                           = 236;
+    case unitedStatesMinorOutlyingIslands       = 237;
+    case uruguay                                = 238;
+    case uzbekistan                             = 239;
+    case vanuatu                                = 240;
+    case venezuelaBolivarianRepublicOf          = 241;
+    case vietNam                                = 242;
+    case virginIslandsBritish                   = 243;
+    case virginIslandsUs                        = 244;
+    case wallisAndFutuna                        = 245;
+    case westernSahara                          = 246;
+    case yemen                                  = 247;
+    case zambia                                 = 248;
+    case zimbabwe                               = 249;
+
+    /**
+     * Optionnal labels definition
+     *
+     * @phpstan-ignore-next-line
+     */
+    private const LABELS = [
+        self::afghanistan->name                            => 'Afghanistan',
+        self::alandIslands->name                           => 'Åland Islands',
+        self::albania->name                                => 'Albania',
+        self::algeria->name                                => 'Algeria',
+        self::americanSamoa->name                          => 'American Samoa',
+        self::andorra->name                                => 'Andorra',
+        self::angola->name                                 => 'Angola',
+        self::anguilla->name                               => 'Anguilla',
+        self::antarctica->name                             => 'Antarctica',
+        self::antiguaAndBarbuda->name                      => 'Antigua and Barbuda',
+        self::argentina->name                              => 'Argentina',
+        self::armenia->name                                => 'Armenia',
+        self::aruba->name                                  => 'Aruba',
+        self::australia->name                              => 'Australia',
+        self::austria->name                                => 'Austria',
+        self::azerbaijan->name                             => 'Azerbaijan',
+        self::bahrain->name                                => 'Bahrain',
+        self::bahamas->name                                => 'Bahamas',
+        self::bangladesh->name                             => 'Bangladesh',
+        self::barbados->name                               => 'Barbados',
+        self::belarus->name                                => 'Belarus',
+        self::belgium->name                                => 'Belgium',
+        self::belize->name                                 => 'Belize',
+        self::benin->name                                  => 'Benin',
+        self::bermuda->name                                => 'Bermuda',
+        self::bhutan->name                                 => 'Bhutan',
+        self::boliviaPlurinationalStateOf->name            => 'Bolivia, Plurinational State of',
+        self::bonaireSintEustatiusAndSaba->name            => 'Bonaire, Sint Eustatius and Saba',
+        self::bosniaAndHerzegovina->name                   => 'Bosnia and Herzegovina',
+        self::botswana->name                               => 'Botswana',
+        self::bouvetIsland->name                           => 'Bouvet Island',
+        self::brazil->name                                 => 'Brazil',
+        self::britishIndianOceanTerritory->name            => 'British Indian Ocean Territory',
+        self::bruneiDarussalam->name                       => 'Brunei Darussalam',
+        self::bulgaria->name                               => 'Bulgaria',
+        self::burkinaFaso->name                            => 'Burkina Faso',
+        self::burundi->name                                => 'Burundi',
+        self::cambodia->name                               => 'Cambodia',
+        self::cameroon->name                               => 'Cameroon',
+        self::canada->name                                 => 'Canada',
+        self::capeVerde->name                              => 'Cape Verde',
+        self::caymanIslands->name                          => 'Cayman Islands',
+        self::centralAfricanRepublic->name                 => 'Central African Republic',
+        self::chad->name                                   => 'Chad',
+        self::chile->name                                  => 'Chile',
+        self::china->name                                  => 'China',
+        self::christmasIsland->name                        => 'Christmas Island',
+        self::cocosKeelingIslands->name                    => 'Cocos (Keeling) Islands',
+        self::colombia->name                               => 'Colombia',
+        self::comoros->name                                => 'Comoros',
+        self::congo->name                                  => 'Congo',
+        self::congoTheDemocraticRepublicOfThe->name        => 'Congo, the Democratic Republic of the',
+        self::cookIslands->name                            => 'Cook Islands',
+        self::costaRica->name                              => 'Costa Rica',
+        self::coteDivoire->name                            => 'Côte d\'Ivoire',
+        self::croatia->name                                => 'Croatia',
+        self::cuba->name                                   => 'Cuba',
+        self::curacao->name                                => 'Curaçao',
+        self::cyprus->name                                 => 'Cyprus',
+        self::czechRepublic->name                          => 'Czech Republic',
+        self::denmark->name                                => 'Denmark',
+        self::djibouti->name                               => 'Djibouti',
+        self::dominica->name                               => 'Dominica',
+        self::dominicanRepublic->name                      => 'Dominican Republic',
+        self::ecuador->name                                => 'Ecuador',
+        self::egypt->name                                  => 'Egypt',
+        self::elSalvador->name                             => 'El Salvador',
+        self::equatorialGuinea->name                       => 'Equatorial Guinea',
+        self::eritrea->name                                => 'Eritrea',
+        self::estonia->name                                => 'Estonia',
+        self::ethiopia->name                               => 'Ethiopia',
+        self::falklandIslandsMalvinas->name                => 'Falkland Islands (Malvinas)',
+        self::faroeIslands->name                           => 'Faroe Islands',
+        self::fiji->name                                   => 'Fiji',
+        self::finland->name                                => 'Finland',
+        self::france->name                                 => 'France',
+        self::frenchGuiana->name                           => 'French Guiana',
+        self::frenchPolynesia->name                        => 'French Polynesia',
+        self::frenchSouthernTerritories->name              => 'French Southern Territories',
+        self::gabon->name                                  => 'Gabon',
+        self::gambia->name                                 => 'Gambia',
+        self::georgia->name                                => 'Georgia',
+        self::germany->name                                => 'Germany',
+        self::ghana->name                                  => 'Ghana',
+        self::gibraltar->name                              => 'Gibraltar',
+        self::greece->name                                 => 'Greece',
+        self::greenland->name                              => 'Greenland',
+        self::grenada->name                                => 'Grenada',
+        self::guadeloupe->name                             => 'Guadeloupe',
+        self::guam->name                                   => 'Guam',
+        self::guatemala->name                              => 'Guatemala',
+        self::guernsey->name                               => 'Guernsey',
+        self::guinea->name                                 => 'Guinea',
+        self::guineaBissau->name                           => 'GuineaBissau',
+        self::guyana->name                                 => 'Guyana',
+        self::haiti->name                                  => 'Haiti',
+        self::heardIslandAndMcdonaldIslands->name          => 'Heard Island and McDonald Islands',
+        self::holySeeVaticanCityState->name                => 'Holy See (Vatican City State)',
+        self::honduras->name                               => 'Honduras',
+        self::hongKong->name                               => 'Hong Kong',
+        self::hungary->name                                => 'Hungary',
+        self::iceland->name                                => 'Iceland',
+        self::india->name                                  => 'India',
+        self::indonesia->name                              => 'Indonesia',
+        self::iranIslamicRepublicOf->name                  => 'Iran, Islamic Republic of',
+        self::iraq->name                                   => 'Iraq',
+        self::ireland->name                                => 'Ireland',
+        self::isleOfMan->name                              => 'Isle of Man',
+        self::israel->name                                 => 'Israel',
+        self::italy->name                                  => 'Italy',
+        self::jamaica->name                                => 'Jamaica',
+        self::japan->name                                  => 'Japan',
+        self::jersey->name                                 => 'Jersey',
+        self::jordan->name                                 => 'Jordan',
+        self::kazakhstan->name                             => 'Kazakhstan',
+        self::kenya->name                                  => 'Kenya',
+        self::kiribati->name                               => 'Kiribati',
+        self::koreaDemocraticPeoplesRepublicOf->name       => 'Korea, Democratic People\'s Republic of',
+        self::koreaRepublicOf->name                        => 'Korea, Republic of',
+        self::kuwait->name                                 => 'Kuwait',
+        self::kyrgyzstan->name                             => 'Kyrgyzstan',
+        self::laoPeoplesDemocraticRepublic->name           => 'Lao People\'s Democratic Republic',
+        self::latvia->name                                 => 'Latvia',
+        self::lebanon->name                                => 'Lebanon',
+        self::lesotho->name                                => 'Lesotho',
+        self::liberia->name                                => 'Liberia',
+        self::libya->name                                  => 'Libya',
+        self::liechtenstein->name                          => 'Liechtenstein',
+        self::lithuania->name                              => 'Lithuania',
+        self::luxembourg->name                             => 'Luxembourg',
+        self::macao->name                                  => 'Macao',
+        self::macedoniaTheFormerYugoslavRepublicOf->name   => 'Macedonia, the Former Yugoslav Republic of',
+        self::madagascar->name                             => 'Madagascar',
+        self::malawi->name                                 => 'Malawi',
+        self::malaysia->name                               => 'Malaysia',
+        self::maldives->name                               => 'Maldives',
+        self::mali->name                                   => 'Mali',
+        self::malta->name                                  => 'Malta',
+        self::marshallIslands->name                        => 'Marshall Islands',
+        self::martinique->name                             => 'Martinique',
+        self::mauritania->name                             => 'Mauritania',
+        self::mauritius->name                              => 'Mauritius',
+        self::mayotte->name                                => 'Mayotte',
+        self::mexico->name                                 => 'Mexico',
+        self::micronesiaFederatedStatesOf->name            => 'Micronesia, Federated States of',
+        self::moldovaRepublicOf->name                      => 'Moldova, Republic of',
+        self::monaco->name                                 => 'Monaco',
+        self::mongolia->name                               => 'Mongolia',
+        self::montenegro->name                             => 'Montenegro',
+        self::montserrat->name                             => 'Montserrat',
+        self::morocco->name                                => 'Morocco',
+        self::mozambique->name                             => 'Mozambique',
+        self::myanmar->name                                => 'Myanmar',
+        self::namibia->name                                => 'Namibia',
+        self::nauru->name                                  => 'Nauru',
+        self::nepal->name                                  => 'Nepal',
+        self::netherlands->name                            => 'Netherlands',
+        self::newCaledonia->name                           => 'New Caledonia',
+        self::newZealand->name                             => 'New Zealand',
+        self::nicaragua->name                              => 'Nicaragua',
+        self::niger->name                                  => 'Niger',
+        self::nigeria->name                                => 'Nigeria',
+        self::niue->name                                   => 'Niue',
+        self::norfolkIsland->name                          => 'Norfolk Island',
+        self::northernMarianaIslands->name                 => 'Northern Mariana Islands',
+        self::norway->name                                 => 'Norway',
+        self::oman->name                                   => 'Oman',
+        self::pakistan->name                               => 'Pakistan',
+        self::palau->name                                  => 'Palau',
+        self::palestineStateOf->name                       => 'Palestine, State of',
+        self::panama->name                                 => 'Panama',
+        self::papuaNewGuinea->name                         => 'Papua New Guinea',
+        self::paraguay->name                               => 'Paraguay',
+        self::peru->name                                   => 'Peru',
+        self::philippines->name                            => 'Philippines',
+        self::pitcairn->name                               => 'Pitcairn',
+        self::poland->name                                 => 'Poland',
+        self::portugal->name                               => 'Portugal',
+        self::puertoRico->name                             => 'Puerto Rico',
+        self::qatar->name                                  => 'Qatar',
+        self::reunion->name                                => 'Réunion',
+        self::romania->name                                => 'Romania',
+        self::russianFederation->name                      => 'Russian Federation',
+        self::rwanda->name                                 => 'Rwanda',
+        self::saintBarthelemy->name                        => 'Saint Barthélemy',
+        self::saintHelenaAscensionAndTristanDaCunha->name  => 'Saint Helena, Ascension and Tristan da Cunha',
+        self::saintKittsAndNevis->name                     => 'Saint Kitts and Nevis',
+        self::saintLucia->name                             => 'Saint Lucia',
+        self::saintMartinFrenchPart->name                  => 'Saint Martin (French part)',
+        self::saintPierreAndMiquelon->name                 => 'Saint Pierre and Miquelon',
+        self::saintVincentAndTheGrenadines->name           => 'Saint Vincent and the Grenadines',
+        self::samoa->name                                  => 'Samoa',
+        self::sanMarino->name                              => 'San Marino',
+        self::saoTomeAndPrincipe->name                     => 'Sao Tome and Principe',
+        self::saudiArabia->name                            => 'Saudi Arabia',
+        self::senegal->name                                => 'Senegal',
+        self::serbia->name                                 => 'Serbia',
+        self::seychelles->name                             => 'Seychelles',
+        self::sierraLeone->name                            => 'Sierra Leone',
+        self::singapore->name                              => 'Singapore',
+        self::sintMaartenDutchPart->name                   => 'Sint Maarten (Dutch part)',
+        self::slovakia->name                               => 'Slovakia',
+        self::slovenia->name                               => 'Slovenia',
+        self::solomonIslands->name                         => 'Solomon Islands',
+        self::somalia->name                                => 'Somalia',
+        self::southAfrica->name                            => 'South Africa',
+        self::southGeorgiaAndTheSouthSandwichIslands->name => 'South Georgia and the South Sandwich Islands',
+        self::southSudan->name                             => 'South Sudan',
+        self::spain->name                                  => 'Spain',
+        self::sriLanka->name                               => 'Sri Lanka',
+        self::sudan->name                                  => 'Sudan',
+        self::suriname->name                               => 'Suriname',
+        self::svalbardAndJanMayen->name                    => 'Svalbard and Jan Mayen',
+        self::swaziland->name                              => 'Swaziland',
+        self::sweden->name                                 => 'Sweden',
+        self::switzerland->name                            => 'Switzerland',
+        self::syrianArabRepublic->name                     => 'Syrian Arab Republic',
+        self::taiwanProvinceOfChina->name                  => 'Taiwan, Province of China',
+        self::tajikistan->name                             => 'Tajikistan',
+        self::tanzaniaUnitedRepublicOf->name               => 'Tanzania, United Republic of',
+        self::thailand->name                               => 'Thailand',
+        self::timorLeste->name                             => 'TimorLeste',
+        self::togo->name                                   => 'Togo',
+        self::tokelau->name                                => 'Tokelau',
+        self::tonga->name                                  => 'Tonga',
+        self::trinidadAndTobago->name                      => 'Trinidad and Tobago',
+        self::tunisia->name                                => 'Tunisia',
+        self::turkey->name                                 => 'Turkey',
+        self::turkmenistan->name                           => 'Turkmenistan',
+        self::turksAndCaicosIslands->name                  => 'Turks and Caicos Islands',
+        self::tuvalu->name                                 => 'Tuvalu',
+        self::uganda->name                                 => 'Uganda',
+        self::ukraine->name                                => 'Ukraine',
+        self::unitedArabEmirates->name                     => 'United Arab Emirates',
+        self::unitedKingdom->name                          => 'United Kingdom',
+        self::unitedStates->name                           => 'United States',
+        self::unitedStatesMinorOutlyingIslands->name       => 'United States Minor Outlying Islands',
+        self::uruguay->name                                => 'Uruguay',
+        self::uzbekistan->name                             => 'Uzbekistan',
+        self::vanuatu->name                                => 'Vanuatu',
+        self::venezuelaBolivarianRepublicOf->name          => 'Venezuela, Bolivarian Republic of',
+        self::vietNam->name                                => 'Viet Nam',
+        self::virginIslandsBritish->name                   => 'Virgin Islands, British',
+        self::virginIslandsUs->name                        => 'Virgin Islands, U.S.',
+        self::wallisAndFutuna->name                        => 'Wallis and Futuna',
+        self::westernSahara->name                          => 'Western Sahara',
+        self::yemen->name                                  => 'Yemen',
+        self::zambia->name                                 => 'Zambia',
+        self::zimbabwe->name                               => 'Zimbabwe',
+    ];
+
+    /**
+     * Get Valid Shipping Countries
+     *
+     * @return array
+     */
+    public static function validShippingCountries(): array
+    {
+        return [
+            self::france,
+            /**
+         * // * DROM COM .
+            // self::guadeloupe,
+            // self::martinique,
+            // self::frenchGuiana,
+            // self::reunion,
+            // self::saintPierreAndMiquelon,
+            // self::mayotte,
+            // self::saintBarthelemy,
+            // self::saintMartinFrenchPart,
+            // self::wallisAndFutuna,
+            // self::frenchPolynesia,
+            // self::newCaledonia
+         */
+        ];
+    }
+
+    /**
+     * Get Valid Shipping Countries
+     *
+     * @return array
+     */
+    public static function validBillingCountries(): array
+    {
+        return [
+            self::france,
+            // * DROM COM.
+            self::guadeloupe,
+            self::martinique,
+            self::frenchGuiana,
+            self::reunion,
+            self::saintPierreAndMiquelon,
+            self::mayotte,
+            self::saintBarthelemy,
+            self::saintMartinFrenchPart,
+            self::wallisAndFutuna,
+            self::frenchPolynesia,
+            self::newCaledonia
+        ];
+    }
+
+    /**
+     * Get Alpha 2 ISO code of valid shipping countries
+     *
+     * @return array
+     */
+    public static function getValidShippingCountriesIsoAplha2Codes(): array
+    {
+        return ['FR'];
+    }
+
+    /**
+     * Get Alpha 2 ISO code of valid billing countries
+     *
+     * @return array
+     */
+    public static function getValidBillingCountriesIsoAplha2Codes(): array
+    {
+        return \array_values(self::ISOCODES);
+    }
+
+    /**
+     * Custom added ISOCODES definition
+     */
+    private const ISOCODES = [
+        self::france->name => 'FR',
+        self::guadeloupe->name => 'GP',
+        self::martinique->name => 'MQ',
+        self::frenchGuiana->name => 'GF',
+        self::reunion->name => 'RE',
+        self::saintPierreAndMiquelon->name => 'PM',
+        self::mayotte->name => 'YT',
+        self::saintBarthelemy->name => 'BL',
+        self::saintMartinFrenchPart->name => 'MF',
+        self::wallisAndFutuna->name => 'WF',
+        self::frenchPolynesia->name => 'PF',
+        self::newCaledonia->name => 'NC',
+    ];
+
+    /**
+     * Get ISOCODE
+     *
+     * @return string
+     */
+    public function iso(): string
+    {
+        return self::ISOCODES[$this->name];
+    }
+
+    /**
+     * Get enum ISOCODES
+     *
+     * @return array<string>
+     */
+    public static function toIsoCodes(): array
+    {
+        return self::ISOCODES;
+    }
+}

app/Enums/GeneralConfigType.php

@@ -2,52 +2,28 @@
 
 namespace App\Enums;
 
-use Kwaadpepper\Enum\BaseEnumRoutable;
+use App\Traits\Enums\BaseEnum;
 
-/**
- * @method static self menu()
- * @method static self bandeau()
- * @method static self demarche()
- * @method static self engagement()
- * @method static self elevage()
- * @method static self mention()
- * @method static self charte()
- */
-final class GeneralConfigType extends BaseEnumRoutable
+enum GeneralConfigType: int
 {
-    /**
-     * Values
-     *
-     * @return array
-     */
-    protected static function values(): array
-    {
-        return [
-            'menu' => 1,
-            'bandeau' => 2,
-            'demarche' => 3,
-            'engagement' => 4,
-            'elevage' => 5,
-            'mention' => 6,
-            'charte' => 7
-        ];
-    }
+    use BaseEnum;
+
+    case menu       = 1;
+    case bandeau    = 2;
+    case demarche   = 3;
+    case engagement = 4;
+    case elevage    = 5;
 
     /**
-     * Labels
+     * Optionnal labels definition.
      *
-     * @return array
+     * @phpstan-ignore-next-line
      */
-    protected static function labels(): array
-    {
-        return [
-            'menu' => __('Menu'),
-            'bandeau' => __('Bandeau'),
-            'demarche' => __('Demarche'),
-            'engagement' => __('Engagement'),
-            'elevage' => __('Elevage'),
-            'mention' => __('Mention légales'),
-            'charte' => __('Charte'),
-        ];
-    }
+    private const LABELS = [
+        self::menu->name       => 'Menu',
+        self::bandeau->name    => 'Bandeau',
+        self::demarche->name   => 'Demarche',
+        self::engagement->name => 'Engagement',
+        self::elevage->name    => 'Elevage',
+    ];
 }

app/Enums/InputType.php

@@ -2,45 +2,23 @@
 
 namespace App\Enums;
 
-use Kwaadpepper\Enum\BaseEnumRoutable;
+use App\Traits\Enums\BaseEnum;
 
-/**
- * @method static self boolean()
- * @method static self image()
- * @method static self string()
- * @method static self text()
- * html autorisé
- * @method static self url()
- * @method static self imageArray()
- * @method static self labelArray()
- * @method static self dropdownArray()
- * html autorisé
- * @method static self miniblocArray()
- * html autorisé
- * @method static self videoVimeo()
- * @method static self number()
- */
-final class InputType extends BaseEnumRoutable
+enum InputType: int
 {
-    /**
-     * Values
-     *
-     * @return array
-     */
-    protected static function values(): array
-    {
-        return [
-            'boolean' => 0,
-            'image' => 1,
-            'string' => 2,
-            'text' => 3,
-            'url' => 4,
-            'imageArray' => 5,
-            'labelArray' => 6,
-            'dropdownArray' => 7,
-            'miniblocArray' => 8,
-            'videoVimeo' => 9,
-            'number' => 10
-        ];
-    }
+    use BaseEnum;
+
+    case boolean       = 0;
+    case image         = 1;
+    case string        = 2;
+    case text          = 3;
+    case url           = 4;
+    case imageArray    = 5;
+    case labelArray    = 6;
+    case dropdownArray = 7;
+    case miniblocArray = 8;
+    case videoVimeo    = 9;
+    case number        = 10;
+    case videoYoutube  = 11;
+    case video         = 12;
 }

app/Enums/Pagination/ItemsPerPaginationEnum.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace App\Enums\Pagination;
+
+use App\Traits\Enums\BaseEnum;
+
+enum ItemsPerPaginationEnum: int
+{
+    use BaseEnum;
+
+    case five       = 5;
+    case twelve     = 12;
+    case twentyfive = 25;
+    case fifty      = 50;
+    case onehundred = 100;
+}

app/Enums/StaticPageType.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace App\Enums;
+
+use App\Traits\Enums\BaseEnum;
+
+enum StaticPageType: int
+{
+    use BaseEnum;
+
+    case confidentiality = 1;
+    case legals          = 2;
+
+    /**
+     * Optionnal labels definition.
+     *
+     * @phpstan-ignore-next-line
+     */
+    private const LABELS = [
+        self::confidentiality->name => 'Charte de Confidentialité',
+        self::legals->name          => 'Mentions légales et CGU',
+    ];
+}

app/Enums/Theme/BootstrapThemeEnum.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace App\Enums\Theme;
+
+use App\Traits\Enums\BaseEnum;
+
+enum BootstrapThemeEnum: int
+{
+    use BaseEnum;
+
+    case light = 1;
+    case dark  = 2;
+
+    /**
+     * Optionnal labels definition
+     *
+     * @phpstan-ignore-next-line
+     */
+    private const LABELS = [
+        self::light->name => 'enums.bootstrap-theme.light',
+        self::dark->name  => 'enums.bootstrap-theme.dark',
+    ];
+}

app/Enums/Users/RoleEnum.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace App\Enums\Users;
+
+use App\Traits\Enums\BaseEnum;
+
+enum RoleEnum: int
+{
+    use BaseEnum;
+
+    case conceptor = 1;
+    case admin     = 2;
+    case visitor   = 3;
+
+    /**
+     * Optionnal labels definition.
+     *
+     * @phpstan-ignore-next-line
+     */
+    private const LABELS = [
+        self::conceptor->name => 'enums.user-role.conceptor',
+        self::admin->name     => 'enums.user-role.admin',
+        self::visitor->name   => 'enums.user-role.visitor',
+    ];
+}

app/Exceptions/Handler.php

@@ -2,21 +2,27 @@
 
 namespace App\Exceptions;
 
-use Kwaadpepper\ExceptionHandler\Exceptions\ExceptionHandler;
+use Illuminate\Foundation\Exceptions\Handler as ExceptionHandler;
 use Throwable;
 
 class Handler extends ExceptionHandler
 {
     /**
-     * A list of the exception types that are not reported.
+     * A list of exception types with their corresponding custom log levels.
      *
-     * @var array<int, class-string<Throwable>>
+     * @var array<class-string<\Throwable>, \Psr\Log\LogLevel::*>
      */
-    protected $dontReport = [
-            ];
+    protected $levels = [];
 
     /**
-     * A list of the inputs that are never flashed for validation exceptions.
+     * A list of the exception types that are not reported.
+     *
+     * @var array<int, class-string<\Throwable>>
+     */
+    protected $dontReport = [];
+
+    /**
+     * A list of the inputs that are never flashed to the session on validation exceptions.
      *
      * @var array<int, string>
      */
@@ -34,6 +40,9 @@ class Handler extends ExceptionHandler
     public function register()
     {
         $this->reportable(function (Throwable $e) {
+            if (app()->bound('sentry')) {
+                app('sentry')->captureException($e);
+            }
         });
     }
 }

app/Http/Controllers/Bo/ActivityLogController.php

@@ -0,0 +1,80 @@
+<?php
+
+namespace App\Http\Controllers\Bo;
+
+use App\Http\Controllers\Controller;
+use App\Models\ActivityLog;
+use App\Traits\Controllers\UpdateModelPublished;
+use Illuminate\Http\Request;
+
+class ActivityLogController extends Controller
+{
+    use UpdateModelPublished;
+
+    /**
+     * Display a listing of the resource.
+     *
+     * @param \Illuminate\Http\Request $request
+     * @return \Illuminate\Contracts\View\View
+     */
+    public function index(Request $request): \Illuminate\Contracts\View\View
+    {
+        $this->authorize('isConceptor');
+        /** @var \Illuminate\Database\Eloquent\Builder $query */
+        $query = ActivityLog::query()->with('user');
+
+        /** @var \App\Models\User|null $userModel */
+        $userModel = $request->route()->parameter('user');
+        if ($userModel) {
+            $query->where('user_id', $userModel->getKey());
+        }
+
+        /** @var string $search Search field */
+        $search = $request->search;
+        if ($search) {
+            $this->searchQuery(
+                $query,
+                $search,
+                null,
+                'model_class',
+            );
+        }
+        $searchFields = \implode(', ', [
+            trans('validation.custom.target'),
+        ]);
+
+        /** Sort columns with a query */
+        $this->sortQuery($query);
+
+        /** Custom pagination */
+        $activitylogModels = $this->paginate($query);
+
+        return view('bo.pages.activity_logs.index', compact(
+            'activitylogModels',
+            'search',
+            'searchFields',
+            'userModel'
+        ));
+    }
+
+    /**
+     * Show the form for editing the specified resource.
+     *
+     * @param \App\Models\ActivityLog $activity_log
+     * @return \Illuminate\Contracts\View\View
+     */
+    public function show(ActivityLog $activity_log): \Illuminate\Contracts\View\View
+    {
+        $this->authorize('isConceptor');
+        $targetModelClass = $activity_log->model_class;
+        $targetModel      = $activity_log->model_class::where(
+            (new $targetModelClass())->getRouteKeyName(),
+            $activity_log->model_id
+        )->first();
+
+        return view('bo.pages.activity_logs.show', [
+            'activitylogModel' => $activity_log,
+            'targetModel'      => $targetModel,
+        ]);
+    }
+}

app/Http/Controllers/Bo/Auth/LoginController.php

@@ -3,24 +3,15 @@
 namespace App\Http\Controllers\Bo\Auth;
 
 use App\Http\Controllers\Controller;
-use App\Providers\RouteServiceProvider;
+use Illuminate\Contracts\Auth\StatefulGuard;
+use Illuminate\Contracts\View\View;
 use Illuminate\Foundation\Auth\AuthenticatesUsers;
-use Illuminate\Foundation\Auth\ThrottlesLogins;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Auth;
-use Illuminate\Support\Facades\Session;
 
 class LoginController extends Controller
 {
     use AuthenticatesUsers;
-    use ThrottlesLogins;
-
-    /**
-     * Where to redirect users after login.
-     *
-     * @var string
-     */
-    protected $redirectTo = RouteServiceProvider::HOME;
 
     /**
      * Create a new controller instance.
@@ -32,16 +23,36 @@ class LoginController extends Controller
         $this->middleware('guest:backend')->except('logout');
     }
 
+    /**
+     * Get the guard to be used during authentication.
+     *
+     * @return \Illuminate\Contracts\Auth\StatefulGuard
+     */
+    protected function guard(): StatefulGuard
+    {
+        return Auth::guard('backend');
+    }
+
     /**
      * Show the application's login form.
      *
-     * @return \Illuminate\View\View
+     * @return \Illuminate\Contracts\View\View
      */
-    public function showLoginForm()
+    public function showLoginForm(): View
     {
         return view('bo.auth.login');
     }
 
+    /**
+     * Where to redirect users after login.
+     *
+     * @return string
+     */
+    protected function redirectTo(): string
+    {
+        return response()->redirectToIntended()->getTargetUrl();
+    }
+
     /**
      * Attempt to log the user into the application.
      *
@@ -50,50 +61,12 @@ class LoginController extends Controller
      */
     protected function attemptLogin(Request $request)
     {
-        return Auth::guard('backend')->attempt(
-            $this->credentials($request),
-            $request->filled('remember')
+        $credentials = $this->credentials($request);
+        // * Attempt login only using published users.
+        $credentials['published'] = true;
+        return $this->guard()->attempt(
+            $credentials,
+            $request->boolean('remember')
         );
     }
-
-    /**
-     * The user has been authenticated.
-     *
-     * @param \Illuminate\Http\Request $request
-     * @param null                     $user
-     * @return mixed
-     * @phpcs:disable Squiz.Commenting.FunctionComment.TypeHintMissing, Generic.CodeAnalysis.UnusedFunctionParameter.FoundInExtendedClassBeforeLastUsed
-     */
-    protected function authenticated(Request $request, $user)
-    {
-        /** @var \App\Models\User|null */
-        $user = Auth::guard('backend')->user();
-        if ($user) {
-            $user->last_connection = now();
-            $user->saveOrFail();
-            Session::flash('info', trans('Vous êtes à présent connecté'));
-        }
-    }
-
-    /**
-     * The user has logged out of the application.
-     *
-     * @param \Illuminate\Http\Request $request
-     * @return mixed
-     * @phpcs:disable Generic.CodeAnalysis.UnusedFunctionParameter.FoundInExtendedClass
-     */
-    protected function loggedOut(Request $request)
-    {
-        Session::flash('info', trans('Vous êtes à présent déconnecté'));
-    }
-
-    /**
-     * Get the post register / login redirect path.
-     *
-     * @return string
-     */
-    public function redirectPath()
-    {
-        return response()->redirectToRoute('bo.dashboard')->getTargetUrl();
-    }
 }

app/Http/Controllers/Bo/Auth/ResetPasswordController.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace App\Http\Controllers\Bo\Auth;
+
+use App\Http\Controllers\Controller;
+use Illuminate\Contracts\Auth\StatefulGuard;
+use Illuminate\Foundation\Auth\ResetsPasswords;
+use Illuminate\Support\Facades\Auth;
+
+class ResetPasswordController extends Controller
+{
+    use ResetsPasswords;
+
+    /**
+     * Get the guard to be used during authentication.
+     *
+     * @return \Illuminate\Contracts\Auth\StatefulGuard
+     */
+    protected function guard(): StatefulGuard
+    {
+        return Auth::guard('backend');
+    }
+
+    /**
+     * Where to redirect users after login.
+     *
+     * @return string
+     */
+    protected function redirectTo(): string
+    {
+        return \route('bo.login');
+    }
+}

app/Http/Controllers/Bo/DashboardController.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace App\Http\Controllers\Bo;
+
+use App\Http\Controllers\Controller;
+use Illuminate\Contracts\View\View;
+
+class DashboardController extends Controller
+{
+    /**
+     * Dashboard Page
+     *
+     * @return \Illuminate\Contracts\View\View
+     */
+    public function index(): View
+    {
+        return view('bo.pages.dashboard');
+    }
+}

app/Http/Controllers/Bo/GeneralConfigController.php

@@ -3,48 +3,57 @@
 namespace App\Http\Controllers\Bo;
 
 use App\Http\Controllers\Controller;
-use App\Http\Requests\Bo\UpdateGeneralConfigRequest;
+use App\Http\Requests\Bo\GeneralConfigs\UpdateGeneralConfigRequest;
 use App\Models\GeneralConfig;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Str;
 
 class GeneralConfigController extends Controller
 {
-    /**
-     * General config index
-     *
-     * @return \Illuminate\Contracts\View\View|\Illuminate\Contracts\View\Factory
-     */
-    public function index()
-    {
-        $configs = GeneralConfig::paginate();
-        return view('bo.general-configs.index', compact('configs'));
-    }
-
     /**
      * Edit general config
      *
-     * @param \App\Models\GeneralConfig $config
-     * @return \Illuminate\Contracts\View\View|\Illuminate\Contracts\View\Factor
+     * @param \App\Models\GeneralConfig $general_config
+     * @return \Illuminate\Contracts\View\View
      */
-    public function edit(GeneralConfig $config)
+    public function edit(GeneralConfig $general_config): \Illuminate\Contracts\View\View
     {
-        return view('bo.general-configs.edit', ['config' => $config]);
+        return view('bo.pages.general-configs.edit', [
+            'configModel' => $general_config
+        ]);
     }
 
     /**
      * Update General
      *
-     * @param \App\Http\Requests\UpdateGeneralConfigRequest $request
-     * @param \App\Models\GeneralConfig                     $config
-     * @return voi\Illuminate\Http\RedirectResponse
+     * @param \App\Http\Requests\Bo\GeneralConfigs\UpdateGeneralConfigRequest $request
+     * @param \App\Models\GeneralConfig                                       $general_config
+     * @return \Illuminate\Http\RedirectResponse
      */
-    public function update(UpdateGeneralConfigRequest $request, GeneralConfig $config)
-    {
-        $config->fill(array_replace_recursive(
-            \json_decode(\json_encode($config->toArray()), true),
-            $request->validated()
-        ));
-        $config->saveOrFail();
-        return redirect()->route('bo.general_configs.edit', $config)
-            ->with('success', 'Enregistré !');
+    public function update(
+        UpdateGeneralConfigRequest $request,
+        GeneralConfig $general_config
+    ): \Illuminate\Http\RedirectResponse {
+        $this->authorize('update', $general_config);
+        return DB::transaction(function () use ($request, $general_config) {
+            $general_config->fill(array_replace_recursive(
+                \json_decode(\json_encode($general_config->toArray()), true),
+                $request->validated()
+            ));
+            if ($general_config->saveOrFail()) {
+                return redirect()
+                    ->route('bo.general_configs.edit', $general_config->getKey())
+                    ->with('success', trans(
+                        'crud.messages.has_been_updated',
+                        ['model' => Str::ucFirst(Str::singular(trans('models.classes.section')))]
+                    ));
+            }
+            return redirect()
+                ->back()
+                ->with('error', trans(
+                    'crud.messages.cannot_be_updated',
+                    ['model' => Str::ucFirst(Str::singular(trans('models.classes.section')))]
+                ));
+        });
     }
 }

app/Http/Controllers/Bo/HomeController.php

@@ -1,18 +0,0 @@
-<?php
-
-namespace App\Http\Controllers\Bo;
-
-use App\Http\Controllers\Controller;
-
-class HomeController extends Controller
-{
-    /**
-     * Dashboard view
-     *
-     * @return \Illuminate\Contracts\View\View|\Illuminate\Contracts\View\Factory
-     */
-    public function dashboard()
-    {
-        return view('bo.dashboard');
-    }
-}

app/Http/Controllers/Bo/StaticPageController.php

@@ -0,0 +1,102 @@
+<?php
+
+namespace App\Http\Controllers\Bo;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\Bo\StaticPages\UpdateStaticPageRequest;
+use App\Models\StaticPage;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Str;
+
+class StaticPageController extends Controller
+{
+    /**
+     * Create the controller instance.
+     */
+    public function __construct()
+    {
+        $this->authorizeResource(StaticPage::class);
+    }
+
+    /**
+     * Display a listing of the resource.
+     *
+     * @param \Illuminate\Http\Request $request
+     * @return \Illuminate\Contracts\View\View
+     */
+    public function index(Request $request): \Illuminate\Contracts\View\View
+    {
+        /** @var \Illuminate\Database\Eloquent\Builder $query */
+        $query = StaticPage::query();
+
+        /** @var string $search Search field */
+        $search = $request->search;
+        if ($search) {
+            $this->searchQuery(
+                $query,
+                $search,
+                null,
+                'title',
+            );
+        }
+        $searchFields = \implode(', ', [
+            trans('validation.attributes.title'),
+        ]);
+
+        /** Sort columns with a query */
+        $this->sortQuery($query);
+
+        /** Custom pagination */
+        $staticPageModelList = $this->paginate($query);
+
+        return view('bo.pages.static_pages.index', compact('staticPageModelList', 'search', 'searchFields'));
+    }
+
+    /**
+     * Show a specific resource.
+     *
+     * @param \App\Models\StaticPage $static_page
+     * @return \Illuminate\Contracts\View\View
+     */
+    public function show(StaticPage $static_page): \Illuminate\Contracts\View\View
+    {
+        return view('bo.pages.static_pages.show', ['staticPageModel' => $static_page]);
+    }
+
+    /**
+     * Show the form for editing the specified resource.
+     *
+     * @param \App\Models\StaticPage $static_page
+     * @return \Illuminate\Contracts\View\View
+     */
+    public function edit(StaticPage $static_page): \Illuminate\Contracts\View\View
+    {
+        return view('bo.pages.static_pages.edit', ['staticPageModel' => $static_page]);
+    }
+
+    /**
+     * Update the specified resource in storage.
+     *
+     * @param \App\Http\Requests\Bo\StaticPages\UpdateStaticPageRequest $request
+     * @param \App\Models\StaticPage                                    $static_page
+     * @return \Illuminate\Http\RedirectResponse
+     */
+    public function update(UpdateStaticPageRequest $request, StaticPage $static_page): \Illuminate\Http\RedirectResponse
+    {
+        return DB::transaction(function () use ($request, $static_page) {
+            $static_page->fill($request->validated());
+
+            if ($static_page->saveOrFail()) {
+                return redirect()->route('bo.static_pages.edit', $static_page)
+                    ->with('success', __('crud.messages.has_been_updated', [
+                        'model' => Str::ucfirst(\trans_choice('models.classes.static_page', 1))
+                    ]));
+            }
+            return redirect()->route('bo.static_pages.edit', $static_page)
+                ->with('error', __('crud.messages.cannot_be_updated', [
+                    'model' => Str::ucfirst(\trans_choice('models.classes.static_page', 1))
+                ]));
+        });
+    }
+}

app/Http/Controllers/Bo/UserController.php

@@ -0,0 +1,168 @@
+<?php
+
+namespace App\Http\Controllers\Bo;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\Bo\Users\StoreUserRequest;
+use App\Http\Requests\Bo\Users\UpdateUserRequest;
+use App\Models\User;
+use App\Traits\Controllers\UpdateModelPublished;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Str;
+
+class UserController extends Controller
+{
+    use UpdateModelPublished;
+
+    /**
+     * Create the controller instance.
+     */
+    public function __construct()
+    {
+        $this->authorizeResource(User::class);
+    }
+
+    /**
+     * Display a listing of the resource.
+     *
+     * @param \Illuminate\Http\Request $request
+     * @return \Illuminate\Contracts\View\View
+     */
+    public function index(Request $request): \Illuminate\Contracts\View\View
+    {
+        /** @var \Illuminate\Database\Eloquent\Builder $userModels */
+        $userModels = User::query();
+
+        /** @var string $search Search field */
+        $search = $request->search;
+        if ($search) {
+            $this->searchQuery(
+                $userModels,
+                $search,
+                null,
+                'first_name',
+                'last_name',
+                'email',
+                'role',
+            );
+        }
+        $searchFields = \implode(', ', [
+            trans('validation.attributes.first_name'),
+            trans('validation.attributes.last_name'),
+            trans('validation.attributes.email'),
+            trans('validation.attributes.role'),
+        ]);
+
+        /** Sort columns with a query */
+        $this->sortQuery($userModels);
+
+        /** Custom pagination */
+        $userModels = $this->paginate($userModels);
+
+        return view('bo.pages.users.index', compact('userModels', 'search', 'searchFields'));
+    }
+
+    /**
+     * Show the form for creating a new resource.
+     *
+     * @param \App\Models\User $user
+     * @return \Illuminate\Contracts\View\View
+     */
+    public function create(User $user): \Illuminate\Contracts\View\View
+    {
+        return view('bo.pages.users.create', ['userModel' => $user]);
+    }
+
+    /**
+     * Store a newly created resource in storage.
+     *
+     * @param \App\Http\Requests\Bo\Users\StoreUserRequest $request
+     * @return \Illuminate\Http\RedirectResponse
+     */
+    public function store(StoreUserRequest $request): \Illuminate\Http\RedirectResponse
+    {
+        return DB::transaction(function () use ($request) {
+            $user = new User();
+            $user->fill($request->validated());
+
+            if ($user->saveOrFail()) {
+                return redirect()->route('bo.users.edit', $user)
+                    ->with('success', __('crud.messages.has_been_created', [
+                        'model' => Str::ucfirst(__('models.classes.user'))
+                    ]));
+            }
+            return redirect()->back()
+                ->with('error', __('crud.messages.cannot_be_created', [
+                    'model' => Str::ucfirst(__('models.classes.user'))
+                ]));
+        });
+    }
+
+    /**
+     * Show the form for editing the specified resource.
+     *
+     * @param \App\Models\User $user
+     * @return \Illuminate\Contracts\View\View
+     */
+    public function edit(User $user): \Illuminate\Contracts\View\View
+    {
+        return view('bo.pages.users.edit', ['userModel' => $user]);
+    }
+
+    /**
+     * Update the specified resource in storage.
+     *
+     * @param \App\Http\Requests\Bo\Users\UpdateUserRequest $request
+     * @param \App\Models\User                              $user
+     * @return \Illuminate\Http\RedirectResponse
+     */
+    public function update(UpdateUserRequest $request, User $user): \Illuminate\Http\RedirectResponse
+    {
+        return DB::transaction(function () use ($request, $user) {
+            $user->fill($request->validated());
+
+            if ($user->saveOrFail()) {
+                return redirect()->route('bo.users.edit', $user)
+                    ->with('success', __('crud.messages.has_been_updated', [
+                        'model' => Str::ucfirst(__('models.classes.user'))
+                    ]));
+            }
+            return redirect()->route('bo.users.edit', $user)
+                ->with('error', __('crud.messages.cannot_be_updated', [
+                    'model' => Str::ucfirst(__('models.classes.user'))
+                ]));
+        });
+    }
+
+    /**
+     * Remove the specified resource from storage.
+     *
+     * @param \App\Models\User $user
+     * @return \Illuminate\Http\RedirectResponse
+     */
+    public function destroy(User $user): \Illuminate\Http\RedirectResponse
+    {
+        if ($user->deleteOrFail()) {
+            return redirect()->route('bo.users.index')
+                ->with('success', __('crud.messages.has_been_deleted', [
+                    'model' => Str::ucfirst(__('models.classes.user'))
+                ]));
+        }
+        return redirect()->back()
+            ->with('error', __('crud.messages.cannot_be_deleted', [
+                'model' => Str::ucfirst(__('models.classes.user'))
+            ]));
+    }
+
+    /**
+     * Duplicate the specified resource.
+     *
+     * @param \App\Models\User $user
+     * @return \Illuminate\Contracts\View\View
+     */
+    public function duplicate(User $user): \Illuminate\Contracts\View\View
+    {
+        return $this->create($user->replicate());
+    }
+}

app/Http/Controllers/Controller.php

@@ -2,37 +2,42 @@
 
 namespace App\Http\Controllers;
 
+use App\Enums\Pagination\ItemsPerPaginationEnum;
+use App\Enums\Theme\BootstrapThemeEnum;
+use App\Lib\Helpers\ToolboxHelper;
 use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Foundation\Auth\Access\AuthorizesRequests;
-use Illuminate\Foundation\Bus\DispatchesJobs;
 use Illuminate\Foundation\Validation\ValidatesRequests;
+use Illuminate\Http\Request;
 use Illuminate\Routing\Controller as BaseController;
+use Illuminate\Support\Facades\Cache;
 use Illuminate\Support\Facades\Schema;
 use Illuminate\Support\Facades\Session;
+use Illuminate\Support\Str;
 
 class Controller extends BaseController
 {
     use AuthorizesRequests;
-    use DispatchesJobs;
     use ValidatesRequests;
 
     /**
      * Build Search query on specified fields
      * splitting search into words or using whole sentence
      *
-     * @param Builder  $query       The eloquent query builder.
-     * @param string   $search      The query string.
-     * @param callable $searchQuery The query string.
-     * @param string   ...$fields   Either a simple array or a string
-     * in case of a string the two fields would be concatenate to make the search.
-     * @return Builder
+     * @param \Illuminate\Database\Eloquent\Builder $query       The eloquent query builder.
+     * @param string                                $search      The query string.
+     * @param callable                              $searchQuery The query string.
+     * @param string                                ...$fields   Either a simple array or a string
+     *                                                           in case of a string the two fields
+     *                                                           would be concatenate to make the search.
+     * @return \Illuminate\Database\Eloquent\Builder
      */
     protected function searchQuery(
         Builder $query,
         string $search,
         callable $searchQuery = null,
         string ...$fields
-    ): Builder {
+    ): \Illuminate\Database\Eloquent\Builder {
         if (count($fields)) {
             // Search using words.
             $words = explode(' ', $search);
@@ -56,66 +61,178 @@ class Controller extends BaseController
     /**
      * Build query search on all fields
      *
-     * @param Builder $query
-     * @param string  $search
-     * @param array   $fields
-     * @return Builder
+     * @param \Illuminate\Database\Eloquent\Builder $query
+     * @param string                                $search
+     * @param array                                 $fields
+     * @return \Illuminate\Database\Eloquent\Builder
      */
-    private function searchOnFields(Builder $query, string $search, array $fields): Builder
-    {
+    private function searchOnFields(
+        Builder $query,
+        string $search,
+        array $fields
+    ): \Illuminate\Database\Eloquent\Builder {
         $table = $query->getModel()->getTable();
-        foreach ($fields as $f) {
-            $f = str_replace('?', '\?', $f);
-            if (is_array($f)) {
+        foreach ($fields as $field) {
+            $field = str_replace('?', '\?', $field);
+            if (is_array($field)) {
                 $query->orWhereRaw(
-                    sprintf("UPPER(CONCAT(%s)) LIKE UPPER(?)", collect($f)->map(function ($q) use ($table) {
+                    sprintf("UPPER(CONCAT(%s)) LIKE UPPER(?)", collect($field)->map(function ($q) use ($table) {
                         return "`$table`.`$q`";
                     })->implode(', \' \', ')),
-                    ['%' . filter_var($search, FILTER_SANITIZE_STRING) . '%']
-                );
-            } else {
-                $query->orWhereRaw(
-                    "UPPER(`$table`.`$f`) LIKE UPPER(?)",
-                    ['%' . filter_var($search, FILTER_SANITIZE_STRING) . '%']
+                    ['%' . htmlspecialchars($search) . '%']
                 );
+                return $query;
             }
-        }
+            // Get models woth enum's label.
+            if (is_array($this->getSearchValue($query, $search, $field))) {
+                foreach ($this->getSearchValue($query, $search, $field) as $array) {
+                    $query->orWhereRaw(
+                        "UPPER(`$table`.`$field`) LIKE UPPER(?)",
+                        ['%' . htmlspecialchars($array->value) . '%']
+                    );
+                }
+                return $query;
+            }
+            // Get models with relation's name/label.
+            if (Str::endsWith($field, '_id')) {
+                $query->orWhereHas(Str::remove('_id', $field), function ($queryRelation) use ($field, $search) {
+                    if (Schema::hasColumn(Str::remove('_id', $field) . 's', 'name')) {
+                        $queryRelation->where('name', 'like', '%' . $search . '%');
+                    } elseif (Schema::hasColumn(Str::remove('_id', $field) . 's', 'label')) {
+                        $queryRelation->where('label', 'like', '%' . $search . '%');
+                    }
+                });
+                return $query;
+            }
+            $query->orWhereRaw(
+                "UPPER(`$table`.`$field`) LIKE UPPER(?)",
+                ['%' . htmlspecialchars($this->getSearchValue($query, $search, $field)) . '%']
+            );
+        } //end foreach
         return $query;
     }
 
     /**
-     * Sort columns with a query
+     * Get the search value (on string or Enum).
      *
-     * @param Builder $query
-     * @param array   $ignore
-     * @return Builder
+     * @param \Illuminate\Database\Eloquent\Builder $query
+     * @param string                                $search
+     * @param string                                $field
+     * @return string|array
      */
-    protected function sortQuery(Builder $query, array $ignore = []): Builder
+    protected function getSearchValue(Builder $query, string $search, string $field): string|array
+    {
+        $cast = $query->getModel()->getCasts()[$field] ?? null;
+        if (
+            count($query->getModel()->getCasts()) and // Check if the model has casts.
+            $cast and // Check if there is cast about specific field.
+            enum_exists($cast) // Check if the cast is an enum.
+        ) {
+            /** @var \App\Traits\Enums $cast */
+            // @phpstan-ignore-next-line
+            $cases = collect($cast::toArray());
+            $enum  = $cases->filter(function ($item) use ($search) {
+                return preg_match('/' . Str::lower($search) . '/', Str::lower($item->label));
+            });
+            return $enum->toArray();
+        } else {
+            return $search;
+        }
+    }
+
+    /**
+     * Sort columns with a query.
+     *
+     * @param \Illuminate\Database\Eloquent\Builder $query
+     * @param array                                 $ignore
+     * @return \Illuminate\Database\Eloquent\Builder
+     */
+    protected function sortQuery(Builder $query, array $ignore = []): \Illuminate\Database\Eloquent\Builder
     {
         $rName = request()->route()->getName();
         $table = $query->getModel()->getTable();
-        if (request()->sort_col) {
-            Session::put("$rName.sort_col", request()->sort_col);
+        if (request()->input('sort_col')) {
+            Session::put("$rName.sort_col", request()->input('sort_col'));
+            Session::put("$rName.sorted", true);
         }
-        if (request()->sort_way) {
-            Session::put("$rName.sort_way", request()->sort_way);
+        if (request()->input('sort_way')) {
+            Session::put("$rName.sort_way", request()->input('sort_way'));
+            Session::put("$rName.sorted", true);
         }
         if (request()->rst) {
+            Session::remove("$rName.sorted");
             Session::remove("$rName.sort_col");
             Session::remove("$rName.sort_way");
         }
-        if (request()->sort_col and request()->sort_way and Schema::hasColumn($table, request()->sort_col)) {
-            if (
-                !isset($ignore) or
-                (isset($ignore) and !in_array(request()->sort_col, $ignore))
-            ) {
-                $query = $query->orderBy(\sprintf("$table.%s", request()->sort_col), request()->sort_way);
+        if (
+            request()->input('sort_col') and
+            request()->input('sort_way') and
+            Schema::hasColumn($table, request()->input('sort_col'))
+        ) {
+            if (!in_array(request()->input('sort_col'), $ignore)) {
+                $query = $query->orderBy(
+                    \sprintf("$table.%s", request()->input('sort_col')),
+                    request()->input('sort_way')
+                );
             }
         } elseif (Schema::hasColumn($table, 'order')) {
             $query = $query->orderBy('order', 'ASC');
             Session::put("$rName.sort_col", 'order');
             Session::put("$rName.sort_way", 'asc');
+        } elseif (Schema::hasColumn($table, 'updated_at')) {
+            $query = $query->orderBy('updated_at', 'DESC');
+            Session::put("$rName.sort_col", 'updated_at');
+            Session::put("$rName.sort_way", 'desc');
+        } elseif (Schema::hasColumn($table, 'created_at')) {
+            $query = $query->orderBy('created_at', 'DESC');
+            Session::put("$rName.sort_col", 'created_at');
+            Session::put("$rName.sort_way", 'desc');
         }
         return $query;
     }
+
+    /**
+     * Customize pagination with cache or config (default).
+     *
+     * @param \Illuminate\Database\Eloquent\Builder             $query
+     * @param \App\Enums\Pagination\ItemsPerPaginationEnum|null $pagination
+     * @return \Illuminate\Contracts\Pagination\LengthAwarePaginator
+     */
+    protected function paginate(
+        Builder $query,
+        ItemsPerPaginationEnum $pagination = null
+    ): \Illuminate\Contracts\Pagination\LengthAwarePaginator {
+        $currentRoutePath = Str::slug(request()->route()->getName());
+        $cacheKey         = "pagination.{$currentRoutePath}";
+        $pagination       = $pagination ?? ItemsPerPaginationEnum::twelve;
+        $pagination       = ToolboxHelper::getValidatedEnum(
+            Cache::get($cacheKey, $pagination->value()),
+            'pagination',
+            '\App\Enums\Pagination\ItemsPerPaginationEnum',
+        );
+        if (Cache::get($cacheKey) !== $pagination) {
+            Cache::put($cacheKey, $pagination);
+        }
+        $query = $query->paginate($pagination);
+        return $query;
+    }
+
+    /**
+     * Set the bootstrap theme or light (default).
+     *
+     * @param \Illuminate\Http\Request $request
+     * @return \Illuminate\Http\RedirectResponse
+     */
+    protected function setTheme(Request $request): \Illuminate\Http\RedirectResponse
+    {
+        $theme = ToolboxHelper::getValidatedEnum(
+            $request->theme ?: Cache::get('theme', BootstrapThemeEnum::light->value()),
+            'theme',
+            '\App\Http\Controllers\BootstrapThemeEnum',
+        );
+        if (Cache::get("theme") !== $theme) {
+            Cache::put("theme", $theme);
+        }
+        return redirect()->back()->with('success', __('crud.messages.theme_updated'));
+    }
 }

app/Http/Controllers/Fo/HomeController.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace App\Http\Controllers\Fo;
+
+use App\Enums\StaticPageType;
+use App\Http\Controllers\Controller;
+use App\Models\GeneralConfig;
+use App\Models\StaticPage;
+
+class HomeController extends Controller
+{
+    /**
+     * Display a listing of the resource.
+     *
+     * @return \Illuminate\Contracts\View\View
+     */
+    public function index(): \Illuminate\Contracts\View\View
+    {
+        $configList            = GeneralConfig::all()->keyBy(function (GeneralConfig $item) {
+            return $item->type->value();
+        });
+        $legalsStaticPageModel = StaticPage::query()->where('type', StaticPageType::legals)->first();
+        $confidStaticPageModel = StaticPage::query()->where('type', StaticPageType::confidentiality)->first();
+        return view('fo.pages.home', compact('configList', 'legalsStaticPageModel', 'confidStaticPageModel'));
+    }
+}

app/Http/Controllers/Fo/OnePageController.php

@@ -1,20 +0,0 @@
-<?php
-
-namespace App\Http\Controllers\Fo;
-
-use App\Http\Controllers\Controller;
-use App\Models\GeneralConfig;
-
-class OnePageController extends Controller
-{
-    /**
-     * Show one page
-     *
-     * @return \Illuminate\Contracts\View\View|\Illuminate\Contracts\View\Factory
-     */
-    public function index()
-    {
-        $configList = GeneralConfig::all()->keyBy('type');
-        return view('fo.onepage', \compact('configList'));
-    }
-}

app/Http/Kernel.php

@@ -16,7 +16,7 @@ class Kernel extends HttpKernel
     protected $middleware = [
         \App\Http\Middleware\TrustHosts::class,
         \App\Http\Middleware\TrustProxies::class,
-        \Fruitcake\Cors\HandleCors::class,
+        \Illuminate\Http\Middleware\HandleCors::class,
         \App\Http\Middleware\PreventRequestsDuringMaintenance::class,
         \Illuminate\Foundation\Http\Middleware\ValidatePostSize::class,
         \App\Http\Middleware\TrimStrings::class,
@@ -34,12 +34,22 @@ class Kernel extends HttpKernel
             \App\Http\Middleware\EncryptCookies::class,
             \Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class,
             \Illuminate\Session\Middleware\StartSession::class,
-            \Illuminate\Session\Middleware\AuthenticateSession::class,
             \Illuminate\View\Middleware\ShareErrorsFromSession::class,
             \App\Http\Middleware\VerifyCsrfToken::class,
             \Illuminate\Routing\Middleware\SubstituteBindings::class,
             \App\Http\Middleware\SecureHeaders::class
-        ]
+        ],
+
+        'saml' => [
+            \App\Http\Middleware\EncryptCookies::class,
+            \Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class,
+            \Illuminate\Session\Middleware\StartSession::class,
+        ],
+
+        'api' => [
+            \Illuminate\Routing\Middleware\ThrottleRequests::class . ':api',
+            \Illuminate\Routing\Middleware\SubstituteBindings::class,
+        ],
     ];
 
     /**
@@ -49,16 +59,18 @@ class Kernel extends HttpKernel
      *
      * @var array<string, class-string|string>
      */
-    protected $routeMiddleware = [
-        'auth' => \App\Http\Middleware\Authenticate::class,
-        'auth.basic' => \Illuminate\Auth\Middleware\AuthenticateWithBasicAuth::class,
-        'cache.headers' => \Illuminate\Http\Middleware\SetCacheHeaders::class,
-        'can' => \Illuminate\Auth\Middleware\Authorize::class,
-        'guest' => \App\Http\Middleware\RedirectIfAuthenticated::class,
+    protected $middlewareAliases = [
+        'auth'             => \App\Http\Middleware\Authenticate::class,
+        'auth.basic'       => \Illuminate\Auth\Middleware\AuthenticateWithBasicAuth::class,
+        'auth.session'     => \Illuminate\Session\Middleware\AuthenticateSession::class,
+        'cache.headers'    => \Illuminate\Http\Middleware\SetCacheHeaders::class,
+        'can'              => \Illuminate\Auth\Middleware\Authorize::class,
+        'guest'            => \App\Http\Middleware\RedirectIfAuthenticated::class,
         'password.confirm' => \Illuminate\Auth\Middleware\RequirePassword::class,
-        'signed' => \Illuminate\Routing\Middleware\ValidateSignature::class,
-        'throttle' => \Illuminate\Routing\Middleware\ThrottleRequests::class,
-        'verified' => \Illuminate\Auth\Middleware\EnsureEmailIsVerified::class,
-        'htmlsanitize' => \App\Http\Middleware\HtmlSanitizer::class
+        'signed'           => \App\Http\Middleware\ValidateSignature::class,
+        'throttle'         => \Illuminate\Routing\Middleware\ThrottleRequests::class,
+        'verified'         => \Illuminate\Auth\Middleware\EnsureEmailIsVerified::class,
+        'htmlsanitize'     => \App\Http\Middleware\HtmlSanitizer::class,
+        'admin-secure'     => \App\Http\Middleware\AdminSecureMiddleware::class,
     ];
 }

app/Http/Middleware/AdminSecureMiddleware.php

@@ -0,0 +1,49 @@
+<?php
+
+namespace App\Http\Middleware;
+
+use App\Lib\AdminSecure;
+use Closure;
+use Dxw\CIDR\IP;
+use Illuminate\Http\Request;
+
+class AdminSecureMiddleware
+{
+    /**
+     * Handle an incoming request.
+     *
+     * @param  \Illuminate\Http\Request $request
+     * @param  \Closure                 $next
+     * @return mixed
+     */
+    public function handle(Request $request, Closure $next)
+    {
+        if (config('app.env') === 'local') {
+            return $next($request);
+        }
+
+        $client_ip     = AdminSecure::fetchClientIp();
+
+        $ip_is_allowed = \collect(AdminSecure::getOptions()->getCidrList())
+            ->reduce(function ($initial, $ip_range) use ($client_ip) {
+                return $initial || IP::contains(
+                    $ip_range,
+                    $client_ip
+                )->unwrap();
+            });
+
+        $ip_is_allowed_by_config = \collect(AdminSecure::getOptions()->getCidrAllowedList())
+            ->reduce(function ($initial, $ip_range) use ($client_ip) {
+                return $initial || IP::contains(
+                    $ip_range,
+                    $client_ip
+                )->unwrap();
+            });
+
+        if ($ip_is_allowed or $ip_is_allowed_by_config or AdminSecure::ipIsPrivate($client_ip)) {
+            return $next($request);
+        }
+
+        abort(403, \trans('Denied IP'));
+    }
+}

app/Http/Middleware/Authenticate.php

@@ -3,6 +3,7 @@
 namespace App\Http\Middleware;
 
 use Illuminate\Auth\Middleware\Authenticate as Middleware;
+use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Session;
 
 class Authenticate extends Middleware
@@ -12,9 +13,8 @@ class Authenticate extends Middleware
      *
      * @param  \Illuminate\Http\Request $request
      * @return string|null
-     * @phpcs:disable Squiz.Commenting.FunctionComment.TypeHintMissing
      */
-    protected function redirectTo($request)
+    protected function redirectTo(Request $request): ?string
     {
         $logins = [
             'backend' => route('bo.login')
@@ -31,8 +31,9 @@ class Authenticate extends Middleware
                     }
                 }
             }
-            return collect($logins)->first() ?? '/';
+            return route('login');
         }
-        abort(401);
+
+        return null;
     }
 }

app/Http/Middleware/EncryptCookies.php

@@ -11,6 +11,5 @@ class EncryptCookies extends Middleware
      *
      * @var array<int, string>
      */
-    protected $except = [
-            ];
+    protected $except = [];
 }

app/Http/Middleware/HtmlSanitizer.php

@@ -2,8 +2,9 @@
 
 namespace App\Http\Middleware;
 
-use App\Lib\ToolboxHelper;
+use App\Lib\Helpers\ToolboxHelper;
 use Illuminate\Http\Request;
+use Symfony\Component\HttpFoundation\Response;
 
 class HtmlSanitizer
 {
@@ -12,21 +13,34 @@ class HtmlSanitizer
      *
      * @param  \Illuminate\Http\Request $request
      * @param  \Closure                 $next
-     * @param  mixed                    ...$params
-     * @return mixed
+     * @param  string|array             ...$params
+     * @return \Symfony\Component\HttpFoundation\Response
      */
-    public function handle(Request $request, \Closure $next, ...$params)
+    public function handle(Request $request, \Closure $next, string|array ...$params): Response
     {
         $inputs = $request->all();
-        array_walk_recursive($inputs, function (&$input, $name) use ($params) {
+        /** @var callable|null */
+        $cleanInput = null;
+        $cleanInput = function (
+            null|string|array &$input,
+            string $name,
+            ?string $rootName = null
+        ) use (
+            $params,
+            &$cleanInput
+        ): void {
+            // * Nested element array
+            if (is_array($input)) {
+                array_walk_recursive($input, $cleanInput, $name);
+            }
             if (!is_string($input)) {
                 return;
             }
-            if (in_array($name, $params)) {
+            if (in_array($name, $params) or in_array($rootName ?? $name, $params)) {
                 // ? Is a json input ?
                 if ($isJson = \json_decode($input, true) and is_array($isJson)) {
                     // ! Decode each json field recursive.
-                    \array_walk_recursive($isJson, function (&$item) {
+                    \array_walk_recursive($isJson, function (string|array &$item) {
                         if (\is_string($item)) {
                             $item = clean($item);
                             $item = ToolboxHelper::stripCkEditorSchemesOnMediaInputs($item);
@@ -39,7 +53,8 @@ class HtmlSanitizer
             } else {
                 $input = strip_tags($input);
             }
-        });
+        };
+        \array_walk($inputs, $cleanInput);
         $request->merge($inputs);
         return $next($request);
     }

app/Http/Middleware/PreventRequestsDuringMaintenance.php

@@ -11,6 +11,5 @@ class PreventRequestsDuringMaintenance extends Middleware
      *
      * @var array<int, string>
      */
-    protected $except = [
-            ];
+    protected $except = [];
 }

app/Http/Middleware/RedirectIfAuthenticated.php

@@ -3,28 +3,38 @@
 namespace App\Http\Middleware;
 
 use Illuminate\Http\Request;
-use Illuminate\Support\Facades\Auth;
+use Symfony\Component\HttpFoundation\Response;
 
 class RedirectIfAuthenticated
 {
     /**
      * Handle an incoming request.
      *
-     * @param  \Illuminate\Http\Request $request
-     * @param  \Closure                 $next
-     * @param  string|null              ...$guards
-     * @return \Illuminate\Http\Response|\Illuminate\Http\RedirectResponse
+     * @param  \Illuminate\Http\Request                                                         $request
+     * @param  \Closure(\Illuminate\Http\Request): (\Symfony\Component\HttpFoundation\Response) $next
+     * @param  string|null                                                                      ...$guards
+     * @return \Symfony\Component\HttpFoundation\Response
+     * @throws \RuntimeException If guard is unhandled.
+     * @phpcs:disable Squiz.Commenting.FunctionComment.IncorrectTypeHint
      */
-    public function handle(Request $request, \Closure $next, ...$guards)
+    public function handle(Request $request, \Closure $next, ...$guards): Response
     {
-        $logins = [
-            'backend' => route('bo.dashboard')
-        ];
+        // phpcs:enable phpcs:disable
         $guards = empty($guards) ? [null] : $guards;
 
         foreach ($guards as $guard) {
-            if (Auth::guard($guard)->check()) {
-                return \redirect()->to($logins[$guard]);
+            if (auth($guard)->check()) {
+                switch ($guard) {
+                    case 'frontend':
+                        return \redirect()->route('fo.homepage');
+                    case 'backend':
+                        if (!$request->routeIs('bo.*')) {
+                            continue;
+                        }
+                        return \redirect()->route('bo.dashboard');
+                    default:
+                        throw new \RuntimeException("Unhandled guard `{$guard}` .");
+                }
             }
         }
 

app/Http/Middleware/SecureHeaders.php

@@ -2,10 +2,10 @@
 
 namespace App\Http\Middleware;
 
-use Closure;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Route;
 use Illuminate\Support\Facades\View;
+use Illuminate\Support\Facades\Vite;
 
 class SecureHeaders
 {
@@ -26,16 +26,17 @@ class SecureHeaders
      *
      * @param  \Illuminate\Http\Request $request
      * @param  \Closure                 $next
-     * @return \Illuminate\Http\Response|\Illuminate\Http\RedirectResponse
+     * @return \Symfony\Component\HttpFoundation\Response
      */
-    public function handle(Request $request, Closure $next)
+    public function handle(Request $request, \Closure $next): \Symfony\Component\HttpFoundation\Response
     {
-        View::share('nonce', $nonce = \uniqid());
+        // * For Vite DEV
+        $host = \parse_url(\config('app.url'), \PHP_URL_HOST);
+        View::share('nonce', $nonce = Vite::useCspNonce());
         // * For VueJS dev tool to execute
-        $jsDev     = config('app.debug') ? "'unsafe-eval' 'unsafe-inline'" : "'nonce-$nonce'";
-        $cssDev    = config('app.debug') ? "'unsafe-inline'" : "'nonce-$nonce'";
+        $jsDev     = config('app.debug') ? "'unsafe-eval' 'unsafe-inline'" : "'nonce-{$nonce}' 'strict-dynamic'";
         $reportUri = Route::has('cspReportUri') ?
-            \sprintf('report-uri %s', \parse_url(route('cspReportUri'), \PHP_URL_PATH)) : '';
+            \sprintf(' report-uri %s ;', \parse_url(route('cspReportUri'), \PHP_URL_PATH)) : '';
         $this->removeUnwantedHeaders($this->unwantedHeaderList);
         $response = $next($request);
         $response->headers->set('Referrer-Policy', 'no-referrer-when-downgrade');
@@ -44,47 +45,72 @@ class SecureHeaders
         $response->headers->set('X-Frame-Options', 'SAMEORIGIN');
         $response->headers->set('Strict-Transport-Security', 'max-age=31536000; includeSubDomains;');
         $cspPolicies = [
-            "default-src 'self' https://www.youtube.com https://www.google-analytics.com;",
+            "default-src 'none';",
             "manifest-src 'self';",
             // * CKEDITOR Specific https://ckeditor.com/docs/ckeditor5/latest/installation/advanced/csp.html
-            "connect-src 'self' https://www.youtube.com https://www.google-analytics.com;",
-            "img-src *;",
-            // "frame-src https://www.youtube.com;",
-            "font-src 'self';",
+            "connect-src 'self' blob: " . implode(' ', [
+                // * VITE DEV
+                config('app.debug') ? "wss://{$host}:4443" : '',
+                config('app.debug') ? "https://{$host}:4443" : '',
+                'https://yl.s-web.fr'
+            ]) . ';',
+            "img-src 'self' data: blob: " . implode(' ', [
+                // * VITE DEV
+                config('app.debug') ? "https://{$host}:4443" : '',
+                'https://yl.s-web.fr'
+            ]) . ';',
+            "object-src 'self' " . implode(' ', []) . ';',
+            "frame-src 'self' " . implode(' ', [
+                'https://www.google.com/recaptcha/',
+                'https://recaptcha.google.com/recaptcha/',
+                'https://www.google.com/maps/',
+                'https://www.youtube.com',
+                'https://player.vimeo.com',
+                'blob:'
+            ]) . ';',
+            "font-src 'self' data: " . \implode(' ', [
+                // * VITE DEV
+                config('app.debug') ? "https://{$host}:4443" : '',
+                'https://fonts.gstatic.com;'
+            ]) . ';',
             // ! Using CKEditor will must have unsafe-inline style
             // phpcs:ignore Generic.Files.LineLength.TooLong
-            "style-src 'self' 'unsafe-inline';",
+            "style-src 'self' 'unsafe-inline' " . \implode(' ', [
+                'https://cdnjs.cloudflare.com',
+                // * File Manager
+                'https://fonts.googleapis.com',
+                'https://cdn.jsdelivr.net',
+                'https://use.fontawesome.com',
+                'https://fonts.googleapis.com',
+                // * VITE DEV
+                config('app.debug') ? "https://{$host}:4443" : '',
+            ]) . ';',
             // ! If you dont use ckeditor use this
-            // "style-src 'self' $cssDev;",
+            // "style-src 'self' 'nonce-$nonce';",
             // phpcs:ignore Generic.Files.LineLength.TooLong
-            "script-src 'self'  https://www.googletagmanager.com https://www.google-analytics.com $jsDev;"
+            "script-src 'self' {$jsDev} " . \implode(' ', [
+                'https:  blob:',
+                'https://yl.s-web.fr',
+                'https://cdnjs.cloudflare.com',
+                // * VITE DEV
+                config('app.debug') ? "https://{$host}:4443" : '',
+            ]) . ';'
         ];
         $response->headers->set(
             'Content-Security-Policy',
             implode(' ', $cspPolicies) . $reportUri
         );
-        $response->headers->set(
-            'Feature-Policy',
-            implode('; ', [
-                'fullscreen https://www.youtube.com',
-                'accelerometer https://www.youtube.com',
-                'autoplay https://www.youtube.com',
-                'clipboard-write https://www.youtube.com',
-                'encrypted-media https://www.youtube.com',
-                'gyroscope https://www.youtube.com',
-                'picture-in-picture https://www.youtube.com'
-            ])
-        );
+        $response->headers->set('Feature-Policy', 'fullscreen=(self \'https://www.youtube.com\');');
         return $response;
     }
 
     /**
-     * Remove unwanted headers
+     * Remove unwanted headers.
      *
      * @param array $headerList
      * @return void
      */
-    private function removeUnwantedHeaders(array $headerList)
+    private function removeUnwantedHeaders(array $headerList): void
     {
         foreach ($headerList as $header) {
             header_remove($header);

app/Http/Middleware/TrustProxies.php

@@ -10,9 +10,11 @@ class TrustProxies extends Middleware
     /**
      * The trusted proxies for this application.
      *
+     *  ! Added * as tmp Fix for #13
+     *
      * @var array<int, string>|string|null
      */
-    protected $proxies;
+    protected $proxies = '*';
 
     /**
      * The headers that should be used to detect proxies.
@@ -20,7 +22,7 @@ class TrustProxies extends Middleware
      * @var integer
      */
     protected $headers =
-        Request::HEADER_X_FORWARDED_FOR |
+    Request::HEADER_X_FORWARDED_FOR |
         Request::HEADER_X_FORWARDED_HOST |
         Request::HEADER_X_FORWARDED_PORT |
         Request::HEADER_X_FORWARDED_PROTO |

app/Http/Middleware/ValidateSignature.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace App\Http\Middleware;
+
+use Illuminate\Routing\Middleware\ValidateSignature as Middleware;
+
+class ValidateSignature extends Middleware
+{
+    /**
+     * The names of the query string parameters that should be ignored.
+     *
+     * @var array<int, string>
+     */
+    protected $except = [];
+}

app/Http/Middleware/VerifyCsrfToken.php

@@ -12,5 +12,6 @@ class VerifyCsrfToken extends Middleware
      * @var array<int, string>
      */
     protected $except = [
-            ];
+        '/csp-report'
+    ];
 }

app/Http/Requests/Bo/GeneralConfigs/UpdateGeneralConfigRequest.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace App\Http\Requests\Bo\GeneralConfigs;
+
+use App\Enums\GeneralConfigType;
+use App\Http\Requests\Bo\UpdateMiniCrudRequest;
+use App\Rules\WysiwygLength;
+
+
+class UpdateGeneralConfigRequest extends UpdateMiniCrudRequest
+{
+    /**
+     * The model parameter name
+     *
+     * @var string
+     */
+    protected $modelName = 'general_config';
+
+    public function rules(): array
+{
+    $rules = parent::rules();
+
+    if ($this->route('general_config')?->type === GeneralConfigType::engagement) {
+        foreach ([1, 2, 3, 4] as $i) {
+            $rules['data.engagement_' . $i . '_text.value'] = [
+                'required',
+                'string',
+                new WysiwygLength(10, 1500),
+            ];
+        }
+    }
+
+    return $rules;
+}
+}

app/Http/Requests/Bo/StaticPages/UpdateStaticPageRequest.php

@@ -0,0 +1,59 @@
+<?php
+
+namespace App\Http\Requests\Bo\StaticPages;
+
+use App\Rules\WysiwygLength;
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Support\Facades\Gate;
+use Illuminate\Support\Str;
+
+class UpdateStaticPageRequest extends FormRequest
+{
+    /**
+     * Determine if the user is authorized to make this request.
+     *
+     * @return boolean
+     */
+    public function authorize(): bool
+    {
+        return Gate::check('update', $this->route('static_page'));
+    }
+
+    /**
+     * Prepare the data for validation.
+     *
+     * @return void
+     */
+    public function prepareForValidation(): void
+    {
+        $this->merge([
+            'content' => Str::of($this->input('content'))->value()
+        ]);
+    }
+
+    /**
+     * Get the validation rules that apply to the request.
+     *
+     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
+     */
+    public function rules(): array
+    {
+        return [
+            'title'   => 'required|min:3|max:255',
+            'content' => ['required', 'string', new WysiwygLength(15)],
+        ];
+    }
+
+    /**
+     * Get custom attributes for validator errors.
+     *
+     * @return array
+     */
+    public function attributes(): array
+    {
+        return [
+            'title'   => trans('validation.attributes.title'),
+            'content' => trans('validation.attributes.content'),
+        ];
+    }
+}

app/Http/Requests/Bo/UpdateChangeOrderRequest.php

@@ -0,0 +1,42 @@
+<?php
+
+namespace App\Http\Requests\Bo;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class UpdateChangeOrderRequest extends FormRequest
+{
+    /**
+     * Determine if the user is authorized to make this request.
+     *
+     * @return boolean
+     */
+    public function authorize(): bool
+    {
+        return auth()->check();
+    }
+
+    /**
+     * Prepare the data for validation.
+     *
+     * @return void
+     */
+    protected function prepareForValidation(): void
+    {
+        $this->merge([
+            'direction' => $this->route('direction') === 'up' ? true : false
+        ]);
+    }
+
+    /**
+     * Get the validation rules that apply to the request.
+     *
+     * @return array
+     */
+    public function rules(): array
+    {
+        return [
+            'direction' => 'required|boolean',
+        ];
+    }
+}

app/Http/Requests/Bo/UpdateGeneralConfigRequest.php

@@ -1,13 +0,0 @@
-<?php
-
-namespace App\Http\Requests\Bo;
-
-class UpdateGeneralConfigRequest extends UpdateMiniCrudRequest
-{
-    /**
-     * The model parameter name
-     *
-     * @var string
-     */
-    protected $modelName = 'general_config';
-}

app/Http/Requests/Bo/UpdateMiniCrudRequest.php

@@ -3,14 +3,14 @@
 namespace App\Http\Requests\Bo;
 
 use App\Enums\InputType;
-use App\Lib\ToolboxHelper;
+use App\Lib\Helpers\ToolboxHelper;
 use Illuminate\Foundation\Http\FormRequest;
 use Illuminate\Validation\ValidationException;
 
 abstract class UpdateMiniCrudRequest extends FormRequest
 {
     /**
-     * The model parameter name
+     * The model parameter name.
      *
      * @var string
      */
@@ -30,29 +30,30 @@ abstract class UpdateMiniCrudRequest extends FormRequest
      * Get the validation rules that apply to the request.
      *
      * @return array
-     * @phpcs:disable Generic.Metrics.CyclomaticComplexity.TooHigh
      * @phpcs:disable Generic.Metrics.NestingLevel.TooHigh
+     * @phpcs:disable Generic.Metrics.CyclomaticComplexity.TooHigh
      */
     public function rules()
     {
         // phpcs:enable
         $rules = [];
-        foreach ($this->{$this->modelName}->data as $iptName => $input) {
+        $data  = $this->{$this->modelName}->data ?? null;
+        foreach ($data as $iptName => $input) {
             $input = \json_decode(\json_encode($input), true);
             switch ($input['inputType']['value']) {
-                case InputType::number()->value:
+                case InputType::number->value:
                     $rules = array_merge($rules, [
                         "data.$iptName.value" => $this->compileValidate('required|numeric', $input)
                     ]);
                     break;
-                case InputType::string()->value:
+                case InputType::string->value:
                     $rules = array_merge($rules, [
                         "data.$iptName.value" => $this->compileValidate('required|string|min:3', $input)
                     ]);
                     break;
-                case InputType::text()->value:
+                case InputType::text->value:
                     $mergeRules = $this->compileValidate('required|string|min:15', $input);
-                    $mergeRules = collect(\explode('|', $mergeRules))
+                    $mergeRules = collect($mergeRules)
                         ->map(function ($rule) {
                             if (\strpos($rule, 'max:') !== false) {
                                 $max = \intval(str_replace('max:', '', $rule));
@@ -63,41 +64,49 @@ abstract class UpdateMiniCrudRequest extends FormRequest
                                 };
                             }
                             return $rule;
-                        });
+                        })->all();
                     $rules      = array_merge($rules, [
-                        "data.$iptName.text" => $mergeRules
+                        "data.$iptName.value" => $mergeRules
                     ]);
                     break;
-                case InputType::image()->value:
-                    $ipt   = $this->data[$iptName];
-                    $max   = isset($ipt['dimensionsMax']);
-                    $dim   = collect(explode(
+                case InputType::image->value:
+                    $required = $this->isUpdate() ? 'sometimes' : 'required';
+
+                    $ipt = $this->data[$iptName];
+                    $max = isset($ipt['dimensionsMax']);
+                    $dim = \is_string($input['dimensions']) ? collect(explode(
                         ',',
-                        $ipt['dimensionsMax'] ?? $input['dimensions']
+                        (isset($ipt['dimensionsMax']) and is_string($ipt['dimensionsMax'])) ?
+                            $ipt['dimensionsMax'] : $input['dimensions']
                     ))->mapWithKeys(function ($v) {
                         $v = explode(' ', $v);
                         return [$v[0] => $v[1]];
-                    });
+                    }) : $input['dimensions'];
+
+                    // * Adapt dimensions
+                    $sizes = (object)[
+                        'minHeight' => $dim['height'],
+                        'maxHeight' => $dim['height'],
+                        'minWidth'  => $dim['width'],
+                        'maxWidth'  => $dim['width'],
+                    ];
                     $rules = array_merge($rules, [
                         "data.$iptName.value" => $this->compileValidate(
-                            implode('|', [
-                                'sometimes',
-                                'image',
-                                'mimes:png,jpg,jpeg',
-                                sprintf(
-                                    'dimensions:%s=%d,%s=%d',
-                                    $max ? 'max_height' : 'height',
-                                    $dim['hauteur'],
-                                    $max ? 'max_width' : 'width',
-                                    $dim['largeur']
-                                )
-                            ]),
+                            $required,
                             $input
                         ),
-                        "data.$iptName.alt" => $this->compileValidate('sometimes|string|min:5', $input)
+                        "data.$iptName.value" => [
+                            function (string $attribute, $value, callable $fail) use ($sizes) {
+                                if ($value) {
+                                    ToolboxHelper::validatePicture($attribute, $value, $fail, $sizes);
+                                }
+                            }
+                        ],
+                        "data.$iptName.alt"   => $this->compileValidate("$required|string|min:5", $input),
+                        "data.$iptName.title" => $this->compileValidate("$required|string|min:5", $input)
                     ]);
                     break;
-                case InputType::url()->value:
+                case InputType::url->value:
                     $rules = array_merge($rules, [
                         "data.$iptName.value" => [
                             'required', 'url',
@@ -113,13 +122,13 @@ abstract class UpdateMiniCrudRequest extends FormRequest
                         ]
                     ]);
                     break;
-                case InputType::boolean()->value:
+                case InputType::boolean->value:
                     $all    = $this->all();
                     $nested = ToolboxHelper::dotStringToNestedArray(
                         "data.$iptName.value",
                         $this->input("data.$iptName.value") ? true : false
                     );
-                    $all    = array_merge_recursive_distinct($all, $nested);
+                    $all    = ToolboxHelper::arrayMergeRecursiveDistinct($all, $nested);
                     $this->merge($all);
                     $rules = array_merge($rules, [
                         "data.$iptName.value" => 'boolean'
@@ -133,23 +142,75 @@ abstract class UpdateMiniCrudRequest extends FormRequest
     /**
      * Undocumented function
      *
-     * @param string $inputTypeValidate
-     * @param array  $input
-     * @return string
+     * @param string|array $inputTypeValidate
+     * @param array        $input
+     * @return array
+     * @phpcs:disable Generic.Metrics.CyclomaticComplexity.TooHigh
      */
-    public function compileValidate(string $inputTypeValidate, array $input): string
+    public function compileValidate(string|array $inputTypeValidate, array $input): array
     {
-        if (!isset($input['validate']) or !\is_string($input['validate'])) {
-            return $inputTypeValidate;
+        // phpcs:enable
+        if (\is_string($inputTypeValidate)) {
+            $inputTypeValidate = explode('|', $inputTypeValidate);
         }
-        /** @var array */
-        $inputValidate = explode('|', $input['validate']);
-        $out           = explode('|', $inputTypeValidate);
+        /** @var array|string */
+        $inputValidate = \collect($input)->get('validate', $input);
+        $inputValidate = \is_string($inputValidate) ? explode('|', $inputValidate) : $inputValidate;
         foreach ($inputValidate as $validate) {
-            if (!\in_array($validate, $out)) {
-                $out[] = $validate;
+            if (!\in_array($validate, $inputTypeValidate)) {
+                $inputTypeValidate[] = $validate;
             }
         }
-        return \implode('|', $out);
+
+        $rules = \collect($inputTypeValidate)->unique()->sort(function ($valueA, $valueB) {
+            $valueA = $this->ruleHasToComeFirst($valueA);
+            $valueB = $this->ruleHasToComeFirst($valueB);
+            return $valueA - $valueB;
+        });
+
+        $hasRequire     = $rules->first(fn ($rule) => $rule === 'required') ? true : false;
+        $hasRequireCond = $rules->first(fn ($rule) => \strpos($rule, 'required_') !== false) ? true : false;
+        $hasNullable    = $rules->first(fn ($rule) => \strpos($rule, 'nullable') !== false) ? true : false;
+        $hasSometime    = $rules->first(fn ($rule) => \strpos($rule, 'sometimes') !== false) ? true : false;
+        $hasPresent     = $rules->first(fn ($rule) => \strpos($rule, 'present') !== false) ? true : false;
+
+        if ($hasRequire and ($hasRequireCond or $hasNullable or $hasSometime or $hasPresent)) {
+            $rules = $rules->reject(fn ($rule) => $rule === 'required');
+        }
+        return $rules->all();
+    }
+
+    /**
+     * Does the rule need to come first ?
+     *
+     * @param string $rule
+     * @return integer
+     */
+    private function ruleHasToComeFirst(string $rule): int
+    {
+        $rule    = \collect(\explode(':', $rule, 2))->filter()->first(null, '');
+        $rules   = \collect([
+            'required_if',
+            'required_unless', 'required_with', 'required_with_all',
+            'required_without', 'required_without_all', 'required_with_all',
+            'missing', 'missing_if', 'missing_unless',
+            'missing_with', 'missing_with_all',
+            'nullable', 'sometimes', 'present', 'required'
+        ]);
+        $itemKey = $rules->search(fn (string $firstRule) =>  \strpos($rule, $firstRule) === 0);
+        if (\is_bool($itemKey)) {
+            return $rules->count() + 1;
+        }
+        return $itemKey;
+    }
+
+    /**
+     * Is this request an update request ?
+     *
+     * @return boolean
+     */
+    private function isUpdate(): bool
+    {
+        return $this->isMethod('PUT');
     }
 }

app/Http/Requests/Bo/Users/StoreUserRequest.php

@@ -0,0 +1,66 @@
+<?php
+
+namespace App\Http\Requests\Bo\Users;
+
+use App\Enums\Users\RoleEnum;
+use App\Models\User;
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Support\Facades\Gate;
+use Illuminate\Validation\Rules\Enum;
+
+class StoreUserRequest extends FormRequest
+{
+    /**
+     * Determine if the user is authorized to make this request.
+     *
+     * @return boolean
+     */
+    public function authorize(): bool
+    {
+        return Gate::check('create', User::class);
+    }
+
+    /**
+     * Prepare the data for validation.
+     *
+     * @return void
+     */
+    protected function prepareForValidation(): void
+    {
+        $this->merge([
+            'published' => $this->boolean('published')
+        ]);
+    }
+
+    /**
+     * Get the validation rules that apply to the request.
+     *
+     * @return array
+     */
+    public function rules(): array
+    {
+        return [
+            'first_name' => 'required|string|min:3|max:255',
+            'last_name'  => 'required|string|min:3|max:255',
+            'email'      => 'required|email:rfc,strict,dns,spoof,filter|unique:users,email',
+            'role'       => ['required', new Enum(RoleEnum::class)],
+            'published'  => 'required|boolean',
+        ];
+    }
+
+    /**
+     * Get custom attributes for validator errors.
+     *
+     * @return array
+     */
+    public function attributes(): array
+    {
+        return [
+            'first_name' => trans('validation.attributes.first_name'),
+            'last_name'  => trans('validation.attributes.last_name'),
+            'email'      => trans('validation.attributes.email'),
+            'role'       => trans('validation.attributes.role'),
+            'published'  => trans('validation.custom.publication')
+        ];
+    }
+}

app/Http/Requests/Bo/Users/UpdateUserRequest.php

@@ -0,0 +1,47 @@
+<?php
+
+namespace App\Http\Requests\Bo\Users;
+
+use Illuminate\Support\Facades\Gate;
+use Illuminate\Validation\Rule;
+
+class UpdateUserRequest extends StoreUserRequest
+{
+    /**
+     * Determine if the user is authorized to make this request.
+     *
+     * @return boolean
+     */
+    public function authorize(): bool
+    {
+        return Gate::check('update', $this->route('user'));
+    }
+
+    /**
+     * Prepare the data for validation.
+     *
+     * @return void
+     */
+    protected function prepareForValidation(): void
+    {
+        $this->merge([
+            'published'             => $this->boolean('published')
+        ]);
+    }
+
+    /**
+     * Get the validation rules that apply to the request.
+     *
+     * @return array
+     */
+    public function rules(): array
+    {
+        return array_merge(parent::rules(), [
+            'email'    => [
+                'required',
+                'email:rfc,strict,dns,spoof,filter',
+                Rule::unique('users', 'email')->ignore(\optional($this->route('user'))->getRouteKey())
+            ]
+        ]);
+    }
+}

app/Lib/AdminSecure.php

@@ -0,0 +1,131 @@
+<?php
+
+namespace App\Lib;
+
+use App\Lib\Options;
+use Dxw\CIDR\IPAddress;
+use Dxw\CIDR\IPv4Address;
+use Dxw\CIDR\IPv4Range;
+use Dxw\CIDR\IPv6Address;
+use Dxw\CIDR\IPv6Range;
+
+abstract class AdminSecure
+{
+    /**
+     * Private ipV4 CIDR list
+     *
+     * @var array
+     */
+    private static $private_ip_v4_cidr_list = [
+        '10.0.0.0/8', '172.16.0.0/12', '192.168.0.0/16'
+    ];
+
+    /**
+     * Private ipV4 CIDR loopback
+     *
+     * @var string
+     */
+    private static $private_ip_v4_loopback_cidr = '127.0.0.0/8';
+
+    /**
+     * Private ipV6 CIDR list
+     *
+     * @var array
+     */
+    private static $private_ip_v6_cidr_list = [
+        'fd00::/8'
+    ];
+
+    /**
+     * Private ipV6 CIDR loopback
+     *
+     * @var string
+     */
+    private static $private_ip_v6_loopback_cidr = '::1/128';
+
+    /**
+     * Private options
+     *
+     * @var \App\Lib\Options|null
+     */
+    private static $options = null;
+
+    /**
+     * Check if ip is private
+     *
+     * @param \Dxw\CIDR\IPv4Address|\Dxw\CIDR\IPv6Address $ip_address
+     * @return boolean
+     */
+    public static function ipIsPrivate($ip_address): bool
+    {
+        return \get_class($ip_address) === IPv4Address::class ?
+            self::ipV4IsPrivate($ip_address) : self::ipV6IsPrivate($ip_address);
+    }
+
+    /**
+     * Fetch client IP
+     *
+     * @return \Dxw\CIDR\IPv4Address|\Dxw\CIDR\IPv6Address
+     * @throws \Exception  If the ip is invalid.
+     */
+    public static function fetchClientIp()
+    {
+        // ! REVERSE PROXY HACK.
+        $ip = request()->server('HTTP_X_FORWARDED_FOR') ?? request()->getClientIp();
+        $ip = IPAddress::Make($ip);
+
+        if ($ip->isErr()) {
+            throw new \Exception(\trans('Client IP not valid ') . $ip->getErr());
+        }
+        return $ip->unwrap();
+    }
+
+    /**
+     * Check if ipV4 is private
+     *
+     * @param \Dxw\CIDR\IPv4Address $ipv4_address
+     * @return boolean
+     */
+    private static function ipV4IsPrivate(IPv4Address $ipv4_address): bool
+    {
+        return \collect(self::$private_ip_v4_cidr_list)
+            ->concat([self::$private_ip_v4_loopback_cidr])
+            ->map(function (string $ipv4_cidr) {
+                return IPv4Range::Make($ipv4_cidr)->unwrap();
+            })
+            ->reduce(function ($initial, IPv4Range $ipv4_range) use ($ipv4_address) {
+                return $initial || $ipv4_range->containsAddress($ipv4_address);
+            });
+    }
+
+    /**
+     * Check if ipV6 is private
+     *
+     * @param \Dxw\CIDR\IPv6Address $ipv6_address
+     * @return boolean
+     */
+    private static function ipV6IsPrivate(IPv6Address $ipv6_address): bool
+    {
+        return \collect(self::$private_ip_v6_cidr_list)
+            ->concat([self::$private_ip_v6_loopback_cidr])
+            ->map(function (string $ipv6_cidr) {
+                return IPv6Range::Make($ipv6_cidr)->unwrap();
+            })
+            ->reduce(function ($initial, IPv6Range $ipv6_range, IPv6Address $ipv6_address) {
+                return $initial || $ipv6_range->containsAddress($ipv6_address);
+            });
+    }
+
+    /**
+     * Get Admin secure options
+     *
+     * @return \App\Lib\Options
+     */
+    public static function getOptions(): Options
+    {
+        if (!self::$options) {
+            self::$options = new Options(\config('admin-secure'));
+        }
+        return self::$options;
+    }
+}

app/Lib/Helpers/CollectionHelper.php

@@ -0,0 +1,64 @@
+<?php
+
+namespace App\Lib\Helpers;
+
+use Illuminate\Container\Container;
+use Illuminate\Pagination\LengthAwarePaginator;
+use Illuminate\Pagination\Paginator;
+use Illuminate\Support\Collection;
+
+class CollectionHelper
+{
+    /**
+     * Paginate a collection
+     *
+     * @param \Illuminate\Support\Collection $results
+     * @param integer                        $pageSize
+     * @return \Illuminate\Pagination\LengthAwarePaginator
+     */
+    public static function paginate(Collection $results, int $pageSize): LengthAwarePaginator
+    {
+        $page = Paginator::resolveCurrentPage('page');
+
+        return self::paginateManually($results, $pageSize, $page);
+    }
+
+    /**
+     * Paginate a collection
+     *
+     * @param \Illuminate\Support\Collection $results
+     * @param integer                        $pageSize
+     * @param integer                        $page
+     * @return \Illuminate\Pagination\LengthAwarePaginator
+     */
+    public static function paginateManually(Collection $results, int $pageSize, int $page = 1): LengthAwarePaginator
+    {
+        $total = $results->count();
+
+        return self::paginator($results->forPage($page, $pageSize), $total, $pageSize, $page, [
+            'path' => Paginator::resolveCurrentPath(),
+            'pageName' => 'page',
+        ]);
+    }
+
+    /**
+     * Create a new length-aware paginator instance.
+     *
+     * @param  \Illuminate\Support\Collection $items
+     * @param  integer                        $total
+     * @param  integer                        $perPage
+     * @param  integer                        $currentPage
+     * @param  array                          $options
+     * @return \Illuminate\Pagination\LengthAwarePaginator
+     */
+    protected static function paginator(Collection $items, int $total, int $perPage, int $currentPage, array $options)
+    {
+        return Container::getInstance()->makeWith(LengthAwarePaginator::class, [
+            'items' => $items,
+            'total' => $total,
+            'perPage' => $perPage,
+            'currentPage' => $currentPage,
+            'options' => $options
+        ]);
+    }
+}

app/Lib/Helpers/ExceptionsHelper.php

@@ -0,0 +1,190 @@
+<?php
+
+namespace App\Lib\Helpers;
+
+class ExceptionsHelper
+{
+    /**
+     * Handle sentry event
+     *
+     * @param \Sentry\Event $event
+     * @return null|\Sentry\Event
+     */
+    public static function sentryEventHandler(\Sentry\Event $event): ?\Sentry\Event
+    {
+        // Remove unwanted reports.
+        $event->setModules([]);
+        $event->setOsContext(null);
+
+        /** @var \Sentry\ExceptionDataBag[] */
+        $exceptionBag = [];
+        foreach ($event->getExceptions() as $exceptionDataBag) {
+            $exceptionBag[] = self::getAnonymizedSentryException($exceptionDataBag);
+        }
+        $event->setExceptions($exceptionBag);
+        return $event;
+    }
+
+    /**
+     * Anonimize Sentry Exception bag
+     *
+     * @param \Sentry\ExceptionDataBag $exceptionDataBag
+     * @return \Sentry\ExceptionDataBag
+     */
+    private static function getAnonymizedSentryException(
+        \Sentry\ExceptionDataBag $exceptionDataBag
+    ): \Sentry\ExceptionDataBag {
+        $exceptionDataBag->setValue(self::getAnonymizedMessage($exceptionDataBag->getValue()));
+        if ($stackTrace = $exceptionDataBag->getStacktrace()) {
+            $exceptionDataBag->setStacktrace(self::getAnonymizedSentryStackTrace($stackTrace));
+        }
+        return $exceptionDataBag;
+    }
+
+    /**
+     * Anonymise sentry stacktrace
+     *
+     * @param \Sentry\Stacktrace $stackTrace
+     * @return \Sentry\Stacktrace
+     */
+    private static function getAnonymizedSentryStackTrace(\Sentry\Stacktrace $stackTrace): \Sentry\Stacktrace
+    {
+        /** @var \Sentry\Frame[] */
+        $frames = \array_reverse($stackTrace->getFrames(), true);
+        $i      = \count($frames) - 1;
+        // * Remove all but keep first (index.php).
+        while ($i-- > 0) {
+            $stackTrace->removeFrame(count($stackTrace->getFrames()) - 1);
+        }
+        foreach ($frames as $index => $frame) {
+            $frame->setPostContext([]);
+            $frame->setPreContext([]);
+            $frame->setContextLine('');
+            $frame->setVars(self::getAnonymizedSentryParams($frame->getVars()));
+            $stackTrace->addFrame($frame);
+            if ($index === 0) {
+                $stackTrace->removeFrame(count($stackTrace->getFrames()) - 1);
+            }
+        }
+        return $stackTrace;
+    }
+
+    /**
+     * Get anonymized sentry params
+     *
+     * @param mixed[] $params
+     * @return string[]
+     */
+    private static function getAnonymizedSentryParams(array $params): array
+    {
+        foreach ($params as &$param) {
+            $type = \strtolower(\gettype($param));
+            if (\is_string($param)) {
+                $type = \explode(' ', \trim(strtolower($param)))[0] ?? null;
+            }
+            switch (true) {
+                case $type === 'lambda':
+                case $type === 'object':
+                    continue 2;
+                case $type === 'array' and \is_array($param):
+                    $param = sprintf('Array(%d)', \count($param));
+                    continue 2;
+                default:
+                    if (\is_numeric($param)) {
+                        $param = \ucfirst($type);
+                        continue 2;
+                    }
+                    if (\is_string($param)) {
+                        $param = sprintf('String(%d)', \strlen($param));
+                        continue 2;
+                    }
+            } //end switch
+        } //end foreach
+        return $params;
+    }
+
+
+    /**
+     * Anonymize at least Sql queries
+     *
+     * @param string $message
+     * @return string
+     */
+    public static function getAnonymizedMessage(string $message): string
+    {
+        $message = \preg_replace('/^(.*)( \(SQL:.*\))$/', '$1', $message) ?? $message;
+        if ($sqlPos = \strpos($message, 'to use near')) {
+            $message = \mb_strcut($message, 0, $sqlPos);
+        }
+        return $message;
+    }
+
+    /**
+     * Anonymize stack trace
+     *
+     * @param \Throwable $e
+     * @return string
+     */
+    public static function getAnonymizedStackTrace(\Throwable $e): string
+    {
+        $projectPath   = \realpath(\sprintf('%s/../', \app_path()));
+        $traceStack    = $e->getTrace();
+        $traceStr      = '';
+        $maxStackStage = 0;
+        foreach ($traceStack as $stackStage => $stack) {
+            $maxStackStage = $stackStage;
+            $traceStr     .= \sprintf(
+                '#%s %s(%d): ',
+                $stackStage,
+                str_replace($projectPath, '', $stack['file'] ?? ''),
+                $stack['line'] ?? ''
+            );
+            if (isset($stack['class'])) {
+                $traceStr .= "{$stack['class']}->{$stack['function']}(";
+                if (isset($stack['args'])) {
+                    $traceStr .= self::handleArgs($stack);
+                }
+                $traceStr .= ")\n";
+            } else {
+                $traceStr .= "{$stack['function']}(";
+                if (isset($stack['args'])) {
+                    $traceStr .= self::handleArgs($stack);
+                }
+                $traceStr .= ")\n";
+            }
+        } //end foreach
+        $maxStackStage++;
+        $traceStr .= "#$maxStackStage {main}";
+        return $traceStr;
+    }
+
+    /**
+     * Handle Args
+     *
+     * @param array $stack
+     * @return string
+     */
+    public static function handleArgs(array $stack): string
+    {
+        $traceArgs = '';
+        $argsCount = count($stack['args']);
+        for ($i = 0; $i < $argsCount; $i++) {
+            $type = \gettype($stack['args'][$i]);
+            switch ($type) {
+                case 'object':
+                    $traceArgs .= sprintf('Object(%s)', \get_class($stack['args'][$i]));
+                    break;
+                case 'array':
+                    $traceArgs .= sprintf('Array(%d)', \count($stack['args'][$i]));
+                    break;
+                case 'string':
+                    $traceArgs .= sprintf('String(%d)', \strlen($stack['args'][$i]));
+                    break;
+                default:
+                    $traceArgs .= \gettype($stack['args'][$i]);
+            }
+            $traceArgs .= ($i !== ($argsCount - 1) ? ',' : '');
+        }
+        return $traceArgs;
+    }
+}

app/Lib/Helpers/FileStorageHelper.php

@@ -0,0 +1,485 @@
+<?php
+
+namespace App\Lib\Helpers;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Support\Facades\File;
+use Illuminate\Support\Facades\Storage;
+use Illuminate\Support\Str;
+
+/**
+ * This class is used to handle files in LDC Laravel stack
+ *
+ *  * The storage strategy will be using date.
+ * The file name may contain sufix timestamp highresolution time (hrtime or microtime) if is duplicate.
+ * (function() { return time() . ' ' . Str::slug(microtime(true)) . ' ' . hrtime(true); })();
+ *
+ * posts/                                                 - The model table name
+ *   10/                                                  - Year
+ *     04/                                                - Month
+ *       19/                                              - Day
+ *         5f/                                            - First two letters of md5 file
+ *           black-cat-under-red-car.png                  - Slugified file name
+ *           black-cat-under-red-car-286071690833400.png  - Slugified file name that is duplicated
+ *
+ * The final path will be storage/modelfiles/posts/10/04/19/5f/black-cat-under-red-car-286071690833400.png
+ *
+ * ! No limits of file per folder will be handled.
+ *
+ * @author Munsch Jérémy <jeremy.munsch@ldc.fr>
+ */
+class FileStorageHelper
+{
+    /**
+     * Remove all files from string attribute html that are stored in public
+     *
+     * @param string $publicStorageFilePath The file path from public directory.
+     * @return string The local storage path.
+     */
+    public static function getFileFullPath(string $publicStorageFilePath): string
+    {
+        /** @var \Illuminate\Filesystem\FilesystemAdapter */
+        $disk = Storage::disk('uploads');
+        $path = ToolboxHelper::mbReplace('storage/', '', \ltrim(\urldecode($publicStorageFilePath), '/'));
+        return $disk->path($path);
+    }
+
+    /**
+     * Destroy the file associate with the attribute.
+     *
+     * @param \Illuminate\Database\Eloquent\Model $model
+     * @param string                              $attribute
+     * @return void
+     */
+    public static function removeFile(Model $model, string $attribute): void
+    {
+        $path = \ltrim(\urldecode($model->{$attribute}), '/');
+        if (\strpos($path, 'storage') !== 0) {
+            return;
+        }
+        $path = ToolboxHelper::mbReplace('storage/', '', $path);
+        if (Storage::disk('public')->exists($path)) {
+            Storage::disk('public')->delete($path);
+        }
+    }
+
+    /**
+     * Destroy the file associate with the attribute old value (before updated to DB).
+     *
+     * @param \Illuminate\Database\Eloquent\Model $model
+     * @param string                              $attribute
+     * @param boolean                             $onlyIfUpdated
+     * @return void
+     */
+    public static function removeOldFile(Model $model, string $attribute, bool $onlyIfUpdated = true): void
+    {
+        // * Ignore If removal has to be done only if the field has changed and it actually hasnt.
+        if ($onlyIfUpdated and $model->{$attribute} === ToolboxHelper::getOriginal($model, $attribute)) {
+            return;
+        }
+        $originalPath = \ltrim(\urldecode(ToolboxHelper::getOriginal($model, $attribute)), '/');
+        if (\strpos($originalPath, 'storage') !== 0) {
+            return;
+        }
+        $originalPath = ToolboxHelper::mbReplace('storage/', '', $originalPath);
+        if (Storage::disk('public')->exists($originalPath)) {
+            Storage::disk('public')->delete($originalPath);
+        }
+    }
+
+    /**
+     * Store a file using optimized storage strategy
+     *
+     * You can use filename param to overload file name.
+     *
+     * @param \Illuminate\Database\Eloquent\Model               $model    The model that will hold the picture.
+     * @param \Illuminate\Http\UploadedFile|\SplFileInfo|string $file     The file, will just return itself is string.
+     * @param boolean                                           $slugify  Force filename slugification.
+     * @param string|null                                       $filename This string may be used to store the file.
+     * @param boolean                                           $private  To store the file in a private space.
+     * @return string
+     * @throws \RuntimeException If file copy fails.
+     * @phpcs:disable Generic.Metrics.CyclomaticComplexity.TooHigh
+     */
+    public static function storeFile(
+        Model $model,
+        $file,
+        bool $slugify = false,
+        string $filename = null,
+        bool $private = false
+    ): string {
+        // phpcs:enable
+        $tableName = $model->getTable();
+        if (\is_object($file) and $file instanceof \Illuminate\Http\UploadedFile) {
+            /** @var \Illuminate\Http\UploadedFile $file */
+            $filename = $filename ?: $file->getClientOriginalName();
+            $filename = $slugify ? self::slugifyFileName($filename) : $filename;
+            $newPath  = self::prepareMoveFile($tableName, $filename, $private);
+            $newPath  = str_replace(storage_path('app'), '', $newPath);
+
+            if (!$private) {
+                // * Store public file.
+                $file->storePubliclyAs(
+                    pathinfo($newPath, \PATHINFO_DIRNAME),
+                    pathinfo($newPath, \PATHINFO_BASENAME)
+                );
+                return 'storage' . str_replace('/public', '', $newPath);
+            }
+
+            $file->storeAs(
+                pathinfo($newPath, \PATHINFO_DIRNAME),
+                pathinfo($newPath, \PATHINFO_BASENAME)
+            );
+
+            return str_replace('/private/', '', $newPath);
+        } //end if
+        if (\is_object($file) and $file instanceof \SplFileInfo) {
+            /** @var \SplFileInfo $file */
+            $filename = $filename ?: $file->getBaseName();
+            $filename = $slugify ? self::slugifyFileName($filename) : $filename;
+            $newPath  = self::prepareMoveFile($tableName, $filename, $private);
+            if (!File::copy($file->getRealPath(), $newPath)) {
+                throw new \RuntimeException(sprintf(
+                    'Failed to copy file %s to %s',
+                    $file->getRealPath(),
+                    $newPath
+                ));
+            }
+            return $private ?
+                \ltrim(str_replace(\storage_path('app/private'), '/storage/app/private', $newPath), '/') :
+                \ltrim(str_replace(\storage_path('app/public'), '/storage', $newPath), '/');
+        }
+        return strval($file);
+    }
+
+    /**
+     * Store all files from string attribute html
+     * If oldHtmlString is passed, a diff is done with new and old files
+     * to keep only files that are present in the new html string.
+     *
+     * @param \Illuminate\Database\Eloquent\Model $model         The model that will hold the picture.
+     * @param string                              $htmlString    The html string to parse and modify files.
+     * @param string|null                         $oldHtmlString The old html string with alreadyParsed
+     *                                                           files using storeModelFilesFromHtml.
+     * @return string Html with files pathes replaced using storage strategy.
+     */
+    public static function storeModelFilesFromHtml(
+        Model $model,
+        string $htmlString,
+        string $oldHtmlString = null
+    ): string {
+        \collect(self::onlyUploadedFilesWithFileManager(self::findFilesInHtml($htmlString)))
+            ->each(function (string $path) use ($model, &$htmlString) {
+                /** @var \Illuminate\Filesystem\FilesystemAdapter */
+                $disk       = Storage::disk('uploads');
+                $fileInfo   = new \SplFileInfo($disk->path(
+                    ToolboxHelper::mbReplace('/uploads/', '', \urldecode($path))
+                ));
+                $htmlString = ToolboxHelper::mbReplace(
+                    $path,
+                    '/' . self::storeFile($model, $fileInfo, true),
+                    $htmlString
+                );
+            });
+
+        if ($oldHtmlString) {
+            self::removeOldModelFilesFromHtml($htmlString, $oldHtmlString);
+        }
+
+        return $htmlString;
+    }
+
+    /**
+     * Remove all old files from string attribute html that are stored in public that
+     * are nove present anymore on new html string
+     *
+     * @param string $newHtmlString The html string with alreadyParsed files using storeModelFilesFromHtml.
+     * @param string $oldHtmlString The old html string with alreadyParsed files using storeModelFilesFromHtml.
+     * @return void
+     */
+    public static function removeOldModelFilesFromHtml(string $newHtmlString, string $oldHtmlString): void
+    {
+        self::removeOldFiles(self::findFilesInHtml($oldHtmlString), self::findFilesInHtml($newHtmlString));
+    }
+
+    /**
+     * Remove all old files that are stored in public that
+     * are not present anymore on new array files
+     *
+     * @param string[] $oldFiles The old array files.
+     * @param string[] $newFiles The new array files.
+     * @return void
+     */
+    public static function removeOldFiles(array $oldFiles, array $newFiles): void
+    {
+        $oldFiles      = \collect(self::onlyUploadedFilesWithFileStorageHelper($oldFiles));
+        $filesToKeep   = \collect(self::onlyUploadedFilesWithFileStorageHelper($newFiles));
+        $filesToRemove = $oldFiles->diff($filesToKeep);
+        $filesToRemove->each(function (string $publicStorageFilePath) {
+            $path = ToolboxHelper::mbReplace('storage/', '', \ltrim(\urldecode($publicStorageFilePath), '/'));
+            if (Storage::disk('public')->exists($path)) {
+                Storage::disk('public')->delete($path);
+            }
+        });
+    }
+
+    /**
+     * Remove all files from string attribute html that are stored in public
+     *
+     * @param string $htmlString The html string with alreadyParsed files using storeModelFilesFromHtml.
+     * @return void
+     */
+    public static function removeModelFilesOfHtml(string $htmlString): void
+    {
+        $filesToRemove = \collect(self::onlyUploadedFilesWithFileStorageHelper(self::findFilesInHtml($htmlString)));
+        $filesToRemove->each(function (string $publicStorageFilePath) {
+            $path = ToolboxHelper::mbReplace('storage/', '', \ltrim(\urldecode($publicStorageFilePath), '/'));
+            if (Storage::disk('public')->exists($path)) {
+                Storage::disk('public')->delete($path);
+            }
+        });
+    }
+
+    /**
+     * Find all occurence of files in html
+     *
+     * @param string $html
+     * @return array
+     */
+    public static function findFilesInHtml(string $html): array
+    {
+        preg_match_all('/href="(?P<href>.*)"|src="(?P<src>.*)"|url="(?P<url>.*)"/Um', $html, $m, PREG_SET_ORDER, 0);
+        return collect($m)->pluck('href')->filter()
+            ->concat(collect($m)->pluck('url')->filter())
+            ->concat(collect($m)->pluck('src')->filter())
+            ->all();
+    }
+
+    /**
+     * Filter array to get only uploaded files that exists
+     * on disk 'public' (using helper storage strategy)
+     *
+     * @param array $urls
+     * @return array
+     */
+    public static function onlyUploadedFilesWithFileStorageHelper(array $urls): array
+    {
+        return \collect($urls)->unique()
+            // * Filter to get only /uploads and using app url or empty
+            ->filter(function (string $url) {
+                $path = \parse_url($url, \PHP_URL_PATH);
+                return \strpos(\ltrim($path, '/'), 'storage/modelfiles') === 0;
+            })->filter(function (string $url) {
+                $path = \parse_url($url, \PHP_URL_PATH);
+                return Storage::disk('public')
+                    ->exists(ToolboxHelper::mbReplace('storage/', '', \ltrim(\urldecode($path), '/')));
+            })->all();
+    }
+
+    /**
+     * Filter array to get only uploaded files that exists
+     * on disk 'uploads'
+     *
+     * @param array $urls
+     * @return array
+     */
+    private static function onlyUploadedFilesWithFileManager(array $urls): array
+    {
+        return \collect($urls)->unique()
+            // * Filter to get only /uploads and using app url or empty
+            ->filter(function (string $url) {
+                $host = \parse_url($url, \PHP_URL_HOST);
+                $path = \parse_url($url, \PHP_URL_PATH);
+                return ($host === \parse_url(config('app.url'), PHP_URL_HOST) or \is_null($host)) and
+                    \strpos(\ltrim($path, '/'), 'uploads') === 0;
+            })->filter(function (string $url) {
+                $path = \parse_url($url, \PHP_URL_PATH);
+                return Storage::disk('uploads')
+                    ->exists(ToolboxHelper::mbReplace('uploads/', '', \ltrim(\urldecode($path), '/')));
+            })->all();
+    }
+
+    /**
+     * Prepare storage path and return
+     * the file full path
+     *
+     * @param string  $tableName Model table name.
+     * @param string  $filename  The basename for the file.
+     * @param boolean $private   May the file be stored in a private dir.
+     * @return string
+     */
+    private static function prepareMoveFile(string $tableName, string $filename, bool $private = false): string
+    {
+        // * Security filter
+        $filename = \htmlspecialchars($filename);
+        // * Security filter + beautifier
+        $filename = self::sanitizeFileName($filename);
+        // * Slugify filename
+        $ext      = \pathinfo($filename, \PATHINFO_EXTENSION);
+        $filename = Str::slug(\pathinfo($filename, \PATHINFO_FILENAME)) .
+            (\strlen($ext) ? ".{$ext}" : '');
+
+        $folderPath = self::getStoragePath(
+            $private ? 'app/private/modelfiles' : 'app/public/modelfiles',
+            $tableName,
+            $filename
+        );
+        $filename   = self::getFileUniqueName($folderPath, $filename);
+        return "{$folderPath}/{$filename}";
+    }
+
+    /**
+     * Create sub folders to store files using pattern
+     * storage/modelfiles/posts/10/04/19/5f
+     * year/month/day/md5 first 2 letters
+     *
+     * @param string $storage_dir
+     * @param string $table
+     * @param string $filename
+     * @return string
+     */
+    private static function getStoragePath(string $storage_dir, string $table, string $filename): string
+    {
+        $filenameHash = \md5($filename);
+        $pathFolder   = \storage_path(sprintf(
+            '%s/%s/%s/%s/%s/%s',
+            $storage_dir,
+            $table,
+            gmdate('y'),
+            gmdate('m'),
+            gmdate('d'),
+            substr($filenameHash, 0, 2)
+        ));
+        if (!File::exists($pathFolder)) {
+            File::makeDirectory($pathFolder, 0755, true);
+        }
+        return $pathFolder;
+    }
+
+    /**
+     * Get unique filename if the path is already occupied
+     *
+     * @param string $folderPath
+     * @param string $filename
+     * @return string
+     * @throws \RuntimeException If a unique filename cannot be obtained.
+     */
+    private static function getFileUniqueName(string $folderPath, string $filename): string
+    {
+        $attempts    = 0;
+        $maxAttempts = 20;
+        while (File::exists("{$folderPath}/{$filename}")) {
+            if ($attempts++ >= $maxAttempts) {
+                throw new \RuntimeException("Failed to have a unique filename for {$folderPath}/{$filename}");
+            }
+            $filename = pathinfo($filename, \PATHINFO_FILENAME) .
+                \uniqid('-') . '.' .
+                pathinfo($filename, \PATHINFO_EXTENSION);
+        }
+        return $filename;
+    }
+
+    /**
+     * Slugify the filename
+     *
+     * @param string $filename
+     * @return string
+     */
+    public static function slugifyFileName(string $filename): string
+    {
+        return Str::slug(pathinfo($filename, \PATHINFO_FILENAME)) . '.' . pathinfo($filename, \PATHINFO_EXTENSION);
+    }
+
+    /**
+     * Sanitize File name for uploaded files
+     *
+     * @param string  $filename The original uploaded client file name.
+     * @param boolean $beautify Beautify the filename.
+     * @return string The sanitized file name.
+     */
+    public static function sanitizeFileName(string $filename, bool $beautify = true): string
+    {
+        // * Sanitize filename
+        // phpcs:disable Generic.Files.LineLength.TooLong
+        $filename = preg_replace(
+            '~
+            [<>:"/\\\|?*]|           # file system reserved https://en.wikipedia.org/wiki/Filename#Reserved_characters_and_words
+            [\x00-\x1F]|             # control characters http://msdn.microsoft.com/en-us/library/windows/desktop/aa365247%28v=vs.85%29.aspx
+            [\x7F\xA0\xAD]|          # non-printing characters DEL, NO-BREAK SPACE, SOFT HYPHEN
+            [#\[\]@!$&\'()+,;=]|     # URI reserved https://tools.ietf.org/html/rfc3986#section-2.2
+            [{}^\~`]                 # URL unsafe characters https://www.ietf.org/rfc/rfc1738.txt
+            ~x',
+            '-',
+            $filename
+        );
+        // phpcs:enable
+        // * Avoids '.' '..' or '.hiddenFiles' .
+        $filename = Str::of($filename)->ltrim('.-');
+        // * Optional beautification
+        if ($beautify) {
+            $filename = self::beautifyFilename($filename);
+        }
+        // * Maximize filename length to 255 bytes http://serverfault.com/a/9548/44086
+        /** @var string */
+        $extension = pathinfo($filename, \PATHINFO_EXTENSION);
+        /** @var string */
+        $filename = pathinfo($filename, \PATHINFO_FILENAME);
+
+        $encoding = mb_detect_encoding($filename);
+        $encoding = $encoding ? $encoding : null;
+        return \mb_strcut(
+            $filename,
+            0,
+            255 - (!empty($extension) ? strlen($extension) + 1 : 0),
+            $encoding
+        ) . (!empty($extension) ? ".$extension" : '');
+    }
+
+    /**
+     * Beautify a filename
+     *
+     * @param string $filename
+     * @return string
+     */
+    private static function beautifyFilename(string $filename): string
+    {
+        // Reduce consecutive characters.
+        $filename = preg_replace([
+            // * "file   name.zip" becomes 'file-name.zip'
+            '/ +/',
+            // * "file___name.zip" becomes 'file-name.zip'
+            '/_+/',
+            // * "file---name.zip" becomes 'file-name.zip'
+            '/-+/'
+        ], '-', $filename);
+        $filename = preg_replace([
+            // * "file--.--.-.--name.zip" becomes "file.name.zip"
+            '/-*\.-*/',
+            // * "file...name..zip" becomes "file.name.zip"
+            '/\.{2,}/'
+        ], '.', $filename);
+        // Lowercase for windows/unix interoperability http://support.microsoft.com/kb/100625 .
+        $filename = mb_strtolower($filename, mb_detect_encoding($filename));
+        // * ".file-name.-" becomes "file-name"
+        $filename = trim($filename, '.-');
+        return $filename;
+    }
+
+    /**
+     * Remove all model files for the given Model.
+     *
+     * @param Model $model
+     * @return void
+     */
+    public static function removeModelFiles(Model $model): void
+    {
+        $tableName = $model::query()->getModel()->getTable();
+
+        if (!empty(Storage::disk('public')->allFiles("modelfiles/{$tableName}"))) {
+            Storage::disk('public')->deleteDirectory("modelfiles/{$tableName}");
+        }
+        if (!empty(Storage::disk('private')->allFiles("modelfiles/{$tableName}"))) {
+            Storage::disk('private')->deleteDirectory("modelfiles/{$tableName}");
+        }
+    }
+}

app/Lib/Helpers/ToolboxHelper.php

@@ -0,0 +1,573 @@
+<?php
+
+namespace App\Lib\Helpers;
+
+use Carbon\Carbon;
+use Illuminate\Contracts\Database\Eloquent\Builder;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Http\Request;
+use Illuminate\Support\Str;
+use Illuminate\Support\Arr;
+use Illuminate\Support\Facades\File;
+use Illuminate\Support\Facades\Http;
+use Illuminate\Support\Facades\Route;
+use Illuminate\Support\Facades\Storage;
+use Illuminate\Support\Facades\Validator;
+use Illuminate\Validation\Rule;
+use Illuminate\Validation\Rules\Enum;
+use Illuminate\Validation\ValidationException;
+use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
+use Symfony\Component\Finder\SplFileInfo;
+
+class ToolboxHelper
+{
+    /**
+     * Run a terminal command and gives the output
+     *
+     * @param array|string $command The command to execute on terminal.
+     * @param boolean      $throw   Wether to throw en esception on failure or not.
+     * @return string|false Return false on failure only if $throw is false.
+     * @phpcs:disable Squiz.Commenting.FunctionComment.EmptyThrows
+     * @phpcs:disable Squiz.Commenting.FunctionCommentThrowTag.WrongNumber
+     * @throws \Illuminate\Process\Exceptions\ProcessTimedOutException
+     * @throws \Symfony\Component\Process\Exception\LogicException
+     * @throws \Symfony\Component\Process\Exception\InvalidArgumentException
+     * @throws \Symfony\Component\Process\Exception\RuntimeException
+     * @throws \LogicException
+     * @throws \RuntimeException If the command fails.
+     */
+    public static function runConsoleCommand(array|string $command, bool $throw = true): string | false
+    {
+        // phpcs:enable
+        $process = \Illuminate\Support\Facades\Process::command($command)->run();
+        if ($process->failed()) {
+            $code  = $process->exitCode();
+            $ouput = $process->errorOutput();
+            if ($throw) {
+                throw new \RuntimeException("Failed to run command exit code {$code} with output \n{$ouput}");
+            }
+            return false;
+        }
+        return $process->output();
+    }
+
+    /**
+     * @param array<int|string, mixed> $array1
+     * @param array<int|string, mixed> $array2
+     *
+     * @return array<int|string, mixed>
+     */
+    public static function arrayMergeRecursiveDistinct(array &$array1, array &$array2): array
+    {
+        $merged = $array1;
+        foreach ($array2 as $key => &$value) {
+            if (is_array($value) && isset($merged[$key]) && is_array($merged[$key])) {
+                $merged[$key] = self::arrayMergeRecursiveDistinct($merged[$key], $value);
+            } else {
+                $merged[$key] = $value;
+            }
+        }
+
+        return $merged;
+    }
+
+    /**
+     * Validate recaptcha
+     *
+     * @param \Illuminate\Http\Request $request
+     * @param boolean                  $isV3
+     * @return void
+     */
+    public static function validateRecaptcha(Request $request, bool $isV3 = true)
+    {
+        Validator::validate($request->all(), [
+            'g-recaptcha-response' => [
+                'required', 'string',
+                // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.FoundAfterLastUsed, Generic.CodeAnalysis.UnusedFunctionParameter.FoundBeforeLastUsed
+                function ($attribute, $value, $fail) use ($isV3) {
+                    try {
+                        $response = Http::asForm()->post('https://www.google.com/recaptcha/api/siteverify', [
+                            'secret' => config('services.google.recaptcha.private'),
+                            'response' => \strval($value),
+                            'remoteip' => app('clientIp')
+                        ]);
+                        if ($e = $response->toException()) {
+                            throw $e;
+                        }
+                        if ($isV3) {
+                            if (
+                                !$response->json('success') or
+                                !$response->json('challenge_ts') or
+                                Carbon::parse($response->json('challenge_ts'))->lessThan(\now('utc')->subMinutes(5)) or
+                                $response->json('hostname') !== \parse_url(config('app.url'), \PHP_URL_HOST) or
+                                !$response->json('score')
+                            ) {
+                                throw new \RuntimeException();
+                            }
+                            if (\floatval($response->json('score')) < 0.8) {
+                                $fail(trans('recaptcha.not_enough_score'));
+                            }
+                            return;
+                        }
+                        if (
+                            !$response->json('success') or
+                            !$response->json('challenge_ts') or
+                            Carbon::parse($response->json('challenge_ts'))->lessThan(\now('utc')->subMinutes(5)) or
+                            $response->json('hostname') !== \parse_url(config('app.url'), \PHP_URL_HOST)
+                        ) {
+                            throw new \RuntimeException();
+                        }
+                    } catch (\Exception $e) {
+                        $fail(trans('recaptcha.error'));
+                    } //end try
+                }
+            ]
+        ], [], ['g-recaptcha-response' => 'reCaptcha']);
+    }
+
+    /**
+     * Strip scheme (https) on oembed urls
+     * Only embed allowed are for MP4 self hosted videos right now
+     *
+     * https is force by ckeditor MediaElements which natively supports
+     * only cloud hosted medias (youtube, spotify etc..)
+     *
+     * @param string $input
+     * @return string
+     */
+    public static function stripCkEditorSchemesOnMediaInputs(string $input): string
+    {
+        $input = \preg_replace('/(?<=<oembed url=")(https:\/\/)(?=.*?">)/m', '', $input);
+        return $input;
+    }
+
+    /**
+     * Assert That no Back Office url is present on txt
+     *
+     * @param string $field
+     * @param string $text
+     * @return string
+     * @throws \Illuminate\Validation\ValidationException If url is a bo url.
+     */
+    public static function assertNoInternalBoUrls(string $field, string $text): string
+    {
+        $routes = Route::getRoutes();
+        // * Url replace and email replace.
+        $text = preg_replace_callback(
+            // phpcs:ignore Generic.Files.LineLength.TooLong
+            '/(?P<url>(?:http[s]?:\/\/.)?(?:www\.)?[-a-zA-Z0-9@%._\+~#=]{2,256}\.[a-z]{2,6}\b(?:[-a-zA-Z0-9@:%_\+.~#?&\/\/=]*))/',
+            function ($matches) use ($routes, $field) {
+                $match = collect($matches)->first() ?? '';
+                $url   = $match;
+                try {
+                    $request = Request::create($url);
+                    // If a route is match then it do not throws exception.
+                    if (
+                        \parse_url(config('app.url'), \PHP_URL_HOST) === \parse_url($url, \PHP_URL_HOST) &&
+                        trim($routes->match($request)->getPrefix() ?? '', '/') === 'bo'
+                    ) {
+                        // Removes the matched url.
+                        throw ValidationException::withMessages([
+                            $field => trans(
+                                'crud.libs.toolbox.assertNoInternalBoUrls',
+                                ['attribute' => $field]
+                            )
+                        ]);
+                    }
+                    return $match;
+                } catch (NotFoundHttpException $e) {
+                    return $match;
+                }
+            },
+            $text
+        );
+        return $text;
+    }
+
+    /**
+     * Assert That only external url is present on txt
+     *
+     * @param string $field
+     * @param string $text
+     * @return string
+     * @throws \Illuminate\Validation\ValidationException If url is a bo url.
+     */
+    public static function assertNoInternalUrls(string $field, string $text): string
+    {
+        self::assertNoInternalBoUrls($field, $text);
+        $routes = Route::getRoutes();
+        // * Url replace and email replace.
+        $text = preg_replace_callback(
+            // phpcs:ignore Generic.Files.LineLength.TooLong
+            '/(?P<url>(?:http[s]?:\/\/.)?(?:www\.)?[-a-zA-Z0-9@%._\+~#=]{2,256}\.[a-z]{2,6}\b(?:[-a-zA-Z0-9@:%_\+.~#?&\/\/=]*))/',
+            function ($matches) use ($routes, $field) {
+                $match = collect($matches)->first() ?? '';
+                $url   = $match;
+                try {
+                    $request = Request::create($url);
+                    // Assert route matches existing routes.
+                    $routes->match($request);
+                    // ? Is url internal ?
+                    if (\parse_url(config('app.url'), \PHP_URL_HOST) === \parse_url($url, \PHP_URL_HOST)) {
+                        // Removes the matched url.
+                        throw ValidationException::withMessages([
+                            $field => trans(
+                                'crud.libs.toolbox.assertNoInternalUrls',
+                                ['attribute' => $field, 'appname' => config('app.name')]
+                            )
+                        ]);
+                    }
+                    return $match;
+                } catch (NotFoundHttpException $e) {
+                    return $match;
+                }
+            },
+            $text
+        );
+        return $text;
+    }
+
+    /**
+     * Mutltibyte string replace
+     *
+     * @param array|string $search
+     * @param array|string $replace
+     * @param array|string $subject
+     * @param integer      $count
+     * @return array|string|false
+     */
+    public static function mbReplace(
+        array|string $search,
+        array|string $replace,
+        array|string $subject,
+        int &$count = 0
+    ): array|string|false {
+        if (!is_array($search) && is_array($replace)) {
+            return false;
+        }
+        if (is_array($subject)) {
+            // Call mb_replace for each single string in $subject .
+            foreach ($subject as &$string) {
+                $string = &self::mbReplace($search, $replace, $string, $count);
+            }
+        } elseif (is_array($search)) {
+            if (!is_array($replace)) {
+                foreach ($search as &$string) {
+                    $subject = self::mbReplace($string, $replace, $subject, $count);
+                }
+            } else {
+                $n = max(count($search), count($replace));
+                while ($n--) {
+                    $subject = self::mbReplace(current($search), current($replace), $subject, $count);
+                    next($search);
+                    next($replace);
+                }
+            }
+        } else {
+            $parts   = mb_split(preg_quote($search), $subject);
+            $count   = count($parts) - 1;
+            $subject = implode($replace, $parts);
+        } //end if
+        return $subject;
+    }
+
+    /**
+     * Asserts that the field is unique
+     *
+     * @param string                                  $table
+     * @param string                                  $field
+     * @param string|integer|float|boolean|null|array $value
+     * @param integer|null                            $id
+     * @param callable|null                           $query
+     * @return void
+     * @throws \Illuminate\Validation\ValidationException If the field is not unique.
+     */
+    public static function assertFieldIsUnique(
+        string $table,
+        string $field,
+        string|int|float|bool|null|array $value,
+        ?int $id = null,
+        ?callable $query = null
+    ) {
+        if (!$query) {
+            Validator::make([$field => $value], [
+                self::mbReplace('.', '\.', $field) => Rule::unique($table, $field)->ignore($id),
+            ], [
+                self::mbReplace('.', '\.', "{$field}.unique")
+                => trans('crud.libs.toolbox.assertFieldIsUnique', ['attribute' => $field, 'value' => $value])
+            ])->validate();
+            return;
+        }
+        Validator::make([$field => $value], [
+            $field => Rule::unique($table)->where($query)->ignore($id),
+        ], [
+            $field . '.unique' => trans(
+                'crud.libs.toolbox.assertFieldIsUnique',
+                ['attribute' => $field, 'value' => $value]
+            )
+        ])->validate();
+    }
+
+    /**
+     * Get original polyfill with autotranslate behavior
+     *
+     * @param \Illuminate\Database\Eloquent\Model $model
+     * @param string                              $attribute
+     * @return mixed
+     */
+    public static function getOriginal(Model $model, string $attribute): mixed
+    {
+        if (
+            \in_array('Spatie\Translatable\HasTranslations', \class_uses_recursive($model)) and
+            // @phpstan-ignore-next-line
+            $model->isTranslatableAttribute($attribute)
+        ) {
+            // @phpstan-ignore-next-line
+            return $model->getTranslation(
+                $attribute,
+                // @phpstan-ignore-next-line
+                $model->getLocale(),
+                // @phpstan-ignore-next-line
+                $model->useFallbackLocale()
+            );
+        }
+        return $model->getOriginal($attribute);
+    }
+
+    /**
+     * Dynamic model query
+     *
+     * @param string                                          $defaultLocale
+     * @param \Illuminate\Contracts\Database\Eloquent\Builder $q
+     * @param string                                          $column
+     * @param string                                          $value
+     * @return \Illuminate\Contracts\Database\Eloquent\Builder
+     */
+    public static function queryColumnWithLocales(
+        string $defaultLocale,
+        Builder $q,
+        string $column,
+        string $value
+    ): Builder {
+        $currentLocale = app()->currentLocale();
+        $locales       = collect(config('app.locales'))
+            ->mapWithKeys(fn (string $locale) => [$locale => $locale]);
+        if (!$locales->has($defaultLocale)) {
+            // * Remove default locale.
+            $locales->pull($defaultLocale);
+        }
+        if (!$locales->has($currentLocale)) {
+            // * Remove current locale.
+            $locales->pull($currentLocale);
+        }
+
+        return $q->where(function (Builder $q) use ($defaultLocale, $currentLocale, $locales, $column, $value) {
+            // * Query default locale
+            $q->whereRaw("JSON_EXTRACT({$column}, '$.{$defaultLocale}') = '{$value}'");
+            if ($defaultLocale !== $currentLocale) {
+                // * Query current locale
+                $q->whereRaw("JSON_EXTRACT({$column}, '$.{$currentLocale}') = '{$value}'");
+            }
+            // * Query any other locale
+            $locales->each(fn ($locale) => $q->orWhereRaw(
+                "JSON_EXTRACT({$column}, '$.{$locale}') = '{$value}'"
+            ));
+        });
+    }
+
+    /**
+     * Generates an array from a dot separated string
+     *
+     * @param string $path
+     * @param mixed  $value
+     * @param string $separator
+     * @return array
+     */
+    public static function dotStringToNestedArray(string $path, mixed $value, string $separator = '.'): array
+    {
+        $arr  = $value;
+        $keys = array_reverse(explode($separator, $path));
+
+        foreach ($keys as $key) {
+            $arr = [$key => $arr];
+        }
+        return $arr;
+    }
+
+    /**
+     * Convert deeply an object to array
+     *
+     * @param mixed $input
+     * @return array
+     * @throws \RuntimeException If $input var is a scalar value.
+     */
+    public static function objectToArray(mixed $input): array
+    {
+        // Only process if it's an object or array being passed to the function.
+        if (!(is_object($input) or is_array($input))) {
+            throw new \RuntimeException('Cannot handle $input of type ' . \gettype($input));
+        }
+        $ret = (array)$input;
+        foreach ($ret as &$item) {
+            // Recursively process EACH element only if not scalar.
+            $item = (is_object($item) or is_array($item)) ?
+                self::objectToArray($item) : $item;
+        }
+        return $ret;
+    }
+
+    /**
+     * Convert deeply an array to object
+     *
+     * @param mixed $input
+     * @return object
+     * @throws \RuntimeException If $input var is a scalar value.
+     */
+    public static function arrayToObject(mixed $input): object
+    {
+        // Only process if it's an object or array being passed to the function.
+        if (!(is_object($input) or is_array($input))) {
+            throw new \RuntimeException('Cannot handle $input of type ' . \gettype($input));
+        }
+        $ret = (object)$input;
+        foreach ($ret as &$item) {
+            // Recursively process EACH element only if not scalar.
+            $item = (is_object($item) or is_array($item)) ?
+                self::arrayToObject($item) : $item;
+        }
+        return $ret;
+    }
+
+    /**
+     * Validate picture
+     *
+     * @param string      $attribute
+     * @param string|null $value
+     * @param callable    $fail
+     * @param object      $sizes
+     * @return void
+     */
+    public static function validatePicture(string $attribute, string|null $value, callable $fail, object $sizes): void
+    {
+        if (!($useStorage = Storage::exists($value)) and !File::exists($value)) {
+            $fail(trans(':attribute n\'existe pas dans le système de fichier', [
+                'attribute' => $attribute
+            ]));
+            return;
+        }
+        $fileFullPath = self::getUploadedFileFullPath($value, $useStorage);
+        if (
+            !\in_array(self::getUploadedFileMimeType($value, $useStorage), [
+                'image/jpeg', 'image/jpg', 'image/png', 'image/gif'
+            ])
+        ) {
+            $fail(trans(':attribute doit être une image de type \'image/jpeg,image/jpg,image/png,image/gif\'', [
+                'attribute' => $attribute
+            ]));
+        }
+        if (!($dimensions = \getimagesize($fileFullPath))) {
+            $fail(trans(':attribute impossible de valider les dimensions', [
+                'attribute' => $attribute
+            ]));
+        } else {
+            $width  = intval($dimensions[0]);
+            $height = intval($dimensions[1]);
+
+            $xMessage = trans(
+                ":attribute la largeur doit être comprise entre {$sizes->minWidth}px et {$sizes->maxWidth}px"
+            );
+            if ($sizes->minWidth === $sizes->maxWidth) {
+                $xMessage = trans(":attribute la largeur doit être de {$sizes->minWidth}px");
+            }
+            $yMessage = trans(
+                ":attribute la hauteur doit être comprise entre {$sizes->minHeight}px et {$sizes->maxHeight}px"
+            );
+            if ($sizes->minHeight === $sizes->maxHeight) {
+                $yMessage = trans(":attribute la hauteur doit être de {$sizes->minHeight}px");
+            }
+
+            if (($width < $sizes->minWidth) or ($width > $sizes->maxWidth)) {
+                $fail($xMessage);
+            }
+            if (($height < $sizes->minHeight) or ($height > $sizes->maxHeight)) {
+                $fail($yMessage);
+            }
+        } //end if
+    }
+
+    /**
+     * Get the file full path
+     *
+     * @param string  $value
+     * @param boolean $useStorage
+     * @return string
+     */
+    private static function getUploadedFileFullPath(string $value, bool $useStorage): string
+    {
+        /** @var \Illuminate\Filesystem\FilesystemAdapter */
+        $disk = Storage::disk();
+        return !$useStorage ? (realpath($value) ?: $value) : $disk->path($value);
+    }
+
+    /**
+     * Get the file mimetype
+     *
+     * @param string  $value
+     * @param boolean $useStorage
+     * @return string|false
+     */
+    private static function getUploadedFileMimeType(string $value, bool $useStorage)
+    {
+        return !$useStorage ? File::mimeType($value) : Storage::mimeType($value);
+    }
+
+    /**
+     * Fetch class list from a specific namespace
+     *
+     * @param string $namespace
+     * @return array<string> An array of classe namespaces
+     */
+    public static function getClassesUsingNamespace(string $namespace): array
+    {
+        return collect(File::files(\app_path(Str::of($namespace)->replaceFirst('\App', ''))))
+            ->filter(fn (SplFileInfo $splFileInfo) => $splFileInfo->getExtension() === 'php')
+            ->map(fn (SplFileInfo $splFileInfo) => Str::of($splFileInfo->getBasename())
+                ->replace('.' . $splFileInfo->getExtension(), '')->prepend("{$namespace}\\"))->all();
+    }
+
+    /**
+     * Get all classes from a specific namespace that implement a specific interface
+     *
+     * @param string $namespace
+     * @param string $interface
+     * @return array<string> An array of classe namespaces
+     */
+    public static function getClassesUsingInterface(string $namespace, string $interface): array
+    {
+        return Arr::where(
+            static::getClassesUsingNamespace($namespace),
+            fn (string $class_namespace) => \collect(class_implements($class_namespace, true))->filter()
+                ->contains(fn (string $class_interface) => $class_interface === $interface)
+        );
+    }
+
+    /**
+     * Get validated pagination from request.
+     *
+     * @param integer $default
+     * @param string  $field
+     * @param string  $enumPath
+     * @return integer
+     */
+    public static function getValidatedEnum(int $default, string $field, string $enumPath): int
+    {
+        try {
+            return \intval(Validator::make(
+                [$field => \request()->get($field)],
+                [$field => new Enum($enumPath)]
+            )->validated()[$field]);
+        } catch (ValidationException $e) {
+            return $default;
+        }
+    }
+}

app/Lib/Options.php

@@ -0,0 +1,159 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Lib;
+
+use Dxw\CIDR\IPv4Range;
+use Dxw\CIDR\IPv6Range;
+use Illuminate\Support\Facades\Cache;
+use Symfony\Component\OptionsResolver\OptionsResolver;
+
+/**
+ * Configuration
+ */
+final class Options
+{
+    /**
+     * @var array<string, mixed> The configuration options
+     */
+    private $options;
+
+    /**
+     * @var \Symfony\Component\OptionsResolver\OptionsResolver The options resolver
+     */
+    private $resolver;
+
+    /**
+     * The cache key where to store config cidr list.
+     *
+     * @var string
+     */
+    private static $cache_config_key = 'uwil_ip_cidr_config_list';
+
+    /**
+     * Class constructor.
+     *
+     * @param array<string, mixed> $options The configuration options.
+     */
+    public function __construct(array $options = [])
+    {
+        $this->resolver = new OptionsResolver();
+
+        $this->configureOptions($this->resolver);
+
+        $this->options = $this->resolver->resolve($options);
+    }
+
+    /**
+     * Get cidr list
+     *
+     * @return array<\Dxw\CIDR\IPv4Range|\Dxw\CIDR\IPv6Range>
+     */
+    public function getCidrList(): array
+    {
+        return $this->options['cidrList'];
+    }
+
+    /**
+     * Get cidr project allowed list
+     *
+     * @return array<\Dxw\CIDR\IPv4Range|\Dxw\CIDR\IPv6Range>
+     */
+    public function getCidrAllowedList(): array
+    {
+        return $this->options['cidrProjectAllowedList'];
+    }
+
+    /**
+     * Configures the options of the client.
+     *
+     * @param \Symfony\Component\OptionsResolver\OptionsResolver $resolver The resolver for the options.
+     * @return void
+     */
+    private function configureOptions(OptionsResolver $resolver): void
+    {
+        $resolver->setDefaults([
+            'cidrList' => [],
+            'cidrProjectAllowedList' => []
+        ]);
+
+        $resolver->setNormalizer('cidrList', \Closure::fromCallable([$this, 'normalizeCidrList']));
+        $resolver->setNormalizer('cidrProjectAllowedList', \Closure::fromCallable([$this, 'normalizeCidrProjectList']));
+    }
+
+    /**
+     * Normalise Cidr list for cidrList option
+     *
+     * @param \Symfony\Component\OptionsResolver\Options $options
+     * @param string|null $value
+     * @return array
+     * @phpcs:disable Generic.CodeAnalysis.UnusedFunctionParameter.FoundBeforeLastUsed
+     */
+    private function normalizeCidrList(
+        \Symfony\Component\OptionsResolver\Options $options,
+        ?string $value
+    ): array {
+        // phpcs:enable
+        return $this->doNormalizeCidrList($value, 'cidrList');
+    }
+
+    /**
+     * Normalise Cidr list for cidrProjectAllowedList option
+     *
+     * @param \Symfony\Component\OptionsResolver\Options $options
+     * @param string|null $value
+     * @return array
+     * @phpcs:disable Generic.CodeAnalysis.UnusedFunctionParameter.FoundBeforeLastUsed
+     */
+    private function normalizeCidrProjectList(
+        \Symfony\Component\OptionsResolver\Options $options,
+        ?string $value
+    ): array {
+        // phpcs:enable
+        return $this->doNormalizeCidrList($value, 'cidrProjectAllowedList');
+    }
+
+    /**
+     * Normalize CIDR list with specific cache key.
+     *
+     * @param string|null $value
+     * @param string $optionName
+     * @return array<\Dxw\CIDR\IPv4Range|\Dxw\CIDR\IPv6Range>
+     */
+    private function doNormalizeCidrList(?string $value, string $optionName): array
+    {
+        $cacheConfigKey = self::$cache_config_key . '_' . $optionName;
+        $allowed_cidr_config_list = collect(explode(',', strval($value)))->filter();
+        $allowed_cidr_config_list_hash = \md5($allowed_cidr_config_list->implode(','));
+        $allowed_cidr_list = [];
+
+        // Flush cache if config hash changed
+        if ($allowed_cidr_config_list_hash !== \collect(Cache::get($cacheConfigKey))->get('hash')) {
+            Cache::forget($cacheConfigKey);
+
+            /** @var array<\Dxw\CIDR\IPv4Range|\Dxw\CIDR\IPv6Range> $allowed_cidr_list */
+            $allowed_cidr_list = $allowed_cidr_config_list
+                ->map(function (string $cidr) {
+                    $ip_range = !IPv4Range::Make($cidr)->isErr() ? IPv4Range::Make($cidr) : IPv6Range::Make($cidr);
+                    if ($ip_range->isErr()) {
+                        throw new \Exception(\trans(
+                            'CIDR LIST not valid (ipv4 or ipv6 cidr) :cidr',
+                            [
+                                'cidr' => $cidr
+                            ]
+                        ));
+                    }
+                    return $ip_range->unwrap();
+                })->all();
+        }
+
+        /** @var array<\Dxw\CIDR\IPv4Range|\Dxw\CIDR\IPv6Range> $allowed_cidr_list */
+        return \collect(Cache::rememberForever($cacheConfigKey, function() use ($allowed_cidr_list, $allowed_cidr_config_list_hash) {
+            return [
+                'list' => $allowed_cidr_list,
+                'hash' => $allowed_cidr_config_list_hash
+            ];
+        }))->get('list');
+    }
+}

app/Lib/ToolboxHelper.php

@@ -1,499 +0,0 @@
-<?php
-
-namespace App\Lib;
-
-use Illuminate\Database\Eloquent\Model;
-use Illuminate\Http\Request;
-use Illuminate\Support\Carbon;
-use Illuminate\Support\Facades\File;
-use Illuminate\Support\Facades\Http;
-use Illuminate\Support\Facades\Route;
-use Illuminate\Support\Facades\Validator;
-use Illuminate\Support\Str;
-use Illuminate\Validation\Rule;
-use Illuminate\Validation\ValidationException;
-use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
-
-class ToolboxHelper
-{
-    /**
-     * Strip scheme (https) on oembed urls
-     * Only embed allowed are for MP4 self hosted videos right now
-     *
-     * https is force by ckeditor MediaElements which natively supports
-     * only cloud hosted medias (youtube, spotify etc..)
-     *
-     * @param string $input
-     * @return string
-     */
-    public static function stripCkEditorSchemesOnMediaInputs(string $input): string
-    {
-        $input = \preg_replace('/(?<=<oembed url=")(https:\/\/)(?=.*?">)/m', '', $input);
-        return $input;
-    }
-
-    /**
-     * Assert That no Back Office url is present on txt
-     *
-     * @param string $field
-     * @param string $text
-     * @return string
-     * @throws \Illuminate\Validation\ValidationException If url is a bo url.
-     */
-    public static function assertNoInternalBoUrls(string $field, string $text): string
-    {
-        $routes = Route::getRoutes();
-        // * Url replace and email replace.
-        $text = preg_replace_callback(
-            // phpcs:ignore Generic.Files.LineLength.TooLong
-            '/(?P<url>(?:http[s]?:\/\/.)?(?:www\.)?[-a-zA-Z0-9@%._\+~#=]{2,256}\.[a-z]{2,6}\b(?:[-a-zA-Z0-9@:%_\+.~#?&\/\/=]*))/',
-            function ($matches) use ($routes, $field) {
-                $match = collect($matches)->first() ?? '';
-                $url   = $match;
-                try {
-                    $request = Request::create($url);
-                    // If a route is match then it do not throws exception.
-                    if (
-                        \parse_url(config('app.url'), \PHP_URL_HOST) === \parse_url($url, \PHP_URL_HOST) &&
-                        trim($routes->match($request)->getPrefix() ?? '', '/') === 'bo'
-                    ) {
-                        // Removes the matched url.
-                        throw ValidationException::withMessages([
-                            $field => sprintf(
-                                '%s : Il est interdit de coller une url du back office dans ce champ',
-                                trans($field)
-                            )
-                        ]);
-                    }
-                    return $match;
-                } catch (NotFoundHttpException $e) {
-                    return $match;
-                }
-            },
-            $text
-        );
-        return $text;
-    }
-
-    /**
-     * Get files path uploaded with ckeditor custom upload plugin (crud-policies)
-     *
-     * @param string $text
-     * @param array  $detectExtensions
-     * @return array
-     */
-    public static function getCkEditorLocalUploadedFiles(
-        string $text,
-        array $detectExtensions = ['png', 'svg', 'jpg', 'gif']
-    ): array {
-        $out = [];
-        \preg_match_all(
-            // phpcs:ignore Generic.Files.LineLength.TooLong
-            '/src="(?P<url>\/storage\/images\/crud-policies\/uploads\/\d{4}-\d{2}-\d{2}\/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}-[-a-zA-Z0-9@%._\+~#=]{2,256}\.(?:' . implode('|', $detectExtensions) . '))"/',
-            $text,
-            $out
-        );
-        return collect($out['url'] ?? [])->map(function (string $urlEncodedFilePath) {
-            return \urldecode($urlEncodedFilePath);
-        })->all();
-    }
-
-    /**
-     * Assert That only external url is present on txt
-     *
-     * @param string $field
-     * @param string $text
-     * @return string
-     * @throws \Illuminate\Validation\ValidationException If url is a bo url.
-     */
-    public static function assertNoInternalUrls(string $field, string $text): string
-    {
-        self::assertNoInternalBoUrls($field, $text);
-        $routes = Route::getRoutes();
-        // * Url replace and email replace.
-        $text = preg_replace_callback(
-            // phpcs:ignore Generic.Files.LineLength.TooLong
-            '/(?P<url>(?:http[s]?:\/\/.)?(?:www\.)?[-a-zA-Z0-9@%._\+~#=]{2,256}\.[a-z]{2,6}\b(?:[-a-zA-Z0-9@:%_\+.~#?&\/\/=]*))/',
-            function ($matches) use ($routes, $field) {
-                $match = collect($matches)->first() ?? '';
-                $url   = $match;
-                try {
-                    $request = Request::create($url);
-                    // If a route is match then it do not throws exception.
-                    if (
-                        \parse_url(config('app.url'), \PHP_URL_HOST) === \parse_url($url, \PHP_URL_HOST) &&
-                        $routes->match($request)
-                    ) {
-                        // Removes the matched url.
-                        throw ValidationException::withMessages([
-                            $field => sprintf(
-                                '%s : Il est interdit de coller une url de %s dans ce champ',
-                                trans($field),
-                                config('app.name')
-                            )
-                        ]);
-                    }
-                    return $match;
-                } catch (NotFoundHttpException $e) {
-                    return $match;
-                }
-            },
-            $text
-        );
-        return $text;
-    }
-
-    /**
-     * Generates an array from a dot separated string
-     *
-     * @param string $path
-     * @param mixed  $value
-     * @param string $separator
-     * @return array
-     */
-    public static function dotStringToNestedArray(string $path, $value, string $separator = '.'): array
-    {
-        $arr  = $value;
-        $keys = array_reverse(explode($separator, $path));
-
-        foreach ($keys as $key) {
-            $arr = [$key => $arr];
-        }
-        return $arr;
-    }
-
-    /**
-     * Destroy image
-     *
-     * @param \Illuminate\Database\Eloquent\Model $model
-     * @param string                              $attribute
-     * @return void
-     */
-    public static function removeImage(Model $model, string $attribute)
-    {
-        $path = ltrim($model->{$attribute}, '/');
-        if (File::exists($path) and \strpos($path, 'storage') === 0) {
-            File::delete($path);
-        }
-    }
-
-    /**
-     * Destroy image
-     *
-     * @param \Illuminate\Database\Eloquent\Model $model
-     * @param string                              $attribute
-     * @return void
-     */
-    public static function removeOldImage(Model $model, string $attribute)
-    {
-        $originalPath = ltrim($model->getOriginal($attribute), '/');
-        if (File::exists($originalPath) and \strpos($originalPath, 'storage') === 0) {
-            File::delete($originalPath);
-        }
-    }
-
-    /**
-     * Remove pictures in ckeditor
-     *
-     * @param \Illuminate\Database\Eloquent\Model $model
-     * @param string                              $attribute
-     * @return void
-     */
-    public static function removeImagesOnCkEditor(Model $model, string $attribute)
-    {
-        // * Remove inline uploaded images
-        collect(ToolboxHelper::getCkEditorLocalUploadedFiles($model->getOriginal($attribute)))
-            ->map(function (string $originalPicturePath) {
-                // * If a picture is not used anymore
-                if (File::exists(\public_path($originalPicturePath))) {
-                    File::delete(\public_path($originalPicturePath));
-                }
-            });
-    }
-    /**
-     * Remove unused pictures in ckeditor
-     *
-     * @param \Illuminate\Database\Eloquent\Model $model
-     * @param string                              $attribute
-     * @return void
-     */
-    public static function removeUnusedImagesOnCkEditor(Model $model, string $attribute)
-    {
-        // * Remove unused inline uploaded images
-        if ($model->{$attribute} != $model->getOriginal($attribute)) {
-            $updatedPicturesPath = collect(
-                ToolboxHelper::getCkEditorLocalUploadedFiles($model->{$attribute})
-            );
-            collect(ToolboxHelper::getCkEditorLocalUploadedFiles($model->getOriginal($attribute)))
-                ->map(function (string $originalPicturePath) use ($updatedPicturesPath) {
-                    // * If a picture is not used anymore
-                    if (!$updatedPicturesPath->contains($originalPicturePath)) {
-                        if (File::exists(\public_path($originalPicturePath))) {
-                            File::delete(\public_path($originalPicturePath));
-                        }
-                    }
-                });
-        }
-    }
-
-    /**
-     * Store an image of different types
-     *
-     * @param \Illuminate\Database\Eloquent\Model               $model
-     * @param \Illuminate\Http\UploadedFile|\SplFileInfo|string $image
-     * @return string
-     * @throws \ErrorException If file copy fails.
-     */
-    public static function storeImage(Model $model, $image): string
-    {
-        $table = $model->getTable();
-        if (\is_object($image) and $image instanceof \Illuminate\Http\UploadedFile) {
-            /** @var \Illuminate\Http\UploadedFile $image */
-            $newPath = self::prepareMoveFile($table, $image->getClientOriginalName());
-            $newPath = str_replace(storage_path('app'), '', $newPath);
-            $image->storePubliclyAs(
-                pathinfo($newPath, \PATHINFO_DIRNAME),
-                pathinfo($newPath, \PATHINFO_BASENAME)
-            );
-            return 'storage' . str_replace('/public', '', $newPath);
-        }
-        if (\is_object($image) and $image instanceof \SplFileInfo) {
-            /** @var \SplFileInfo $image */
-            $newPath = self::prepareMoveFile($table, $image->getBaseName());
-            if (!File::copy($image->getRealPath(), $newPath)) {
-                throw new \ErrorException(sprintf(
-                    'Failed to copy file %s to %s',
-                    $image->getRealPath(),
-                    $newPath
-                ));
-            }
-            return \ltrim(str_replace(\storage_path('app/public'), '/storage', $newPath), '/');
-        }
-        return strval($image);
-    }
-
-    /**
-     * Prepare storage path and return
-     * the image full path
-     *
-     * @param string $table    Model table name.
-     * @param string $filename The basename for the file.
-     * @return string
-     */
-    private static function prepareMoveFile(string $table, string $filename): string
-    {
-        // * Security filter + beautifier
-        $filename = self::sanitizeFileName($filename);
-        // * Security filter
-        $filename = \filter_var($filename, \FILTER_SANITIZE_STRING);
-        // * Slugify filename
-        $ext      = \pathinfo($filename, \PATHINFO_EXTENSION);
-        $filename = Str::slug(\pathinfo($filename, \PATHINFO_FILENAME)) .
-            (\strlen($ext) ? ".{$ext}" : '');
-
-        $pathFolder = \storage_path(sprintf('app/public/images/%s', $table));
-        if (!File::exists($pathFolder)) {
-            File::makeDirectory($pathFolder, 0755, true);
-        }
-        $filename = sprintf('%s-%s', Str::uuid(), $filename);
-        $fullPath = sprintf('%s/%s', $pathFolder, $filename);
-        if (File::exists($fullPath)) {
-            File::delete($fullPath);
-        }
-        return $fullPath;
-    }
-
-    /**
-     * Asserts that the field is unique
-     *
-     * @param string        $table
-     * @param string        $field
-     * @param mixed         $value
-     * @param integer|null  $id
-     * @param callable|null $query
-     * @return void
-     * @throws \Illuminate\Validation\ValidationException If the field is not unique.
-     */
-    public static function assertFieldIsUnique(
-        string $table,
-        string $field,
-        $value,
-        ?int $id = null,
-        ?callable $query = null
-    ) {
-        if (!$query) {
-            Validator::make([$field => $value], [
-                $field => Rule::unique($table, $field)->ignore($id),
-            ], [
-                $field . '.unique' => trans('La valeur :value pour le champ :attribute est déjà utilisé', [
-                    'attribute' => $field,
-                    'value' => $value
-                ])
-            ])->validate();
-            return;
-        }
-        Validator::make([$field => $value], [
-            $field => Rule::unique($table)->where($query)->ignore($id),
-        ], [
-            $field . '.unique' => trans('La valeur pour le champ :attribute est déjà utilisé', [
-                'attribute' => $field
-            ])
-        ])->validate();
-    }
-
-    /**
-     * Validate recaptcha V3
-     *
-     * @param Request $request
-     * @return void
-     */
-    public static function validateRecaptchaV3(Request $request)
-    {
-        Validator::validate($request->all(), [
-            'g-recaptcha-response' => [
-                'required', 'string',
-                // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.FoundAfterLastUsed, Generic.CodeAnalysis.UnusedFunctionParameter.FoundBeforeLastUsed
-                function ($attribute, $value, $fail) {
-                    try {
-                        $response = Http::asForm()->post('https://www.google.com/recaptcha/api/siteverify', [
-                            'secret' => config('recaptcha.private'),
-                            'response' => \strval($value),
-                            'remoteip' => app('clientIp')
-                        ]);
-                        if ($e = $response->toException()) {
-                            throw $e;
-                        }
-
-                        if (
-                            !$response->json('success') or
-                            !$response->json('challenge_ts') or
-                            Carbon::parse($response->json('challenge_ts'))->lessThan(\now('utc')->subMinutes(5)) or
-                            $response->json('hostname') !== \parse_url(config('app.url'), \PHP_URL_HOST) or
-                            !$response->json('score')
-                        ) {
-                            throw new \ErrorException();
-                        }
-                        if (\floatval($response->json('score')) < 0.8) {
-                            $fail('Vous n\'avez pas obtenu un score assez élevé lors de la validation du recaptcha');
-                        }
-                    } catch (\Exception $e) {
-                        $fail('Erreur lors de la validation du formulaire veuillez réssayer');
-                    } //end try
-                }
-            ]
-        ], [], ['g-recaptcha-response' => 'reCaptcha']);
-    }
-
-    /**
-     * * Register CSP report URI
-     *
-     * Put this function inside RouteServiceProvider,
-     * and call it in RouteServiceProvider::boot
-     *
-     * ! Use this in conjonction with kwaadpepper/exception-handler
-     *
-     * @return void
-     */
-    public static function cspReportRoute()
-    {
-        // * CSP REPORT URI, Please add /csp-report to VerifyCsrfToken $except middleware
-        \Illuminate\Support\Facades\Route::post('/csp-report', function () {
-            $isCspRequest = request()->header('Content-Type') === 'application/csp-report';
-            if (!$isCspRequest or !request()->json('csp-report') or !is_array(request()->json('csp-report'))) {
-                abort(401);
-            }
-            // * Flatten if needed
-            $cspReport = collect(request()->json('csp-report'))
-                ->flatMap(function ($v, $k) {
-                    return [$k => is_array($v) ? collect($v)->flatten()->implode(', ') : $v];
-                })->all();
-            // * Filter array keys
-            $cspReport = collect(array_intersect_key($cspReport, [
-                'blocked-uri' => '', 'document-uri' => '', 'original-policy' => '',
-                'referrer' => '', 'violated-directive' => ''
-            ]));
-            report(new \Illuminate\Http\Client\HttpClientException(sprintf(
-                "CSP REPORT for %s : \n %s",
-                $cspReport->get('document-uri'),
-                $cspReport->implode("\n")
-            )));
-        })->middleware('throttle:5,2')
-            ->withoutMiddleware(\App\Http\Middleware\VerifyCsrfToken::class)
-            ->name('cspReportUri');
-    }
-
-    /**
-     * Sanitize File name for uploaded files
-     *
-     * @param string  $filename The original uploaded client file name.
-     * @param boolean $beautify Beautify the filename.
-     * @return string The sanitized file name.
-     */
-    public static function sanitizeFileName(string $filename, bool $beautify = true): string
-    {
-        // * Sanitize filename
-        // phpcs:disable Generic.Files.LineLength.TooLong
-        $filename = preg_replace(
-            '~
-            [<>:"/\\\|?*]|            # file system reserved https://en.wikipedia.org/wiki/Filename#Reserved_characters_and_words
-            [\x00-\x1F]|             # control characters http://msdn.microsoft.com/en-us/library/windows/desktop/aa365247%28v=vs.85%29.aspx
-            [\x7F\xA0\xAD]|          # non-printing characters DEL, NO-BREAK SPACE, SOFT HYPHEN
-            [#\[\]@!$&\'()+,;=]|     # URI reserved https://tools.ietf.org/html/rfc3986#section-2.2
-            [{}^\~`]                 # URL unsafe characters https://www.ietf.org/rfc/rfc1738.txt
-            ~x',
-            '-',
-            $filename
-        );
-        // phpcs:enable
-        // * Avoids '.' '..' or '.hiddenFiles' .
-        $filename = Str::of($filename)->ltrim('.-');
-        // * Optional beautification
-        if ($beautify) {
-            $filename = static::beautifyFilename($filename);
-        }
-        // * Maximize filename length to 255 bytes http://serverfault.com/a/9548/44086
-        /** @var string */
-        $extension = pathinfo($filename, \PATHINFO_EXTENSION);
-        /** @var string */
-        $filename = pathinfo($filename, \PATHINFO_FILENAME);
-
-        $encoding = mb_detect_encoding($filename);
-        $encoding = $encoding ? $encoding : null;
-        return \mb_strcut(
-            $filename,
-            0,
-            255 - (!empty($extension) ? strlen($extension) + 1 : 0),
-            $encoding
-        ) . (!empty($extension) ? ".$extension" : '');
-    }
-
-    /**
-     * Beautify a filename
-     *
-     * @param string $filename
-     * @return string
-     */
-    private static function beautifyFilename(string $filename): string
-    {
-        // Reduce consecutive characters.
-        $filename = preg_replace([
-            // * "file   name.zip" becomes 'file-name.zip'
-            '/ +/',
-            // * "file___name.zip" becomes 'file-name.zip'
-            '/_+/',
-            // * "file---name.zip" becomes 'file-name.zip'
-            '/-+/'
-        ], '-', $filename);
-        $filename = preg_replace([
-            // * "file--.--.-.--name.zip" becomes "file.name.zip"
-            '/-*\.-*/',
-            // * "file...name..zip" becomes "file.name.zip"
-            '/\.{2,}/'
-        ], '.', $filename);
-        // Lowercase for windows/unix interoperability http://support.microsoft.com/kb/100625 .
-        $filename = mb_strtolower($filename, mb_detect_encoding($filename));
-        // * ".file-name.-" becomes "file-name"
-        $filename = trim($filename, '.-');
-        return $filename;
-    }
-}

app/Models/ActivityLog.php

@@ -0,0 +1,179 @@
+<?php
+
+namespace App\Models;
+
+use App\Enums\ActivityLogs\ActivityLogsEventEnum;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Notifications\Notifiable;
+use Illuminate\Support\Str;
+
+/**
+ * @property string                                        $model      Target model.
+ * @property string                                        $model_id   Id of the target model.
+ * @property \App\Enums\ActivityLogs\ActivityLogsEventEnum $event      Event of this activity (ActivityLogsEventEnum).
+ * @property array                                         $data       Changes.
+ * @property-read \Illuminate\Support\Carbon               $created_at Created date.
+ *
+ * @property-read \App\Models\User $user User BelongsTo relation.
+ */
+class ActivityLog extends Model
+{
+    use HasFactory;
+    use Notifiable;
+
+    /**
+     * Indicates if the model should be timestamped.
+     *
+     * @var boolean
+     */
+    public $timestamps = false;
+
+    /**
+     * The attributes that are mass assignable.
+     *
+     * @var array<int, string>
+     */
+    protected $fillable = [
+        'is_anonymous',
+        'model_class',
+        'model_id',
+        'event',
+        'data',
+        'created_at',
+    ];
+
+    /**
+     * The attributes that should be cast.
+     *
+     * @var array<string, string>
+     */
+    protected $casts = [
+        'is_anonymous' => 'bool',
+        'event'        => ActivityLogsEventEnum::class,
+        'data'         => 'json',
+        'created_at'   => 'datetime',
+    ];
+
+    // * METHODS
+
+    /**
+     * Add new activity to the activity logs list.
+     *
+     * @param \Illuminate\Database\Eloquent\Model           $model
+     * @param \App\Enums\ActivityLogs\ActivityLogsEventEnum $eventEnum
+     * @return void
+     */
+    public static function addActivity(Model $model, ActivityLogsEventEnum $eventEnum): void
+    {
+        $isAnonymous = true;
+        /** @var \Illuminate\Database\Eloquent\Model|null */
+        $userModel = auth('backend')->user();
+        if (is_object($userModel)) {
+            $userModel   = $userModel->getKeyForSelectQuery();
+            $isAnonymous = false;
+        }
+        $activity               = new self();
+        $activity->user_id      = $userModel;
+        $activity->is_console   = app()->runningInConsole();
+        $activity->is_anonymous = $isAnonymous;
+        $activity->model_class  = \get_class($model);
+        $activity->model_id     = $model->getKey();
+        $activity->event        = $eventEnum;
+        $activity->data         = static::getChangedColumns($activity, $model, $eventEnum);
+        // @phpstan-ignore-next-line
+        $activity->created_at = now();
+        $activity->saveOrFail();
+    }
+
+    /**
+     * Get old, new columns that has changed.
+     *
+     * @param self                                          $activity
+     * @param \Illuminate\Database\Eloquent\Model           $model
+     * @param \App\Enums\ActivityLogs\ActivityLogsEventEnum $eventEnum
+     * @return array
+     */
+    public static function getChangedColumns(self $activity, Model $model, ActivityLogsEventEnum $eventEnum): array
+    {
+        $modelClassName = $activity->model_class;
+        /** Get type of each fields of the target model */
+        /** @var \Illuminate\Database\Eloquent\Model|null $targetModel */
+        $targetModel = $activity->model_class::where(
+            (new $modelClassName())->getRouteKeyName(),
+            $activity->model_id
+        )->first();
+
+        if (\is_null($targetModel)) {
+            return [];
+        }
+        $targetModelTypes = collect($targetModel->toArray())
+            ->map(fn($value) => self::getValueType($value))
+            ->toArray();
+        /** Return old, new and type of values changed */
+        return match ($eventEnum) {
+            ActivityLogsEventEnum::created => array_intersect_key($targetModelTypes, $model->toArray()),
+            ActivityLogsEventEnum::duplicated => array_intersect_key($targetModelTypes, $model->toArray()),
+            ActivityLogsEventEnum::updated => array_intersect_key($targetModelTypes, $model->getChanges()),
+            default => []
+        };
+    }
+
+
+    /**
+     * Get a value type as a string
+     * ! Use this for display purpose only
+     *
+     * @param mixed $value
+     * @return string
+     * @throws \RuntimeException If type is unhlanded.
+     * @phpcs:disable Generic.Metrics.CyclomaticComplexity.MaxExceeded
+     */
+    private static function getValueType(mixed $value): string
+    {
+        // phpcs:enable
+        $type = \gettype($value);
+        switch ($type) {
+                // phpcs:ignore PSR2.ControlStructures.SwitchDeclaration.TerminatingComment
+            case 'string':
+                return match (true) {
+                    Str::length(\strip_tags($value)) !== Str::length($value) => 'html',
+                    Str::startsWith($value, 'storage/modelfiles') => 'file',
+                    Str::isUuid($value) => 'uuid',
+                    Str::isUlid($value) => 'ulid',
+                    Str::isUrl($value) => 'url',
+                    Str::isMatch('/^[0-9A-Za-z_-]{10}[048AEIMQUYcgkosw]$/', $value) => 'youtube_video_id',
+                    \is_numeric($value) => 'numeric',
+                    Str::isJson($value) and
+                        (Str::startsWith($value, '[') or Str::startsWith($value, '{')) => 'json',
+                    default => 'string'
+                };
+            case 'NULL':
+            case 'object':
+            case 'array':
+            case 'integer':
+            case 'boolean':
+                return $type;
+            case 'double':
+                return is_float($value) ? 'float' : 'double';
+            case 'resource (closed)':
+            case 'resource':
+                throw new \RuntimeException('Laravel model properties should not contain resources !');
+            case 'unknown type':
+            default:
+                throw new \RuntimeException('Unhandled Type ' . \gettype($value));
+        } //end switch
+    }
+
+    // * RELATIONS
+
+    /**
+     * User BelongsTo relation.
+     *
+     * @return \Illuminate\Database\Eloquent\Relations\BelongsTo
+     */
+    public function user(): \Illuminate\Database\Eloquent\Relations\BelongsTo
+    {
+        return $this->belongsTo(User::class);
+    }
+}

app/Models/GeneralConfig.php

@@ -3,15 +3,14 @@
 namespace App\Models;
 
 use App\Enums\GeneralConfigType;
+use App\Traits\Models\ActivityLog;
 use App\Traits\Models\MiniCrudModel;
-use Illuminate\Database\Eloquent\Collection;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Support\Facades\Cache;
-use Kwaadpepper\Enum\Traits\CastsEnums;
 
 class GeneralConfig extends Model
 {
-    use CastsEnums;
+    use ActivityLog;
     use MiniCrudModel;
 
     /**
@@ -28,31 +27,26 @@ class GeneralConfig extends Model
      */
     public $incrementing = false;
 
-    /**
-     * The attributes that should be cast.
-     *
-     * @var array
-     */
-    protected $casts = [
-        'data' => 'array'
-    ];
-
-    /**
-     * The attributes that should be cast to Enums.
-     *
-     * @var array
-     */
-    protected $enumCasts = [
-        'type' => GeneralConfigType::class
-    ];
-
     /**
      * The attributes that are mass assignable.
      *
-     * @var array
+     * @var array<int, string>
      */
     protected $fillable = [
-        'type', 'data'
+        'type',
+        'data',
+        'created_at',
+        'updated_at'
+    ];
+
+    /**
+     * The attributes that should be cast.
+     *
+     * @var array<string, string>
+     */
+    protected $casts = [
+        'type' => GeneralConfigType::class,
+        'data' => 'object',
     ];
 
     /**
@@ -62,16 +56,13 @@ class GeneralConfig extends Model
      */
     protected static function booted()
     {
-        // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.FoundInExtendedClass
-        static::created(function (GeneralConfig $config) {
+        static::created(function () {
             Cache::delete('GeneralConfigGlobal');
         });
-        // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.FoundInExtendedClass
-        static::updated(function (GeneralConfig $config) {
+        static::updated(function () {
             Cache::delete('GeneralConfigGlobal');
         });
-        // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.FoundInExtendedClass
-        static::deleted(function (GeneralConfig $config) {
+        static::deleted(function () {
             Cache::delete('GeneralConfigGlobal');
         });
     }
@@ -79,9 +70,9 @@ class GeneralConfig extends Model
     /**
      * Get from cached all configs
      *
-     * @return \Illuminate\Database\Eloquent\Collection<mixed, \App\Models\GeneralConfig>
+     * @return \Illuminate\Database\Eloquent\Collection
      */
-    public static function getCachedConfigs(): Collection
+    public static function getCachedConfigs(): \Illuminate\Database\Eloquent\Collection
     {
         if (!Cache::has('GeneralConfigGlobal')) {
             self::setCachedConfigs();

app/Models/StaticPage.php

@@ -0,0 +1,143 @@
+<?php
+
+namespace App\Models;
+
+use App\Enums\StaticPageType;
+use App\Lib\Helpers\ToolboxHelper;
+use App\Traits\Models\ActivityLog;
+use App\Traits\Models\MiniCrudModel;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Support\Facades\Cache;
+use Illuminate\Support\Str;
+
+/**
+ * @property \App\Enums\StaticPageType       $type       Page type (StaticPageEnum).
+ * @property string                          $title      Title for the page.
+ * @property string                          $slug       Slug of the title for the page.
+ * @property string                          $content    WYSIWYG text content using ckeditor.
+ * @property-read \Illuminate\Support\Carbon $created_at Created date.
+ * @property-read \Illuminate\Support\Carbon $updated_at Updated date.
+ */
+class StaticPage extends Model
+{
+    use ActivityLog;
+    use HasFactory;
+    use MiniCrudModel;
+
+    /**
+     * The attributes that are mass assignable.
+     *
+     * @var array<int, string>
+     */
+    protected $fillable = [
+        'type',
+        'title',
+        'subtitle',
+        'content',
+    ];
+
+    /**
+     * The attributes that should be cast.
+     *
+     * @var array<string, string>
+     */
+    protected $casts = [
+        'type' => StaticPageType::class,
+        'data' => 'object',
+    ];
+
+    /**
+     * Perform any actions required after the model boots.
+     *
+     * @return void
+     */
+    protected static function booted(): void
+    {
+        static::creating(function () {
+            throw new \RuntimeException("Creating a new page is not authorized");
+        });
+        static::updating(function (self $model) {
+            self::assertTitleIsUnique($model->title, $model->getKey());
+            $model->slug = Str::slug($model->title);
+        });
+        static::updated(function (self $model) {
+            self::resetCache($model->type);
+        });
+        static::deleted(function () {
+            throw new \RuntimeException('Deleting a page is not authorized');
+        });
+    }
+
+    // * ROUTABLE
+
+    /**
+     * Get the value of the model's route key.
+     *
+     * @return mixed
+     */
+    public function getRouteKey(): mixed
+    {
+        /** @var \App\Enums\StaticPageType */
+        $enum = $this->getAttribute($this->getRouteKeyName());
+        return $enum->value();
+    }
+
+    /**
+     * Get the route key for the model.
+     *
+     * ! Type is the routable parameter
+     *
+     * @return string
+     */
+    public function getRouteKeyName(): string
+    {
+        return 'type';
+    }
+
+    // * METHODS
+
+    /**
+     * Asserts using validation that the title is unique
+     *
+     * @param string       $title
+     * @param integer|null $id
+     * @return void
+     * @throws \Illuminate\Validation\ValidationException If an actu title already exists.
+     */
+    private static function assertTitleIsUnique(string $title, ?int $id = null): void
+    {
+        $table = (new self())->getTable();
+        ToolboxHelper::assertFieldIsUnique($table, 'title', $title, $id);
+        ToolboxHelper::assertFieldIsUnique($table, 'slug', Str::slug($title), $id);
+    }
+
+    /**
+     * Reset all cache elements related to this model.
+     *
+     * @param \App\Enums\StaticPageType $type
+     * @return void
+     */
+    private static function resetCache(StaticPageType $type): void
+    {
+        Cache::forget(sprintf('%sStaticPage', $type->name));
+        self::getCachedStaticPage($type);
+
+        // Breeding pages.
+        Cache::forget('breedingStaticPages');
+    }
+
+    /**
+     * Get cached static page associated to a given type.
+     *
+     * @param \App\Enums\StaticPageType $type
+     * @return \App\Models\StaticPage
+     */
+    public static function getCachedStaticPage(StaticPageType $type): \App\Models\StaticPage
+    {
+        return Cache::rememberForever(
+            sprintf('%sStaticPage', $type->name),
+            fn() => self::query()->where('type', $type)->first()
+        );
+    }
+}

app/Models/User.php

@@ -2,15 +2,26 @@
 
 namespace App\Models;
 
-use App\Lib\ToolboxHelper;
+use App\Enums\Users\RoleEnum;
+use App\Traits\Models\ActivityLog;
+use Illuminate\Auth\Access\AuthorizationException;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Foundation\Auth\User as Authenticatable;
 use Illuminate\Notifications\Notifiable;
-use Illuminate\Support\Facades\Hash;
-use Illuminate\Support\Str;
 
+/**
+ * @property string                          $first_name   Firstname.
+ * @property string                          $last_name    Lastname.
+ * @property string                          $email        Email.
+ * @property \App\Enums\Users\RoleEnum       $role         Role.
+ * @property bool                            $published    Published status.
+ * @property \Illuminate\Support\Carbon      $published_at Publication status update date.
+ * @property-read \Illuminate\Support\Carbon $created_at   Created date.
+ * @property-read \Illuminate\Support\Carbon $updated_at   Updated date.
+ */
 class User extends Authenticatable
 {
+    use ActivityLog;
     use HasFactory;
     use Notifiable;
 
@@ -20,9 +31,12 @@ class User extends Authenticatable
      * @var array<int, string>
      */
     protected $fillable = [
-        'name',
+        'first_name',
+        'last_name',
         'email',
-        'password',
+        'role',
+        'published',
+        'published_at',
     ];
 
     /**
@@ -31,7 +45,6 @@ class User extends Authenticatable
      * @var array<int, string>
      */
     protected $hidden = [
-        'password',
         'remember_token',
     ];
 
@@ -41,8 +54,9 @@ class User extends Authenticatable
      * @var array<string, string>
      */
     protected $casts = [
-        'email_verified_at' => 'datetime',
-        'last_connection' => 'datetime',
+        'role'              => RoleEnum::class,
+        'published'         => 'boolean',
+        'published_at'      => 'datetime',
     ];
 
     /**
@@ -50,37 +64,28 @@ class User extends Authenticatable
      *
      * @return void
      */
-    protected static function booted()
+    protected static function booted(): void
     {
-        // * EVENT CLOSURES.
-        static::creating(function (self $user) {
-            static::assertEmailIsUnique($user->email);
-            if (Hash::needsRehash($user->password)) {
-                $user->password = Hash::make($user->password);
-            }
-            $user->remember_token = Str::random(10);
+        static::creating(function (self $model) {
+            // * Prevent user elevation privileges
+            throw_if(
+                auth('backend')->user() and auth('backend')->user()->role->value() > $model->role->value(),
+                AuthorizationException::class
+            );
         });
-        static::updating(function (self $user) {
-            static::assertEmailIsUnique($user->email, $user->id);
-            if (Hash::needsRehash($user->password)) {
-                $user->password = Hash::make($user->password);
+        static::updating(function (self $model) {
+            if (optional(auth('backend')->user())->getKey() === $model->getKey()) {
+                \validator(
+                    ['published' => $model->published],
+                    ['published' => 'required|boolean|accepted'],
+                    ['published.accepted' => trans('crud.messages.user_unpublished')],
+                )->validate();
             }
-            $user->remember_token = Str::random(10);
+            // * Prevent user elevation privileges
+            throw_if(
+                auth('backend')->user() and auth('backend')->user()->role->value() > $model->role->value(),
+                AuthorizationException::class
+            );
         });
     }
-
-    // * METHODS
-
-    /**
-     * Asserts using validation that the email is unique
-     *
-     * @param mixed        $email
-     * @param integer|null $id
-     * @return void
-     * @throws \Illuminate\Validation\ValidationException If user email as already used.
-     */
-    private static function assertEmailIsUnique($email, ?int $id = null)
-    {
-        ToolboxHelper::assertFieldIsUnique((new self())->getTable(), 'email', $email, $id);
-    }
 }

app/Observers/ModelObserver.php

@@ -0,0 +1,54 @@
+<?php
+
+namespace App\Observers;
+
+use App\Enums\ActivityLogs\ActivityLogsEventEnum;
+use App\Models\ActivityLog;
+use Illuminate\Database\Eloquent\Model;
+
+class ModelObserver
+{
+    /**
+     * Handle the model "created" event.
+     *
+     * @param \Illuminate\Database\Eloquent\Model $model
+     * @return void
+     */
+    public static function created(Model $model): void
+    {
+        ActivityLog::addActivity($model, ActivityLogsEventEnum::created);
+    }
+
+    /**
+     * Handle the model "updated" event.
+     *
+     * @param \Illuminate\Database\Eloquent\Model $model
+     * @return void
+     */
+    public static function updated(Model $model): void
+    {
+        ActivityLog::addActivity($model, ActivityLogsEventEnum::updated);
+    }
+
+    /**
+     * Handle the model "duplicated" event.
+     *
+     * @param \Illuminate\Database\Eloquent\Model $model
+     * @return void
+     */
+    public static function duplicated(Model $model): void
+    {
+        ActivityLog::addActivity($model, ActivityLogsEventEnum::duplicated);
+    }
+
+    /**
+     * Handle the model "deleted" event.
+     *
+     * @param \Illuminate\Database\Eloquent\Model $model
+     * @return void
+     */
+    public static function deleted(Model $model): void
+    {
+        ActivityLog::addActivity($model, ActivityLogsEventEnum::deleted);
+    }
+}

app/Policies/GeneralConfigPolicy.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace App\Policies;
+
+use App\Enums\Users\RoleEnum;
+use App\Models\User;
+use App\Policies\Rules\UserStaticRules;
+
+class GeneralConfigPolicy
+{
+    /**
+     * Determine whether the user can view the model.
+     *
+     * @param \App\Models\User $authUser
+     * @return boolean
+     */
+    public function view(User $authUser): bool
+    {
+        return UserStaticRules::atLeastRole($authUser, RoleEnum::admin);
+    }
+
+    /**
+     * Determine whether the user can update the model.
+     *
+     * @param \App\Models\User $authUser
+     * @return boolean
+     */
+    public function update(User $authUser): bool
+    {
+        return UserStaticRules::atLeastRole($authUser, RoleEnum::admin);
+    }
+}

app/Policies/Rules/UserStaticRules.php

@@ -0,0 +1,51 @@
+<?php
+
+namespace App\Policies\Rules;
+
+use App\Enums\Users\RoleEnum;
+use App\Models\User;
+
+/**
+ * Userlevel Policiy Static Rules
+ *
+ * @codeCoverageIgnore
+ */
+abstract class UserStaticRules
+{
+    /**
+     * Allow everyone.
+     *
+     * @return boolean
+     */
+    public static function everyOne(): bool
+    {
+        return true;
+    }
+
+    /**
+     * Allow no one.
+     *
+     * @return boolean
+     */
+    public static function noOne(): bool
+    {
+        return false;
+    }
+
+    /**
+     * At least a minimum role
+     *
+     * @param \App\Models\User               $user
+     * @param \App\Enums\Users\RoleEnum|null $minRole
+     * @return boolean
+     */
+    public static function atLeastRole(User $user, RoleEnum|null $minRole): bool
+    {
+        // phpcs:enable
+        // Condition for creation case when user model is null.
+        if (!$minRole) {
+            return true;
+        }
+        return $user->role->value() <= $minRole->value();
+    }
+}

app/Policies/StaticPagePolicy.php

@@ -0,0 +1,47 @@
+<?php
+
+namespace App\Policies;
+
+use App\Enums\Users\RoleEnum;
+use App\Models\StaticPage;
+use App\Models\User;
+use App\Policies\Rules\UserStaticRules;
+
+class StaticPagePolicy
+{
+    /**
+     * Determine whether the user can view any models.
+     *
+     * @param \App\Models\User $authUser
+     * @return boolean
+     */
+    public function viewAny(User $authUser): bool
+    {
+        return UserStaticRules::atLeastRole($authUser, RoleEnum::admin);
+    }
+
+    /**
+     * Determine whether the user can view the model.
+     *
+     * @param \App\Models\User $authUser
+     * @return boolean
+     */
+    public function view(User $authUser): bool
+    {
+        return UserStaticRules::atLeastRole($authUser, RoleEnum::admin);
+    }
+
+    /**
+     * Determine whether the user can update the model.
+     *
+     * @param \App\Models\User       $authUser
+     * @param \App\Models\StaticPage $static_page
+     * @return boolean
+     * @phpcs:disable Generic.CodeAnalysis.UnusedFunctionParameter.FoundAfterLastUsed
+     */
+    public function update(User $authUser, StaticPage $static_page): bool
+    {
+        // phpcs:enable
+        return UserStaticRules::atLeastRole($authUser, RoleEnum::admin);
+    }
+}

app/Policies/UserPolicy.php

@@ -0,0 +1,129 @@
+<?php
+
+namespace App\Policies;
+
+use App\Enums\Users\RoleEnum;
+use App\Models\User;
+use App\Policies\Rules\UserStaticRules;
+
+class UserPolicy
+{
+    /**
+     * Determine whether the user can view any models.
+     *
+     * @param \App\Models\User $authUser
+     * @return boolean
+     */
+    public function viewAny(User $authUser): bool
+    {
+        return UserStaticRules::atLeastRole($authUser, RoleEnum::admin);
+    }
+
+    /**
+     * Determine whether the user can view the model.
+     *
+     * @param \App\Models\User $authUser
+     * @param \App\Models\User $user
+     * @return boolean
+     */
+    public function view(User $authUser, User $user): bool
+    {
+        return UserStaticRules::atLeastRole($authUser, RoleEnum::admin) and
+            UserStaticRules::atLeastRole($authUser, $user->role);
+    }
+
+    /**
+     * Determine whether the user can create models.
+     *
+     * @param \App\Models\User $authUser
+     * @return boolean
+     */
+    public function create(User $authUser): bool
+    {
+        return UserStaticRules::atLeastRole($authUser, RoleEnum::admin);
+    }
+
+    /**
+     * Determine whether the user can update the model.
+     *
+     * @param \App\Models\User $authUser
+     * @param \App\Models\User $user
+     * @return boolean
+     */
+    public function update(User $authUser, User $user): bool
+    {
+        return $authUser->getRouteKey() === $user->getRouteKey() or
+            (UserStaticRules::atLeastRole($authUser, RoleEnum::admin) and
+                UserStaticRules::atLeastRole($authUser, $user->role));
+    }
+
+    /**
+     * Determine whether the user can delete the model.
+     *
+     * @param \App\Models\User $authUser
+     * @param \App\Models\User $user
+     * @return boolean
+     */
+    public function delete(User $authUser, User $user): bool
+    {
+        return $authUser->getRouteKey() !== $user->getRouteKey() and
+            UserStaticRules::atLeastRole($authUser, RoleEnum::admin) and
+            UserStaticRules::atLeastRole($authUser, $user->role);
+    }
+
+    /**
+     * Determine whether the user can restore the model.
+     *
+     * @param \App\Models\User $authUser
+     * @param \App\Models\User $user
+     * @return boolean
+     */
+    public function restore(User $authUser, User $user): bool
+    {
+        return $authUser->getRouteKey() !== $user->getRouteKey() and
+            UserStaticRules::atLeastRole($authUser, RoleEnum::admin) and
+            UserStaticRules::atLeastRole($authUser, $user->role);
+    }
+
+    /**
+     * Determine whether the user can permanently delete the model.
+     *
+     * @param \App\Models\User $authUser
+     * @param \App\Models\User $user
+     * @return boolean
+     */
+    public function forceDelete(User $authUser, User $user): bool
+    {
+        return $authUser->getRouteKey() !== $user->getRouteKey() and
+            UserStaticRules::atLeastRole($authUser, RoleEnum::admin) and
+            UserStaticRules::atLeastRole($authUser, $user->role);
+    }
+
+    /**
+     * Determine whether the user can duplicate the model.
+     *
+     * @param \App\Models\User $authUser
+     * @param \App\Models\User $user
+     * @return boolean
+     */
+    public function duplicate(User $authUser, User $user): bool
+    {
+        return $authUser->getRouteKey() !== $user->getRouteKey() and
+            UserStaticRules::atLeastRole($authUser, RoleEnum::admin) and
+            UserStaticRules::atLeastRole($authUser, $user->role);
+    }
+
+    /**
+     * Determine whether the user can publish/unpublish the model.
+     *
+     * @param \App\Models\User $authUser
+     * @param \App\Models\User $user
+     * @return boolean
+     */
+    public function changePublished(User $authUser, User $user): bool
+    {
+        return $authUser->getRouteKey() !== $user->getRouteKey() and
+            UserStaticRules::atLeastRole($authUser, RoleEnum::admin) and
+            UserStaticRules::atLeastRole($authUser, $user->role);
+    }
+}

app/Providers/AppServiceProvider.php

@@ -2,22 +2,14 @@
 
 namespace App\Providers;
 
-use Illuminate\Pagination\Paginator;
 use Illuminate\Support\Carbon;
+use Illuminate\Support\Facades\App;
 use Illuminate\Support\Facades\URL;
 use Illuminate\Support\ServiceProvider;
+use Illuminate\Database\Eloquent\Model;
 
 class AppServiceProvider extends ServiceProvider
 {
-    /**
-     * Register any application services.
-     *
-     * @return void
-     */
-    public function register()
-    {
-    }
-
     /**
      * Bootstrap any application services.
      *
@@ -25,34 +17,27 @@ class AppServiceProvider extends ServiceProvider
      */
     public function boot()
     {
+        Model::shouldBeStrict(!$this->app->environment('production'));
+
+        // * HTTPS FIX
         URL::forceScheme('https');
 
-        // * LOCAL FORCE eg: for Carbon
-        // * Remove numeric to prevent float seperator to breaking numeric transactions
-        \collect([\LC_TIME, \LC_MESSAGES, \LC_COLLATE, \LC_CTYPE, \LC_MONETARY])
-            ->map(function ($contant) {
-                setlocale(
-                    $contant,
-                    \sprintf(
-                        '%s_%s.UTF-8',
-                        config('app.locale'),
-                        \strtoupper(config('app.locale'))
-                    )
-                );
-            });
-        Carbon::setLocale(config('app.locale'));
-
-        // * Force bootstrap paginator from Alexis with tooltips.
-        Paginator::defaultView('bo.modules.pagination');
-
         // * HA PROXY FIX
-        app()->singleton('clientIp', function () {
-            if (
-                config('app.env') === 'local'
-            ) {
+        App::singleton('clientIp', function () {
+            if (config('app.env') === 'local') {
                 return request()->getClientIp();
+            } else {
+                return request()->server('HTTP_X_FORWARDED_FOR') ??
+                    request()->getClientIp();
             }
-            return request()->server('HTTP_X_FORWARDED_FOR') ?? request()->getClientIp();
         });
+
+        // * LOCAL FORCE eg: for Carbon
+        setlocale(LC_ALL, \sprintf(
+            '%s_%s.UTF-8',
+            config('app.locale'),
+            \strtoupper(config('app.locale'))
+        ));
+        Carbon::setLocale(config('app.locale'));
     }
 }

app/Providers/AuthServiceProvider.php

@@ -2,12 +2,15 @@
 
 namespace App\Providers;
 
+use App\Enums\Users\RoleEnum;
+use App\Models\User;
 use Illuminate\Foundation\Support\Providers\AuthServiceProvider as ServiceProvider;
+use Illuminate\Support\Facades\Gate;
 
 class AuthServiceProvider extends ServiceProvider
 {
     /**
-     * The policy mappings for the application.
+     * The model to policy mappings for the application.
      *
      * @var array<class-string, class-string>
      */
@@ -18,8 +21,10 @@ class AuthServiceProvider extends ServiceProvider
      *
      * @return void
      */
-    public function boot()
+    public function boot(): void
     {
-        $this->registerPolicies();
+        Gate::define('isConceptor', function (User $user) {
+            return $user->role === RoleEnum::conceptor;
+        });
     }
 }

app/Providers/EventServiceProvider.php

@@ -5,11 +5,18 @@ namespace App\Providers;
 use Illuminate\Auth\Events\Registered;
 use Illuminate\Auth\Listeners\SendEmailVerificationNotification;
 use Illuminate\Foundation\Support\Providers\EventServiceProvider as ServiceProvider;
+use Illuminate\Support\Facades\Event;
+use App\Models\User;
+use Illuminate\Support\Facades\Auth;
+use Illuminate\Support\Facades\Cache;
+use Illuminate\Support\Facades\Session;
+use Slides\Saml2\Events\SignedIn;
+use Slides\Saml2\Events\SignedOut;
 
 class EventServiceProvider extends ServiceProvider
 {
     /**
-     * The event listener mappings for the application.
+     * The event to listener mappings for the application.
      *
      * @var array<class-string, array<int, class-string>>
      */
@@ -19,6 +26,16 @@ class EventServiceProvider extends ServiceProvider
         ],
     ];
 
+    /**
+     * Determine if events and listeners should be automatically discovered.
+     *
+     * @return boolean
+     */
+    public function shouldDiscoverEvents(): bool
+    {
+        return false;
+    }
+
     /**
      * Register any events for your application.
      *
@@ -26,5 +43,41 @@ class EventServiceProvider extends ServiceProvider
      */
     public function boot()
     {
+        Event::listen('Slides\Saml2\Events\SignedIn', function (SignedIn $event) {
+
+            $messageId = $event->getAuth()->getLastMessageId();
+
+            $fromCache = Cache::get(config('cache.prefix') . "_saml_message_id_" . $messageId);
+            if ($fromCache) {
+                logger()->error(
+                    'SAML MESSAGE ID HANDLER',
+                    ['error' => 'Message ID : ' . $messageId . " replayed !"]
+                );
+                abort(403);
+            } else {
+                Cache::put(config('cache.prefix') . "_saml_message_id_" . $messageId, $messageId, 28800);
+                // Cache for 8h.
+            }
+
+            $user  = $event->getSaml2User();
+            $email = $user->getNameId();
+
+            $lUser = User::where('email', '=', $email)->first();
+
+            if (!$lUser) {
+                abort(403);
+            }
+
+            Auth::guard('backend')->login($lUser);
+            session(['sessionIndex' => $user->getSessionIndex()]);
+            $lUser->last_connection = now();
+            $lUser->saveQuietly();
+        });
+
+        //phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.Found
+        Event::listen('Slides\Saml2\Events\SignedOut', function (SignedOut $event) {
+            Auth::guard('backend')->logout();
+            Session::save();
+        });
     }
 }

app/Providers/RouteServiceProvider.php

@@ -2,9 +2,7 @@
 
 namespace App\Providers;
 
-use App\Enums\GeneralConfigType;
-use App\Lib\ToolboxHelper;
-use App\Models\GeneralConfig;
+use App\Models\User;
 use Illuminate\Cache\RateLimiting\Limit;
 use Illuminate\Foundation\Support\Providers\RouteServiceProvider as ServiceProvider;
 use Illuminate\Http\Request;
@@ -14,43 +12,36 @@ use Illuminate\Support\Facades\Route;
 class RouteServiceProvider extends ServiceProvider
 {
     /**
-     * The path to the "home" route for your application.
+     * The path to your application's "home" route.
      *
-     * This is used by Laravel authentication to redirect users after login.
+     * Typically, users are redirected here after authentication.
      *
      * @var string
      */
-    public const HOME = '/home';
+    public const HOME = '/';
 
     /**
-     * Define your route model bindings, pattern filters, etc.
+     * Define your route model bindings, pattern filters, and other route configuration.
      *
      * @return void
      */
-    public function boot()
+    public function boot(): void
     {
         $this->configureRateLimiting();
 
-        ToolboxHelper::cspReportRoute();
+        $this->cspReportRoute();
 
         $this->routes(function () {
             Route::middleware('web')
                 ->namespace($this->namespace)
-                ->group(base_path('routes/web-fo.php'));
+                ->group(base_path('routes/web-bo.php'));
 
             Route::middleware('web')
                 ->namespace($this->namespace)
-                ->group(base_path('routes/web-bo.php'));
+                ->group(base_path('routes/web-fo.php'));
         });
 
-        Route::bind('general_config', function ($value) {
-            try {
-                return GeneralConfig::where('type', GeneralConfigType::make(\intval($value)))
-                    ->firstOrFail();
-            } catch (\BadMethodCallException $e) {
-                abort(404);
-            }
-        });
+        Route::model('user', User::class);
     }
 
     /**
@@ -58,10 +49,52 @@ class RouteServiceProvider extends ServiceProvider
      *
      * @return void
      */
-    protected function configureRateLimiting()
+    protected function configureRateLimiting(): void
     {
+        RateLimiter::for('api', function (Request $request) {
+            return Limit::perMinute(150)->by($request->user()?->id ?: app('clientIp'));
+        });
         RateLimiter::for('web', function (Request $request) {
-            return Limit::perMinute(150)->by(optional($request->user())->id ?: app('clientIp'));
+            return Limit::perMinute(150)->by($request->user()?->id ?: app('clientIp'));
+        });
+        RateLimiter::for('credentials', function (Request $request) {
+            return Limit::perMinute(30)->by($request->user()?->id ?: app('clientIp'));
         });
     }
+
+    /**
+     * * Register CSP report URI
+     *
+     * Put this function inside RouteServiceProvider,
+     * and call it in RouteServiceProvider::boot
+     *
+     * @return void
+     */
+    private function cspReportRoute()
+    {
+        // * CSP REPORT URI, Please add /csp-report to VerifyCsrfToken $except middleware
+        \Illuminate\Support\Facades\Route::post('/csp-report', function () {
+            $isCspRequest = request()->header('Content-Type') === 'application/csp-report';
+            if (!$isCspRequest or !request()->json('csp-report') or !is_array(request()->json('csp-report'))) {
+                abort(401);
+            }
+            // * Flatten if needed
+            $cspReport = collect(request()->json('csp-report'))
+                ->flatMap(function ($v, $k) {
+                    return [$k => is_array($v) ? collect($v)->flatten()->implode(', ') : $v];
+                })->all();
+            // * Filter array keys
+            $cspReport = collect(array_intersect_key($cspReport, [
+                'blocked-uri' => '', 'document-uri' => '', 'original-policy' => '',
+                'referrer' => '', 'violated-directive' => ''
+            ]));
+            \Illuminate\Support\Facades\Log::warning(sprintf(
+                "CSP REPORT for %s : \n %s",
+                $cspReport->get('document-uri'),
+                $cspReport->implode("\n")
+            ));
+        })->middleware('throttle:5,2')
+            ->withoutMiddleware(\App\Http\Middleware\VerifyCsrfToken::class)
+            ->name('cspReportUri');
+    }
 }

app/Providers/TranslationServiceProvider.php

@@ -2,10 +2,12 @@
 
 namespace App\Providers;
 
+use App\Lib\Helpers\ToolboxHelper;
 use Illuminate\Support\Collection;
 use Illuminate\Support\Facades\File;
 use Illuminate\Support\Facades\Cache;
 use Illuminate\Support\ServiceProvider;
+use Symfony\Component\Finder\SplFileInfo;
 
 class TranslationServiceProvider extends ServiceProvider
 {
@@ -14,14 +16,24 @@ class TranslationServiceProvider extends ServiceProvider
      *
      * @return void
      */
-    public function boot()
+    public function boot(): void
     {
         foreach ($this->collectLocalesStrings() as $locale) {
             // * Suported locales
             Cache::rememberForever(sprintf('translations.%s', $locale), function () use ($locale) {
-                $translations = [
-                    'php' => $this->phpTranslations($locale),
-                    'json' => $this->jsonTranslations($locale),
+                $phpTransFallback  = $this->phpTranslations(config('app.fallback_locale'));
+                $phpTransLocale    = $this->phpTranslations($locale);
+                $jsonTransFallback = $this->jsonTranslations(config('app.fallback_locale'));
+                $jsonTransLocale   = $this->jsonTranslations($locale);
+                $translations      = [
+                    'php' => ToolboxHelper::arrayMergeRecursiveDistinct(
+                        $phpTransLocale,
+                        $phpTransFallback,
+                    ),
+                    'json' => ToolboxHelper::arrayMergeRecursiveDistinct(
+                        $jsonTransLocale,
+                        $jsonTransFallback,
+                    ),
                 ];
                 return $translations;
             });
@@ -31,27 +43,33 @@ class TranslationServiceProvider extends ServiceProvider
     /**
      * Gather provided langs checking from files
      *
-     * @return Collection
+     * @return \Illuminate\Support\Collection<string, string>
      */
     private function collectLocalesStrings(): Collection
     {
-        return collect(File::allFiles(resource_path('lang/')))->flatMap(function ($file) {
-            if ($file->getRelativePath()) {
+        // * En dur dans ->keys array<int,string>.
+        // @phpstan-ignore-next-line
+        return collect(File::allFiles(resource_path('lang/')))->flatMap(function (SplFileInfo $file) {
+            if ($file->getRelativePath() and \strpos($file->getRelativePath(), 'vendor') !== 0) {
                 return [$file->getRelativePath() => ''];
             }
-        })->keys();
+        })->keys()->merge(config('app.locales', []));
     }
 
     /**
      * Gather all php translations
      *
      * @param string $locale
-     * @return array
+     * @return array<string, string>
      */
     private function phpTranslations(string $locale): array
     {
         $path = resource_path("lang/$locale");
 
+        if (!File::exists($path) or !File::isReadable($path)) {
+            return [];
+        }
+
         return collect(File::allFiles($path))->flatMap(function ($file) use ($locale) {
             $translation = $file->getBasename('.php');
             return [$translation => trans($translation, [], $locale)];
@@ -62,16 +80,16 @@ class TranslationServiceProvider extends ServiceProvider
      * Gather json translations
      *
      * @param string $locale
-     * @return array
+     * @return array<string, string>
      */
     private function jsonTranslations(string $locale): array
     {
         $path = resource_path("lang/$locale.json");
 
-        if (is_string($path) && is_readable($path)) {
-            return json_decode(file_get_contents($path), true) ?? [];
+        if (!File::exists($path) or !File::isReadable($path)) {
+            return [];
         }
 
-        return [];
+        return json_decode(File::get($path), true) ?? [];
     }
 }

app/Providers/ViewServiceProvider.php

@@ -0,0 +1,39 @@
+<?php
+
+namespace App\Providers;
+
+use Illuminate\Pagination\Paginator;
+use Illuminate\Support\Facades\Cache;
+use Illuminate\Support\Facades\File;
+use Illuminate\Support\Facades\View;
+use Illuminate\Support\ServiceProvider;
+
+class ViewServiceProvider extends ServiceProvider
+{
+    /**
+     * Bootstrap any application services.
+     *
+     * @return void
+     */
+    public function boot(): void
+    {
+        $appInfos = Cache::remember('composer', 360, function () {
+            return json_decode(File::get(\app_path('../composer.json')));
+        });
+        // Share composer.json infos.
+        if (isset($appInfos->name) and isset($appInfos->version)) {
+            View::share('cpsr_name', $appInfos->name);
+            View::share('cpsr_version', $appInfos->version);
+        }
+
+        if (!app()->runningInConsole()) {
+            // * FORCE BOOTSTRAP PAGINATOR (or custom if in front)
+            // Early boot, request wont be filled as expected.
+            if (collect(explode('/', \request()->getPathInfo()))->get(1) === 'bo') {
+                Paginator::defaultView('bo.modules.pagination');
+            } else {
+                Paginator::useBootstrapFive();
+            }
+        }
+    }
+}

app/Rules/WysiwygLength.php

@@ -0,0 +1,83 @@
+<?php
+
+namespace App\Rules;
+
+use Illuminate\Contracts\Validation\ValidationRule;
+use Illuminate\Support\Str;
+
+/**
+ * Check the length of a Wysiwyg field, excluding tags and end spaces.
+ *
+ * @package App\Rules
+ */
+class WysiwygLength implements ValidationRule
+{
+    /**
+     * Construct method.
+     *
+     * @param integer      $min The minimum length of the content (excluding tags). Default is 15.
+     * @param integer|null $max The maximum length of the content (excluding tags).
+     *  Default is null (max will be defined by the type of the column in DB).
+     * @return void
+     * @throws \InvalidArgumentException If $max < $min.
+     */
+    public function __construct(private int $min = 15, private int|null $max = null)
+    {
+        if ($max !== null && $max < $min && $min < 0) {
+            throw new \InvalidArgumentException(sprintf(
+                '$max should be higher than $min. $max = %d. $min = %d.',
+                $max,
+                $min
+            ));
+        }
+    }
+
+    /**
+     * Run the validation rule.
+     *
+     * @param string   $attribute
+     * @param mixed    $value
+     * @param \Closure $fail
+     *
+     * @return void
+     */
+    public function validate(string $attribute, mixed $value, \Closure $fail): void
+    {
+        $length = Str::length(\strip_tags($value));
+
+        $translatedAttribute = self::getTranslatedAttribute($attribute);
+        if (!\is_null($this->max) and !($length >= $this->min && $length <= $this->max)) {
+            $fail(trans('validation.between.string', [
+                'attribute' => $translatedAttribute,
+                'min' => $this->min,
+                'max' => $this->max
+            ]));
+            return;
+        }
+        if ($length < $this->min) {
+            $fail(trans('validation.min.string', [
+                'attribute' => $translatedAttribute,
+                'min' => $this->min
+            ]));
+        }
+    }
+
+    /**
+     * Get the correct translation for the given attrribute.
+     *
+     * @param string $attribute
+     * @return string
+     */
+    private static function getTranslatedAttribute(string $attribute): string
+    {
+        /** @var \Illuminate\Translation\Translator $trans */
+        $trans = trans();
+        if ($trans->has('validation.attributes.' . $attribute)) {
+            return trans('validation.attributes.' . $attribute);
+        }
+        if ($trans->has('validation.custom.' . $attribute)) {
+            return trans('validation.custom.' . $attribute);
+        }
+        return $attribute;
+    }
+}

app/Traits/Controllers/ChangesModelOrder.php

@@ -0,0 +1,64 @@
+<?php
+
+namespace App\Traits\Controllers;
+
+use App\Http\Requests\Bo\UpdateChangeOrderRequest;
+use Illuminate\Support\Arr;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Session;
+use Illuminate\Support\Str;
+
+trait ChangesModelOrder
+{
+    /**
+     * Change order.
+     *
+     * @param \App\Http\Requests\Bo\UpdateChangeOrderRequest $request
+     * @param mixed                                          ...$params
+     * @return \Illuminate\Http\RedirectResponse
+     * @throws \RuntimeException Si le nom du parametre de la route ne correspond pas au params utilisé.
+     */
+    public function changeOrder(UpdateChangeOrderRequest $request, mixed ...$params): \Illuminate\Http\RedirectResponse
+    {
+        $paramNames = collect(request()->route()->parameterNames);
+        $className  = Str::of($paramNames->get($paramNames->count() - 2))->lower()->studly();
+        $className  = "\\App\\Models\\{$className}";
+        $model      = Arr::get($params, $paramNames->count() - 2);
+
+        if (!class_exists($className)) {
+            throw new \RuntimeException("The {$className} class doesn't exist.");
+        }
+
+        if (!\is_object($model)) {
+            throw new \RuntimeException("The second last param isn't an object.");
+        }
+
+        if (get_class($model) !== (string)Str::of($className)->replaceStart('\\', '')) {
+            throw new \RuntimeException("The {$className} doesn't match second last binded param.");
+        }
+
+        /** @var \Illuminate\Database\Eloquent\Model|null */
+        $model = $className::query()->where($model->getRouteKeyName(), $model->getRouteKey())->first();
+
+        if (!$model) {
+            return back()->with('error', trans('crud.messages.order_not_changed'));
+        }
+
+        return DB::transaction(function () use ($request, $className, $model) {
+            /** @var \Illuminate\Database\Eloquent\Model|null */
+            $tmp = $className::where('order', $request->direction ? '<' : '>', $model->getOriginal('order'))
+                ->orderBy('order', $request->direction ? 'DESC' : 'ASC')->first();
+
+            if (!$tmp) {
+                return back()->with('error', trans('crud.messages.order_not_changed'));
+            }
+
+            $newOrder = $tmp->getOriginal('order');
+            $tmp->update(['order' => $model->getOriginal('order')]);
+            $model->update(['order' => $newOrder]);
+            Session::flash('success', trans('crud.messages.order_changed'));
+
+            return back();
+        });
+    }
+}

app/Traits/Controllers/HasPicture.php

@@ -1,40 +0,0 @@
-<?php
-
-namespace App\Traits\Controllers;
-
-use App\Lib\ToolboxHelper;
-use Illuminate\Database\Eloquent\Model;
-use Illuminate\Http\Request;
-
-trait HasPicture
-{
-    /**
-     * Save Model Image
-     *
-     * @param \Illuminate\Http\Request            $request
-     * @param \Illuminate\Database\Eloquent\Model $model
-     * @return void
-     */
-    private function storePicture(Request $request, Model $model)
-    {
-        $model->picture = ToolboxHelper::storeImage($model, $request->picture);
-    }
-
-    /**
-     * Save Model Images
-     *
-     * @param \Illuminate\Http\Request            $request
-     * @param \Illuminate\Database\Eloquent\Model $model
-     * @return void
-     */
-    private function storePictures(Request $request, Model $model)
-    {
-        if (is_array($request->pictures)) {
-            $model->pictures = [];
-            $model->pictures = collect($request->pictures)
-                ->map(function ($picture) use ($model) {
-                    return ToolboxHelper::storeImage($model, $picture);
-                })->all();
-        }
-    }
-}

app/Traits/Controllers/UpdateModelPublished.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace App\Traits\Controllers;
+
+use Illuminate\Database\Eloquent\Model;
+
+/**
+ * This trait works with Route::bind in App service provider
+ * to resolve the model and the DB row
+ * It does not work with binder Service
+ */
+trait UpdateModelPublished
+{
+    /**
+     * Change model published.
+     *
+     * @param \Illuminate\Database\Eloquent\Model $model
+     * @return \Illuminate\Http\RedirectResponse
+     */
+    public function changePublished(Model $model)
+    {
+        $model->update(['published' => !$model->getOriginal('published')]);
+        return redirect()->back()->with('success', trans(__('crud.messages.publish_status_saved')));
+    }
+}

app/Traits/Enums/BaseEnum.php

@@ -0,0 +1,263 @@
+<?php
+
+namespace App\Traits\Enums;
+
+use Illuminate\Support\Str;
+
+trait BaseEnum
+{
+    // * GENERIC METHODS
+
+    /**
+     * Get enum value.
+     *
+     * @return string|integer
+     */
+    public function value(): string|int
+    {
+        return self::toValues()[$this->name];
+    }
+
+    /**
+     * Get enum label.
+     *
+     * @return string
+     */
+    public function label(): string
+    {
+        return self::toLabels()[$this->name];
+    }
+
+    /**
+     * Get enum name.
+     *
+     * @return string
+     */
+    public function name(): string
+    {
+        return $this->name;
+    }
+
+    // * STATIC FETCH METHODS
+
+    /**
+     * Get enum labels.
+     *
+     * @return array<string>
+     */
+    public static function toLabels(): array
+    {
+        if (empty(self::getCache('labels'))) {
+            $labels = self::getLabelsConstant();
+            self::setCache('labels', \collect(self::cases())
+                ->mapWithKeys(function ($enum) use ($labels) {
+                    if (!\is_null($labels) and !isset($labels[$enum->name])) {
+                        throw new \Error('Missing definition label ' . self::class . " for {$enum->name}");
+                    }
+                    return [$enum->name => \trans(
+                        !\is_null($labels) ? $labels[$enum->name] : Str::ucfirst($enum->name)
+                    )];
+                })->all());
+        }
+        return self::getCache('labels');
+    }
+
+    /**
+     * Get enum values.
+     *
+     * @return array<integer|string>
+     */
+    public static function toValues(): array
+    {
+        if (empty(self::getCache('values'))) {
+            self::setCache('values', \collect(self::cases())
+                ->mapWithKeys(fn ($enum) => [$enum->name => $enum->value])->all());
+        }
+        return self::getCache('values');
+    }
+
+    /**
+     * Get enums.
+     *
+     * @return array
+     */
+    public static function all(): array
+    {
+        return self::cases();
+    }
+
+    /**
+     * Get enums.
+     *
+     * @return array
+     */
+    public static function toArray(): array
+    {
+        if (empty(self::getCache('enums'))) {
+            $definitions = self::getCustomDefinitions();
+            self::setCache('enums', \collect(self::cases())
+                ->mapWithKeys(function ($enum) use ($definitions) {
+                    $baseArray = [
+                        'name' => $enum->name,
+                        'label' => $enum->label(),
+                        'value' => $enum->value,
+                    ];
+                    foreach ($definitions as $index => $elements) {
+                        $index = Str::lower(Str::singular($index));
+                        if (!isset($elements[$enum->name])) {
+                            throw new \Error("Missing definition {$index} " . self::class . " for {$enum->name}");
+                        }
+                        $baseArray[$index] = $elements[$enum->name];
+                    }
+                    return [$enum->name => (object)$baseArray];
+                })->all());
+        }
+        return self::getCache('enums');
+    }
+
+    /**
+     * Fetch enum using value.
+     *
+     * @param self|integer|string $value
+     * @param string              $field
+     * @return self|null
+     */
+    public static function make(self|int|string $value, string $field = 'value'): self|null
+    {
+        if ($field === "label") {
+            $enumLabels = array_change_key_case(array_flip(self::toLabels()), CASE_LOWER);
+            $value      = (isset($enumLabels[strtolower($value)])) ? $enumLabels[strtolower($value)] : false;
+            $field      = 'name';
+        }
+        return !\is_object($value) ?
+            \collect(self::cases())->keyBy($field)->get($value) : $value;
+    }
+
+    /**
+     * Test if 2 enum are equals.
+     *
+     * @param object ...$others
+     * @return boolean
+     * @throws \Error If provided element are not enums that extends BaseEnum.
+     */
+    public function equals(object ...$others): bool
+    {
+        foreach ($others as $other) {
+            if (!\in_array(BaseEnum::class, \class_uses_recursive($other))) {
+                throw new \Error(__METHOD__ .
+                    ' requires $enum to use ' . BaseEnum::class);
+            }
+            if (
+                get_class($this) === get_class($other)
+                && $this->value === $other->value
+            ) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    /**
+     * Serialize to json.
+     *
+     * @return mixed
+     */
+    public function jsonSerialize(): mixed
+    {
+        return $this->value;
+    }
+
+
+    // * CACHE
+
+    /**
+     * Get cache array.
+     *
+     * @param string $index
+     * @return array
+     */
+    private static function getCache(string $index): array
+    {
+        self::initCache();
+        if (!isset($GLOBALS[self::class]['props'][$index])) {
+            $GLOBALS[self::class]['props'][$index] = [];
+        }
+        return $GLOBALS[self::class]['props'][$index];
+    }
+
+    /**
+     * Set cache array.
+     *
+     * @param string $index
+     * @param array  $items
+     * @return void
+     */
+    private static function setCache(string $index, array $items): void
+    {
+        self::initCache();
+        if (!isset($GLOBALS[self::class]['props'][$index])) {
+            $GLOBALS[self::class]['props'][$index] = [];
+        }
+        $GLOBALS[self::class]['props'][$index] = $items;
+    }
+
+    /**
+     * Init cache if needed.
+     *
+     * @return void
+     */
+    private static function initCache(): void
+    {
+        if (!isset($GLOBALS[self::class])) {
+            $GLOBALS[self::class] = [
+                'props' => [
+                    'enums' => [],
+                    'values' => [],
+                    'labels' => []
+                ],
+                'customProps' => null
+            ];
+        }
+    }
+
+    // * PRIVATE
+
+    /**
+     * Fetch the LABELS constant if exists.
+     *
+     * @return array|null
+     */
+    private static function getLabelsConstant(): array|null
+    {
+        $class_name = self::class;
+        try {
+            $constant_reflex = new \ReflectionClassConstant($class_name, 'LABELS');
+            return $constant_reflex->getValue();
+        } catch (\ReflectionException $e) {
+            return null;
+        }
+    }
+
+    /**
+     * Get custom constants.
+     *
+     * @return array
+     */
+    private static function getCustomDefinitions(): array
+    {
+        // ? Has custom props in cache ?
+        if (!isset($GLOBALS[self::class]) or \is_null($GLOBALS[self::class]['customProps'])) {
+            $names = \collect(self::cases())->keyBy('name');
+
+            $GLOBALS[self::class]['customProps'] = \collect((new \ReflectionClass(self::class))->getConstants())
+                ->filter(function (mixed $constant, string $key) use ($names) {
+                    if ($key === 'LABELS' or !\is_array($constant)) {
+                        return false;
+                    }
+                    return \collect($constant)->keys()
+                        ->filter(fn (string $name) => $names->has($name))->count();
+                })->all();
+        }
+        return $GLOBALS[self::class]['customProps'];
+    }
+}

app/Traits/Models/ActivityLog.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace App\Traits\Models;
+
+use App\Observers\ModelObserver;
+use App\Models\ActivityLog as ActivityLogModel;
+
+/**
+ * If there is a static function in a trait (named boot[TraitName]),
+ * it will be executed as the boot() function would on an Eloquent model.
+ * Futhermore, event in the Model observer doesn't erase actual events in the model,
+ * but adds them.
+ */
+trait ActivityLog
+{
+    /**
+     *
+     * @return void
+     */
+    public static function bootActivityLog(): void
+    {
+        static::observe(ModelObserver::class);
+    }
+
+    // * RELATIONS
+
+    /**
+     * Activities logs One-to-many relationship.
+     *
+     * @return \Illuminate\Database\Eloquent\Relations\HasMany
+     */
+    public function activityLogs(): \Illuminate\Database\Eloquent\Relations\HasMany
+    {
+        return $this->hasMany(ActivityLogModel::class, 'model_id');
+    }
+}

app/Traits/Models/IsCachedAsCollection.php

@@ -0,0 +1,104 @@
+<?php
+
+namespace App\Traits\Models;
+
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Database\QueryException;
+use Illuminate\Support\Collection;
+use Illuminate\Support\Facades\Cache;
+
+/**
+ * ! Use this only on limited elements, (not on tags, or products, or posts for ex.)
+ *
+ * @property array<string,string|integer|float|boolean> $cacheConditions
+ *  Eloquent condition to cache elements (to be used in where statement).
+ */
+trait IsCachedAsCollection
+{
+    /**
+     * Get all available instances from cache.
+     * If cache was reset, it will fetch them from DB.
+     *
+     * @return \Illuminate\Database\Eloquent\Collection
+     */
+    public static function getCached(): Collection
+    {
+        if (!Cache::has(static::getCacheKeyName())) {
+            try {
+                static::setCached();
+            } catch (QueryException $e) {
+                report($e);
+                return \collect();
+            }
+        }
+        return Cache::get(static::getCacheKeyName());
+    }
+
+    /**
+     * Remove cached elements
+     *
+     * @return void
+     */
+    public static function removeCached(): void
+    {
+        Cache::forget(static::getCacheKeyName());
+    }
+
+    /**
+     * Put all instances into cache.
+     *
+     * @return void
+     */
+    protected static function setCached(): void
+    {
+        $conditions = [];
+        if (property_exists(get_called_class(), 'cacheConditions')) {
+            $conditions = collect(static::${'cacheConditions'})->all();
+        }
+        Cache::put(static::getCacheKeyName(), static::queryCached(static::query())
+            ->where($conditions)->get()
+            ->pipe(fn (Collection $collection) => \call_user_func([self::class, 'filterQuery'], $collection)));
+    }
+
+    /**
+     * Change query for cached elements
+     *
+     * @param \Illuminate\Database\Eloquent\Builder $query
+     * @return \Illuminate\Database\Eloquent\Builder
+     */
+    protected static function queryCached(Builder $query): Builder
+    {
+        return $query;
+    }
+
+    /**
+     * Change query for cached elements
+     *
+     * @param \Illuminate\Support\Collection $results
+     * @return \Illuminate\Support\Collection
+     */
+    protected static function filterQuery(Collection $results): Collection
+    {
+        return $results;
+    }
+
+    /**
+     * Get the class basename
+     *
+     * @return string
+     */
+    protected static function getCacheKeyName(): string
+    {
+        return static::getCallClassBaseName();
+    }
+
+    /**
+     * Get the class basename
+     *
+     * @return string
+     */
+    protected static function getCallClassBaseName(): string
+    {
+        return str_replace(__NAMESPACE__ . '\\', '', get_called_class());
+    }
+}

app/Traits/Models/MiniCrudModel.php

@@ -3,7 +3,8 @@
 namespace App\Traits\Models;
 
 use App\Enums\InputType;
-use App\Lib\ToolboxHelper;
+use App\Lib\Helpers\FileStorageHelper;
+use App\Lib\Helpers\ToolboxHelper;
 
 trait MiniCrudModel
 {
@@ -12,10 +13,9 @@ trait MiniCrudModel
      *
      * @param  array $attributes
      * @return void
-     * @throws \Illuminate\Database\Eloquent\MassAssignmentException If fill prop is not allowed.
-     * @phpcs:disable Squiz.Commenting.FunctionComment.EmptyThrows
+     * @phpstan-ignore-next-line
      */
-    public function fill(array $attributes)
+    public function fill(array $attributes): void
     {
         parent::fill($attributes);
         if (isset($attributes['data'])) {
@@ -23,6 +23,73 @@ trait MiniCrudModel
         }
     }
 
+    /**
+     * Apply function on data typed text while on save event
+     *
+     * @return void
+     */
+    public function minicrudCreating(): void
+    {
+        /** @var array<string,array> */
+        $data = $this->data;
+        foreach ($data as &$input) {
+            switch ($input['inputType']) {
+                case InputType::text->value:
+                    $input['text'] = clean($input['text']);
+                    $input['text'] = FileStorageHelper::storeModelFilesFromHtml($this, $input['text']);
+                    break;
+            } //end switch
+        } //end foreach
+        $this->data = $data;
+    }
+
+    /**
+     * Apply function on data typed text while on update event
+     *
+     * @return void
+     */
+    public function minicrudUpdating(): void
+    {
+        $this->minicrudCreating();
+    }
+
+    /**
+     * Apply function on data typed text while on updated event
+     *
+     * @return void
+     */
+    public function minicrudUpdated(): void
+    {
+        foreach ($this->data as $index => $input) {
+            switch ($input['inputType']) {
+                case InputType::text->value:
+                    $original = ToolboxHelper::getOriginal($this, 'data');
+                    FileStorageHelper::removeOldModelFilesFromHtml(
+                        $input['text'],
+                        $original[$index]['text'] ?? ''
+                    );
+                    break;
+            } //end switch
+        } //end foreach
+    }
+
+    /**
+     * Apply function on data typed text while on deleted event
+     *
+     * @return void
+     */
+    public function minicrudDeleted(): void
+    {
+        /** @var array */
+        foreach ($this->data as $input) {
+            switch ($input['inputType']) {
+                case InputType::text->value:
+                    FileStorageHelper::removeModelFilesOfHtml($input['text']);
+                    break;
+            } //end switch
+        } //end foreach
+    }
+
     /**
      * Set a specific prop
      *
@@ -35,69 +102,66 @@ trait MiniCrudModel
         if (isset($attrs['data'])) {
             unset($attrs['data']);
         }
-        $data = $this->serializeData($data);
-        $this->setRawAttributes(\array_merge_recursive(
-            $attrs,
-            ['data' => $data]
-        ));
+        $this->setAttribute('data', $data);
     }
 
     /**
-     * Get data attribute
-     * Cast json_decode to object.
+     * Set a specific prop
      *
-     * @return object|null
-     */
-    protected function getDataAttribute(): ?object
-    {
-        return \json_decode($this->getAttributes()['data'] ?? '[]');
-    }
-
-    /**
-     * Get data attribute
-     * Cast json_decode to object.
-     *
-     * @param array $data
+     * @param array $value
      * @return void
      */
-    protected function setDataAttribute(array $data): void
+    protected function setDataAttribute(array $value): void
     {
-        $this->setData($data);
+        $this->attributes['data'] = $this->castAttributeAsJson(
+            'data',
+            $this->serializeData($value)
+        );
+    }
+
+    /**
+     * Set a specific prop
+     *
+     * @param string|null $data
+     * @return array
+     */
+    protected function getDataAttribute(string|null $data): array
+    {
+        return $this->fromJson($data ?? $this->attributes['data'] ?? '[]');
     }
 
     /**
      * Serialize properties
      *
      * @param array $data
-     * @return string
+     * @return array
      * @throws \ErrorException If input type is no handled.
      * @throws \Illuminate\Validation\ValidationException If url is a bo url.
      * @phpcs:disable Squiz.Commenting.FunctionCommentThrowTag.WrongNumber
      * @phpcs:disable Generic.Metrics.CyclomaticComplexity.TooHigh
      */
-    private function serializeData(array $data): string
+    private function serializeData(array $data): array
     {
         foreach ($data as $o => $input) {
             switch ($input['inputType']->value ?? $input['inputType']['value']) {
-                case InputType::image()->value:
-                    $data[$o]['value'] = ToolboxHelper::storeImage($this, $input['value']);
+                case InputType::image->value:
+                    $data[$o]['value'] = \preg_replace(
+                        '/^\/|^/',
+                        '',
+                        FileStorageHelper::storeFile($this, $input['value'], true)
+                    );
                     break;
-                case InputType::boolean()->value:
-                case InputType::text()->value:
-                case InputType::number()->value:
-                case InputType::string()->value:
-                case InputType::videoVimeo()->value:
+                case InputType::string->value:
                     break;
-                case InputType::url()->value:
-                    ToolboxHelper::assertNoInternalBoUrls('content', $input['value']);
+                case InputType::text->value:
                     break;
                 default:
                     throw new \ErrorException(sprintf(
                         'Unknown input Type %s',
                         $input['inputType']->label ?? $input['inputType']['label']
                     ));
-            }
+            } //end switch
         } //end foreach
-        return json_encode($data);
+        return $data;
     }
 }

app/Traits/Requests/HasPicture.php

@@ -2,23 +2,80 @@
 
 namespace App\Traits\Requests;
 
-use Illuminate\Http\UploadedFile;
-use Illuminate\Support\Facades\File;
+use App\Lib\Helpers\ToolboxHelper;
 
+/**
+ * ! This assumes file system is using local storage
+ */
 trait HasPicture
 {
     /**
-     * Images rules
+     * Minimum width
      *
+     * @var integer
+     */
+    private $minWidth = 400;
+
+    /**
+     * Maximum width
+     *
+     * @var integer
+     */
+    private $maxWidth = 1800;
+
+    /**
+     * Minimum height
+     *
+     * @var integer
+     */
+    private $minHeight = 300;
+
+    /**
+     * Maximum height
+     *
+     * @var integer
+     */
+    private $maxHeight = 1800;
+
+    /**
+     * Image rules
+     *
+     * @param string       $name
+     * @param integer|null $minWidth
+     * @param integer|null $minHeight
+     * @param integer|null $maxWidth
+     * @param integer|null $maxHeight
+     * @param boolean      $nullable
+     * @param integer|null $size
+     * @param string|null  $requiredWith
+     * @param string|null  $requiredWithout
      * @return array
      */
-    public function pictureRules(): array
-    {
+    public function pictureRules(
+        string $name = 'picture',
+        ?int $minWidth = null,
+        ?int $minHeight = null,
+        ?int $maxWidth = null,
+        ?int $maxHeight = null,
+        bool $nullable = false,
+        ?int $size = null,
+        ?string $requiredWith = null,
+        ?string $requiredWithout = null,
+    ): array {
+        $dimensions = (object)[
+            'minWidth'   => $minWidth ?? $this->minWidth,
+            'minHeight' => $minHeight ?? $this->minHeight,
+            'maxWidth'   => $maxWidth ?? $this->maxWidth,
+            'maxHeight' => $maxHeight ?? $this->maxHeight
+        ];
         return [
-            'picture' => [
-                'required',
-                function (string $attribute, $value, callable $fail) {
-                    return $this->validatePicture($attribute, $value, $fail);
+            $name => [
+                !$nullable ? 'required' : 'nullable',
+                (strlen($requiredWith)) ? 'required_with:' . $requiredWith : '',
+                (strlen($requiredWithout)) ? 'required_without:' . $requiredWithout : '',
+                ($size) ? 'max:' . $size : '',
+                function (string $attribute, $value, callable $fail) use ($dimensions) {
+                    ToolboxHelper::validatePicture($attribute, $value, $fail, $dimensions);
                 }
             ]
         ];
@@ -27,88 +84,71 @@ trait HasPicture
     /**
      * Images rules
      *
+     * @param string       $name
+     * @param integer|null $minWidth
+     * @param integer|null $minHeight
+     * @param integer|null $maxWidth
+     * @param integer|null $maxHeight
+     * @param integer      $limitMin
+     * @param integer      $limitMax
+     * @param boolean      $nullable
      * @return array
      */
-    public function picturesRules(): array
-    {
+    public function picturesRules(
+        string $name = 'pictures',
+        ?int $minWidth = null,
+        ?int $minHeight = null,
+        ?int $maxWidth = null,
+        ?int $maxHeight = null,
+        int $limitMin = 1,
+        int $limitMax = 5,
+        bool $nullable = false
+    ): array {
+        $sizes = (object)[
+            'minWidth'   => $minWidth ?? $this->minWidth,
+            'minHeight' => $minHeight ?? $this->minHeight,
+            'maxWidth'   => $maxWidth ?? $this->maxWidth,
+            'maxHeight' => $maxHeight ?? $this->maxHeight,
+        ];
         return [
-            'pictures' => 'present|array',
-            'pictureValidate' => 'required_with:pictures|array',
-            'pictureValidate.*' => [
+            $name => [!$nullable ? 'required' : 'nullable', 'array', "between:{$limitMin},{$limitMax}"],
+            "{$name}Validate" => "required_with:{$name}|array",
+            "{$name}Validate.*" => [
                 'required',
-                function (string $attribute, $value, callable $fail) {
-                    return $this->validatePicture($attribute, $value, $fail);
+                function (string $attribute, $value, callable $fail) use ($sizes) {
+                    ToolboxHelper::validatePicture($attribute, $value, $fail, $sizes);
                 }
             ]
         ];
     }
 
-    /**
-     * Validate picture
-     *
-     * @param string   $attribute
-     * @param mixed    $value
-     * @param callback $fail
-     * @return void
-     * @phpcs:disable Generic.CodeAnalysis.UnusedFunctionParameter.FoundBeforeLastUsed
-     */
-    private function validatePicture(string $attribute, $value, callable $fail)
-    {
-        if (!File::exists($value)) {
-            $fail(trans(":attribute n'existe pas dans le système de fichier"));
-            return;
-        }
-        if (!\in_array(File::mimeType($value), ['image/jpeg', 'image/jpg', 'image/png'])) {
-            $fail(trans(":attribute doit être une image de type 'image/jpeg,image/jpg,image/png'"));
-            return;
-        }
-        if (!($dimensions = \getimagesize($value)) or !isset($dimensions[0]) or !isset($dimensions[1])) {
-            $fail(trans(":attribute impossible de valider les dimensions"));
-            return;
-        }
-        $minWith   = 400;
-        $maxWith   = 1800;
-        $minHeight = 300;
-        $maxHeight = 1800;
-        $width     = intval($dimensions[0]);
-        $height    = intval($dimensions[1]);
-        if (($width < $minWith) or ($width > $maxWith)) {
-            $fail(trans(":attribute la largeur doit être comprise entre $minWith et $maxWith"));
-        }
-        if (($height < $minHeight) or ($height > $maxHeight)) {
-            $fail(trans(":attribute la hauteur doit être comprise entre $minHeight et $maxHeight"));
-        }
-    }
-
     /**
      * Merges products pictures fields with request data
      *
+     * @param string $name
      * @return void
      */
-    protected function mergePicture(): void
+    protected function mergePicture(string $name = 'picture'): void
     {
-        $picturePath = $this->picture;
-        if (is_string($picturePath) or (\is_object($picturePath) and $picturePath instanceof UploadedFile)) {
-            $this->merge(['pictureValidate' => []]);
+        $picturePath = $this->{$name};
+        if (is_string($picturePath)) {
+            $this->merge(["{$name}Validate" => []]);
             // ! Empty picture.
             if ($picturePath === 'false') {
                 // * Empty picture and exit
-                $this->merge(['picture' => null]);
+                $this->merge([$name => []]);
                 return;
             }
             $decodedPath = \urldecode($picturePath);
             $this->merge([
-                'pictureValidate' => array_merge(
-                    $this->pictureValidate,
-                    [is_string($picturePath) ? \public_path(ltrim($decodedPath, '/')) : \strval($picturePath)]
+                "{$name}Validate" => array_merge(
+                    $this->{"{$name}Validate"},
+                    [\public_path(ltrim($decodedPath, '/'))]
                 )
             ]);
-            $changedPicture = $this->picture;
-            if (is_string($picturePath)) {
-                $changedPicture = ltrim($decodedPath, '/');
-            }
+            $changedPicture = ltrim($decodedPath, '/');
             $this->merge([
-                'picture' => $changedPicture
+                $name => $changedPicture
             ]);
         } //end if
     }
@@ -116,41 +156,34 @@ trait HasPicture
     /**
      * Merges products pictures fields with request data
      *
+     * @param string $name
      * @return void
      */
-    protected function mergePictures(): void
+    protected function mergePictures(string $name = 'pictures'): void
     {
-        // Allows to empty pictures.
-        $this->merge([
-            'pictures' => $this->pictures ? $this->pictures : []
-        ]);
-        $pictures = $this->pictures;
+        $pictures = $this->{$name};
         if (is_array($pictures)) {
-            $this->merge(['pictureValidate' => []]);
+            $this->merge(["{$name}Validate" => []]);
             foreach ($pictures as $key => $picturePath) {
-                if (is_string($picturePath) or (\is_object($picturePath) and $picturePath instanceof UploadedFile)) {
-                    // ! Empty picture.
-                    if ($picturePath === 'false') {
-                        // * Empty picture and exit
-                        $this->merge(['pictures' => []]);
-                        return;
-                    }
-                    $decodedPath = \urldecode($picturePath);
-                    $this->merge([
-                        'pictureValidate' => array_merge(
-                            $this->pictureValidate,
-                            [is_string($picturePath) ? \public_path(ltrim($decodedPath, '/')) : \strval($picturePath)]
-                        )
-                    ]);
-                    $changedPictures = $this->pictures;
-                    if (is_string($picturePath)) {
-                        $changedPicture[$key] = ltrim($decodedPath, '/');
-                    }
-                    $this->merge([
-                        'pictures' => $changedPictures
-                    ]);
-                } //end if
-            } //end foreach
+                // ! Empty picture.
+                if ($picturePath === 'false') {
+                    // * Empty picture and exit
+                    $this->merge([$name => []]);
+                    return;
+                }
+                $decodedPath = \urldecode($picturePath);
+                $this->merge([
+                    "{$name}Validate" => array_merge(
+                        $this->{"{$name}Validate"},
+                        [\public_path(ltrim($decodedPath, '/'))]
+                    )
+                ]);
+                $changedPicture       = $this->{$name};
+                $changedPicture[$key] = ltrim($decodedPath, '/');
+                $this->merge([
+                    $name => $changedPicture
+                ]);
+            }
         } //end if
     }
 }

composer.json

@@ -1,35 +1,33 @@
 {
-    "name": "laravel/laravel",
+    "name": "uwil/nature-eleveurs",
+    "version": "1.0.0",
     "type": "project",
-    "description": "The Laravel Framework.",
-    "keywords": [
-        "framework",
-        "laravel"
-    ],
-    "license": "MIT",
+    "description": "Nature d'éleveurs website",
     "require": {
-        "php": "^7.3",
+        "php": "^8.5",
+        "24slides/laravel-saml2": "^2.4",
         "diglactic/laravel-breadcrumbs": "^8.0",
-        "fruitcake/laravel-cors": "^2.0",
-        "guzzlehttp/guzzle": "^7.0.1",
-        "kwaadpepper/exception-handler": "^0.0.9",
-        "kwaadpepper/refresh-sitemap": "^1.0",
-        "laravel/framework": "^8.75",
-        "laravel/tinker": "^2.5",
-        "laravel/ui": "^3.4",
-        "ldc/web-admin-secure-laravel": "1.0.1",
-        "ldc/web-status-checker-laravel": "1.0.3",
-        "mews/purifier": "^3.3",
-        "slevomat/coding-standard": "^8.3",
-        "spatie/laravel-mix-preload": "^1.3"
+        "doctrine/dbal": "^3.8",
+        "dxw/cidr": "^3.2",
+        "guzzlehttp/guzzle": "^7.2",
+        "laravel/framework": "^10.0",
+        "laravel/tinker": "^2.8",
+        "laravel/ui": "^4.2",
+        "mews/purifier": "^3.4",
+        "sentry/sentry-laravel": "*",
+        "uwil/k8s-laravel": "^1.2"
     },
     "require-dev": {
-        "facade/ignition": "^2.5",
         "fakerphp/faker": "^1.9.1",
-        "laravel/sail": "^1.0.1",
+        "larastan/larastan": "^2.6",
+        "laravel-lang/common": "^4.0",
+        "laravel/pint": "^1.0",
+        "laravel/sail": "^1.18",
         "mockery/mockery": "^1.4.4",
-        "nunomaduro/collision": "^5.10",
-        "phpunit/phpunit": "^9.5.10"
+        "nunomaduro/collision": "^7.0",
+        "phpunit/phpunit": "^10.0",
+        "slevomat/coding-standard": "^8.10",
+        "spatie/laravel-ignition": "^2.0"
     },
     "autoload": {
         "psr-4": {
@@ -38,6 +36,12 @@
             "Database\\Seeders\\": "database/seeders/"
         }
     },
+    "repositories": [
+        {
+            "type": "composer",
+            "url": "https://lab.s-web.fr/api/v4/group/23/-/packages/composer/packages.json"
+        }
+    ],
     "autoload-dev": {
         "psr-4": {
             "Tests\\": "tests/"
@@ -56,6 +60,12 @@
         ],
         "post-create-project-cmd": [
             "@php artisan key:generate --ansi"
+        ],
+        "phpcs": [
+            "./vendor/bin/phpcs"
+        ],
+        "phpstan": [
+            "./vendor/bin/phpstan analyse"
         ]
     },
     "extra": {
@@ -68,15 +78,14 @@
         "preferred-install": "dist",
         "sort-packages": true,
         "allow-plugins": {
+            "pestphp/pest-plugin": true,
+            "php-http/discovery": true,
             "dealerdirect/phpcodesniffer-composer-installer": true
-        }
+        },
+        "gitlab-domains": [
+            "lab.s-web.fr"
+        ]
     },
-    "minimum-stability": "dev",
-    "prefer-stable": true,
-    "repositories": {
-        "gitlab.com/16669037": {
-            "type": "composer",
-            "url": "https://gitlab.com/api/v4/group/16669037/-/packages/composer/packages.json"
-        }
-    }
+    "minimum-stability": "stable",
+    "prefer-stable": true
 }

config/admin-secure.php

@@ -0,0 +1,6 @@
+<?php
+
+return [
+    'cidrList' => env('UWIL_ADMIN_SECURE_CIDR_LIST'),
+    'cidrProjectAllowedList' => env('UWIL_ADMIN_SECURE_CIDR_PROJECT_ALLOWED_LIST')
+];

config/app.php

@@ -1,5 +1,7 @@
 <?php
 
+use Illuminate\Support\Facades\Facade;
+
 return [
 
     /*
@@ -54,7 +56,7 @@ return [
 
     'url' => env('APP_URL', 'http://localhost'),
 
-    'asset_url' => env('ASSET_URL', null),
+    'asset_url' => env('ASSET_URL'),
 
     /*
         |--------------------------------------------------------------------------
@@ -67,7 +69,7 @@ return [
         |
     */
 
-    'timezone' => 'UTC',
+    'timezone' => 'Europe/Paris',
 
     /*
         |--------------------------------------------------------------------------
@@ -93,7 +95,7 @@ return [
         |
     */
 
-    'fallback_locale' => 'en',
+    'fallback_locale' => 'fr',
 
     /*
         |--------------------------------------------------------------------------
@@ -123,6 +125,23 @@ return [
 
     'cipher' => 'AES-256-CBC',
 
+    /*
+        |--------------------------------------------------------------------------
+        | Maintenance Mode Driver
+        |--------------------------------------------------------------------------
+        |
+        | These configuration options determine the driver used to determine and
+        | manage Laravel's "maintenance mode" status. The "cache" driver will
+        | allow maintenance mode to be controlled across multiple machines.
+        |
+        | Supported drivers: "file", "cache"
+        |
+    */
+
+    'maintenance' => [
+        'driver' => 'file'
+    ],
+
     /*
         |--------------------------------------------------------------------------
         | Autoloaded Service Providers
@@ -173,11 +192,10 @@ return [
 
         App\Providers\AppServiceProvider::class,
         App\Providers\AuthServiceProvider::class,
-        // phpcs:ignore
-        // App\Providers\BroadcastServiceProvider::class,
         App\Providers\EventServiceProvider::class,
         App\Providers\RouteServiceProvider::class,
-
+        App\Providers\TranslationServiceProvider::class,
+        App\Providers\ViewServiceProvider::class,
     ],
 
     /*
@@ -191,49 +209,8 @@ return [
         |
     */
 
-    'aliases' => [
-
-        'App' => Illuminate\Support\Facades\App::class,
-        'Arr' => Illuminate\Support\Arr::class,
-        'Artisan' => Illuminate\Support\Facades\Artisan::class,
-        'Auth' => Illuminate\Support\Facades\Auth::class,
-        'Blade' => Illuminate\Support\Facades\Blade::class,
-        'Broadcast' => Illuminate\Support\Facades\Broadcast::class,
-        'Bus' => Illuminate\Support\Facades\Bus::class,
-        'Cache' => Illuminate\Support\Facades\Cache::class,
-        'Config' => Illuminate\Support\Facades\Config::class,
-        'Cookie' => Illuminate\Support\Facades\Cookie::class,
-        'Crypt' => Illuminate\Support\Facades\Crypt::class,
-        'Date' => Illuminate\Support\Facades\Date::class,
-        'DB' => Illuminate\Support\Facades\DB::class,
-        'Eloquent' => Illuminate\Database\Eloquent\Model::class,
-        'Event' => Illuminate\Support\Facades\Event::class,
-        'File' => Illuminate\Support\Facades\File::class,
-        'Gate' => Illuminate\Support\Facades\Gate::class,
-        'Hash' => Illuminate\Support\Facades\Hash::class,
-        'Http' => Illuminate\Support\Facades\Http::class,
-        'Js' => Illuminate\Support\Js::class,
-        'Lang' => Illuminate\Support\Facades\Lang::class,
-        'Log' => Illuminate\Support\Facades\Log::class,
-        'Mail' => Illuminate\Support\Facades\Mail::class,
-        'Notification' => Illuminate\Support\Facades\Notification::class,
-        'Password' => Illuminate\Support\Facades\Password::class,
-        'Queue' => Illuminate\Support\Facades\Queue::class,
-        'RateLimiter' => Illuminate\Support\Facades\RateLimiter::class,
-        'Redirect' => Illuminate\Support\Facades\Redirect::class,
-        // phpcs:ignore
-        // 'Redis' => Illuminate\Support\Facades\Redis::class,
-        'Request' => Illuminate\Support\Facades\Request::class,
-        'Response' => Illuminate\Support\Facades\Response::class,
-        'Route' => Illuminate\Support\Facades\Route::class,
-        'Schema' => Illuminate\Support\Facades\Schema::class,
-        'Session' => Illuminate\Support\Facades\Session::class,
-        'Storage' => Illuminate\Support\Facades\Storage::class,
-        'Str' => Illuminate\Support\Str::class,
-        'URL' => Illuminate\Support\Facades\URL::class,
-        'Validator' => Illuminate\Support\Facades\Validator::class,
-        'View' => Illuminate\Support\Facades\View::class,
-
-    ],
+    'aliases' => Facade::defaultAliases()->merge([
+        'Carbon' => \Illuminate\Support\Carbon::class,
+    ])->toArray(),
 
 ];

config/auth.php

@@ -14,7 +14,7 @@ return [
     */
 
     'defaults' => [
-        'guard' => 'backend',
+        'guard' => 'frontend',
         'passwords' => 'users',
     ],
 
@@ -40,6 +40,12 @@ return [
             'driver' => 'session',
             'provider' => 'users',
         ],
+
+        'frontend' => [
+            'driver' => 'session',
+            // ! Remplacer "users" par le model authenticable voulu
+            'provider' => 'users',
+        ],
     ],
 
     /*
@@ -62,7 +68,7 @@ return [
     'providers' => [
         'users' => [
             'driver' => 'eloquent',
-            'model' => App\Models\User::class,
+            'model' => \App\Models\User::class,
         ],
     ],
 
@@ -75,16 +81,20 @@ return [
         | than one user table or model in the application and you want to have
         | separate password reset settings based on the specific user types.
         |
-        | The expire time is the number of minutes that each reset token will be
+        | The expiry time is the number of minutes that each reset token will be
         | considered valid. This security feature keeps tokens short-lived so
         | they have less time to be guessed. You may change this as needed.
         |
+        | The throttle setting is the number of seconds a user must wait before
+        | generating more password reset tokens. This prevents the user from
+        | quickly generating a very large amount of password reset tokens.
+        |
     */
 
     'passwords' => [
         'users' => [
             'provider' => 'users',
-            'table' => 'password_resets',
+            'table' => 'password_reset_tokens',
             'expire' => 60,
             'throttle' => 60,
         ],

config/breadcrumbs.php

@@ -0,0 +1,78 @@
+<?php
+
+return [
+
+    /*
+        |--------------------------------------------------------------------------
+        | View Name
+        |--------------------------------------------------------------------------
+        |
+        | Choose a view to display when Breadcrumbs::render() is called.
+        | Built in templates are:
+        |
+        | - 'breadcrumbs::bootstrap5'  - Bootstrap 5
+        | - 'breadcrumbs::bootstrap4'  - Bootstrap 4
+        | - 'breadcrumbs::bulma'       - Bulma
+        | - 'breadcrumbs::foundation6' - Foundation 6
+        | - 'breadcrumbs::json-ld'     - JSON-LD Structured Data
+        | - 'breadcrumbs::materialize' - Materialize
+        | - 'breadcrumbs::tailwind'    - Tailwind CSS
+        | - 'breadcrumbs::uikit'       - UIkit
+        |
+        | Or a custom view, e.g. '_partials/breadcrumbs'.
+        |
+    */
+
+    'view' => 'modules/breadcrumbs/breadcrumb-layout',
+
+    /*
+        |--------------------------------------------------------------------------
+        | Breadcrumbs File(s)
+        |--------------------------------------------------------------------------
+        |
+        | The file(s) where breadcrumbs are defined. e.g.
+        |
+        | - base_path('routes/breadcrumbs.php')
+        | - glob(base_path('breadcrumbs/*.php'))
+        |
+    */
+
+    'files' => [
+        base_path('routes/breadcrumbs-bo.php'),
+        base_path('routes/breadcrumbs-fo.php'),
+    ],
+
+    /*
+        |--------------------------------------------------------------------------
+        | Exceptions
+        |--------------------------------------------------------------------------
+        |
+        | Determine when to throw an exception.
+        |
+    */
+
+    // * When route-bound breadcrumbs are used but the current route doesn't have a name (UnnamedRouteException)
+    'unnamed-route-exception' => true,
+
+    // * When route-bound breadcrumbs are used and the matching breadcrumb doesn't exist (InvalidBreadcrumbException)
+    'missing-route-bound-breadcrumb-exception' => true,
+
+    // * When a named breadcrumb is used but doesn't exist (InvalidBreadcrumbException)
+    'invalid-named-breadcrumb-exception' => true,
+
+    /*
+        |--------------------------------------------------------------------------
+        | Classes
+        |--------------------------------------------------------------------------
+        |
+        | Subclass the default classes for more advanced customisations.
+        |
+    */
+
+    // * Manager
+    'manager-class' => Diglactic\Breadcrumbs\Manager::class,
+
+    // * Generator
+    'generator-class' => Diglactic\Breadcrumbs\Generator::class,
+
+];

config/broadcasting.php

@@ -36,8 +36,14 @@ return [
             'secret' => env('PUSHER_APP_SECRET'),
             'app_id' => env('PUSHER_APP_ID'),
             'options' => [
-                'cluster' => env('PUSHER_APP_CLUSTER'),
-                'useTLS' => true,
+                'host' => env('PUSHER_HOST') ?: 'api-' . env('PUSHER_APP_CLUSTER', 'mt1') . '.pusher.com',
+                'port' => env('PUSHER_PORT', 443),
+                'scheme' => env('PUSHER_SCHEME', 'https'),
+                'encrypted' => true,
+                'useTLS' => env('PUSHER_SCHEME', 'https') === 'https',
+            ],
+            'client_options' => [
+                // Guzzle client options: https://docs.guzzlephp.org/en/stable/request-options.html .
             ],
         ],
 

config/cache.php

@@ -62,8 +62,7 @@ return [
                 env('MEMCACHED_PASSWORD'),
             ],
             'options' => [
-                // phpcs:ignore
-                // Memcached::OPT_CONNECT_TIMEOUT => 2000,
+                // Memcached::OPT_CONNECT_TIMEOUT => 2000, .
             ],
             'servers' => [
                 [
@@ -100,12 +99,12 @@ return [
         | Cache Key Prefix
         |--------------------------------------------------------------------------
         |
-        | When utilizing a RAM based store such as APC or Memcached, there might
-        | be other applications utilizing the same cache. So, we'll specify a
-        | value to get prefixed to all our keys so we can avoid collisions.
+        | When utilizing the APC, database, memcached, Redis, or DynamoDB cache
+        | stores there might be other applications using the same cache. For
+        | that reason, you may prefix every cache key to avoid collisions.
         |
     */
 
-    'prefix' => env('CACHE_PREFIX', Str::slug(env('APP_NAME', 'laravel'), '_') . '_cache'),
+    'prefix' => env('CACHE_PREFIX', Str::slug(env('APP_NAME', 'laravel'), '_') . '_cache_'),
 
 ];

config/cors.php

@@ -15,7 +15,7 @@ return [
         |
     */
 
-    'paths' => ['api/*', 'sanctum/csrf-cookie'],
+    'paths' => ['api/*'],
 
     'allowed_methods' => ['*'],
 

config/database.php

@@ -74,7 +74,7 @@ return [
             'charset' => 'utf8',
             'prefix' => '',
             'prefix_indexes' => true,
-            'schema' => 'public',
+            'search_path' => 'public',
             'sslmode' => 'prefer',
         ],
 
@@ -129,7 +129,8 @@ return [
         'default' => [
             'url' => env('REDIS_URL'),
             'host' => env('REDIS_HOST', '127.0.0.1'),
-            'password' => env('REDIS_PASSWORD', null),
+            'username' => env('REDIS_USERNAME'),
+            'password' => env('REDIS_PASSWORD'),
             'port' => env('REDIS_PORT', '6379'),
             'database' => env('REDIS_DB', '0'),
         ],
@@ -137,7 +138,8 @@ return [
         'cache' => [
             'url' => env('REDIS_URL'),
             'host' => env('REDIS_HOST', '127.0.0.1'),
-            'password' => env('REDIS_PASSWORD', null),
+            'username' => env('REDIS_USERNAME'),
+            'password' => env('REDIS_PASSWORD'),
             'port' => env('REDIS_PORT', '6379'),
             'database' => env('REDIS_CACHE_DB', '1'),
         ],

config/exception-handler.php

@@ -1,15 +0,0 @@
-<?php
-
-return [
-    /**
-     * Send mail when app debug is turn off
-     * so you can be warned if an unhandled exception occurs
-     */
-    'enableMaiLog' => !config('app.debug'),
-
-    /**
-     * Put a developper secured mailbox in here
-     * so you can receive email if things go mad
-     */
-    'contactsList' => explode(",", env('MAIL_LIST_SERVICEWEB'))
-];

config/filesystems.php

@@ -13,7 +13,7 @@ return [
         |
     */
 
-    'default' => env('FILESYSTEM_DRIVER', 'local'),
+    'default' => env('FILESYSTEM_DISK', 'local'),
 
     /*
         |--------------------------------------------------------------------------
@@ -22,7 +22,7 @@ return [
         |
         | Here you may configure as many filesystem "disks" as you wish, and you
         | may even configure multiple disks of the same driver. Defaults have
-        | been setup for each driver as an example of the required options.
+        | been set up for each driver as an example of the required values.
         |
         | Supported Drivers: "local", "ftp", "sftp", "s3"
         |
@@ -33,6 +33,7 @@ return [
         'local' => [
             'driver' => 'local',
             'root' => storage_path('app'),
+            'throw' => false,
         ],
 
         'public' => [
@@ -40,6 +41,14 @@ return [
             'root' => storage_path('app/public'),
             'url' => env('APP_URL') . '/storage',
             'visibility' => 'public',
+            'throw' => false,
+        ],
+
+        'private' => [
+            'driver' => 'local',
+            'root' => storage_path('app/private'),
+            'visibility' => 'private',
+            'throw' => false,
         ],
 
         's3' => [
@@ -51,6 +60,7 @@ return [
             'url' => env('AWS_URL'),
             'endpoint' => env('AWS_ENDPOINT'),
             'use_path_style_endpoint' => env('AWS_USE_PATH_STYLE_ENDPOINT', false),
+            'throw' => false,
         ],
 
     ],

config/hashing.php

@@ -29,7 +29,7 @@ return [
     */
 
     'bcrypt' => [
-        'rounds' => env('BCRYPT_ROUNDS', 10),
+        'rounds' => env('BCRYPT_ROUNDS', 12),
     ],
 
     /*

config/logging.php

@@ -3,6 +3,7 @@
 use Monolog\Handler\NullHandler;
 use Monolog\Handler\StreamHandler;
 use Monolog\Handler\SyslogUdpHandler;
+use Monolog\Processor\PsrLogMessageProcessor;
 
 return [
 
@@ -30,7 +31,10 @@ return [
         |
     */
 
-    'deprecations' => env('LOG_DEPRECATIONS_CHANNEL', 'null'),
+    'deprecations' => [
+        'channel' => env('LOG_DEPRECATIONS_CHANNEL', 'null'),
+        'trace' => false,
+    ],
 
     /*
         |--------------------------------------------------------------------------
@@ -58,6 +62,7 @@ return [
             'driver' => 'single',
             'path' => storage_path('logs/laravel.log'),
             'level' => env('LOG_LEVEL', 'debug'),
+            'replace_placeholders' => true,
         ],
 
         'daily' => [
@@ -65,6 +70,7 @@ return [
             'path' => storage_path('logs/laravel.log'),
             'level' => env('LOG_LEVEL', 'debug'),
             'days' => 14,
+            'replace_placeholders' => true,
         ],
 
         'slack' => [
@@ -73,16 +79,19 @@ return [
             'username' => 'Laravel Log',
             'emoji' => ':boom:',
             'level' => env('LOG_LEVEL', 'critical'),
+            'replace_placeholders' => true,
         ],
 
         'papertrail' => [
             'driver' => 'monolog',
             'level' => env('LOG_LEVEL', 'debug'),
-            'handler' => SyslogUdpHandler::class,
+            'handler' => env('LOG_PAPERTRAIL_HANDLER', SyslogUdpHandler::class),
             'handler_with' => [
                 'host' => env('PAPERTRAIL_URL'),
                 'port' => env('PAPERTRAIL_PORT'),
+                'connectionString' => 'tls://' . env('PAPERTRAIL_URL') . ':' . env('PAPERTRAIL_PORT'),
             ],
+            'processors' => [PsrLogMessageProcessor::class],
         ],
 
         'stderr' => [
@@ -93,16 +102,20 @@ return [
             'with' => [
                 'stream' => 'php://stderr',
             ],
+            'processors' => [PsrLogMessageProcessor::class],
         ],
 
         'syslog' => [
             'driver' => 'syslog',
             'level' => env('LOG_LEVEL', 'debug'),
+            'facility' => LOG_USER,
+            'replace_placeholders' => true,
         ],
 
         'errorlog' => [
             'driver' => 'errorlog',
             'level' => env('LOG_LEVEL', 'debug'),
+            'replace_placeholders' => true,
         ],
 
         'null' => [
@@ -113,6 +126,23 @@ return [
         'emergency' => [
             'path' => storage_path('logs/laravel.log'),
         ],
+
+        'stdout' => [
+            'driver' => 'monolog',
+            'level' => env('LOG_LEVEL', 'debug'),
+            'handler' => StreamHandler::class,
+            'formatter' => env('LOG_STDOUT_FORMATTER'),
+            'with' => [
+                'stream' => 'php://stdout',
+            ],
+        ],
+
+        'k8s' => [
+            'driver' => 'stack',
+            'channels' => ['daily', 'stdout'],
+            'ignore_exceptions' => false,
+        ],
+
     ],
 
 ];