@hed-hog/lms 0.0.303 → 0.0.305

package/hedhog/frontend/widgets/upcoming-classes.tsx.ejs

@@ -0,0 +1,152 @@
+'use client';
+
+import { PaginationFooter } from '@/components/entity-list';
+import { Badge } from '@/components/ui/badge';
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card';
+import {
+  Table,
+  TableBody,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow,
+} from '@/components/ui/table';
+import { WidgetWrapper } from '@/app/(app)/(libraries)/core/dashboard/components';
+import { useWidgetData } from '@/hooks/use-widget-data';
+import { format } from 'date-fns';
+import { enUS } from 'date-fns/locale/en-US';
+import { ptBR } from 'date-fns/locale/pt-BR';
+import { BookOpen } from 'lucide-react';
+import { useLocale, useTranslations } from 'next-intl';
+import { useMemo, useState } from 'react';
+
+interface Props {
+  widget?: { name?: string };
+  onRemove?: () => void;
+}
+
+type ClassItem = {
+  id: number;
+  className: string;
+  subject: string;
+  teacher: string;
+  date: string;
+  startTime: string;
+  endTime: string;
+};
+
+type Data = { upcomingClasses?: ClassItem[] };
+
+const ITEMS_PER_PAGE = 5;
+
+function parseApiDateTime(value: string): Date {
+  const raw = String(value ?? '').trim();
+  if (!raw) return new Date(NaN);
+  const hasTimezone = /[zZ]$|[+-]\d{2}:\d{2}$/.test(raw);
+  if (hasTimezone) return new Date(raw);
+  const dateOnly = /^(\d{4})-(\d{2})-(\d{2})$/.exec(raw);
+  if (dateOnly) {
+    return new Date(Number(dateOnly[1]), Number(dateOnly[2]) - 1, Number(dateOnly[3]), 12, 0, 0, 0);
+  }
+  const dt = /^(\d{4})-(\d{2})-(\d{2})[T\s](\d{2}):(\d{2})(?::(\d{2}))?/.exec(raw);
+  if (dt) {
+    return new Date(Number(dt[1]), Number(dt[2]) - 1, Number(dt[3]), Number(dt[4]), Number(dt[5]), Number(dt[6] ?? '0'), 0);
+  }
+  return new Date(raw);
+}
+
+export default function UpcomingClasses({ widget, onRemove }: Props) {
+  const t = useTranslations('lms.DashboardPage');
+  const locale = useLocale();
+  const dateLocale = locale.startsWith('pt') ? ptBR : enUS;
+  const [page, setPage] = useState(1);
+
+  const { data, isLoading, isAccessDenied, isError } = useWidgetData<Data>({
+    endpoint: '/lms/dashboard',
+    queryKey: 'lms-dashboard',
+    select: (d) => ({ upcomingClasses: (d as any)?.upcomingClasses }),
+  });
+
+  const classes = useMemo(
+    () =>
+      (data?.upcomingClasses ?? []).map((item) => ({
+        id: item.id,
+        turma: item.className,
+        disciplina: item.subject,
+        professor: item.teacher,
+        data: format(
+          parseApiDateTime(item.date),
+          locale.startsWith('pt') ? 'dd/MM/yyyy' : 'MM/dd/yyyy',
+          { locale: dateLocale }
+        ),
+        horario: `${item.startTime} - ${item.endTime}`,
+      })),
+    [data, dateLocale, locale]
+  );
+
+  const paged = classes.slice((page - 1) * ITEMS_PER_PAGE, page * ITEMS_PER_PAGE);
+
+  return (
+    <WidgetWrapper
+      isLoading={isLoading}
+      isAccessDenied={isAccessDenied}
+      isError={isError}
+      widgetName={widget?.name || t('tables.upcomingClasses.title')}
+      onRemove={onRemove}
+    >
+      <Card className="h-full flex flex-col overflow-hidden border-border/70">
+        <CardHeader className="pb-2">
+          <CardTitle className="text-sm font-semibold">
+            {t('tables.upcomingClasses.title')}
+          </CardTitle>
+          <CardDescription>{t('tables.upcomingClasses.description')}</CardDescription>
+        </CardHeader>
+        <CardContent className="flex flex-1 flex-col">
+          <div className="overflow-x-auto">
+            <Table>
+              <TableHeader>
+                <TableRow>
+                  <TableHead>{t('tables.upcomingClasses.columns.class')}</TableHead>
+                  <TableHead>{t('tables.upcomingClasses.columns.subject')}</TableHead>
+                  <TableHead className="hidden sm:table-cell">{t('tables.upcomingClasses.columns.teacher')}</TableHead>
+                  <TableHead>{t('tables.upcomingClasses.columns.date')}</TableHead>
+                  <TableHead className="hidden md:table-cell">{t('tables.upcomingClasses.columns.time')}</TableHead>
+                </TableRow>
+              </TableHeader>
+              <TableBody>
+                {paged.map((aula) => (
+                  <TableRow key={aula.id}>
+                    <TableCell>
+                      <div className="flex items-center gap-2">
+                        <div className="flex size-8 items-center justify-center rounded-lg bg-muted">
+                          <BookOpen className="size-3.5 text-muted-foreground" />
+                        </div>
+                        <span className="font-medium">{aula.turma}</span>
+                      </div>
+                    </TableCell>
+                    <TableCell>{aula.disciplina}</TableCell>
+                    <TableCell className="hidden text-muted-foreground sm:table-cell">{aula.professor}</TableCell>
+                    <TableCell>
+                      <Badge variant="outline" className="text-xs font-normal">{aula.data}</Badge>
+                    </TableCell>
+                    <TableCell className="hidden text-muted-foreground md:table-cell">{aula.horario}</TableCell>
+                  </TableRow>
+                ))}
+              </TableBody>
+            </Table>
+          </div>
+          <div className="mt-auto border-t pt-4">
+            <PaginationFooter
+              currentPage={page}
+              pageSize={ITEMS_PER_PAGE}
+              totalItems={classes.length}
+              onPageChange={setPage}
+              onPageSizeChange={() => undefined}
+              pageSizeOptions={[ITEMS_PER_PAGE]}
+            />
+          </div>
+        </CardContent>
+      </Card>
+    </WidgetWrapper>
+  );
+}

