@hed-hog/lms 0.0.358 → 0.0.364

package/src/student-xp/student-xp.controller.ts

@@ -0,0 +1,76 @@
+import { Role } from '@hed-hog/api';
+import { Controller, Get, Param, ParseIntPipe, Query } from '@nestjs/common';
+import { StudentXpService } from './student-xp.service';
+
+@Role()
+@Controller('lms/xp')
+export class StudentXpController {
+  constructor(private readonly studentXpService: StudentXpService) {}
+
+  @Get('events')
+  listEvents(
+    @Query('page') page?: string,
+    @Query('pageSize') pageSize?: string,
+    @Query('personId') personId?: string,
+    @Query('courseLessonId') courseLessonId?: string,
+    @Query('source') source?: string,
+  ) {
+    return this.studentXpService.listEvents({
+      page: Number(page) || 1,
+      pageSize: Number(pageSize) || 20,
+      personId: personId ? Number(personId) : undefined,
+      courseLessonId: courseLessonId ? Number(courseLessonId) : undefined,
+      source,
+    });
+  }
+
+  @Get('balances/areas')
+  listAreaBalances(
+    @Query('page') page?: string,
+    @Query('pageSize') pageSize?: string,
+    @Query('personId') personId?: string,
+    @Query('areaId') areaId?: string,
+  ) {
+    return this.studentXpService.listAreaBalances({
+      page: Number(page) || 1,
+      pageSize: Number(pageSize) || 20,
+      personId: personId ? Number(personId) : undefined,
+      areaId: areaId ? Number(areaId) : undefined,
+    });
+  }
+
+  @Get('balances/skills')
+  listSkillBalances(
+    @Query('page') page?: string,
+    @Query('pageSize') pageSize?: string,
+    @Query('personId') personId?: string,
+    @Query('skillId') skillId?: string,
+  ) {
+    return this.studentXpService.listSkillBalances({
+      page: Number(page) || 1,
+      pageSize: Number(pageSize) || 20,
+      personId: personId ? Number(personId) : undefined,
+      skillId: skillId ? Number(skillId) : undefined,
+    });
+  }
+
+  @Get('balances/learning-types')
+  listLearningTypeBalances(
+    @Query('page') page?: string,
+    @Query('pageSize') pageSize?: string,
+    @Query('personId') personId?: string,
+    @Query('learningTypeId') learningTypeId?: string,
+  ) {
+    return this.studentXpService.listLearningTypeBalances({
+      page: Number(page) || 1,
+      pageSize: Number(pageSize) || 20,
+      personId: personId ? Number(personId) : undefined,
+      learningTypeId: learningTypeId ? Number(learningTypeId) : undefined,
+    });
+  }
+
+  @Get('balances/person/:personId')
+  getPersonBalanceSummary(@Param('personId', ParseIntPipe) personId: number) {
+    return this.studentXpService.getPersonBalanceSummary(personId);
+  }
+}

package/src/student-xp/student-xp.module.ts

@@ -0,0 +1,12 @@
+import { PrismaModule } from '@hed-hog/api-prisma';
+import { forwardRef, Module } from '@nestjs/common';
+import { StudentXpController } from './student-xp.controller';
+import { StudentXpService } from './student-xp.service';
+
+@Module({
+  imports: [forwardRef(() => PrismaModule)],
+  controllers: [StudentXpController],
+  providers: [StudentXpService],
+  exports: [StudentXpService],
+})
+export class StudentXpModule {}

package/src/student-xp/student-xp.service.ts

