@hed-hog/lms 0.0.338 → 0.0.349

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

@@ -589,6 +589,7 @@ export default function QuestoesPage() {
   const [deleteDialogOpen, setDeleteDialogOpen] = useState(false);
   const [questaoToDelete, setQuestaoToDelete] = useState<Questao | null>(null);
   const [hasChanges, setHasChanges] = useState(false);
+  const [saving, setSaving] = useState(false);
   const [buscaInput, setBuscaInput] = useState('');
   const [debouncedBuscaInput, setDebouncedBuscaInput] = useState('');
   const [filtroTipoInput, setFiltroTipoInput] = useState<
@@ -993,24 +994,29 @@ export default function QuestoesPage() {
       }),
     };
 
-    if (editingQuestao) {
-      await request({
-        url: `/lms/exams/${examId}/questions/${editingQuestao.id}`,
-        method: 'PATCH',
-        data: payload,
-      });
-      toast.success(t('toasts.questionUpdated'));
-    } else {
-      await request({
-        url: `/lms/exams/${examId}/questions`,
-        method: 'POST',
-        data: payload,
-      });
-      toast.success(t('toasts.questionCreated'));
-    }
+    setSaving(true);
+    try {
+      if (editingQuestao) {
+        await request({
+          url: `/lms/exams/${examId}/questions/${editingQuestao.id}`,
+          method: 'PATCH',
+          data: payload,
+        });
+        toast.success(t('toasts.questionUpdated'));
+      } else {
+        await request({
+          url: `/lms/exams/${examId}/questions`,
+          method: 'POST',
+          data: payload,
+        });
+        toast.success(t('toasts.questionCreated'));
+      }
 
-    await refetchQuestions();
-    setSheetOpen(false);
+      await refetchQuestions();
+      setSheetOpen(false);
+    } finally {
+      setSaving(false);
+    }
   }
 
   async function confirmDelete() {
@@ -1801,7 +1807,8 @@ export default function QuestoesPage() {
               )}
 
               <SheetFooter className="mt-auto gap-2 p-0 pt-4">
-                <Button type="submit" className="w-full">
+                <Button type="submit" className="w-full" disabled={saving}>
+                  {saving && <Loader2 className="mr-2 size-4 animate-spin" />}
                   {editingQuestao
                     ? t('sheet.actions.update')
                     : t('sheet.actions.create')}

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

@@ -64,6 +64,7 @@ import {
   TableRow,
 } from '@/components/ui/table';
 import { Textarea } from '@/components/ui/textarea';
