Deploy FeWo mit PipelineManager / deploy (push) Successful in 6m16s
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
98 lines
4.3 KiB
PHP
98 lines
4.3 KiB
PHP
<?php
|
||
|
||
namespace App\Process;
|
||
|
||
use App\Enums\Execution;
|
||
use App\Enums\IntakeKind;
|
||
use App\Models\Channel;
|
||
use App\Process\Modules\ModuleDefinition;
|
||
|
||
/**
|
||
* Rule-based comparison of a configuration draft (docs/Prozessarchitektur/MODUL_KONFIGURATIONSMATRIX.md §5): for every
|
||
* step the landlord switched off it names the steps that depend on it, what stays required, the admissible ways to
|
||
* achieve the result otherwise and what the configurator suggests. Derived from the module definitions the runner uses –
|
||
* no second set of rules. Pure: it reads and explains, it never changes a setting.
|
||
*/
|
||
final class ConfigurationImpact
|
||
{
|
||
public function __construct(private ProcessCatalogue $catalogue, private ChannelProcessConfiguration $configuration) {}
|
||
|
||
/**
|
||
* @param array<string, mixed> $draft
|
||
* @return list<array{module: string, label: string, valid: bool, affected: list<string>, relaxed: list<string>, remains: list<string>, alternatives: list<string>, suggestion: string}>
|
||
*/
|
||
public function of(Channel $channel, IntakeKind $intake, array $draft): array
|
||
{
|
||
$rows = collect($this->configuration->preview($channel, $intake, $draft));
|
||
$active = $rows->where('on', true)->pluck('module')->all();
|
||
$labels = $rows->mapWithKeys(fn (array $row): array => [$row['module'] => $row['label']])->all();
|
||
$impacts = [];
|
||
|
||
foreach ($rows as $row) {
|
||
$definition = $this->catalogue->modules()[$row['module']]::definition();
|
||
if (($draft['steps'][$row['module']]['on'] ?? true) !== false) {
|
||
continue;
|
||
}
|
||
$affected = $relaxed = [];
|
||
foreach ($active as $other) {
|
||
foreach ($this->catalogue->modules()[$other]::definition()->requires as $dependency) {
|
||
if ($dependency->module !== $row['module']) {
|
||
continue;
|
||
}
|
||
if ($dependency->hard) {
|
||
$affected[] = $labels[$other];
|
||
} else {
|
||
$relaxed[] = $labels[$other];
|
||
}
|
||
}
|
||
}
|
||
$alternatives = array_values(array_map(fn (Execution $execution): string => $execution->getLabel(), array_filter($definition->executions, fn (Execution $execution): bool => $execution !== Execution::NotRequired)));
|
||
$valid = $definition->isOptional();
|
||
|
||
$impacts[] = [
|
||
'module' => $row['module'], 'label' => $row['label'], 'valid' => $valid,
|
||
'affected' => array_values(array_unique($affected)), 'relaxed' => array_values(array_unique($relaxed)),
|
||
'remains' => $this->remains($definition, $affected, $labels),
|
||
'alternatives' => $alternatives,
|
||
'suggestion' => $this->suggestion($row['label'], $definition, $valid, $alternatives),
|
||
];
|
||
}
|
||
|
||
return $impacts;
|
||
}
|
||
|
||
/**
|
||
* The results that stay necessary although the step is off: what the steps depending on it still need.
|
||
*
|
||
* @param list<string> $affected
|
||
* @param array<string, string> $labels
|
||
* @return list<string>
|
||
*/
|
||
private function remains(ModuleDefinition $definition, array $affected, array $labels): array
|
||
{
|
||
$remains = [];
|
||
if ($affected !== []) {
|
||
$remains[] = 'Weiterhin nötig, damit „'.implode('“, „', array_unique($affected)).'“ laufen kann: '.lcfirst($definition->purpose);
|
||
}
|
||
if ($definition->why !== null) {
|
||
$remains[] = $definition->why;
|
||
}
|
||
|
||
return $remains;
|
||
}
|
||
|
||
/**
|
||
* @param list<string> $alternatives
|
||
*/
|
||
private function suggestion(string $label, ModuleDefinition $definition, bool $valid, array $alternatives): string
|
||
{
|
||
if (! $valid) {
|
||
return '„'.$label.'“ ist Pflicht und kann nicht abgeschaltet werden.'.($alternatives !== [] ? ' Zulässig sind stattdessen: '.implode('; ', $alternatives).'.' : '');
|
||
}
|
||
|
||
return $alternatives === []
|
||
? '„'.$label.'“ entfällt ersatzlos; es ist nichts weiter einzustellen.'
|
||
: 'Statt abzuschalten, können Sie „'.$label.'“ auch so erledigen lassen: '.implode('; ', $alternatives).'. Es wird nichts anderes automatisch geändert.';
|
||
}
|
||
}
|