Normalize AI provider validation

README.md

@@ -30,6 +30,6 @@ Szkielet komponentu Joomla 6 do gromadzenia pytań testowych.
 
 ## Instalacja
 
-W Joomla wybierz **System → Install → Install from Folder** i wskaż ten katalog. Manifestem instalacyjnym jest `com_testquestions.xml` (wersja 1.41.0).
+W Joomla wybierz **System → Install → Install from Folder** i wskaż ten katalog. Manifestem instalacyjnym jest `com_testquestions.xml` (wersja 1.42.6).
 
 Po instalacji komponent jest dostępny w panelu administratora jako **Pytania testowe**.

administrator/components/com_testquestions/config.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<config>
+    <fields name="params">
+        <fieldset name="basic" label="COM_TESTQUESTIONS_AI_SETTINGS">
+            <field name="ai_provider" type="list" label="COM_TESTQUESTIONS_AI_PROVIDER">
+                <option value="openai">OpenAI</option>
+                <option value="grok">Grok</option>
+            </field>
+            <field name="ai_api_key" type="aiapikey" addfieldprefix="Komponent\Component\Testquestions\Administrator\Field" label="COM_TESTQUESTIONS_AI_API_KEY" filter="raw" autocomplete="off" size="120" class="w-100" />
+        </fieldset>
+    </fields>
+</config>

administrator/components/com_testquestions/language/en-GB/com_testquestions.ini

@@ -62,6 +62,14 @@ COM_TESTQUESTIONS_SET_REORDER_INFO="Przeciągnij pytania, aby zmienić ich kolej
 COM_TESTQUESTIONS_SET_SAVE="Zapisz"
 COM_TESTQUESTIONS_SET_SAVE_AND_CLOSE="Zapisz i zamknij"
 COM_TESTQUESTIONS_SET_VARIANT_DURATION_INFO="Czas testu jest pobierany z zestawu nadrzędnego."
+COM_TESTQUESTIONS_AI_SETTINGS="Ustawienia AI"
+COM_TESTQUESTIONS_AI_PROVIDER="Dostawca AI"
+COM_TESTQUESTIONS_AI_API_KEY="Klucz API"
+COM_TESTQUESTIONS_AI_SETTINGS_MENU="Konfiguracja AI"
+COM_TESTQUESTIONS_AI_EVALUATE="AI"
+COM_TESTQUESTIONS_AI_RESULT="Ocena AI"
+COM_TESTQUESTIONS_AI_NOT_CONFIGURED="Skonfiguruj dostawcę i klucz API w ustawieniach komponentu."
+COM_TESTQUESTIONS_AI_ERROR="Nie udało się uzyskać odpowiedzi AI: %s"
 COM_TESTQUESTIONS_SET_DESCRIPTION="Opis zestawu"
 COM_TESTQUESTIONS_SET_QUESTIONS="Pytania w zestawie"
 COM_TESTQUESTIONS_SET_QUESTION_COUNT="Liczba pytań"

administrator/components/com_testquestions/sql/updates/mysql/1.42.0.sql

@@ -0,0 +1 @@
+-- AI feedback is stored in the existing answers JSON column.

administrator/components/com_testquestions/sql/updates/mysql/1.42.1.sql

@@ -0,0 +1 @@
+-- No database changes required for version 1.42.1.

administrator/components/com_testquestions/sql/updates/mysql/1.42.2.sql

@@ -0,0 +1 @@
+-- No database changes required for version 1.42.2.

administrator/components/com_testquestions/sql/updates/mysql/1.42.3.sql

@@ -0,0 +1 @@
+-- No database changes required for version 1.42.3.

administrator/components/com_testquestions/sql/updates/mysql/1.42.4.sql

@@ -0,0 +1 @@
+-- No database changes required for version 1.42.4.

administrator/components/com_testquestions/sql/updates/mysql/1.42.5.sql

@@ -0,0 +1 @@
+-- No database changes required for version 1.42.5.

administrator/components/com_testquestions/sql/updates/mysql/1.42.6.sql

@@ -0,0 +1 @@
+-- No database changes required for version 1.42.6.

administrator/components/com_testquestions/src/Controller/ResultController.php

