Init laravel 10

.browserslistrc

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

.editorconfig

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

.env.example

@@ -0,0 +1,61 @@
+APP_NAME=Laravel
+APP_ENV=local
+APP_KEY=
+APP_DEBUG=true
+APP_URL=http://localhost
+
+LOG_CHANNEL=stack
+LOG_DEPRECATIONS_CHANNEL=null
+LOG_LEVEL=debug
+
+DB_CONNECTION=mysql
+DB_HOST=127.0.0.1
+DB_PORT=3306
+DB_DATABASE=laravel
+DB_USERNAME=root
+DB_PASSWORD=
+
+BROADCAST_DRIVER=log
+CACHE_DRIVER=file
+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=mailpit
+MAIL_PORT=1025
+MAIL_USERNAME=null
+MAIL_PASSWORD=null
+MAIL_ENCRYPTION=null
+MAIL_FROM_ADDRESS="hello@example.com"
+MAIL_FROM_NAME="${APP_NAME}"
+
+AWS_ACCESS_KEY_ID=
+AWS_SECRET_ACCESS_KEY=
+AWS_DEFAULT_REGION=us-east-1
+AWS_BUCKET=
+AWS_USE_PATH_STYLE_ENDPOINT=false
+
+PUSHER_APP_ID=
+PUSHER_APP_KEY=
+PUSHER_APP_SECRET=
+PUSHER_HOST=
+PUSHER_PORT=443
+PUSHER_SCHEME=https
+PUSHER_APP_CLUSTER=mt1
+
+VITE_PUSHER_APP_KEY="${PUSHER_APP_KEY}"
+VITE_PUSHER_HOST="${PUSHER_HOST}"
+VITE_PUSHER_PORT="${PUSHER_PORT}"
+VITE_PUSHER_SCHEME="${PUSHER_SCHEME}"
+VITE_PUSHER_APP_CLUSTER="${PUSHER_APP_CLUSTER}"
+
+# Sentry
+SENTRY_LARAVEL_DSN=

.eslintrc.json

@@ -0,0 +1,55 @@
+{
+    "env": {
+        "browser": true,
+        "es2021": true
+    },
+    "extends": [
+        "eslint:recommended",
+        "plugin:vue/vue3-strongly-recommended",
+        "@vue/eslint-config-typescript"
+    ],
+    "overrides": [
+        {
+            "files": ["*.ts", "*.vue"],
+            "rules": {
+                "no-undef": "off"
+            }
+        },
+        {
+            "files": ["*.vue"],
+            "rules": {
+                "indent": "off"
+            }
+        }
+    ],
+    "parser": "vue-eslint-parser",
+    "parserOptions": {
+        "parser": "@typescript-eslint/parser",
+        "ecmaVersion": "latest",
+        "sourceType": "module"
+    },
+    "plugins": ["vue", "@typescript-eslint"],
+    "ignorePatterns": ["webpack.mix.js", "**/vendor/*.js", "**/vendor/**/*.js"],
+    "rules": {
+        "indent": ["error", 4, { "SwitchCase": 1 }],
+        "linebreak-style": ["error", "unix"],
+        "quotes": ["error", "double"],
+        "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

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

.gitignore

@@ -0,0 +1,25 @@
+.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
+.npmrc

.gitlab-ci.yml

@@ -0,0 +1,24 @@
+include:
+  - project: 'ldc-web/shared-ci'
+    ref: 'main'
+    file: 'lint/lint.yml'
+  - project: 'ldc-web/shared-ci'
+    ref: 'main'
+    file: 'security/security.yml'
+  - project: 'ldc-web/shared-ci'
+    ref: 'main'
+    file: 'build/build.yml'
+  - project: 'ldc-web/shared-ci'
+    ref: 'main'
+    file: 'test/test.yml'
+  - project: 'ldc-web/shared-ci'
+    ref: 'main'
+    file: 'deploy/deploy.yml'
+
+
+stages:
+    - lint
+    - security
+    - build
+    - test
+    - deploy

.stylelintrc.json

@@ -0,0 +1,45 @@
+{
+    "extends": [
+        "stylelint-config-standard-scss",
+        "stylelint-config-sass-guidelines",
+        "stylelint-config-idiomatic-order"
+    ],
+    "plugins": [
+        "stylelint-scss"
+    ],
+    "files": [
+        "**/*.css",
+        "**/*.scss"
+    ],
+    "ignoreFiles": [
+        "**/vendor/*.css",
+        "**/vendor/**/*.css",
+        "**/vendor/*.scss",
+        "**/vendor/**/*.scss",
+        "**/vendor/*.sass",
+        "**/vendor/**/*.sass",
+        "**/vendor/*.less",
+        "**/vendor/**/*.less"
+    ],
+    "customSyntax": "postcss-scss",
+    "rules": {
+        "declaration-property-value-no-unknown": true,
+        "selector-max-id": null,
+        "color-no-invalid-hex": true,
+        "order/properties-alphabetical-order": null,
+        "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"
+                ]
+            }
+        ]
+    }
+}

README.md

@@ -0,0 +1,66 @@
+<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>
+
+<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>
+
+## About Laravel
+
+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:
+
+- [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/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,231 @@
+<?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;
+
+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
+     */
+    protected $first_name;
+
+    /**
+     * The last name of the new user.
+     *
+     * @var string
+     */
+    protected $last_name;
+
+    /**
+     * The email of the new user.
+     *
+     * @var string
+     */
+    protected $email;
+
+    /**
+     * The password of the new user.
+     *
+     * @var string
+     */
+    protected $password;
+
+    /**
+     * The role of the new user.
+     *
+     * @var string
+     */
+    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->password = null;
+        $this->addPassword();
+
+        $this->role = null;
+        $this->addRole();
+
+        $user = new User([
+            'first_name' => $this->first_name,
+            'last_name' => $this->last_name,
+            'email' => $this->email,
+            'password' => $this->password,
+            '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 password to the user.
+     *
+     * @return void
+     */
+    private function addPassword(): void
+    {
+        while (
+            ($this->password = $this->secret(
+                (!\is_null($this->password) ? 'Failed to confirm, ' : '') . 'Type the wanted user password'
+            )) !== $this->secret('Confirm the password')
+        ) {
+            continue;
+        }; //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',
+                    [RoleEnum::conceptor->name, RoleEnum::admin->name, RoleEnum::visitor->name],
+                    RoleEnum::visitor->name,
+                    $maxAttempts             = null,
+                    $allowMultipleSelections = false
+                );
+                if ($tmp === RoleEnum::conceptor->name) {
+                    $tmp = RoleEnum::conceptor;
+                }
+                if ($tmp === RoleEnum::admin->name) {
+                    $tmp = RoleEnum::admin;
+                }
+                if ($tmp === RoleEnum::visitor->name) {
+                    $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',
+                    \implode(',', collect($e->errors())->flatten()->all())
+                ));
+                continue;
+            } //end try
+        }; //end while
+    }
+}

app/Console/Kernel.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace App\Console;
+
+use Illuminate\Console\Scheduling\Schedule;
+use Illuminate\Foundation\Console\Kernel as ConsoleKernel;
+
+class Kernel extends ConsoleKernel
+{
+    /**
+     * Define the application's command schedule.
+     *
+     * @param  \Illuminate\Console\Scheduling\Schedule $schedule
+     * @return void
+     */
+    protected function schedule(Schedule $schedule)
+    {
+    }
+
+    /**
+     * Register the commands for the application.
+     *
+     * @return void
+     */
+    protected function commands()
+    {
+        $this->load(__DIR__ . '/Commands');
+
+        require base_path('routes/console.php');
+    }
+}

app/Enums/ActivityLogs/ActivityLogsEventEnum.php

@@ -0,0 +1,46 @@
+<?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
+     */
+    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,623 @@
+<?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
+     */
+    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/InputType.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace App\Enums;
+
+use App\Traits\Enums\BaseEnum;
+
+enum InputType: int
+{
+    use BaseEnum;
+
+    case boolean       = 1;
+    case dropdownArray = 2;
+    case email         = 3;
+    case image         = 4;
+    case imageArray    = 5;
+    case labelArray    = 6;
+    case miniblocArray = 7;
+    case number        = 8;
+    case selectEnum    = 9;
+    case password      = 10;
+    case string        = 11;
+    case text          = 12;
+    case url           = 13;
+    /** Vimeo only */
+    case videoVimeo = 14;
+    /** Youtube only */
+    case videoYoutube = 15;
+    /** Youtube or Vimeo. */
+    case video = 16;
+}

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/Theme/BootstrapThemeEnum.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace App\Enums\Theme;
+
+use App\Traits\Enums\BaseEnum;
+
+enum BootstrapThemeEnum: int
+{
+    use BaseEnum;
+
+    case light = 1;
+    case dark  = 2;
+
+    /**
+     * Optionnal labels definition
+     */
+    private const LABELS = [
+        self::light->name => 'Light',
+        self::dark->name  => 'Dark',
+    ];
+}

app/Enums/Users/RoleEnum.php

@@ -0,0 +1,23 @@
+<?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.
+     */
+    private const LABELS = [
+        self::conceptor->name => 'Concepteur',
+        self::admin->name     => 'Administrateur',
+        self::visitor->name   => 'Visiteur',
+    ];
+}

app/Exceptions/Handler.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace App\Exceptions;
+
+use Illuminate\Foundation\Exceptions\Handler as ExceptionHandler;
+use Throwable;
+
+class Handler extends ExceptionHandler
+{
+    /**
+     * A list of exception types with their corresponding custom log levels.
+     *
+     * @var array<class-string<\Throwable>, \Psr\Log\LogLevel::*>
+     */
+    protected $levels = [];
+
+    /**
+     * 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>
+     */
+    protected $dontFlash = [
+        'current_password',
+        'password',
+        'password_confirmation',
+    ];
+
+    /**
+     * Register the exception handling callbacks for the application.
+     *
+     * @return void
+     */
+    public function register()
+    {
+        $this->reportable(function (Throwable $e) {
+            if (app()->bound('sentry')) {
+                app('sentry')->captureException($e);
+            }
+        });
+    }
+}

app/Http/Controllers/Bo/ActivityLogsController.php

@@ -0,0 +1,71 @@
+<?php
+
+namespace App\Http\Controllers\Bo;
+
+use App\Http\Controllers\Controller;
+use App\Models\ActivityLog;
+use App\Traits\Controllers\ChangesModelOrder;
+use App\Traits\Controllers\UpdateModelPublished;
+use Illuminate\Http\Request;
+
+class ActivityLogsController extends Controller
+{
+    use ChangesModelOrder;
+    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 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'));
+    }
+
+    /**
+     * 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

@@ -0,0 +1,72 @@
+<?php
+
+namespace App\Http\Controllers\Bo\Auth;
+
+use App\Http\Controllers\Controller;
+use Illuminate\Contracts\Auth\StatefulGuard;
+use Illuminate\Contracts\View\View;
+use Illuminate\Foundation\Auth\AuthenticatesUsers;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Auth;
+
+class LoginController extends Controller
+{
+    use AuthenticatesUsers;
+
+    /**
+     * Create a new controller instance.
+     *
+     * @return void
+     */
+    public function __construct()
+    {
+        $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\Contracts\View\View
+     */
+    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.
+     *
+     * @param \Illuminate\Http\Request $request
+     * @return boolean
+     */
+    protected function attemptLogin(Request $request)
+    {
+        $credentials = $this->credentials($request);
+        // * Attempt login only using published users.
+        $credentials['published'] = true;
+        return $this->guard()->attempt(
+            $credentials,
+            $request->boolean('remember')
+        );
+    }
+}

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/UsersController.php

@@ -0,0 +1,169 @@
+<?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 UsersController 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

@@ -0,0 +1,231 @@
+<?php
+
+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\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 ValidatesRequests;
+
+    /**
+     * Build Search query on specified fields
+     * splitting search into words or using whole sentence
+     *
+     * @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
+    ): \Illuminate\Database\Eloquent\Builder {
+        if (count($fields)) {
+            // Search using words.
+            $words = explode(' ', $search);
+            $query->where(function ($query) use ($searchQuery, $words, $search, $fields) {
+                foreach ($words as $word) {
+                    if (!strlen($word)) {
+                        continue;
+                    }
+                    $this->searchOnFields($query, $word, $fields);
+                } //end foreach
+                // Search whole using whole sentence.
+                $this->searchOnFields($query, $search, $fields);
+                if ($searchQuery) {
+                    $searchQuery($query);
+                }
+            });
+        } //end if
+        return $query;
+    }
+
+    /**
+     * Build query search on all fields
+     *
+     * @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
+    ): \Illuminate\Database\Eloquent\Builder {
+        $table = $query->getModel()->getTable();
+        foreach ($fields as $field) {
+            $field = str_replace('?', '\?', $field);
+            if (is_array($field)) {
+                $query->orWhereRaw(
+                    sprintf("UPPER(CONCAT(%s)) LIKE UPPER(?)", collect($field)->map(function ($q) use ($table) {
+                        return "`$table`.`$q`";
+                    })->implode(', \' \', ')),
+                    ['%' . 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->getModel()->has(Str::remove('_id', $field))) {
+                $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;
+    }
+
+    /**
+     * Get the search value (on string or Enum).
+     *
+     * @param \Illuminate\Database\Eloquent\Builder $query
+     * @param string                                $search
+     * @param string                                $field
+     * @return string|array
+     */
+    protected function getSearchValue(Builder $query, string $search, string $field): string|array
+    {
+        if (
+            count($query->getModel()->getCasts()) and // Check if the model has casts.
+            isset($query->getModel()->getCasts()[$field]) and // Check if there is cast about specific field.
+            enum_exists($query->getModel()->getCasts()[$field]) // Check if the cast is an enum.
+        ) {
+            $cases = collect($query->getModel()->getCasts()[$field]::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);
+            Session::put("$rName.sorted", true);
+        }
+        if (request()->sort_way) {
+            Session::put("$rName.sort_way", request()->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);
+            }
+        } 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,18 @@
+<?php
+
+namespace App\Http\Controllers\Fo;
+
+use App\Http\Controllers\Controller;
+
+class HomeController extends Controller
+{
+    /**
+     * Display a listing of the resource.
+     *
+     * @return \Illuminate\Contracts\View\View
+     */
+    public function index(): \Illuminate\Contracts\View\View
+    {
+        return view('fo.pages.home');
+    }
+}

app/Http/Kernel.php

@@ -0,0 +1,69 @@
+<?php
+
+namespace App\Http;
+
+use Illuminate\Foundation\Http\Kernel as HttpKernel;
+
+class Kernel extends HttpKernel
+{
+    /**
+     * The application's global HTTP middleware stack.
+     *
+     * These middleware are run during every request to your application.
+     *
+     * @var array<int, class-string|string>
+     */
+    protected $middleware = [
+        \App\Http\Middleware\TrustHosts::class,
+        \App\Http\Middleware\TrustProxies::class,
+        \Illuminate\Http\Middleware\HandleCors::class,
+        \App\Http\Middleware\PreventRequestsDuringMaintenance::class,
+        \Illuminate\Foundation\Http\Middleware\ValidatePostSize::class,
+        \App\Http\Middleware\TrimStrings::class,
+        \Illuminate\Foundation\Http\Middleware\ConvertEmptyStringsToNull::class,
+    ];
+
+    /**
+     * The application's route middleware groups.
+     *
+     * @var array<string, array<int, class-string|string>>
+     */
+    protected $middlewareGroups = [
+        'web' => [
+            'htmlsanitize',
+            \App\Http\Middleware\EncryptCookies::class,
+            \Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class,
+            \Illuminate\Session\Middleware\StartSession::class,
+            \Illuminate\View\Middleware\ShareErrorsFromSession::class,
+            \App\Http\Middleware\VerifyCsrfToken::class,
+            \Illuminate\Routing\Middleware\SubstituteBindings::class,
+            \App\Http\Middleware\SecureHeaders::class
+        ],
+
+        'api' => [
+            \Illuminate\Routing\Middleware\ThrottleRequests::class . ':api',
+            \Illuminate\Routing\Middleware\SubstituteBindings::class,
+        ],
+    ];
+
+    /**
+     * The application's route middleware.
+     *
+     * These middleware may be assigned to groups or used individually.
+     *
+     * @var array<string, class-string|string>
+     */
+    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' => \App\Http\Middleware\ValidateSignature::class,
+        'throttle' => \Illuminate\Routing\Middleware\ThrottleRequests::class,
+        'verified' => \Illuminate\Auth\Middleware\EnsureEmailIsVerified::class,
+        'htmlsanitize' => \App\Http\Middleware\HtmlSanitizer::class,
+    ];
+}