package/hedhog/table/course.yaml

@@ -1,5 +1,9 @@
 columns:
   - type: pk
+  - name: code
+    type: varchar
+    length: 32
+    isNullable: true
   - name: title
     type: varchar
     length: 255
@@ -20,14 +24,18 @@ columns:
   - name: duration_hours
     type: int
     default: 0
-  - name: status
-    type: enum
-    values: [draft, published, archived]
-    default: draft
-  - name: primary_color
-    type: varchar
-    length: 9
-    isNullable: true
+  - name: status
+    type: enum
+    values: [draft, published, archived]
+    default: draft
+  - name: offering_type
+    type: enum
+    values: [scheduled, on_demand, blended]
+    default: on_demand
+  - name: primary_color
+    type: varchar
+    length: 9
+    isNullable: true
   - name: primary_contrast_color
     type: varchar
     length: 9
@@ -59,11 +67,21 @@ columns:
   - name: target_audience
     type: text
     isNullable: true
+  - name: is_featured
+    type: boolean
+    default: false
+  - name: has_certificate
+    type: boolean
+    default: false
+  - name: is_listed
+    type: boolean
+    default: false
   - type: created_at
   - type: updated_at
 
 indices:
   - columns: [slug]
     isUnique: true
-  - columns: [certificate_template_id]
-  - columns: [status]
+  - columns: [certificate_template_id]
+  - columns: [status]
+  - columns: [offering_type]

package/hedhog/table/course_class_group.yaml

@@ -6,6 +6,13 @@ columns:
       table: course
       column: id
       onDelete: CASCADE
+  - name: instructor_id
+    type: fk
+    references:
+      table: instructor
+      column: id
+      onDelete: SET NULL
+    isNullable: true
   - name: title
     type: varchar
     length: 255
@@ -55,4 +62,5 @@ indices:
   - columns: [code]
     isUnique: true
   - columns: [course_id]
+  - columns: [instructor_id]
   - columns: [status]

package/hedhog/table/course_class_session.yaml

@@ -27,12 +27,45 @@ columns:
     type: varchar
     length: 500
     isNullable: true
+  - name: color
+    type: varchar
+    length: 9
+    isNullable: true
+    comment: "Hex color used to render the session on the calendar"
   - name: status
     type: enum
     values: [scheduled, completed, cancelled]
     default: scheduled
+  - name: recurrence_id
+    type: varchar
+    length: 50
+    isNullable: true
+    comment: "Unique identifier for recurring series; all instances share the same recurrence_id"
+  - name: recurrence_rule
+    type: text
+    isNullable: true
+    comment: "RFC-like recurrence metadata in JSON format: {freq, interval, byDay, until, exdate}"
+  - name: occurrence_index
+    type: int
+    isNullable: true
+    comment: "Zero-based index of this occurrence within the series (0, 1, 2, ...)"
+  - name: is_exception
+    type: boolean
+    isNullable: true
+    default: false
+    comment: "Marks if this occurrence was modified or excluded from the original series"
+  - name: parent_session_id
+    type: fk
+    isNullable: true
+    references:
+      table: course_class_session
+      column: id
+      onDelete: CASCADE
+    comment: "If set, points to the first session in the recurrence series for easy parent lookup"
   - type: created_at
   - type: updated_at
 
 indices:
   - columns: [course_class_group_id, session_date]
