Merge branch 'feature/csv_exports' into 'develop'

Export CSV feature

See merge request !1

.devTools/routes.txt

+
+  GET|HEAD  / ................................................................................................................................................................................................................................................................................................... home
+  POST      _ignition/execute-solution ................................................................................................................................................................................................. ignition.executeSolution › Spatie\LaravelIgnition › ExecuteSolutionController
+  GET|HEAD  _ignition/health-check ............................................................................................................................................................................................................. ignition.healthCheck › Spatie\LaravelIgnition › HealthCheckController
+  POST      _ignition/update-config .......................................................................................................................................................................................................... ignition.updateConfig › Spatie\LaravelIgnition › UpdateConfigController
+  GET|HEAD  api/dangers .................................................................................................................................................................................................................................................. api.dangers.all › Api\DangersController@all
+  GET|HEAD  api/evaluations ...................................................................................................................................................................................................................................... api.evaluations.all › Api\EvaluationsController@all
+  POST      api/evaluations .................................................................................................................................................................................................................................... api.evaluations.post › Api\EvaluationsController@save
+  PUT       api/evaluations/{id} ................................................................................................................................................................................................................................ api.evaluations.put › Api\EvaluationsController@save
+  GET|HEAD  api/evaluations/{id} ................................................................................................................................................................................................................................. api.evaluations.get › Api\EvaluationsController@get
+  DELETE    api/evaluations/{id} ........................................................................................................................................................................................................................... api.evaluations.delete › Api\EvaluationsController@delete
+  GET|HEAD  api/evaluations/{id}/graphs/attack ......................................................................................................................................................................................................... api.evaluations.graph.attack › Api\GraphDataController@attack
+  GET|HEAD  api/evaluations/{id}/graphs/best_measures ..................................................................................................................................................................................... api.evaluations.graph.best_measures › Api\GraphDataController@bestMeasures
+  GET|HEAD  api/evaluations/{id}/graphs/exposition ............................................................................................................................................................................................. api.evaluations.graph.exposition › Api\GraphDataController@exposition
+  GET|HEAD  api/evaluations/{id}/graphs/futurerisks .......................................................................................................................................................................................... api.evaluations.graph.futurerisks › Api\GraphDataController@futurerisks
+  GET|HEAD  api/evaluations/{id}/graphs/maturity ................................................................................................................................................................................................... api.evaluations.graph.maturity › Api\GraphDataController@maturity
+  GET|HEAD  api/evaluations/{id}/graphs/measures ................................................................................................................................................................................................... api.evaluations.graph.measures › Api\GraphDataController@measures
+  GET|HEAD  api/evaluations/{id}/graphs/risks ............................................................................................................................................................................................................ api.evaluations.graph.risks › Api\GraphDataController@risks
+  POST      api/forgetpwd .............................................................................................................................................................................................................................................. api.forgetpwd › Api\UsersController@forgetpwd
+  GET|HEAD  api/graphs/actionterritory ............................................................................................................................................................................................... api.evaluations.graph.actionterritory › Api\GraphDataController@actionterritory
+  GET|HEAD  api/graphs/organizations/{territory_id?} ..................................................................................................................................................................................... api.evaluations.graph.organizations › Api\GraphDataController@organizations
+  POST      api/impersonate ....................................................................................................................................................................................................................................... api.impersonate › Auth\LoginController@impersonate
+  POST      api/leave ............................................................................................................................................................................................................................... api.leaveImpersonation › Auth\LoginController@leaveImpersonation
+  GET|HEAD  api/measures ............................................................................................................................................................................................................................................... api.measures.all › Api\MeasuresController@all
+  GET|HEAD  api/measures/download ...................................................................................................................................................................................................................... api.measures.downloadAll › Api\MeasuresController@downloadAll
+  GET|HEAD  api/measures/download/{id} ....................................................................................................................................................................................................................... api.measures.download › Api\MeasuresController@download
+  PUT       api/measures/{id} ......................................................................................................................................................................................................................................... api.measures.put › Api\MeasuresController@save
+  GET|HEAD  api/organizations ................................................................................................................................................................................................................................ api.organizations.all › Api\OrganizationsController@all
+  POST      api/organizations .............................................................................................................................................................................................................................. api.organizations.post › Api\OrganizationsController@save
+  PUT       api/organizations/{id} .......................................................................................................................................................................................................................... api.organizations.put › Api\OrganizationsController@save
+  DELETE    api/organizations/{id} ..................................................................................................................................................................................................................... api.organizations.delete › Api\OrganizationsController@delete
+  GET|HEAD  api/questions .............................................................................................................................................................................................................................................. api.maturity.all › Api\MaturityController@all
+  GET|HEAD  api/scenarios ............................................................................................................................................................................................................................................ api.scenarios.all › Api\ScenariosController@all
+  GET|HEAD  api/territories ...................................................................................................................................................................................................................................... api.territories.all › Api\TerritoriesController@all
+  POST      api/territories .................................................................................................................................................................................................................................... api.territories.post › Api\TerritoriesController@save
+  PUT       api/territories/{id} ................................................................................................................................................................................................................................ api.territories.put › Api\TerritoriesController@save
+  DELETE    api/territories/{id} ........................................................................................................................................................................................................................... api.territories.delete › Api\TerritoriesController@delete
+  GET|HEAD  api/users ........................................................................................................................................................................................................................................................ api.users.all › Api\UsersController@all
+  POST      api/users ...................................................................................................................................................................................................................................................... api.users.post › Api\UsersController@save
+  GET|HEAD  api/users/me ....................................................................................................................................................................................................................................................... api.users.me › Api\UsersController@me
+  PUT       api/users/{id} .................................................................................................................................................................................................................................................. api.users.put › Api\UsersController@save
+  DELETE    api/users/{id} ............................................................................................................................................................................................................................................. api.users.delete › Api\UsersController@delete
+  GET|HEAD  export/evaluations.{ext} ............................................................................................................................................................................................................................... export.evaluations › ExportController@evaluations
+  GET|HEAD  export/structures.{ext} ............................................................................................................................................................................................................................ export.organizations › ExportController@organizations
+  POST      login ................................................................................................................................................................................................................................................................. login › Auth\LoginController@login
+  GET|HEAD  login .................................................................................................................................................................................................................................................................................................... 
+  GET|HEAD  logout ............................................................................................................................................................................................................................................................. logout › Auth\LogoutController@logout
+  POST      newpassword .......................................................................................................................................................................................................................................... password_reset.send › UsersController@storePassword
+  GET|HEAD  newpassword/{id}/{reset_token} ........................................................................................................................................................................................................................... password_reset › UsersController@createPassword
+  GET|HEAD  pdf/dossierCyberSecurite/{organization_id}/{evaluation_id?} ........................................................................................................................................................................... pdf.dossier_cyber_securite › PdfController@DossierCyberSecuritePdf
+  GET|HEAD  pdf/planAction/{organization_id} ........................................................................................................................................................................................................................... pdf.plan_action › PdfController@ActionPlanPdf
+  GET|HEAD  pdf/politiqueSecurite/{organization_id} ...................................................................................................................................................................................................... pdf.politique_securite › PdfController@PolitiqueSecuritePdf
+  GET|HEAD  sanctum/csrf-cookie .......................................................................................................................................................................................................................................... Laravel\Sanctum › CsrfCookieController@show
+  GET|HEAD  {any} .................................................................................................................................................................................................................................................................................................... 
+
+                                                                                                                                                                                                                                                                                                   Showing [53] routes
+