app/Http/Middleware/Authenticate.php

@@ -0,0 +1,39 @@
+<?php
+
+namespace App\Http\Middleware;
+
+use Illuminate\Auth\Middleware\Authenticate as Middleware;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Session;
+
+class Authenticate extends Middleware
+{
+    /**
+     * Get the path the user should be redirected to when they are not authenticated.
+     *
+     * @param  \Illuminate\Http\Request $request
+     * @return string|null
+     */
+    protected function redirectTo(Request $request): ?string
+    {
+        $logins = [
+            'backend' => route('bo.login')
+        ];
+        if (!$request->expectsJson()) {
+            // * Notify must login
+            Session::flash('warning', trans('Veuillez vous connecter pour continuer'));
+
+            foreach ($request->route()->gatherMiddleware() as $middleware) {
+                if (\is_string($middleware) and strpos($middleware, 'auth:') !== false) {
+                    $route = $logins[str_replace('auth:', '', $middleware)] ?? null;
+                    if ($route) {
+                        return $route;
+                    }
+                }
+            }
+            return route('login');
+        }
+
+        return null;
+    }
+}

app/Http/Middleware/EncryptCookies.php

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

app/Http/Middleware/HtmlSanitizer.php

@@ -0,0 +1,61 @@
+<?php
+
+namespace App\Http\Middleware;
+
+use App\Lib\Helpers\ToolboxHelper;
+use Illuminate\Http\Request;
+use Symfony\Component\HttpFoundation\Response;
+
+class HtmlSanitizer
+{
+    /**
+     * Handle an incoming request.
+     *
+     * @param  \Illuminate\Http\Request $request
+     * @param  \Closure                 $next
+     * @param  string|array             ...$params
+     * @return \Symfony\Component\HttpFoundation\Response
+     */
+    public function handle(Request $request, \Closure $next, string|array ...$params): Response
+    {
+        $inputs = $request->all();
+        /** @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) 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 (string|array &$item) {
+                        if (\is_string($item)) {
+                            $item = clean($item);
+                            $item = ToolboxHelper::stripCkEditorSchemesOnMediaInputs($item);
+                        }
+                    });
+                } else {
+                    $input = clean($input);
+                    $input = ToolboxHelper::stripCkEditorSchemesOnMediaInputs($input);
+                }
+            } else {
+                $input = strip_tags($input);
+            }
+        };
+        \array_walk($inputs, $cleanInput);
+        $request->merge($inputs);
+        return $next($request);
+    }
+}

app/Http/Middleware/PreventRequestsDuringMaintenance.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace App\Http\Middleware;
+
+use Illuminate\Foundation\Http\Middleware\PreventRequestsDuringMaintenance as Middleware;
+
+class PreventRequestsDuringMaintenance extends Middleware
+{
+    /**
+     * The URIs that should be reachable while maintenance mode is enabled.
+     *
+     * @var array<int, string>
+     */
+    protected $except = [];
+}

app/Http/Middleware/RedirectIfAuthenticated.php

@@ -0,0 +1,43 @@
+<?php
+
+namespace App\Http\Middleware;
+
+use Illuminate\Http\Request;
+use Symfony\Component\HttpFoundation\Response;
+
+class RedirectIfAuthenticated
+{
+    /**
+     * Handle an incoming request.
+     *
+     * @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): Response
+    {
+        // phpcs:enable phpcs:disable
+        $guards = empty($guards) ? [null] : $guards;
+
+        foreach ($guards as $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}` .");
+                }
+            }
+        }
+
+        return $next($request);
+    }
+}

app/Http/Middleware/SecureHeaders.php

@@ -0,0 +1,103 @@
+<?php
+
+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;
+use Symfony\Component\HttpFoundation\Response;
+
+class SecureHeaders
+{
+    /**
+     * Enumerate headers which you do not want in your application's responses.
+     * Great starting point would be to go check out @Scott_Helme's:
+     * https://securityheaders.com/
+     *
+     * @var array
+     */
+    private $unwantedHeaderList = [
+        'X-Powered-By',
+        'Server',
+    ];
+
+    /**
+     * Handle an incoming request.
+     *
+     * @param  \Illuminate\Http\Request                                                         $request
+     * @param  \Closure(\Illuminate\Http\Request): (\Symfony\Component\HttpFoundation\Response) $next
+     * @return \Symfony\Component\HttpFoundation\Response
+     * @phpcs:disable Squiz.Commenting.FunctionComment.IncorrectTypeHint
+     */
+    public function handle(Request $request, Closure $next): Response
+    {
+        // phpcs:enable
+        View::share('nonce', $nonce = Vite::useCspNonce());
+        // * For VueJS dev tool to execute
+        $jsDev     = config('app.debug') ? "'unsafe-eval' 'unsafe-inline'" : "'nonce-{$nonce}' 'strict-dynamic'";
+        $scheme    = config('app.env') === 'local' ? 'http' : 'https';
+        $reportUri = Route::has('cspReportUri') ?
+            \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');
+        $response->headers->set('X-Content-Type-Options', 'nosniff');
+        $response->headers->set('X-XSS-Protection', '1; mode=block');
+        $response->headers->set('X-Frame-Options', 'SAMEORIGIN');
+        $response->headers->set('Strict-Transport-Security', 'max-age=31536000; includeSubDomains;');
+        $cspPolicies = [
+            "default-src 'none';",
+            "manifest-src 'self';",
+            // * CKEDITOR Specific https://ckeditor.com/docs/ckeditor5/latest/installation/advanced/csp.html
+            "connect-src 'self' blob:;",
+            "img-src * data: blob:;",
+            'frame-src ' . implode(' ', [
+                'https://www.google.com/recaptcha/',
+                'https://recaptcha.google.com/recaptcha/',
+                'https://www.google.com/maps/'
+            ]) . ';',
+            "font-src 'self' data: https://fonts.gstatic.com;",
+            // ! Using CKEditor will must have unsafe-inline style
+            // phpcs:ignore Generic.Files.LineLength.TooLong
+            "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'
+            ]) . ';',
+            // ! If you dont use ckeditor use this
+            // "style-src 'self' 'nonce-$nonce';",
+            // phpcs:ignore Generic.Files.LineLength.TooLong
+            "script-src 'self' {$jsDev} " . \implode(' ', [
+                'https:  blob:',
+                'https://www.googletagmanager.com',
+                'https://cdnjs.cloudflare.com',
+                "$scheme://www.google-analytics.com",
+            ]) . ';'
+        ];
+
+        $response->headers->set(
+            'Content-Security-Policy',
+            implode(' ', $cspPolicies) . $reportUri
+        );
+        $response->headers->set('Feature-Policy', 'fullscreen \'self\';');
+        return $response;
+    }
+
+    /**
+     * Remove unwanted headers
+     *
+     * @param array $headerList
+     * @return void
+     */
+    private function removeUnwantedHeaders(array $headerList): void
+    {
+        foreach ($headerList as $header) {
+            header_remove($header);
+        }
+    }
+}

app/Http/Middleware/TrimStrings.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace App\Http\Middleware;
+
+use Illuminate\Foundation\Http\Middleware\TrimStrings as Middleware;
+
+class TrimStrings extends Middleware
+{
+    /**
+     * The names of the attributes that should not be trimmed.
+     *
+     * @var array<int, string>
+     */
+    protected $except = [
+        'current_password',
+        'password',
+        'password_confirmation',
+    ];
+}

app/Http/Middleware/TrustHosts.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace App\Http\Middleware;
+
+use Illuminate\Http\Middleware\TrustHosts as Middleware;
+
+class TrustHosts extends Middleware
+{
+    /**
+     * Get the host patterns that should be trusted.
+     *
+     * @return array<int, string|null>
+     */
+    public function hosts()
+    {
+        return [
+            $this->allSubdomainsOfApplicationUrl(),
+        ];
+    }
+}

app/Http/Middleware/TrustProxies.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace App\Http\Middleware;
+
+use Illuminate\Http\Middleware\TrustProxies as Middleware;
+use Illuminate\Http\Request;
+
+class TrustProxies extends Middleware
+{
+    /**
+     * The trusted proxies for this application.
+     *
+     * @var array<int, string>|string|null
+     */
+    protected $proxies;
+
+    /**
+     * The headers that should be used to detect proxies.
+     *
+     * @var integer
+     */
+    protected $headers =
+        Request::HEADER_X_FORWARDED_FOR |
+        Request::HEADER_X_FORWARDED_HOST |
+        Request::HEADER_X_FORWARDED_PORT |
+        Request::HEADER_X_FORWARDED_PROTO |
+        Request::HEADER_X_FORWARDED_AWS_ELB;
+}

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

@@ -0,0 +1,17 @@
+<?php
+
+namespace App\Http\Middleware;
+
+use Illuminate\Foundation\Http\Middleware\VerifyCsrfToken as Middleware;
+
+class VerifyCsrfToken extends Middleware
+{
+    /**
+     * The URIs that should be excluded from CSRF verification.
+     *
+     * @var array<int, string>
+     */
+    protected $except = [
+        '/csp-report'
+    ];
+}

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->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/UpdateMiniCrudRequest.php

