Shadowing: use DTO's

composer.json

@@ -71,6 +71,8 @@
 		"mbostock/d3": "^3.5",
 		"nelmio/api-doc-bundle": "^4.11",
 		"novus/nvd3": "^1.8",
+		"phpdocumentor/reflection-docblock": "^5.3",
+		"phpstan/phpdoc-parser": "^1.25",
 		"promphp/prometheus_client_php": "^2.6",
 		"ramsey/uuid": "^4.2",
 		"select2/select2": "4.*",
@@ -89,9 +91,12 @@
 		"symfony/intl": "6.4.*",
 		"symfony/mime": "6.4.*",
 		"symfony/monolog-bundle": "^3.8.0",
+		"symfony/property-access": "6.4.*",
+		"symfony/property-info": "6.4.*",
 		"symfony/runtime": "6.4.*",
 		"symfony/security-bundle": "6.4.*",
 		"symfony/security-csrf": "6.4.*",
+		"symfony/serializer": "6.4.*",
 		"symfony/stopwatch": "6.4.*",
 		"symfony/twig-bundle": "6.4.*",
 		"symfony/validator": "6.4.*",

webapp/config/packages/framework.yaml

@@ -6,6 +6,9 @@ framework:
     http_method_override: true
     annotations: true
     handle_all_throwables: true
+    serializer:
+        enabled: true
+        name_converter: serializer.name_converter.camel_case_to_snake_case
 
     # Enables session support. Note that the session will ONLY be started if you read or write from it.
     # Remove or comment this section to explicitly disable session support.

webapp/src/Controller/API/GeneralInfoController.php

@@ -3,6 +3,7 @@
 namespace App\Controller\API;
 
 use App\DataTransferObject\ApiInfo;
+use App\DataTransferObject\ApiInfoProvider;
 use App\DataTransferObject\ApiVersion;
 use App\DataTransferObject\DomJudgeApiInfo;
 use App\DataTransferObject\ExtendedContestStatus;
@@ -99,6 +100,11 @@ public function getInfoAction(
             version: self::CCS_SPEC_API_VERSION,
             versionUrl: self::CCS_SPEC_API_URL,
             name: 'DOMjudge',
+            //TODO: Add DOMjudge logo
+            provider: new ApiInfoProvider(
+                name: 'DOMjudge',
+                version: $this->getParameter('domjudge.version'),
+            ),
             domjudge: $domjudge
         );
     }

webapp/src/Controller/Jury/ShadowDifferencesController.php

@@ -3,6 +3,7 @@
 namespace App\Controller\Jury;
 
 use App\DataTransferObject\SubmissionRestriction;
+use App\Entity\ExternalContestSource;
 use App\Service\ConfigurationService;
 use Doctrine\ORM\EntityManagerInterface;
 use Doctrine\ORM\NonUniqueResultException;
@@ -64,6 +65,19 @@ public function indexAction(
             return $this->redirectToRoute('jury_index');
         }
 
+        /** @var ExternalContestSource|null $externalContestSource */
+        $externalContestSource = $this->em->createQueryBuilder()
+            ->from(ExternalContestSource::class, 'ecs')
+            ->select('ecs')
+            ->andWhere('ecs.contest = :contest')
+            ->setParameter('contest', $this->dj->getCurrentContest())
+            ->getQuery()->getOneOrNullResult();
+
+        if (!$externalContestSource) {
+            $this->addFlash('warning', 'No external contest present yet, please configure one first');
+            return $this->redirectToRoute('jury_external_contest_manage');
+        }
+
         // Close the session, as this might take a while and we don't need the session below.
         $this->requestStack->getSession()->save();
 

webapp/src/DataTransferObject/ApiInfo.php

@@ -10,6 +10,7 @@ public function __construct(
         public readonly string $version,
         public readonly string $versionUrl,
         public readonly string $name,
+        public readonly ?ApiInfoProvider $provider,
         #[Serializer\Exclude(if: '!object.domjudge')]
         public readonly ?DomJudgeApiInfo $domjudge,
     ) {}

webapp/src/DataTransferObject/ApiInfoProvider.php

@@ -0,0 +1,15 @@
+<?php declare(strict_types=1);
+
+namespace App\DataTransferObject;
+
+use JMS\Serializer\Annotation as Serializer;
+
+class ApiInfoProvider
+{
+    public function __construct(
+        public readonly string $name,
+        public readonly string $version,
+        #[Serializer\Exclude(if: '!object.buildDate')]
+        public readonly ?string $buildDate = null,
+    ) {}
+}

webapp/src/DataTransferObject/Shadowing/ClarificationEvent.php

@@ -0,0 +1,16 @@
+<?php declare(strict_types=1);
+
+namespace App\DataTransferObject\Shadowing;
+
+class ClarificationEvent implements EventData
+{
+    public function __construct(
+        public readonly string $id,
+        public readonly string $text,
+        public readonly string $time,
+        public readonly ?string $fromTeamId,
+        public readonly ?string $toTeamId,
+        public readonly ?string $replyToId,
+        public readonly ?string $problemId,
+    ) {}
+}