+  - columns: [recurrence_id, occurrence_index]
+  - columns: [parent_session_id]

package/hedhog/table/course_instructor.yaml

@@ -0,0 +1,27 @@
+columns:
+  - type: pk
+  - name: course_id
+    type: fk
+    references:
+      table: course
+      column: id
+      onDelete: CASCADE
+  - name: instructor_id
+    type: fk
+    references:
+      table: instructor
+      column: id
+      onDelete: CASCADE
+  - name: role
+    type: enum
+    values: [lead, assistant]
+    default: assistant
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [course_id, instructor_id]
+    isUnique: true
+  - columns: [course_id]
+  - columns: [instructor_id]
+  - columns: [role]

package/hedhog/table/enterprise.yaml

@@ -0,0 +1,29 @@
+columns:
+  - type: pk
+  - name: name
+    type: varchar
+    length: 255
+  - name: slug
+    type: slug
+  - name: status
+    type: enum
+    values: [active, trial, inactive, suspended]
+    default: active
+  - name: crm_person_id
+    type: fk
+    isNullable: true
+    references:
+      table: person
+      column: id
+      onDelete: SET NULL
+  - name: portal_enabled
+    type: boolean
+    default: false
+  - name: license_limit
+    type: int
+    isNullable: true
+  - name: notes
+    type: text
+    isNullable: true
+  - type: created_at
+  - type: updated_at

package/hedhog/table/enterprise_class_group.yaml

@@ -0,0 +1,20 @@
+columns:
+  - type: pk
+  - name: enterprise_id
+    type: fk
+    references:
+      table: enterprise
+      column: id
+      onDelete: CASCADE
+  - name: course_class_group_id
+    type: fk
+    references:
+      table: course_class_group
+      column: id
+      onDelete: CASCADE
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [enterprise_id, course_class_group_id]
+    isUnique: true

package/hedhog/table/enterprise_course.yaml

@@ -0,0 +1,23 @@
+columns:
+  - type: pk
+  - name: enterprise_id
+    type: fk
+    references:
+      table: enterprise
+      column: id
+      onDelete: CASCADE
+  - name: course_id
+    type: fk
+    references:
+      table: course
+      column: id
+      onDelete: CASCADE
+  - name: contracted_at
+    type: datetime
+    isNullable: true
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [enterprise_id, course_id]
+    isUnique: true

package/hedhog/table/enterprise_student.yaml

@@ -0,0 +1,24 @@
+columns:
+  - type: pk
+  - name: enterprise_id
+    type: fk
+    references:
+      table: enterprise
+      column: id
+      onDelete: CASCADE
+  - name: person_id
+    type: fk
+    references:
+      table: person
+      column: id
+      onDelete: CASCADE
+  - name: status
+    type: enum
+    values: [active, inactive, pending]
+    default: pending
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [enterprise_id, person_id]
+    isUnique: true

package/hedhog/table/enterprise_user.yaml

@@ -0,0 +1,35 @@
+columns:
+  - type: pk
+  - name: enterprise_id
+    type: fk
+    references:
+      table: enterprise
+      column: id
+      onDelete: CASCADE
+  - name: user_id
+    type: fk
+    references:
+      table: user
+      column: id
+      onDelete: CASCADE
+  - name: person_id
+    type: fk
+    isNullable: true
+    references:
+      table: person
+      column: id
+      onDelete: SET NULL
+  - name: role
+    type: enum
+    values: [hr_manager, enterprise_admin, viewer]
+    default: viewer
+  - name: status
+    type: enum
+    values: [active, inactive, pending]
+    default: pending
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [enterprise_id, user_id]
+    isUnique: true

package/hedhog/table/instructor_qualification.yaml

@@ -0,0 +1,26 @@
+columns:
+  - type: pk
+  - name: slug
+    isUnique: true
+  - name: name
+    type: locale_varchar
+    locale:
+      pt: Nome
+      en: Name
+  - name: description
+    type: locale_text
+    isNullable: true
+    locale:
+      pt: Descricao
+      en: Description
+  - name: status
+    type: enum
+    values: [active, inactive]
+    default: active
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [slug]
+    isUnique: true
+  - columns: [status]

package/hedhog/table/instructor_qualification_assignment.yaml

@@ -0,0 +1,22 @@
+columns:
+  - type: pk
+  - name: instructor_id
+    type: fk
+    references:
+      table: instructor
+      column: id
+      onDelete: CASCADE
+  - name: qualification_id
+    type: fk
+    references:
+      table: instructor_qualification
+      column: id
+      onDelete: CASCADE
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [instructor_id, qualification_id]
+    isUnique: true
+  - columns: [instructor_id]
+  - columns: [qualification_id]