.devTools/scripts/dump-routes.sh

+#!/bin/bash
+
+cd ../..
+./artisan route:list --no-ansi > ./.devTools/routes.txt

.devTools/scripts/ide-helper.sh

+#!/bin/bash
+
+cd ../..
+./vendor/bin/sail artisan ide-helper:generate
+./vendor/bin/sail artisan ide-helper:meta
+./vendor/bin/sail artisan ide-helper:models -W
+./vendor/bin/php-cs-fixer fix ./app/Models

.env.docker

+APP_NAME="Madis Cyber"
+APP_ENV=local
+APP_KEY=base64:wJlBLhzTz0XSp8HoFwb/4z4QsG7Ad8H++FjURNhSxtU=
+APP_DEBUG=true
+APP_URL=http://madis-cyber.test
+
+LOG_CHANNEL=stack
+LOG_DEPRECATIONS_CHANNEL=null
+LOG_LEVEL=debug
+
+DB_CONNECTION=mysql
+DB_HOST=mysql
+DB_PORT=3306
+DB_DATABASE=laravel
+DB_USERNAME=sail
+DB_PASSWORD=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=redis
+REDIS_PASSWORD=null
+REDIS_PORT=6379
+
+MAIL_DRIVER=smtp
+MAIL_MAILER=smtp
+MAIL_HOST=mailhog
+MAIL_PORT=1025
+MAIL_USERNAME=null
+MAIL_PASSWORD=null
+MAIL_ENCRYPTION=null
+
+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_APP_CLUSTER=mt1
+
+MIX_PUSHER_APP_KEY="${PUSHER_APP_KEY}"
+MIX_PUSHER_APP_CLUSTER="${PUSHER_APP_CLUSTER}"
+
+SANCTUM_STATEFUL_DOMAINS=localhost,127.0.0.1,127.0.0.1:8000,::1,madis.test,cyber.local,madis-cyber.test
+
+ADMIN_EMAIL=admin@datakode.fr
+ADMIN_FIRSTNAME=Admin
+ADMIN_LASTNAME=Datakode
+ADMIN_PASSWORD=secret
+
+APP_FAVICON_PATH="logo_madis_2020_favicon_white.png"
+REFERENTIEL_VERSION="1.3"
+SEUIL_ALERTE=1
+LOGO_SIDEBAR="logo-soluris.png"
+FOOTER_LINK=https://www.soluris.fr/

