Modul-Konfigurationsmatrix und Auswirkungs-Abgleich im Kanalkonfigurator
Deploy FeWo mit PipelineManager / deploy (push) Successful in 6m16s
Deploy FeWo mit PipelineManager / deploy (push) Successful in 6m16s
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
a3ab1b6657
commit
381720763c
6 files changed
+327
No files matched your search
@@ -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.';
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user