@@ -32,6 +32,34 @@ class ResultController extends BaseController
         );
     }
 
+    public function ai(): void
+    {
+        if (!Session::checkToken()) {
+            throw new \RuntimeException(Text::_('JINVALID_TOKEN'), 403);
+        }
+
+        $input = Factory::getApplication()->getInput();
+        $id = $input->post->getInt('id');
+        $questionId = $input->post->getInt('ai_question_id');
+        $message = Text::_('COM_TESTQUESTIONS_AI_RESULT');
+        $type = 'message';
+
+        try {
+            $this->getModel('Result')->evaluateWithAi($id, $questionId);
+        } catch (\Throwable $error) {
+            $message = $error->getMessage() === 'AI_NOT_CONFIGURED'
+                ? Text::_('COM_TESTQUESTIONS_AI_NOT_CONFIGURED')
+                : Text::sprintf('COM_TESTQUESTIONS_AI_ERROR', $error->getMessage());
+            $type = 'error';
+        }
+
+        $this->setRedirect(
+            Route::_('index.php?option=com_testquestions&view=result&id=' . $id, false),
+            $message,
+            $type
+        );
+    }
+
     private function saveAssessment(): void
     {
         if (!Session::checkToken()) {

administrator/components/com_testquestions/src/Field/AiapikeyField.php

@@ -0,0 +1,37 @@
+<?php
+
+namespace Komponent\Component\Testquestions\Administrator\Field;
+
+defined('_JEXEC') or die;
+
+use Joomla\CMS\Form\FormField;
+
+class AiapikeyField extends FormField
+{
+    protected $type = 'Aiapikey';
+
+    protected function getInput(): string
+    {
+        $id = htmlspecialchars($this->id, ENT_QUOTES, 'UTF-8');
+        $name = htmlspecialchars($this->name, ENT_QUOTES, 'UTF-8');
+        $value = htmlspecialchars((string) $this->value, ENT_QUOTES, 'UTF-8');
+        $length = mb_strlen((string) $this->value);
+
+        return '<div class="input-group">'
+            . '<input type="password" id="' . $id . '" name="' . $name . '" value="' . $value . '" size="120" autocomplete="off" class="form-control">'
+            . '<button type="button" class="btn btn-outline-secondary" data-ai-key-toggle="' . $id . '">Pokaż</button>'
+            . '</div>'
+            . '<small class="form-text text-muted">Zapisany klucz: ' . (int) $length . ' znaków.</small>'
+            . '<script>
+                document.addEventListener("click", function (event) {
+                    var button = event.target.closest("[data-ai-key-toggle]");
+                    if (!button) return;
+                    var input = document.getElementById(button.getAttribute("data-ai-key-toggle"));
+                    if (!input) return;
+                    var visible = input.type === "text";
+                    input.type = visible ? "password" : "text";
+                    button.textContent = visible ? "Pokaż" : "Ukryj";
+                });
+            </script>';
+    }
+}

administrator/components/com_testquestions/src/Model/ResultModel.php

@@ -6,6 +6,8 @@ defined('_JEXEC') or die;
 
 use Joomla\CMS\Factory;
 use Joomla\CMS\MVC\Model\BaseDatabaseModel;
+use Joomla\CMS\Component\ComponentHelper;
+use Komponent\Component\Testquestions\Administrator\Service\AiService;
 
 class ResultModel extends BaseDatabaseModel
 {
@@ -72,4 +74,71 @@ class ResultModel extends BaseDatabaseModel
 
         return (bool) $db->updateObject('#__testquestions_results', $row, 'id');
     }
+
+    public function evaluateWithAi(int $id, int $questionId): string
+    {
+        $item = $this->getItem($id);
+
+        if (!$item) {
+            throw new \RuntimeException('Nie znaleziono zapisanego testu.');
+        }
+
+        $answer = $item->answers[$questionId] ?? null;
+        $question = $item->questions[$questionId] ?? null;
+
+        if (!$item || !$answer || !$question || $question->question_type !== 'open' || !empty($answer['correct'])) {
+            throw new \RuntimeException('Nieprawidłowe pytanie do oceny AI.');
+        }
+
+        $params = ComponentHelper::getParams('com_testquestions');
+        $provider = trim((string) $params->get('ai_provider', 'openai'));
+        $apiKey = trim((string) $params->get('ai_api_key', ''));
+
+        // Odczytaj zapisane parametry bezpośrednio z bazy. Dzięki temu nie użyjemy
+        // nieaktualnej wartości z pamięci ComponentHelper, a maska pola hasła
+        // (np. ********) nie zostanie potraktowana jako prawdziwy klucz.
+        $db = Factory::getContainer()->get('DatabaseDriver');
+        $storedParams = (string) $db->setQuery(
+            $db->getQuery(true)
+                ->select($db->quoteName('params'))
+                ->from($db->quoteName('#__extensions'))
+                ->where($db->quoteName('type') . ' = ' . $db->quote('component'))
+                ->where($db->quoteName('element') . ' = ' . $db->quote('com_testquestions'))
+        )->loadResult();
+        $storedParams = json_decode($storedParams, true);
+
+        if (is_array($storedParams)) {
+            $storedProvider = trim((string) ($storedParams['ai_provider'] ?? ''));
+            $storedApiKey = trim((string) ($storedParams['ai_api_key'] ?? ''));
+
+            if ($storedProvider !== '') {
+                $provider = $storedProvider;
+            }
+
+            if ($storedApiKey !== '' && !preg_match('/^\*+$/', $storedApiKey)) {
+                $apiKey = $storedApiKey;
+            }
+        }
+
+        $feedback = (new AiService())->evaluate(
+            $provider,
+            $apiKey,
+            strip_tags((string) $question->question),
+            (string) ($answer['selected'] ?? ''),
+            (string) $question->answer_open
+        );
+        $item->answers[$questionId]['ai_feedback'] = $feedback;
+
+        $db = Factory::getContainer()->get('DatabaseDriver');
+        $row = (object) [
+            'id' => $id,
+            'answers' => json_encode($item->answers, JSON_UNESCAPED_UNICODE),
+        ];
+
+        if (!$db->updateObject('#__testquestions_results', $row, 'id')) {
+            throw new \RuntimeException('Nie udało się zapisać oceny AI.');
+        }
+
+        return $feedback;
+    }
 }

administrator/components/com_testquestions/src/Service/AiService.php

@@ -0,0 +1,79 @@
+<?php
+
+namespace Komponent\Component\Testquestions\Administrator\Service;
+
+defined('_JEXEC') or die;
+
+use Joomla\CMS\Http\HttpFactory;
+
+class AiService
+{
+    public function evaluate(string $provider, string $apiKey, string $question, string $answer, string $pattern): string
+    {
+        $provider = strtolower(trim($provider));
+        $provider = preg_replace('/[^a-z]/', '', $provider);
+        $config = $provider === 'grok'
+            ? ['url' => 'https://api.x.ai/v1/responses', 'model' => 'grok-4.7']
+            : ['url' => 'https://api.openai.com/v1/responses', 'model' => 'gpt-4.1-mini'];
+
+        if (trim($apiKey) === '') {
+            throw new \RuntimeException('AI_NOT_CONFIGURED');
+        }
+
+        if (!in_array($provider, ['openai', 'grok'], true)) {
+            throw new \RuntimeException('Nieprawidłowy dostawca AI: ' . $provider);
+        }
+
+        $input = "Oceń odpowiedź ucznia na pytanie otwarte.\n\n"
+            . "Pytanie:\n" . $question . "\n\n"
+            . "Wzorzec odpowiedzi:\n" . $pattern . "\n\n"
+            . "Odpowiedź ucznia:\n" . ($answer !== '' ? $answer : 'Brak odpowiedzi') . "\n\n"
+            . "Napisz po polsku krótką ocenę: czy odpowiedź może zostać uznana za poprawną, jakie elementy są poprawne lub błędne oraz czy warto przyznać punkty. Nie zmieniaj wzorca odpowiedzi.";
+
+        $payload = json_encode([
+            'model' => $config['model'],
+            'input' => $input,
+            'temperature' => 0.1,
+        ], JSON_UNESCAPED_UNICODE);
+
+        $response = HttpFactory::getHttp()->post(
+            $config['url'],
+            $payload,
+            [
+                'Authorization' => 'Bearer ' . trim($apiKey),
+                'Content-Type' => 'application/json',
+            ],
+            60
+        );
+        $body = json_decode((string) $response->body, true);
+
+        if ((int) $response->code < 200 || (int) $response->code >= 300) {
+            throw new \RuntimeException((string) ($body['error']['message'] ?? ('HTTP ' . (int) $response->code)));
+        }
+
+        $text = $this->extractText($body);
+        if ($text === '') {
+            throw new \RuntimeException('Brak treści odpowiedzi AI.');
+        }
+
+        return $text;
+    }
+
+    private function extractText(array $body): string
+    {
+        if (!empty($body['output_text']) && is_string($body['output_text'])) {
+            return trim($body['output_text']);
+        }
+
+        $parts = [];
+        foreach ((array) ($body['output'] ?? []) as $output) {
+            foreach ((array) ($output['content'] ?? []) as $content) {
+                if (!empty($content['text']) && is_string($content['text'])) {
+                    $parts[] = $content['text'];
+                }
+            }
+        }
+
+        return trim(implode("\n", $parts));
+    }
+}

administrator/components/com_testquestions/src/View/Questions/HtmlView.php

@@ -63,5 +63,11 @@ class HtmlView extends BaseHtmlView
             'COM_TESTQUESTIONS_RESULTS',
             'list'
         );