.env.test

@@ -54,5 +54,6 @@ MIX_PUSHER_APP_CLUSTER="${PUSHER_APP_CLUSTER}"
 SANCTUM_STATEFUL_DOMAINS=localhost,127.0.0.1,127.0.0.1:8000,::1
 APP_FAVICON_PATH="logo_madis_2020_favicon_white.png"
 REFERENTIEL_VERSION="1.3"
+SEUIL_ALERTE=1
 LOGO_SIDEBAR="logo-soluris.png"
 FOOTER_LINK=https://www.soluris.fr/

.gitignore

@@ -24,3 +24,5 @@ public/images
 /Vagrantfile
 /after.sh
 /aliases
+/.phpstorm.meta.php
+/_ide_helper.php

.gitlab-ci.yml

@@ -58,7 +58,7 @@ unit_tests:
   <<: *vendor-install-definition
   <<: *cache-pull-definition
   script:
-    - php -dxdebug.mode=coverage vendor/bin/phpunit --coverage-text --colors=never --coverage-html storage/artefacts/coverage/
+    - php -dxdebug.mode=coverage vendor/bin/phpunit --colors=never
   coverage: /^\s+Lines:\s+(\d+)\.\d+%/
   artifacts:
     paths:

app/Enums/MaturityQuestionNames.php

+<?php
+
+namespace App\Enums;
+
+enum MaturityQuestionNames: string
+{
+    case KNOWLEDGE = 'Connaissance';
+    case ORGANIZATION = 'Organisation';
+    case MOTIVATION = 'Motivation';
+    case EXECUTION = 'Exécution';
+    case FUNDAMENTALS = 'Fondamentaux';
+}

app/Http/Controllers/ExportController.php

+<?php
+
+namespace App\Http\Controllers;
+
+use App\Http\Resources\EvaluationExportResource;
+use App\Http\Resources\OrganizationExportResource;
+use App\Models\Evaluation;
+use App\Models\Organization;
+use Illuminate\Http\Request;
+use Illuminate\Support\Collection;
+use Spatie\SimpleExcel\SimpleExcelWriter;
+
+class ExportController extends Controller
+{
+    public function organizations(Request $request): Collection|null
+    {
+        $ext = $request->route('ext');
+        $filename = "structures.$ext";
+        $data = Organization::with(['address', 'referent', 'referentCyber', 'referentElu', 'territory', 'evaluations', 'evaluations.dangerLevels'])->get();
+        $rows = OrganizationExportResource::collection($data)->toArray($request);
+        $header = $this->_getRowsHeader($rows[0], 'exports.organization');
+
+        if ('json' === $ext) {
+            //            die('<pre>'.print_r($rows).'</pre>');
+            return collect(compact('header', 'rows'));
+        }
+
+        $rows = [$header, ...$rows];
+
+        SimpleExcelWriter::streamDownload($filename)
+            ->noHeaderRow()
+            ->addRows($rows)
+            ->toBrowser();
+
+        return null;
+    }
+
+    public function evaluations(Request $request): Collection|null
+    {
+        $ext = $request->route('ext');
+        $filename = "evaluations.$ext";
+        $data = Evaluation::with(['dangerLevels'])->get();
+        $rows = EvaluationExportResource::collection($data)->toArray($request);
+        $header = $this->_getRowsHeader($rows[0], 'exports.evaluation');
+
+        if ('json' === $ext) {
+            return collect(compact('header', 'rows'));
+        }
+
+        $rows = [$header, ...$rows];
+
+        SimpleExcelWriter::streamDownload($filename)
+            ->noHeaderRow()
+            ->addRows($rows)
+            ->toBrowser();
+
+        return null;
+    }
+
+    private function _getRowsHeader(array $cols, string $prefix): array
+    {
+        $keys = collect($cols)->keys();
+
+        return $keys->map(function ($item) use ($prefix) {
+            return trans($prefix . '.' . $item);
+        })->toArray();
+    }
+}

app/Http/Resources/EvaluationExportResource.php

