Show actual AI token usage and cost

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.39.0).
+W Joomla wybierz **System → Install → Install from Folder** i wskaż ten katalog. Manifestem instalacyjnym jest `com_testquestions.xml` (wersja 1.43.4).
 
 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

@@ -58,9 +58,27 @@ COM_TESTQUESTIONS_SET_ADD_VARIANT="Dodaj wariant"
 COM_TESTQUESTIONS_SET_PARENT="Zestaw nadrzędny"
 COM_TESTQUESTIONS_SET_NO_VARIANTS="Brak wariantów"
 COM_TESTQUESTIONS_SET_MULTI_QUESTIONS_INFO="Pytania są dodawane w poszczególnych wariantach zestawu."
+COM_TESTQUESTIONS_SET_REORDER_INFO="Przeciągnij pytania, aby zmienić ich kolejność."
 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_OPENAI_KEY="Klucz API OpenAI"
+COM_TESTQUESTIONS_AI_GROK_KEY="Klucz API Grok"
+COM_TESTQUESTIONS_AI_SETTINGS_MENU="Konfiguracja AI"
+COM_TESTQUESTIONS_AI_SETTINGS_SAVED="Ustawienia AI zapisano."
+COM_TESTQUESTIONS_AI_SAVE_FAILED="Nie udało się zapisać ustawień AI."
+COM_TESTQUESTIONS_AI_PROVIDER_INVALID="Wybierz prawidłowego dostawcę AI."
+COM_TESTQUESTIONS_AI_EVALUATE_ALL="AI — oceń wszystkie niezaliczone pytania otwarte (%s)"
+COM_TESTQUESTIONS_AI_BULK_DONE="AI oceniło %s pytań."
+COM_TESTQUESTIONS_AI_BULK_PARTIAL="AI oceniło %s pytań; nie udało się ocenić %s. Błąd: %s"
+COM_TESTQUESTIONS_AI_NO_OPEN_QUESTIONS="Brak niezaliczonych pytań otwartych do oceny 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.40.0.sql

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

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

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

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/sql/updates/mysql/1.42.7.sql

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,83 @@
+<?php
+
+namespace Komponent\Component\Testquestions\Administrator\Controller;
+
+defined('_JEXEC') or die;
+
+use Joomla\CMS\Factory;
+use Joomla\CMS\Language\Text;
+use Joomla\CMS\MVC\Controller\BaseController;
+use Joomla\CMS\Router\Route;
+use Joomla\CMS\Session\Session;
+
+class AiController extends BaseController
+{
+    public function save(): void
+    {
+        if (!Session::checkToken()) {
+            throw new \RuntimeException(Text::_('JINVALID_TOKEN'), 403);
+        }
+
+        $user = Factory::getApplication()->getIdentity();
+        if (!$user->authorise('core.admin', 'com_testquestions') && !$user->authorise('core.options', 'com_testquestions')) {
+            throw new \RuntimeException(Text::_('JERROR_ALERTNOAUTHOR'), 403);
+        }
+
+        $input = Factory::getApplication()->getInput();
+        $provider = strtolower($input->post->getCmd('ai_provider', ''));
+        if (!in_array($provider, ['openai', 'grok'], true)) {
+            throw new \RuntimeException(Text::_('COM_TESTQUESTIONS_AI_PROVIDER_INVALID'));
+        }
+
+        $db = Factory::getContainer()->get('DatabaseDriver');
+        $row = $db->setQuery(
+            $db->getQuery(true)
+                ->select([$db->quoteName('extension_id'), $db->quoteName('params')])
+                ->from($db->quoteName('#__extensions'))
+                ->where($db->quoteName('type') . ' = ' . $db->quote('component'))
+                ->where($db->quoteName('element') . ' = ' . $db->quote('com_testquestions'))
+        )->loadObject();
+
+        if (!$row) {
+            throw new \RuntimeException(Text::_('COM_TESTQUESTIONS_AI_SAVE_FAILED'));
+        }
+
+        $settings = json_decode((string) $row->params, true);
+        $settings = is_array($settings) ? $settings : [];
+        $legacyKey = trim((string) ($settings['ai_api_key'] ?? ''));
+
+        $settings['ai_provider'] = $provider;
+        foreach (['openai', 'grok'] as $keyProvider) {
+            $fieldName = 'ai_' . $keyProvider . '_api_key';
+            $apiKey = trim((string) $input->post->get($fieldName, '', 'RAW'));
+
+            if ($apiKey !== '') {
+                $settings[$fieldName] = $apiKey;
+            }
+
+            if ($keyProvider === $provider && empty($settings[$fieldName]) && $legacyKey !== '') {
+                $settings[$fieldName] = $legacyKey;
+            }
+        }
+        unset($settings['ai_api_key']);
+
+        $extension = (object) [
+            'extension_id' => (int) $row->extension_id,
+            'params' => json_encode($settings, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),
+        ];
+
+        if (!$db->updateObject('#__extensions', $extension, 'extension_id')) {
+            throw new \RuntimeException(Text::_('COM_TESTQUESTIONS_AI_SAVE_FAILED'));
+        }
+
+        $this->setRedirect(
+            Route::_('index.php?option=com_testquestions&view=ai', false),
+            Text::_('COM_TESTQUESTIONS_AI_SETTINGS_SAVED')
+        );
+    }
+
+    public function cancel(): void
+    {
+        $this->setRedirect(Route::_('index.php?option=com_testquestions&view=questions', false));
+    }
+}

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