@@ -0,0 +1,236 @@
+import { PrismaService } from '@hed-hog/api-prisma';
+import { Injectable } from '@nestjs/common';
+
+@Injectable()
+export class StudentXpService {
+  constructor(private readonly prisma: PrismaService) {}
+
+  async listEvents(params: {
+    page?: number;
+    pageSize?: number;
+    personId?: number;
+    courseLessonId?: number;
+    source?: string;
+  }) {
+    const page = Math.max(Number(params.page) || 1, 1);
+    const pageSize = Math.max(Number(params.pageSize) || 20, 1);
+    const offset = (page - 1) * pageSize;
+
+    const values: unknown[] = [];
+    const where: string[] = ['1 = 1'];
+
+    if (params.personId) {
+      where.push(`ce.person_id = ${this.param(values, params.personId)}`);
+    }
+    if (params.courseLessonId) {
+      where.push(`m.course_lesson_id = ${this.param(values, params.courseLessonId)}`);
+    }
+    if (params.source?.trim()) {
+      where.push(`e.source::text = ${this.param(values, params.source.trim())}`);
+    }
+
+    const whereClause = where.join(' AND ');
+
+    const totalRow = await this.querySingle<{ total: string }>(
+      `SELECT COUNT(*)::text AS total
+         FROM student_xp_event e
+         JOIN course_enrollment ce ON ce.id = e.course_enrollment_id
+         JOIN lesson_xp_segment s ON s.id = e.lesson_xp_segment_id
+         JOIN lesson_xp_map m ON m.id = s.lesson_xp_map_id
+        WHERE ${whereClause}`,
+      values,
+    );
+
+    const q = [...values];
+    const rows = await this.queryRows<any>(
+      `SELECT
+          e.id,
+          e.course_enrollment_id AS "courseEnrollmentId",
+          ce.person_id AS "personId",
+          e.lesson_xp_segment_id AS "lessonXpSegmentId",
+          m.course_lesson_id AS "courseLessonId",
+          e.xp_earned AS "xpEarned",
+          e.watch_percent::float AS "watchPercent",
+          e.granted_at::text AS "grantedAt",
+          e.source::text AS source,
+          e.created_at::text AS "createdAt"
+        FROM student_xp_event e
+        JOIN course_enrollment ce ON ce.id = e.course_enrollment_id
+        JOIN lesson_xp_segment s ON s.id = e.lesson_xp_segment_id
+        JOIN lesson_xp_map m ON m.id = s.lesson_xp_map_id
+       WHERE ${whereClause}
+       ORDER BY e.granted_at DESC
+       LIMIT ${this.param(q, pageSize)} OFFSET ${this.param(q, offset)}`,
+      q,
+    );
+
+    const total = Number(totalRow?.total ?? 0);
+    return { data: rows, total, page, pageSize, lastPage: Math.ceil(total / pageSize) };
+  }
+
+  async listAreaBalances(params: { page?: number; pageSize?: number; personId?: number; areaId?: number }) {
+    const page = Math.max(Number(params.page) || 1, 1);
+    const pageSize = Math.max(Number(params.pageSize) || 20, 1);
+    const offset = (page - 1) * pageSize;
+
+    const values: unknown[] = [];
+    const where: string[] = ['1 = 1'];
+    if (params.personId) where.push(`b.person_id = ${this.param(values, params.personId)}`);
+    if (params.areaId) where.push(`b.xp_area_id = ${this.param(values, params.areaId)}`);
+    const whereClause = where.join(' AND ');
+
+    const totalRow = await this.querySingle<{ total: string }>(
+      `SELECT COUNT(*)::text AS total FROM student_area_xp b WHERE ${whereClause}`,
+      values,
+    );
+
+    const q = [...values];
+    const rows = await this.queryRows<any>(
+      `SELECT
+          b.id, b.person_id AS "personId", b.xp_area_id AS "xpAreaId",
+          COALESCE(l.name, a.slug) AS "areaName",
+          b.total_xp AS "totalXp", b.event_count AS "eventCount",
+          b.last_updated_at::text AS "lastUpdatedAt"
+        FROM student_area_xp b
+        JOIN xp_area a ON a.id = b.xp_area_id
+        LEFT JOIN xp_area_locale l ON l.xp_area_id = a.id
+          AND l.locale_id = (SELECT id FROM locale WHERE code = 'pt' LIMIT 1)
+       WHERE ${whereClause}
+       ORDER BY b.total_xp DESC
+       LIMIT ${this.param(q, pageSize)} OFFSET ${this.param(q, offset)}`,
+      q,
+    );
+
+    const total = Number(totalRow?.total ?? 0);
+    return { data: rows, total, page, pageSize, lastPage: Math.ceil(total / pageSize) };
+  }
+
+  async listSkillBalances(params: { page?: number; pageSize?: number; personId?: number; skillId?: number }) {
+    const page = Math.max(Number(params.page) || 1, 1);
+    const pageSize = Math.max(Number(params.pageSize) || 20, 1);
+    const offset = (page - 1) * pageSize;
+
+    const values: unknown[] = [];
+    const where: string[] = ['1 = 1'];
+    if (params.personId) where.push(`b.person_id = ${this.param(values, params.personId)}`);
+    if (params.skillId) where.push(`b.xp_skill_id = ${this.param(values, params.skillId)}`);
+    const whereClause = where.join(' AND ');
+
+    const totalRow = await this.querySingle<{ total: string }>(
+      `SELECT COUNT(*)::text AS total FROM student_skill_xp b WHERE ${whereClause}`,
+      values,
+    );
+
+    const q = [...values];
+    const rows = await this.queryRows<any>(
+      `SELECT
+          b.id, b.person_id AS "personId", b.xp_skill_id AS "xpSkillId",
+          COALESCE(l.name, s.slug) AS "skillName",
+          b.total_xp AS "totalXp", b.event_count AS "eventCount",
+          b.last_updated_at::text AS "lastUpdatedAt"
+        FROM student_skill_xp b
+        JOIN xp_skill s ON s.id = b.xp_skill_id
+        LEFT JOIN xp_skill_locale l ON l.xp_skill_id = s.id
+          AND l.locale_id = (SELECT id FROM locale WHERE code = 'pt' LIMIT 1)
+       WHERE ${whereClause}
+       ORDER BY b.total_xp DESC
+       LIMIT ${this.param(q, pageSize)} OFFSET ${this.param(q, offset)}`,
+      q,
+    );
+
+    const total = Number(totalRow?.total ?? 0);
+    return { data: rows, total, page, pageSize, lastPage: Math.ceil(total / pageSize) };
+  }
+
+  async listLearningTypeBalances(params: { page?: number; pageSize?: number; personId?: number; learningTypeId?: number }) {
+    const page = Math.max(Number(params.page) || 1, 1);
+    const pageSize = Math.max(Number(params.pageSize) || 20, 1);
+    const offset = (page - 1) * pageSize;
+
+    const values: unknown[] = [];
+    const where: string[] = ['1 = 1'];
+    if (params.personId) where.push(`b.person_id = ${this.param(values, params.personId)}`);
+    if (params.learningTypeId) where.push(`b.xp_learning_type_id = ${this.param(values, params.learningTypeId)}`);
+    const whereClause = where.join(' AND ');
+
+    const totalRow = await this.querySingle<{ total: string }>(
+      `SELECT COUNT(*)::text AS total FROM student_learning_type_xp b WHERE ${whereClause}`,
+      values,
+    );
+
+    const q = [...values];
+    const rows = await this.queryRows<any>(
+      `SELECT
+          b.id, b.person_id AS "personId", b.xp_learning_type_id AS "xpLearningTypeId",
+          COALESCE(l.name, t.slug) AS "learningTypeName",
+          b.total_xp AS "totalXp", b.event_count AS "eventCount",
+          b.last_updated_at::text AS "lastUpdatedAt"
+        FROM student_learning_type_xp b
+        JOIN xp_learning_type t ON t.id = b.xp_learning_type_id
+        LEFT JOIN xp_learning_type_locale l ON l.xp_learning_type_id = t.id
+          AND l.locale_id = (SELECT id FROM locale WHERE code = 'pt' LIMIT 1)
+       WHERE ${whereClause}
+       ORDER BY b.total_xp DESC
+       LIMIT ${this.param(q, pageSize)} OFFSET ${this.param(q, offset)}`,
+      q,
+    );
+
+    const total = Number(totalRow?.total ?? 0);
+    return { data: rows, total, page, pageSize, lastPage: Math.ceil(total / pageSize) };
+  }
+
+  async getPersonBalanceSummary(personId: number) {
+    const [areas, skills, learningTypes, totalRow] = await Promise.all([
+      this.queryRows<any>(
+        `SELECT b.xp_area_id AS "xpAreaId", COALESCE(l.name, a.slug) AS name, b.total_xp AS "totalXp", b.event_count AS "eventCount"
+           FROM student_area_xp b
+           JOIN xp_area a ON a.id = b.xp_area_id
+           LEFT JOIN xp_area_locale l ON l.xp_area_id = a.id AND l.locale_id = (SELECT id FROM locale WHERE code = 'pt' LIMIT 1)
+          WHERE b.person_id = $1 ORDER BY b.total_xp DESC`,
+        [personId],
+      ),
+      this.queryRows<any>(
+        `SELECT b.xp_skill_id AS "xpSkillId", COALESCE(l.name, s.slug) AS name, b.total_xp AS "totalXp", b.event_count AS "eventCount"
+           FROM student_skill_xp b
+           JOIN xp_skill s ON s.id = b.xp_skill_id
+           LEFT JOIN xp_skill_locale l ON l.xp_skill_id = s.id AND l.locale_id = (SELECT id FROM locale WHERE code = 'pt' LIMIT 1)
+          WHERE b.person_id = $1 ORDER BY b.total_xp DESC`,
+        [personId],
+      ),
+      this.queryRows<any>(
+        `SELECT b.xp_learning_type_id AS "xpLearningTypeId", COALESCE(l.name, t.slug) AS name, b.total_xp AS "totalXp", b.event_count AS "eventCount"
+           FROM student_learning_type_xp b
+           JOIN xp_learning_type t ON t.id = b.xp_learning_type_id
+           LEFT JOIN xp_learning_type_locale l ON l.xp_learning_type_id = t.id AND l.locale_id = (SELECT id FROM locale WHERE code = 'pt' LIMIT 1)
+          WHERE b.person_id = $1 ORDER BY b.total_xp DESC`,
+        [personId],
+      ),
+      this.querySingle<{ total: string }>(
+        `SELECT COALESCE(SUM(total_xp), 0)::text AS total FROM student_area_xp WHERE person_id = $1`,
+        [personId],
+      ),
+    ]);
+
+    return {
+      personId,
+      totalXp: Number(totalRow?.total ?? 0),
+      areas,
+      skills,
+      learningTypes,
+    };
+  }
+
+  private param(values: unknown[], value: unknown) {
+    values.push(value);
+    return `$${values.length}`;
+  }
+
+  private async queryRows<T>(query: string, values: unknown[] = []) {
+    return this.prisma.$queryRawUnsafe<T[]>(query, ...values);
+  }
+
+  private async querySingle<T>(query: string, values: unknown[] = []) {
+    const rows = await this.prisma.$queryRawUnsafe<T[]>(query, ...values);
+    return rows[0] ?? null;
+  }
+}