+<?php
+
+namespace App\Http\Resources;
+
+use App\Enums\MaturityQuestionNames;
+use App\Models\DangerLevelEvaluation;
+use App\Models\Evaluation;
+use App\Models\MaturityAnswer;
+use App\Models\Measure;
+use App\Models\MeasureLevel;
+use Carbon\Carbon;
+use Illuminate\Database\Eloquent\Collection as EloquentCollection;
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+use Illuminate\Support\Collection;
+
+class EvaluationExportResource extends JsonResource
+{
+    /**
+     * Transform the resource into an array.
+     *
+     * @param Request $request
+     */
+    public function toArray($request): array
+    {
+        /** @var Evaluation $evaluation */
+        $evaluation = $this->resource;
+
+        $res = [
+            'organizationId' => $evaluation->organization_id, //    -Collectivité id
+            'updatedDate' => $evaluation->updated_at->isoFormat('DD/MM/YYYY'), //    - Date de modification
+            'updatedBy' => $evaluation->updated_by, //    - Modifié par
+            'reference' => $evaluation->reference, //    - Référentiel
+            'status' => Evaluation::STATUS[$evaluation->status], //    - Statut de l’évaluation
+
+            // ***
+//            'statusDangers' => '!TODO', //    - Statut Dangers @todo ??? quelle est la valeur attendue
+            // ***
+        ];
+
+        $dangerLevelEvaluations = $evaluation->dangerLevels ?? collect();
+
+        foreach ([1, 2, 3, 4, 5, 6] as $dangerId) {
+            /** @var ?DangerLevelEvaluation $dangerLevelEvaluation */
+            $dangerLevelEvaluation = $dangerLevelEvaluations->where('danger_id', '=', $dangerId)->first();
+            $res["dangerLevel_$dangerId"] = (string) $dangerLevelEvaluation?->level?->name; //    - perception du danger X
+        }
+
+        $mesures = Measure::orderBy('fundamental', 'ASC')->get();
+        $mesureLevels = $evaluation->measureLevels ?? collect();
+        foreach ([1, 2, 3, 4, 5, 6, 7, 8, 9, 10] as $questionId) {
+            /** @var ?Measure $mesure */
+            $mesure = $mesures->get($questionId - 1);
+            /** @var ?MeasureLevel $mesureLevel */
+            $mesureLevel = $mesureLevels->where('measure_id', '=', $mesure->id)->first();
+
+            $actualLevel = $mesureLevel?->actual_level;
+            $res["q$questionId"] = $mesure->name;
+            if ($actualLevel) {
+                $res["q$questionId"] .= PHP_EOL . $mesure->getAttribute('level' . $actualLevel . '_actual_label');
+            }
+        }
+
+        $maturityLevelAnswers = $evaluation->maturityLevels()->with(['question', 'answer'])->get();
+
+        return [...$res,
+            'actionPlan' => $this->_getActionPlanString($mesureLevels), //    - Plan d’action
+            'motivation' => (string) $this->_getAnswerForQuestionName($maturityLevelAnswers, MaturityQuestionNames::MOTIVATION)?->name, //    - Motivation
+            'execution' => (string) $this->_getAnswerForQuestionName($maturityLevelAnswers, MaturityQuestionNames::EXECUTION)?->name, //    - Execution
+            'fundamental' => (string) $this->_getAnswerForQuestionName($maturityLevelAnswers, MaturityQuestionNames::FUNDAMENTALS)?->name, //    - Fondamentaux
+            'organization' => (string) $this->_getAnswerForQuestionName($maturityLevelAnswers, MaturityQuestionNames::ORGANIZATION)?->name, //    - Organisation
+            'maturityCyber' => $evaluation->maturity_cyber, //    - Indice de maturité
+        ];
+    }
+
+    private function _getAnswerForQuestionName(?EloquentCollection $maturityLevelAnswers, MaturityQuestionNames $name): ?MaturityAnswer
+    {
+        return $maturityLevelAnswers?->firstWhere('question.title', '=', $name->value)?->answer;
+    }
+
+    private function _getActionPlanString(Collection $mesureLevels): string
+    {
+        $actionPlan = [];
+        foreach ($mesureLevels as $mesureLevel) {
+            if ($mesureLevel->expected_level > $mesureLevel->actual_level) {
+                $actionPlan[] = implode(';', [
+                    $mesureLevel->measure->short_name,
+                    '[' . $mesureLevel->actual_level . ' >> ' . $mesureLevel->expected_level . ']',
+                    (new Carbon($mesureLevel->end_date))->isoFormat('DD/MM/YYYY'),
+                    $mesureLevel->manager,
+                ]);
+            }
+        }
+
+        return implode(PHP_EOL, $actionPlan);
+    }
+}

app/Http/Resources/OrganizationExportResource.php