@@ -32,6 +32,78 @@ 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) {
+            $errorMessage = $error->getMessage();
+            $message = str_starts_with($errorMessage, 'AI_KEY_EMPTY|')
+                ? 'Diagnostyka konfiguracji AI (1.42.8): ' . substr($errorMessage, strlen('AI_KEY_EMPTY|'))
+                : ($errorMessage === 'AI_NOT_CONFIGURED'
+                    ? Text::_('COM_TESTQUESTIONS_AI_NOT_CONFIGURED')
+                    : Text::sprintf('COM_TESTQUESTIONS_AI_ERROR', $errorMessage));
+            $type = 'error';
+        }
+
+        $this->setRedirect(
+            Route::_('index.php?option=com_testquestions&view=result&id=' . $id, false),
+            $message,
+            $type
+        );
+    }
+
+    public function aiAll(): void
+    {
+        if (!Session::checkToken()) {
+            throw new \RuntimeException(Text::_('JINVALID_TOKEN'), 403);
+        }
+
+        $input = Factory::getApplication()->getInput();
+        $id = $input->post->getInt('id');
+        $message = '';
+        $type = 'message';
+
+        try {
+            $summary = $this->getModel('Result')->evaluateAllWithAi($id);
+            if ($summary['failed'] > 0) {
+                $message = Text::sprintf(
+                    'COM_TESTQUESTIONS_AI_BULK_PARTIAL',
+                    $summary['evaluated'],
+                    $summary['failed'],
+                    $summary['first_error']
+                );
+                $type = 'warning';
+            } else {
+                $message = Text::sprintf('COM_TESTQUESTIONS_AI_BULK_DONE', $summary['evaluated']);
+            }
+        } catch (\Throwable $error) {
+            $errorMessage = $error->getMessage();
+            $message = $errorMessage === 'AI_NO_OPEN_QUESTIONS'
+                ? Text::_('COM_TESTQUESTIONS_AI_NO_OPEN_QUESTIONS')
+                : ($errorMessage === 'AI_NOT_CONFIGURED'
+                    ? Text::_('COM_TESTQUESTIONS_AI_NOT_CONFIGURED')
+                    : Text::sprintf('COM_TESTQUESTIONS_AI_ERROR', $errorMessage));
+            $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,35 @@
+<?php
+
+namespace Komponent\Component\Testquestions\Administrator\Field;
+
+defined('_JEXEC') or die;
+
+use Joomla\CMS\Form\Field\PasswordField;
+
+class AiapikeyField extends PasswordField
+{
+    protected $type = 'Aiapikey';
+
+    protected function getInput(): string
+    {
+        $id = htmlspecialchars($this->id, ENT_QUOTES, 'UTF-8');
+        $length = mb_strlen((string) $this->value);
+
+        return '<div class="input-group">'
+            . parent::getInput()
+            . '<button type="button" class="btn btn-outline-secondary" data-ai-key-toggle="' . $id . '">Pokaż</button>'
+            . '</div>'
+            . '<small class="form-text text-muted">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,150 @@ 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'));
+        $provider = strtolower(preg_replace('/[^a-z]/', '', $provider));
+        $keyName = 'ai_' . $provider . '_api_key';
+        $apiKey = trim((string) $params->get($keyName, $params->get('ai_api_key', '')));
+        $componentKeyLength = mb_strlen($apiKey);
+
+        // 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;
+            }
+        }
+
+        $provider = strtolower(preg_replace('/[^a-z]/', '', $provider));
+        $keyName = 'ai_' . $provider . '_api_key';
+        $apiKey = trim((string) $params->get($keyName, $params->get('ai_api_key', '')));
+        $componentKeyLength = mb_strlen($apiKey);
+        $storedApiKey = is_array($storedParams)
+            ? trim((string) ($storedParams[$keyName] ?? $storedParams['ai_api_key'] ?? ''))
+            : '';
+        if ($storedApiKey !== '' && !preg_match('/^\*+$/', $storedApiKey)) {
+            $apiKey = $storedApiKey;
+        }
+
+        if (trim($apiKey) === '') {
+            $databaseKey = $storedApiKey;
+            $databaseKeyLength = preg_match('/^\*+$/', $databaseKey) ? 0 : mb_strlen($databaseKey);
+            throw new \RuntimeException(
+                'AI_KEY_EMPTY|provider=' . ($provider !== '' ? $provider : '(pusty)')
+                . '|component_chars=' . $componentKeyLength
+                . '|database_chars=' . $databaseKeyLength
+                . '|database_params=' . (is_array($storedParams) ? 'json' : 'unreadable')
+            );
+        }
+
+        $aiResult = (new AiService())->evaluate(
+            $provider,
+            $apiKey,
+            strip_tags((string) $question->question),
+            (string) ($answer['selected'] ?? ''),
+            (string) $question->answer_open,
+            (int) $question->points
+        );
+        $item->answers[$questionId]['ai_feedback'] = $aiResult['feedback'];
+        $item->answers[$questionId]['awarded_points'] = $aiResult['awarded_points'];
+        if ($aiResult['usage'] !== null) {
+            $item->answers[$questionId]['ai_usage'] = $aiResult['usage'];
+        }
+
+        $correctionPoints = 0;
+        foreach ($item->answers as $savedAnswer) {
+            $correctionPoints += (int) ($savedAnswer['awarded_points'] ?? 0);
+        }
+
+        $db = Factory::getContainer()->get('DatabaseDriver');
+        $row = (object) [
+            'id' => $id,
+            'answers' => json_encode($item->answers, JSON_UNESCAPED_UNICODE),
+            'points_after' => (int) $item->points_before + $correctionPoints,
+        ];
+
+        if (!$db->updateObject('#__testquestions_results', $row, 'id')) {
+            throw new \RuntimeException('Nie udało się zapisać oceny AI.');
+        }
+
+        return $aiResult['feedback'];
+    }
+
+    public function evaluateAllWithAi(int $id): array
+    {
+        $item = $this->getItem($id);
+
+        if (!$item) {
+            throw new \RuntimeException('Nie znaleziono zapisanego testu.');
+        }
+
+        $questionIds = [];
+        foreach ($item->answers as $questionId => $answer) {
+            $question = $item->questions[(int) $questionId] ?? null;
+            if ($question && $question->question_type === 'open' && empty($answer['correct'])) {
+                $questionIds[] = (int) $questionId;
+            }
+        }
+
+        if (!$questionIds) {
+            throw new \RuntimeException('AI_NO_OPEN_QUESTIONS');
+        }
+
+        $evaluated = 0;
+        $failed = 0;
+        $firstError = '';
+
+        foreach ($questionIds as $questionId) {
+            try {
+                $this->evaluateWithAi($id, $questionId);
+                $evaluated++;
+            } catch (\Throwable $error) {
+                $failed++;
+                $firstError = $firstError ?: $error->getMessage();
+
+                if (in_array($error->getMessage(), ['AI_NOT_CONFIGURED'], true)
+                    || str_starts_with($error->getMessage(), 'AI_KEY_EMPTY|')) {
+                    break;
+                }
+            }
+        }
+
+        return [
+            'evaluated' => $evaluated,
+            'failed' => $failed,
+            'first_error' => $firstError,
+            'total' => count($questionIds),
+        ];
+    }
 }

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

