@hed-hog/lms 0.0.358 → 0.0.364

package/hedhog/table/lms_bulk_upload_session.yaml

@@ -0,0 +1,42 @@
+columns:
+  - type: pk
+  - name: user_id
+    type: fk
+    references:
+      table: user
+      column: id
+      onDelete: CASCADE
+  - name: app_name
+    type: varchar
+    length: 80
+    default: hedhog-desktop
+  - name: folder_path
+    type: text
+    isNullable: true
+  - name: status
+    type: enum
+    values: [started, uploading, paused, cancelling, completed, failed, cancelled]
+    default: started
+  - name: progress_percent
+    type: int
+    default: 0
+  - name: total_files
+    type: int
+    default: 0
+  - name: total_bytes
+    type: bigint
+    default: 0
+  - name: heartbeat_at
+    type: datetime
+    isNullable: true
+  - name: started_at
+    type: datetime
+  - name: finished_at
+    type: datetime
+    isNullable: true
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [user_id, created_at]
+  - columns: [status, updated_at]

package/hedhog/table/student_area_xp.yaml

@@ -0,0 +1,30 @@
+columns:
+  - type: pk
+  - name: person_id
+    type: fk
+    references:
+      table: person
+      column: id
+      onDelete: CASCADE
+  - name: xp_area_id
+    type: fk
+    references:
+      table: xp_area
+      column: id
+      onDelete: CASCADE
+  - name: total_xp
+    type: int
+    default: 0
+  - name: event_count
+    type: int
+    default: 0
+  - name: last_updated_at
+    type: datetime
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [person_id, xp_area_id]
+    isUnique: true
+  - columns: [xp_area_id]
+  - columns: [person_id, total_xp]

package/hedhog/table/student_learning_type_xp.yaml

@@ -0,0 +1,30 @@
+columns:
+  - type: pk
+  - name: person_id
+    type: fk
+    references:
+      table: person
+      column: id
+      onDelete: CASCADE
+  - name: xp_learning_type_id
+    type: fk
+    references:
+      table: xp_learning_type
+      column: id
+      onDelete: CASCADE
+  - name: total_xp
+    type: int
+    default: 0
+  - name: event_count
+    type: int
+    default: 0
+  - name: last_updated_at
+    type: datetime
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [person_id, xp_learning_type_id]
+    isUnique: true
+  - columns: [xp_learning_type_id]
+  - columns: [person_id, total_xp]

package/hedhog/table/student_skill_xp.yaml

@@ -0,0 +1,30 @@
+columns:
+  - type: pk
+  - name: person_id
+    type: fk
+    references:
+      table: person
+      column: id
+      onDelete: CASCADE
+  - name: xp_skill_id
+    type: fk
+    references:
+      table: xp_skill
+      column: id
+      onDelete: CASCADE
+  - name: total_xp
+    type: int
+    default: 0
+  - name: event_count
+    type: int
+    default: 0
+  - name: last_updated_at
+    type: datetime
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [person_id, xp_skill_id]
+    isUnique: true
+  - columns: [xp_skill_id]
+  - columns: [person_id, total_xp]

package/hedhog/table/student_xp_event.yaml

@@ -0,0 +1,34 @@
+columns:
+  - type: pk
+  - name: course_enrollment_id
+    type: fk
+    references:
+      table: course_enrollment
+      column: id
+      onDelete: CASCADE
+  - name: lesson_xp_segment_id
+    type: fk
+    references:
+      table: lesson_xp_segment
+      column: id
+      onDelete: CASCADE
+  - name: xp_earned
+    type: int
+    default: 0
+  - name: watch_percent
+    type: NUMERIC(5,2)
+    default: 0
+  - name: granted_at
+    type: datetime
+  - name: source
+    type: enum
+    values: [video_watch, manual_grant, recalculation, admin_override]
+    default: video_watch
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [course_enrollment_id, lesson_xp_segment_id]
+    isUnique: true
+  - columns: [lesson_xp_segment_id]
+  - columns: [course_enrollment_id, granted_at]

package/hedhog/table/xp_area.yaml