+<?php
+
+namespace App\Http\Resources;
+
+use App\Enums\MaturityQuestionNames;
+use App\Models\DangerLevelEvaluation;
+use App\Models\Evaluation;
+use App\Models\MaturityAnswer;
+use App\Models\MeasureLevel;
+use App\Models\Organization;
+use Illuminate\Database\Eloquent\Collection as EloquentCollection;
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class OrganizationExportResource extends JsonResource
+{
+    /**
+     * Transform the resource into an array.
+     *
+     * @param Request $request
+     */
+    public function toArray($request): array
+    {
+        /** @var Organization $organization */
+        $organization = $this->resource;
+
+        $evaluation = $organization->doneEvaluations()->limit(2)->get();
+        /** @var ?Evaluation $lastEvaluation */
+        $lastEvaluation = $evaluation->first();
+        /** @var ?Evaluation $previousEvaluation */
+        $previousEvaluation = $evaluation->get(1);
+
+        $res = [
+            'name' => $organization->name, //    - nom de la collectivité
+            'shortName' => $organization->short_name, //    - nom court
+            'territory' => (string) $organization->territory?->name, //    - libellé territoire
+            'type' => $organization->type, //    - type de structure
+            'insee' => $organization->address->codeInsee, //    - insee
+            'siren' => $organization->siren, //    - siren
+            'active' => $organization->active, //    - actif
+            'website' => $organization->website, //    - site internet
+            'info' => $organization->info, //    - infos complémentaires
+            'fullAddress' => (string) $organization->address, //    - adresses (tous les champs)
+            'referent' => (string) $organization->referent, //     - référents et responsable (tous les champs)
+            'referentCyber' => (string) $organization->referentCyber,
+            'referentElu' => (string) $organization->referentElu,
+            'lastEvaluation.cyberMaturity' => (float) $lastEvaluation?->maturity_cyber, //     - score indice maturité cyber
+            'previousEvaluation.cyberMaturity' => (float) $previousEvaluation?->maturity_cyber, //    - score indice maturité cyber n-1
+        ];
+
+        $measureLevels = $lastEvaluation?->measureLevels ?? collect();
+
+        foreach ([1, 2, 3, 4, 5, 6, 7, 8, 9, 10] as $measureKey) {
+            /** @var ?MeasureLevel $measureLevel */
+            $measureLevel = $measureLevels->get($measureKey - 1);
+            $res["measure$measureKey.actualLevel"] = (string) $measureLevel?->actual_level; //    - niveau de mise en œuvre mesure X
+        }
+
+        foreach ([1, 2, 3, 4, 5, 6, 7, 8, 9, 10] as $measureKey) {
+            /** @var ?MeasureLevel $measureLevel */
+            $measureLevel = $measureLevels->get($measureKey - 1);
+            $res["measure$measureKey.expectedLevel"] = (string) $measureLevel?->expected_level; //    - niveau de planification mesure X
+        }
+
+        $maturityLevelAnswers = $lastEvaluation?->maturityLevels()->with(['question', 'answer'])->get();
+
+        $res = [...$res,
+            'executionLevel' => (string) $this->_getAnswerForQuestionName($maturityLevelAnswers, MaturityQuestionNames::EXECUTION)?->name,  // niveau d'exécution
+            'createdDate' => $organization->created_at->isoFormat('DD/MM/YYYY'), // date création de la collectivité
+            'lastEvaluation.reference' => (string) $lastEvaluation?->reference, //     - version du référentiel
+            'lastEvaluation.updatedBy' => (string) $lastEvaluation?->updated_by, //     - évaluation modifiée par
+            'lastEvaluation.author' => (string) $lastEvaluation?->author, //     - évaluation crée par
+        ];
+
+        $dangerLevelEvaluations = $lastEvaluation?->dangerLevels ?? collect();
+
+        foreach ([1, 2, 3, 4, 5, 6] as $dangerId) {
+            /** @var ?DangerLevelEvaluation $dangerLevelEvaluation */
+            $dangerLevelEvaluation = $dangerLevelEvaluations->where('danger_id', '=', $dangerId)->first();
+            $res["dangerLevel$dangerId"] = (string) $dangerLevelEvaluation?->level->name; //    - perception du danger X
+        }
+
+        return [...$res,
+            'maturityLevel.knowledge' => (string) $this->_getAnswerForQuestionName($maturityLevelAnswers, MaturityQuestionNames::KNOWLEDGE)?->name,  //     - niveau de connaissance
+            'maturityLevel.organization' => (string) $this->_getAnswerForQuestionName($maturityLevelAnswers, MaturityQuestionNames::ORGANIZATION)?->name,  //     - niveau d'organisation
+            'maturityLevel.motivation' => (string) $this->_getAnswerForQuestionName($maturityLevelAnswers, MaturityQuestionNames::MOTIVATION)?->name,  //     - niveau de motivation
+
+            'alert' => (bool) $lastEvaluation?->isThresholdNotExceeded(),  //     - seuil non dépassé (true/false)
+        ];
+    }
+
+    private function _getAnswerForQuestionName(?EloquentCollection $maturityLevelAnswers, MaturityQuestionNames $name): ?MaturityAnswer
+    {
+        return $maturityLevelAnswers?->firstWhere('question.title', '=', $name->value)?->answer;
+    }
+}

app/Models/Address.php

@@ -2,12 +2,47 @@
 
 namespace App\Models;
 
+use Database\Factories\AddressFactory;
+use Eloquent;
+use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
+use Illuminate\Support\Carbon;
 