@@ -0,0 +1,136 @@
+<?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, int $maxPoints): array
+    {
+        $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 i ustal liczbę uznanych punktów.\n"
+            . "Maksymalna liczba punktów za to pytanie: " . max(0, $maxPoints) . ".\n"
+            . "Przyznaj liczbę całkowitą od 0 do maksymalnej liczby punktów. Przyznaj punkty proporcjonalnie za poprawne elementy odpowiedzi; pełne punkty za komplet, część punktów za częściową odpowiedź. Nie przekraczaj limitu.\n\n"
+            . "Pytanie:\n" . $question . "\n\n"
+            . "Wzorzec odpowiedzi:\n" . $pattern . "\n\n"
+            . "Odpowiedź ucznia:\n" . ($answer !== '' ? $answer : 'Brak odpowiedzi') . "\n\n"
+            . "Zwróć wyłącznie poprawny obiekt JSON w formacie {\"awarded_points\": liczba_całkowita, \"feedback\": \"krótka ocena po polsku\"}. W ocenie opisz poprawne i brakujące elementy. 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.');
+        }
+
+        $jsonText = preg_replace('/^```(?:json)?\s*|\s*```$/i', '', trim($text));
+        $result = json_decode($jsonText, true);
+
+        if (!is_array($result) || !isset($result['awarded_points']) || !is_numeric($result['awarded_points'])) {
+            $start = strpos($jsonText, '{');
+            $end = strrpos($jsonText, '}');
+            if ($start !== false && $end !== false && $end > $start) {
+                $result = json_decode(substr($jsonText, $start, $end - $start + 1), true);
+            }
+        }
+
+        if (!is_array($result) || !isset($result['awarded_points']) || !is_numeric($result['awarded_points'])) {
+            throw new \RuntimeException('AI zwróciło nieprawidłowy format oceny i punktów.');
+        }
+
+        $usage = $this->getUsage($body, $provider, $config['model']);
+
+        return [
+            'awarded_points' => min(max(0, $maxPoints), max(0, (int) $result['awarded_points'])),
+            'feedback' => trim((string) ($result['feedback'] ?? '')),
+            'usage' => $usage,
+        ];
+    }
+
+    private function getUsage(array $body, string $provider, string $model): ?array
+    {
+        $usage = $body['usage'] ?? null;
+        if (!is_array($usage) || !isset($usage['input_tokens'], $usage['output_tokens'])) {
+            return null;
+        }
+
+        $inputTokens = max(0, (int) $usage['input_tokens']);
+        $outputTokens = max(0, (int) $usage['output_tokens']);
+        $cachedTokens = min($inputTokens, max(0, (int) ($usage['input_tokens_details']['cached_tokens'] ?? 0)));
+        $cost = null;
+        $costSource = '';
+
+        if ($provider === 'grok' && isset($usage['cost_in_usd_ticks']) && is_numeric($usage['cost_in_usd_ticks'])) {
+            $cost = (float) $usage['cost_in_usd_ticks'] / 10000000000;
+            $costSource = 'provider';
+        } elseif ($provider === 'openai' && $model === 'gpt-4.1-mini') {
+            $uncachedTokens = $inputTokens - $cachedTokens;
+            $cost = ($uncachedTokens * 0.40 + $cachedTokens * 0.10 + $outputTokens * 1.60) / 1000000;
+            $costSource = 'token_rates';
+        }
+
+        return [
+            'provider' => $provider,
+            'model' => $model,
+            'input_tokens' => $inputTokens,
+            'output_tokens' => $outputTokens,
+            'total_tokens' => (int) ($usage['total_tokens'] ?? ($inputTokens + $outputTokens)),
+            'cached_input_tokens' => $cachedTokens,
+            'cost_usd' => $cost,
+            'cost_source' => $costSource,
+        ];
+    }
+
+    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/Ai/HtmlView.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace Komponent\Component\Testquestions\Administrator\View\Ai;
+
+defined('_JEXEC') or die;
+
+use Joomla\CMS\Factory;
+use Joomla\CMS\Language\Text;
+use Joomla\CMS\MVC\View\HtmlView as BaseHtmlView;
+use Joomla\CMS\Toolbar\ToolbarHelper;
+
+class HtmlView extends BaseHtmlView
+{
+    protected array $settings = [];
+
+    public function display($tpl = null)
+    {
+        $db = Factory::getContainer()->get('DatabaseDriver');
+        $raw = (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();
+        $this->settings = json_decode($raw, true) ?: [];
+
+        ToolbarHelper::title(Text::_('COM_TESTQUESTIONS_AI_SETTINGS'));
+        ToolbarHelper::link('index.php?option=com_testquestions&view=questions', 'COM_TESTQUESTIONS_QUESTIONS', 'arrow-left');
+
+        return parent::display($tpl);
+    }
+}

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_testquestions&view=ai',
+            'COM_TESTQUESTIONS_AI_SETTINGS_MENU',
+            'cog'
+        );
     }
 }

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

