Add location to team API.

ChangeLog

@@ -27,6 +27,7 @@ Version 8.3.0DEV
  - Fix medal awards when skipping categories.
  - Add direct button to public page for registering when enabled.
  - Scale batch size of judge tasks dynamically.
+ - Rename room to location for teams.
 
 Version 8.2.0 - 6 March 2023
 ----------------------------

doc/manual/import.rst

@@ -166,7 +166,7 @@ fields:
 - ``display_name`` (optional): the team display name. If provided, will display
   this instead of the team name in certain places, like the scoreboard
 - ``organization_id``: the ID of the team affiliation this team belongs to
-- ``room`` (optional): the room of the team
+- ``location.description`` (optional): the location of the team
 
 If the ``data_source`` setting of DOMjudge is set to external, the ``id`` field will be the
 ID used for the team and the ``group_ids`` and ``organization_id`` fields are the values as
@@ -183,7 +183,7 @@ Example ``teams.json``::
     "group_ids": ["24"],
     "name": "¡i¡i¡",
     "organization_id": "INST-42",
-    "room": "AUD 10"
+    "location": {"description": "AUD 10"}
   }, {
     "id": "2",
     "icpc_id": "447837",

webapp/migrations/Version20240112100916.php

@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DoctrineMigrations;
+
+use Doctrine\DBAL\Schema\Schema;
+use Doctrine\Migrations\AbstractMigration;
+
+/**
+ * Auto-generated Migration: Please modify to your needs!
+ */
+final class Version20240112100916 extends AbstractMigration
+{
+    public function getDescription(): string
+    {
+        return 'Change room to location for teams.';
+    }
+
+    public function up(Schema $schema): void
+    {
+        // this up() migration is auto-generated, please modify it to your needs
+        $this->addSql('ALTER TABLE team CHANGE room location VARCHAR(255) DEFAULT NULL COMMENT \'Physical location of team\'');
+    }
+
+    public function down(Schema $schema): void
+    {
+        // this down() migration is auto-generated, please modify it to your needs
+        $this->addSql('ALTER TABLE team CHANGE location room VARCHAR(255) DEFAULT NULL COMMENT \'Physical location of team\'');
+    }
+
+    public function isTransactional(): bool
+    {
+        return false;
+    }
+}

webapp/public/js/domjudge.js

@@ -658,7 +658,7 @@ function updateMenuBalloons(data)
         $("#num-alerts-balloons").html(num);
         $("#num-alerts-balloons").show();
         for (var i=0; i<num; i++) {
-            var text = (data[i].room !== null) ? data[i].room+': ' : '';
+            var text = (data[i].location !== null) ? data[i].location+': ' : '';
             text += data[i].pname + ' ' + data[i].name;
             sendNotification('New balloon:',
                  {'tag': 'ball_' + data[i].baloonid,

webapp/src/Controller/Jury/BalloonController.php

@@ -91,10 +91,10 @@ public function indexAction(BalloonService $balloonService): Response
         if (isset($filters['location-str'])) {
             /** @var Team[] $filteredLocations */
             $filteredLocations = $this->em->createQueryBuilder()
-                ->from(Team::class, 'a', 'a.room')
+                ->from(Team::class, 'a', 'a.location')
                 ->select('a')
-                ->where('a.room IN (:rooms)')
-                ->setParameter('rooms', $filters['location-str'])
+                ->where('a.location IN (:locations)')
+                ->setParameter('locations', $filters['location-str'])
                 ->getQuery()
                 ->getResult();
         }

webapp/src/Controller/Jury/JuryMiscController.php

@@ -83,15 +83,15 @@ public function ajaxDataAction(Request $request, string $datatype): JsonResponse
             }, $affiliations);
         } elseif ($datatype === 'locations') {
             $locations = $qb->from(Team::class, 'a')
-                ->select('DISTINCT a.room')
-                ->where($qb->expr()->like('a.room', '?1'))
-                ->orderBy('a.room', 'ASC')
+                ->select('DISTINCT a.location')
+                ->where($qb->expr()->like('a.location', '?1'))
+                ->orderBy('a.location', 'ASC')
                 ->getQuery()->setParameter(1, '%' . $q . '%')
                 ->getResult();
 
             $results = array_map(fn(array $location) => [
-                'id' => $location['room'],
-                'text' => $location['room']
+                'id' => $location['location'],
+                'text' => $location['location']
             ], $locations);
         } elseif (!$this->isGranted('ROLE_JURY')) {
             throw new AccessDeniedHttpException('Permission denied');

webapp/src/Controller/Jury/TeamController.php

@@ -93,7 +93,7 @@ public function indexAction(): Response
             'affiliation' => ['title' => 'affiliation', 'sort' => true,],
             'num_contests' => ['title' => '# contests', 'sort' => true,],
             'ip_address' => ['title' => 'last IP', 'sort' => true,],
-            'room' => ['title' => 'room', 'sort' => true,],
+            'location' => ['title' => 'location', 'sort' => true,],
             'status' => ['title' => '', 'sort' => false,],
             'stats' => ['title' => 'stats', 'sort' => true,],
         ];

webapp/src/Controller/Team/MiscController.php

@@ -184,7 +184,7 @@ public function printAction(Request $request): Response
                 $teamId = (string)$team->getTeamid();
             }
             $ret  = $this->dj->printFile($realfile, $originalfilename, $langid,
-                $username, $team->getEffectiveName(), $teamId, $team->getRoom());
+                $username, $team->getEffectiveName(), $teamId, $team->getLocation());
 
             return $this->render('team/print_result.html.twig', [
                 'success' => $ret[0],

webapp/src/DataFixtures/Test/AddLocationToTeamFixture.php

@@ -0,0 +1,16 @@
+<?php declare(strict_types=1);
+
+namespace App\DataFixtures\Test;
+
+use App\Entity\Team;
+use Doctrine\Persistence\ObjectManager;
+
+class AddLocationToTeamFixture extends AbstractTestDataFixture
+{
+    public function load(ObjectManager $manager): void
+    {
+        $team = $manager->getRepository(Team::class)->findOneBy(['name' => 'Example teamname']);
+        $team->setLocation('Utrecht');
+        $manager->flush();
+    }
+}

webapp/src/Entity/Team.php

@@ -3,6 +3,7 @@
 namespace App\Entity;
 
 use App\Controller\API\AbstractRestController as ARC;
+use App\Helpers\TeamLocation;
 use Doctrine\Common\Collections\ArrayCollection;
 use Doctrine\Common\Collections\Collection;
 use Doctrine\ORM\Mapping as ORM;
@@ -87,8 +88,9 @@ class Team extends BaseApiEntity implements ExternalRelationshipEntityInterface,
     private ?string $publicDescription = null;
 
     #[ORM\Column(nullable: true, options: ['comment' => 'Physical location of team'])]
+    #[OA\Property(nullable: true)]
     #[Serializer\Exclude]
-    private ?string $room = null;
+    private ?string $location = null;
 
     #[ORM\Column(
         name: 'internalcomments',
@@ -285,15 +287,23 @@ public function getPublicDescription(): ?string
         return $this->publicDescription;
     }
 
-    public function setRoom(?string $room): Team
+    public function setLocation(?string $location): Team
     {
-        $this->room = $room;
+        $this->location = $location;
         return $this;
     }
 
-    public function getRoom(): ?string
+    public function getLocation(): ?string
+    {
+        return $this->location;
+    }
+
+    #[Serializer\Groups([ARC::GROUP_NONSTRICT])]
+    #[Serializer\VirtualProperty]
+    #[Serializer\SerializedName('location')]
+    public function getLocationForApi(): ?TeamLocation
     {
-        return $this->room;
+        return $this->location ? new TeamLocation($this->location) : null;
     }
 
     public function setInternalComments(?string $comments): Team

webapp/src/Form/Type/TeamType.php

@@ -82,7 +82,7 @@ public function buildForm(FormBuilderInterface $builder, array $options): void
         $builder->add('penalty', IntegerType::class, [
             'label' => 'Penalty time',
         ]);
-        $builder->add('room', TextType::class, [
+        $builder->add('location', TextType::class, [
             'label'    => 'Location',
             'required' => false,
         ]);

webapp/src/Helpers/TeamLocation.php

@@ -0,0 +1,10 @@
+<?php declare(strict_types=1);
+
+namespace App\Helpers;
+
+class TeamLocation
+{
+    public function __construct(
+        public readonly string $description
+    ) {}
+}

webapp/src/Service/BalloonService.php

@@ -92,7 +92,7 @@ public function collectBalloonTable(Contest $contest, bool $todo = false): array
 
         $query = $em->createQueryBuilder()
             ->select('b', 's.submittime', 'p.probid',
-                't.teamid', 's', 't', 't.room',
+                't.teamid', 's', 't', 't.location',
                 'c.categoryid AS categoryid', 'c.name AS catname',
                 'co.cid', 'co.shortname',
                 'cp.shortname AS probshortname', 'cp.color',
@@ -159,7 +159,7 @@ public function collectBalloonTable(Contest $contest, bool $todo = false): array
             $balloondata['contestproblem'] = $balloon->getSubmission()->getContestProblem();
             $balloondata['team'] = $balloon->getSubmission()->getTeam();
             $balloondata['teamid'] = $balloonsData['teamid'];
-            $balloondata['location'] = $balloonsData['room'];
+            $balloondata['location'] = $balloonsData['location'];
             $balloondata['affiliation'] = $balloonsData['affilshort'];
             $balloondata['affiliationid'] = $balloonsData['affilid'];
             $balloondata['category'] = $balloonsData['catname'];

webapp/src/Service/DOMJudgeService.php

@@ -410,7 +410,7 @@ public function getUpdates(): array
 
         if ($this->checkrole('balloon')) {
             $balloonsQuery = $this->em->createQueryBuilder()
-            ->select('b.balloonid', 't.name', 't.room', 'p.name AS pname')
+            ->select('b.balloonid', 't.name', 't.location', 'p.name AS pname')
             ->from(Balloon::class, 'b')
             ->leftJoin('b.submission', 's')
             ->leftJoin('s.problem', 'p')
@@ -714,7 +714,7 @@ public function openZipFile(string $filename): ZipArchive
      * @param string      $username Username of the print job submitter
      * @param string|null $teamname Teamname of the team this user belongs to, if any
      * @param string|null $teamid   Teamid of the team this user belongs to, if any
-     * @param string|null $location Room/place of the team, if any.
+     * @param string|null $location Location of the team, if any.
      */
     public function printFile(
         string $filename,

webapp/src/Service/ICPCCmsService.php

@@ -115,7 +115,7 @@ public function importTeams(string $token, string $contest, ?string &$message =
                         ->setEnabled($enabled)
                         ->setInternalComments('Status: ' . $teamData['status'])
                         ->setIcpcid($teamData['teamId'])
-                        ->setRoom($siteName);
+                        ->setLocation($siteName);
                     $this->em->persist($team);
                     $this->em->flush();
                     $username = sprintf("team%04d", $team->getTeamid());
@@ -137,7 +137,7 @@ public function importTeams(string $token, string $contest, ?string &$message =
                         ->setEnabled($enabled)
                         ->setInternalComments('Status: ' . $teamData['status'])
                         ->setIcpcid($teamData['teamId'])
-                        ->setRoom($siteName);
+                        ->setLocation($siteName);
 
                     $user = $this->em->getRepository(User::class)->findOneBy(['username' => $username]);
                     $user?->setName($teamData['teamName']);

webapp/src/Service/ImportExportService.php

@@ -854,7 +854,7 @@ public function importTeamsJson(array $data, ?string &$message = null, ?array &$
                     'name' => @$team['name'],
                     'display_name' => @$team['display_name'],
                     'publicdescription' => $team['public_description'] ?? @$team['members'],
-                    'room' => @$team['room'],
+                    'location' => @$team['location']['description'],
                 ],
                 'team_affiliation' => [
                     'externalid' => $team['organization_id'] ?? null,

webapp/templates/jury/balloons.html.twig

@@ -46,8 +46,8 @@
                         <select id="location-filter" class="select2 form-control" multiple data-filter-field="location-str"
                                 data-ajax-url="{{ path('jury_ajax_data', {datatype: 'locations', select2: true}) }}">
                             {%- for location in filteredLocations %}
-                                <option value="{{ location.room }}" selected>
-                                    {{ location.room }}
+                                <option value="{{ location.location }}" selected>
+                                    {{ location.location }}
                                 </option>
                             {%- endfor %}
                         </select>

webapp/templates/jury/partials/team_form.html.twig

@@ -12,7 +12,7 @@
         {{ form_row(form.publicdescription) }}
         {{ form_row(form.affiliation) }}
         {{ form_row(form.penalty) }}
-        {{ form_row(form.room) }}
+        {{ form_row(form.location) }}
         {{ form_row(form.internalcomments) }}
         {{ form_row(form.contests) }}
         {{ form_row(form.enabled) }}

webapp/templates/jury/team.html.twig

@@ -85,10 +85,10 @@
                         <td>{{ team.penalty }}</td>
                     </tr>
                 {% endif %}
-                {% if team.room %}
+                {% if team.location %}
                     <tr>
                         <th>Location</th>
-                        <td>{{ team.room }}</td>
+                        <td>{{ team.location }}</td>
                     </tr>
                 {% endif %}
                 <tr>

webapp/templates/partials/team.html.twig

@@ -45,10 +45,10 @@
                         </tr>
                     {% endif %}
                 {% endif %}
-                {% if team.room is not empty %}
+                {% if team.location is not empty %}
                     <tr>
                         <th>Location</th>
-                        <td>{{ team.room }}</td>
+                        <td>{{ team.location }}</td>
                     </tr>
                 {% endif %}
             </table>

webapp/tests/Unit/Controller/API/TeamControllerTest.php

@@ -2,6 +2,7 @@
 
 namespace App\Tests\Unit\Controller\API;
 
+use App\DataFixtures\Test\AddLocationToTeamFixture;
 use Symfony\Component\HttpFoundation\BinaryFileResponse;
 use Symfony\Component\HttpFoundation\File\UploadedFile;
 
@@ -21,9 +22,12 @@ class TeamControllerTest extends BaseTestCase
             'display_name'    => null,
             'members'         => null,
             'photo'           => null,
+            'location'        => ['description' => 'Utrecht'],
         ],
     ];
 
+    protected static array $fixtures = [AddLocationToTeamFixture::class];
+
     protected array $expectedAbsent = ['4242', 'nonexistent'];
 
     public function testLogoManagement(): void

webapp/tests/Unit/Controller/Jury/TeamControllerTest.php

@@ -18,7 +18,7 @@ class TeamControllerTest extends JuryControllerTestCase
     protected static string  $className                = Team::class;
     protected static array   $DOM_elements             = ['h1' => ['Teams']];
     protected static string  $addForm                  = 'team[';
-    protected static array   $addEntitiesShown         = ['icpcid', 'label', 'displayName', 'room'];
+    protected static array   $addEntitiesShown         = ['icpcid', 'label', 'displayName', 'location'];
     protected static array   $overviewSingleNotShown   = ['addUserForTeam'];
     protected static array   $overviewGeneralNotShown  = ['icpcid'];
     protected static array   $addEntitiesCount         = ['contests'];
@@ -27,7 +27,7 @@ class TeamControllerTest extends JuryControllerTestCase
                                                            'category' => '3',
                                                            'publicdescription' => 'Some members',
                                                            'penalty' => '0',
-                                                           'room' => 'The first room',
+                                                           'location' => 'The first room',
                                                            'internalcomments' => 'This is a team without a user',
                                                            'contests' => [],
                                                            'enabled' => '1',
@@ -38,7 +38,7 @@ class TeamControllerTest extends JuryControllerTestCase
                                                            'category' => '1',
                                                            'publicdescription' => 'More members',
                                                            'penalty' => '20',
-                                                           'room' => 'Another room',
+                                                           'location' => 'Another room',
                                                            'internalcomments' => 'This is a team with a user',
                                                            'enabled' => '1',
                                                            'addUserForTeam' => Team::CREATE_NEW_USER,
@@ -57,9 +57,9 @@ class TeamControllerTest extends JuryControllerTestCase
                                                           ['name' => 'no_members',
                                                            'publicdescription' => '',
                                                            'displayName' => 'Team without members'],
-                                                          ['name' => 'no_room',
-                                                           'room' => '',
-                                                           'displayName' => 'Team without a room'],
+                                                          ['name' => 'no_location',
+                                                           'location' => '',
+                                                           'displayName' => 'Team without a location'],
                                                           ['name' => 'no_comments',
                                                            'internalcomments' => '',
                                                            'displayName' => 'Team without comments'],