+
+        ToolbarHelper::link(
+            'index.php?option=com_config&view=component&component=com_testquestions',
+            'COM_TESTQUESTIONS_AI_SETTINGS_MENU',
+            'cog'
+        );
     }
 }

administrator/components/com_testquestions/tmpl/result/default.php

@@ -38,6 +38,16 @@
             <?php endif; ?>
             <div class="mt-2 <?php echo !empty($answer['correct']) ? 'text-success' : 'text-danger'; ?>"><?php echo !empty($answer['correct']) ? '✓ ' . \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_ANSWER_CORRECT') : '✗ ' . \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_ANSWER_INCORRECT'); ?></div>
             <?php if (empty($answer['correct'])) : ?>
+                <?php if ($question->question_type === 'open') : ?>
+                    <div class="mt-3">
+                        <button type="submit" name="ai_question_id" value="<?php echo (int) $questionId; ?>" onclick="this.form.task.value='result.ai';" formaction="<?php echo Route::_('index.php?option=com_testquestions&task=result.ai&id=' . (int) $this->item->id); ?>" class="btn btn-outline-primary">
+                            <?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_AI_EVALUATE'); ?>
+                        </button>
+                    </div>
+                    <?php if (!empty($answer['ai_feedback'])) : ?>
+                        <div class="alert alert-info mt-3"><strong><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_AI_RESULT'); ?>:</strong><br><?php echo nl2br(htmlspecialchars((string) $answer['ai_feedback'], ENT_QUOTES, 'UTF-8')); ?></div>
+                    <?php endif; ?>
+                <?php endif; ?>
                 <div class="row mt-3">
                     <div class="col-md-3">
                         <label for="awarded-points-<?php echo (int) $questionId; ?>" class="form-label"><?php echo \Joomla\CMS\Language\Text::sprintf('COM_TESTQUESTIONS_RESULT_AWARDED_POINTS', (int) ($question->points ?? 0)); ?></label>

com_testquestions.xml

@@ -4,7 +4,7 @@
     <creationDate>2026-10-14</creationDate>
     <author>Komponent</author>
     <license>GNU General Public License version 2 or later</license>
-    <version>1.41.0</version>
+    <version>1.42.6</version>
     <description>COM_TESTQUESTIONS_DESCRIPTION</description>
     <element>com_testquestions</element>
     <namespace path="src">Komponent\Component\Testquestions</namespace>
@@ -19,6 +19,7 @@
     <administration>
         <menu link="index.php?option=com_testquestions&amp;view=questions">COM_TESTQUESTIONS</menu>
         <files folder="administrator/components/com_testquestions">
+            <filename>config.xml</filename>
             <folder>forms</folder>
             <folder>services</folder>
             <folder>sql</folder>