webapp/src/DataTransferObject/Shadowing/ContestData.php

@@ -0,0 +1,16 @@
+<?php declare(strict_types=1);
+
+namespace App\DataTransferObject\Shadowing;
+
+class ContestData
+{
+    public function __construct(
+        public readonly string $id,
+        public readonly string $name,
+        public readonly string $duration,
+        public readonly ?string $scoreboardFreezeDuration,
+        public readonly int $penaltyTime,
+        public readonly ?string $startTime,
+        // TODO: check for end time and scoreboard thaw time
+    ) {}
+}

webapp/src/DataTransferObject/Shadowing/ContestEvent.php

@@ -0,0 +1,19 @@
+<?php declare(strict_types=1);
+
+namespace App\DataTransferObject\Shadowing;
+
+class ContestEvent implements EventData
+{
+    public function __construct(
+        public readonly string $id,
+        public readonly string $name,
+        public readonly string $duration,
+        public readonly ?string $scoreboardType,
+        public readonly int $penaltyTime,
+        public readonly ?string $formalName,
+        public readonly ?string $startTime,
+        public readonly ?int $countdownPauseTime,
+        public readonly ?string $scoreboardFreezeDuration,
+        public readonly ?string $scoreboardThawTime,
+    ) {}
+}

webapp/src/DataTransferObject/Shadowing/Event.php

@@ -0,0 +1,20 @@
+<?php declare(strict_types=1);
+
+namespace App\DataTransferObject\Shadowing;
+
+/**
+ * @template-covariant T of EventData
+ */
+class Event
+{
+    /**
+     * @param T[] $data
+     */
+    public function __construct(
+        public readonly ?string $id,
+        public readonly EventType $type,
+        public readonly Operation $operation,
+        public readonly ?string $objectId,
+        public readonly array $data,
+    ) {}
+}

webapp/src/DataTransferObject/Shadowing/EventData.php

@@ -0,0 +1,8 @@
+<?php declare(strict_types=1);
+
+namespace App\DataTransferObject\Shadowing;
+
+interface EventData
+{
+
+}

webapp/src/DataTransferObject/Shadowing/EventType.php

@@ -0,0 +1,65 @@
+<?php declare(strict_types=1);
+
+namespace App\DataTransferObject\Shadowing;
+
+enum EventType: string
+{
+    case ACCOUNTS = 'accounts';
+    case AWARDS = 'awards';
+    case CLARIFICATIONS = 'clarifications';
+    case CONTESTS = 'contests';
+    case GROUPS = 'groups';
+    case JUDGEMENTS = 'judgements';
+    case JUDGEMENT_TYPES = 'judgement-types';
+    case LANGUAGES = 'languages';
+    case ORGANIZATIONS = 'organizations';
+    case PROBLEMS = 'problems';
+    case RUNS = 'runs';
+    case STATE = 'state';
+    case SUBMISSIONS = 'submissions';
+    case TEAMS = 'teams';
+    case TEAM_MEMBERS = 'team-members';
+
+    public static function fromString(string $value): EventType
+    {
+        if ($value === 'contest') {
+            return EventType::CONTESTS;
+        }
+
+        return EventType::from($value);
+    }
+
+    /**
+     * @return class-string<EventData>|null
+     */
+    public function getEventClass(): ?string
+    {
+        switch ($this) {
+            case self::CLARIFICATIONS:
+                return ClarificationEvent::class;
+            case self::CONTESTS:
+                return ContestEvent::class;
+            case self::GROUPS:
+                return GroupEvent::class;
+            case self::JUDGEMENTS:
+                return JudgementEvent::class;
+            case self::JUDGEMENT_TYPES:
+                return JudgementTypeEvent::class;
+            case self::LANGUAGES:
+                return LanguageEvent::class;
+            case self::ORGANIZATIONS:
+                return OrganizationEvent::class;
+            case self::PROBLEMS:
+                return ProblemEvent::class;
+            case self::RUNS:
+                return RunEvent::class;
+            case self::STATE:
+                return StateEvent::class;
+            case self::SUBMISSIONS:
+                return SubmissionEvent::class;
+            case self::TEAMS:
+                return TeamEvent::class;
+        }
+        return null;
+    }
+}

webapp/src/DataTransferObject/Shadowing/GroupEvent.php

@@ -0,0 +1,15 @@
+<?php declare(strict_types=1);
+
+namespace App\DataTransferObject\Shadowing;
+
+class GroupEvent implements EventData
+{
+    public function __construct(
+        public readonly string $id,
+        public readonly string $name,
+        public readonly ?string $icpcId,
+        public readonly ?bool $hidden,
+        public readonly ?int $sortorder,
+        public readonly ?string $color,
+    ) {}
+}