package/src/xp-catalog/dto/create-xp-area.dto.ts

@@ -0,0 +1,40 @@
+import { IsEnum, IsInt, IsOptional, IsString, MaxLength, Min } from 'class-validator';
+
+export class CreateXpAreaDto {
+  @IsString()
+  @MaxLength(100)
+  slug: string;
+
+  @IsString()
+  namePt: string;
+
+  @IsString()
+  nameEn: string;
+
+  @IsOptional()
+  @IsString()
+  descriptionPt?: string | null;
+
+  @IsOptional()
+  @IsString()
+  descriptionEn?: string | null;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(100)
+  iconSlug?: string | null;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(9)
+  color?: string | null;
+
+  @IsOptional()
+  @IsInt()
+  @Min(0)
+  sortOrder?: number;
+
+  @IsOptional()
+  @IsEnum(['active', 'inactive'])
+  status?: 'active' | 'inactive';
+}

package/src/xp-catalog/dto/create-xp-learning-type.dto.ts

@@ -0,0 +1,35 @@
+import { IsEnum, IsInt, IsNumber, IsOptional, IsString, MaxLength, Min } from 'class-validator';
+
+export class CreateXpLearningTypeDto {
+  @IsString()
+  @MaxLength(100)
+  slug: string;
+
+  @IsString()
+  namePt: string;
+
+  @IsString()
+  nameEn: string;
+
+  @IsOptional()
+  @IsString()
+  descriptionPt?: string | null;
+
+  @IsOptional()
+  @IsString()
+  descriptionEn?: string | null;
+
+  @IsOptional()
+  @IsNumber()
+  @Min(0)
+  multiplier?: number;
+
+  @IsOptional()
+  @IsInt()
+  @Min(0)
+  sortOrder?: number;
+
+  @IsOptional()
+  @IsEnum(['active', 'inactive'])
+  status?: 'active' | 'inactive';
+}