+/**
+ * App\Models\Address.
+ *
+ * @property int         $id
+ * @property Carbon|null $created_at
+ * @property Carbon|null $updated_at
+ * @property string      $address
+ * @property string|null $moreInfos
+ * @property string      $cp
+ * @property string      $city
+ * @property string      $codeInsee
+ *
+ * @method static AddressFactory factory(...$parameters)
+ * @method static Builder|Address newModelQuery()
+ * @method static Builder|Address newQuery()
+ * @method static Builder|Address query()
+ * @method static Builder|Address whereAddress($value)
+ * @method static Builder|Address whereCity($value)
+ * @method static Builder|Address whereCodeInsee($value)
+ * @method static Builder|Address whereCp($value)
+ * @method static Builder|Address whereCreatedAt($value)
+ * @method static Builder|Address whereId($value)
+ * @method static Builder|Address whereMoreInfos($value)
+ * @method static Builder|Address whereUpdatedAt($value)
+ * @mixin Eloquent
+ */
 class Address extends Model
 {
     use HasFactory;
 
     protected $table = 'address';
+
+    public function __toString(): string
+    {
+        return implode(' ', [$this->address, $this->cp, $this->city]);
+    }
 }

app/Models/Contact.php

@@ -2,21 +2,47 @@
 
 namespace App\Models;
 
+use Database\Factories\ContactFactory;
+use Eloquent;
+use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
+use Illuminate\Support\Carbon;
 
 /**
  * Class Contact.
  *
- * @property int    $id
- * @property string $civility
- * @property string $firstname
- * @property string $lastname
- * @property string $function
- * @property string $email
- * @property string $phone
+ * @property int         $id
+ * @property string      $civility
+ * @property string      $firstname
+ * @property string      $lastname
+ * @property string      $function
+ * @property string      $email
+ * @property string      $phone
+ * @property Carbon|null $created_at
+ * @property Carbon|null $updated_at
+ *
+ * @method static ContactFactory factory(...$parameters)
+ * @method static Builder|Contact newModelQuery()
+ * @method static Builder|Contact newQuery()
+ * @method static Builder|Contact query()
+ * @method static Builder|Contact whereCivility($value)
+ * @method static Builder|Contact whereCreatedAt($value)
+ * @method static Builder|Contact whereEmail($value)
+ * @method static Builder|Contact whereFirstname($value)
+ * @method static Builder|Contact whereFunction($value)
+ * @method static Builder|Contact whereId($value)
+ * @method static Builder|Contact whereLastname($value)
+ * @method static Builder|Contact wherePhone($value)
+ * @method static Builder|Contact whereUpdatedAt($value)
+ * @mixin Eloquent
  */
 class Contact extends Model
 {
     use HasFactory;
+
+    public function __toString(): string
+    {
+        return implode(' ', [$this->civility, $this->firstname, $this->lastname]);
+    }
 }

app/Models/Danger.php

@@ -2,10 +2,14 @@
 
 namespace App\Models;
 