@@ -0,0 +1,58 @@
+<?php defined('_JEXEC') or die; ?>
+<?php use Joomla\CMS\HTML\HTMLHelper; ?>
+<?php use Joomla\CMS\Router\Route; ?>
+<?php $provider = (string) ($this->settings['ai_provider'] ?? 'openai'); ?>
+<?php $legacyKey = (string) ($this->settings['ai_api_key'] ?? ''); ?>
+<?php $openaiKey = (string) ($this->settings['ai_openai_api_key'] ?? ($provider === 'openai' ? $legacyKey : '')); ?>
+<?php $grokKey = (string) ($this->settings['ai_grok_api_key'] ?? ($provider === 'grok' ? $legacyKey : '')); ?>
+<form action="<?php echo Route::_('index.php?option=com_testquestions&view=ai'); ?>" method="post" name="adminForm" id="adminForm">
+    <div class="card" style="max-width: 900px;">
+        <div class="card-body">
+            <div class="mb-3">
+                <label for="ai-provider" class="form-label"><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_AI_PROVIDER'); ?></label>
+                <select id="ai-provider" name="ai_provider" class="form-select" required>
+                    <option value="openai" <?php echo $provider === 'openai' ? 'selected' : ''; ?>>OpenAI</option>
+                    <option value="grok" <?php echo $provider === 'grok' ? 'selected' : ''; ?>>Grok</option>
+                </select>
+            </div>
+            <div class="mb-3">
+                <label for="ai-openai-api-key" class="form-label"><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_AI_OPENAI_KEY'); ?></label>
+                <div class="input-group">
+                    <input type="password" id="ai-openai-api-key" name="ai_openai_api_key" value="<?php echo htmlspecialchars($openaiKey, ENT_QUOTES, 'UTF-8'); ?>" class="form-control" size="120" maxlength="4096" autocomplete="new-password">
+                    <button type="button" class="btn btn-outline-secondary" data-ai-key-toggle="ai-openai-api-key">Pokaż</button>
+                </div>
+                <small class="form-text text-muted">
+                    <?php echo $openaiKey !== '' ? 'Zapisany klucz: ' . mb_strlen($openaiKey) . ' znaków. Pozostaw pole bez zmian, aby go zachować.' : 'Nie zapisano klucza OpenAI.'; ?>
+                </small>
+            </div>
+            <div class="mb-3">
+                <label for="ai-grok-api-key" class="form-label"><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_AI_GROK_KEY'); ?></label>
+                <div class="input-group">
+                    <input type="password" id="ai-grok-api-key" name="ai_grok_api_key" value="<?php echo htmlspecialchars($grokKey, ENT_QUOTES, 'UTF-8'); ?>" class="form-control" size="120" maxlength="4096" autocomplete="new-password">
+                    <button type="button" class="btn btn-outline-secondary" data-ai-key-toggle="ai-grok-api-key">Pokaż</button>
+                </div>
+                <small class="form-text text-muted">
+                    <?php echo $grokKey !== '' ? 'Zapisany klucz: ' . mb_strlen($grokKey) . ' znaków. Pozostaw pole bez zmian, aby go zachować.' : 'Nie zapisano klucza Grok.'; ?>
+                </small>
+            </div>
+            <button type="submit" class="btn btn-primary" onclick="this.form.task.value='ai.save';">
+                <?php echo \Joomla\CMS\Language\Text::_('JTOOLBAR_SAVE'); ?>
+            </button>
+            <a class="btn btn-secondary" href="<?php echo Route::_('index.php?option=com_testquestions&view=questions'); ?>">
+                <?php echo \Joomla\CMS\Language\Text::_('JCANCEL'); ?>
+            </a>
+        </div>
+    </div>
+    <input type="hidden" name="task" value="ai.save">
+    <?php echo HTMLHelper::_('form.token'); ?>
+</form>
+<script>
+document.querySelectorAll('[data-ai-key-toggle]').forEach(function (button) {
+    button.addEventListener('click', function () {
+        const input = document.getElementById(this.dataset.aiKeyToggle);
+        const visible = input.type === 'text';
+        input.type = visible ? 'password' : 'text';
+        this.textContent = visible ? 'Pokaż' : 'Ukryj';
+    });
+});
+</script>

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

