@hed-hog/lms 0.0.349 → 0.0.351

package/hedhog/query/triggers.sql

@@ -0,0 +1,53 @@
+CREATE OR REPLACE FUNCTION sync_bitcode_wallet_balance()
+RETURNS TRIGGER
+LANGUAGE plpgsql
+AS $$
+DECLARE
+  target_wallet_id INTEGER;
+BEGIN
+  target_wallet_id := COALESCE(NEW.wallet_id, OLD.wallet_id);
+
+  UPDATE bitcode_wallet
+     SET current_balance = COALESCE((
+           SELECT SUM(
+             CASE
+               WHEN type = 'credit' THEN amount
+               ELSE -amount
+             END
+           )
+           FROM bitcode_wallet_transaction
+           WHERE wallet_id = target_wallet_id
+         ), 0),
+         updated_at = NOW()
+   WHERE id = target_wallet_id;
+
+  IF TG_OP = 'UPDATE'
+     AND NEW.wallet_id IS DISTINCT FROM OLD.wallet_id
+     AND OLD.wallet_id IS NOT NULL THEN
+    UPDATE bitcode_wallet
+       SET current_balance = COALESCE((
+             SELECT SUM(
+               CASE
+                 WHEN type = 'credit' THEN amount
+                 ELSE -amount
+               END
+             )
+             FROM bitcode_wallet_transaction
+             WHERE wallet_id = OLD.wallet_id
+           ), 0),
+           updated_at = NOW()
+     WHERE id = OLD.wallet_id;
+  END IF;
+
+  RETURN COALESCE(NEW, OLD);
+END;
+$$;
+
+DROP TRIGGER IF EXISTS bitcode_wallet_transaction_sync_balance_trigger
+  ON bitcode_wallet_transaction;
+
+CREATE TRIGGER bitcode_wallet_transaction_sync_balance_trigger
+AFTER INSERT OR UPDATE OR DELETE
+ON bitcode_wallet_transaction
+FOR EACH ROW
+EXECUTE FUNCTION sync_bitcode_wallet_balance();

package/hedhog/table/achievement.yaml

@@ -0,0 +1,46 @@
+columns:
+  - type: pk
+  - name: name
+    type: varchar
+    length: 255
+  - name: description
+    type: text
+    isNullable: true
+  - name: icon_file_id
+    type: fk
+    references:
+      table: file
+      column: id
+      onDelete: SET NULL
+    isNullable: true
+  - name: main_image_file_id
+    type: fk
+    references:
+      table: file
+      column: id
+      onDelete: SET NULL
+    isNullable: true
+  - name: type
+    type: enum
+    values:
+      [
+        course_completion,
+        learning_path_completion,
+        exam_approval,
+        attendance,
+        engagement,
+        custom,
+      ]
+    default: custom
+  - name: bitcodes_value
+    type: int
+    default: 0
+  - name: can_receive_multiple_times
+    type: boolean
+    default: false
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [name]
+  - columns: [type]

package/hedhog/table/bitcode_wallet.yaml

@@ -0,0 +1,18 @@
+columns:
+  - type: pk
+  - name: person_id
+    type: fk
+    references:
+      table: person
+      column: id
+      onDelete: CASCADE
+  - name: current_balance
+    type: int
+    default: 0
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [person_id]
+    isUnique: true
+  - columns: [current_balance]

package/hedhog/table/bitcode_wallet_transaction.yaml

@@ -0,0 +1,22 @@
+columns:
+  - type: pk
+  - name: wallet_id
+    type: fk
+    references:
+      table: bitcode_wallet
+      column: id
+      onDelete: CASCADE
+  - name: type
+    type: enum
+    values: [credit, debit]
+  - name: amount
+    type: int
+  - name: description
+    type: text
+    isNullable: true
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [wallet_id, created_at]
+  - columns: [type]

package/hedhog/table/certificate.yaml

@@ -71,6 +71,9 @@ columns:
     type: varchar
     length: 500
     isNullable: true
+  - name: public_access
+    type: boolean
+    default: false
   - name: pdf_url
     type: varchar
     length: 500

package/hedhog/table/course.yaml

@@ -76,6 +76,13 @@ columns:
   - name: is_listed
     type: boolean
     default: false
+  - name: operations_project_id
+    type: int
+    isNullable: true
+  - name: code
+    type: varchar
+    length: 32
+    isNullable: true
   - type: created_at
   - type: updated_at
 
