@hed-hog/lms 0.0.349 → 0.0.350

package/hedhog/frontend/app/enterprise/_components/enterprise-course-edit-sheet.tsx.ejs

@@ -36,6 +36,7 @@ type ApiCourse = {
   primaryColor?: string | null;
   secondaryColor?: string | null;
   logoFileId?: number | null;
+  operationsProjectId?: number | null;
 };
 
 export interface EnterpriseCourseEditSheetProps {
@@ -128,6 +129,9 @@ export function EnterpriseCourseEditSheet({
           nivel: toPtLevel(course.level),
           status: toPtStatus(course.status),
           categorias: course.categories ?? [],
+          operationsProjectId: course.operationsProjectId
+            ? String(course.operationsProjectId)
+            : '',
           primaryColor: course.primaryColor ?? '#1D4ED8',
           secondaryColor: course.secondaryColor ?? '#111827',
           logoFileId: course.logoFileId ?? null,
@@ -171,6 +175,9 @@ export function EnterpriseCourseEditSheet({
           primaryContrastColor: getContrastColor(values.primaryColor),
           secondaryColor: values.secondaryColor,
           secondaryContrastColor: getContrastColor(values.secondaryColor),
+          operationsProjectId: values.operationsProjectId
+            ? Number(values.operationsProjectId)
+            : null,
           logoFileId: values.logoFileId ?? null,
         },
       });

package/hedhog/frontend/app/exams/[id]/questions/page.tsx.ejs

@@ -8,6 +8,7 @@ import {
   SearchBar,
   ViewModeToggle,
 } from '@/components/entity-list';
+import { EntityPicker } from '@/components/ui/entity-picker';
 import { RichTextEditor } from '@/components/rich-text-editor';
 import { Badge } from '@/components/ui/badge';
 import { Button } from '@/components/ui/button';
@@ -132,13 +133,22 @@ interface Questao {
   examQuestionId: number;
   order: number;
   tipo: ExamQuestionType;
+  assuntoId: number | null;
+  assunto: string | null;
   enunciado: string;
+  explicacao: string;
   pontuacao: number;
   alternativas: Alternativa[];
   fillBlankAnswers: FillBlankAnswer[];
   matchingPairs: MatchingPair[];
 }
 
+type AssuntoQuestaoOption = {
+  id: number;
+  name: string;
+  description?: string | null;
+};
+
 type ExamQuestionType =
   | 'multiple_choice'
   | 'true_false'
@@ -164,7 +174,10 @@ type ApiExamQuestion = {
   examQuestionId: number;
   order: number;
   questionType: ExamQuestionType;
+  subjectId: number | null;
+  subjectName: string | null;
   statement: string;
+  explanation?: string | null;
   points: number;
   alternatives: ApiExamQuestionAlternative[];
   fillBlankAnswers?: Array<{
@@ -188,8 +201,18 @@ type ApiExamQuestionsResponse = {
   data: ApiExamQuestion[];
 };
 
+type ApiQuestionSubjectListResponse = {
+  data: AssuntoQuestaoOption[];
+  total: number;
+  page: number;
+  pageSize: number;
+  lastPage: number;
+};
+
 type QuestaoForm = {
+  subjectId: number;
   enunciado: string;
+  explicacao?: string;
   questionType: ExamQuestionType;
   pontuacao: number;
 };
@@ -204,7 +227,10 @@ function mapApiQuestion(question: ApiExamQuestion): Questao {
     examQuestionId: question.examQuestionId,
     order: question.order,
     tipo: question.questionType,
+    assuntoId: question.subjectId,
+    assunto: question.subjectName,
     enunciado: question.statement,
+    explicacao: question.explanation ?? '',
     pontuacao: question.points,
     alternativas: question.alternatives.map((alternative) => ({
       id: alternative.id,
@@ -440,6 +466,11 @@ function SortableQuestao({
 
               <div className="flex items-start justify-between gap-3">
                 <div className="mt-2 flex flex-wrap items-center gap-2">
+                  {questao.assunto && (
+                    <Badge variant="secondary" className="text-xs">
+                      {questao.assunto}
+                    </Badge>
+                  )}
                   <Badge variant="outline" className="text-xs">
                     {t(`question.types.${questao.tipo}`)}
                   </Badge>
@@ -588,6 +619,9 @@ export default function QuestoesPage() {
   );
   const [deleteDialogOpen, setDeleteDialogOpen] = useState(false);
   const [questaoToDelete, setQuestaoToDelete] = useState<Questao | null>(null);
+  const [assuntosLocais, setAssuntosLocais] = useState<AssuntoQuestaoOption[]>(
+    []
+  );
   const [hasChanges, setHasChanges] = useState(false);
   const [saving, setSaving] = useState(false);
   const [buscaInput, setBuscaInput] = useState('');
@@ -608,7 +642,9 @@ export default function QuestoesPage() {
   });
 
   const questaoSchema = z.object({
+    subjectId: z.coerce.number().int().min(1, t('sheet.validation.subjectRequired')),
     enunciado: z.string().min(5, t('sheet.validation.statementMin')),
+    explicacao: z.string().optional(),
     questionType: z.enum([
       'multiple_choice',
       'true_false',
@@ -622,7 +658,9 @@ export default function QuestoesPage() {
   const form = useForm<QuestaoForm>({
     resolver: zodResolver(questaoSchema),
     defaultValues: {
+      subjectId: 0,
       enunciado: '',
+      explicacao: '',
       questionType: 'multiple_choice',
       pontuacao: 1,
     },
@@ -701,6 +739,65 @@ export default function QuestoesPage() {
     setCurrentPage(1);
   }
 
+
+  async function loadQuestionSubjectOptions(args: {
+    page: number;
+    pageSize: number;
+    search: string;
+  }) {
+    const response = await request<ApiQuestionSubjectListResponse>({
+      url: '/lms/exams/question-subjects',
+      method: 'GET',
+      params: {
+        page: args.page,
+        pageSize: args.pageSize,
+        ...(args.search ? { search: args.search } : {}),
+      },
+    });
+
+    const items = response.data?.data ?? [];
+
+    setAssuntosLocais((prev) => {
+      const merged = [...prev, ...items];
+      return merged.filter(
+        (item, index, arr) =>
+          arr.findIndex((candidate) => candidate.id === item.id) === index
+      );
+    });
+
+    return {
+      items,
+      hasMore: (response.data?.page ?? 1) < (response.data?.lastPage ?? 1),
+    };
+  }
+
+  async function createQuestionSubject(values: Record<string, string>) {
+    const name = values.name?.trim() ?? '';
+
+    if (!name) {
+      toast.error(t('toasts.subjectNameRequired'));
+      return null;
+    }
+
+    const response = await request<AssuntoQuestaoOption>({
+      url: '/lms/exams/question-subjects',
+      method: 'POST',
+      data: { name },
+    });
+
+    const created = response.data;
+
+    if (created?.id) {
+      setAssuntosLocais((prev) =>
+        prev.some((item) => item.id === created.id) ? prev : [...prev, created]
+      );
+      toast.success(t('toasts.subjectCreated'));
+      return created;
+    }
+
+    return null;
+  }
+
   useEffect(() => {
     if (currentPage > totalPages) {
       setCurrentPage(totalPages);
@@ -786,7 +883,9 @@ export default function QuestoesPage() {
   function openCreateSheet() {
     setEditingQuestao(null);
     form.reset({
+      subjectId: 0,
       enunciado: '',
+      explicacao: '',
       questionType: 'multiple_choice',
       pontuacao: 1,
     });
@@ -802,7 +901,9 @@ export default function QuestoesPage() {
   function openEditSheet(questao: Questao) {
     setEditingQuestao(questao);
     form.reset({
+      subjectId: questao.assuntoId ?? 0,
       enunciado: questao.enunciado,
+      explicacao: questao.explicacao,
       questionType: questao.tipo,
       pontuacao: questao.pontuacao,
     });
@@ -967,7 +1068,9 @@ export default function QuestoesPage() {
     }
 
     const payload = {
+      subjectId: data.subjectId,
       statement: data.enunciado,
+      explanation: data.explicacao?.trim() || null,
       questionType: data.questionType,
       points: Math.max(1, Math.round(data.pontuacao)),
       ...(requiresAlternatives && {
@@ -1033,11 +1136,18 @@ export default function QuestoesPage() {
   }
 
   async function duplicateQuestao(questao: Questao) {
+    if (!questao.assuntoId) {
+      toast.error(t('toasts.subjectRequiredToDuplicate'));
+      return;
+    }
+
     await request({
-      url: `/lms/exams/${examId}/questions`,
+      url: '/lms/exams/' + examId + '/questions',
       method: 'POST',
       data: {
-        statement: `${questao.enunciado}${t('copySuffix')}`,
+        subjectId: questao.assuntoId,
+        statement: questao.enunciado + t('copySuffix'),
+        explanation: questao.explicacao?.trim() || null,
         questionType: questao.tipo,
         points: Math.max(1, Math.round(questao.pontuacao)),
         ...(OBJECTIVE_QUESTION_TYPES.includes(questao.tipo) && {
@@ -1346,6 +1456,7 @@ export default function QuestoesPage() {
                 <TableHeader>
                   <TableRow>
                     <TableHead>{t('table.headers.question')}</TableHead>
+                    <TableHead>{t('table.headers.subject')}</TableHead>
                     <TableHead>{t('table.headers.type')}</TableHead>
                     <TableHead className="text-right">
                       {t('table.headers.points')}
@@ -1366,6 +1477,7 @@ export default function QuestoesPage() {
                           </p>
                         </div>
                       </TableCell>
+                      <TableCell>{questao.assunto ?? '-'}</TableCell>
                       <TableCell>
                         <Badge variant="outline" className="text-xs">
                           {t(`question.types.${questao.tipo}`)}
@@ -1493,6 +1605,43 @@ export default function QuestoesPage() {
               onSubmit={form.handleSubmit(onSubmit)}
               className="flex flex-1 flex-col gap-5 px-4 pb-4"
             >
+              <FormField
+                control={form.control}
+                name="subjectId"
+                render={({ field }) => (
+                  <FormItem>
+                    <FormLabel>{t('sheet.fields.subject')}</FormLabel>
+                    <FormControl>
+                      <EntityPicker<AssuntoQuestaoOption>
+                        value={field.value || null}
+                        valueType="number"
+                        placeholder={t('sheet.fields.subjectPlaceholder')}
+                        searchPlaceholder={t('sheet.fields.subjectSearchPlaceholder')}
+                        entityLabel={t('sheet.fields.subjectEntityLabel')}
+                        noResultsLabel={t('sheet.fields.subjectNoResults')}
+                        options={assuntosLocais}
+                        loadOptions={loadQuestionSubjectOptions}
+                        getOptionLabel={(option) => option.name}
+                        getOptionDescription={(option) => option.description ?? undefined}
+                        createTitle={t('sheet.fields.subjectCreateTitle')}
+                        createDescription={t('sheet.fields.subjectCreateDescription')}
+                        createFields={[
+                          {
+                            name: 'name',
+                            label: t('sheet.fields.subjectCreateNameLabel'),
+                            placeholder: t('sheet.fields.subjectCreateNamePlaceholder'),
+                            required: true,
+                          },
+                        ]}
+                        onCreate={createQuestionSubject}
+                        onChange={(value) => field.onChange(Number(value ?? 0))}
+                      />
+                    </FormControl>
+                    <FormMessage />
+                  </FormItem>
+                )}
+              />
+
               <FormField
                 control={form.control}
                 name="enunciado"
@@ -1554,6 +1703,24 @@ export default function QuestoesPage() {
                 )}
               />
 
+              <FormField
+                control={form.control}
+                name="explicacao"
+                render={({ field }) => (
+                  <FormItem>
+                    <FormLabel>{t('sheet.fields.explanation')}</FormLabel>
+                    <FormControl>
+                      <RichTextEditor
+                        className="w-full max-w-full h-40"
+                        value={field.value ?? ''}
+                        onChange={field.onChange}
+                      />
+                    </FormControl>
+                    <FormMessage />
+                  </FormItem>
+                )}
+              />
+
               <FormField
                 control={form.control}
                 name="pontuacao"

package/hedhog/frontend/app/exams/page.tsx.ejs

@@ -82,7 +82,7 @@ import {
 } from 'lucide-react';
 import { useTranslations } from 'next-intl';
 import { useRouter } from 'next/navigation';
-import { useEffect, useMemo, useRef, useState } from 'react';
+import { useEffect, useMemo, useState } from 'react';
 import { usePersistedPageSize } from '@/hooks/use-persisted-page-size';
 import { Controller, useForm, useWatch } from 'react-hook-form';
 import { toast } from 'sonner';
@@ -94,9 +94,11 @@ interface Exame {
   id: number;
   codigo: string;
   titulo: string;
+  nivel: 'beginner' | 'intermediate' | 'advanced';
   notaMinima: number;
   limiteTempo: number;
   shuffle: boolean;
+  mostrarGabaritoAposConclusao: boolean;
   status: 'publicado' | 'rascunho' | 'encerrado';
   questoes: number;
   realizacoes: number;
@@ -110,9 +112,11 @@ type ApiExame = {
   id: number;
   code: string;
   title: string;
+  level: 'beginner' | 'intermediate' | 'advanced';
   minScore: number;
   timeLimit: number;
   shuffle: boolean;
+  showAnswerKeyAfterFinish: boolean;
   status: 'published' | 'draft' | 'closed' | 'archived';
   questions: number;
   attempts: number;
@@ -153,12 +157,14 @@ const API_EXAMS_CACHE_KEY = 'lms:exams:api-cache';
 const createExameSchema = (t: (key: string) => string) =>
   z.object({
     titulo: z.string().min(3, t('form.validation.titleMinLength')),
+    nivel: z.enum(['beginner', 'intermediate', 'advanced']),
     notaMinima: z.coerce
       .number()
       .min(0, t('form.validation.minScoreMin'))
       .max(10, t('form.validation.minScoreMax')),
     limiteTempo: z.coerce.number().min(1, t('form.validation.timeLimitMin')),
     shuffle: z.boolean().default(false),
+    mostrarGabaritoAposConclusao: z.boolean().default(false),
     status: z.string().min(1, t('form.validation.statusRequired')),
     primaryColor: z
       .string()
@@ -190,9 +196,11 @@ function mapApiExame(exame: ApiExame): Exame {
     id: exame.id,
     codigo: exame.code,
     titulo: exame.title,
+    nivel: exame.level,
     notaMinima: exame.minScore,
     limiteTempo: exame.timeLimit,
     shuffle: exame.shuffle,
+    mostrarGabaritoAposConclusao: Boolean(exame.showAnswerKeyAfterFinish),
     status: toPtStatus(exame.status),
     questoes: exame.questions,
     realizacoes: exame.attempts,
@@ -268,18 +276,15 @@ export default function ExamesPage() {
     allowedValues: PAGE_SIZES,
   });
 
-  // Double-click tracking
-  const clickTimers = useRef<Map<number, ReturnType<typeof setTimeout>>>(
-    new Map()
-  );
-
   const form = useForm<ExameForm>({
     resolver: zodResolver(exameSchema),
     defaultValues: {
       titulo: '',
+      nivel: 'beginner',
       notaMinima: 7,
       limiteTempo: 60,
       shuffle: true,
+      mostrarGabaritoAposConclusao: false,
       status: 'rascunho',
       primaryColor: '#1D4ED8',
       secondaryColor: '#111827',
@@ -365,11 +370,18 @@ export default function ExamesPage() {
         watchedFormValues.notaMinima,
         editingExame.notaMinima
       ),
+      nivel:
+        watchedFormValues.nivel === undefined
+          ? editingExame.nivel
+          : watchedFormValues.nivel,
       limiteTempo: toNumberOrFallback(
         watchedFormValues.limiteTempo,
         editingExame.limiteTempo
       ),
       shuffle: watchedFormValues.shuffle ?? editingExame.shuffle,
+      mostrarGabaritoAposConclusao:
+        watchedFormValues.mostrarGabaritoAposConclusao ??
+        editingExame.mostrarGabaritoAposConclusao,
       status:
         (watchedFormValues.status as Exame['status'] | undefined) ??
         editingExame.status,
@@ -421,29 +433,17 @@ export default function ExamesPage() {
     setDeleteDialogOpen(true);
   }
 
-  // ── Double-click ──────────────────────────────────────────────────────────
-
-  function handleCardClick(exame: Exame) {
-    const existing = clickTimers.current.get(exame.id);
-    if (existing) {
-      clearTimeout(existing);
-      clickTimers.current.delete(exame.id);
-      router.push(`/lms/exams/${exame.id}/questions`);
-    } else {
-      const t = setTimeout(() => clickTimers.current.delete(exame.id), 300);
-      clickTimers.current.set(exame.id, t);
-    }
-  }
-
   // ── CRUD ──────────────────────────────────────────────────────────────────
 
   function openCreateSheet() {
     setEditingExame(null);
     form.reset({
       titulo: '',
+      nivel: 'beginner',
       notaMinima: 7,
       limiteTempo: 60,
       shuffle: true,
+      mostrarGabaritoAposConclusao: false,
       status: 'rascunho',
       primaryColor: '#1D4ED8',
       secondaryColor: '#111827',
@@ -456,9 +456,11 @@ export default function ExamesPage() {
     setEditingExame(exame);
     form.reset({
       titulo: exame.titulo,
+      nivel: exame.nivel,
       notaMinima: exame.notaMinima,
       limiteTempo: exame.limiteTempo,
       shuffle: exame.shuffle,
+      mostrarGabaritoAposConclusao: exame.mostrarGabaritoAposConclusao,
       status: exame.status,
       primaryColor: exame.primaryColor ?? '#1D4ED8',
       secondaryColor: exame.secondaryColor ?? '#111827',
@@ -471,9 +473,11 @@ export default function ExamesPage() {
     try {
       const payload = {
         title: data.titulo,
+        level: data.nivel,
         minScore: data.notaMinima,
         timeLimit: data.limiteTempo,
         shuffle: data.shuffle,
+        showAnswerKeyAfterFinish: data.mostrarGabaritoAposConclusao,
         status: toApiStatus(data.status),
         primaryColor: data.primaryColor,
         secondaryColor: data.secondaryColor,
@@ -783,7 +787,7 @@ export default function ExamesPage() {
                   <motion.div key={exame.id} variants={fadeUp}>
                     <Card
                       className="group relative h-95 cursor-pointer overflow-hidden border-border/70 shadow-sm transition-all duration-200 hover:border-border hover:shadow-md"
-                      onClick={() => handleCardClick(exame)}
+                      onDoubleClick={() => openEditSheet(exame)}
                       title={t('cards.tooltip')}
                     >
                       <div
@@ -962,7 +966,7 @@ export default function ExamesPage() {
                     <TableRow
                       key={exame.id}
                       className="cursor-pointer"
-                      onClick={() => handleCardClick(exame)}
+                      onDoubleClick={() => openEditSheet(exame)}
                       title={t('cards.tooltip')}
                     >
                       <TableCell>
@@ -1114,6 +1118,37 @@ export default function ExamesPage() {
               <FieldError>{form.formState.errors.titulo?.message}</FieldError>
             </Field>
             <div className="grid grid-cols-2 gap-4">
+              <Field>
+                <FieldLabel>
+                  {t('form.fields.level.label')}{' '}
+                  <span className="text-destructive">*</span>
+                </FieldLabel>
+                <Controller
+                  name="nivel"
+                  control={form.control}
+                  render={({ field }) => (
+                    <Select onValueChange={field.onChange} value={field.value}>
+                      <SelectTrigger>
+                        <SelectValue
+                          placeholder={t('form.fields.level.placeholder')}
+                        />
+                      </SelectTrigger>
+                      <SelectContent>
+                        <SelectItem value="beginner">
+                          {t('form.fields.level.options.beginner')}
+                        </SelectItem>
+                        <SelectItem value="intermediate">
+                          {t('form.fields.level.options.intermediate')}
+                        </SelectItem>
+                        <SelectItem value="advanced">
+                          {t('form.fields.level.options.advanced')}
+                        </SelectItem>
+                      </SelectContent>
+                    </Select>
+                  )}
+                />
+                <FieldError>{form.formState.errors.nivel?.message}</FieldError>
+              </Field>
               <Field>
                 <FieldLabel htmlFor="notaMinima">
                   {t('form.fields.minScore.label')}{' '}
@@ -1261,6 +1296,26 @@ export default function ExamesPage() {
                 )}
               />
             </label>
+            <label className="flex cursor-pointer items-center justify-between rounded-lg border p-3 hover:bg-muted">
+              <div>
+                <p className="text-sm font-medium">
+                  {t('form.fields.showAnswerKeyAfterFinish.label')}
+                </p>
+                <p className="text-xs text-muted-foreground">
+                  {t('form.fields.showAnswerKeyAfterFinish.description')}
+                </p>
+              </div>
+              <Controller
+                name="mostrarGabaritoAposConclusao"
+                control={form.control}
+                render={({ field }) => (
+                  <Switch
+                    checked={field.value}
+                    onCheckedChange={field.onChange}
+                  />
+                )}
+              />
+            </label>
             <SheetFooter className="mt-auto shrink-0 gap-2 pt-4 px-0">
               <Button type="submit" disabled={saving} className="gap-2">
                 {saving && <Loader2 className="size-4 animate-spin" />}

package/hedhog/frontend/app/instructor-skills/page.tsx.ejs

@@ -476,6 +476,7 @@ export default function InstructorSkillsPage() {
           setPageSize(nextPageSize);
           setPage(1);
         }}
+        pageSizeOptions={[6, 12, 24]}
       />
 
       <SkillFormSheet

package/hedhog/frontend/app/instructors/page.tsx.ejs

@@ -735,6 +735,7 @@ export default function InstructorsPage() {
           setPageSize(nextPageSize);
           setPage(1);
         }}
+        pageSizeOptions={[6, 12, 24]}
       />
 
       <InstructorFormSheet

package/hedhog/frontend/app/paths/page.tsx.ejs

@@ -591,11 +591,6 @@ export default function TrainingPage() {
     allowedValues: PAGE_SIZES,
   });
 
-  // Double-click tracking
-  const clickTimers = useRef<Map<number, ReturnType<typeof setTimeout>>>(
-    new Map()
-  );
-
   const sensors = useSensors(
     useSensor(PointerSensor, { activationConstraint: { distance: 5 } }),
     useSensor(KeyboardSensor, {
@@ -961,23 +956,6 @@ export default function TrainingPage() {
     setDeleteDialogOpen(true);
   }
 
-  // ── Double-click ──────────────────────────────────────────────────────────
-
-  function handleCardClick(formacao: Formacao) {
-    const existing = clickTimers.current.get(formacao.id);
-    if (existing) {
-      clearTimeout(existing);
-      clickTimers.current.delete(formacao.id);
-      // Toast message for opening would go here if integrated
-    } else {
-      const timer = setTimeout(
-        () => clickTimers.current.delete(formacao.id),
-        300
-      );
-      clickTimers.current.set(formacao.id, timer);
-    }
-  }
-
   // ── CRUD ──────────────────────────────────────────────────────────────────
 
   function openCreateSheet() {
@@ -1318,11 +1296,15 @@ export default function TrainingPage() {
             data.tituloComercial || data.nomeInterno
           ),
           slug,
+          name: data.nomeInterno.trim() || undefined,
           title: data.tituloComercial,
           description: data.descricao,
           level: ptLevelToApi(data.nivel),
           status: courseStatusToApi(data.status),
           categorySlugs,
+          operationsProjectId: data.operationsProjectId
+            ? Number(data.operationsProjectId)
+            : null,
         },
       });
 
@@ -1664,7 +1646,7 @@ export default function TrainingPage() {
                   <motion.div key={formacao.id} variants={fadeUp}>
                     <Card
                       className="group relative flex min-h-60 max-h-67.5 cursor-pointer flex-col overflow-hidden border-border/70 py-0 shadow-sm transition-all duration-200 hover:border-border hover:shadow-md"
-                      onClick={() => handleCardClick(formacao)}
+                      onDoubleClick={() => openEditSheet(formacao)}
                       title={t('cards.tooltip')}
                     >
                       <div
@@ -1806,7 +1788,7 @@ export default function TrainingPage() {
                       <TableRow
                         key={formacao.id}
                         className="cursor-pointer"
-                        onClick={() => handleCardClick(formacao)}
+                        onDoubleClick={() => openEditSheet(formacao)}
                         title={t('cards.tooltip')}
                       >
                         <TableCell>