@@ -25,6 +25,37 @@
         <dd class="col-sm-9"><?php echo floor((int) $this->item->execution_time / 60); ?>:<?php echo str_pad((string) ((int) $this->item->execution_time % 60), 2, '0', STR_PAD_LEFT); ?></dd>
     </dl>
     <form action="<?php echo Route::_('index.php?option=com_testquestions&view=result&id=' . (int) $this->item->id); ?>" method="post" name="adminForm" id="adminForm">
+    <?php $pendingAiCount = 0; ?>
+    <?php foreach ($this->item->answers as $questionId => $answer) : ?>
+        <?php $candidate = $this->item->questions[(int) $questionId] ?? null; ?>
+        <?php if ($candidate && $candidate->question_type === 'open' && empty($answer['correct'])) { $pendingAiCount++; } ?>
+    <?php endforeach; ?>
+    <?php if ($pendingAiCount > 0) : ?>
+        <div class="mb-3">
+            <button type="submit" class="btn btn-primary" formaction="<?php echo Route::_('index.php?option=com_testquestions&task=result.aiAll&id=' . (int) $this->item->id); ?>" onclick="this.form.task.value='result.aiAll';">
+                <?php echo \Joomla\CMS\Language\Text::sprintf('COM_TESTQUESTIONS_AI_EVALUATE_ALL', $pendingAiCount); ?>
+            </button>
+            <?php
+            $usageTotals = ['input_tokens' => 0, 'output_tokens' => 0, 'total_tokens' => 0, 'cost_usd' => 0.0, 'providers' => []];
+            foreach ($this->item->answers as $savedAnswer) {
+                $usage = $savedAnswer['ai_usage'] ?? null;
+                if (!is_array($usage)) continue;
+                $usageTotals['input_tokens'] += (int) ($usage['input_tokens'] ?? 0);
+                $usageTotals['output_tokens'] += (int) ($usage['output_tokens'] ?? 0);
+                $usageTotals['total_tokens'] += (int) ($usage['total_tokens'] ?? 0);
+                if (is_numeric($usage['cost_usd'] ?? null)) $usageTotals['cost_usd'] += (float) $usage['cost_usd'];
+                if (!empty($usage['provider'])) $usageTotals['providers'][(string) $usage['provider']] = true;
+            }
+            ?>
+            <?php if ($usageTotals['total_tokens'] > 0) : ?>
+                <span class="badge text-bg-light border ms-2" title="Suma dotychczasowych ocen AI">
+                    ✦ <?php echo implode(' + ', array_map('htmlspecialchars', array_keys($usageTotals['providers']))); ?>:
+                    <?php echo number_format($usageTotals['total_tokens'], 0, ',', ' '); ?> tokenów,
+                    <?php echo number_format($usageTotals['cost_usd'], 8, ',', ' '); ?> USD
+                </span>
+            <?php endif; ?>
+        </div>
+    <?php endif; ?>
     <h2><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_RESULT_ANSWERS'); ?></h2>
     <?php foreach ($this->item->answers as $questionId => $answer) : ?>
         <?php $question = $this->item->questions[(int) $questionId] ?? null; if (!$question) continue; ?>