@@ -85,3 +92,4 @@ indices:
   - columns: [certificate_template_id]
   - columns: [status]
   - columns: [offering_type]
+  - columns: [operations_project_id]

package/hedhog/table/course_file.yaml

@@ -0,0 +1,23 @@
+columns:
+  - type: pk
+  - name: course_id
+    type: fk
+    references:
+      table: course
+      column: id
+      onDelete: CASCADE
+  - name: file_id
+    type: fk
+    isNullable: true
+    references:
+      table: file
+      column: id
+      onDelete: SET NULL
+  - name: title
+    type: varchar
+    length: 255
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [course_id]

package/hedhog/table/course_lesson.yaml

@@ -22,6 +22,9 @@ columns:
   - name: duration_seconds
     type: int
     default: 0
+  - name: operations_task_id
+    type: int
+    isNullable: true
   - type: order
   - name: is_released
     type: boolean
@@ -31,5 +34,7 @@ columns:
 
 indices:
   - columns: [course_module_id]
+  - columns: [operations_task_id]
+    isUnique: true
   - columns: [course_module_id, order]
     isUnique: true

package/hedhog/table/course_lesson_discussion_like.yaml

@@ -0,0 +1,21 @@
+columns:
+  - type: pk
+  - name: topic_id
+    type: fk
+    references:
+      table: course_lesson_discussion_topic
+      column: id
+      onDelete: CASCADE
+  - name: person_id
+    type: fk
+    references:
+      table: person
+      column: id
+      onDelete: CASCADE
+  - type: created_at
+
+indices:
+  - columns: [topic_id]
+  - columns: [person_id]
+  - columns: [topic_id, person_id]
+    isUnique: true

package/hedhog/table/course_lesson_discussion_topic.yaml

@@ -0,0 +1,35 @@
+columns:
+  - type: pk
+  - name: course_lesson_id
+    type: fk
+    references:
+      table: course_lesson
+      column: id
+      onDelete: CASCADE
+  - name: person_id
+    type: fk
+    references:
+      table: person
+      column: id
+      onDelete: CASCADE
+  - name: parent_topic_id
+    type: fk
+    isNullable: true
+    references:
+      table: course_lesson_discussion_topic
+      column: id
+      onDelete: CASCADE
+  - name: content
+    type: text
+  - name: player_time_seconds
+    type: int
+    default: 0
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [course_lesson_id]
+  - columns: [person_id]
+  - columns: [parent_topic_id]
+  - columns: [course_lesson_id, parent_topic_id]
+  - columns: [course_lesson_id, player_time_seconds]

package/hedhog/table/course_lesson_file.yaml

@@ -16,8 +16,16 @@ columns:
   - name: title
     type: varchar
     length: 255
+  - name: tipo
+    type: varchar
+    length: 80
+    isNullable: true
+  - name: publico
+    type: boolean
+    default: true
   - type: created_at
   - type: updated_at
 
 indices:
   - columns: [course_lesson_id]
+  - columns: [course_lesson_id, tipo]

package/hedhog/table/course_lesson_note.yaml

@@ -0,0 +1,34 @@
+columns:
+  - type: pk
+  - name: course_lesson_id
+    type: fk
+    references:
+      table: course_lesson
+      column: id
+      onDelete: CASCADE
+  - name: person_id
+    type: fk
+    references:
+      table: person
+      column: id
+      onDelete: CASCADE
+  - name: description
+    type: text
+  - name: player_time_seconds
+    type: int
+    default: 0
+  - name: frame_file_id
+    type: fk
+    isNullable: true
+    references:
+      table: file
+      column: id
+      onDelete: SET NULL
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [course_lesson_id]
+  - columns: [person_id]
+  - columns: [course_lesson_id, person_id]
+  - columns: [course_lesson_id, player_time_seconds]

package/hedhog/table/course_video_resolution_profile.yaml

@@ -0,0 +1,22 @@
+columns:
+  - type: pk
+  - name: course_id
+    type: fk
+    references:
+      table: course
+      column: id
+      onDelete: CASCADE
+  - name: video_resolution_profile_id
+    type: fk
+    references:
+      table: video_resolution_profile
+      column: id
+      onDelete: CASCADE
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [course_id, video_resolution_profile_id]
+    isUnique: true
+  - columns: [course_id]
+  - columns: [video_resolution_profile_id]

package/hedhog/table/exam.yaml

