Show AI token usage per saved test

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.43.7).
+W Joomla wybierz **System → Install → Install from Folder** i wskaż ten katalog. Manifestem instalacyjnym jest `com_testquestions.xml` (wersja 1.43.9).
 
 Po instalacji komponent jest dostępny w panelu administratora jako **Pytania testowe**.

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

@@ -70,18 +70,13 @@ COM_TESTQUESTIONS_AI_GROK_KEY="Klucz API Grok"
 COM_TESTQUESTIONS_AI_OPENAI_MODEL="Model OpenAI"
 COM_TESTQUESTIONS_AI_GROK_MODEL="Model Grok"
 COM_TESTQUESTIONS_AI_MODEL_INVALID="Wybierz prawidłowy model dla każdego dostawcy AI."
-COM_TESTQUESTIONS_AI_BALANCE="Saldo kont API"
+COM_TESTQUESTIONS_AI_TOKEN_USAGE="Wykorzystanie tokenów API"
-COM_TESTQUESTIONS_AI_OPENAI_BALANCE_INFO="OpenAI nie udostępnia salda przedpłaconych środków przez zwykłe API. Saldo sprawdzisz w panelu rozliczeń: "
+COM_TESTQUESTIONS_AI_TOKEN_USAGE_INFO="Suma użycia zapisanego przy ocenach AI we wszystkich wynikach testów. Powtórne oceny są zliczane, jeśli zostały wykonane po tej aktualizacji."
-COM_TESTQUESTIONS_AI_OPENAI_BILLING_LINK="Otwórz rozliczenia OpenAI"
+COM_TESTQUESTIONS_AI_USAGE_CALLS="Liczba ocen"
-COM_TESTQUESTIONS_AI_GROK_TEAM_ID="ID zespołu xAI"
+COM_TESTQUESTIONS_AI_USAGE_INPUT="Tokeny wejściowe"
-COM_TESTQUESTIONS_AI_GROK_MANAGEMENT_KEY="Klucz zarządzający xAI"
+COM_TESTQUESTIONS_AI_USAGE_OUTPUT="Tokeny wyjściowe"
-COM_TESTQUESTIONS_AI_GROK_MANAGEMENT_KEY_SAVED="Klucz zarządzający jest zapisany. Pozostaw pole bez zmian, aby go zachować."
+COM_TESTQUESTIONS_AI_USAGE_TOTAL="Razem tokenów"
-COM_TESTQUESTIONS_AI_GROK_MANAGEMENT_KEY_INFO="Wymagany jest osobny Management API key z xAI Console → Settings → Management Keys."
+COM_TESTQUESTIONS_AI_USAGE_COST="Koszt zapisany"
-COM_TESTQUESTIONS_AI_CHECK_GROK_BALANCE="Sprawdź saldo xAI"
-COM_TESTQUESTIONS_AI_GROK_BALANCE_INFO="Odczyt dotyczy dostępnych kredytów przedpłaconych zespołu xAI. Nie obejmuje limitu rozliczeń postpaid."
-COM_TESTQUESTIONS_AI_GROK_BALANCE_CONFIG_REQUIRED="Aby sprawdzić saldo xAI, wpisz ID zespołu i klucz zarządzający, a następnie ponów próbę."
-COM_TESTQUESTIONS_AI_GROK_BALANCE_FAILED="Nie udało się odczytać salda xAI. Sprawdź ID zespołu, klucz zarządzający i jego uprawnienia."
-COM_TESTQUESTIONS_AI_GROK_BALANCE_RESULT="Dostępne kredyty przedpłacone xAI: $%s USD"
 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."
@@ -111,6 +106,7 @@ COM_TESTQUESTIONS_RESULTS="Zapisane testy"
 COM_TESTQUESTIONS_RESULT_PREVIEW="Podgląd zapisanego testu"
 COM_TESTQUESTIONS_RESULT_NOT_FOUND="Nie znaleziono zapisanego testu."
 COM_TESTQUESTIONS_RESULT_PARTICIPANT="Użytkownik"
