Groups (management and joining)

app/commands/Recodex/AddAdmin.php

@@ -0,0 +1,77 @@
+<?php
+
+namespace App\Console;
+
+use App\Helpers\RecodexApiHelper;
+use App\Model\Repository\Users;
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Input\InputArgument;
+use Symfony\Component\Console\Output\OutputInterface;
+
+/**
+ * Add admin into a group as a member.
+ * This command is mainly designed for debugging ReCodEx API integration.
+ */
+class RecodexAddAdmin extends BaseCommand
+{
+    protected static $defaultName = 'recodex:add-admin';
+
+    /**
+     * @var RecodexApiHelper
+     */
+    private $recodexApi;
+
+    /**
+     * @var Users
+     */
+    private $users;
+
+    /**
+     * @param RecodexApiHelper $recodexApi
+     * @param Users $users
+     */
+    public function __construct(RecodexApiHelper $recodexApi, Users $users)
+    {
+        parent::__construct();
+        $this->recodexApi = $recodexApi;
+        $this->users = $users;
+    }
+
+    /**
+     * Register the command.
+     */
+    protected function configure()
+    {
+        $this->setName(self::$defaultName)->setDescription('Add admin into a group as a member.');
+        $this->addArgument('groupId', InputArgument::REQUIRED, 'ID of the group to which the admin will be added.');
+        $this->addArgument('adminId', InputArgument::REQUIRED, 'ID of the admin to be added.');
+    }
+
+    /**
+     * @param InputInterface $input Console input, not used
+     * @param OutputInterface $output Console output for logging
+     * @return int 0 on success, 1 on error
+     */
+    protected function execute(InputInterface $input, OutputInterface $output)
+    {
+        $this->input = $input;
+        $this->output = $output;
+
+        $groupId = $input->getArgument('groupId');
+        $adminId = $input->getArgument('adminId');
+        $admin = $this->users->findOrThrow($adminId);
+
+        $token = trim($this->prompt('Auth token: '));
+        if (!$token) {
+            $output->writeln('No token given, terminating...');
+            return Command::SUCCESS;
+        }
+        $this->recodexApi->setAuthToken($token);
+
+        $output->writeln("Adding admin '$adminId' to group '$groupId'...");
+        $this->recodexApi->addAdminToGroup($groupId, $admin);
+
+        return Command::SUCCESS;
+    }
+}

app/commands/Recodex/AddAttribute.php

@@ -0,0 +1,70 @@
+<?php
+
+namespace App\Console;
+
+use App\Helpers\RecodexApiHelper;
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Input\InputArgument;
+use Symfony\Component\Console\Output\OutputInterface;
+
+/**
+ * Add external attribute to ReCodEx group.
+ * This command is mainly designed for debugging ReCodEx API integration.
+ */
+class RecodexAddAttribute extends BaseCommand
+{
+    protected static $defaultName = 'recodex:add-attribute';
+
+    /**
+     * @var RecodexApiHelper
+     */
+    private $recodexApi;
+
+    /**
+     * @param RecodexApiHelper $recodexApi
+     */
+    public function __construct(RecodexApiHelper $recodexApi)
+    {
+        parent::__construct();
+        $this->recodexApi = $recodexApi;
+    }
+
+    /**
+     * Register the command.
+     */
+    protected function configure()
+    {
+        $this->setName(self::$defaultName)->setDescription('Add external attribute to ReCodEx group.');
+        $this->addArgument('groupId', InputArgument::REQUIRED, 'ID of the group to which the attribute will be added.');
+        $this->addArgument('key', InputArgument::REQUIRED, 'The key of the attribute being added.');
+        $this->addArgument('value', InputArgument::REQUIRED, 'The value of the attribute being added.');
+    }
+
+    /**
+     * @param InputInterface $input Console input, not used
+     * @param OutputInterface $output Console output for logging
+     * @return int 0 on success, 1 on error
+     */
+    protected function execute(InputInterface $input, OutputInterface $output)
+    {
+        $this->input = $input;
+        $this->output = $output;
+
+        $groupId = $input->getArgument('groupId');
+        $key = $input->getArgument('key');
+        $value = $input->getArgument('value');
+
+        $token = trim($this->prompt('Auth token: '));
+        if (!$token) {
+            $output->writeln('No token given, terminating...');
+            return Command::SUCCESS;
+        }
+        $this->recodexApi->setAuthToken($token);
+
+        $output->writeln("Adding attribute '$key' with value '$value' to group '$groupId'...");
+        $this->recodexApi->addAttribute($groupId, $key, $value);
+
+        return Command::SUCCESS;
+    }
+}

app/commands/Recodex/AddStudent.php