package/src/xp-catalog/dto/create-xp-skill.dto.ts

@@ -0,0 +1,35 @@
+import { IsEnum, IsInt, IsOptional, IsString, MaxLength, Min } from 'class-validator';
+
+export class CreateXpSkillDto {
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  xpAreaId?: number | null;
+
+  @IsString()
+  @MaxLength(100)
+  slug: string;
+
+  @IsString()
+  namePt: string;
+
+  @IsString()
+  nameEn: string;
+
+  @IsOptional()
+  @IsString()
+  descriptionPt?: string | null;
+
+  @IsOptional()
+  @IsString()
+  descriptionEn?: string | null;
+
+  @IsOptional()
+  @IsInt()
+  @Min(0)
+  sortOrder?: number;
+
+  @IsOptional()
+  @IsEnum(['active', 'inactive'])
+  status?: 'active' | 'inactive';
+}

package/src/xp-catalog/dto/update-xp-area.dto.ts

@@ -0,0 +1,43 @@
+import { IsEnum, IsInt, IsOptional, IsString, MaxLength, Min } from 'class-validator';
+
+export class UpdateXpAreaDto {
+  @IsOptional()
+  @IsString()
+  @MaxLength(100)
+  slug?: string;
+
+  @IsOptional()
+  @IsString()
+  namePt?: string;
+
+  @IsOptional()
+  @IsString()
+  nameEn?: string;
+
+  @IsOptional()
+  @IsString()
+  descriptionPt?: string | null;
+
+  @IsOptional()
+  @IsString()
+  descriptionEn?: string | null;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(100)
+  iconSlug?: string | null;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(9)
+  color?: string | null;
+
+  @IsOptional()
+  @IsInt()
+  @Min(0)
+  sortOrder?: number;
+
+  @IsOptional()
+  @IsEnum(['active', 'inactive'])
+  status?: 'active' | 'inactive';
+}