@@ -0,0 +1,39 @@
+columns:
+  - type: pk
+  - name: slug
+    type: varchar
+    length: 100
+    isUnique: true
+  - name: name
+    type: locale_varchar
+    locale:
+      pt: Nome
+      en: Name
+  - name: description
+    type: locale_text
+    isNullable: true
+    locale:
+      pt: Descrição
+      en: Description
+  - name: icon_slug
+    type: varchar
+    length: 100
+    isNullable: true
+  - name: color
+    type: varchar
+    length: 9
+    isNullable: true
+  - name: sort_order
+    type: int
+    default: 0
+  - 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/xp_learning_type.yaml

@@ -0,0 +1,34 @@
+columns:
+  - type: pk
+  - name: slug
+    type: varchar
+    length: 100
+    isUnique: true
+  - name: name
+    type: locale_varchar
+    locale:
+      pt: Nome
+      en: Name
+  - name: description
+    type: locale_text
+    isNullable: true
+    locale:
+      pt: Descrição
+      en: Description
+  - name: multiplier
+    type: NUMERIC(5,2)
+    default: 1.00
+  - name: sort_order
+    type: int
+    default: 0
+  - 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/xp_skill.yaml

@@ -0,0 +1,39 @@
+columns:
+  - type: pk
+  - name: xp_area_id
+    type: fk
+    references:
+      table: xp_area
+      column: id
+      onDelete: SET NULL
+    isNullable: true
+  - name: slug
+    type: varchar
+    length: 100
+    isUnique: true
+  - name: name
+    type: locale_varchar
+    locale:
+      pt: Nome
+      en: Name
+  - name: description
+    type: locale_text
+    isNullable: true
+    locale:
+      pt: Descrição
+      en: Description
+  - name: sort_order
+    type: int
+    default: 0
+  - name: status
+    type: enum
+    values: [active, inactive]
+    default: active
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [slug]
+    isUnique: true
+  - columns: [xp_area_id]
+  - columns: [status]

package/package.json