@@ -38,16 +69,39 @@
             <?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'])) : ?>
-                <div class="row mt-3">
+                <?php if ($question->question_type === 'open') : ?>
-                    <div class="col-md-3">
+                    <div class="mt-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>
+                        <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">
-                        <input type="number" min="0" max="<?php echo (int) ($question->points ?? 0); ?>" name="awarded_points[<?php echo (int) $questionId; ?>]" id="awarded-points-<?php echo (int) $questionId; ?>" class="form-control" value="<?php echo (int) ($answer['awarded_points'] ?? 0); ?>">
+                            <?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_AI_EVALUATE'); ?>
+                        </button>
+                        <?php if (!empty($answer['ai_usage']) && is_array($answer['ai_usage'])) : ?>
+                            <?php $usage = $answer['ai_usage']; ?>
+                            <?php $usageProvider = (string) ($usage['provider'] ?? ''); ?>
+                            <span class="badge text-bg-light border ms-2" title="<?php echo $usageProvider === 'grok' ? 'Koszt zwrócony przez dostawcę' : 'Koszt obliczony z faktycznie wykorzystanych tokenów i stawek modelu'; ?>">
+                                <?php echo $usageProvider === 'grok' ? '✦ Grok' : '◉ OpenAI'; ?> ·
+                                <?php echo number_format((int) ($usage['input_tokens'] ?? 0), 0, ',', ' '); ?> in /
+                                <?php echo number_format((int) ($usage['output_tokens'] ?? 0), 0, ',', ' '); ?> out ·
+                                <?php echo is_numeric($usage['cost_usd'] ?? null) ? number_format((float) $usage['cost_usd'], 8, ',', ' ') . ' USD' : 'koszt niedostępny'; ?>
+                                <?php echo ($usage['cost_source'] ?? '') === 'token_rates' ? ' (wyliczony)' : ''; ?>
+                            </span>
+                        <?php endif; ?>
                     </div>