+use Database\Factories\DangerFactory;
+use Eloquent;
+use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Concerns\HasTimestamps;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsToMany;
+use Illuminate\Support\Carbon;
 use Illuminate\Support\Collection;
 
 /**
@@ -15,6 +19,20 @@
  * @property string                $name
  * @property string                $description
  * @property Scenario[]|Collection $scenarios
+ * @property Carbon|null           $created_at
+ * @property Carbon|null           $updated_at
+ * @property int|null              $scenarios_count
+ *
+ * @method static DangerFactory factory(...$parameters)
+ * @method static Builder|Danger newModelQuery()
+ * @method static Builder|Danger newQuery()
+ * @method static Builder|Danger query()
+ * @method static Builder|Danger whereCreatedAt($value)
+ * @method static Builder|Danger whereDescription($value)
+ * @method static Builder|Danger whereId($value)
+ * @method static Builder|Danger whereName($value)
+ * @method static Builder|Danger whereUpdatedAt($value)
+ * @mixin Eloquent
  */
 class Danger extends Model
 {

app/Models/DangerLevel.php

@@ -2,20 +2,40 @@
 
 namespace App\Models;
 
+use Database\Factories\DangerLevelFactory;
+use Eloquent;
+use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Concerns\HasTimestamps;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
+use Illuminate\Support\Carbon;
 
 /**
  * Class DangerLevel.
  *
- * @property int    $id
- * @property string $name
- * @property string $color
- * @property Danger $danger
- * @property int    $danger_id
- * @property string $description
- * @property int    $value
+ * @property int         $id
+ * @property string      $name
+ * @property string      $color
+ * @property Danger      $danger
+ * @property int         $danger_id
+ * @property string      $description
+ * @property int         $value
+ * @property Carbon|null $created_at
+ * @property Carbon|null $updated_at
+ * @property int|void    $points
+ *
+ * @method static DangerLevelFactory factory(...$parameters)
+ * @method static Builder|DangerLevel newModelQuery()
+ * @method static Builder|DangerLevel newQuery()
+ * @method static Builder|DangerLevel query()
+ * @method static Builder|DangerLevel whereColor($value)
+ * @method static Builder|DangerLevel whereCreatedAt($value)
+ * @method static Builder|DangerLevel whereDescription($value)
+ * @method static Builder|DangerLevel whereId($value)
+ * @method static Builder|DangerLevel whereName($value)
+ * @method static Builder|DangerLevel whereUpdatedAt($value)
+ * @method static Builder|DangerLevel whereValue($value)
+ * @mixin Eloquent
  */
 class DangerLevel extends Model
 {

app/Models/DangerLevelEvaluation.php

@@ -2,10 +2,13 @@
 
 namespace App\Models;
 
+use Eloquent;
+use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Concerns\HasTimestamps;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Support\Carbon;
 
 /**
  * Class DangerLevelEvaluation.
@@ -17,6 +20,19 @@
  * @property int         $evaluation_id
  * @property DangerLevel $level
  * @property int         $danger_level_id
+ * @property Carbon|null $created_at
+ * @property Carbon|null $updated_at
+ *
+ * @method static Builder|DangerLevelEvaluation newModelQuery()
+ * @method static Builder|DangerLevelEvaluation newQuery()
+ * @method static Builder|DangerLevelEvaluation query()
+ * @method static Builder|DangerLevelEvaluation whereCreatedAt($value)
+ * @method static Builder|DangerLevelEvaluation whereDangerId($value)
+ * @method static Builder|DangerLevelEvaluation whereDangerLevelId($value)
+ * @method static Builder|DangerLevelEvaluation whereEvaluationId($value)
+ * @method static Builder|DangerLevelEvaluation whereId($value)
+ * @method static Builder|DangerLevelEvaluation whereUpdatedAt($value)
+ * @mixin Eloquent
  */
 class DangerLevelEvaluation extends Model
 {

app/Models/Evaluation.php

@@ -4,7 +4,10 @@
 
 use App\Calculator\MaturityAnswerLevelCalculator;
 use Carbon\Carbon;
+use Database\Factories\EvaluationFactory;
 use DateTime;
+use Eloquent;
+use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Concerns\HasTimestamps;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
@@ -25,7 +28,6 @@
  * @property MeasureLevel[]|Collection<MeasureLevel>                         $measureLevels
  * @property MeasureLevel[]|Collection<MeasureLevel>                         $measure_levels
  * @property EvaluationMaturityAnswer[]|Collection<EvaluationMaturityAnswer> $maturityLevels
- * @property EvaluationMaturityAnswer[]|Collection<EvaluationMaturityAnswer> $maturity_levels
  * @property int                                                             $status
  * @property Organization                                                    $organization
  * @property int                                                             $organization_id
@@ -36,6 +38,24 @@
  * @property float                                                           $maturityCyber
  * @property float                                                           $maturity_cyber
  * @property string                                                          $reference
+ * @property int|null                                                        $danger_levels_count
+ * @property int|null                                                        $maturity_levels_count
+ * @property int|null                                                        $measure_levels_count
+ *
+ * @method static EvaluationFactory factory(...$parameters)
+ * @method static Builder|Evaluation newModelQuery()
+ * @method static Builder|Evaluation newQuery()
+ * @method static Builder|Evaluation query()
+ * @method static Builder|Evaluation whereAuthor($value)
+ * @method static Builder|Evaluation whereCreatedAt($value)
+ * @method static Builder|Evaluation whereCurrentStep($value)
+ * @method static Builder|Evaluation whereId($value)
+ * @method static Builder|Evaluation whereOrganizationId($value)
+ * @method static Builder|Evaluation whereReference($value)
+ * @method static Builder|Evaluation whereStatus($value)
+ * @method static Builder|Evaluation whereUpdatedAt($value)
+ * @method static Builder|Evaluation whereUpdatedBy($value)
+ * @mixin Eloquent
  */
 class Evaluation extends Model
 {
@@ -176,9 +196,28 @@ public function saveAutomaticAnswers()
             }
 
             $evalAnswer->maturity_question_id = $question->id;
-            $evalAnswer->maturity_answer_id = $answer->id;
+            $evalAnswer->maturity_answer_id = $answer?->id;
             $evalAnswer->evaluation_id = $this->id;
             $evalAnswer->save();
         }
     }
+
+    public static function getThreshold(): float
+    {
+        return env('SEUIL_ALERTE'); // TODO use config instead of direct ENV
+    }
+
+    /**
+     * true if OK.
+     */
+    public function isThresholdNotExceeded(): bool
+    {
+        foreach ($this->measureLevels as $measureLevel) {
+            if ($measureLevel->actual_level < self::getThreshold()) {
+                return true;
+            }
+        }
+
+        return false;
+    }
 }