package/hedhog/table/question.yaml

@@ -8,6 +8,12 @@ columns:
   - name: explanation
     type: text
     isNullable: true
+  - name: fill_blank_answers
+    type: json
+    isNullable: true
+  - name: matching_pairs
+    type: json
+    isNullable: true
   - name: points
     type: int
     default: 1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hed-hog/lms",
-  "version": "0.0.303",
+  "version": "0.0.305",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "dependencies": {
@@ -12,12 +12,12 @@
     "@hed-hog/api-prisma": "0.0.6",
     "@hed-hog/api-types": "0.0.1",
     "@hed-hog/api-pagination": "0.0.7",
-    "@hed-hog/contact": "0.0.303",
-    "@hed-hog/core": "0.0.303",
-    "@hed-hog/finance": "0.0.303",
+    "@hed-hog/core": "0.0.305",
+    "@hed-hog/finance": "0.0.305",
+    "@hed-hog/category": "0.0.305",
     "@hed-hog/api": "0.0.6",
-    "@hed-hog/category": "0.0.303",
-    "@hed-hog/api-locale": "0.0.14"
+    "@hed-hog/api-locale": "0.0.14",
+    "@hed-hog/contact": "0.0.305"
   },
   "exports": {
     ".": {

package/src/certificate/certificate.controller.ts

@@ -0,0 +1,83 @@
+import { Role } from '@hed-hog/api';
+import {
+    Body,
+    Controller,
+    Delete,
+    Get,
+    Param,
+    ParseIntPipe,
+    Patch,
+    Post,
+    Query,
+    UploadedFile,
+    UseInterceptors,
+} from '@nestjs/common';
+import { FileInterceptor } from '@nestjs/platform-express';
+import { LmsCertificateService } from './certificate.service';
+import { CreateCertificateTemplateDto } from './dto/create-certificate-template.dto';
+import { UpdateCertificateTemplateDto } from './dto/update-certificate-template.dto';
+
+@Role()
+@Controller('lms/certificates')
+export class LmsCertificateController {
+  constructor(private readonly certificateService: LmsCertificateService) {}
+
+  @Get('templates')
+  listTemplates(
+    @Query('page') page?: string,
+    @Query('pageSize') pageSize?: string,
+    @Query('search') search?: string,
+    @Query('status') status?: string,
+  ) {
+    return this.certificateService.listTemplates({
+      page: page ? Number(page) : 1,
+      pageSize: pageSize ? Number(pageSize) : 12,
+      search,
+      status,
+    });
+  }
+
+  @Get('templates/:id')
+  getTemplateById(@Param('id', ParseIntPipe) id: number) {
+    return this.certificateService.getTemplateById(id);
+  }
+
+  @Post('templates')
+  createTemplate(@Body() dto: CreateCertificateTemplateDto) {
+    return this.certificateService.createTemplate(dto);
+  }
+
+  @Patch('templates/:id')
+  updateTemplate(
+    @Param('id', ParseIntPipe) id: number,
+    @Body() dto: UpdateCertificateTemplateDto,
+  ) {
+    return this.certificateService.updateTemplate(id, dto);
+  }
+
+  @Post('templates/background-image')
+  @UseInterceptors(FileInterceptor('file'))
+  uploadTemplateBackgroundImage(@UploadedFile() file: any) {
+    return this.certificateService.uploadTemplateBackgroundImage(file);
+  }
+
+  @Delete('templates/:id')
+  deleteTemplate(@Param('id', ParseIntPipe) id: number) {
+    return this.certificateService.deleteTemplate(id);
+  }
+
+  @Get('issued')
+  listIssued(
+    @Query('page') page?: string,
+    @Query('pageSize') pageSize?: string,
+    @Query('search') search?: string,
+    @Query('type') type?: string,
+  ) {
+    return this.certificateService.listIssued({
+      page: page ? Number(page) : 1,
+      pageSize: pageSize ? Number(pageSize) : 12,
+      search,
+      type,
+    });
+  }
+}

package/src/certificate/certificate.module.ts

@@ -0,0 +1,13 @@
+import { PrismaModule } from '@hed-hog/api-prisma';
+import { FileModule } from '@hed-hog/core';
+import { forwardRef, Module } from '@nestjs/common';
+import { LmsCertificateController } from './certificate.controller';
+import { LmsCertificateService } from './certificate.service';
+
+@Module({
+  imports: [forwardRef(() => PrismaModule), forwardRef(() => FileModule)],
+  controllers: [LmsCertificateController],
+  providers: [LmsCertificateService],
+  exports: [forwardRef(() => LmsCertificateService)],
+})
+export class LmsCertificateModule {}