+COM_TESTQUESTIONS_RESULT_AI_TOKENS="Tokeny AI"
 COM_TESTQUESTIONS_RESULT_SCORE="Wynik"
 COM_TESTQUESTIONS_RESULT_POINTS_BEFORE_AFTER="Punkty przed / po korekcie"
 COM_TESTQUESTIONS_RESULT_GRADE="Ocena"

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

@@ -0,0 +1,5 @@
+UPDATE `#__extensions`
+SET `params` = JSON_REMOVE(`params`, '$.ai_grok_team_id', '$.ai_grok_management_key')
+WHERE `type` = 'component'
+  AND `element` = 'com_testquestions'
+  AND JSON_VALID(`params`);

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

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

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

@@ -5,7 +5,6 @@ namespace Komponent\Component\Testquestions\Administrator\Controller;
 defined('_JEXEC') or die;
 
 use Joomla\CMS\Factory;
-use Joomla\CMS\Http\HttpFactory;
 use Joomla\CMS\Language\Text;
 use Joomla\CMS\MVC\Controller\BaseController;
 use Joomla\CMS\Router\Route;
@@ -24,55 +23,6 @@ class AiController extends BaseController
         );
     }
 
-    public function checkbalance(): void
-    {
-        $settings = $this->saveSettings();
-        $teamId = trim((string) ($settings['ai_grok_team_id'] ?? ''));
-        $managementKey = trim((string) ($settings['ai_grok_management_key'] ?? ''));
-
-        if ($teamId === '' || $managementKey === '') {
-            $this->setRedirect(
-                Route::_('index.php?option=com_testquestions&view=ai', false),
-                Text::_('COM_TESTQUESTIONS_AI_GROK_BALANCE_CONFIG_REQUIRED'),
-                'warning'
-            );
-            return;
-        }
-
-        try {
-            $response = HttpFactory::getHttp()->get(
-                'https://management-api.x.ai/v1/billing/teams/' . rawurlencode($teamId) . '/prepaid/balance',
-                ['Authorization' => 'Bearer ' . $managementKey, 'Accept' => 'application/json'],
-                30
-            );
-        } catch (\Throwable $error) {
-            $this->setRedirect(
-                Route::_('index.php?option=com_testquestions&view=ai', false),
-                Text::_('COM_TESTQUESTIONS_AI_GROK_BALANCE_FAILED'),
-                'error'
-            );
-            return;
-        }
-
-        $body = json_decode((string) $response->body, true);
-        if ((int) $response->code < 200 || (int) $response->code >= 300 || !isset($body['total']['val']) || !is_numeric($body['total']['val'])) {
-            $this->setRedirect(
-                Route::_('index.php?option=com_testquestions&view=ai', false),
-                Text::_('COM_TESTQUESTIONS_AI_GROK_BALANCE_FAILED'),
-                'error'
-            );
-            return;
-        }
-
-        $balance = abs((float) $body['total']['val']) / 100;
-        $message = Text::sprintf('COM_TESTQUESTIONS_AI_GROK_BALANCE_RESULT', number_format($balance, 2, ',', ' '));
-        $this->setRedirect(
-            Route::_('index.php?option=com_testquestions&view=ai', false),
-            $message,
-            'message'
-        );
-    }
-
     private function saveSettings(): array
     {
         if (!Session::checkToken()) {
@@ -132,15 +82,8 @@ class AiController extends BaseController
             }
         }
 
-        $teamId = trim((string) $input->post->get('ai_grok_team_id', '', 'STRING'));
-        if ($teamId !== '') {
-            $settings['ai_grok_team_id'] = $teamId;
-        }
-        $managementKey = trim((string) $input->post->get('ai_grok_management_key', '', 'RAW'));
-        if ($managementKey !== '') {
-            $settings['ai_grok_management_key'] = $managementKey;
-        }
         unset($settings['ai_api_key']);