@@ -0,0 +1,229 @@
+<?php
+
+namespace App\Http\Requests\Bo;
+
+use App\Enums\InputType;
+use App\Lib\Helpers\ToolboxHelper;
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\ValidationException;
+
+abstract class UpdateMiniCrudRequest extends FormRequest
+{
+    /**
+     * The model parameter name
+     *
+     * @var string
+     */
+    protected $modelName = null;
+
+    /**
+     * Determine if the user is authorized to make this request.
+     *
+     * @return boolean
+     */
+    public function authorize()
+    {
+        return auth('backend')->check();
+    }
+
+    /**
+     * Get the validation rules that apply to the request.
+     *
+     * @return array
+     * @phpcs:disable Generic.Metrics.CyclomaticComplexity.TooHigh
+     * @phpcs:disable Generic.Metrics.NestingLevel.TooHigh
+     */
+    public function rules()
+    {
+        // phpcs:enable
+        $rules = [];
+        foreach ($this->{$this->modelName}->data as $iptName => $input) {
+            $input = \json_decode(\json_encode($input), true);
+            switch ($input['inputType']) {
+                case InputType::number->value:
+                    $rules = array_merge($rules, [
+                        "data.$iptName.value" => $this->compileValidate('required|numeric', $input)
+                    ]);
+                    break;
+                case InputType::videoYoutube->value:
+                    $rules = array_merge($rules, [
+                        "data.$iptName.value" => $this->compileValidate('regex:%([^"&?\/\s]{11})%i', $input)
+                    ]);
+                    break;
+                case InputType::videoVimeo->value:
+                    $rules = array_merge($rules, [
+                        "data.$iptName.value" => $this->compileValidate('regex:%([0-9]{8,10})%i', $input)
+                    ]);
+                    break;
+                case InputType::video->value:
+                    $rules = array_merge($rules, [
+                        "data.$iptName.value" => $this->compileValidate([
+                            'regex:%([0-9]{8,10}|[^"&?\/\s]{11})%i'
+                        ], $input)
+                    ]);
+                    break;
+                case InputType::string->value:
+                    $rules = array_merge($rules, [
+                        "data.$iptName.value" => $this->compileValidate('required|string|min:3', $input)
+                    ]);
+                    break;
+                case InputType::text->value:
+                    $mergeRules = $this->compileValidate('required|string|min:15', $input);
+                    $mergeRules = collect($mergeRules)
+                        ->map(function ($rule) {
+                            if (\strpos($rule, 'max:') !== false) {
+                                $max = \intval(str_replace('max:', '', $rule));
+                                return function ($attribute, $value, $fail) use ($max) {
+                                    if (\strlen(\strip_tags($value)) > $max) {
+                                        $fail("$attribute ne doit pas excéder $max caractères");
+                                    }
+                                };
+                            }
+                            return $rule;
+                        });
+                    $rules      = array_merge($rules, [
+                        "data.$iptName.value" => $mergeRules
+                    ]);
+                    break;
+                case InputType::image->value:
+                    $required = $this->isUpdate() ? 'sometimes' : 'required';
+
+                    $ipt = $this->data[$iptName];
+                    $max = isset($ipt['dimensionsMax']);
+                    $dim = \is_string($input['dimensions']) ? collect(explode(
+                        ',',
+                        (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'],
+                        'minWith' => $dim['width'],
+                        'maxWith' => $dim['width'],
+                    ];
+                    $rules = array_merge($rules, [
+                        "data.$iptName.value" => [
+                            function (string $attribute, $value, callable $fail) use ($sizes) {
+                                return ToolboxHelper::validatePicture($attribute, $value, $fail, $sizes);
+                            }
+                        ],
+                        $this->compileValidate(
+                            implode('|', [
+                                $required,
+                                'image',
+                                'mimes:png,jpg,jpeg',
+                                sprintf(
+                                    'dimensions:%s=%d,%s=%d',
+                                    $max ? 'max_height' : 'height',
+                                    $dim['height'],
+                                    $max ? 'max_width' : 'width',
+                                    $dim['width']
+                                )
+                            ]),
+                            $input
+                        ),
+                        "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:
+                    $rules = array_merge($rules, [
+                        "data.$iptName.value" => [
+                            'required', 'url',
+                            // @phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.FoundInExtendedClassBeforeLastUsed
+                            function ($attribute, $value, $fail) {
+                                try {
+                                    ToolboxHelper::assertNoInternalUrls($attribute, $value);
+                                    ToolboxHelper::assertNoInternalBoUrls($attribute, $value);
+                                } catch (ValidationException $e) {
+                                    $fail(collect($e->errors())->first()[0]);
+                                }
+                            }
+                        ]
+                    ]);
+                    break;
+                case InputType::boolean->value:
+                    $all    = $this->all();
+                    $nested = ToolboxHelper::dotStringToNestedArray(
+                        "data.$iptName.value",
+                        $this->input("data.$iptName.value") ? true : false
+                    );
+                    $all    = ToolboxHelper::arrayMergeRecursiveDistinct($all, $nested);
+                    $this->merge($all);
+                    $rules = array_merge($rules, [
+                        "data.$iptName.value" => 'boolean'
+                    ]);
+                    break;
+            } //end switch
+        } //end foreach
+        return $rules;
+    }
+
+    /**
+     * Undocumented function
+     *
+     * @param string|array $inputTypeValidate
+     * @param array        $input
+     * @return array
+     */
+    public function compileValidate(string|array $inputTypeValidate, array $input): array
+    {
+        if (\is_string($inputTypeValidate)) {
+            $inputTypeValidate = 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, $inputTypeValidate)) {
+                $inputTypeValidate[] = $validate;
+            }
+        }
+
+        $test = \collect($inputTypeValidate)->all();
+        $test = \collect($inputTypeValidate)->sort(function ($valueA, $valueB) {
+            $valueA = $this->ruleHasToComeFirst($valueA) ? 0 : 2;
+            $valueB = $this->ruleHasToComeFirst($valueB) ? 1 : 2;
+            return $valueA - $valueB;
+        })->unique()->all();
+
+        return \collect($inputTypeValidate)->unique()->sort(function ($valueA, $valueB) {
+            $valueA = $this->ruleHasToComeFirst($valueA) ? 0 : 2;
+            $valueB = $this->ruleHasToComeFirst($valueB) ? 1 : 2;
+            return $valueA - $valueB;
+        })->all();
+    }
+
+    /**
+     * Does the rulle need to come first ?
+     *
+     * @param string $rule
+     * @return boolean
+     */
+    private function ruleHasToComeFirst(string $rule): bool
+    {
+        $rule = \collect(\explode(':', $rule, 1))->filter()->first(null, '');
+        return \collect([
+            'nullable', 'present', 'required', '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',
+        ])->first(fn (string $firstRule) =>  \strpos($rule, $firstRule) === 0) ? true : false;
+    }
+
+    /**
+     * 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,74 @@
+<?php
+
+namespace App\Http\Requests\Bo\Users;
+
+use App\Enums\Users\RoleEnum;
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\Rules\Enum;
+use Illuminate\Validation\Rules\Password;
+
+class StoreUserRequest extends FormRequest
+{
+    /**
+     * Determine if the user is authorized to make this request.
+     *
+     * @return boolean
+     */
+    public function authorize(): bool
+    {
+        return auth('backend')->check();
+    }
+
+    /**
+     * Prepare the data for validation.
+     *
+     * @return void
+     */
+    protected function prepareForValidation()
+    {
+        $this->merge([
+            'published' => $this->published ? true : false
+        ]);
+    }
+
+    /**
+     * 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',
+            'password' => [
+                'required', 'required_with:password_confirmation', 'confirmed', 'max:255', Password::min(8)
+                    ->letters()
+                    ->mixedCase()
+                    ->numbers()
+                    ->symbols()
+                    ->uncompromised()
+            ],
+            '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'),
+            'password' => trans('validation.attributes.password'),
+            'role' => trans('validation.attributes.role'),
+            'published' => trans('validation.custom.publication')
+        ];
+    }
+}

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

@@ -0,0 +1,48 @@
+<?php
+
+namespace App\Http\Requests\Bo\Users;
+
+use Illuminate\Validation\Rules\Password;
+
+class UpdateUserRequest extends StoreUserRequest
+{
+    /**
+     * Prepare the data for validation.
+     *
+     * @return void
+     */
+    protected function prepareForValidation()
+    {
+        $this->merge([
+            'published' => $this->published ? true : false,
+            'password' => $this->password ? $this->password : $this->route('user')->password,
+            'password_confirmation' => $this->password_confirmation ?
+                $this->password_confirmation :
+                $this->route('user')->password
+        ]);
+    }
+
+    /**
+     * 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',
+                'unique:users,email,' . $this->route('user')->id . ',id',
+            ],
+            'password' => [
+                'required', 'required_with:password_confirmation', 'confirmed', 'max:255', Password::min(8)
+                    ->letters()
+                    ->mixedCase()
+                    ->numbers()
+                    ->symbols()
+                    ->uncompromised()
+            ],
+        ]);
+    }
+}

app/Lib/Helpers/CollectionHelper.php

@@ -0,0 +1,64 @@
+<?php
+
+namespace App\Lib;
+
+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";
+            } elseif (isset($stack['function'])) {
+                $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,454 @@
+<?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
+{
+    /**
+     * 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,
+            $private
+        );
+        $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 = 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/Lib/Helpers/ToolboxHelper.php

@@ -0,0 +1,540 @@
+<?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
+{
+    /**
+     * @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);
+                    // 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 => 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
+     */
+    public static function mbReplace(
+        array|string $search,
+        array|string $replace,
+        array|string $subject,
+        int &$count = 0
+    ): array|string {
+        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))) {
+            return $model->getTranslation(
+                $attribute,
+                $model->getLocale(),
+                $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 array|object $input
+     * @return array
+     * @throws \RuntimeException If $input var is a scalar value.
+     */
+    public static function objectToArray($input): array
+    {
+        // Only process if it's an object or array being passed to the function.
+        if (is_object($input) or is_array($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;
+        } else {
+            throw new \RuntimeException('Cannot handle $input of type ' . \gettype($input));
+        }
+    }
+
+    /**
+     * Convert deeply an array to object
+     *
+     * @param array|object $input
+     * @return object
+     * @throws \RuntimeException If $input var is a scalar value.
+     */
+    public static function arrayToObject($input): object
+    {
+        // Only process if it's an object or array being passed to the function.
+        if (is_object($input) or is_array($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;
+        } else {
+            throw new \RuntimeException('Cannot handle $input of type ' . \gettype($input));
+        }
+    }
+
+    /**
+     * Validate picture
+     *
+     * @param string      $attribute
+     * @param string|null $value
+     * @param callback    $fail
+     * @param object      $sizes
+     * @return void
+     */
+    public static function validatePicture(string $attribute, string|null $value, callable $fail, object $sizes)
+    {
+        if (!($useStorage = Storage::exists($value)) and !File::exists($value)) {
+            $fail(trans(':attribute n\'existe pas dans le système de fichier', [
+                'attribute' => $attribute
+            ]));
+            return;
+        }
+        /** @var string */
+        $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)) or !isset($dimensions[0]) or !isset($dimensions[1])) {
+            $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->minWith}px et {$sizes->maxWith}px"
+            );
+            if ($sizes->minWith === $sizes->maxWith) {
+                $xMessage = trans(":attribute la largeur doit être de {$sizes->minWith}px");
+            }
+            $yMessage = trans(
+                ":attribute la hauteur doit être comprise entre {$sizes->minWith}px et {$sizes->maxWith}px"
+            );
+            if ($sizes->minHeight === $sizes->maxHeight) {
+                $yMessage = trans(":attribute la hauteur doit être de {$sizes->minWith}px");
+            }
+
+            if (($width < $sizes->minWith) or ($width > $sizes->maxWith)) {
+                $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/Models/ActivityLog.php

@@ -0,0 +1,133 @@
+<?php
+
+namespace App\Models;
+
+use App\Enums\ActivityLogs\ActivityLogsEventEnum;
+use Carbon\Carbon;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Notifications\Notifiable;
+use Illuminate\Support\Facades\Schema;
+
+/**
+ * @property string                          $model      Target model.
+ * @property string                          $model_id   Id of the target model.
+ * @property string                          $event      Event of this activity (ActivityLogsEventEnum).
+ * @property string                          $data       Changes.
+ * @property-read \Illuminate\Support\Carbon $created_at Created date.
+ *
+ * @method public static function addActivity($model, $eventEnum) Add new activity to the activity logs list.
+ * @method public static function getValuesChanged($activity, $model, $eventEnum)
+ * Get old, new and type of values changed.
+ *
+ * @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);
+        $activity->created_at   = Carbon::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|null
+     */
+    public static function getChangedColumns(self $activity, Model $model, ActivityLogsEventEnum $eventEnum): array|null
+    {
+        $modelClassName = $activity->model_class;
+        /** Get type of each fields of the target model */
+        $targetModel = $activity->model_class::where(
+            (new $modelClassName())->getRouteKeyName(),
+            $activity->model_id
+        )->first();
+        if ($targetModel != null) {
+            // phpcs:disable Generic.CodeAnalysis.UnusedFunctionParameter.FoundInExtendedClassBeforeLastUsed
+            $targetModelTypes = collect($targetModel->toArray())
+                ->map(function ($field, $fieldIndex) use ($targetModel) {
+                    return Schema::getColumnType($targetModel->getTable(), $fieldIndex);
+                })->toArray();
+            // phpcs:enable
+        }
+        /** Return old, new and type of values changed */
+        return ($eventEnum === ActivityLogsEventEnum::updated) ?
+            array_intersect_key($targetModelTypes, $model->getChanges()) : null;
+    }
+
+    // * RELATIONS
+
+    /**
+     * User BelongsTo relation.
+     *
+     * @return \Illuminate\Database\Eloquent\Relations\BelongsTo
+     */
+    public function user()
+    {
+        return $this->belongsTo(User::class);
+    }
+}

app/Models/User.php

@@ -0,0 +1,129 @@
+<?php
+
+namespace App\Models;
+
+use App\Enums\Users\RoleEnum;
+use App\Traits\Models\ActivityLog;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Foundation\Auth\User as Authenticatable;
+use Illuminate\Notifications\Notifiable;
+use Illuminate\Support\Facades\Hash;
+
+/**
+ * @property string                          $first_name   Prénom.
+ * @property string                          $last_name    Nom.
+ * @property string                          $email        Email.
+ * @property string                          $password     Mot de passe.
+ * @property \App\Enums\Users\RoleEnum       $role         Rôle.
+ * @property \Illuminate\Support\Carbon      $published    État de publication.
+ * @property \Illuminate\Support\Carbon      $published_at Date de mise à jour de l'état de publication.
+ * @property-read \Illuminate\Support\Carbon $created_at   Created date.
+ * @property-read \Illuminate\Support\Carbon $updated_at   Updated date.
+ *
+ * @method protected static function booted()             Perform any actions required after the model boots.
+ * @method private static function setOrder($model)       Set order after the last element of the list.
+ * @method private static function updatePassword($model) Update password.
+ *
+ * @property-read \App\Models\ActivityLog $activityLogs Activities logs One-to-many relationship.
+ */
+class User extends Authenticatable
+{
+    use ActivityLog;
+    use HasFactory;
+    use Notifiable;
+
+    /**
+     * The attributes that are mass assignable.
+     *
+     * @var array<int, string>
+     */
+    protected $fillable = [
+        'first_name',
+        'last_name',
+        'email',
+        'password',
+        'role',
+        'published',
+        'published_at',
+    ];
+
+    /**
+     * The attributes that should be hidden for serialization.
+     *
+     * @var array<int, string>
+     */
+    protected $hidden = [
+        'password',
+        'remember_token',
+    ];
+
+    /**
+     * The attributes that should be cast.
+     *
+     * @var array<string, string>
+     */
+    protected $casts = [
+        'role'              => RoleEnum::class,
+        'email_verified_at' => 'datetime',
+        'published'         => 'boolean',
+    ];
+
+    /**
+     * Perform any actions required after the model boots.
+     *
+     * @return void
+     */
+    protected static function booted(): void
+    {
+        static::creating(function (self $model) {
+            static::updatePassword($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 $model) {
+            static::updatePassword($model);
+            if (optional(auth('backend')->user())->getKey() === $model->getKey()) {
+                \validator(
+                    ['published' => $model->published],
+                    ['published' => 'required|boolean|accepted'],
+                    ['published.accepted' => trans('Vous ne pouvez pas déactiver votre propre compte')],
+                )->validate();
+            }
+            // * Prevent user elevation privileges
+            throw_if(
+                auth('backend')->user() and auth('backend')->user()->role->value() > $model->role->value(),
+                AuthorizationException::class
+            );
+        });
+    }
+
+    // * METHODS
+
+    /**
+     * Update password.
+     *
+     * @param self $model
+     * @return void
+     */
+    private static function updatePassword(self $model): void
+    {
+        if (Hash::needsRehash($model->password)) {
+            $model->password = Hash::make($model->password);
+        }
+    }
+
+    // * RELATIONS
+
+    /**
+     * Activities logs One-to-many relationship.
+     *
+     * @return \Illuminate\Database\Eloquent\Relations\HasMany
+     */
+    public function activityLogs(): \Illuminate\Database\Eloquent\Relations\HasMany
+    {
+        return $this->hasMany(ActivityLog::class);
+    }
+}

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/Rules/UserStaticRules.php

@@ -0,0 +1,47 @@
+<?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 $minRole
+     * @return boolean
+     */
+    public static function atLeastRole(User $user, RoleEnum $minRole): bool
+    {
+        // phpcs:enable
+        return $user->role->value() <= $minRole->value();
+    }
+}

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 booleanean
+     */
+    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 booleanean
+     */
+    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 booleanean
+     */
+    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

@@ -0,0 +1,43 @@
+<?php
+
+namespace App\Providers;
+
+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
+{
+    /**
+     * Bootstrap any application services.
+     *
+     * @return void
+     */
+    public function boot()
+    {
+        Model::shouldBeStrict(!$this->app->environment('production'));
+
+        // * HTTPS FIX
+        URL::forceScheme('https');
+
+        // * HA PROXY FIX
+        App::singleton('clientIp', function () {
+            if (config('app.env') === 'local') {
+                return request()->getClientIp();
+            } else {
+                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

@@ -0,0 +1,30 @@
+<?php
+
+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 model to policy mappings for the application.
+     *
+     * @var array<class-string, class-string>
+     */
+    protected $policies = [];
+
+    /**
+     * Register any authentication / authorization services.
+     *
+     * @return void
+     */
+    public function boot(): void
+    {
+        Gate::define('isConceptor', function (User $user) {
+            return $user->role === RoleEnum::conceptor;
+        });
+    }
+}

app/Providers/EventServiceProvider.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace App\Providers;
+
+use Illuminate\Auth\Events\Registered;
+use Illuminate\Auth\Listeners\SendEmailVerificationNotification;
+use Illuminate\Foundation\Support\Providers\EventServiceProvider as ServiceProvider;
+
+class EventServiceProvider extends ServiceProvider
+{
+    /**
+     * The event to listener mappings for the application.
+     *
+     * @var array<class-string, array<int, class-string>>
+     */
+    protected $listen = [
+        Registered::class => [
+            SendEmailVerificationNotification::class,
+        ],
+    ];
+
+    /**
+     * Determine if events and listeners should be automatically discovered.
+     *
+     * @return boolean
+     */
+    public function shouldDiscoverEvents(): bool
+    {
+        return false;
+    }
+}

app/Providers/RouteServiceProvider.php

@@ -0,0 +1,100 @@
+<?php
+
+namespace App\Providers;
+
+use App\Models\User;
+use Illuminate\Cache\RateLimiting\Limit;
+use Illuminate\Foundation\Support\Providers\RouteServiceProvider as ServiceProvider;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\RateLimiter;
+use Illuminate\Support\Facades\Route;
+
+class RouteServiceProvider extends ServiceProvider
+{
+    /**
+     * The path to your application's "home" route.
+     *
+     * Typically, users are redirected here after authentication.
+     *
+     * @var string
+     */
+    public const HOME = '/';
+
+    /**
+     * Define your route model bindings, pattern filters, and other route configuration.
+     *
+     * @return void
+     */
+    public function boot(): void
+    {
+        $this->configureRateLimiting();
+
+        $this->cspReportRoute();
+
+        $this->routes(function () {
+            Route::middleware('web')
+                ->namespace($this->namespace)
+                ->group(base_path('routes/web-bo.php'));
+
+            Route::middleware('web')
+                ->namespace($this->namespace)
+                ->group(base_path('routes/web-fo.php'));
+        });
+
+        Route::model('user', User::class);
+    }
+
+    /**
+     * Configure the rate limiters for the application.
+     *
+     * @return void
+     */
+    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($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

@@ -0,0 +1,78 @@
+<?php
+
+namespace App\Providers;
+
+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
+{
+    /**
+     * Bootstrap the application services.
+     *
+     * @return void
+     */
+    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),
+                ];
+                return $translations;
+            });
+        }
+    }
+
+    /**
+     * Gather provided langs checking from files
+     *
+     * @return \Illuminate\Support\Collection<string, string>
+     */
+    private function collectLocalesStrings(): Collection
+    {
+        return collect(File::allFiles(resource_path('lang/')))->flatMap(function (SplFileInfo $file) {
+            if ($file->getRelativePath() and \strpos($file->getRelativePath(), 'vendor') !== 0) {
+                return [$file->getRelativePath() => ''];
+            }
+        })->keys();
+    }
+
+    /**
+     * Gather all php translations
+     *
+     * @param string $locale
+     * @return array<string, string>
+     */
+    private function phpTranslations(string $locale): array
+    {
+        $path = resource_path("lang/$locale");
+
+        return collect(File::allFiles($path))->flatMap(function ($file) use ($locale) {
+            $translation = $file->getBasename('.php');
+            return [$translation => trans($translation, [], $locale)];
+        })->all();
+    }
+
+    /**
+     * Gather json translations
+     *
+     * @param string $locale
+     * @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) ?? [];
+        }
+
+        return [];
+    }
+}

app/Providers/ViewServiceProvider.php

@@ -0,0 +1,41 @@
+<?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) and isset($appInfos->license)) {
+            View::share('cpsr_name', $appInfos->name);
+            View::share('cpsr_version', $appInfos->version);
+            View::share('cpsr_license', $appInfos->license);
+            View::share('cpsr_support', $appInfos->support->email);
+        }
+
+        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/Traits/Controllers/ChangesModelOrder.php

@@ -0,0 +1,57 @@
+<?php
+
+namespace App\Traits\Controllers;
+
+use App\Http\Requests\Bo\UpdateChangeOrderRequest;
+use Illuminate\Database\Eloquent\Model;
+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 \Illuminate\Database\Eloquent\Model            $model
+     * @return \Illuminate\Http\RedirectResponse
+     * @throws \RuntimeException Si le nom du parametre de la route ne correspond pas au model utilisé.
+     */
+    public function changeOrder(UpdateChangeOrderRequest $request, Model $model): \Illuminate\Http\RedirectResponse
+    {
+        $params    = collect(request()->route()->parameterNames);
+        $className = Str::ucfirst(Str::lower($params->get($params->count() - 2)));
+        $className = "\\App\\Models\\$className";
+
+        if (!class_exists($className)) {
+            throw new \RuntimeException("The $className class doesn't exist.");
+        }
+
+        /** @var \Illuminate\Database\Eloquent\Model|null */
+        $model = $className::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->order)
+                ->orderBy('order', $request->direction ? 'DESC' : 'ASC')->first();
+
+            if (!$tmp) {
+                return back()->with('error', trans('crud.messages.order_not_changed'));
+            }
+
+            $newOrder     = $tmp->order;
+            $tmp->order   = $model->order;
+            $model->order = $newOrder;
+            $tmp->saveOrFail();
+            $model->saveOrFail();
+            Session::flash('success', trans('crud.messages.order_changed'));
+
+            return back();
+        });
+    }
+}