+import { usePersistedPageSize } from '@/hooks/use-persisted-page-size';
 import { usePersistedViewMode } from '@/hooks/use-persisted-view-mode';
 import {
   DndContext,
@@ -103,7 +104,6 @@ import {
 import { useTranslations } from 'next-intl';
 import { useRouter } from 'next/navigation';
 import { useEffect, useMemo, useRef, useState } from 'react';
-import { usePersistedPageSize } from '@/hooks/use-persisted-page-size';
 import { Controller, useForm, useWatch } from 'react-hook-form';
 import { toast } from 'sonner';
 import { z } from 'zod';
@@ -114,6 +114,7 @@ interface Formacao {
   id: number;
   nome: string;
   descricao: string;
+  progressionMode: 'sequencial' | 'livre';
   area: string;
   nivel: string;
   prerequisitos: string;
@@ -135,6 +136,9 @@ type TrainingColorPayload = {
   secondaryColor?: string | null;
   primary_color?: string | null;
   secondary_color?: string | null;
+  progressionMode?: string | null;
+  progressMode?: string | null;
+  progress_mode?: string | null;
 };
 
 interface CursoOption {
@@ -340,6 +344,14 @@ function normalizeLevelValue(value: string) {
   return 'Iniciante';
 }
 
+function normalizeProgressModeValue(value?: string) {
+  const normalized = normalizeText(value ?? '');
+
+  if (['livre', 'free'].includes(normalized)) return 'livre';
+
+  return 'sequencial';
+}
+
 function normalizeStatusValue(value: string) {
   const normalized = normalizeText(value);
 
@@ -391,6 +403,12 @@ function normalizeTrainingColorPayload<T extends TrainingColorPayload>(
 
   return {
     ...payload,
+    progressionMode: normalizeProgressModeValue(
+      payload.progressionMode ??
+        payload.progressMode ??
+        payload.progress_mode ??
+        undefined
+    ),
     primaryColor: primaryColor ?? undefined,
     secondaryColor: secondaryColor ?? undefined,
   };
@@ -422,7 +440,8 @@ function buildCourseCodeFromTitle(title: string) {
 
 const formacaoSchema = z.object({
   nome: z.string().min(3, 'Minimo 3 caracteres'),
-  descricao: z.string().min(10, 'Minimo 10 caracteres'),
+  descricao: z.string().optional(),
+  progressionMode: z.enum(['sequencial', 'livre']),
   area: z.enum(['Tecnologia', 'Design', 'Gestao', 'Marketing', 'Financas']),
   nivel: z.enum(['Iniciante', 'Intermediario', 'Avancado']),
   prerequisitos: z.string().optional(),
@@ -728,6 +747,7 @@ export default function TrainingPage() {
     defaultValues: {
       nome: '',
       descricao: '',
+      progressionMode: 'sequencial' as const,
       area: 'Tecnologia',
       nivel: 'Iniciante',
       prerequisitos: '',
@@ -967,6 +987,7 @@ export default function TrainingPage() {
     form.reset({
       nome: '',
       descricao: '',
+      progressionMode: 'sequencial',
       area: 'Tecnologia',
       nivel: 'Iniciante',
       prerequisitos: '',
@@ -1022,6 +1043,9 @@ export default function TrainingPage() {
       form.reset({
         nome: fullFormacao.nome,
         descricao: fullFormacao.descricao,
+        progressionMode: normalizeProgressModeValue(
+          fullFormacao.progressionMode
+        ),
         area: normalizeAreaValue(fullFormacao.area),
         nivel: normalizeLevelValue(fullFormacao.nivel),
         prerequisitos: fullFormacao.prerequisitos,
@@ -1171,6 +1195,9 @@ export default function TrainingPage() {
   }
 
   async function onSubmit(data: FormacaoForm) {
+    const toApiProgressMode = (value: FormacaoForm['progressionMode']) =>
+      value === 'livre' ? 'free' : 'sequential';
+
     try {
       const orderedItems = normalizeTrailOrder(
         [...learningPathItems].sort((a, b) => a.order - b.order)
@@ -1196,6 +1223,7 @@ export default function TrainingPage() {
           shortDescription?: string;
           level?: 'beginner' | 'intermediate' | 'advanced';
           status?: 'draft' | 'active' | 'archived';
+          progressMode?: 'sequential' | 'free';
           primaryColor?: string;
           secondaryColor?: string;
           items?: Array<{
@@ -1215,6 +1243,7 @@ export default function TrainingPage() {
         if (dirty.status) {
           payload.status = ptStatusToApi(data.status as Formacao['status']);
         }
+        payload.progressMode = toApiProgressMode(data.progressionMode);
         if (dirty.primaryColor) payload.primaryColor = data.primaryColor;
         if (dirty.secondaryColor) payload.secondaryColor = data.secondaryColor;
         if (itemsChanged) {
@@ -1244,6 +1273,7 @@ export default function TrainingPage() {
           shortDescription: data.prerequisitos?.trim() || undefined,
           level: ptLevelToApi(data.nivel),
           status: ptStatusToApi(data.status as Formacao['status']),
+          progressMode: toApiProgressMode(data.progressionMode),
           primaryColor: data.primaryColor,
           secondaryColor: data.secondaryColor,
           items: orderedItems.map((item, index) => ({
@@ -1899,8 +1929,7 @@ export default function TrainingPage() {
             </Field>
             <Field>
               <FieldLabel htmlFor="descricao">
-                {t('form.fields.description.label')}{' '}
-                <span className="text-destructive">*</span>
+                {t('form.fields.description.label')}
               </FieldLabel>
               <Textarea
                 id="descricao"
@@ -1908,8 +1937,42 @@ export default function TrainingPage() {
                 placeholder={t('form.fields.description.placeholder')}
                 {...form.register('descricao')}
               />
+            </Field>
+            <Field>
+              <FieldLabel>
+                {t('form.fields.progressionMode.label')}{' '}
+                <span className="text-destructive">*</span>
+              </FieldLabel>
+              <Controller
+                name="progressionMode"
+                control={form.control}
+                render={({ field }) => (
+                  <Select onValueChange={field.onChange} value={field.value}>
+                    <SelectTrigger>
+                      <SelectValue
+                        placeholder={t(
+                          'form.fields.progressionMode.placeholder'
+                        )}
+                      />
+                    </SelectTrigger>
+                    <SelectContent>
+                      <SelectItem value="sequencial">
+                        {t('form.fields.progressionMode.options.sequential')}
+                      </SelectItem>
+                      <SelectItem value="livre">
+                        {t('form.fields.progressionMode.options.free')}
+                      </SelectItem>
+                    </SelectContent>
+                  </Select>
+                )}
+              />
+              <p className="text-xs text-muted-foreground">
+                {watchedFormValues.progressionMode === 'livre'
+                  ? t('form.fields.progressionMode.help.free')
+                  : t('form.fields.progressionMode.help.sequential')}
+              </p>
               <FieldError>
-                {form.formState.errors.descricao?.message}
+                {form.formState.errors.progressionMode?.message}
               </FieldError>
             </Field>
             <div className="grid grid-cols-1 gap-4 sm:grid-cols-2">

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

@@ -63,6 +63,7 @@ import {
   TableRow,
 } from '@/components/ui/table';
 import { Textarea } from '@/components/ui/textarea';
+import { usePersistedPageSize } from '@/hooks/use-persisted-page-size';
 import { usePersistedViewMode } from '@/hooks/use-persisted-view-mode';
 import {
   DndContext,
@@ -102,7 +103,6 @@ import {
 import { useTranslations } from 'next-intl';
 import { useRouter } from 'next/navigation';
 import { useEffect, useMemo, useRef, useState } from 'react';
-import { usePersistedPageSize } from '@/hooks/use-persisted-page-size';
 import { Controller, useForm, useWatch } from 'react-hook-form';
 import { toast } from 'sonner';
 import { z } from 'zod';
@@ -113,6 +113,7 @@ interface Formacao {
   id: number;
   nome: string;
   descricao: string;
+  progressionMode: 'sequencial' | 'livre';
   area: string;
   nivel: string;
   prerequisitos: string;
@@ -344,6 +345,14 @@ function normalizeStatusValue(value: string) {
   return 'rascunho';
 }
 
+function normalizeProgressModeValue(value?: string) {
+  const normalized = normalizeText(value ?? '');
+
+  if (['livre', 'free'].includes(normalized)) return 'livre';
+
+  return 'sequencial';
+}
+
 function slugifyText(value: string) {
   return normalizeText(value)
     .replace(/[^a-z0-9\s-]/g, '')
@@ -417,7 +426,8 @@ function buildCourseCodeFromTitle(title: string) {
 
 const formacaoSchema = z.object({
   nome: z.string().min(3, 'Minimo 3 caracteres'),
-  descricao: z.string().min(10, 'Minimo 10 caracteres'),
+  descricao: z.string().optional(),
+  progressionMode: z.enum(['sequencial', 'livre']),
   area: z.enum(['Tecnologia', 'Design', 'Gestao', 'Marketing', 'Financas']),
   nivel: z.enum(['Iniciante', 'Intermediario', 'Avancado']),
   prerequisitos: z.string().optional(),
@@ -721,6 +731,7 @@ export default function TrainingPage() {
     defaultValues: {
       nome: '',
       descricao: '',
+      progressionMode: 'sequencial',
       area: 'Tecnologia',
       nivel: 'Iniciante',
       prerequisitos: '',
@@ -872,6 +883,8 @@ export default function TrainingPage() {
         ...formacao,
         nome: watchedFormValues.nome ?? formacao.nome,
         descricao: watchedFormValues.descricao ?? formacao.descricao,
+        progressionMode:
+          watchedFormValues.progressionMode ?? formacao.progressionMode,
         nivel: watchedFormValues.nivel ?? formacao.nivel,
         status: watchedFormValues.status ?? formacao.status,
         prerequisitos:
@@ -960,6 +973,7 @@ export default function TrainingPage() {
     form.reset({
       nome: '',
       descricao: '',
+      progressionMode: 'sequencial',
       area: 'Tecnologia',
       nivel: 'Iniciante',
       prerequisitos: '',
@@ -1015,6 +1029,9 @@ export default function TrainingPage() {
       form.reset({
         nome: fullFormacao.nome,
         descricao: fullFormacao.descricao,
+        progressionMode: normalizeProgressModeValue(
+          fullFormacao.progressionMode
+        ),
         area: normalizeAreaValue(fullFormacao.area),
         nivel: normalizeLevelValue(fullFormacao.nivel),
         prerequisitos: fullFormacao.prerequisitos,
@@ -1164,6 +1181,9 @@ export default function TrainingPage() {
   }
 
   async function onSubmit(data: FormacaoForm) {
+    const toApiProgressMode = (value: FormacaoForm['progressionMode']) =>
+      value === 'livre' ? 'free' : 'sequential';
+
     try {
       const orderedItems = normalizeTrailOrder(
         [...learningPathItems].sort((a, b) => a.order - b.order)
@@ -1189,6 +1209,7 @@ export default function TrainingPage() {
           shortDescription?: string;
           level?: 'beginner' | 'intermediate' | 'advanced';
           status?: 'draft' | 'active' | 'archived';
+          progressMode?: 'sequential' | 'free';
           primaryColor?: string;
           secondaryColor?: string;
           items?: Array<{
@@ -1200,7 +1221,9 @@ export default function TrainingPage() {
         } = {};
 
         if (dirty.nome) payload.title = data.nome;
-        if (dirty.descricao) payload.description = data.descricao;
+        if (dirty.descricao) {
+          payload.description = data.descricao?.trim() || undefined;
+        }
         if (dirty.prerequisitos) {
           payload.shortDescription = data.prerequisitos?.trim() || undefined;
         }
@@ -1208,6 +1231,9 @@ export default function TrainingPage() {
         if (dirty.status) {
           payload.status = ptStatusToApi(data.status as Formacao['status']);
         }
+        if (dirty.progressionMode) {
+          payload.progressMode = toApiProgressMode(data.progressionMode);
+        }
         if (dirty.primaryColor) payload.primaryColor = data.primaryColor;
         if (dirty.secondaryColor) payload.secondaryColor = data.secondaryColor;
         if (itemsChanged) {
@@ -1233,10 +1259,11 @@ export default function TrainingPage() {
       } else {
         const payload = {
           title: data.nome,
-          description: data.descricao,
+          description: data.descricao?.trim() || undefined,
           shortDescription: data.prerequisitos?.trim() || undefined,
           level: ptLevelToApi(data.nivel),
           status: ptStatusToApi(data.status as Formacao['status']),
+          progressMode: toApiProgressMode(data.progressionMode),
           primaryColor: data.primaryColor,
           secondaryColor: data.secondaryColor,
           items: orderedItems.map((item, index) => ({
@@ -1892,12 +1919,12 @@ export default function TrainingPage() {
             </Field>
             <Field>
               <FieldLabel htmlFor="descricao">
-                {t('form.fields.description.label')}{' '}
-                <span className="text-destructive">*</span>
+                {t('form.fields.description.label')}
               </FieldLabel>
               <Textarea
                 id="descricao"
                 rows={3}
+                required={false}
                 placeholder={t('form.fields.description.placeholder')}
                 {...form.register('descricao')}
               />
@@ -1905,6 +1932,43 @@ export default function TrainingPage() {
                 {form.formState.errors.descricao?.message}
               </FieldError>
             </Field>
+            <Field>
+              <FieldLabel>
+                {t('form.fields.progressionMode.label')}{' '}
+                <span className="text-destructive">*</span>
+              </FieldLabel>
+              <Controller
+                name="progressionMode"
+                control={form.control}
+                render={({ field }) => (
+                  <Select onValueChange={field.onChange} value={field.value}>
+                    <SelectTrigger>
+                      <SelectValue
+                        placeholder={t(
+                          'form.fields.progressionMode.placeholder'
+                        )}
+                      />
+                    </SelectTrigger>
+                    <SelectContent>
+                      <SelectItem value="sequencial">
+                        {t('form.fields.progressionMode.options.sequential')}
+                      </SelectItem>
+                      <SelectItem value="livre">
+                        {t('form.fields.progressionMode.options.free')}
+                      </SelectItem>
+                    </SelectContent>
+                  </Select>
+                )}
+              />
+              <p className="text-xs text-muted-foreground">
+                {watchedFormValues.progressionMode === 'livre'
+                  ? t('form.fields.progressionMode.help.free')
+                  : t('form.fields.progressionMode.help.sequential')}
+              </p>
+              <FieldError>
+                {form.formState.errors.progressionMode?.message}
+              </FieldError>
+            </Field>
             <div className="grid grid-cols-1 gap-4 sm:grid-cols-2">
               <Field>
                 <FieldLabel>

package/hedhog/frontend/messages/pt.json

@@ -1544,7 +1544,20 @@
         "description": {
           "label": "Descrição",
           "placeholder": "Descreva a formação...",
-          "required": true
+          "required": false
+        },
+        "progressionMode": {
+          "label": "Fluxo da Trilha",
+          "placeholder": "Selecione o fluxo",
+          "required": true,
+          "options": {
+            "sequential": "Exigir ordem dos passos",
+            "free": "Liberar navegação entre passos"
+          },
+          "help": {
+            "sequential": "O aluno precisa concluir cada etapa da trilha antes de avançar para a próxima.",
+            "free": "O aluno pode abrir qualquer etapa da trilha a qualquer momento, sem bloqueio de sequência."
+          }
         },
         "area": {
           "label": "Área",

package/hedhog/table/learning_path.yaml

@@ -24,6 +24,10 @@ columns:
     type: enum
     values: [draft, active, archived]
     default: draft
+  - name: progress_mode
+    type: enum
+    values: [sequential, free]
+    default: sequential
   - name: primary_color
     type: varchar
     length: 9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hed-hog/lms",
-  "version": "0.0.338",
+  "version": "0.0.349",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "dependencies": {
@@ -9,15 +9,15 @@
     "@nestjs/core": "^11",
     "@nestjs/jwt": "^11",
     "@nestjs/mapped-types": "*",
-    "@hed-hog/api-prisma": "0.0.6",
+    "@hed-hog/api-locale": "0.0.14",
     "@hed-hog/api-types": "0.0.1",
-    "@hed-hog/api": "0.0.8",
+    "@hed-hog/api-prisma": "0.0.6",
     "@hed-hog/api-pagination": "0.0.7",
-    "@hed-hog/api-locale": "0.0.14",
-    "@hed-hog/contact": "0.0.338",
-    "@hed-hog/category": "0.0.338",
-    "@hed-hog/core": "0.0.338",
-    "@hed-hog/finance": "0.0.338"
+    "@hed-hog/contact": "0.0.349",
+    "@hed-hog/api": "0.0.8",
+    "@hed-hog/core": "0.0.349",
+    "@hed-hog/category": "0.0.349",
+    "@hed-hog/finance": "0.0.349"
   },
   "exports": {
     ".": {

package/src/course/course.controller.ts

@@ -28,6 +28,7 @@ export class CourseController {
     @Query('status') status?: string,
     @Query('level') level?: string,
     @Query('category') category?: string,
+    @Query('offeringTypes') offeringTypes?: string | string[],
   ) {
     return this.courseService.list({
       page: page ? Number(page) : 1,
@@ -36,9 +37,26 @@ export class CourseController {
       status,
       level,
       category,
+      offeringTypes: this.toArray(offeringTypes),
     });
   }
 
+  private toArray(value?: string | string[]) {
+    if (Array.isArray(value)) {
+      return value
+        .flatMap((item) => String(item).split(','))
+        .map((item) => item.trim())
+        .filter(Boolean);
+    }
+    if (typeof value === 'string') {
+      return value
+        .split(',')
+        .map((item) => item.trim())
+        .filter(Boolean);
+    }
+    return [];
+  }
+
   @Get('stats')
   stats() {
     return this.courseService.stats();