Files
fewo-stommer/app/Process/ConfigurationImpact.php
T
LarsandClaude Sonnet 5.5 381720763c
Deploy FeWo mit PipelineManager / deploy (push) Successful in 6m16s
Modul-Konfigurationsmatrix und Auswirkungs-Abgleich im Kanalkonfigurator
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-05 09:51:33 +01:00

98 lines
4.3 KiB
PHP
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<?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.';
}
}