package/src/xp-catalog/dto/update-xp-learning-type.dto.ts

@@ -0,0 +1,38 @@
+import { IsEnum, IsInt, IsNumber, IsOptional, IsString, MaxLength, Min } from 'class-validator';
+
+export class UpdateXpLearningTypeDto {
+  @IsOptional()
+  @IsString()
+  @MaxLength(100)
+  slug?: string;
+
+  @IsOptional()
+  @IsString()
+  namePt?: string;
+
+  @IsOptional()
+  @IsString()
+  nameEn?: string;
+
+  @IsOptional()
+  @IsString()
+  descriptionPt?: string | null;
+
+  @IsOptional()
+  @IsString()
+  descriptionEn?: string | null;
+
+  @IsOptional()
+  @IsNumber()
+  @Min(0)
+  multiplier?: number;
+
+  @IsOptional()
+  @IsInt()
+  @Min(0)
+  sortOrder?: number;
+
+  @IsOptional()
+  @IsEnum(['active', 'inactive'])
+  status?: 'active' | 'inactive';
+}

package/src/xp-catalog/dto/update-xp-skill.dto.ts

@@ -0,0 +1,38 @@
+import { IsEnum, IsInt, IsOptional, IsString, MaxLength, Min } from 'class-validator';
+
+export class UpdateXpSkillDto {
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  xpAreaId?: number | null;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(100)
+  slug?: string;
+
+  @IsOptional()
+  @IsString()
+  namePt?: string;
+
+  @IsOptional()
+  @IsString()
+  nameEn?: string;
+
+  @IsOptional()
+  @IsString()
+  descriptionPt?: string | null;
+
+  @IsOptional()
+  @IsString()
+  descriptionEn?: string | null;
+
+  @IsOptional()
+  @IsInt()
+  @Min(0)
+  sortOrder?: number;
+
+  @IsOptional()
+  @IsEnum(['active', 'inactive'])
+  status?: 'active' | 'inactive';
+}

package/src/xp-catalog/xp-area.controller.ts

@@ -0,0 +1,64 @@
+import { Role } from '@hed-hog/api';
+import {
+  Body,
+  Controller,
+  Delete,
+  Get,
+  HttpCode,
+  HttpStatus,
+  Param,
+  ParseIntPipe,
+  Patch,
+  Post,
+  Query,
+} from '@nestjs/common';
+import { CreateXpAreaDto } from './dto/create-xp-area.dto';
+import { UpdateXpAreaDto } from './dto/update-xp-area.dto';
+import { XpAreaService } from './xp-area.service';
+
+@Role()
+@Controller('lms/xp/areas')
+export class XpAreaController {
+  constructor(private readonly xpAreaService: XpAreaService) {}
+
+  @Get()
+  list(
+    @Query('page') page?: string,
+    @Query('pageSize') pageSize?: string,
+    @Query('search') search?: string,
+    @Query('status') status?: string,
+  ) {
+    return this.xpAreaService.list({ page: Number(page) || 1, pageSize: Number(pageSize) || 20, search, status });
+  }
+
+  @Get('all')
+  getAll() {
+    return this.xpAreaService.getAll();
+  }
+
+  @Get('stats')
+  stats() {
+    return this.xpAreaService.stats();
+  }
+
+  @Get(':id')
+  getById(@Param('id', ParseIntPipe) id: number) {
+    return this.xpAreaService.getById(id);
+  }
+
+  @Post()
+  create(@Body() dto: CreateXpAreaDto) {
+    return this.xpAreaService.create(dto);
+  }
+
+  @Patch(':id')
+  update(@Param('id', ParseIntPipe) id: number, @Body() dto: UpdateXpAreaDto) {
+    return this.xpAreaService.update(id, dto);
+  }
+
+  @Delete(':id')
+  @HttpCode(HttpStatus.NO_CONTENT)
+  remove(@Param('id', ParseIntPipe) id: number) {
+    return this.xpAreaService.delete(id);
+  }
+}