@@ -26,6 +26,10 @@ columns:
   - name: exam_type
     type: enum
     values: [quiz, test, assignment, project]
+  - name: level
+    type: enum
+    values: [beginner, intermediate, advanced]
+    default: beginner
   - name: status
     type: enum
     values: [draft, published, closed, archived]
@@ -88,4 +92,5 @@ columns:
 indices:
   - columns: [course_id]
   - columns: [course_class_group_id]
+  - columns: [level]
   - columns: [status]

package/hedhog/table/learning_path_enrollment.yaml

@@ -21,9 +21,15 @@ columns:
     default: 0
   - name: enrolled_at
     type: datetime
+  - name: started_at
+    type: datetime
+    isNullable: true
   - name: completed_at
     type: datetime
     isNullable: true
+  - name: ended_at
+    type: datetime
+    isNullable: true
   - type: created_at
   - type: updated_at
 

package/hedhog/table/question.yaml

@@ -1,5 +1,12 @@
 columns:
   - type: pk
+  - name: question_subject_id
+    type: fk
+    isNullable: true
+    references:
+      table: question_subject
+      column: id
+      onDelete: SET NULL
   - name: question_type
     type: enum
     values: [multiple_choice, true_false, essay, fill_blank, matching]
@@ -19,3 +26,6 @@ columns:
     default: 1
   - type: created_at
   - type: updated_at
+
+indices:
+  - columns: [question_subject_id]

package/hedhog/table/question_subject.yaml

@@ -0,0 +1,17 @@
+columns:
+  - type: pk
+  - name: name
+    type: varchar
+    length: 255
+  - name: description
+    type: text
+    isNullable: true
+  - name: is_active
+    type: boolean
+    default: true
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [name]
+    isUnique: true

package/hedhog/table/student_activity_streak.yaml

@@ -0,0 +1,25 @@
+columns:
+  - type: pk
+  - name: person_id
+    type: fk
+    references:
+      table: person
+      column: id
+      onDelete: CASCADE
+  - name: activity_date_key
+    type: varchar
+  - name: activity_type
+    type: varchar
+    isNullable: true
+  - name: source
+    type: varchar
+    isNullable: true
+  - name: last_activity_at
+    type: datetime
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [person_id, activity_date_key]
+    isUnique: true
+  - columns: [person_id, last_activity_at]

package/hedhog/table/video_resolution_profile.yaml

@@ -0,0 +1,18 @@
+columns:
+  - type: pk
+  - name: name
+    type: varchar
+    length: 100
+  - name: ffmpeg_params
+    type: text
+  - name: status
+    type: enum
+    values: [active, inactive]
+    default: active
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [name]
+    isUnique: true
+  - columns: [status]

package/package.json

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

package/src/achievement/achievement.controller.ts

@@ -0,0 +1,60 @@
+import { Role } from '@hed-hog/api';
+import {
+  Body,
+  Controller,
+  Delete,
+  Get,
+  HttpCode,
+  HttpStatus,
+  Param,
+  ParseIntPipe,
+  Patch,
+  Post,
+  Query,
+} from '@nestjs/common';
+import { AchievementService } from './achievement.service';
+import { CreateAchievementDto } from './dto/create-achievement.dto';
+import { UpdateAchievementDto } from './dto/update-achievement.dto';
+
+@Role()
+@Controller('lms/achievements')
+export class AchievementController {
+  constructor(private readonly achievementService: AchievementService) {}
+
+  @Get()
+  list(
+    @Query('page') page?: string,
+    @Query('pageSize') pageSize?: string,
+    @Query('search') search?: string
+  ) {
+    return this.achievementService.list({
+      page: page ? Number(page) : 1,
+      pageSize: pageSize ? Number(pageSize) : 20,
+      search,
+    });
+  }
+
+  @Get(':id')
+  getById(@Param('id', ParseIntPipe) id: number) {
+    return this.achievementService.getById(id);
+  }
+
+  @Post()
+  create(@Body() dto: CreateAchievementDto) {
+    return this.achievementService.create(dto);
+  }
+
+  @Patch(':id')
+  update(
+    @Param('id', ParseIntPipe) id: number,
+    @Body() dto: UpdateAchievementDto
+  ) {
+    return this.achievementService.update(id, dto);
+  }
+
+  @Delete(':id')
+  @HttpCode(HttpStatus.NO_CONTENT)
+  remove(@Param('id', ParseIntPipe) id: number) {
+    return this.achievementService.delete(id);
+  }
+}