@@ -0,0 +1,77 @@
+<?php
+
+namespace App\Console;
+
+use App\Helpers\RecodexApiHelper;
+use App\Model\Repository\Users;
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Input\InputArgument;
+use Symfony\Component\Console\Output\OutputInterface;
+
+/**
+ * Add student into a group as a member.
+ * This command is mainly designed for debugging ReCodEx API integration.
+ */
+class RecodexAddStudent extends BaseCommand
+{
+    protected static $defaultName = 'recodex:add-student';
+
+    /**
+     * @var RecodexApiHelper
+     */
+    private $recodexApi;
+
+    /**
+     * @var Users
+     */
+    private $users;
+
+    /**
+     * @param RecodexApiHelper $recodexApi
+     * @param Users $users
+     */
+    public function __construct(RecodexApiHelper $recodexApi, Users $users)
+    {
+        parent::__construct();
+        $this->recodexApi = $recodexApi;
+        $this->users = $users;
+    }
+
+    /**
+     * Register the command.
+     */
+    protected function configure()
+    {
+        $this->setName(self::$defaultName)->setDescription('Add student into a group as a member.');
+        $this->addArgument('groupId', InputArgument::REQUIRED, 'ID of the group to which the student will be added.');
+        $this->addArgument('studentId', InputArgument::REQUIRED, 'ID of the student to be added.');
+    }
+
+    /**
+     * @param InputInterface $input Console input, not used
+     * @param OutputInterface $output Console output for logging
+     * @return int 0 on success, 1 on error
+     */
+    protected function execute(InputInterface $input, OutputInterface $output)
+    {
+        $this->input = $input;
+        $this->output = $output;
+
+        $groupId = $input->getArgument('groupId');
+        $studentId = $input->getArgument('studentId');
+        $student = $this->users->findOrThrow($studentId);
+
+        $token = trim($this->prompt('Auth token: '));
+        if (!$token) {
+            $output->writeln('No token given, terminating...');
+            return Command::SUCCESS;
+        }
+        $this->recodexApi->setAuthToken($token);
+
+        $output->writeln("Adding student '$studentId' to group '$groupId'...");
+        $this->recodexApi->addStudentToGroup($groupId, $student);
+
+        return Command::SUCCESS;
+    }
+}

app/commands/Recodex/CreateGroup.php

@@ -0,0 +1,96 @@
+<?php
+
+namespace App\Console;
+
+use App\Helpers\RecodexApiHelper;
+use App\Model\Repository\SisScheduleEvents;
+use App\Model\Repository\Users;
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Input\InputArgument;
+use Symfony\Component\Console\Output\OutputInterface;
+
+/**
+ * Create a new group in ReCodEx form selected SIS event.
+ * This command is mainly designed for debugging ReCodEx API integration.
+ */
+class RecodexCreateGroup extends BaseCommand
+{
+    protected static $defaultName = 'recodex:create-group';
+
+    /**
+     * @var RecodexApiHelper
+     */
+    private $recodexApi;
+
+    /**
+     * @var SisScheduleEvents
+     */
+    private $sisEvents;
+
+    /**
+     * @var Users
+     */
+    private $users;
+
+    /**
+     * @param RecodexApiHelper $recodexApi
+     * @param SisScheduleEvents $sisEvents
+     * @param Users $users
+     */
+    public function __construct(RecodexApiHelper $recodexApi, SisScheduleEvents $sisEvents, Users $users)
+    {
+        parent::__construct();
+        $this->recodexApi = $recodexApi;
+        $this->sisEvents = $sisEvents;
+        $this->users = $users;
+    }
+
+    /**
+     * Register the command.
+     */
+    protected function configure()
+    {
+        $this->setName(self::$defaultName)->setDescription('Create a new group in ReCodEx.');
+        $this->addArgument('eventId', InputArgument::REQUIRED, 'The SIS ID of the event associated with the group.');
+        $this->addArgument('parentId', InputArgument::REQUIRED, 'ReCodEx ID of the the parent group.');
+        $this->addArgument('adminId', InputArgument::REQUIRED, 'ReCodEx ID of the admin of the newly created group.');
+    }
+
+    /**
+     * @param InputInterface $input Console input, not used
+     * @param OutputInterface $output Console output for logging
+     * @return int 0 on success, 1 on error
+     */
+    protected function execute(InputInterface $input, OutputInterface $output)
+    {
+        $this->input = $input;
+        $this->output = $output;
+
+        $eventId = $input->getArgument('eventId');
+        $event = $this->sisEvents->findBySisId($eventId);
+        if (!$event) {
+            $output->writeln("Event with ID $eventId not found.");
+            return Command::FAILURE;
+        }
+        $parentId = $input->getArgument('parentId');
+        $adminId = $input->getArgument('adminId');
+        $admin = $this->users->get($adminId);
+        if (!$admin) {
+            $output->writeln("Admin with ID $adminId not found.");
+            return Command::FAILURE;
+        }
+
+        $token = trim($this->prompt('Auth token: '));
+        if (!$token) {
+            $output->writeln('No token given, terminating...');
+            return Command::SUCCESS;
+        }
+        $this->recodexApi->setAuthToken($token);
+
+        $output->writeln("Creating group for event '$eventId' under parent group '$parentId'...");
+        $this->recodexApi->createGroup($event, $parentId, $admin);
+
+        return Command::SUCCESS;
+    }
+}