@@ -1,24 +1,25 @@
 {
   "name": "@hed-hog/lms",
-  "version": "0.0.358",
+  "version": "0.0.364",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "dependencies": {
+    "@aws-sdk/client-s3": "^3.888.0",
     "@nestjs/common": "*",
     "@nestjs/config": "^4.0.2",
     "@nestjs/core": "^11",
     "@nestjs/jwt": "^11",
     "@nestjs/mapped-types": "*",
-    "@hed-hog/api": "0.0.8",
+    "@hed-hog/api-types": "0.0.1",
     "@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-pagination": "0.0.7",
-    "@hed-hog/crm": "0.0.358",
-    "@hed-hog/category": "0.0.358",
-    "@hed-hog/queue": "0.0.358",
-    "@hed-hog/finance": "0.0.358",
-    "@hed-hog/core": "0.0.358"
+    "@hed-hog/finance": "0.0.364",
+    "@hed-hog/category": "0.0.364",
+    "@hed-hog/core": "0.0.364",
+    "@hed-hog/crm": "0.0.364",
+    "@hed-hog/queue": "0.0.364"
   },
   "exports": {
     ".": {

package/src/bitcode-wallet/bitcode-wallet.service.ts

@@ -1,9 +1,11 @@
 import { PrismaService } from '@hed-hog/api-prisma';
 import {
+    BadRequestException,
     ConflictException,
     Injectable,
     NotFoundException,
 } from '@nestjs/common';
+import { CreateCurrentBitcodeWalletTransactionDto } from './dto/create-current-bitcode-wallet-transaction.dto';
 import { CreateBitcodeWalletTransactionDto } from './dto/create-bitcode-wallet-transaction.dto';
 import { CreateBitcodeWalletDto } from './dto/create-bitcode-wallet.dto';
 import { UpdateBitcodeWalletDto } from './dto/update-bitcode-wallet.dto';
@@ -220,6 +222,48 @@ export class BitcodeWalletService {
     return this.getById(created.id);
   }
 
+  async getCurrentUserWallet(userId: number) {
+    const personId = await this.resolvePersonIdFromUser(userId);
+    const existingWallet = await this.findWalletByPersonId(personId);
+
+    return existingWallet ? this.getById(existingWallet.id) : null;
+  }
+
+  async creditCurrentUserWallet(
+    userId: number,
+    dto: CreateCurrentBitcodeWalletTransactionDto
+  ) {
+    return this.createCurrentUserTransaction(userId, {
+      ...dto,
+      type: 'credit',
+    });
+  }
+
+  async createCurrentUserTransaction(
+    userId: number,
+    dto: CreateCurrentBitcodeWalletTransactionDto
+  ) {
+    const amount = Math.trunc(Number(dto.amount));
+    const type = dto.type ?? 'credit';
+
+    if (!Number.isFinite(amount) || amount < 1) {
+      throw new BadRequestException('BitCode transaction amount must be positive');
+    }
+
+    const personId = await this.resolvePersonIdFromUser(userId);
+    const wallet = await this.getOrCreateWalletByPersonId(personId);
+
+    if (type === 'debit' && Number(wallet.currentBalance ?? 0) < amount) {
+      throw new BadRequestException('Insufficient BitCode balance');
+    }
+
+    return this.createTransaction(wallet.id, {
+      type,
+      amount,
+      description: this.buildCurrentTransactionDescription(dto, type),
+    });
+  }
+
   async update(id: number, dto: UpdateBitcodeWalletDto) {
     await this.ensureWalletExists(id);
 
@@ -287,6 +331,55 @@ export class BitcodeWalletService {
     }
   }
 
+  private async resolvePersonIdFromUser(userId: number) {
+    const row = await this.querySingle<{ personId: number }>(
+      `SELECT person_id AS "personId" FROM person_user WHERE user_id = $1 LIMIT 1`,
+      [userId]
+    );
+
+    if (!row) {
+      throw new NotFoundException('No person profile found for this user');
+    }
+
+    return Number(row.personId);
+  }
+
+  private async findWalletByPersonId(personId: number) {
+    return this.querySingle<{ id: number }>(
+      `SELECT id FROM bitcode_wallet WHERE person_id = $1`,
+      [personId]
+    );
+  }
+
+  private async getOrCreateWalletByPersonId(personId: number) {
+    await this.ensurePersonExists(personId);
+
+    const created = await this.querySingle<{ id: number }>(
+      `INSERT INTO bitcode_wallet (
+          person_id,
+          current_balance,
+          created_at,
+          updated_at
+        ) VALUES (
+          $1,
+          0,
+          NOW(),
+          NOW()
+        )
+        ON CONFLICT (person_id) DO NOTHING
+        RETURNING id`,
+      [personId]
+    );
+
+    const wallet = created ?? (await this.findWalletByPersonId(personId));
+
+    if (!wallet) {
+      throw new NotFoundException('BitCode wallet not found');
+    }
+
+    return this.getById(wallet.id);
+  }
+
   private async ensureWalletExists(id: number) {
     const row = await this.querySingle<{ id: number }>(
       `SELECT id FROM bitcode_wallet WHERE id = $1`,
@@ -345,6 +438,26 @@ export class BitcodeWalletService {
     return normalized ? normalized : null;
   }
 
+  private buildCurrentTransactionDescription(
+    dto: CreateCurrentBitcodeWalletTransactionDto,
+    type: 'credit' | 'debit'
+  ) {
+    const description = this.normalizeOptionalText(dto.description);
+    const source = this.normalizeOptionalText(dto.source);
+    const fallback = type === 'debit' ? 'Class debit' : 'Class reward';
+
+    if (description && source) {
+      return description.toLowerCase().includes(source.toLowerCase())
+        ? description
+        : `${description} - ${source}`;
+    }
+
+    if (description) return description;
+    if (source) return `${fallback}: ${source}`;
+
+    return fallback;
+  }
+
   private param(values: unknown[], value: unknown) {
     values.push(value);
     return `$${values.length}`;

package/src/bitcode-wallet/dto/create-current-bitcode-wallet-transaction.dto.ts

@@ -0,0 +1,32 @@
+import {
+  IsEnum,
+  IsInt,
+  IsOptional,
+  IsString,
+  MaxLength,
+  Min,
+} from 'class-validator';
+import {
+  BITCODE_TRANSACTION_TYPE_VALUES,
+  type BitcodeTransactionType,
+} from './create-bitcode-wallet-transaction.dto';
+
+export class CreateCurrentBitcodeWalletTransactionDto {
+  @IsOptional()
+  @IsEnum(BITCODE_TRANSACTION_TYPE_VALUES)
+  type?: BitcodeTransactionType;
+
+  @IsInt()
+  @Min(1)
+  amount: number;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(2000)
+  description?: string | null;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(200)
+  source?: string | null;
+}

package/src/course/course-audio-transcription.service.ts

@@ -1,6 +1,6 @@
 import { PrismaService } from '@hed-hog/api-prisma';
 import { buildAiConfigFromIntegration, FileService, NotificationService, SettingService } from '@hed-hog/core';
-import { IJobHandler, QueueHandlerRegistry } from '@hed-hog/queue';
+import { DatabaseQueueProvider, IJobHandler, NonRetryableError, QueueHandlerRegistry } from '@hed-hog/queue';
 import {
     Inject,
     Injectable,
@@ -102,6 +102,8 @@ export class CourseAudioTranscriptionService implements OnModuleInit, IJobHandle
     private readonly notificationService: NotificationService,
     @Inject(forwardRef(() => QueueHandlerRegistry))
     private readonly registry: QueueHandlerRegistry,
+    @Inject(forwardRef(() => DatabaseQueueProvider))
+    private readonly dbQueue: DatabaseQueueProvider,
   ) {}
 
   onModuleInit() {
@@ -159,18 +161,11 @@ export class CourseAudioTranscriptionService implements OnModuleInit, IJobHandle
     const transcriptionEnabled = settings['lms-audio-transcription-enabled'] !== false;
 
     if (!transcriptionEnabled) {
-      this.logger.warn(
-        `Transcription skipped for lesson ${lessonId}: disabled by lms-audio-transcription-enabled setting`,
-      );
+      const msg = `Transcrição desabilitada nas configurações do LMS (lms-audio-transcription-enabled=false).`;
       if (notificationContext) {
-        await this.updateAsyncNotification(
-          notificationContext,
-          100,
-          'Transcrição desabilitada nas configurações do LMS.',
-          false,
-        );
+        await this.updateAsyncNotification(notificationContext, 100, msg, false);
       }
-      return;
+      throw new NonRetryableError(msg);
     }
 
     const profileId = Number(settings['ai-openai-profile-id']);
@@ -190,18 +185,14 @@ export class CourseAudioTranscriptionService implements OnModuleInit, IJobHandle
     }
 
     if (!apiKey) {
-      this.logger.warn(
-        `Transcription skipped for lesson ${lessonId}: OpenAI profile not configured`,
-      );
+      const profileIdValue = settings['ai-openai-profile-id'];
+      const msg = profileIdValue
+        ? `Perfil de IA (id=${profileIdValue}) não encontrado ou não possui chave de API OpenAI configurada. Verifique em Settings → Integrações → Profiles.`
+        : `Transcrição de áudio requer um perfil OpenAI configurado.\n\nComo configurar:\n1. Acesse Settings → Integrações → Profiles\n2. Crie um perfil do tipo OpenAI com sua API Key\n3. Copie o ID do perfil criado\n4. Acesse Settings → LMS e defina o campo \'ai-openai-profile-id\' com esse ID`;
       if (notificationContext) {
-        await this.updateAsyncNotification(
-          notificationContext,
-          100,
-          'Transcrição não iniciada: perfil de IA não configurado em Settings → AI.',
-          false,
-        );
+        await this.updateAsyncNotification(notificationContext, 100, msg, false);
       }
-      return;
+      throw new NonRetryableError(msg);
     }
 
     const course = await (this.prismaService as any).course.findUnique({
@@ -369,6 +360,52 @@ export class CourseAudioTranscriptionService implements OnModuleInit, IJobHandle
       this.logger.log(
         `Transcription saved for lesson ${lessonId}: ${allSegments.length} segments`,
       );
+
+      // Automatically trigger XP calculation after transcription completes.
+      try {
+        const existingMap = await (this.prismaService as any).lesson_xp_map.findUnique({
+          where: { course_lesson_id: lessonId },
+          select: { id: true },
+        });
+
+        let mapId: number;
+        if (existingMap) {
+          mapId = existingMap.id;
+          await this.prismaService.$executeRawUnsafe(
+            `UPDATE lesson_xp_map
+                SET status = 'processing'::lesson_xp_map_status_d4e5f6a7b8_enum,
+                    processing_error = NULL,
+                    updated_at = NOW()
+              WHERE id = $1`,
+            mapId,
+          );
+        } else {
+          const rows = await this.prismaService.$queryRawUnsafe<{ id: number }[]>(
+            `INSERT INTO lesson_xp_map (course_lesson_id, version, total_xp, status, created_at, updated_at)
+             VALUES ($1, 1, 0, 'processing'::lesson_xp_map_status_d4e5f6a7b8_enum, NOW(), NOW())
+             RETURNING id`,
+            lessonId,
+          );
+          mapId = rows[0].id;
+        }
+
+        await this.dbQueue.enqueue({
+          type: 'lms.lesson.xp.calculate',
+          queueName: 'lms.lesson.xp.calculate',
+          payload: { lessonId, mapId, userId: notificationUserId ?? 0 },
+          maxAttempts: 3,
+          sourceModule: 'lms',
+          sourceEntity: 'course_lesson',
+          sourceEntityId: String(lessonId),
+        });
+
+        this.logger.log(`XP calculation job enqueued for lesson ${lessonId} (map ${mapId})`);
+      } catch (xpErr) {
+        this.logger.warn(
+          `Failed to enqueue XP calculation for lesson ${lessonId}: ${xpErr instanceof Error ? xpErr.message : String(xpErr)}`,
+        );
+      }
+
       await emitProgress(
         `Transcrição concluída com ${allSegments.length} segmento(s).`,
         {

package/src/course/course-lesson.controller.ts

@@ -1,5 +1,5 @@
 import { Role } from '@hed-hog/api';
-import { Body, Controller, Get, Param, ParseIntPipe, Put } from '@nestjs/common';
+import { Body, Controller, Get, Param, ParseIntPipe, Post, Put } from '@nestjs/common';
 import { CourseStructureService } from './course-structure.service';
 import { UpdateTranscriptionSegmentsDTO } from './dto/update-transcription-segments.dto';
 
@@ -25,4 +25,9 @@ export class CourseLessonController {
   getAudioFiles(@Param('id', ParseIntPipe) id: number) {
     return this.courseStructureService.getAudioFiles(id);
   }
+
+  @Post(':id/transcription/start')
+  startTranscription(@Param('id', ParseIntPipe) id: number) {
+    return this.courseStructureService.startTranscription(id);
+  }
 }

package/src/course/course-structure.controller.ts

@@ -11,6 +11,7 @@ import {
 } from '@nestjs/common';
 import { CourseStructureService } from './course-structure.service';
 import { CourseVideoConversionService } from './course-video-conversion.service';
+import { CreateCourseBulkJobDto } from './dto/create-course-bulk-job.dto';
 import { CreateCourseLessonFrameDto } from './dto/create-course-lesson-frame.dto';
 import {
     CreateCourseStructureLessonDto,
@@ -227,4 +228,13 @@ export class CourseStructureController {
   ) {
     return this.courseStructureService.duplicateLesson(courseId, sessionId, lessonId);
   }
+
+  @Post('bulk-jobs')
+  createBulkJobs(
+    @User() user: any,
+    @Param('id', ParseIntPipe) courseId: number,
+    @Body() dto: CreateCourseBulkJobDto,
+  ) {
+    return this.courseStructureService.bulkEnqueueJobs(courseId, dto.jobType, user?.id ?? 0);
+  }
 }