package/src/achievement/achievement.mcp-tools.ts

@@ -0,0 +1,108 @@
+import { McpContext, McpTool } from '@hed-hog/core';
+import { Injectable } from '@nestjs/common';
+import { AchievementService } from './achievement.service';
+
+@Injectable()
+export class LmsAchievementsMcpTools {
+  constructor(private readonly achievementService: AchievementService) {}
+
+  @McpTool({
+    name: 'lms.achievements.list',
+    description: 'Lists LMS achievements with optional pagination and search.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        page: { type: 'number', description: 'Page number (default: 1)' },
+        pageSize: { type: 'number', description: 'Items per page (default: 20)' },
+        search: { type: 'string', description: 'Search term (name, description, type)' },
+      },
+    },
+    readOnly: true,
+  })
+  async listAchievements(args: Record<string, any>, _context: McpContext): Promise<any> {
+    return this.achievementService.list(args);
+  }
+
+  @McpTool({
+    name: 'lms.achievements.get',
+    description: 'Returns a single LMS achievement by ID.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Achievement ID' },
+      },
+      required: ['id'],
+    },
+    readOnly: true,
+  })
+  async getAchievement(args: { id: number }, _context: McpContext): Promise<any> {
+    return this.achievementService.getById(args.id);
+  }
+
+  @McpTool({
+    name: 'lms.achievements.create',
+    description: 'Creates a new LMS achievement.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        name: { type: 'string', description: 'Achievement name (required)' },
+        description: { type: 'string', description: 'Description' },
+        iconFileId: { type: 'number', description: 'Icon file ID' },
+        mainImageFileId: { type: 'number', description: 'Main image file ID' },
+        type: {
+          type: 'string',
+          description: 'Achievement type (required)',
+          enum: ['course_completion', 'learning_path_completion', 'exam_approval', 'attendance', 'engagement', 'custom'],
+        },
+        bitCodesValue: { type: 'number', description: 'BitCodes value awarded (required, min 0)' },
+        canReceiveMultipleTimes: { type: 'boolean', description: 'Whether the student can receive this achievement multiple times (required)' },
+      },
+      required: ['name', 'type', 'bitCodesValue', 'canReceiveMultipleTimes'],
+    },
+  })
+  async createAchievement(args: Record<string, any>, _context: McpContext): Promise<any> {
+    return this.achievementService.create(args as any);
+  }
+
+  @McpTool({
+    name: 'lms.achievements.update',
+    description: 'Updates an existing LMS achievement.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Achievement ID' },
+        name: { type: 'string', description: 'Achievement name' },
+        description: { type: 'string', description: 'Description' },
+        iconFileId: { type: 'number', description: 'Icon file ID' },
+        mainImageFileId: { type: 'number', description: 'Main image file ID' },
+        type: {
+          type: 'string',
+          description: 'Achievement type',
+          enum: ['course_completion', 'learning_path_completion', 'exam_approval', 'attendance', 'engagement', 'custom'],
+        },
+        bitCodesValue: { type: 'number', description: 'BitCodes value' },
+        canReceiveMultipleTimes: { type: 'boolean', description: 'Whether the student can receive this achievement multiple times' },
+      },
+      required: ['id'],
+    },
+  })
+  async updateAchievement(args: { id: number; [key: string]: any }, _context: McpContext): Promise<any> {
+    const { id, ...dto } = args;
+    return this.achievementService.update(id, dto as any);
+  }
+
+  @McpTool({
+    name: 'lms.achievements.delete',
+    description: 'Deletes an LMS achievement by ID.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Achievement ID' },
+      },
+      required: ['id'],
+    },
+  })
+  async deleteAchievement(args: { id: number }, _context: McpContext): Promise<any> {
+    return this.achievementService.delete(args.id);
+  }
+}

package/src/achievement/achievement.module.ts

@@ -0,0 +1,13 @@
+import { PrismaModule } from '@hed-hog/api-prisma';
+import { forwardRef, Module } from '@nestjs/common';
+import { AchievementController } from './achievement.controller';
+import { LmsAchievementsMcpTools } from './achievement.mcp-tools';
+import { AchievementService } from './achievement.service';
+
+@Module({
+  imports: [forwardRef(() => PrismaModule)],
+  controllers: [AchievementController],
+  providers: [AchievementService, LmsAchievementsMcpTools],
+  exports: [AchievementService],
+})
+export class AchievementModule {}