app/Traits/Controllers/UpdateModelPublished.php

@@ -0,0 +1,26 @@
+<?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->published = !$model->published;
+        $model->saveOrFail();
+        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 \App\Traits\Enums\BaseEnum|integer|string $value
+     * @param string                                    $field
+     * @return \App\Traits\Enums\BaseEnum|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,23 @@
+<?php
+
+namespace App\Traits\Models;
+
+use App\Observers\ModelObserver;
+
+/**
+ * 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);
+    }
+}

app/Traits/Models/IsCachedAsCollection.php

@@ -0,0 +1,103 @@
+<?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 private static array $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

@@ -0,0 +1,180 @@
+<?php
+
+namespace App\Traits\Models;
+
+use App\Enums\InputType;
+use App\Lib\Helpers\FileStorageHelper;
+use App\Lib\Helpers\ToolboxHelper;
+
+trait MiniCrudModel
+{
+    /**
+     * Fill the model with an array of attributes.
+     *
+     * @param  array $attributes
+     * @return void
+     * @throws \Illuminate\Database\Eloquent\MassAssignmentException If fill prop is not allowed.
+     * @phpcs:disable Squiz.Commenting.FunctionComment.EmptyThrows
+     */
+    public function fill(array $attributes)
+    {
+        // phpcs:enable
+        parent::fill($attributes);
+        if (isset($attributes['data'])) {
+            $this->setData($attributes['data']);
+        }
+    }
+
+    /**
+     * Apply function on data typed text while on save event
+     *
+     * @return void
+     */
+    public function minicrudCreating()
+    {
+        /** @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()
+    {
+        $this->minicrudCreating();
+    }
+
+    /**
+     * Apply function on data typed text while on updated event
+     *
+     * @return void
+     */
+    public function minicrudUpdated()
+    {
+        /** @var array */
+        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()
+    {
+        /** @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
+     *
+     * @param array $data
+     * @return void
+     */
+    private function setData(array $data): void
+    {
+        $attrs = $this->attributes;
+        if (isset($attrs['data'])) {
+            unset($attrs['data']);
+        }
+        $this->setAttribute('data', $data);
+    }
+
+    /**
+     * Set a specific prop
+     *
+     * @param array $value
+     * @return void
+     */
+    protected function setDataAttribute(array $value): void
+    {
+        $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 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): array
+    {
+        foreach ($data as $o => $input) {
+            switch ($input['inputType']) {
+                case InputType::image->value:
+                    $data[$o]['value'] = \preg_replace(
+                        '/^\/|^/',
+                        '',
+                        FileStorageHelper::storeFile($this, $input['value'], true)
+                    );
+                    break;
+                case InputType::selectEnum->value:
+                case InputType::boolean->value:
+                case InputType::password->value:
+                case InputType::email->value:
+                case InputType::number->value:
+                case InputType::videoVimeo->value:
+                case InputType::videoYoutube->value:
+                case InputType::video->value:
+                    break;
+                case InputType::string->value:
+                case InputType::text->value:
+                case InputType::url->value:
+                    ToolboxHelper::assertNoInternalBoUrls('content', $input['value']);
+                    break;
+                default:
+                    throw new \ErrorException(sprintf(
+                        'Unknown input Type %s',
+                        $input['inputType']
+                    ));
+            } //end switch
+        } //end foreach
+        return $data;
+    }
+}

artisan

@@ -0,0 +1,53 @@
+#!/usr/bin/env php
+<?php
+
+define('LARAVEL_START', microtime(true));
+
+/*
+|--------------------------------------------------------------------------
+| Register The Auto Loader
+|--------------------------------------------------------------------------
+|
+| Composer provides a convenient, automatically generated class loader
+| for our application. We just need to utilize it! We'll require it
+| into the script here so that we do not have to worry about the
+| loading of any of our classes manually. It's great to relax.
+|
+*/
+
+require __DIR__.'/vendor/autoload.php';
+
+$app = require_once __DIR__.'/bootstrap/app.php';
+
+/*
+|--------------------------------------------------------------------------
+| Run The Artisan Application
+|--------------------------------------------------------------------------
+|
+| When we run the console application, the current CLI command will be
+| executed in this console and the response sent back to a terminal
+| or another output device for the developers. Here goes nothing!
+|
+*/
+
+$kernel = $app->make(Illuminate\Contracts\Console\Kernel::class);
+
+$status = $kernel->handle(
+    $input = new Symfony\Component\Console\Input\ArgvInput,
+    new Symfony\Component\Console\Output\ConsoleOutput
+);
+
+/*
+|--------------------------------------------------------------------------
+| Shutdown The Application
+|--------------------------------------------------------------------------
+|
+| Once Artisan has finished running, we will fire off the shutdown events
+| so that any final work may be done by the application before we shut
+| down the process. This is the last thing to happen to the request.
+|
+*/
+
+$kernel->terminate($input, $status);
+
+exit($status);

composer.json

@@ -0,0 +1,88 @@
+{
+    "name": "uwil/laravel-base-project",
+    "version": "1.0.0",
+    "type": "project",
+    "description": "Laravel base project reference.",
+    "support": {
+        "email": "equipe.web@ldc.fr"
+    },
+    "keywords": [
+        "framework",
+        "laravel"
+    ],
+    "license": "MIT",
+    "require": {
+        "php": "^8.2",
+        "diglactic/laravel-breadcrumbs": "^8.0",
+        "guzzlehttp/guzzle": "^7.2",
+        "laravel/framework": "^10.0",
+        "laravel/tinker": "^2.8",
+        "laravel/ui": "^4.2",
+        "mews/purifier": "^3.4",
+        "sentry/sentry-laravel": "*"
+    },
+    "require-dev": {
+        "fakerphp/faker": "^1.9.1",
+        "kitloong/laravel-migrations-generator": "^6.8",
+        "krlove/eloquent-model-generator": "dev-l10-compatibility",
+        "laravel-lang/common": "^4.0",
+        "laravel/pint": "^1.0",
+        "laravel/sail": "^1.18",
+        "mockery/mockery": "^1.4.4",
+        "nunomaduro/collision": "^7.0",
+        "phpunit/phpunit": "^10.0",
+        "slevomat/coding-standard": "^8.10",
+        "spatie/laravel-ignition": "^2.0",
+        "thedoctor0/laravel-factory-generator": "^1.2"
+    },
+    "autoload": {
+        "psr-4": {
+            "App\\": "app/",
+            "Database\\Factories\\": "database/factories/",
+            "Database\\Seeders\\": "database/seeders/"
+        }
+    },
+    "repositories": [
+        {
+            "type": "vcs",
+            "url": "https://github.com/laravel-shift/eloquent-model-generator.git"
+        }
+    ],
+    "autoload-dev": {
+        "psr-4": {
+            "Tests\\": "tests/"
+        }
+    },
+    "scripts": {
+        "post-autoload-dump": [
+            "Illuminate\\Foundation\\ComposerScripts::postAutoloadDump",
+            "@php artisan package:discover --ansi"
+        ],
+        "post-update-cmd": [
+            "@php artisan vendor:publish --tag=laravel-assets --ansi --force"
+        ],
+        "post-root-package-install": [
+            "@php -r \"file_exists('.env') || copy('.env.example', '.env');\""
+        ],
+        "post-create-project-cmd": [
+            "@php artisan key:generate --ansi"
+        ]
+    },
+    "extra": {
+        "laravel": {
+            "dont-discover": []
+        }
+    },
+    "config": {
+        "optimize-autoloader": true,
+        "preferred-install": "dist",
+        "sort-packages": true,
+        "allow-plugins": {
+            "pestphp/pest-plugin": true,
+            "php-http/discovery": true,
+            "dealerdirect/phpcodesniffer-composer-installer": true
+        }
+    },
+    "minimum-stability": "stable",
+    "prefer-stable": true
+}

config/app.php

@@ -0,0 +1,216 @@
+<?php
+
+use Illuminate\Support\Facades\Facade;
+
+return [
+
+    /*
+        |--------------------------------------------------------------------------
+        | Application Name
+        |--------------------------------------------------------------------------
+        |
+        | This value is the name of your application. This value is used when the
+        | framework needs to place the application's name in a notification or
+        | any other location as required by the application or its packages.
+        |
+    */
+
+    'name' => env('APP_NAME', 'Laravel'),
+
+    /*
+        |--------------------------------------------------------------------------
+        | Application Environment
+        |--------------------------------------------------------------------------
+        |
+        | This value determines the "environment" your application is currently
+        | running in. This may determine how you prefer to configure various
+        | services the application utilizes. Set this in your ".env" file.
+        |
+    */
+
+    'env' => env('APP_ENV', 'production'),
+
+    /*
+        |--------------------------------------------------------------------------
+        | Application Debug Mode
+        |--------------------------------------------------------------------------
+        |
+        | When your application is in debug mode, detailed error messages with
+        | stack traces will be shown on every error that occurs within your
+        | application. If disabled, a simple generic error page is shown.
+        |
+    */
+
+    'debug' => (bool)env('APP_DEBUG', false),
+
+    /*
+        |--------------------------------------------------------------------------
+        | Application URL
+        |--------------------------------------------------------------------------
+        |
+        | This URL is used by the console to properly generate URLs when using
+        | the Artisan command line tool. You should set this to the root of
+        | your application so that it is used when running Artisan tasks.
+        |
+    */
+
+    'url' => env('APP_URL', 'http://localhost'),
+
+    'asset_url' => env('ASSET_URL'),
+
+    /*
+        |--------------------------------------------------------------------------
+        | Application Timezone
+        |--------------------------------------------------------------------------
+        |
+        | Here you may specify the default timezone for your application, which
+        | will be used by the PHP date and date-time functions. We have gone
+        | ahead and set this to a sensible default for you out of the box.
+        |
+    */
+
+    'timezone' => 'Europe/Paris',
+
+    /*
+        |--------------------------------------------------------------------------
+        | Application Locale Configuration
+        |--------------------------------------------------------------------------
+        |
+        | The application locale determines the default locale that will be used
+        | by the translation service provider. You are free to set this value
+        | to any of the locales which will be supported by the application.
+        |
+    */
+
+    'locale' => 'fr',
+
+    /*
+        |--------------------------------------------------------------------------
+        | Application Fallback Locale
+        |--------------------------------------------------------------------------
+        |
+        | The fallback locale determines the locale to use when the current one
+        | is not available. You may change the value to correspond to any of
+        | the language folders that are provided through your application.
+        |
+    */
+
+    'fallback_locale' => 'fr',
+
+    /*
+        |--------------------------------------------------------------------------
+        | Faker Locale
+        |--------------------------------------------------------------------------
+        |
+        | This locale will be used by the Faker PHP library when generating fake
+        | data for your database seeds. For example, this will be used to get
+        | localized telephone numbers, street address information and more.
+        |
+    */
+
+    'faker_locale' => 'fr_FR',
+
+    /*
+        |--------------------------------------------------------------------------
+        | Encryption Key
+        |--------------------------------------------------------------------------
+        |
+        | This key is used by the Illuminate encrypter service and should be set
+        | to a random, 32 character string, otherwise these encrypted strings
+        | will not be safe. Please do this before deploying an application!
+        |
+    */
+
+    'key' => env('APP_KEY'),
+
+    '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
+        |--------------------------------------------------------------------------
+        |
+        | The service providers listed here will be automatically loaded on the
+        | request to your application. Feel free to add your own services to
+        | this array to grant expanded functionality to your applications.
+        |
+    */
+
+    'providers' => [
+
+        /*
+         * Laravel Framework Service Providers...
+         */
+
+        Illuminate\Auth\AuthServiceProvider::class,
+        Illuminate\Broadcasting\BroadcastServiceProvider::class,
+        Illuminate\Bus\BusServiceProvider::class,
+        Illuminate\Cache\CacheServiceProvider::class,
+        Illuminate\Foundation\Providers\ConsoleSupportServiceProvider::class,
+        Illuminate\Cookie\CookieServiceProvider::class,
+        Illuminate\Database\DatabaseServiceProvider::class,
+        Illuminate\Encryption\EncryptionServiceProvider::class,
+        Illuminate\Filesystem\FilesystemServiceProvider::class,
+        Illuminate\Foundation\Providers\FoundationServiceProvider::class,
+        Illuminate\Hashing\HashServiceProvider::class,
+        Illuminate\Mail\MailServiceProvider::class,
+        Illuminate\Notifications\NotificationServiceProvider::class,
+        Illuminate\Pagination\PaginationServiceProvider::class,
+        Illuminate\Pipeline\PipelineServiceProvider::class,
+        Illuminate\Queue\QueueServiceProvider::class,
+        Illuminate\Redis\RedisServiceProvider::class,
+        Illuminate\Auth\Passwords\PasswordResetServiceProvider::class,
+        Illuminate\Session\SessionServiceProvider::class,
+        Illuminate\Translation\TranslationServiceProvider::class,
+        Illuminate\Validation\ValidationServiceProvider::class,
+        Illuminate\View\ViewServiceProvider::class,
+
+        /*
+         * Package Service Providers...
+         */
+
+        /*
+         * Application Service Providers...
+         */
+
+        App\Providers\AppServiceProvider::class,
+        App\Providers\AuthServiceProvider::class,
+        App\Providers\EventServiceProvider::class,
+        App\Providers\RouteServiceProvider::class,
+        App\Providers\TranslationServiceProvider::class,
+        App\Providers\ViewServiceProvider::class,
+    ],
+
+    /*
+        |--------------------------------------------------------------------------
+        | Class Aliases
+        |--------------------------------------------------------------------------
+        |
+        | This array of class aliases will be registered when this application
+        | is started. However, feel free to register as many as you wish as
+        | the aliases are "lazy" loaded so they don't hinder performance.
+        |
+    */
+
+    'aliases' => Facade::defaultAliases()->merge([
+        'Carbon' => \Illuminate\Support\Carbon::class,
+    ])->toArray(),
+
+];

config/auth.php

@@ -0,0 +1,116 @@
+<?php
+
+return [
+
+    /*
+        |--------------------------------------------------------------------------
+        | Authentication Defaults
+        |--------------------------------------------------------------------------
+        |
+        | This option controls the default authentication "guard" and password
+        | reset options for your application. You may change these defaults
+        | as required, but they're a perfect start for most applications.
+        |
+    */
+
+    'defaults' => [
+        'guard' => 'frontend',
+        'passwords' => 'users',
+    ],
+
+    /*
+        |--------------------------------------------------------------------------
+        | Authentication Guards
+        |--------------------------------------------------------------------------
+        |
+        | Next, you may define every authentication guard for your application.
+        | Of course, a great default configuration has been defined for you
+        | here which uses session storage and the Eloquent user provider.
+        |
+        | All authentication drivers have a user provider. This defines how the
+        | users are actually retrieved out of your database or other storage
+        | mechanisms used by this application to persist your user's data.
+        |
+        | Supported: "session"
+        |
+    */
+
+    'guards' => [
+        'backend' => [
+            'driver' => 'session',
+            'provider' => 'users',
+        ],
+
+        'frontend' => [
+            'driver' => 'session',
+            // ! Remplacer "users" par le model authenticable voulu
+            'provider' => 'users',
+        ],
+    ],
+
+    /*
+        |--------------------------------------------------------------------------
+        | User Providers
+        |--------------------------------------------------------------------------
+        |
+        | All authentication drivers have a user provider. This defines how the
+        | users are actually retrieved out of your database or other storage
+        | mechanisms used by this application to persist your user's data.
+        |
+        | If you have multiple user tables or models you may configure multiple
+        | sources which represent each model / table. These sources may then
+        | be assigned to any extra authentication guards you have defined.
+        |
+        | Supported: "database", "eloquent"
+        |
+    */
+
+    'providers' => [
+        'users' => [
+            'driver' => 'eloquent',
+            'model' => \App\Models\User::class,
+        ],
+    ],
+
+    /*
+        |--------------------------------------------------------------------------
+        | Resetting Passwords
+        |--------------------------------------------------------------------------
+        |
+        | You may specify multiple password reset configurations if you have more
+        | 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 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_reset_tokens',
+            'expire' => 60,
+            'throttle' => 60,
+        ],
+    ],
+
+    /*
+        |--------------------------------------------------------------------------
+        | Password Confirmation Timeout
+        |--------------------------------------------------------------------------
+        |
+        | Here you may define the amount of seconds before a password confirmation
+        | times out and the user is prompted to re-enter their password via the
+        | confirmation screen. By default, the timeout lasts for three hours.
+        |
+    */
+
+    'password_timeout' => 10800,
+
+];

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

@@ -0,0 +1,70 @@
+<?php
+
+return [
+
+    /*
+        |--------------------------------------------------------------------------
+        | Default Broadcaster
+        |--------------------------------------------------------------------------
+        |
+        | This option controls the default broadcaster that will be used by the
+        | framework when an event needs to be broadcast. You may set this to
+        | any of the connections defined in the "connections" array below.
+        |
+        | Supported: "pusher", "ably", "redis", "log", "null"
+        |
+    */
+
+    'default' => env('BROADCAST_DRIVER', 'null'),
+
+    /*
+        |--------------------------------------------------------------------------
+        | Broadcast Connections
+        |--------------------------------------------------------------------------
+        |
+        | Here you may define all of the broadcast connections that will be used
+        | to broadcast events to other systems or over websockets. Samples of
+        | each available type of connection are provided inside this array.
+        |
+    */
+
+    'connections' => [
+
+        'pusher' => [
+            'driver' => 'pusher',
+            'key' => env('PUSHER_APP_KEY'),
+            'secret' => env('PUSHER_APP_SECRET'),
+            'app_id' => env('PUSHER_APP_ID'),
+            'options' => [
+                '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 .
+            ],
+        ],
+
+        'ably' => [
+            'driver' => 'ably',
+            'key' => env('ABLY_KEY'),
+        ],
+
+        'redis' => [
+            'driver' => 'redis',
+            'connection' => 'default',
+        ],
+
+        'log' => [
+            'driver' => 'log',
+        ],
+
+        'null' => [
+            'driver' => 'null',
+        ],
+
+    ],
+
+];

config/cache.php

@@ -0,0 +1,110 @@
+<?php
+
+use Illuminate\Support\Str;
+
+return [
+
+    /*
+        |--------------------------------------------------------------------------
+        | Default Cache Store
+        |--------------------------------------------------------------------------
+        |
+        | This option controls the default cache connection that gets used while
+        | using this caching library. This connection is used when another is
+        | not explicitly specified when executing a given caching function.
+        |
+    */
+
+    'default' => env('CACHE_DRIVER', 'file'),
+
+    /*
+        |--------------------------------------------------------------------------
+        | Cache Stores
+        |--------------------------------------------------------------------------
+        |
+        | Here you may define all of the cache "stores" for your application as
+        | well as their drivers. You may even define multiple stores for the
+        | same cache driver to group types of items stored in your caches.
+        |
+        | Supported drivers: "apc", "array", "database", "file",
+        |         "memcached", "redis", "dynamodb", "octane", "null"
+        |
+    */
+
+    'stores' => [
+
+        'apc' => [
+            'driver' => 'apc',
+        ],
+
+        'array' => [
+            'driver' => 'array',
+            'serialize' => false,
+        ],
+
+        'database' => [
+            'driver' => 'database',
+            'table' => 'cache',
+            'connection' => null,
+            'lock_connection' => null,
+        ],
+
+        'file' => [
+            'driver' => 'file',
+            'path' => storage_path('framework/cache/data'),
+        ],
+
+        'memcached' => [
+            'driver' => 'memcached',
+            'persistent_id' => env('MEMCACHED_PERSISTENT_ID'),
+            'sasl' => [
+                env('MEMCACHED_USERNAME'),
+                env('MEMCACHED_PASSWORD'),
+            ],
+            'options' => [
+                // Memcached::OPT_CONNECT_TIMEOUT => 2000, .
+            ],
+            'servers' => [
+                [
+                    'host' => env('MEMCACHED_HOST', '127.0.0.1'),
+                    'port' => env('MEMCACHED_PORT', 11211),
+                    'weight' => 100,
+                ],
+            ],
+        ],
+
+        'redis' => [
+            'driver' => 'redis',
+            'connection' => 'cache',
+            'lock_connection' => 'default',
+        ],
+
+        'dynamodb' => [
+            'driver' => 'dynamodb',
+            'key' => env('AWS_ACCESS_KEY_ID'),
+            'secret' => env('AWS_SECRET_ACCESS_KEY'),
+            'region' => env('AWS_DEFAULT_REGION', 'us-east-1'),
+            'table' => env('DYNAMODB_CACHE_TABLE', 'cache'),
+            'endpoint' => env('DYNAMODB_ENDPOINT'),
+        ],
+
+        'octane' => [
+            'driver' => 'octane',
+        ],
+
+    ],
+
+    /*
+        |--------------------------------------------------------------------------
+        | Cache Key Prefix
+        |--------------------------------------------------------------------------
+        |
+        | 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_'),
+
+];

config/cors.php

@@ -0,0 +1,34 @@
+<?php
+
+return [
+
+    /*
+        |--------------------------------------------------------------------------
+        | Cross-Origin Resource Sharing (CORS) Configuration
+        |--------------------------------------------------------------------------
+        |
+        | Here you may configure your settings for cross-origin resource sharing
+        | or "CORS". This determines what cross-origin operations may execute
+        | in web browsers. You are free to adjust these settings as needed.
+        |
+        | To learn more: https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS
+        |
+    */
+
+    'paths' => ['api/*'],
+
+    'allowed_methods' => ['*'],
+
+    'allowed_origins' => ['*'],
+
+    'allowed_origins_patterns' => [],
+
+    'allowed_headers' => ['*'],
+
+    'exposed_headers' => [],
+
+    'max_age' => 0,
+
+    'supports_credentials' => false,
+
+];

config/database.php

@@ -0,0 +1,149 @@
+<?php
+
+use Illuminate\Support\Str;
+
+return [
+
+    /*
+        |--------------------------------------------------------------------------
+        | Default Database Connection Name
+        |--------------------------------------------------------------------------
+        |
+        | Here you may specify which of the database connections below you wish
+        | to use as your default connection for all database work. Of course
+        | you may use many connections at once using the Database library.
+        |
+    */
+
+    'default' => env('DB_CONNECTION', 'mysql'),
+
+    /*
+        |--------------------------------------------------------------------------
+        | Database Connections
+        |--------------------------------------------------------------------------
+        |
+        | Here are each of the database connections setup for your application.
+        | Of course, examples of configuring each database platform that is
+        | supported by Laravel is shown below to make development simple.
+        |
+        |
+        | All database work in Laravel is done through the PHP PDO facilities
+        | so make sure you have the driver for your particular database of
+        | choice installed on your machine before you begin development.
+        |
+    */
+
+    'connections' => [
+
+        'sqlite' => [
+            'driver' => 'sqlite',
+            'url' => env('DATABASE_URL'),
+            'database' => env('DB_DATABASE', database_path('database.sqlite')),
+            'prefix' => '',
+            'foreign_key_constraints' => env('DB_FOREIGN_KEYS', true),
+        ],
+
+        'mysql' => [
+            'driver' => 'mysql',
+            'url' => env('DATABASE_URL'),
+            'host' => env('DB_HOST', '127.0.0.1'),
+            'port' => env('DB_PORT', '3306'),
+            'database' => env('DB_DATABASE', 'forge'),
+            'username' => env('DB_USERNAME', 'forge'),
+            'password' => env('DB_PASSWORD', ''),
+            'unix_socket' => env('DB_SOCKET', ''),
+            'charset' => 'utf8mb4',
+            'collation' => 'utf8mb4_unicode_ci',
+            'prefix' => '',
+            'prefix_indexes' => true,
+            'strict' => true,
+            'engine' => null,
+            'options' => extension_loaded('pdo_mysql') ? array_filter([
+                PDO::MYSQL_ATTR_SSL_CA => env('MYSQL_ATTR_SSL_CA'),
+            ]) : [],
+        ],
+
+        'pgsql' => [
+            'driver' => 'pgsql',
+            'url' => env('DATABASE_URL'),
+            'host' => env('DB_HOST', '127.0.0.1'),
+            'port' => env('DB_PORT', '5432'),
+            'database' => env('DB_DATABASE', 'forge'),
+            'username' => env('DB_USERNAME', 'forge'),
+            'password' => env('DB_PASSWORD', ''),
+            'charset' => 'utf8',
+            'prefix' => '',
+            'prefix_indexes' => true,
+            'search_path' => 'public',
+            'sslmode' => 'prefer',
+        ],
+
+        'sqlsrv' => [
+            'driver' => 'sqlsrv',
+            'url' => env('DATABASE_URL'),
+            'host' => env('DB_HOST', 'localhost'),
+            'port' => env('DB_PORT', '1433'),
+            'database' => env('DB_DATABASE', 'forge'),
+            'username' => env('DB_USERNAME', 'forge'),
+            'password' => env('DB_PASSWORD', ''),
+            'charset' => 'utf8',
+            'prefix' => '',
+            'prefix_indexes' => true,
+        ],
+
+    ],
+
+    /*
+        |--------------------------------------------------------------------------
+        | Migration Repository Table
+        |--------------------------------------------------------------------------
+        |
+        | This table keeps track of all the migrations that have already run for
+        | your application. Using this information, we can determine which of
+        | the migrations on disk haven't actually been run in the database.
+        |
+    */
+
+    'migrations' => 'migrations',
+
+    /*
+        |--------------------------------------------------------------------------
+        | Redis Databases
+        |--------------------------------------------------------------------------
+        |
+        | Redis is an open source, fast, and advanced key-value store that also
+        | provides a richer body of commands than a typical key-value system
+        | such as APC or Memcached. Laravel makes it easy to dig right in.
+        |
+    */
+
+    'redis' => [
+
+        'client' => env('REDIS_CLIENT', 'phpredis'),
+
+        'options' => [
+            'cluster' => env('REDIS_CLUSTER', 'redis'),
+            'prefix' => env('REDIS_PREFIX', Str::slug(env('APP_NAME', 'laravel'), '_') . '_database_'),
+        ],
+
+        'default' => [
+            'url' => env('REDIS_URL'),
+            'host' => env('REDIS_HOST', '127.0.0.1'),
+            'username' => env('REDIS_USERNAME'),
+            'password' => env('REDIS_PASSWORD'),
+            'port' => env('REDIS_PORT', '6379'),
+            'database' => env('REDIS_DB', '0'),
+        ],
+
+        'cache' => [
+            'url' => env('REDIS_URL'),
+            'host' => env('REDIS_HOST', '127.0.0.1'),
+            'username' => env('REDIS_USERNAME'),
+            'password' => env('REDIS_PASSWORD'),
+            'port' => env('REDIS_PORT', '6379'),
+            'database' => env('REDIS_CACHE_DB', '1'),
+        ],
+
+    ],
+
+];

config/filesystems.php

@@ -0,0 +1,83 @@
+<?php
+
+return [
+
+    /*
+        |--------------------------------------------------------------------------
+        | Default Filesystem Disk
+        |--------------------------------------------------------------------------
+        |
+        | Here you may specify the default filesystem disk that should be used
+        | by the framework. The "local" disk, as well as a variety of cloud
+        | based disks are available to your application. Just store away!
+        |
+    */
+
+    'default' => env('FILESYSTEM_DISK', 'local'),
+
+    /*
+        |--------------------------------------------------------------------------
+        | Filesystem Disks
+        |--------------------------------------------------------------------------
+        |
+        | 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 set up for each driver as an example of the required values.
+        |
+        | Supported Drivers: "local", "ftp", "sftp", "s3"
+        |
+    */
+
+    'disks' => [
+
+        'local' => [
+            'driver' => 'local',
+            'root' => storage_path('app'),
+            'throw' => false,
+        ],
+
+        'public' => [
+            'driver' => 'local',
+            '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' => [
+            'driver' => 's3',
+            'key' => env('AWS_ACCESS_KEY_ID'),
+            'secret' => env('AWS_SECRET_ACCESS_KEY'),
+            'region' => env('AWS_DEFAULT_REGION'),
+            'bucket' => env('AWS_BUCKET'),
+            'url' => env('AWS_URL'),
+            'endpoint' => env('AWS_ENDPOINT'),
+            'use_path_style_endpoint' => env('AWS_USE_PATH_STYLE_ENDPOINT', false),
+            'throw' => false,
+        ],
+
+    ],
+
+    /*
+        |--------------------------------------------------------------------------
+        | Symbolic Links
+        |--------------------------------------------------------------------------
+        |
+        | Here you may configure the symbolic links that will be created when the
+        | `storage:link` Artisan command is executed. The array keys should be
+        | the locations of the links and the values should be their targets.
+        |
+    */
+
+    'links' => [
+        public_path('storage') => storage_path('app/public'),
+    ],
+
+];

config/hashing.php

@@ -0,0 +1,52 @@
+<?php
+
+return [
+
+    /*
+        |--------------------------------------------------------------------------
+        | Default Hash Driver
+        |--------------------------------------------------------------------------
+        |
+        | This option controls the default hash driver that will be used to hash
+        | passwords for your application. By default, the bcrypt algorithm is
+        | used; however, you remain free to modify this option if you wish.
+        |
+        | Supported: "bcrypt", "argon", "argon2id"
+        |
+    */
+
+    'driver' => 'bcrypt',
+
+    /*
+        |--------------------------------------------------------------------------
+        | Bcrypt Options
+        |--------------------------------------------------------------------------
+        |
+        | Here you may specify the configuration options that should be used when
+        | passwords are hashed using the Bcrypt algorithm. This will allow you
+        | to control the amount of time it takes to hash the given password.
+        |
+    */
+
+    'bcrypt' => [
+        'rounds' => env('BCRYPT_ROUNDS', 12),
+    ],
+
+    /*
+        |--------------------------------------------------------------------------
+        | Argon Options
+        |--------------------------------------------------------------------------
+        |
+        | Here you may specify the configuration options that should be used when
+        | passwords are hashed using the Argon algorithm. These will allow you
+        | to control the amount of time it takes to hash the given password.
+        |
+    */
+
+    'argon' => [
+        'memory' => 65536,
+        'threads' => 1,
+        'time' => 4,
+    ],
+
+];

config/logging.php

@@ -0,0 +1,148 @@
+<?php
+
+use Monolog\Handler\NullHandler;
+use Monolog\Handler\StreamHandler;
+use Monolog\Handler\SyslogUdpHandler;
+use Monolog\Processor\PsrLogMessageProcessor;
+
+return [
+
+    /*
+        |--------------------------------------------------------------------------
+        | Default Log Channel
+        |--------------------------------------------------------------------------
+        |
+        | This option defines the default log channel that gets used when writing
+        | messages to the logs. The name specified in this option should match
+        | one of the channels defined in the "channels" configuration array.
+        |
+    */
+
+    'default' => env('LOG_CHANNEL', 'stack'),
+
+    /*
+        |--------------------------------------------------------------------------
+        | Deprecations Log Channel
+        |--------------------------------------------------------------------------
+        |
+        | This option controls the log channel that should be used to log warnings
+        | regarding deprecated PHP and library features. This allows you to get
+        | your application ready for upcoming major versions of dependencies.
+        |
+    */
+
+    'deprecations' => [
+        'channel' => env('LOG_DEPRECATIONS_CHANNEL', 'null'),
+        'trace' => false,
+    ],
+
+    /*
+        |--------------------------------------------------------------------------
+        | Log Channels
+        |--------------------------------------------------------------------------
+        |
+        | Here you may configure the log channels for your application. Out of
+        | the box, Laravel uses the Monolog PHP logging library. This gives
+        | you a variety of powerful log handlers / formatters to utilize.
+        |
+        | Available Drivers: "single", "daily", "slack", "syslog",
+        |                    "errorlog", "monolog",
+        |                    "custom", "stack"
+        |
+    */
+
+    'channels' => [
+        'stack' => [
+            'driver' => 'stack',
+            'channels' => ['single'],
+            'ignore_exceptions' => false,
+        ],
+
+        'single' => [
+            'driver' => 'single',
+            'path' => storage_path('logs/laravel.log'),
+            'level' => env('LOG_LEVEL', 'debug'),
+            'replace_placeholders' => true,
+        ],
+
+        'daily' => [
+            'driver' => 'daily',
+            'path' => storage_path('logs/laravel.log'),
+            'level' => env('LOG_LEVEL', 'debug'),
+            'days' => 14,
+            'replace_placeholders' => true,
+        ],
+
+        'slack' => [
+            'driver' => 'slack',
+            'url' => env('LOG_SLACK_WEBHOOK_URL'),
+            'username' => 'Laravel Log',
+            'emoji' => ':boom:',
+            'level' => env('LOG_LEVEL', 'critical'),
+            'replace_placeholders' => true,
+        ],
+
+        'papertrail' => [
+            'driver' => 'monolog',
+            'level' => env('LOG_LEVEL', 'debug'),
+            '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' => [
+            'driver' => 'monolog',
+            'level' => env('LOG_LEVEL', 'debug'),
+            'handler' => StreamHandler::class,
+            'formatter' => env('LOG_STDERR_FORMATTER'),
+            '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' => [
+            'driver' => 'monolog',
+            'handler' => NullHandler::class,
+        ],
+
+        '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,
+        ],
+
+    ],
+
+];

config/mail.php

@@ -0,0 +1,118 @@
+<?php
+
+return [
+
+    /*
+        |--------------------------------------------------------------------------
+        | Default Mailer
+        |--------------------------------------------------------------------------
+        |
+        | This option controls the default mailer that is used to send any email
+        | messages sent by your application. Alternative mailers may be setup
+        | and used as needed; however, this mailer will be used by default.
+        |
+    */
+
+    'default' => env('MAIL_MAILER', 'smtp'),
+
+    /*
+        |--------------------------------------------------------------------------
+        | Mailer Configurations
+        |--------------------------------------------------------------------------
+        |
+        | Here you may configure all of the mailers used by your application plus
+        | their respective settings. Several examples have been configured for
+        | you and you are free to add your own as your application requires.
+        |
+        | Laravel supports a variety of mail "transport" drivers to be used while
+        | sending an e-mail. You will specify which one you are using for your
+        | mailers below. You are free to add additional mailers as required.
+        |
+        | Supported: "smtp", "sendmail", "mailgun", "ses", "ses-v2",
+        |            "postmark", "log", "array", "failover"
+        |
+    */
+
+    'mailers' => [
+        'smtp' => [
+            'transport' => 'smtp',
+            'host' => env('MAIL_HOST', 'smtp.mailgun.org'),
+            'port' => env('MAIL_PORT', 587),
+            'encryption' => env('MAIL_ENCRYPTION', 'tls'),
+            'username' => env('MAIL_USERNAME'),
+            'password' => env('MAIL_PASSWORD'),
+            'timeout' => null,
+            'local_domain' => env('MAIL_EHLO_DOMAIN'),
+        ],
+
+        'ses' => [
+            'transport' => 'ses',
+        ],
+
+        'mailgun' => [
+            'transport' => 'mailgun'
+        ],
+
+        'postmark' => [
+            'transport' => 'postmark'
+        ],
+
+        'sendmail' => [
+            'transport' => 'sendmail',
+            'path' => env('MAIL_SENDMAIL_PATH', '/usr/sbin/sendmail -bs -i'),
+        ],
+
+        'log' => [
+            'transport' => 'log',
+            'channel' => env('MAIL_LOG_CHANNEL'),
+        ],
+
+        'array' => [
+            'transport' => 'array',
+        ],
+
+        'failover' => [
+            'transport' => 'failover',
+            'mailers' => [
+                'smtp',
+                'log',
+            ],
+        ],
+    ],
+
+    /*
+        |--------------------------------------------------------------------------
+        | Global "From" Address
+        |--------------------------------------------------------------------------
+        |
+        | You may wish for all e-mails sent by your application to be sent from
+        | the same address. Here, you may specify a name and address that is
+        | used globally for all e-mails that are sent by your application.
+        |
+    */
+
+    'from' => [
+        'address' => env('MAIL_FROM_ADDRESS', 'hello@example.com'),
+        'name' => env('MAIL_FROM_NAME', 'Example'),
+    ],
+
+    /*
+        |--------------------------------------------------------------------------
+        | Markdown Mail Settings
+        |--------------------------------------------------------------------------
+        |
+        | If you are using Markdown based email rendering, you may configure your
+        | theme and component paths here, allowing you to customize the design
+        | of the emails. Or, you may simply stick with the Laravel defaults!
+        |
+    */
+
+    'markdown' => [
+        'theme' => 'default',
+
+        'paths' => [
+            resource_path('views/vendor/mail'),
+        ],
+    ],
+
+];

config/purifier.php

@@ -0,0 +1,132 @@
+<?php
+
+/**
+ * Ok, glad you are here
+ * first we get a config instance, and set the settings
+ * $config = HTMLPurifier_Config::createDefault();
+ * $config->set('Core.Encoding', $this->config->get('purifier.encoding'));
+ * $config->set('Cache.SerializerPath', $this->config->get('purifier.cachePath'));
+ * if ( ! $this->config->get('purifier.finalize')) {
+ *     $config->autoFinalize = false;
+ * }
+ * $config->load [$this->getConfig());
+ *
+ * You must NOT delete the default settings
+ * anything in settings should be compacted with params that needed to instance HTMLPurifier_Config.
+ *
+ * @link http://htmlpurifier.org/live/configdoc/plain.html
+ */
+
+// phpcs:disable Generic.Files.LineLength.TooLong
+return [
+    'encoding'      => 'UTF-8',
+    'finalize'      => true,
+    'cachePath'     => storage_path('app/purifier'),
+    'cacheFileMode' => 0755,
+    'settings'      => [
+        'default' => [
+            'HTML.SafeIframe'          => true,
+            // * For iframes
+            'URI.SafeIframeRegexp'     => "%^(http://|https://|//)(www.youtube.com/embed/|player.vimeo.com/video/|vimeo.com/)%",
+            'HTML.Doctype'             => 'HTML 4.01 Transitional',
+            // * Legacy filter en full avec safe legacy.
+            // 'HTML.Allowed'             => 'h1[style|id],h2[style|id],h3[style|id],h4[style|id],h5[style|id],h6[style|id],figure[class|style],oembed[url],div[style],b,strong,i,em,u,s,pre,code[class],a[href|title|target|rel|id],ul[style],ol[style],dl[style],li,p[style],br,span[style|class],img[width|height|alt|src|style|class|title],iframe[src|width|height|class|frameborder|style],table[style|align|border|cellspacing|cellpadding|width],thead,tbody,th[colspan|align|valign|style],tr[align|valign|style],td[style|colspan|rowspan|scope|align|valign],hr,dl,dt,mark[class]',
+            // * Restricted basics.
+            'HTML.Allowed'             => 'br,p[style],b[style],u[style],i[style],a[href|title|target|rel],strong[style],span[class],ul[style],ol[style],li[style],h2[style],h3[style],h4[style],hr,blockquote[style]',
+            // * Legacy filter en full avec safe legacy.
+            // 'CSS.AllowedProperties'    => 'font,font-size,font-weight,font-style,font-family,text-decoration,padding-left,color,background-color,text-align,list-style-type,float,width,height,vertical-align,border,border-color,margin-left',
+            // * Restricted basics.
+            'CSS.AllowedProperties'    => 'text-align,margin-left',
+            'AutoFormat.AutoParagraph' => false,
+            'AutoFormat.RemoveEmpty'   => false,
+            'AutoFormat.RemoveEmpty.RemoveNbsp' => false,
+        ],
+        "youtube" => [
+            "HTML.SafeIframe"      => 'true',
+            "URI.SafeIframeRegexp" => "%^(http://|https://|//)(www.youtube.com/embed/|player.vimeo.com/video/|vimeo.com/)%",
+        ],
+        'custom_definition' => [
+            'id'  => 'html5-definitions',
+            'rev' => 1,
+            'debug' => true,
+            'elements' => [
+                // * http://developers.whatwg.org/sections.html
+                ['section', 'Block', 'Flow', 'Common'],
+                ['nav',     'Block', 'Flow', 'Common'],
+                ['article', 'Block', 'Flow', 'Common'],
+                ['aside',   'Block', 'Flow', 'Common'],
+                ['header',  'Block', 'Flow', 'Common'],
+                ['footer',  'Block', 'Flow', 'Common'],
+
+                // * Content model actually excludes several tags, not modelled here
+                ['address', 'Block', 'Flow', 'Common'],
+                ['hgroup', 'Block', 'Required: h1 | h2 | h3 | h4 | h5 | h6', 'Common'],
+
+                // * http://developers.whatwg.org/grouping-content.html
+                ['figure', 'Block', 'Optional: (figcaption, Flow) | (Flow, figcaption) | Flow', 'Common'],
+                ['figcaption', 'Inline', 'Flow', 'Common'],
+                ['oembed', 'Inline', 'Flow', 'Common'],
+
+                // * http://developers.whatwg.org/the-video-element.html#the-video-element
+                ['video', 'Block', 'Optional: (source, Flow) | (Flow, source) | Flow', 'Common', [
+                    'src' => 'URI',
+                    'type' => 'Text',
+                    'width' => 'Length',
+                    'height' => 'Length',
+                    'poster' => 'URI',
+                    'preload' => 'Enum#auto,metadata,none',
+                    'controls' => 'Bool',
+                ]],
+                ['source', 'Block', 'Flow', 'Common', [
+                    'src' => 'URI',
+                    'type' => 'Text',
+                ]],
+
+                // * http://developers.whatwg.org/text-level-semantics.html
+                ['s',    'Inline', 'Inline', 'Common'],
+                ['var',  'Inline', 'Inline', 'Common'],
+                ['sub',  'Inline', 'Inline', 'Common'],
+                ['sup',  'Inline', 'Inline', 'Common'],
+                ['mark', 'Inline', 'Inline', 'Common'],
+                ['wbr',  'Inline', 'Empty', 'Core'],
+
+                // * http://developers.whatwg.org/edits.html
+                ['ins', 'Block', 'Flow', 'Common', ['cite' => 'URI', 'datetime' => 'CDATA']],
+                ['del', 'Block', 'Flow', 'Common', ['cite' => 'URI', 'datetime' => 'CDATA']],
+            ],
+            'attributes' => [
+                ['iframe', 'allowfullscreen', 'Bool'],
+                ['table', 'height', 'Text'],
+                ['td', 'border', 'Text'],
+                ['th', 'border', 'Text'],
+                ['tr', 'width', 'Text'],
+                ['tr', 'height', 'Text'],
+                ['tr', 'border', 'Text'],
+                ['figure', 'class', 'Text'],
+                ['figure', 'style', 'Text'],
+                ['oembed', 'url', 'Text'],
+                ['span', 'style', 'Text'],
+                ['img', 'style', 'Text'],
+            ],
+        ],
+        'custom_attributes' => [
+            ['a', 'target', 'Enum#_blank,_self,_target,_top'],
+            ['a', 'id', 'Text'],
+            ['ol', 'style', 'Text'],
+            ['figure', 'style', 'Text'],
+            ['img', 'style', 'Text'],
+            ['span', 'style', 'Text'],
+            ['oembed', 'url', 'Text'],
+            ['h1', 'id', 'Text'],
+            ['h2', 'id', 'Text'],
+            ['h3', 'id', 'Text'],
+            ['h4', 'id', 'Text'],
+            ['h5', 'id', 'Text'],
+            ['h6', 'id', 'Text'],
+        ],
+        'custom_elements' => [
+            ['u', 'Inline', 'Inline', 'Common'],
+            ['oembed', 'Inline', 'Inline', 'Common'],
+        ],
+    ],
+];

config/queue.php

@@ -0,0 +1,109 @@
+<?php
+
+return [
+
+    /*
+        |--------------------------------------------------------------------------
+        | Default Queue Connection Name
+        |--------------------------------------------------------------------------
+        |
+        | Laravel's queue API supports an assortment of back-ends via a single
+        | API, giving you convenient access to each back-end using the same
+        | syntax for every one. Here you may define a default connection.
+        |
+    */
+
+    'default' => env('QUEUE_CONNECTION', 'sync'),
+
+    /*
+        |--------------------------------------------------------------------------
+        | Queue Connections
+        |--------------------------------------------------------------------------
+        |
+        | Here you may configure the connection information for each server that
+        | is used by your application. A default configuration has been added
+        | for each back-end shipped with Laravel. You are free to add more.
+        |
+        | Drivers: "sync", "database", "beanstalkd", "sqs", "redis", "null"
+        |
+    */
+
+    'connections' => [
+
+        'sync' => [
+            'driver' => 'sync',
+        ],
+
+        'database' => [
+            'driver' => 'database',
+            'table' => 'jobs',
+            'queue' => 'default',
+            'retry_after' => 90,
+            'after_commit' => false,
+        ],
+
+        'beanstalkd' => [
+            'driver' => 'beanstalkd',
+            'host' => 'localhost',
+            'queue' => 'default',
+            'retry_after' => 90,
+            'block_for' => 0,
+            'after_commit' => false,
+        ],
+
+        'sqs' => [
+            'driver' => 'sqs',
+            'key' => env('AWS_ACCESS_KEY_ID'),
+            'secret' => env('AWS_SECRET_ACCESS_KEY'),
+            'prefix' => env('SQS_PREFIX', 'https://sqs.us-east-1.amazonaws.com/your-account-id'),
+            'queue' => env('SQS_QUEUE', 'default'),
+            'suffix' => env('SQS_SUFFIX'),
+            'region' => env('AWS_DEFAULT_REGION', 'us-east-1'),
+            'after_commit' => false,
+        ],
+
+        'redis' => [
+            'driver' => 'redis',
+            'connection' => 'default',
+            'queue' => env('REDIS_QUEUE', 'default'),
+            'retry_after' => 90,
+            'block_for' => null,
+            'after_commit' => false,
+        ],
+
+    ],
+
+    /*
+        |--------------------------------------------------------------------------
+        | Job Batching
+        |--------------------------------------------------------------------------
+        |
+        | The following options configure the database and table that store job
+        | batching information. These options can be updated to any database
+        | connection and table which has been defined by your application.
+        |
+    */
+
+    'batching' => [
+        'database' => env('DB_CONNECTION', 'mysql'),
+        'table' => 'job_batches',
+    ],
+
+    /*
+        |--------------------------------------------------------------------------
+        | Failed Queue Jobs
+        |--------------------------------------------------------------------------
+        |
+        | These options configure the behavior of failed queue job logging so you
+        | can control which database and table are used to store the jobs that
+        | have failed. You may change them to any database / table you wish.
+        |
+    */
+
+    'failed' => [
+        'driver' => env('QUEUE_FAILED_DRIVER', 'database-uuids'),
+        'database' => env('DB_CONNECTION', 'mysql'),
+        'table' => 'failed_jobs',
+    ],
+
+];

config/sentry.php

@@ -0,0 +1,61 @@
+<?php
+
+return [
+
+    'dsn' => env('SENTRY_LARAVEL_DSN', env('SENTRY_DSN')),
+
+    // The release version of your application.
+    // Example with dynamic git hash: trim(exec('git --git-dir ' . base_path('.git') . ' log --pretty="%h" -n1 HEAD')).
+    'release' => env('SENTRY_RELEASE'),
+
+    // When left empty or `null` the Laravel environment will be used.
+    'environment' => env('SENTRY_ENVIRONMENT'),
+
+    'breadcrumbs' => [
+        // Capture Laravel logs in breadcrumbs.
+        'logs' => true,
+
+        // Capture SQL queries in breadcrumbs.
+        'sql_queries' => true,
+
+        // Capture bindings on SQL queries logged in breadcrumbs.
+        'sql_bindings' => false,
+
+        // Capture queue job information in breadcrumbs.
+        'queue_info' => true,
+
+        // Capture command information in breadcrumbs.
+        'command_info' => true,
+    ],
+
+    'tracing' => [
+        // Trace queue jobs as their own transactions.
+        'queue_job_transactions' => env('SENTRY_TRACE_QUEUE_ENABLED', false),
+
+        // Capture queue jobs as spans when executed on the sync driver.
+        'queue_jobs' => true,
+
+        // Capture SQL queries as spans.
+        'sql_queries' => true,
+
+        // Try to find out where the SQL query originated from and add it to the query spans.
+        'sql_origin' => true,
+
+        // Capture views as spans.
+        'views' => true,
+
+        // Indicates if the tracing integrations supplied by Sentry should be loaded.
+        'default_integrations' => true,
+
+        // Indicates that requests without a matching route should be traced.
+        'missing_routes' => false,
+    ],
+
+    // @see: https://docs.sentry.io/platforms/php/guides/laravel/configuration/options/#send-default-pii.
+    'send_default_pii' => env('SENTRY_SEND_DEFAULT_PII', false),
+
+    // @see: https://docs.sentry.io/platforms/php/guides/laravel/configuration/options/#traces-sample-rate.
+    'traces_sample_rate' => env('SENTRY_TRACES_SAMPLE_RATE') === null ? null : (float)env('SENTRY_TRACES_SAMPLE_RATE'),
+
+    'before_send' => [\App\Lib\Helpers\ExceptionsHelper::class, 'sentryEventHandler'],
+];

config/services.php

@@ -0,0 +1,34 @@
+<?php
+
+return [
+
+    /*
+        |--------------------------------------------------------------------------
+        | Third Party Services
+        |--------------------------------------------------------------------------
+        |
+        | This file is for storing the credentials for third party services such
+        | as Mailgun, Postmark, AWS and more. This file provides the de facto
+        | location for this type of information, allowing packages to have
+        | a conventional file to locate the various service credentials.
+        |
+    */
+
+    'mailgun' => [
+        'domain' => env('MAILGUN_DOMAIN'),
+        'secret' => env('MAILGUN_SECRET'),
+        'endpoint' => env('MAILGUN_ENDPOINT', 'api.mailgun.net'),
+        'scheme' => 'https',
+    ],
+
+    'postmark' => [
+        'token' => env('POSTMARK_TOKEN'),
+    ],
+
+    'ses' => [
+        'key' => env('AWS_ACCESS_KEY_ID'),
+        'secret' => env('AWS_SECRET_ACCESS_KEY'),
+        'region' => env('AWS_DEFAULT_REGION', 'us-east-1'),
+    ],
+
+];

config/session.php

@@ -0,0 +1,201 @@
+<?php
+
+use Illuminate\Support\Str;
+
+return [
+
+    /*
+        |--------------------------------------------------------------------------
+        | Default Session Driver
+        |--------------------------------------------------------------------------
+        |
+        | This option controls the default session "driver" that will be used on
+        | requests. By default, we will use the lightweight native driver but
+        | you may specify any of the other wonderful drivers provided here.
+        |
+        | Supported: "file", "cookie", "database", "apc",
+        |            "memcached", "redis", "dynamodb", "array"
+        |
+    */
+
+    'driver' => env('SESSION_DRIVER', 'file'),
+
+    /*
+        |--------------------------------------------------------------------------
+        | Session Lifetime
+        |--------------------------------------------------------------------------
+        |
+        | Here you may specify the number of minutes that you wish the session
+        | to be allowed to remain idle before it expires. If you want them
+        | to immediately expire on the browser closing, set that option.
+        |
+    */
+
+    'lifetime' => env('SESSION_LIFETIME', 120),
+
+    'expire_on_close' => false,
+
+    /*
+        |--------------------------------------------------------------------------
+        | Session Encryption
+        |--------------------------------------------------------------------------
+        |
+        | This option allows you to easily specify that all of your session data
+        | should be encrypted before it is stored. All encryption will be run
+        | automatically by Laravel and you can use the Session like normal.
+        |
+    */
+
+    'encrypt' => false,
+
+    /*
+        |--------------------------------------------------------------------------
+        | Session File Location
+        |--------------------------------------------------------------------------
+        |
+        | When using the native session driver, we need a location where session
+        | files may be stored. A default has been set for you but a different
+        | location may be specified. This is only needed for file sessions.
+        |
+    */
+
+    'files' => storage_path('framework/sessions'),
+
+    /*
+        |--------------------------------------------------------------------------
+        | Session Database Connection
+        |--------------------------------------------------------------------------
+        |
+        | When using the "database" or "redis" session drivers, you may specify a
+        | connection that should be used to manage these sessions. This should
+        | correspond to a connection in your database configuration options.
+        |
+    */
+
+    'connection' => env('SESSION_CONNECTION'),
+
+    /*
+        |--------------------------------------------------------------------------
+        | Session Database Table
+        |--------------------------------------------------------------------------
+        |
+        | When using the "database" session driver, you may specify the table we
+        | should use to manage the sessions. Of course, a sensible default is
+        | provided for you; however, you are free to change this as needed.
+        |
+    */
+
+    'table' => 'sessions',
+
+    /*
+        |--------------------------------------------------------------------------
+        | Session Cache Store
+        |--------------------------------------------------------------------------
+        |
+        | While using one of the framework's cache driven session backends you may
+        | list a cache store that should be used for these sessions. This value
+        | must match with one of the application's configured cache "stores".
+        |
+        | Affects: "apc", "dynamodb", "memcached", "redis"
+        |
+    */
+
+    'store' => env('SESSION_STORE'),
+
+    /*
+        |--------------------------------------------------------------------------
+        | Session Sweeping Lottery
+        |--------------------------------------------------------------------------
+        |
+        | Some session drivers must manually sweep their storage location to get
+        | rid of old sessions from storage. Here are the chances that it will
+        | happen on a given request. By default, the odds are 2 out of 100.
+        |
+    */
+
+    'lottery' => [2, 100],
+
+    /*
+        |--------------------------------------------------------------------------
+        | Session Cookie Name
+        |--------------------------------------------------------------------------
+        |
+        | Here you may change the name of the cookie used to identify a session
+        | instance by ID. The name specified here will get used every time a
+        | new session cookie is created by the framework for every driver.
+        |
+    */
+
+    'cookie' => env(
+        'SESSION_COOKIE',
+        Str::slug(env('APP_NAME', 'laravel'), '_') . '_session'
+    ),
+
+    /*
+        |--------------------------------------------------------------------------
+        | Session Cookie Path
+        |--------------------------------------------------------------------------
+        |
+        | The session cookie path determines the path for which the cookie will
+        | be regarded as available. Typically, this will be the root path of
+        | your application but you are free to change this when necessary.
+        |
+    */
+
+    'path' => '/',
+
+    /*
+        |--------------------------------------------------------------------------
+        | Session Cookie Domain
+        |--------------------------------------------------------------------------
+        |
+        | Here you may change the domain of the cookie used to identify a session
+        | in your application. This will determine which domains the cookie is
+        | available to in your application. A sensible default has been set.
+        |
+    */
+
+    'domain' => env('SESSION_DOMAIN'),
+
+    /*
+        |--------------------------------------------------------------------------
+        | HTTPS Only Cookies
+        |--------------------------------------------------------------------------
+        |
+        | By setting this option to true, session cookies will only be sent back
+        | to the server if the browser has a HTTPS connection. This will keep
+        | the cookie from being sent to you when it can't be done securely.
+        |
+    */
+
+    'secure' => env('SESSION_SECURE_COOKIE'),
+
+    /*
+        |--------------------------------------------------------------------------
+        | HTTP Access Only
+        |--------------------------------------------------------------------------
+        |
+        | Setting this value to true will prevent JavaScript from accessing the
+        | value of the cookie and the cookie will only be accessible through
+        | the HTTP protocol. You are free to modify this option if needed.
+        |
+    */
+
+    'http_only' => true,
+
+    /*
+        |--------------------------------------------------------------------------
+        | Same-Site Cookies
+        |--------------------------------------------------------------------------
+        |
+        | This option determines how your cookies behave when cross-site requests
+        | take place, and can be used to mitigate CSRF attacks. By default, we
+        | will set this value to "lax" since this is a secure default value.
+        |
+        | Supported: "lax", "strict", "none", null
+        |
+    */
+
+    'same_site' => 'lax',
+
+];

config/view.php

@@ -0,0 +1,38 @@
+<?php
+
+return [
+
+    /*
+        |--------------------------------------------------------------------------
+        | View Storage Paths
+        |--------------------------------------------------------------------------
+        |
+        | Most templating systems load templates from disk. Here you may specify
+        | an array of paths that should be checked for your views. Of course
+        | the usual Laravel view path has already been registered for you.
+        |
+    */
+
+    'paths' => [
+        resource_path('views'),
+        // ! for vendor publish (mail notifications par ex)
+        resource_path('views/vendor'),
+    ],
+
+    /*
+        |--------------------------------------------------------------------------
+        | Compiled View Path
+        |--------------------------------------------------------------------------
+        |
+        | This option determines where all the compiled Blade templates will be
+        | stored for your application. Typically, this is within the storage
+        | directory. However, as usual, you are free to change this value.
+        |
+    */
+
+    'compiled' => env(
+        'VIEW_COMPILED_PATH',
+        realpath(storage_path('framework/views'))
+    ),
+
+];

database/.gitignore

@@ -0,0 +1 @@
+*.sqlite*

database/factories/UserFactory.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace Database\Factories;
+
+use App\Enums\Users\RoleEnum;
+use Illuminate\Database\Eloquent\Factories\Factory;
+use Illuminate\Support\Str;
+
+class UserFactory extends Factory
+{
+    /**
+     * Define the model's default state.
+     *
+     * @return array<string, mixed>
+     */
+    public function definition()
+    {
+        $published = $this->faker->boolean(75);
+        return [
+            'first_name'         => fake()->firstname(),
+            'last_name'          => fake()->lastname(),
+            'email'             => fake()->unique()->safeEmail(),
+            'email_verified_at' => now(),
+            'password'          => '$2y$10$92IXUNpkjO0rOQ5byMi.Ye4oKoEa3Ro9llC/.og/at2.uheWG/igi',
+            'remember_token'    => Str::random(10),
+            'role'              => \collect(RoleEnum::toArray())->random()->value,
+            'published'         => $published,
+            'published_at'      => ($published) ? now() : null,
+        ];
+    }
+
+    /**
+     * Indicate that the model's email address should be unverified.
+     *
+     * @return static
+     */
+    public function unverified(): static
+    {
+        // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.FoundInExtendedClass
+        return $this->state(fn (array $attributes) => [
+            'email_verified_at' => null,
+        ]);
+    }
+}

database/migrations/2014_10_12_000000_create_users_table.php

@@ -0,0 +1,40 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     *
+     * @return void
+     */
+    public function up()
+    {
+        Schema::create('users', function (Blueprint $table) {
+            $table->id();
+            $table->string('first_name')->comment('First name of the user.');
+            $table->string('last_name')->comment('Last name of the user.');
+            $table->string('email')->unique()->comment('Email of the user.');
+            $table->timestamp('email_verified_at')->nullable();
+            $table->string('password')->comment('Password of the user account.');
+            $table->rememberToken();
+            $table->boolean('role')->comment('Role of the user who defines the rights/access.');
+            $table->boolean('published')->comment('The user is acivated or not.');
+            $table->timestamp('published_at')->nullable()->comment('The date on which the user was acivated.');
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     *
+     * @return void
+     */
+    public function down()
+    {
+        Schema::dropIfExists('users');
+    }
+};

database/migrations/2014_10_12_100000_create_password_resets_table.php

@@ -0,0 +1,32 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     *
+     * @return void
+     */
+    public function up()
+    {
+        Schema::create('password_resets', function (Blueprint $table) {
+            $table->string('email')->index();
+            $table->string('token');
+            $table->timestamp('created_at')->nullable();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     *
+     * @return void
+     */
+    public function down()
+    {
+        Schema::dropIfExists('password_resets');
+    }
+};

database/migrations/2019_08_19_000000_create_failed_jobs_table.php

@@ -0,0 +1,36 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     *
+     * @return void
+     */
+    public function up()
+    {
+        Schema::create('failed_jobs', function (Blueprint $table) {
+            $table->id();
+            $table->string('uuid')->unique();
+            $table->text('connection');
+            $table->text('queue');
+            $table->longText('payload');
+            $table->longText('exception');
+            $table->timestamp('failed_at')->useCurrent();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     *
+     * @return void
+     */
+    public function down()
+    {
+        Schema::dropIfExists('failed_jobs');
+    }
+};

database/migrations/2021_11_19_102529_create_jobs_table.php

@@ -0,0 +1,36 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+class CreateJobsTable extends Migration
+{
+    /**
+     * Run the migrations.
+     *
+     * @return void
+     */
+    public function up()
+    {
+        Schema::create('jobs', function (Blueprint $table) {
+            $table->bigIncrements('id');
+            $table->string('queue')->index();
+            $table->longText('payload');
+            $table->unsignedTinyInteger('attempts');
+            $table->unsignedInteger('reserved_at')->nullable();
+            $table->unsignedInteger('available_at');
+            $table->unsignedInteger('created_at');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     *
+     * @return void
+     */
+    public function down()
+    {
+        Schema::dropIfExists('jobs');
+    }
+}

database/migrations/2023_09_08_102717_create_actitivy_logs_table.php

@@ -0,0 +1,39 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     *
+     * @return void
+     */
+    public function up(): void
+    {
+        Schema::create('activity_logs', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('user_id')->nullable()->constrained('users')
+                ->comment('Id of the user associated, or nullable for a deleted user.');
+            $table->boolean('is_anonymous')->comment('If there is no user connected when action was realised.');
+            $table->boolean('is_console')->comment('If the action was realised in console.');
+            $table->string('model_class')->comment('Target model.');
+            $table->integer('model_id')->comment('Id of the target model.');
+            $table->integer('event')->comment('Event of this activity (ActivityLogsEventEnum).');
+            $table->json('data')->nullable()->comment('List of changes (old and new values).');
+            $table->timestamp('created_at')->comment('The date on which the user was published.');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     *
+     * @return void
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('activity_logs');
+    }
+};

database/seeders/DatabaseSeeder.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace Database\Seeders;
+
+use Illuminate\Database\Seeder;
+
+class DatabaseSeeder extends Seeder
+{
+    /**
+     * Seed the application's database.
+     *
+     * @return void
+     */
+    public function run()
+    {
+        $this->call([
+            UserSeeder::class,
+        ]);
+    }
+}

database/seeders/UserSeeder.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace Database\Seeders;
+
+use App\Models\User;
+use Illuminate\Database\Seeder;
+
+class UserSeeder extends Seeder
+{
+    /**
+     * Run the database seeds.
+     *
+     * @return void
+     */
+    public function run()
+    {
+        User::factory(20)->create();
+    }
+}

jsconfig.json

@@ -0,0 +1,3 @@
+{
+    "include": ["./resources/js/**/*"]
+}

package.json

@@ -0,0 +1,54 @@
+{
+    "private": true,
+    "scripts": {
+        "prod": "vite build --mode production",
+        "dev": "NODE_ENV=development vite build -d --mode development",
+        "watch": "NODE_ENV=development vite build --mode development --watch",
+        "eslint": "node ./node_modules/.bin/eslint --max-warnings 0 -c .eslintrc.json ./resources",
+        "eslint-fix": "node ./node_modules/.bin/eslint --fix --max-warnings 0 -c .eslintrc.json ./resources",
+        "eslint-ci": "node ./node_modules/.bin/eslint --max-warnings 0 -c .eslintrc.json ./resources -f junit",
+        "stylelint": "node ./node_modules/.bin/stylelint --config './.stylelintrc.json' --max-warnings 0 '**/resources/**/*.scss'",
+        "stylelint-fix": "node ./node_modules/.bin/stylelint --config './.stylelintrc.json' --fix --max-warnings 0 '**/resources/**/*.scss'",
+        "stylelint-ci": "node ./node_modules/.bin/stylelint --config './.stylelintrc.json' --max-warnings 0 '**/resources/**/*.scss' -f json"
+    },
+    "devDependencies": {
+        "@fortawesome/fontawesome-svg-core": "latest",
+        "@fortawesome/free-brands-svg-icons": "latest",
+        "@fortawesome/free-regular-svg-icons": "latest",
+        "@fortawesome/free-solid-svg-icons": "latest",
+        "@fortawesome/vue-fontawesome": "^3.0.3",
+        "@sipec/vue3-tags-input": "^3.0.4",
+        "@types/bootstrap": "^5.2.7",
+        "@types/node": "^20.8.2",
+        "@types/toastify-js": "^1.12.1",
+        "@vitejs/plugin-legacy": "latest",
+        "@vitejs/plugin-vue": "latest",
+        "@vue/compiler-sfc": "latest",
+        "@vue/eslint-config-typescript": "latest",
+        "@vue/tsconfig": "latest",
+        "axios": "^1.5.1",
+        "bootstrap": "^5.3.2",
+        "chart.js": "^4.4.0",
+        "cropperjs": "^1.6.1",
+        "eslint": "latest",
+        "eslint-plugin-vue": "latest",
+        "laravel-vite-plugin": "latest",
+        "postcss-discard-comments": "^6.0.0",
+        "prettier": "latest",
+        "print-js": "^1.6.0",
+        "sass": "latest",
+        "slugify": "^1.6.6",
+        "stylelint-config-idiomatic-order": "github:ream88/stylelint-config-idiomatic-order",
+        "stylelint-config-sass-guidelines": "latest",
+        "stylelint-config-standard-scss": "latest",
+        "sweetalert2": "^11.7.31",
+        "terser": "latest",
+        "toastify-js": "^1.12.0",
+        "typescript": "latest",
+        "vite-plugin-checker": "latest",
+        "vite-plugin-eslint": "latest",
+        "vite-plugin-stylelint": "latest",
+        "vue": "latest",
+        "vue-tsc": "1.6.0"
+    }
+}

phpcs.xml

@@ -0,0 +1,129 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ruleset name="LDC Laravel"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="vendor/squizlabs/php_codesniffer/phpcs.xsd">
+    <description>Created with the PHP Coding Standard Generator. http://edorian.github.com/php-coding-standard-generator/</description>
+    <arg name="colors" />
+    <arg name="extensions" value="php" />
+    <file>app/</file>
+    <file>config/</file>
+    <file>database/factories</file>
+    <file>routes/</file>
+    <rule ref="PSR1" />
+    <rule ref="PSR12" />
+
+    <rule ref="Generic.Classes.DuplicateClassName"/>
+    <rule ref="Generic.CodeAnalysis.EmptyStatement"/>
+    <rule ref="Generic.CodeAnalysis.ForLoopShouldBeWhileLoop"/>
+    <rule ref="Generic.CodeAnalysis.ForLoopWithTestFunctionCall"/>
+    <rule ref="Generic.CodeAnalysis.JumbledIncrementer"/>
+    <rule ref="Generic.CodeAnalysis.UnconditionalIfStatement"/>
+    <rule ref="Generic.CodeAnalysis.UnnecessaryFinalModifier"/>
+    <rule ref="Generic.CodeAnalysis.UnusedFunctionParameter"/>
+    <rule ref="Generic.CodeAnalysis.UselessOverridingMethod"/>
+    <rule ref="Generic.Commenting.DocComment.SpacingBeforeTags"/>
+    <rule ref="Generic.Commenting.Todo"/>
+    <rule ref="Generic.Commenting.Fixme"/>
+    <rule ref="Generic.ControlStructures.InlineControlStructure"/>
+    <rule ref="Generic.Files.ByteOrderMark"/>
+    <rule ref="Generic.Files.LineEndings"/>
+    <rule ref="Generic.Files.LineLength"/>
+    <rule ref="Generic.Formatting.DisallowMultipleStatements"/>
+    <rule ref="Generic.Formatting.MultipleStatementAlignment"/>
+    <rule ref="Generic.Formatting.NoSpaceAfterCast"/>
+    <rule ref="Generic.Functions.CallTimePassByReference"/>
+    <rule ref="Generic.Functions.FunctionCallArgumentSpacing"/>
+    <rule ref="Generic.Metrics.CyclomaticComplexity"/>
+    <rule ref="Generic.Metrics.NestingLevel"/>
+    <rule ref="Generic.NamingConventions.ConstructorName"/>
+    <rule ref="Generic.NamingConventions.UpperCaseConstantName"/>
+    <rule ref="Generic.NamingConventions.CamelCapsFunctionName"/>
+    <rule ref="Generic.PHP.DeprecatedFunctions"/>
+    <rule ref="Generic.PHP.DisallowShortOpenTag"/>
+    <rule ref="Generic.PHP.ForbiddenFunctions"/>
+    <rule ref="Generic.PHP.NoSilencedErrors"/>
+    <rule ref="Generic.Strings.UnnecessaryStringConcat"/>
+    <rule ref="Generic.WhiteSpace.DisallowTabIndent"/>
+    <rule ref="Generic.WhiteSpace.ScopeIndent"/>
+    <rule ref="MySource.PHP.EvalObjectFactory"/>
+    <rule ref="MySource.PHP.GetRequestData"/>
+    <rule ref="MySource.PHP.AjaxNullComparison"/>
+    <rule ref="PEAR.Classes.ClassDeclaration"/>
+    <rule ref="PEAR.Commenting.InlineComment"/>
+    <rule ref="PSR1.Classes.ClassDeclaration"/>
+    <rule ref="PSR1.Files.SideEffects"/>
+    <rule ref="PSR2.Classes.ClassDeclaration"/>
+    <rule ref="PSR2.Classes.PropertyDeclaration"/>
+    <rule ref="PSR2.ControlStructures.ElseIfDeclaration"/>
+    <rule ref="PSR2.ControlStructures.SwitchDeclaration"/>
+    <rule ref="PSR2.Files.EndFileNewline"/>
+    <rule ref="PSR2.Methods.MethodDeclaration"/>
+    <rule ref="PSR2.Namespaces.NamespaceDeclaration"/>
+    <rule ref="PSR2.Namespaces.UseDeclaration"/>
+    <rule ref="Squiz.PHP.CommentedOutCode"/>
+    <rule ref="Squiz.PHP.DisallowMultipleAssignments">
+        <exclude name="Squiz.PHP.DisallowMultipleAssignments.FoundInControlStructure" />
+    </rule>
+    <rule ref="Squiz.PHP.DisallowSizeFunctionsInLoops"/>
+
+    <rule ref="Squiz.PHP.DiscouragedFunctions">
+        <properties>
+            <property name="error" value="true"/>
+        </properties>
+    </rule>
+    <rule ref="Squiz.PHP.Eval"/>
+    <rule ref="Squiz.PHP.GlobalKeyword"/>
+    <rule ref="Squiz.PHP.Heredoc"/>
+    <rule ref="Squiz.PHP.InnerFunctions"/>
+    <rule ref="Squiz.PHP.LowercasePHPFunctions"/>
+    <rule ref="Squiz.PHP.NonExecutableCode"/>
+    <rule ref="Squiz.Scope.MemberVarScope"/>
+    <rule ref="Squiz.Scope.MethodScope"/>
+    <rule ref="Squiz.Scope.StaticThisUsage"/>
+    <rule ref="Squiz.WhiteSpace.LanguageConstructSpacing"/>
+    <rule ref="Squiz.WhiteSpace.LogicalOperatorSpacing"/>
+    <rule ref="Squiz.WhiteSpace.MemberVarSpacing">
+        <properties>
+            <property name="spacingBeforeFirst " value="false"/>
+        </properties>
+    </rule>
+    <rule ref="Squiz.WhiteSpace.OperatorSpacing">
+        <properties>
+            <property name="ignoreNewlines" value="true"/>
+        </properties>
+    </rule>
+    <rule ref="Squiz.WhiteSpace.ObjectOperatorSpacing">
+        <properties>
+            <property name="ignoreNewlines" value="true"/>
+        </properties>
+    </rule>
+    <rule ref="Squiz.WhiteSpace.ScopeKeywordSpacing"/>
+    <rule ref="Squiz.WhiteSpace.SemicolonSpacing"/>
+    <rule ref="Squiz.Commenting.BlockComment">
+        <exclude name="Squiz.Commenting.BlockComment.WrongStart" />
+    </rule>
+    <rule ref="Squiz.Commenting.ClassComment">
+        <exclude name="Squiz.Commenting.ClassComment.Missing" />
+        <exclude name="Squiz.Commenting.ClassComment.TagNotAllowed" />
+    </rule>
+    <rule ref="Squiz.Commenting.DocCommentAlignment"/>
+    <rule ref="Squiz.Commenting.EmptyCatchComment"/>
+    <rule ref="Squiz.Commenting.FunctionComment">
+        <exclude name="Squiz.Commenting.FunctionComment.MissingParamComment" />
+    </rule>
+    <rule ref="Squiz.Commenting.FunctionCommentThrowTag"/>
+    <rule ref="Squiz.Commenting.InlineComment">
+        <exclude name="Squiz.Commenting.InlineComment.DocBlock" />
+    </rule>
+    <rule ref="Squiz.Commenting.LongConditionClosingComment">
+        <exclude name="Squiz.Commenting.LongConditionClosingComment.SpacingBefore" />
+    </rule>
+    <rule ref="Squiz.Commenting.PostStatementComment"/>
+    <rule ref="Squiz.Commenting.VariableComment"/>
+    <rule ref="SlevomatCodingStandard.Namespaces.UnusedUses.UnusedUse" />
+
+    <!-- For Laravel migrations -->
+    <rule ref="PSR1.Classes.ClassDeclaration.MissingNamespace">
+        <exclude-pattern>*/database/migrations/*</exclude-pattern>
+    </rule>
+
+</ruleset>

phpunit.xml

@@ -0,0 +1,31 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:noNamespaceSchemaLocation="./vendor/phpunit/phpunit/phpunit.xsd"
+         bootstrap="vendor/autoload.php"
+         colors="true"
+>
+    <testsuites>
+        <testsuite name="Unit">
+            <directory suffix="Test.php">./tests/Unit</directory>
+        </testsuite>
+        <testsuite name="Feature">
+            <directory suffix="Test.php">./tests/Feature</directory>
+        </testsuite>
+    </testsuites>
+    <coverage>
+        <include>
+            <directory suffix=".php">./app</directory>
+        </include>
+    </coverage>
+    <php>
+        <env name="APP_ENV" value="testing"/>
+        <env name="BCRYPT_ROUNDS" value="4"/>
+        <env name="CACHE_DRIVER" value="array"/>
+        <!-- <env name="DB_CONNECTION" value="sqlite"/> -->
+        <!-- <env name="DB_DATABASE" value=":memory:"/> -->
+        <env name="MAIL_MAILER" value="array"/>
+        <env name="QUEUE_CONNECTION" value="sync"/>
+        <env name="SESSION_DRIVER" value="array"/>
+        <env name="TELESCOPE_ENABLED" value="false"/>
+    </php>
+</phpunit>

public/.htaccess

@@ -0,0 +1,21 @@
+<IfModule mod_rewrite.c>
+    <IfModule mod_negotiation.c>
+        Options -MultiViews -Indexes
+    </IfModule>
+
+    RewriteEngine On
+
+    # Handle Authorization Header
+    RewriteCond %{HTTP:Authorization} .
+    RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
+
+    # Redirect Trailing Slashes If Not A Folder...
+    RewriteCond %{REQUEST_FILENAME} !-d
+    RewriteCond %{REQUEST_URI} (.+)/$
+    RewriteRule ^ %1 [L,R=301]
+
+    # Send Requests To Front Controller...
+    RewriteCond %{REQUEST_FILENAME} !-d
+    RewriteCond %{REQUEST_FILENAME} !-f
+    RewriteRule ^ index.php [L]
+</IfModule>