-                    <div class="col-md-9">
+                    <?php if (!empty($answer['ai_feedback'])) : ?>
-                        <label for="result-comment-<?php echo (int) $questionId; ?>" class="form-label"><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_RESULT_COMMENT'); ?></label>
+                        <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>
-                        <textarea name="comments[<?php echo (int) $questionId; ?>]" id="result-comment-<?php echo (int) $questionId; ?>" class="form-control" rows="2"><?php echo htmlspecialchars((string) ($answer['comment'] ?? ''), ENT_QUOTES, 'UTF-8'); ?></textarea>
+                    <?php endif; ?>
+                <?php endif; ?>
+                <?php if ($question->question_type === 'open') : ?>
+                    <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>
+                            <input type="number" min="0" max="<?php echo (int) ($question->points ?? 0); ?>" name="awarded_points[<?php echo (int) $questionId; ?>]" id="awarded-points-<?php echo (int) $questionId; ?>" class="form-control" value="<?php echo (int) ($answer['awarded_points'] ?? 0); ?>">
+                        </div>
+                        <div class="col-md-9">
+                            <label for="result-comment-<?php echo (int) $questionId; ?>" class="form-label"><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_RESULT_COMMENT'); ?></label>
+                            <textarea name="comments[<?php echo (int) $questionId; ?>]" id="result-comment-<?php echo (int) $questionId; ?>" class="form-control" rows="2"><?php echo htmlspecialchars((string) ($answer['comment'] ?? ''), ENT_QUOTES, 'UTF-8'); ?></textarea>
+                        </div>
                     </div>
-                </div>
+                <?php endif; ?>
             <?php endif; ?>
         </article>
     <?php endforeach; ?>

administrator/components/com_testquestions/tmpl/set/edit.php

@@ -8,6 +8,7 @@ use Joomla\CMS\Router\Route;
 HTMLHelper::_('behavior.formvalidator');
 ?>
 <form action="<?php echo Route::_('index.php?option=com_testquestions&view=set&layout=edit&id=' . (int) $this->item->id); ?>" method="post" name="adminForm" id="adminForm" class="form-validate">
+    <?php $canOrderQuestions = $this->isVariant || (string) $this->item->set_type === 'ordinary'; ?>
     <fieldset class="adminform">
         <?php echo $this->form->renderField('parent_id'); ?>
         <?php if ($this->isVariant) : ?>
@@ -51,10 +52,14 @@ HTMLHelper::_('behavior.formvalidator');
         <?php if (!((string) $this->item->set_type === 'multi' && (int) $this->item->parent_id === 0)) : ?>
         <fieldset class="mb-3">
             <legend><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_SET_SELECTED_QUESTIONS'); ?></legend>