app/Models/EvaluationMaturityAnswer.php

@@ -2,17 +2,21 @@
 
 namespace App\Models;
 
+use Database\Factories\EvaluationMaturityAnswerFactory;
 use DateTime;
+use Eloquent;
+use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Concerns\HasTimestamps;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Support\Carbon;
 
 /**
  * Class EvaluationMaturityAnswer.
  *
- * @property int $id
- * @property Evaluation$evaluation
+ * @property int              $id
+ * @property Evaluation       $evaluation
  * @property int              $evaluation_id
  * @property MaturityQuestion $question
  * @property int              $maturity_question_id
@@ -20,6 +24,20 @@
  * @property int              $maturity_answer_id
  * @property DateTime         $createdAt
  * @property DateTime         $updatedAt
+ * @property Carbon|null      $created_at
+ * @property Carbon|null      $updated_at
+ *
+ * @method static EvaluationMaturityAnswerFactory factory(...$parameters)
+ * @method static Builder|EvaluationMaturityAnswer newModelQuery()
+ * @method static Builder|EvaluationMaturityAnswer newQuery()
+ * @method static Builder|EvaluationMaturityAnswer query()
+ * @method static Builder|EvaluationMaturityAnswer whereCreatedAt($value)
+ * @method static Builder|EvaluationMaturityAnswer whereEvaluationId($value)
+ * @method static Builder|EvaluationMaturityAnswer whereId($value)
+ * @method static Builder|EvaluationMaturityAnswer whereMaturityAnswerId($value)
+ * @method static Builder|EvaluationMaturityAnswer whereMaturityQuestionId($value)
+ * @method static Builder|EvaluationMaturityAnswer whereUpdatedAt($value)
+ * @mixin Eloquent
  */
 class EvaluationMaturityAnswer extends Model
 {

app/Models/MaturityAnswer.php

@@ -2,12 +2,16 @@
 
 namespace App\Models;
 
+use Database\Factories\MaturityAnswerFactory;
 use DateTime;
+use Eloquent;
+use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Concerns\HasTimestamps;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Support\Carbon;
 use Illuminate\Support\Collection;
 
 /**
@@ -22,6 +26,22 @@
  * @property MaturityAnswer[]|iterable|Collection $evaluationMaturityAnswers
  * @property DateTime                             $createdAt
  * @property DateTime                             $updatedAt
+ * @property Carbon|null                          $created_at
+ * @property Carbon|null                          $updated_at
+ * @property int|null                             $evaluation_maturity_answers_count
+ *
+ * @method static MaturityAnswerFactory factory(...$parameters)
+ * @method static Builder|MaturityAnswer newModelQuery()
+ * @method static Builder|MaturityAnswer newQuery()
+ * @method static Builder|MaturityAnswer query()
+ * @method static Builder|MaturityAnswer whereCreatedAt($value)
+ * @method static Builder|MaturityAnswer whereId($value)
+ * @method static Builder|MaturityAnswer whereLevel($value)
+ * @method static Builder|MaturityAnswer whereMaturityQuestionId($value)
+ * @method static Builder|MaturityAnswer whereName($value)
+ * @method static Builder|MaturityAnswer whereSlug($value)
+ * @method static Builder|MaturityAnswer whereUpdatedAt($value)
+ * @mixin Eloquent
  */
 class MaturityAnswer extends Model
 {

app/Models/MaturityQuestion.php

@@ -2,11 +2,15 @@
 
 namespace App\Models;
 
+use Database\Factories\MaturityQuestionFactory;
 use DateTime;
+use Eloquent;
+use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Concerns\HasTimestamps;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Support\Carbon;
 
 /**
  * Class MaturityQuestion.
@@ -20,6 +24,23 @@
  * @property bool             $auto
  * @property DateTime         $createdAt
  * @property DateTime         $updatedAt
+ * @property Carbon|null      $created_at
+ * @property Carbon|null      $updated_at
+ * @property int|null         $answers_count
+ *
+ * @method static MaturityQuestionFactory factory(...$parameters)
+ * @method static Builder|MaturityQuestion newModelQuery()
+ * @method static Builder|MaturityQuestion newQuery()
+ * @method static Builder|MaturityQuestion query()
+ * @method static Builder|MaturityQuestion whereAuto($value)
+ * @method static Builder|MaturityQuestion whereCreatedAt($value)
+ * @method static Builder|MaturityQuestion whereId($value)
+ * @method static Builder|MaturityQuestion whereName($value)
+ * @method static Builder|MaturityQuestion whereSlug($value)
+ * @method static Builder|MaturityQuestion whereSubtitle($value)
+ * @method static Builder|MaturityQuestion whereTitle($value)
+ * @method static Builder|MaturityQuestion whereUpdatedAt($value)
+ * @mixin Eloquent
  */
 class MaturityQuestion extends Model
 {