+        unset($settings['ai_grok_team_id'], $settings['ai_grok_management_key']);
 
         $extension = (object) [
             'extension_id' => (int) $row->extension_id,

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

@@ -161,6 +161,14 @@ class ResultModel extends BaseDatabaseModel
         $item->answers[$questionId]['ai_feedback'] = $aiResult['feedback'];
         $item->answers[$questionId]['awarded_points'] = $aiResult['awarded_points'];
         if ($aiResult['usage'] !== null) {
+            $history = $item->answers[$questionId]['ai_usage_history'] ?? null;
+            if (!is_array($history)) {
+                $history = !empty($item->answers[$questionId]['ai_usage']) && is_array($item->answers[$questionId]['ai_usage'])
+                    ? [$item->answers[$questionId]['ai_usage']]
+                    : [];
+            }
+            $history[] = $aiResult['usage'];
+            $item->answers[$questionId]['ai_usage_history'] = $history;
             $item->answers[$questionId]['ai_usage'] = $aiResult['usage'];
         }
 

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

@@ -9,6 +9,48 @@ use Joomla\CMS\MVC\Model\ListModel;
 
 class ResultsModel extends ListModel
 {
+    public function getItems()
+    {
+        $items = parent::getItems();
+
+        foreach ($items as $item) {
+            $item->ai_input_tokens = 0;
+            $item->ai_output_tokens = 0;
+            $item->ai_total_tokens = 0;
+            $item->ai_cost_usd = 0.0;
+
+            $answers = json_decode((string) ($item->answers ?? ''), true);
+            if (!is_array($answers)) {
+                continue;
+            }
+
+            foreach ($answers as $answer) {
+                if (!is_array($answer)) {
+                    continue;
+                }
+
+                $usages = $answer['ai_usage_history'] ?? (isset($answer['ai_usage']) ? [$answer['ai_usage']] : []);
+                if (!is_array($usages)) {
+                    continue;
+                }
+
+                foreach ($usages as $usage) {
+                    if (!is_array($usage)) {
+                        continue;
+                    }
+                    $item->ai_input_tokens += (int) ($usage['input_tokens'] ?? 0);
+                    $item->ai_output_tokens += (int) ($usage['output_tokens'] ?? 0);
+                    $item->ai_total_tokens += (int) ($usage['total_tokens'] ?? 0);
+                    if (is_numeric($usage['cost_usd'] ?? null)) {
+                        $item->ai_cost_usd += (float) $usage['cost_usd'];
+                    }
+                }
+            }
+        }
+
+        return $items;
+    }
+
     protected function populateState($ordering = 'r.created', $direction = 'desc')
     {
         parent::populateState($ordering, $direction);

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

@@ -12,6 +12,7 @@ use Joomla\CMS\Toolbar\ToolbarHelper;
 class HtmlView extends BaseHtmlView
 {
     protected array $settings = [];
+    protected array $usageTotals = [];
 
     public function display($tpl = null)
     {
@@ -24,6 +25,54 @@ class HtmlView extends BaseHtmlView
                 ->where($db->quoteName('element') . ' = ' . $db->quote('com_testquestions'))
         )->loadResult();
         $this->settings = json_decode($raw, true) ?: [];
+        $this->usageTotals = [
+            'openai' => ['calls' => 0, 'input_tokens' => 0, 'output_tokens' => 0, 'total_tokens' => 0, 'cost_usd' => 0.0, 'cost_calls' => 0],
+            'grok' => ['calls' => 0, 'input_tokens' => 0, 'output_tokens' => 0, 'total_tokens' => 0, 'cost_usd' => 0.0, 'cost_calls' => 0],
+        ];
+
+        $usageRows = $db->setQuery(
+            $db->getQuery(true)
+                ->select($db->quoteName('answers'))
+                ->from($db->quoteName('#__testquestions_results'))
+                ->where($db->quoteName('answers') . ' LIKE ' . $db->quote('%ai_usage%'))
+        )->loadColumn();
+
+        foreach ($usageRows as $answersJson) {
+            $answers = json_decode((string) $answersJson, true);
+            if (!is_array($answers)) {
+                continue;
+            }
+
+            foreach ($answers as $answer) {
+                if (!is_array($answer)) {
+                    continue;
+                }
+
+                $usages = $answer['ai_usage_history'] ?? (isset($answer['ai_usage']) ? [$answer['ai_usage']] : []);
+                if (!is_array($usages)) {
+                    continue;
+                }
+
+                foreach ($usages as $usage) {
+                    if (!is_array($usage)) {
+                        continue;
+                    }
+                    $provider = (string) ($usage['provider'] ?? '');
+                    if (!isset($this->usageTotals[$provider])) {
+                        continue;
+                    }
+
+                    $this->usageTotals[$provider]['calls']++;
+                    $this->usageTotals[$provider]['input_tokens'] += (int) ($usage['input_tokens'] ?? 0);
+                    $this->usageTotals[$provider]['output_tokens'] += (int) ($usage['output_tokens'] ?? 0);
+                    $this->usageTotals[$provider]['total_tokens'] += (int) ($usage['total_tokens'] ?? 0);
+                    if (is_numeric($usage['cost_usd'] ?? null)) {
+                        $this->usageTotals[$provider]['cost_usd'] += (float) $usage['cost_usd'];
+                        $this->usageTotals[$provider]['cost_calls']++;
+                    }
+                }
+            }
+        }
 
         ToolbarHelper::title(Text::_('COM_TESTQUESTIONS_AI_SETTINGS'));
         ToolbarHelper::link('index.php?option=com_testquestions&view=questions', 'COM_TESTQUESTIONS_QUESTIONS', 'arrow-left');

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

@@ -2,6 +2,7 @@
 <?php use Joomla\CMS\HTML\HTMLHelper; ?>
 <?php use Joomla\CMS\Router\Route; ?>
 <?php $availableModels = \Komponent\Component\Testquestions\Administrator\Service\AiService::availableModels(); ?>
+<?php $usageTotals = $this->usageTotals; ?>
 <?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 : '')); ?>
@@ -55,29 +56,35 @@
                 </select>
             </div>
             <hr>
-            <h3><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_AI_BALANCE'); ?></h3>
+            <h3><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_AI_TOKEN_USAGE'); ?></h3>
-            <div class="alert alert-info">
+            <p class="text-muted"><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_AI_TOKEN_USAGE_INFO'); ?></p>
-                <?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_AI_OPENAI_BALANCE_INFO'); ?>
+            <div class="table-responsive">
-                <a href="https://platform.openai.com/settings/organization/billing/overview" target="_blank" rel="noopener noreferrer"><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_AI_OPENAI_BILLING_LINK'); ?></a>
+                <table class="table table-striped">
+                    <thead>
+                        <tr>
+                            <th><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_AI_PROVIDER'); ?></th>
+                            <th><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_AI_USAGE_CALLS'); ?></th>
+                            <th><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_AI_USAGE_INPUT'); ?></th>
+                            <th><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_AI_USAGE_OUTPUT'); ?></th>
+                            <th><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_AI_USAGE_TOTAL'); ?></th>
+                            <th><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_AI_USAGE_COST'); ?></th>
+                        </tr>
+                    </thead>
+                    <tbody>
+                        <?php foreach (['openai' => 'OpenAI', 'grok' => 'Grok'] as $usageProvider => $usageProviderLabel) : ?>
+                            <?php $providerUsage = $usageTotals[$usageProvider]; ?>
+                            <tr>
+                                <th><?php echo $usageProviderLabel; ?></th>
+                                <td><?php echo number_format($providerUsage['calls'], 0, ',', ' '); ?></td>
+                                <td><?php echo number_format($providerUsage['input_tokens'], 0, ',', ' '); ?></td>
+                                <td><?php echo number_format($providerUsage['output_tokens'], 0, ',', ' '); ?></td>
+                                <td><?php echo number_format($providerUsage['total_tokens'], 0, ',', ' '); ?></td>
+                                <td><?php echo $providerUsage['cost_calls'] > 0 ? number_format($providerUsage['cost_usd'], 8, ',', ' ') . ' USD' : '—'; ?></td>
+                            </tr>
+                        <?php endforeach; ?>
+                    </tbody>
+                </table>
             </div>
-            <div class="mb-3">
-                <label for="ai-grok-team-id" class="form-label"><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_AI_GROK_TEAM_ID'); ?></label>
-                <input type="text" id="ai-grok-team-id" name="ai_grok_team_id" class="form-control" maxlength="255" value="<?php echo htmlspecialchars((string) ($this->settings['ai_grok_team_id'] ?? ''), ENT_QUOTES, 'UTF-8'); ?>">
-            </div>
-            <div class="mb-3">
-                <label for="ai-grok-management-key" class="form-label"><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_AI_GROK_MANAGEMENT_KEY'); ?></label>
-                <div class="input-group">
-                    <input type="password" id="ai-grok-management-key" name="ai_grok_management_key" value="<?php echo htmlspecialchars((string) ($this->settings['ai_grok_management_key'] ?? ''), ENT_QUOTES, 'UTF-8'); ?>" class="form-control" maxlength="4096" autocomplete="new-password">
-                    <button type="button" class="btn btn-outline-secondary" data-ai-key-toggle="ai-grok-management-key">Pokaż</button>
-                </div>
-                <small class="form-text text-muted">
-                    <?php echo !empty($this->settings['ai_grok_management_key']) ? \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_AI_GROK_MANAGEMENT_KEY_SAVED') : \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_AI_GROK_MANAGEMENT_KEY_INFO'); ?>
-                </small>
-            </div>
-            <button type="submit" class="btn btn-outline-primary" onclick="this.form.task.value='ai.checkbalance';">
-                <?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_AI_CHECK_GROK_BALANCE'); ?>
-            </button>
-            <div class="form-text mt-2"><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_AI_GROK_BALANCE_INFO'); ?></div>
             <hr>
             <button type="submit" class="btn btn-primary" onclick="this.form.task.value='ai.save';">
                 <?php echo \Joomla\CMS\Language\Text::_('JTOOLBAR_SAVE'); ?>

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

@@ -38,6 +38,7 @@ use Joomla\CMS\Router\Route;
             <th><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_RESULT_PARTICIPANT'); ?></th>
             <th><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_SET_TITLE'); ?></th>
             <th><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_RESULT_POINTS_BEFORE_AFTER'); ?></th>
+            <th><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_RESULT_AI_TOKENS'); ?></th>
             <th><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_RESULT_GRADE'); ?></th>
             <th><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_RESULT_EXECUTION_TIME'); ?></th>
             <th><?php echo \Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_RESULT_DATE'); ?></th>
@@ -55,6 +56,18 @@ use Joomla\CMS\Router\Route;
                     <?php if ($pointsAfterPercentage >= $gradeScale[1]) { $grade = $gradeScale[0]; break; } ?>
                 <?php endforeach; ?>
                 <td><?php echo (int) $item->points_before; ?> (<?php echo $pointsBeforePercentage; ?>%) / <?php echo (int) $item->points_after; ?> (<?php echo $pointsAfterPercentage; ?>%)</td>
+                <td>
+                    <?php if ($item->ai_total_tokens > 0) : ?>
+                        <?php echo number_format((int) $item->ai_total_tokens, 0, ',', ' '); ?> <?php echo $this->escape(\Joomla\CMS\Language\Text::_('COM_TESTQUESTIONS_AI_USAGE_TOTAL')); ?>
+                        <small class="d-block text-muted">
+                            <?php echo number_format((int) $item->ai_input_tokens, 0, ',', ' '); ?> in /
+                            <?php echo number_format((int) $item->ai_output_tokens, 0, ',', ' '); ?> out
+                            <?php if ($item->ai_cost_usd > 0) : ?> · <?php echo number_format((float) $item->ai_cost_usd, 8, ',', ' '); ?> USD<?php endif; ?>
+                        </small>
+                    <?php else : ?>
+                        —
+                    <?php endif; ?>
+                </td>
                 <td><?php echo $this->escape($grade); ?></td>
                 <td><?php echo floor((int) $item->execution_time / 60); ?>:<?php echo str_pad((string) ((int) $item->execution_time % 60), 2, '0', STR_PAD_LEFT); ?></td>
                 <td><?php echo HTMLHelper::_('date', $item->created, 'Y-m-d H:i'); ?></td>

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.43.7</version>
+    <version>1.43.9</version>
     <description>COM_TESTQUESTIONS_DESCRIPTION</description>
     <element>com_testquestions</element>
     <namespace path="src">Komponent\Component\Testquestions</namespace>