-            <div id="set-selected-question-list" class="border rounded p-3">
+            <?php if ($canOrderQuestions) : ?>
-                <?php foreach ($this->questions as $question) : ?>
+                <div class="form-text mb-2"><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_SET_REORDER_INFO'); ?></div>
-                    <?php if (!in_array((int) $question->id, array_map('intval', (array) $this->item->question_ids), true)) continue; ?>
+            <?php endif; ?>
-                    <div class="form-check set-question-row">
+            <div id="set-selected-question-list" class="border rounded p-3" data-sortable="<?php echo $canOrderQuestions ? '1' : '0'; ?>">
+                <?php $questionsById = []; foreach ($this->questions as $availableQuestion) : $questionsById[(int) $availableQuestion->id] = $availableQuestion; endforeach; ?>
+                <?php foreach ((array) $this->item->question_ids as $selectedQuestionId) : ?>
+                    <?php $question = $questionsById[(int) $selectedQuestionId] ?? null; if (!$question) continue; ?>
+                    <div class="form-check set-question-row"<?php echo $canOrderQuestions ? ' draggable="true"' : ''; ?>>
                         <input class="form-check-input" type="checkbox" name="jform[question_ids][]" value="<?php echo (int) $question->id; ?>" id="set-question-<?php echo (int) $question->id; ?>" checked>
                         <label class="form-check-label" for="set-question-<?php echo (int) $question->id; ?>">
                             <span class="badge bg-secondary"><?php echo $this->escape($question->category_title ?: \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_UNCATEGORIZED')); ?></span>
@@ -124,6 +129,47 @@ HTMLHelper::_('behavior.formvalidator');
     <?php echo HTMLHelper::_('form.token'); ?>
 </form>
 <script>
+document.addEventListener('DOMContentLoaded', function () {
+    const list = document.getElementById('set-selected-question-list');
+
+    if (!list || list.dataset.sortable !== '1') {
+        return;
+    }
+
+    let dragged = null;
+
+    list.querySelectorAll('.set-question-row[draggable="true"]').forEach(function (row) {
+        row.addEventListener('dragstart', function (event) {
+            dragged = row;
+            row.classList.add('opacity-50');
+            event.dataTransfer.effectAllowed = 'move';
+        });
+
+        row.addEventListener('dragend', function () {
+            row.classList.remove('opacity-50');
+            dragged = null;
+        });
+
+        row.addEventListener('dragover', function (event) {
+            event.preventDefault();
+            event.dataTransfer.dropEffect = 'move';
+        });
+
+        row.addEventListener('drop', function (event) {
+            event.preventDefault();
+
+            if (!dragged || dragged === row) {
+                return;
+            }
+
+            const rect = row.getBoundingClientRect();
+            const insertAfter = event.clientY > rect.top + rect.height / 2;
+            list.insertBefore(dragged, insertAfter ? row.nextSibling : row);
+        });
+    });
+});
+</script>
+<script>
 document.addEventListener('DOMContentLoaded', function () {
     const filter = document.getElementById('set-question-category');
     const rows = document.querySelectorAll('.set-available-question-row');

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.39.0</version>
+    <version>1.43.4</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>

components/com_testquestions/src/Model/SetModel.php

@@ -10,6 +10,7 @@ use Joomla\CMS\MVC\Model\BaseDatabaseModel;
 class SetModel extends BaseDatabaseModel
 {
     protected $resolvedSetId;
+    protected $randomizeQuestions = true;
 
     protected function getSetId(): int
     {
@@ -44,6 +45,7 @@ class SetModel extends BaseDatabaseModel
         }
 
         $this->resolvedSetId = $setId;
+        $this->randomizeQuestions = $set->set_type !== 'multi';
 
         if ($set->set_type === 'multi') {
             $variantId = (int) $db->setQuery(
@@ -74,15 +76,16 @@ class SetModel extends BaseDatabaseModel
             return [];
         }
 
-        return $db->setQuery(
+        $query = $db->getQuery(true)
-            $db->getQuery(true)
                 ->select(['q.id', 'q.question_type', 'q.question', 'q.answer_a', 'q.answer_b', 'q.answer_c', 'q.answer_d', 'q.answer_open', 'q.correct_answer', 'q.points', 'q.image'])
                 ->from($db->quoteName('#__testquestions_set_questions', 'sq'))
                 ->innerJoin($db->quoteName('#__testquestions_questions', 'q') . ' ON q.id = sq.question_id')
                 ->where('sq.set_id = ' . $setId)
-                ->where('q.published = 1')
+                ->where('q.published = 1');
-                ->order('sq.ordering ASC, q.id ASC')
+
-        )->loadObjectList();
+        $query->order($this->randomizeQuestions ? 'RAND()' : 'sq.ordering ASC, q.id ASC');
+
+        return $db->setQuery($query)->loadObjectList();
     }
 
     public function getSets()