feat(manager): integrate forecast controls and merge V4 development

Merge the V4 development history with current manager, SDL and setpoint fixes. Retain guarded trial behavior and consolidate controls in Prognose / Forecast. Exclude the unverified accounting-evidence change; no runtime deployment or new dispatch permission. Validated: 357 PHPUnit tests / 1758 assertions, 150 PHP syntax checks, 310 backend tests, 16 portal tests and isolated UI/receiver checks. develop and beta publication explicitly approved by Daniel Haefliger.
2026-10-06 14:22:16 +00:00
parent 5437f3f058 ce525a1ca0
commit 9fbc52ee47
207 changed files with 20340 additions and 11 deletions
@@ -0,0 +1,46 @@
+<?php
+namespace Belevo\EnelixEMS {
+ if (\function_exists('IPS_GetKernelVersion')) throw new \RuntimeException('CLI test only');
+ require_once __DIR__.'/../../libs/ManagerNetzfahrplanV4EmpfangTrait.php';
+ class Lizenzpruefung {const NETZFAHRPLAN='synthetic';}
+ function time(){return $GLOBALS['now'];}
+ function IPS_InstanceExists($id){return $id===44234;}
+ function IPS_GetInstance($id){return ['ModuleInfo'=>['ModuleID'=>'{437FB683-517F-4FEC-8CCB-FE6B0A62B69E}']];}
+ function IPS_GetProperty($id,$k){return ['IstleistungVariableID'=>1002,'LadezustandVariableID'=>1001,'NetzfahrplanV4RueckmeldungKonfiguration'=>$GLOBALS['configured']?'configured':'{}'][$k];}
+ function IPS_VariableExists($id){return $id===1002;}
+ function IPS_GetVariable($id){return ['VariableUpdated'=>$GLOBALS['now']];}
+ function GetValue($id){return -9000.;} // deliberately held/incorrect legacy virtual display
+ class FeedbackReceiver {
+  use ManagerNetzfahrplanV4EmpfangTrait;
+  public int $InstanceID=17004;public array $props,$attrs,$op;
+  public function __construct($r,$op){$this->op=$op;$this->props=['NetzfahrplanV4EmpfangAktiv'=>true,'NetzfahrplanV4SchattenAktiv'=>true,'NetzfahrplanAktiv'=>false,'MesswertMaxAlter'=>60,'AnlagenBatterien'=>json_encode([['ID'=>'b','LeistungVariableID'=>1002,'SOCVariableID'=>1001,'Leistungsfaktor'=>1]])];$this->attrs=['LizenzInstallationID'=>$r['installationId'],'NetzfahrplanV4Empfang'=>json_encode(['response'=>$r,'receivedAt'=>time()]),'NetzfahrplanV4EmpfangStatus'=>'{}'];}
+  private function ReadPropertyBoolean($k){return $this->props[$k];}
+  private function ReadPropertyString($k){return $this->props[$k];}
+  private function ReadPropertyInteger($k){return $this->props[$k];}
+  private function ReadAttributeString($k){return $this->attrs[$k];}
+  private function aktiveVerbraucherIDs(){return [44234];}
+  private function berechtigungLizenziert($k){return true;}
+  public function GetNetzfahrplanV4Diagnose(){return json_encode(['operation'=>$this->op]);}
+ }
+}
+namespace {
+ function ENELIX_GetV4BatterieRueckmeldung($id){$GLOBALS['now']+=($GLOBALS['feedbackDelay']??0);$GLOBALS['feedback']['checkedAt']=$GLOBALS['now'];return json_encode($GLOBALS['feedback']);}
+ require_once __DIR__.'/../V4Receiver/fixture.php';
+ use Belevo\EnelixEMS\FeedbackReceiver;
+ [$response,$id,$op,$now]=receiverFixture();$configured=true;$count=0;$feedbackDelay=0;
+ $feedback=['kind'=>'local_physical_feedback','version'=>1,'installationId'=>$id,'assetId'=>'b','managerId'=>17004,'batteryInstanceId'=>44234,'batteryW'=>0.,'gridW'=>$op['gridW'],'checkedAt'=>$now,'estimated'=>true,'usableForTrial'=>false,'canDispatch'=>false,'configHash'=>str_repeat('a',64)];
+ function ck($v,$t){global$count;if(!$v)throw new RuntimeException('FAIL '.$t);$count++;echo "PASS $t\n";}
+ $m=new FeedbackReceiver($response,$op);$p=json_decode($m->GetNetzfahrplanV4Vorschau(),true);
+ ck($p['status']==='preview_only'&&$p['actualBatteryW']==0,'real receiver uses corrected physical feedback rather than held -9kW');
+ ck($p['previewBatteryW']==3000,'net target translated once to total battery demand');
+ ck($p['canDispatch']===false&&$p['localFeedback']['b']['estimated']===true,'model feedback remains marked and preview grants no dispatch');
+ $feedbackDelay=1;$p=json_decode($m->GetNetzfahrplanV4Vorschau(),true);$feedbackDelay=0;
+ ck($p['status']==='preview_only','feedback timestamp produced after device read is compared with post-read clock');
+ $feedback=['status'=>'unavailable','reason'=>'feedback_device_read_failed:grid','batteryW'=>null,'gridW'=>null];$p=json_decode($m->GetNetzfahrplanV4Vorschau(),true);
+ ck($p['status']==='unavailable'&&$p['previewBatteryW']===null,'configured feedback failure never falls back to held virtual display');
+ ck(str_contains($p['reason'],'feedback_unavailable:feedback_device_read_failed:grid'),'configured feedback exposes bounded root cause without credentials');
+ $configured=false;$p=json_decode($m->GetNetzfahrplanV4Vorschau(),true);
+ ck($p['status']==='preview_only'&&$p['feedbackMeaning']==='legacy_display_only_not_for_trial','unconfigured old preview stays compatible but explicitly not for control');
+ ck($p['canDispatch']===false,'legacy display cannot gain actuation permission');
+ echo "TOTAL $count actual receiver checks passed; synthetic read-only controller API.\n";
+}