Modul-Konfigurationsmatrix und Auswirkungs-Abgleich im Kanalkonfigurator
Deploy FeWo mit PipelineManager / deploy (push) Successful in 6m16s

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
LarsandClaude Sonnet 5.5 committed 2026-11-05 09:51:33 +01:00
1 parent a3ab1b6657
commit 381720763c
6 files changed
+327

No files matched your search

+97
View File
@@ -0,0 +1,97 @@
<?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.';
}
}