1.5.0

bro.config.js

@@ -23,6 +23,7 @@ module.exports = {
   features: {
     'challenge-admin': {
       'use-chain-submissions-api': { value: 'true' },
+      'submissions-polling-interval-ms': { value: '1200' },
     },
   },
   config: {

docs/CHALLENGE_LEARNING_MATERIAL.md

@@ -0,0 +1,202 @@
+# Добавление поля learningMaterial в задачу челленджа
+
+## Описание изменений
+
+В модель задачи челленджа (`ChallengeTask`) добавлено новое необязательное текстовое поле `learningMaterial` для хранения дополнительной обучающей информации в формате Markdown.
+
+## Структура данных
+
+### Модель ChallengeTask
+
+```typescript
+{
+  title: string,           // Заголовок задания (обязательное)
+  description: string,     // Основное описание в Markdown (обязательное, видно студентам)
+  learningMaterial: string, // Дополнительный учебный материал в Markdown (необязательное, видно студентам)
+  hiddenInstructions: string, // Скрытые инструкции для LLM (необязательное, только для преподавателей)
+  createdAt: Date,         // Дата создания
+  updatedAt: Date,         // Дата последнего обновления
+  creator: Object          // Данные создателя из Keycloak
+}
+```
+
+## Изменения в API
+
+### 1. Создание задания (POST /challenge/task)
+
+**Добавлено поле в тело запроса:**
+```json
+{
+  "title": "Название задания",
+  "description": "Основное описание в Markdown",
+  "learningMaterial": "Дополнительный учебный материал в Markdown",
+  "hiddenInstructions": "Скрытые инструкции для преподавателей"
+}
+```
+
+**Пример запроса:**
+```bash
+POST /challenge/task
+Content-Type: application/json
+
+{
+  "title": "Реализация алгоритма сортировки",
+  "description": "Напишите функцию сортировки массива методом пузырька",
+  "learningMaterial": "## Теория\n\nМетод пузырьковой сортировки работает путем...\n\n## Полезные ссылки\n- [Википедия](https://ru.wikipedia.org/wiki/Сортировка_пузырьком)\n- [Видео объяснение](https://example.com/video)",
+  "hiddenInstructions": "Оценить эффективность алгоритма и стиль кода"
+}
+```
+
+### 2. Обновление задания (PUT /challenge/task/:taskId)
+
+**Добавлено поле в тело запроса:**
+```json
+{
+  "title": "Новое название",
+  "description": "Обновленное описание",
+  "learningMaterial": "Обновленный учебный материал",
+  "hiddenInstructions": "Обновленные инструкции"
+}
+```
+
+## Получение данных
+
+### Получение задания (GET /challenge/task/:taskId)
+
+**Ответ содержит новое поле:**
+```json
+{
+  "id": "task_id",
+  "title": "Название задания",
+  "description": "Основное описание в Markdown",
+  "learningMaterial": "Дополнительный учебный материал в Markdown",
+  "createdAt": "2025-01-15T10:00:00.000Z",
+  "updatedAt": "2025-01-15T10:30:00.000Z"
+}
+```
+
+**Важно:** Поле `learningMaterial` видно всем пользователям (студентам и преподавателям), в отличие от `hiddenInstructions`, которое скрывается от студентов.
+
+### Получение всех заданий (GET /challenge/tasks)
+
+Возвращает массив заданий с новым полем `learningMaterial`.
+
+### Получение цепочек (GET /challenge/chains, GET /challenge/chain/:chainId)
+
+При получении цепочек с populate заданий, поле `learningMaterial` будет доступно в каждом задании цепочки.
+
+## Frontend изменения
+
+### Интерфейсы TypeScript
+
+```typescript
+interface ChallengeTask {
+  id: string;
+  title: string;
+  description: string;     // Markdown
+  learningMaterial?: string; // Новое поле - дополнительный материал в Markdown
+  createdAt: string;
+  updatedAt: string;
+}
+```
+
+### Формы создания/редактирования заданий
+
+В формах создания и редактирования заданий необходимо добавить поле для ввода `learningMaterial`:
+
+```typescript
+// Пример компонента формы
+const TaskForm = () => {
+  const [formData, setFormData] = useState({
+    title: '',
+    description: '',
+    learningMaterial: '', // Новое поле
+    hiddenInstructions: ''
+  });
+
+  // Визуальный редактор или textarea для learningMaterial
+  return (
+    <form>
+      <input name="title" value={formData.title} />
+      <textarea name="description" value={formData.description} />
+
+      {/* Новое поле для дополнительного материала */}
+      <label>Дополнительный учебный материал (Markdown)</label>
+      <textarea
+        name="learningMaterial"
+        value={formData.learningMaterial}
+        placeholder="Дополнительные объяснения, ссылки, примеры..."
+      />
+
+      {/* Только для преподавателей */}
+      <textarea name="hiddenInstructions" value={formData.hiddenInstructions} />
+    </form>
+  );
+};
+```
+
+### Отображение заданий
+
+При отображении задания студентам показывать `learningMaterial` как дополнительную информацию:
+
+```typescript
+const TaskView = ({ task }: { task: ChallengeTask }) => {
+  return (
+    <div>
+      <h1>{task.title}</h1>
+
+      {/* Основное описание */}
+      <div dangerouslySetInnerHTML={{ __html: marked(task.description) }} />
+
+      {/* Дополнительный учебный материал */}
+      {task.learningMaterial && (
+        <div className="learning-material">
+          <h2>Дополнительные материалы</h2>
+          <div dangerouslySetInnerHTML={{ __html: marked(task.learningMaterial) }} />
+        </div>
+      )}
+    </div>
+  );
+};
+```
+
+## Миграция данных
+
+Поле `learningMaterial` добавлено как необязательное с значением по умолчанию `''`, поэтому:
+- Существующие задания будут работать без изменений
+- Новое поле будет пустым для старых заданий
+- Можно постепенно добавлять учебный материал к существующим заданиям
+
+## Тестирование
+
+### Создание задания с учебным материалом
+```bash
+# Создать задание с дополнительным материалом
+POST /challenge/task
+{
+  "title": "Тестовое задание",
+  "description": "Основное задание",
+  "learningMaterial": "# Полезная информация\n\nЭто дополнительный материал для студентов"
+}
+```
+
+### Получение задания
+```bash
+GET /challenge/task/{taskId}
+# Проверить, что learningMaterial присутствует в ответе
+```
+
+### Обновление учебного материала
+```bash
+PUT /challenge/task/{taskId}
+{
+  "learningMaterial": "# Обновленная информация\n\nНовые полезные материалы..."
+}
+```
+
+## Влияние на существующий код
+
+- Все существующие эндпоинты получения данных автоматически возвращают новое поле
+- Создание заданий без указания `learningMaterial` работает как прежде
+- Фильтрация и валидация не затрагиваются
+- Поле индексируется MongoDB автоматически

locales/en.json

@@ -20,6 +20,9 @@
   "challenge.admin.tasks.field.description": "Description (Markdown)",
   "challenge.admin.tasks.field.description.placeholder": "# Task title\n\nTask description in Markdown format...",
   "challenge.admin.tasks.field.description.helper": "Use Markdown to format text",
+  "challenge.admin.tasks.field.learning.material": "Additional Learning Material (Markdown)",
+  "challenge.admin.tasks.field.learning.material.placeholder": "# Additional Materials\n\nTheory, links, solution examples...",
+  "challenge.admin.tasks.field.learning.material.helper": "Materials for in-depth study. Displayed with scrolling like a book.",
   "challenge.admin.tasks.tab.editor": "Editor",
   "challenge.admin.tasks.tab.preview": "Preview",
   "challenge.admin.tasks.preview.empty": "Preview will appear here...",

locales/ru.json

@@ -19,6 +19,9 @@
   "challenge.admin.tasks.field.description": "Описание (Markdown)",
   "challenge.admin.tasks.field.description.placeholder": "# Заголовок задания\n\nОписание задания в формате Markdown...",
   "challenge.admin.tasks.field.description.helper": "Используйте Markdown для форматирования текста",
+  "challenge.admin.tasks.field.learning.material": "Дополнительный учебный материал (Markdown)",
+  "challenge.admin.tasks.field.learning.material.placeholder": "# Дополнительные материалы\n\nТеория, ссылки, примеры решений...",
+  "challenge.admin.tasks.field.learning.material.helper": "Материалы для углубленного изучения. Отображаются с прокруткой как книга.",
   "challenge.admin.tasks.tab.editor": "Редактор",
   "challenge.admin.tasks.tab.preview": "Превью",
   "challenge.admin.tasks.preview.empty": "Предпросмотр появится здесь...",

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "challenge-admin-pl",
-  "version": "1.2.0",
+  "version": "1.5.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "challenge-admin-pl",
-      "version": "1.2.0",
+      "version": "1.5.0",
       "license": "ISC",
       "dependencies": {
         "@brojs/cli": "^1.9.4",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "challenge-admin",
-  "version": "1.2.0",
+  "version": "1.5.0",
   "description": "",
   "main": "./src/index.tsx",
   "scripts": {

src/__data__/kc.ts

@@ -3,6 +3,6 @@ import Keycloak from 'keycloak-js'
 export const keycloak = new Keycloak({
   url: KC_URL,
   realm: KC_REALM,
-  clientId: KC_CLIENT_ID,
+  clientId: KC_CLIENT_ID
-});
+})
 

src/pages/submissions/SubmissionsPage.tsx

@@ -41,9 +41,18 @@ export const SubmissionsPage: React.FC = () => {
   const navigate = useNavigate()
   const { chainId } = useParams<{ chainId?: string }>()
 
-  // Проверяем feature flag
+  // Проверяем feature flags
   const featureValue = getFeatureValue('challenge-admin', 'use-chain-submissions-api')
   const useNewApi = featureValue?.value === 'true'
+  const pollingIntervalFeatureValue = getFeatureValue(
+    'challenge-admin',
+    'submissions-polling-interval-ms'
+  )
+  const pollingIntervalMs = (() => {
+    const rawValue = pollingIntervalFeatureValue?.value ?? ''
+    const parsed = Number.parseInt(rawValue, 10)
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : 1200
+  })()
 
   // Состояние для выбранного пользователя и фильтров
   const [selectedUserId, setSelectedUserId] = useState<string | null>(null)
@@ -70,7 +79,10 @@ export const SubmissionsPage: React.FC = () => {
       userId: selectedUserId || undefined,
       status: statusFilter !== 'all' ? statusFilter : undefined,
     },
-    { skip: !chainId || !useNewApi }
+    {
+      skip: !chainId || !useNewApi,
+      pollingInterval: pollingIntervalMs,
+    }
   )
 
   // Старый API: получаем общую статистику и submissions отдельно

src/pages/tasks/TaskFormPage.tsx

@@ -40,6 +40,7 @@ export const TaskFormPage: React.FC = () => {
 
   const [title, setTitle] = useState('')
   const [description, setDescription] = useState('')
+  const [learningMaterial, setLearningMaterial] = useState('')
   const [hiddenInstructions, setHiddenInstructions] = useState('')
   const [showDescPreview, setShowDescPreview] = useState(false)
   const [testAnswer, setTestAnswer] = useState('')
@@ -50,6 +51,7 @@ export const TaskFormPage: React.FC = () => {
     if (task) {
       setTitle(task.title)
       setDescription(task.description)
+      setLearningMaterial(task.learningMaterial || '')
       setHiddenInstructions(task.hiddenInstructions || '')
     }
   }, [task])
@@ -106,6 +108,7 @@ export const TaskFormPage: React.FC = () => {
           data: {
             title: title.trim(),
             description: description.trim(),
+            learningMaterial: learningMaterial.trim() || undefined,
             hiddenInstructions: hiddenInstructions.trim() || undefined,
           },
         }).unwrap()
@@ -118,6 +121,7 @@ export const TaskFormPage: React.FC = () => {
         await createTask({
           title: title.trim(),
           description: description.trim(),
+          learningMaterial: learningMaterial.trim() || undefined,
           hiddenInstructions: hiddenInstructions.trim() || undefined,
         }).unwrap()
         toaster.create({
@@ -126,7 +130,7 @@ export const TaskFormPage: React.FC = () => {
           type: 'success',
         })
       }
-      navigate(URLs.tasks)
+      // navigate(URLs.tasks)
     } catch (err: unknown) {
       const errorMessage = 
         (err && typeof err === 'object' && 'data' in err && 
@@ -355,6 +359,128 @@ export const TaskFormPage: React.FC = () => {
             <Field.HelperText>{t('challenge.admin.tasks.field.description.helper')}</Field.HelperText>
           </Field.Root>
 
+          {/* Learning Material */}
+          <Field.Root>
+            <Field.Label>{t('challenge.admin.tasks.field.learning.material')}</Field.Label>
+            <Box display={{ base: 'block', lg: 'none' }}>
+              {/* Табы для мобильных */}
+              <Tabs.Root
+                value={showDescPreview ? 'preview' : 'editor'}
+                onValueChange={(e) => setShowDescPreview(e.value === 'preview')}
+              >
+                <Tabs.List>
+                  <Tabs.Trigger value="editor">{t('challenge.admin.tasks.tab.editor')}</Tabs.Trigger>
+                  <Tabs.Trigger value="preview">{t('challenge.admin.tasks.tab.preview')}</Tabs.Trigger>
+                </Tabs.List>
+                <Tabs.Content value="editor" pt={4}>
+                  <Textarea
+                    value={learningMaterial}
+                    onChange={(e) => setLearningMaterial(e.target.value)}
+                    placeholder={t('challenge.admin.tasks.field.learning.material.placeholder')}
+                    rows={12}
+                    fontFamily="monospace"
+                    disabled={isLoading}
+                  />
+                </Tabs.Content>
+                <Tabs.Content value="preview" pt={4}>
+                  <Box
+                    p={4}
+                    borderWidth="1px"
+                    borderColor="gray.200"
+                    borderRadius="md"
+                    minH="250px"
+                    maxH="400px"
+                    bg="gray.50"
+                    overflowY="auto"
+                  >
+                    {learningMaterial ? (
+                      <Box
+                        className="markdown-preview"
+                        css={{
+                          '& a': {
+                            color: '#0f766e',
+                            textDecoration: 'underline',
+                            cursor: 'pointer',
+                            '&:hover': {
+                              color: '#115e59',
+                            }
+                          }
+                        }}
+                      >
+                        <ReactMarkdown>{learningMaterial}</ReactMarkdown>
+                      </Box>
+                    ) : (
+                      <Text color="gray.400" fontStyle="italic">
+                        {t('challenge.admin.tasks.preview.empty')}
+                      </Text>
+                    )}
+                  </Box>
+                </Tabs.Content>
+              </Tabs.Root>
+            </Box>
+
+            {/* Две колонки для десктопа */}
+            <Grid
+              display={{ base: 'none', lg: 'grid' }}
+              templateColumns="1fr 1fr"
+              gap={4}
+              mt={2}
+            >
+              <Box>
+                <Text fontSize="sm" fontWeight="medium" mb={2} color="gray.700">
+                  {t('challenge.admin.tasks.tab.editor')}
+                </Text>
+                <Textarea
+                  value={learningMaterial}
+                  onChange={(e) => setLearningMaterial(e.target.value)}
+                  placeholder={t('challenge.admin.tasks.field.learning.material.placeholder')}
+                  rows={15}
+                  fontFamily="monospace"
+                  disabled={isLoading}
+                />
+              </Box>
+              <Box>
+                <Text fontSize="sm" fontWeight="medium" mb={2} color="gray.700">
+                  {t('challenge.admin.tasks.tab.preview')}
+                </Text>
+                <Box
+                  p={4}
+                  borderWidth="1px"
+                  borderColor="gray.200"
+                  borderRadius="md"
+                  minH="250px"
+                  maxH="400px"
+                  bg="gray.50"
+                  overflowY="auto"
+                  height="100%"
+                >
+                  {learningMaterial ? (
+                    <Box
+                      className="markdown-preview"
+                      css={{
+                        '& a': {
+                          color: '#0f766e',
+                          textDecoration: 'underline',
+                          cursor: 'pointer',
+                          '&:hover': {
+                            color: '#115e59',
+                          }
+                        }
+                      }}
+                    >
+                      <ReactMarkdown>{learningMaterial}</ReactMarkdown>
+                    </Box>
+                  ) : (
+                    <Text color="gray.400" fontStyle="italic">
+                      {t('challenge.admin.tasks.preview.empty')}
+                    </Text>
+                  )}
+                </Box>
+              </Box>
+            </Grid>
+            <Field.HelperText>{t('challenge.admin.tasks.field.learning.material.helper')}</Field.HelperText>
+          </Field.Root>
+
           {/* Hidden Instructions */}
           <Field.Root>
             <Box bg="purple.50" p={4} borderRadius="md" borderWidth="1px" borderColor="purple.200">

src/types/challenge.ts

@@ -12,6 +12,7 @@ export interface ChallengeTask {
   id: string
   title: string
   description: string // Markdown
+  learningMaterial?: string // Дополнительный учебный материал в Markdown
   hiddenInstructions?: string // Только для преподавателей
   creator?: {
     sub: string
@@ -121,12 +122,14 @@ export interface APIResponse<T> {
 export interface CreateTaskRequest {
   title: string
   description: string
+  learningMaterial?: string
   hiddenInstructions?: string
 }
 
 export interface UpdateTaskRequest {
   title?: string
   description?: string
+  learningMaterial?: string
   hiddenInstructions?: string
 }